瑞芯微(EASY EAI)RV1126B BASE64编解码
1. BASE64编解码简介
Base64是网络上最常见的用于传输8Bit字节码的编码方式之一，Base64就是一种基于64个可打印字符来表示二进制数据的方法。EASY EAI api封装了BASE64编解码工具，方便用户对数据进行BASE64封装。
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-base64/ ./build.sh
注：
* 由于依赖库部署在板卡上，因此交叉编译过程中必须保持/mnt挂载。
2.3 例程运行
通过串口调试或ssh调试，进入板卡后台，定位到例程部署的位置，如下所示：
cd /userdata/Demo/common-base64
运行例程命令如下所示：
./test-base64
2.4 运行效果
执行效果如下所示。
3. BASE64编解码API说明
3.1 引用方式
EASY EAI api库位于本仓库的easyeai-api目录中。为方便客户在本地工程中直接调用我们的EASY EAI api库，此处列出工程中需要链接的库以及头文件等，方便用户直接添加。
API源代码路径为EASY-EAI-Toolkit-1126B/easyeai-api/common/base64/。用户可通过源代码了解接口实现，甚至可对源码进行修改。
3.2 BASE64编码操作
编码函数原型如下所示。
int32_t base64_encode(char *out_data, const char* in_data, unsigned int in_len);
具体介绍如下所示。
3.3 BASE64解码操作
解码函数原型如下所示。
int32_t base64_decode(char *out_data, unsigned int out_len, const char* encoded_string);
具体介绍如下所示。
4. BASE64操作API案例
示例代码路径为EASY-EAI-Toolkit-1126B/Demos/common-base64/test-base64.c。
示例一，对字符串进行BASE64编码，然后将得出的编码数据再解码。
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 : %s\n", base64_data); base64_decode(src_string, sizeof(src_string), base64_data); printf("source string : %s\n", src_string)
示例二，验证数据中有0x00，还原出来的数据不会在0x00处断开。
char num_data[8] = {0x67, 0x88, 0x70, '\0', '\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 : %s\n", 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%02x\n", decode_data[0], decode_data[1], decode_data[2], decode_data[3], decode_data[4], decode_data[5], decode_data[6], decode_data[7]);