瑞芯微(EASY EAI)RV1126B 二维码生成

1. 二维码简介

二维码又称二维条码，常见的二维码为QR Code，QR全称Quick Response，是一个近几年来移动设备上超流行的一种编码方式，它比传统的Bar Code条形码能存更多的信息，也能表示更多的数据类型。

二维码一共有40个尺寸。官方叫版本Version。Version 1是21 x 21的矩阵，Version 2是 25 x 25的矩阵，Version 3是29的尺寸，每增加一个version，就会增加4的尺寸，公式是：(V-1)*4 + 21（V是版本号） 最高Version 40，(40-1)*4+21 = 177，所以最高是177 x 177 的正方形。

二维码有一定的纠错能力，纠错码主要是通过Reed-Solomon error correction（里德-所罗门纠错算法）来实现的。

二维码结构：

2. 快速上手

2.1 开发环境准备

如果您初次阅读此文档，请阅读《入门指南/开发环境准备/Easy-Eai编译环境准备与更新》，并按照其相关的操作，进行编译环境的部署。

在PC端Ubuntu系统中执行run脚本，进入EASY-EAI编译环境，具体如下所示。

cd ~/develop_environment ./run.sh 2204

2.2 源码下载以及例程编译

在EASY-EAI编译环境下创建存放源码仓库的管理目录：

cd /opt mkdir EASY-EAI-Toolkit cd EASY-EAI-Toolkit

通过git工具，在管理目录内克隆远程仓库

git clone https://github.com/EASY-EAI/EASY-EAI-Toolkit-1126B.git

注：

* 此处可能会因网络原因造成卡顿，请耐心等待。

* 如果实在要在gitHub网页上下载，也要把整个仓库下载下来，不能单独下载本实例对应的目录。

进入到对应的例程目录执行编译操作，具体命令如下所示：

cd EASY-EAI-Toolkit-1126B/Demos/common-qrcode/ ./build.sh

注：

* 由于依赖库部署在板卡上，因此交叉编译过程中必须保持/mnt挂载。

2.3 例程运行

通过串口调试或ssh调试，进入板卡后台，定位到例程部署的位置，如下所示：

cd /userdata/Demo/common-qrcode

运行例程命令如下所示：

./test-QRCode

2.4 运行效果

执行效果如下所示。

测试程序运行后会生成一张名为“QRCode.png”的图片，如下所示。

回到【编译窗口】，直接用eog命令把图片打开：

eog /mnt/userdata/Demo/common-qrcode/QRCode.png

若EASY-EAI编译环境提示找不到eog命令，可以采用下方操作安装一下eog命令：

sudo apt-get update sudo apt-get install eog

也可以尝试把图片，从板卡上拷到电脑上来：

cp /mnt/userdata/Demo/common-qrcode/QRCode.png ./Release

API的详细说明，以及API的调用（本例程源码），详细信息见下方说明。

3. 二维码生成API说明

EASY EAI api封装了二维码生成工具，只需传入信息即可生成二维码图片，方便用户生成自身应用的二维码图片。

3.1 引用方式

EASY EAI api库位于本仓库的easyeai-api目录中。为方便客户在本地工程中直接调用我们的EASY EAI api库，此处列出工程中需要链接的库以及头文件等，方便用户直接添加。

API源代码路径为EASY-EAI-Toolkit-1126B/easyeai-api/common/qrcode/。用户可通过源代码了解接口实现，甚至可对源码进行修改。

3.2 二维码生成操作

二维码生成函数原型如下所示。

long StrToQRCode(const char *file, const char *pStr);

具体介绍如下所示。

4. 使用案例

二维码操作API使用案例，示例代码路径为：

EASY-EAI-Toolkit-1126B/Demos/common-qrcode/test-QRCode.c。

StrToQRCode(QRCODE_PATH, "hello! my name is EasyEai-api !");