关于HiSpark WiFi IoT OLED移植到鸿蒙
效果图
大家好，我是gray,是一名默默无闻的嵌入式软件工程师，比较喜欢钻研新技术，一直关注鸿蒙，由于错过最佳申请板子的时间，现在手头没有开发板，申请的还没有下文，现在借用别人的，下班回来搞搞，希望官方有多的板子能送我一套3861~~，今天就给大家分享一下我的在移植oled到鸿蒙,其实也不叫移植，已经有大佬们移植好了，我只是修改一些函数，让它用起来更加的方便，更加符合我们程序猿的使用风格，今天的主要内容就是让oled能通过printf那样输出字符串，支持中英混合的那种，先看效果图：
可以是这种姿势：
ssd1306_print(0,0,哈喽鸿蒙, white);
这种姿势：
ssd1306_print(0,0,哈喽harmony, white);
甚至还可以这么搞：
sprintf(buff,温度 %d c,20);ssd1306_print(0,32,buff, white);
这样用不比下面的这样的香吗？？？？？？
oled_showchinese(0,0,0); oled_showchinese(16,0,1); oled_showchinese(32,0,2); oled_showchinese(48,0,3); oled_showchinese(64,0,4); oled_showchinese(80,0,5); oled_showchinese(96,0,6); //显示 空气质量检测仪 oled_showstring(0,2,t:); oled_shownum(16,2,temperature,2,16);//显示温度值 oled_showchinese(32,2,8);//显示温度符号 oled_showstring(56,2,r:); oled_showchar(88,2,'%');//显示温度符号 oled_shownum(72,2,humidity,2,16); 传统的这种一个字一条语句，你还得算某个字体有没有越位，或者位置是不是有间隔了。。。这样浪费多少时间，怎么能容忍这样的事情发生呢？坚决不能容忍！！！！接下来看看怎么弄吧~~
移植教程
声明：跟着本教程操作默认你已经搭建好环境，环境搭建可移步：
传送
移植教程已经有了，我是参照润和许老师的教程修改的，移植教程请移步：
[传送]
教程是把代码下载到根目录，并运行，但是我们做项目都是把外设模块统一放在app下执行，所以我的移植是这样的：
1.把代码下载并上传到 linux服务器，我的是虚拟机，直接通过共享文件夹上传到虚拟机桌面，然后敲命令
unzip harmonyos-ssd1306-master.zip -d /home/harmony/harmony/code/code-1.0/applications/sample/wifi-iot/app/
解压到app文件夹：
然后修改app目录下的build.gn ,添加harmonyos-ssd1306:app, 注意分号
然后编译，下载即可。
如何显示中文
我们都知道，oled显示都是ascii码，那中文是用什么码来显示呢？这里普及一下汉字编码知识：
中文汉字：
字节数 : 2;编码：gb2312
字节数 : 2;编码：gbk
字节数 : 2;编码：gb18030
字节数 : 1;编码：iso-8859-1
字节数 : 3;编码：utf-8
字节数 : 4;编码：utf-16
字节数 : 2;编码：utf-16be
字节数 : 2;编码：utf-16le
1、美国人首先对其英文字符进行了编码，也就是最早的ascii码，用一个字节的低7位来表示英文的128个字符，高1位统一为0；
2、后来欧洲人发现尼玛你这128位哪够用，比如我高贵的法国人字母上面的还有注音符，这个怎么区分，得，把高1位编进来吧，这样欧洲普遍使用一个全字节进行编码，最多可表示256位。欧美人就是喜欢直来直去，字符少，编码用得位数少； 3、但是即使位数少，不同国家地区用不同的字符编码，虽然0–127表示的符号是一样的，但是128–255这一段的解释完全乱套了，即使2进制完全一样，表示的字符完全不一样，比如135在法语，希伯来语，俄语编码中完全是不同的符号； 4、更麻烦的是，尼玛这电脑高科技传到中国后，中国人发现我们有10万多个汉字，你们欧美这256字塞牙缝都不够。于是就发明了gb2312这些汉字编码，典型的用2个字节来表示绝大部分的常用汉字，最多可以表示65536个汉字字符，这样就不难理解有些汉字你在新华字典里查得到，但是电脑上如果不处理一下你是显示不出来的了吧。
5、这下各用各的字符集编码，这世界咋统一？俄国人发封email给中国人，两边字符集编码不同，尼玛显示都是乱码啊。为了统一，于是就发明了unicode，将世界上所有的符号都纳入其中，每一个符号都给予一个独一无二的编码，现在unicode可以容纳100多万个符号，每个符号的编码都不一样，这下可统一了，所有语言都可以互通，一个网页页面里可以同时显示各国文字。
6、然而，unicode虽然统一了全世界字符的二进制编码，但没有规定如何存储啊，亲。x86和amd体系结构的电脑小端序和大端序都分不清，别提计算机如何识别到底是unicode还是acsii了。如果unicode统一规定，每个符号用三个或四个字节表示，那么每个英文字母前都必然有二到三个字节是0，文本文件的大小会因此大出二三倍，这对于存储来说是极大的浪费。这样导致一个后果：出现了unicode的多种存储方式。 7、互联网的兴起，网页上要显示各种字符，必须统一啊，亲。utf-8就是unicode最重要的实现方式之一。另外还有utf-16、utf-32等。utf-8不是固定字长编码的，而是一种变长的编码方式。它可以使用1~4个字节表示一个符号，根据不同的符号而变化字节长度。这是种比较巧妙的设计，如果一个字节的第一位是0，则这个字节单独就是一个字符；如果第一位是1，则连续有多少个1，就表示当前字符占用多少个字节。
8、注意unicode的字符编码和utf-8的存储编码表示是不同的，例如严字的unicode码是4e25，utf-8编码是e4b8a5，这个7里面解释了的，utf-8编码不仅考虑了编码，还考虑了存储，e4b8a5是在存储识别编码的基础上塞进了4e25。
9、utf-8 使用一至四个字节为每个字符编码。128 个 ascii 字符（unicode 范围由 u+0000 至 u+007f）只需一个字节，带有变音符号的拉丁文、希腊文、西里尔字母、亚美尼亚语、希伯来文、阿拉伯文、叙利亚文及马尔代夫语（unicode 范围由 u+0080 至 u+07ff）需要二个字节，其他基本多文种平面（bmp）中的字符（cjk属于此类-qieqie注）使用三个字节，其他 unicode 辅助平面的字符使用四字节编码。
所以。。我们可以看看在鸿蒙系统上使用的是什么编码格式的，先写个demo验证一下
void test(void){ uint8_t i = 0; char *ch = 鸿蒙; //uint32_t byte; printf(len is %d\r\n,strlen(ch)); for (i = 0; i < strlen(ch); i++) { printf(code is %x \n, *(ch +i)); }} 输出
len is 6code is ffffffe9 code is ffffffb8 code is ffffffbf code is ffffffe8 code is ffffff92 code is ffffff99 整理一下就是 e9b8bf 和 e89299 两个汉字6字节，一个就3字节，证明编码使用utf-8来的
ok，确定了编码之后，该如何进行下一步？我们使用的ssd1306是不包含字库的，所以需要自己生成字库，那么通常的办法是把需要的字体生成字库数组，然后再通过索引找到这个字再显示出来，我这个也是这样的思路，只不过换了个方法来找字体，那就是通过编码来找。
我们可以先把汉字转成utf-8编码，比如“鸿蒙”的编码就是 0xe9b8bf 0xe89299
转换的网站是这个
转换utf-8
在里面生成utf-8编码，然后记住
在代码里创建一个结构体：
typedef struct { unsigned int index; //汉字编码utf-8 unsigned char msk[32]; //字模}typfnt_gb16; 然后创建结构体数组：
typfnt_gb16 cn16_msk[2] = { { 0xe9b8bf, { 0x00,0x80,0x40,0x1f,0x84,0x44,0x44,0x04,0x24,0x44,0xc4,0x47,0x5c,0x48,0x40,0x00, 0x10,0x20,0x7c,0x44,0x64,0x54,0x44,0x4c,0x40,0x7e,0x02,0x02,0x7a,0x02,0x0a,0x04,/*鸿,0*/ }},{ 0xe89299, { 0x08,0xff,0x08,0x7f,0x40,0x8f,0x00,0x7f,0x06,0x3b,0x04,0x19,0x62,0x0c,0x72,0x01, 0x20,0xfe,0x20,0xfe,0x02,0xe4,0x00,0xfc,0x00,0x08,0xb0,0xc0,0xa0,0x98,0x86,0x00,/*蒙,1*/ }},}; 字模生成使用pctolcd 配置是 阴码，顺向，行列式，16进制。
显示中文代码
上面的准备工作做好之后，接下来就是编写显示的函数了，一开始想直接用代码自带的字库数组，无奈，这个代码的作者是使用u16类型来编码的，所以无法适配我们u8类型，所以还是得自己编写，那么实现的代码如下：
void ssd1306_print(uint8_t x, uint8_t y, char *s, ssd1306_color color){ unsigned char i,k,length; uint32_t index = 0; uint8_t b; length = strlen(s);//取字符串总长 for(k=0; k 适配英文字符
为了适配英文，原生字库没有带有8x16大小的英文字符数组，最接近的也是7x10，所以我写了一个8x16显示字符的函数：
char ssd1306_drawchar_u8(char ch, ssd1306_color color) { uint32_t i, j; uint8_t b; // check if character is valid if (ch 126) return 0; // check remaining space on current line if (ssd1306_width < (ssd1306.currentx + 8) || ssd1306_height < (ssd1306.currenty + 16)) { // not enough space on current line return 0; } // use the font to write for(i = 0; i < 16; i++) { // b = font8x16[(ch - 32) * 16 + i]; for(j = 0; j < 8; j++) { if((b << j) & 0x80) { ssd1306_drawpixel(ssd1306.currentx + j, (ssd1306.currenty + i), (ssd1306_color) color); } else { ssd1306_drawpixel(ssd1306.currentx + j, (ssd1306.currenty + i), (ssd1306_color)!color); } } } // the current space is now taken ssd1306.currentx += 8; // return written char for validation return ch;} 这个函数是对应8x16大小的ascii码，如果想换其他的大小的请自己修改。举一反三
如果想使用原生字库，只需把ssd1306_drawchar_u8(*(s+k), color); 改成ssd1306_drawchar((s+k),(字体)， color);
就可以了，不过中英文混搭输出还是字体大小对应得上比较好。
验证
编写好代码之后就是验证阶段了，验证结果也就是开头的效果图，还别说写好这样的代码以后用起来是很方便的。
光路科技工业交换机助力智慧交通行业发展，成为行业新兴力量
苹果回应iPhone12消磁：买个价值479元的MagSafe皮革卡包就可以了
呼气阀气密性测试仪的主要组成是怎样的
芯片缺货潮如何解决?如何看待立讯精密遭美国337调查?工信部回应
触控板和手势组合以控制AR
关于HiSpark WiFi IoT OLED移植到鸿蒙
奇安信推出生态战略计划，携手伙伴共同构建安全行业全景生态
高通预计于 2018 年夏天推出支持 WPA3 安全协议的芯片
全直耦胆石混合功率放大电路的工作原理及制作
运放电路设计实战
2个器件，做1个恒流源
宽带中频数字接收机的FPGA实现
增大升压转换器的效用：以更低电压驱动更重负载
华数机器人六度斩获高工金球奖
为什么dsp非常适合物联网设备使用 为什么DSP与RTOS很匹配？
三星将在2021年推迷你LED背光QLED产品挑战OLED电视
苹果将在圣地亚哥大量招工 试图在高通的地盘上扩大影响力
三极管设计的多级音频放大器
二手信号分析仪
强强联合布局市场 量子点显示技术步入发展快车道
大家好，我是gray,是一名默默无闻的嵌入式软件工程师，比较喜欢钻研新技术，一直关注鸿蒙，由于错过最佳申请板子的时间，现在手头没有开发板，申请的还没有下文，现在借用别人的，下班回来搞搞，希望官方有多的板子能送我一套3861~~，今天就给大家分享一下我的在移植oled到鸿蒙,其实也不叫移植，已经有大佬们移植好了，我只是修改一些函数，让它用起来更加的方便，更加符合我们程序猿的使用风格，今天的主要内容就是让oled能通过printf那样输出字符串，支持中英混合的那种，先看效果图：
可以是这种姿势：
ssd1306_print(0,0,哈喽鸿蒙, white);
这种姿势：
ssd1306_print(0,0,哈喽harmony, white);
甚至还可以这么搞：
sprintf(buff,温度 %d c,20);ssd1306_print(0,32,buff, white);
这样用不比下面的这样的香吗？？？？？？
oled_showchinese(0,0,0); oled_showchinese(16,0,1); oled_showchinese(32,0,2); oled_showchinese(48,0,3); oled_showchinese(64,0,4); oled_showchinese(80,0,5); oled_showchinese(96,0,6); //显示 空气质量检测仪 oled_showstring(0,2,t:); oled_shownum(16,2,temperature,2,16);//显示温度值 oled_showchinese(32,2,8);//显示温度符号 oled_showstring(56,2,r:); oled_showchar(88,2,'%');//显示温度符号 oled_shownum(72,2,humidity,2,16); 传统的这种一个字一条语句，你还得算某个字体有没有越位，或者位置是不是有间隔了。。。这样浪费多少时间，怎么能容忍这样的事情发生呢？坚决不能容忍！！！！接下来看看怎么弄吧~~
移植教程
声明：跟着本教程操作默认你已经搭建好环境，环境搭建可移步：
传送
移植教程已经有了，我是参照润和许老师的教程修改的，移植教程请移步：
[传送]
教程是把代码下载到根目录，并运行，但是我们做项目都是把外设模块统一放在app下执行，所以我的移植是这样的：
1.把代码下载并上传到 linux服务器，我的是虚拟机，直接通过共享文件夹上传到虚拟机桌面，然后敲命令
unzip harmonyos-ssd1306-master.zip -d /home/harmony/harmony/code/code-1.0/applications/sample/wifi-iot/app/
解压到app文件夹：
然后修改app目录下的build.gn ,添加harmonyos-ssd1306:app, 注意分号
然后编译，下载即可。
如何显示中文
我们都知道，oled显示都是ascii码，那中文是用什么码来显示呢？这里普及一下汉字编码知识：
中文汉字：
字节数 : 2;编码：gb2312
字节数 : 2;编码：gbk
字节数 : 2;编码：gb18030
字节数 : 1;编码：iso-8859-1
字节数 : 3;编码：utf-8
字节数 : 4;编码：utf-16
字节数 : 2;编码：utf-16be
字节数 : 2;编码：utf-16le
1、美国人首先对其英文字符进行了编码，也就是最早的ascii码，用一个字节的低7位来表示英文的128个字符，高1位统一为0；
2、后来欧洲人发现尼玛你这128位哪够用，比如我高贵的法国人字母上面的还有注音符，这个怎么区分，得，把高1位编进来吧，这样欧洲普遍使用一个全字节进行编码，最多可表示256位。欧美人就是喜欢直来直去，字符少，编码用得位数少； 3、但是即使位数少，不同国家地区用不同的字符编码，虽然0–127表示的符号是一样的，但是128–255这一段的解释完全乱套了，即使2进制完全一样，表示的字符完全不一样，比如135在法语，希伯来语，俄语编码中完全是不同的符号； 4、更麻烦的是，尼玛这电脑高科技传到中国后，中国人发现我们有10万多个汉字，你们欧美这256字塞牙缝都不够。于是就发明了gb2312这些汉字编码，典型的用2个字节来表示绝大部分的常用汉字，最多可以表示65536个汉字字符，这样就不难理解有些汉字你在新华字典里查得到，但是电脑上如果不处理一下你是显示不出来的了吧。
5、这下各用各的字符集编码，这世界咋统一？俄国人发封email给中国人，两边字符集编码不同，尼玛显示都是乱码啊。为了统一，于是就发明了unicode，将世界上所有的符号都纳入其中，每一个符号都给予一个独一无二的编码，现在unicode可以容纳100多万个符号，每个符号的编码都不一样，这下可统一了，所有语言都可以互通，一个网页页面里可以同时显示各国文字。
6、然而，unicode虽然统一了全世界字符的二进制编码，但没有规定如何存储啊，亲。x86和amd体系结构的电脑小端序和大端序都分不清，别提计算机如何识别到底是unicode还是acsii了。如果unicode统一规定，每个符号用三个或四个字节表示，那么每个英文字母前都必然有二到三个字节是0，文本文件的大小会因此大出二三倍，这对于存储来说是极大的浪费。这样导致一个后果：出现了unicode的多种存储方式。 7、互联网的兴起，网页上要显示各种字符，必须统一啊，亲。utf-8就是unicode最重要的实现方式之一。另外还有utf-16、utf-32等。utf-8不是固定字长编码的，而是一种变长的编码方式。它可以使用1~4个字节表示一个符号，根据不同的符号而变化字节长度。这是种比较巧妙的设计，如果一个字节的第一位是0，则这个字节单独就是一个字符；如果第一位是1，则连续有多少个1，就表示当前字符占用多少个字节。
8、注意unicode的字符编码和utf-8的存储编码表示是不同的，例如严字的unicode码是4e25，utf-8编码是e4b8a5，这个7里面解释了的，utf-8编码不仅考虑了编码，还考虑了存储，e4b8a5是在存储识别编码的基础上塞进了4e25。
9、utf-8 使用一至四个字节为每个字符编码。128 个 ascii 字符（unicode 范围由 u+0000 至 u+007f）只需一个字节，带有变音符号的拉丁文、希腊文、西里尔字母、亚美尼亚语、希伯来文、阿拉伯文、叙利亚文及马尔代夫语（unicode 范围由 u+0080 至 u+07ff）需要二个字节，其他基本多文种平面（bmp）中的字符（cjk属于此类-qieqie注）使用三个字节，其他 unicode 辅助平面的字符使用四字节编码。
所以。。我们可以看看在鸿蒙系统上使用的是什么编码格式的，先写个demo验证一下
void test(void){ uint8_t i = 0; char *ch = 鸿蒙; //uint32_t byte; printf(len is %d\r\n,strlen(ch)); for (i = 0; i < strlen(ch); i++) { printf(code is %x \n, *(ch +i)); }} 输出
len is 6code is ffffffe9 code is ffffffb8 code is ffffffbf code is ffffffe8 code is ffffff92 code is ffffff99 整理一下就是 e9b8bf 和 e89299 两个汉字6字节，一个就3字节，证明编码使用utf-8来的
ok，确定了编码之后，该如何进行下一步？我们使用的ssd1306是不包含字库的，所以需要自己生成字库，那么通常的办法是把需要的字体生成字库数组，然后再通过索引找到这个字再显示出来，我这个也是这样的思路，只不过换了个方法来找字体，那就是通过编码来找。
我们可以先把汉字转成utf-8编码，比如“鸿蒙”的编码就是 0xe9b8bf 0xe89299
转换的网站是这个
转换utf-8
在里面生成utf-8编码，然后记住
在代码里创建一个结构体：
typedef struct { unsigned int index; //汉字编码utf-8 unsigned char msk[32]; //字模}typfnt_gb16; 然后创建结构体数组：
typfnt_gb16 cn16_msk[2] = { { 0xe9b8bf, { 0x00,0x80,0x40,0x1f,0x84,0x44,0x44,0x04,0x24,0x44,0xc4,0x47,0x5c,0x48,0x40,0x00, 0x10,0x20,0x7c,0x44,0x64,0x54,0x44,0x4c,0x40,0x7e,0x02,0x02,0x7a,0x02,0x0a,0x04,/*鸿,0*/ }},{ 0xe89299, { 0x08,0xff,0x08,0x7f,0x40,0x8f,0x00,0x7f,0x06,0x3b,0x04,0x19,0x62,0x0c,0x72,0x01, 0x20,0xfe,0x20,0xfe,0x02,0xe4,0x00,0xfc,0x00,0x08,0xb0,0xc0,0xa0,0x98,0x86,0x00,/*蒙,1*/ }},}; 字模生成使用pctolcd 配置是 阴码，顺向，行列式，16进制。
显示中文代码
上面的准备工作做好之后，接下来就是编写显示的函数了，一开始想直接用代码自带的字库数组，无奈，这个代码的作者是使用u16类型来编码的，所以无法适配我们u8类型，所以还是得自己编写，那么实现的代码如下：
void ssd1306_print(uint8_t x, uint8_t y, char *s, ssd1306_color color){ unsigned char i,k,length; uint32_t index = 0; uint8_t b; length = strlen(s);//取字符串总长 for(k=0; k
为了适配英文，原生字库没有带有8x16大小的英文字符数组，最接近的也是7x10，所以我写了一个8x16显示字符的函数：
char ssd1306_drawchar_u8(char ch, ssd1306_color color) { uint32_t i, j; uint8_t b; // check if character is valid if (ch 126) return 0; // check remaining space on current line if (ssd1306_width < (ssd1306.currentx + 8) || ssd1306_height < (ssd1306.currenty + 16)) { // not enough space on current line return 0; } // use the font to write for(i = 0; i < 16; i++) { // b = font8x16[(ch - 32) * 16 + i]; for(j = 0; j < 8; j++) { if((b << j) & 0x80) { ssd1306_drawpixel(ssd1306.currentx + j, (ssd1306.currenty + i), (ssd1306_color) color); } else { ssd1306_drawpixel(ssd1306.currentx + j, (ssd1306.currenty + i), (ssd1306_color)!color); } } } // the current space is now taken ssd1306.currentx += 8; // return written char for validation return ch;} 这个函数是对应8x16大小的ascii码，如果想换其他的大小的请自己修改。举一反三
如果想使用原生字库，只需把ssd1306_drawchar_u8(*(s+k), color); 改成ssd1306_drawchar((s+k),(字体)， color);
就可以了，不过中英文混搭输出还是字体大小对应得上比较好。
验证
编写好代码之后就是验证阶段了，验证结果也就是开头的效果图，还别说写好这样的代码以后用起来是很方便的。
光路科技工业交换机助力智慧交通行业发展，成为行业新兴力量
苹果回应iPhone12消磁：买个价值479元的MagSafe皮革卡包就可以了
呼气阀气密性测试仪的主要组成是怎样的
芯片缺货潮如何解决?如何看待立讯精密遭美国337调查?工信部回应
触控板和手势组合以控制AR
关于HiSpark WiFi IoT OLED移植到鸿蒙
奇安信推出生态战略计划，携手伙伴共同构建安全行业全景生态
高通预计于 2018 年夏天推出支持 WPA3 安全协议的芯片
全直耦胆石混合功率放大电路的工作原理及制作
运放电路设计实战
2个器件，做1个恒流源
宽带中频数字接收机的FPGA实现
增大升压转换器的效用：以更低电压驱动更重负载
华数机器人六度斩获高工金球奖
为什么dsp非常适合物联网设备使用 为什么DSP与RTOS很匹配？
三星将在2021年推迷你LED背光QLED产品挑战OLED电视
苹果将在圣地亚哥大量招工 试图在高通的地盘上扩大影响力
三极管设计的多级音频放大器
二手信号分析仪
强强联合布局市场 量子点显示技术步入发展快车道