返回发烧友论坛
发 帖  

[]鸿蒙HiSpark WiFi IoT------OLED移植和修改

伤
2020-11-01 21:13:33
阅读量0
OLED鸿蒙系统HarmonyOS鸿蒙OS
0
0
大家好，我是Gray,是一名默默无闻的嵌入式软件工程师，比较喜欢钻研新技术，一直关注鸿蒙，由于错过最佳申请板子的时间，现在手头没有开发板，申请的还没有下文，现在借用别人的，下班回来搞搞，希望官方有多的板子能送我一套3861~~，今天就给大家分享一下我的在移植OLED到鸿蒙,其实也不叫移植，已经有大佬们移植好了，我只是修改一些函数，让它用起来更加的方便，更加符合我们程序猿的使用风格，今天的主要内容就是让OLED能通过printf那样输出字符串，支持中英混合的那种，先看效果图：
可以是这种姿势：
  1. ssd1306_Print(0,0,"哈喽鸿蒙", White);
复制代码
==》
这种姿势：
  1. ssd1306_Print(0,0,"哈喽Harmony", White);
复制代码

==》
甚至还可以这么搞：
  1. <div align="left">sprintf(buff,"温度 %d C",20);</div><div align="left">ssd1306_Print(0,32,buff, White);</div>
复制代码

==》
这样用不比下面的这样的香吗？？？？？？
      
  1. OLED_ShowCHinese(0,0,0);
  2.                 OLED_ShowCHinese(16,0,1);
  3.                 OLED_ShowCHinese(32,0,2);
  4.                 OLED_ShowCHinese(48,0,3);
  5.                 OLED_ShowCHinese(64,0,4);
  6.                 OLED_ShowCHinese(80,0,5);
  7.                 OLED_ShowCHinese(96,0,6); //显示 空气质量检测仪
  8.                

  10.                
  11.                 OLED_ShowString(0,2,"T:");
  12.             OLED_ShowNum(16,2,temperature,2,16);//显示温度值
  13.                 OLED_ShowCHinese(32,2,8);//显示温度符号
  14.                 OLED_ShowString(56,2,"R:");
  15.                 OLED_ShowChar(88,2,'%');//显示温度符号
  16.                 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验证一下
  1. void test(void)
  2. {
  3.     uint8_t i = 0;
  4.    
  5.     char *ch = "鸿蒙";
  6.    
  7.     //uint32_t byte;

  9.     printf("len is %drn",strlen(ch));

  11.     for (i = 0; i < strlen(ch); i++)
  12.     {
  13.         printf("code is %x n", *(ch +i));
  14.     }
  15. }   
复制代码


输出：
  1. <div align="left">len is 6</div><div align="left">code is ffffffe9</div><div align="left">code is ffffffb8</div><div align="left">code is ffffffbf</div><div align="left">code is ffffffe8</div><div align="left">code is ffffff92</div><div align="left">code is ffffff99</div>
复制代码

整理一下就是 e9b8bf 和 e89299 两个汉字6字节，一个就3字节，证明编码使用UTF-8来的
OK，确定了编码之后，该如何进行下一步？我们使用的ssd1306是不包含字库的，所以需要自己生成字库，那么通常的办法是把需要的字体生成字库数组，然后再通过索引找到这个字再显示出来，我这个也是这样的思路，只不过换了个方法来找字体，那就是通过编码来找。
我们可以先把汉字转成utf-8编码，比如“鸿蒙”的编码就是 0xe9b8bf  0xe89299
转换的网站是这个
[转换UTF-8]
在里面生成UTF-8编码，然后记住
在代码里创建一个结构体：
  1. typedef struct
  2. {
  3.   unsigned int Index;   //汉字编码UTF-8
  4.   unsigned char Msk[32]; //字模
  5. }typFNT_GB16;
复制代码

然后创建结构体数组：
  1. typFNT_GB16 CN16_Msk[2] = {  
  2. {
  3.     0xE9B8BF,
  4.     {      
  5.         0x00,0x80,0x40,0x1F,0x84,0x44,0x44,0x04,0x24,0x44,0xC4,0x47,0x5C,0x48,0x40,0x00,
  6.         0x10,0x20,0x7C,0x44,0x64,0x54,0x44,0x4C,0x40,0x7E,0x02,0x02,0x7A,0x02,0x0A,0x04,/*"鸿",0*/
  7.     }
  8. },

  10. {
  11.     0xE89299,
  12.     {
  13.         0x08,0xFF,0x08,0x7F,0x40,0x8F,0x00,0x7F,0x06,0x3B,0x04,0x19,0x62,0x0C,0x72,0x01,
  14.         0x20,0xFE,0x20,0xFE,0x02,0xE4,0x00,0xFC,0x00,0x08,0xB0,0xC0,0xA0,0x98,0x86,0x00,/*"蒙",1*/
  15.     }
  16. },
  17. };
复制代码

字模生成使用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<length; k++)
        {
                if((uint8_t)(*(s+k)) <= 127){//小于128是ASCII符号
            ssd1306_SetCursor(x,y);
            ssd1306_DrawChar_u8(*(s+k), color);
                        x += 8;//x坐标右移8
                }
        else if((uint8_t)(*(s+k)) > 127){//大于127，为汉字，UTF-8是3个字节   
                 Index = ((uint8_t)(*(s+k)) << 16) | ((uint8_t)(*(s+k+1)) << 8) | (uint8_t)((s+k+2));
            //取汉字的编码
                        //printf("byte is %x  rn", Index );       
            for(i=0;i<sizeof(CN16_Msk)/34;i++){//查数组
                                if(Index == CN16_Msk.Index){
                                        //查询到这个字
                                //        printf("Pindex is %d, %drn",i,color);
                    for (uint8_t t = 0; t < 2; t++)
                    {                                                                 
                        for(uint8_t k = (0 + 16 * t); k < (16 + 16 * t); k++) {    //
                            b = CN16_Msk.Msk[k];
                            for(uint8_t j = 0; j < 8; j++) {
                                if((b << j) & 0x80)  {                  
                                    ssd1306_DrawPixel(x + j, (y + k % 16), color);
                                } else {                              
                                    ssd1306_DrawPixel(x + j, (y + k % 16), !color);
                                }
                            }
                           // printf("n");
                        }
                        x += 8;
                    }
                                        k += 2; //汉字占3B,跳过2个       
                                }
                        }
                }
        }
}


核心也是画点函数，根据字节来确定是否点亮那个位置，
适配英文字符
为了适配英文，原生字库没有带有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 < 32 || 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);
就可以了，不过中英文混搭输出还是字体大小对应得上比较好。

验证
        编写好代码之后就是验证阶段了，验证结果也就是开头的效果图，还别说写好这样的代码以后用起来是很方便的。
代码链接：Gray
举报

回帖

声明：本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人，不代表电子发烧友网立场。文章及其配图仅供工程师学习之用，如有内容图片侵权或者其他问题，请联系本站作侵删。 侵权投诉
版权所有 © 深圳华秋电子有限公司 电子发烧友（电路图）粤公网安备44030402000349号 电信与信息服务业务经营许可证：粤B2-20160233 工商网监 湘ICP备2023018690号