1. 二維碼簡(jiǎn)介

二維碼又稱二維條碼，常見的二維碼為QR Code，QR全稱Quick Response，是一個(gè)近幾年來移動(dòng)設(shè)備上超流行的一種編碼方式，它比傳統(tǒng)的Bar Code條形碼能存更多的信息，也能表示更多的數(shù)據(jù)類型。

二維碼一共有40個(gè)尺寸。官方叫版本Version。Version 1是21 x 21的矩陣，Version 2是 25 x 25的矩陣，Version 3是29的尺寸，每增加一個(gè)version，就會(huì)增加4的尺寸，公式是：(V-1)*4 + 21（V是版本號(hào)） 最高Version 40，(40-1)*4+21 = 177，所以最高是177 x 177 的正方形。

二維碼有一定的糾錯(cuò)能力，糾錯(cuò)碼主要是通過Reed-Solomon error correction（里德-所羅門糾錯(cuò)算法）來實(shí)現(xiàn)的。

二維碼結(jié)構(gòu)：

2. 快速上手

如果您初次閱讀此文檔，請(qǐng)閱讀：《入門指南/源碼管理及編程介紹/源碼工程管理》，按需管理自己工程源碼（注：此文檔必看，并建議采用【遠(yuǎn)程掛載管理】方式，否則有代碼丟失風(fēng)險(xiǎn)?。。。?。

2.1 源碼工程下載

先在PC虛擬機(jī)定位到nfs服務(wù)目錄，再在目錄中創(chuàng)建存放源碼倉庫的管理目錄：

cd ~/nfsroot
mkdir GitHub
cd GitHub

再通過git工具，在管理目錄內(nèi)克隆遠(yuǎn)程倉庫（需要設(shè)備能對(duì)外網(wǎng)進(jìn)行訪問）

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

注：

* 此處可能會(huì)因網(wǎng)絡(luò)原因造成卡頓，請(qǐng)耐心等待。

* 如果實(shí)在要在gitHub網(wǎng)頁上下載，也要把整個(gè)倉庫下載下來，不能單獨(dú)下載本實(shí)例對(duì)應(yīng)的目錄。

2.2 開發(fā)環(huán)境搭建

通過adb shell進(jìn)入板卡開發(fā)環(huán)境，如下圖所示。

通過以下命令，把nfs目錄掛載上nfs服務(wù)器。

mount -t nfs -o nolock : /home/orin-nano/Desktop/nfs/

2.3 例程編譯

然后定位到nfs的掛載目錄，再在目錄中創(chuàng)建存放源碼倉庫的管理目錄：

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

進(jìn)入到對(duì)應(yīng)的例程目錄執(zhí)行編譯操作，具體命令如下所示：

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

2.4 例程運(yùn)行及效果

執(zhí)行下方命令，運(yùn)行示例程序：

./Release/test-QRCode

執(zhí)行效果如下所示。

測(cè)試程序運(yùn)行后會(huì)生成一張名為“QRCode.png”的圖片，如下所示。

API的詳細(xì)說明，以及API的調(diào)用（本例程源碼），詳細(xì)信息見下方說明。

3. 二維碼生成API說明

EASY EAI api封裝了二維碼生成工具，只需傳入信息即可生成二維碼圖片，方便用戶生成自身應(yīng)用的二維碼圖片。

3.1 引用方式

EASY EAI api庫位于本倉庫的easyeai-api目錄中。為方便客戶在本地工程中直接調(diào)用我們的EASY EAI api庫，此處列出工程中需要鏈接的庫以及頭文件等，方便用戶直接添加。

API源代碼路徑為EASY-EAI-Toolkit-3576/easyeai-api/common/qrcode/。用戶可通過源代碼了解接口實(shí)現(xiàn)，甚至可對(duì)源碼進(jìn)行修改。

3.2 二維碼生成操作

二維碼生成函數(shù)原型如下所示。

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

具體介紹如下所示。

3.3 二維碼操作API案例

示例代碼路徑為EASY-EAI-Toolkit-3576/Demos/common-qrcode/test-QRCode.c。

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