I2C通信实例 - OLED显示 03

2022-11-17 13:12:23 HarmonyOS ℃

　　前文回顾：

　　I2C通信实例 - OLED显示 01I2C通信实例 - OLED显示 02书接前文，接下来开始编写管理OLED显示的功能函数。

　　OLED初始化

　　OLED首次点亮前要做一些初始化工作。比如设置复用路数，偏移量，对比度，显示模式等等。如果默认不满足要求的，可以再次一并设置。可以参考SSD1306手册中推荐的初始化流程图进行初始化。

　　void OLED_Init(void) { u8 cmdlist[] = { DISPLAY_SLEEP, //Display OFF SET_MUX, 0x1F, //Multiplex ratio. No. of row to drive. SET_DISP_OFFSET, 0x00, //No vertical shift RAM_START_LINE+0U, //Start line SEG_REMAP_OFF,//Remap COL0 to SEG127 R<->L SET_COM_PIN, 0x02, //No Remap. COM_SCAN_INCR, //COM scan direction: from COM0 to COM(N-1) SET_CONTRAST, 0x0F, //contrast DISPLAY_ENTIRE_RAM, //Disable entire display ON DISPLAY_NORMAL, //Set display mode SET_OSC_FRE, 0x80,//FOCS1111, DCLK=Fosc/1 SET_PRE_CHARGE, 0x22, //Phase 1 and 2 all 2 DCLK SET_VCOMH_LEVEL, 0x30, // 0.83Vcc }; OLED_Write_CMD(cmdlist, sizeof(cmdlist)); OLED_Display_PowOn(); OLED_Clear();}cmdlist数组中的指令没有严格的顺序。双参数或多参数的指令可以放到同一行，提高程序的可读性。最后通过OLED_Write_CMD函数一次性发送给OLED控制器。最后两个函数是上电和清屏。

　　OLED显示控制

　　开启OLED的顺序是先开启电荷泵，然后开启屏幕显示；关闭是要先关掉电荷泵，然后关闭屏幕显示。常用的显示控制函数示例如下：

　　//Power on OLEDvoid OLED_Display_PowOn(void) { u8 cmdlist[] = {SET_CHARGE_PUMP, CHARGE_PUMP_ON, DISPALY_AWAKE}; OLED_Write_CMD(cmdlist, sizeof(cmdlist));}//Power off OLEDvoid OLED_Display_PowOff(void) { u8 cmdlist[] = {SET_CHARGE_PUMP, CHARGE_PUMP_OFF, DISPLAY_SLEEP}; OLED_Write_CMD(cmdlist, sizeof(cmdlist));}//Set Contrast. ctrst=[20-255]void OLDE_Set_Contrast(u16 ctrst){ u8 cmdlist[2] = {0U}; if (ctrst>255U) ctrst = 255U; if (ctrst<20U) ctrst = 20U; cmdlist[0] = SET_CONTRAST; cmdlist[1] = ctrst; //contrast OLED_Write_CMD(cmdlist, 2U);}//Clear GDDRAMvoid OLED_Clear(void) { u8 databuff[128] = {0U}; u8 i; for (i = 0U; i<Max_Page; i++) { OLED_Set_Pos(0U, i);//Page i OLED_Write_DAT(databuff, 128U); }}如果不关电荷泵，仅发送DISPLAY_SLEEP指令可以仅关闭屏幕，进入休眠。再次发送DISPALY_AWAKE指令可以恢复显示。但是如果关闭了电荷泵，DISPLAY_SLEEP后再发送DISPALY_AWAKE并不会恢复显示。OLDE_Set_Contrast函数用于设置对比度，0-255共256级，但太低意义不大，所以对范围进行了限制。OLED_Clear函数将显存逐页清零（清屏）。

　　OLED字符显示函数

　　信息的显示是把点阵字符写入到显存中的指定位置。需要提前准备好字符库。

　　//Display character at (Col x, page y)static void OLED_ShowChar(u8 x, u8 y, u8 chr, u8 Char_Hight) { u8 c = 0U, i = 0U; u8 hlfchr[8] = {0U}; c = chr-' '; //Subtract first character in ASCII table if (x>Max_Col-1) { //Go to Next Page x = 0; y = y+2; } if (Char_Hight==16) { OLED_Set_Pos(x, y);//upper page for (i = 0U; i<8U; i++) hlfchr[i] = ASCII8X16[c][i]; OLED_Write_DAT(hlfchr, 8U); OLED_Set_Pos(x, y+1);//lower page for (i = 0U; i<8U; i++) hlfchr[i] = ASCII8X16[c][i+8U]; OLED_Write_DAT(hlfchr, 8U); } else { OLED_Set_Pos(x, y);//single page for (i = 0U; i<6U; i++) hlfchr[i] = ASCII6x8[c][i]; OLED_Write_DAT(hlfchr, 6U); }}//Display a string specified like "string".void OLED_ShowString(u8 x, u8 y, char *chr, u8 Char_Hight) { u8 j = 0; while (chr[j]!='\0') { OLED_ShowChar(x, y, chr[j], Char_Hight); x += 8; if (x>120) { x = 0; y += 2; } j++; }}高度为16个像素的字符占两页，需要分两次写入。注意这里虽然也有个循环，但只是把一行的前8列和后8列分别整理到缓存数组中，然后调用OLED_Write_DAT一次写入8个字节，异于通常的逐字节写入。原因前面已多次解释，不再赘述。按8个字节分页的原因是，英文字符是半角字符。*ShowString在*ShowChar的基础上，使我们可以一次写入任意多个字符。有了*ShowString，*ShowChar在.c文件外部完全可以不用，因此声明为Static。

　　ASCII码中包含所有的数字，因此没有必要编写*ShowNumber。显示数字时用sprintf函数把数字打印到一个字符串中，然后调用*ShowString就可以了。

　　汉字是全角字符，需要单独处理。16×16的点阵字整好占两行，因此逐行发送即可。

　　//Display Chinese Charactervoid OLED_ShowChinese(u8 x, u8 y, u8 no) { OLED_Set_Pos(x, y);//upper page OLED_Write_DAT((u8*)&HZ16X16[2U*no],16U); OLED_Set_Pos(x, y+1U);//lower page OLED_Write_DAT((u8*)&HZ16X16[2U*no+1U],16U);}效果

图1. 显示效果图