效果圖

大家好，我是Gray,是一名默默無(wú)聞的嵌入式軟件工程師，比較喜歡鉆研新技術(shù)，一直關(guān)注鴻蒙，由于錯(cuò)過(guò)最佳申請(qǐng)板子的時(shí)間，現(xiàn)在手頭沒(méi)有開(kāi)發(fā)板，申請(qǐng)的還沒(méi)有下文，現(xiàn)在借用別人的，下班回來(lái)搞搞，希望官方有多的板子能送我一套3861~~，今天就給大家分享一下我的在移植OLED到鴻蒙,其實(shí)也不叫移植，已經(jīng)有大佬們移植好了，我只是修改一些函數(shù)，讓它用起來(lái)更加的方便，更加符合我們程序猿的使用風(fēng)格，今天的主要內(nèi)容就是讓OLED能通過(guò)Printf那樣輸出字符串，支持中英混合的那種，先看效果圖：

可以是這種姿勢(shì)：

ssd1306_Print(0,0,"哈嘍鴻蒙", White);

這種姿勢(shì)：

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); //顯示 空氣質(zhì)量檢測(cè)儀

		OLED_ShowString(0,2,"T:");
    	OLED_ShowNum(16,2,temperature,2,16);//顯示溫度值
		OLED_ShowCHinese(32,2,8);//顯示溫度符號(hào)
		OLED_ShowString(56,2,"R:");
		OLED_ShowChar(88,2,'%');//顯示溫度符號(hào)
		OLED_ShowNum(72,2,humidity,2,16);

傳統(tǒng)的這種一個(gè)字一條語(yǔ)句，你還得算某個(gè)字體有沒(méi)有越位，或者位置是不是有間隔了。。。這樣浪費(fèi)多少時(shí)間，怎么能容忍這樣的事情發(fā)生呢？堅(jiān)決不能容忍！?。?！接下來(lái)看看怎么弄吧~~

移植教程

聲明：跟著本教程操作默認(rèn)你已經(jīng)搭建好環(huán)境，環(huán)境搭建可移步：

傳送

移植教程已經(jīng)有了，我是參照潤(rùn)和許老師的教程修改的，移植教程請(qǐng)移步：

[傳送]

教程是把代碼下載到根目錄，并運(yùn)行，但是我們做項(xiàng)目都是把外設(shè)模塊統(tǒng)一放在app下執(zhí)行，所以我的移植是這樣的：

1.把代碼下載并上傳到 linux服務(wù)器，我的是虛擬機(jī)，直接通過(guò)共享文件夾上傳到虛擬機(jī)桌面，然后敲命令

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", 注意分號(hào)

然后編譯，下載即可。

如何顯示中文

我們都知道，oled顯示都是ascii碼，那中文是用什么碼來(lái)顯示呢？這里普及一下漢字編碼知識(shí)：

中文漢字：

字節(jié)數(shù) : 2;編碼：GB2312

字節(jié)數(shù) : 2;編碼：GBK

字節(jié)數(shù) : 2;編碼：GB18030

字節(jié)數(shù) : 1;編碼：ISO-8859-1

字節(jié)數(shù) : 3;編碼：UTF-8

字節(jié)數(shù) : 4;編碼：UTF-16

字節(jié)數(shù) : 2;編碼：UTF-16BE

字節(jié)數(shù) : 2;編碼：UTF-16LE

1、美國(guó)人首先對(duì)其英文字符進(jìn)行了編碼，也就是最早的ascii碼，用一個(gè)字節(jié)的低7位來(lái)表示英文的128個(gè)字符，高1位統(tǒng)一為0；

2、后來(lái)歐洲人發(fā)現(xiàn)尼瑪你這128位哪夠用，比如我高貴的法國(guó)人字母上面的還有注音符，這個(gè)怎么區(qū)分，得，把高1位編進(jìn)來(lái)吧，這樣歐洲普遍使用一個(gè)全字節(jié)進(jìn)行編碼，最多可表示256位。歐美人就是喜歡直來(lái)直去，字符少，編碼用得位數(shù)少； 3、但是即使位數(shù)少，不同國(guó)家地區(qū)用不同的字符編碼，雖然0–127表示的符號(hào)是一樣的，但是128–255這一段的解釋完全亂套了，即使2進(jìn)制完全一樣，表示的字符完全不一樣，比如135在法語(yǔ)，希伯來(lái)語(yǔ)，俄語(yǔ)編碼中完全是不同的符號(hào)； 4、更麻煩的是，尼瑪這電腦高科技傳到中國(guó)后，中國(guó)人發(fā)現(xiàn)我們有10萬(wàn)多個(gè)漢字，你們歐美這256字塞牙縫都不夠。于是就發(fā)明了GB2312這些漢字編碼，典型的用2個(gè)字節(jié)來(lái)表示絕大部分的常用漢字，最多可以表示65536個(gè)漢字字符，這樣就不難理解有些漢字你在新華字典里查得到，但是電腦上如果不處理一下你是顯示不出來(lái)的了吧。

5、這下各用各的字符集編碼，這世界咋統(tǒng)一？俄國(guó)人發(fā)封email給中國(guó)人，兩邊字符集編碼不同，尼瑪顯示都是亂碼啊。為了統(tǒng)一，于是就發(fā)明了unicode，將世界上所有的符號(hào)都納入其中，每一個(gè)符號(hào)都給予一個(gè)獨(dú)一無(wú)二的編碼，現(xiàn)在unicode可以容納100多萬(wàn)個(gè)符號(hào)，每個(gè)符號(hào)的編碼都不一樣，這下可統(tǒng)一了，所有語(yǔ)言都可以互通，一個(gè)網(wǎng)頁(yè)頁(yè)面里可以同時(shí)顯示各國(guó)文字。

6、然而，unicode雖然統(tǒng)一了全世界字符的二進(jìn)制編碼，但沒(méi)有規(guī)定如何存儲(chǔ)啊，親。x86和amd體系結(jié)構(gòu)的電腦小端序和大端序都分不清，別提計(jì)算機(jī)如何識(shí)別到底是unicode還是acsii了。如果Unicode統(tǒng)一規(guī)定，每個(gè)符號(hào)用三個(gè)或四個(gè)字節(jié)表示，那么每個(gè)英文字母前都必然有二到三個(gè)字節(jié)是0，文本文件的大小會(huì)因此大出二三倍，這對(duì)于存儲(chǔ)來(lái)說(shuō)是極大的浪費(fèi)。這樣導(dǎo)致一個(gè)后果：出現(xiàn)了Unicode的多種存儲(chǔ)方式。 7、互聯(lián)網(wǎng)的興起，網(wǎng)頁(yè)上要顯示各種字符，必須統(tǒng)一啊，親。utf-8就是Unicode最重要的實(shí)現(xiàn)方式之一。另外還有utf-16、utf-32等。UTF-8不是固定字長(zhǎng)編碼的，而是一種變長(zhǎng)的編碼方式。它可以使用1~4個(gè)字節(jié)表示一個(gè)符號(hào)，根據(jù)不同的符號(hào)而變化字節(jié)長(zhǎng)度。這是種比較巧妙的設(shè)計(jì)，如果一個(gè)字節(jié)的第一位是0，則這個(gè)字節(jié)單獨(dú)就是一個(gè)字符；如果第一位是1，則連續(xù)有多少個(gè)1，就表示當(dāng)前字符占用多少個(gè)字節(jié)。

8、注意unicode的字符編碼和utf-8的存儲(chǔ)編碼表示是不同的，例如"嚴(yán)"字的Unicode碼是4E25，UTF-8編碼是E4B8A5，這個(gè)7里面解釋了的，UTF-8編碼不僅考慮了編碼，還考慮了存儲(chǔ)，E4B8A5是在存儲(chǔ)識(shí)別編碼的基礎(chǔ)上塞進(jìn)了4E25。

9、UTF-8 使用一至四個(gè)字節(jié)為每個(gè)字符編碼。128 個(gè) ASCII 字符（Unicode 范圍由 U+0000 至 U+007F）只需一個(gè)字節(jié)，帶有變音符號(hào)的拉丁文、希臘文、西里爾字母、亞美尼亞語(yǔ)、希伯來(lái)文、阿拉伯文、敘利亞文及馬爾代夫語(yǔ)（Unicode 范圍由 U+0080 至 U+07FF）需要二個(gè)字節(jié)，其他基本多文種平面（BMP）中的字符（CJK屬于此類(lèi)-Qieqie注）使用三個(gè)字節(jié)，其他 Unicode 輔助平面的字符使用四字節(jié)編碼。

所以。。我們可以看看在鴻蒙系統(tǒng)上使用的是什么編碼格式的，先寫(xiě)個(gè)demo驗(yàn)證一下

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 6
code is ffffffe9 
code is ffffffb8 
code is ffffffbf 
code is ffffffe8 
code is ffffff92 
code is ffffff99 

整理一下就是 e9b8bf 和 e89299 兩個(gè)漢字6字節(jié)，一個(gè)就3字節(jié)，證明編碼使用UTF-8來(lái)的

OK，確定了編碼之后，該如何進(jìn)行下一步？我們使用的ssd1306是不包含字庫(kù)的，所以需要自己生成字庫(kù)，那么通常的辦法是把需要的字體生成字庫(kù)數(shù)組，然后再通過(guò)索引找到這個(gè)字再顯示出來(lái)，我這個(gè)也是這樣的思路，只不過(guò)換了個(gè)方法來(lái)找字體，那就是通過(guò)編碼來(lái)找。

我們可以先把漢字轉(zhuǎn)成utf-8編碼，比如“鴻蒙”的編碼就是 0xe9b8bf 0xe89299

轉(zhuǎn)換的網(wǎng)站是這個(gè)

轉(zhuǎn)換UTF-8

在里面生成UTF-8編碼，然后記住

在代碼里創(chuàng)建一個(gè)結(jié)構(gòu)體：

typedef struct 
{
  unsigned int Index;   //漢字編碼UTF-8
  unsigned char Msk[32]; //字模
}typFNT_GB16;

然后創(chuàng)建結(jié)構(gòu)體數(shù)組：

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進(jìn)制。

顯示中文代碼

上面的準(zhǔn)備工作做好之后，接下來(lái)就是編寫(xiě)顯示的函數(shù)了，一開(kāi)始想直接用代碼自帶的字庫(kù)數(shù)組，無(wú)奈，這個(gè)代碼的作者是使用u16類(lèi)型來(lái)編碼的，所以無(wú)法適配我們u8類(lèi)型，所以還是得自己編寫(xiě)，那么實(shí)現(xiàn)的代碼如下：

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);//取字符串總長(zhǎng)
	for(k=0; k 127){//大于127，為漢字，UTF-8是3個(gè)字節(jié)    
         	Index = ((uint8_t)(*(s+k)) << 16) | ((uint8_t)(*(s+k+1)) << 8) | (uint8_t)((s+k+2));
            //取漢字的編碼
			//printf("byte is %x  \r\n", Index );	
            for(i=0;i

	核心也是畫(huà)點(diǎn)函數(shù)，根據(jù)字節(jié)來(lái)確定是否點(diǎn)亮那個(gè)位置，

	適配英文字符

	為了適配英文，原生字庫(kù)沒(méi)有帶有8x16大小的英文字符數(shù)組，最接近的也是7x10，所以我寫(xiě)了一個(gè)8x16顯示字符的函數(shù)：
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;
}

	這個(gè)函數(shù)是對(duì)應(yīng)8x16大小的ascii碼，如果想換其他的大小的請(qǐng)自己修改。舉一反三

	如果想使用原生字庫(kù)，只需把ssd1306_DrawChar_u8(*(s+k), color); 改成ssd1306_DrawChar((s+k),(字體)， color);

	就可以了，不過(guò)中英文混搭輸出還是字體大小對(duì)應(yīng)得上比較好。

	驗(yàn)證

	? 編寫(xiě)好代碼之后就是驗(yàn)證階段了，驗(yàn)證結(jié)果也就是開(kāi)頭的效果圖，還別說(shuō)寫(xiě)好這樣的代碼以后用起來(lái)是很方便的。

	編輯：hfy