1. BASE64編解碼簡(jiǎn)介

Base64是網(wǎng)絡(luò)上最常見(jiàn)的用于傳輸8Bit字節(jié)碼的編碼方式之一，Base64就是一種基于64個(gè)可打印字符來(lái)表示二進(jìn)制數(shù)據(jù)的方法。EASY EAI api封裝了BASE64編解碼工具，方便用戶對(duì)數(shù)據(jù)進(jìn)行BASE64封裝。

2. 快速上手

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

2.1 源碼工程下載

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

cd ~/nfsroot
mkdir GitHub
cd GitHub

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

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

注：

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

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

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

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

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

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

2.3 例程編譯

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

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

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

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

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

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

./Release/test-base64

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

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

3. BASE64編解碼API說(shuō)明

3.1 引用方式

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

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

3.2 BASE64編碼操作

編碼函數(shù)原型如下所示。

int32_t base64_encode(char *out_data, const char* in_data, unsigned int in_len);

具體介紹如下所示。

3.3 BASE64解碼操作

解碼函數(shù)原型如下所示。

int32_t base64_decode(char *out_data, unsigned int out_len, const char* encoded_string);

具體介紹如下所示。

4. BASE64操作API案例

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

示例一，對(duì)字符串進(jìn)行BASE64編碼，然后將得出的編碼數(shù)據(jù)再解碼。

char *cStr = "my name is hao";
char base64_data[1024] = {0};
char src_string[1024] = {0};

memset(base64_data, 0, sizeof(base64_data));
base64_encode(base64_data, cStr, strlen(cStr));
printf("encode data : %sn", base64_data);
base64_decode(src_string, sizeof(src_string), base64_data);
printf("source string : %sn", src_string)

示例二，驗(yàn)證數(shù)據(jù)中有0x00，還原出來(lái)的數(shù)據(jù)不會(huì)在0x00處斷開(kāi)。

char num_data[8] = {0x67, 0x88, 0x70, '', 'r', 'n', 0x73, 0x73};
char decode_data[8] = {0};
memset(base64_data, 0, sizeof(base64_data));
base64_encode(base64_data, num_data, sizeof(num_data));
printf("encode data : %sn", base64_data);
base64_decode(decode_data, sizeof(decode_data), base64_data);
printf("source string : 0x%02x 0x%02x 0x%02x 0x%02x 0x%02x 0x%02x 0x%02x 0x%02xn", 
	decode_data[0], decode_data[1], decode_data[2], decode_data[3],
	decode_data[4], decode_data[5], decode_data[6], decode_data[7]);

審核編輯 黃宇