瑞芯微(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]);