1. 二維碼簡介

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

二維碼一共有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（里德-所羅門糾錯算法）來實現(xiàn)的。

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

2. 快速上手

2.1 開發(fā)環(huán)境準(zhǔn)備

如果您初次閱讀此文檔，請閱讀《入門指南/開發(fā)環(huán)境準(zhǔn)備/Easy-Eai編譯環(huán)境準(zhǔn)備與更新》，并按照其相關(guān)的操作，進(jìn)行編譯環(huán)境的部署。

在PC端Ubuntu系統(tǒng)中執(zhí)行run腳本，進(jìn)入EASY-EAI編譯環(huán)境，具體如下所示。

cd ~/develop_environment ./run.sh 2204

2.2 源碼下載以及例程編譯

在EASY-EAI編譯環(huán)境下創(chuàng)建存放源碼倉庫的管理目錄：

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

通過git工具，在管理目錄內(nèi)克隆遠(yuǎn)程倉庫

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

注：

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

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

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

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

注：

* 由于依賴庫部署在板卡上，因此交叉編譯過程中必須保持/mnt掛載。

2.3 例程運行

通過串口調(diào)試或ssh調(diào)試，進(jìn)入板卡后臺，定位到例程部署的位置，如下所示：

cd /userdata/Demo/common-qrcode

運行例程命令如下所示：

./test-QRCode

2.4 運行效果

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

測試程序運行后會生成一張名為“QRCode.png”的圖片，如下所示。

回到【編譯窗口】，直接用eog命令把圖片打開：

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

若EASY-EAI編譯環(huán)境提示找不到eog命令，可以采用下方操作安裝一下eog命令：

sudo apt-get update sudo apt-get install eog

也可以嘗試把圖片，從板卡上拷到電腦上來：

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

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-1126B/easyeai-api/common/qrcode/。用戶可通過源代碼了解接口實現(xiàn)，甚至可對源碼進(jìn)行修改。

3.2 二維碼生成操作

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

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 !");