基于RK3576开发板的二维码生成

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  源码工程下载

       先在PC虚拟机定位到nfs服务目录，再在目录中创建存放源码仓库的管理目录：

cd ~/nfsroot
mkdir GitHub
cd GitHub

       再通过git工具，在管理目录内克隆远程仓库（需要设备能对外网进行访问）

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

  注：

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

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

2.2  开发环境搭建

       通过adb shell进入板卡开发环境，如下图所示。

       通过以下命令，把nfs目录挂载上nfs服务器。

mount -t nfs -o nolock <nfs server ip>:<nfs path in server> /home/orin-nano/Desktop/nfs/

2.3  例程编译

       然后定位到nfs的挂载目录，再在目录中创建存放源码仓库的管理目录：

cd /home/orin-nano/Desktop/nfs/GitHub

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

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

2.4  例程运行及效果

       执行下方命令，运行示例程序：

./Release/test-QRCode

       执行效果如下所示。

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

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

3. 二维码生成API说明

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

3.1  引用方式

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

描述	CMake写法	Makefile写法
api.cmake	${common_root}/qrcode/api.cmake	无
头文件目录	${QRCODE_INCLUDE_DIRS}	-I ../../easyeai-api/common/qrcode
源文件目录	${QRCODE_SOURCE_DIRS}	../../easyeai-api/common/qrcode
库文件目录	无	无
库链接参数	${QRCODE_LIBS}	无

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

3.2  二维码生成操作

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

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

       具体介绍如下所示。

函数名：StrToQRCode()
头文件	easyeai-api/common/qrencode/qrcode.h
输入参数	file：生成的二维码图片存放路径（含所在目录） 如：/userdata/myQRCode.png
返回值	成功返回0
	失败返回-1
注意事项	无

3.3  二维码操作API案例

       示例代码路径为EASY-EAI-Toolkit-3576/Demos/common-qrcode/test-QRCode.c。

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