【普中Hi3861开发攻略--基于鸿蒙OS】-- 第 24 章 OLED液晶显示实验

(1)实验平台：

普中Hi3861鸿蒙物联网WIFI套件https://item.taobao.com/item.htm?id=829136021914(2)资料下载：普中科技-各型号产品资料下载链接

前面我们学习过很多传感器模块都需要显示数据，当时使用软件串口监视器输出，对于需要脱离电脑运行查看数据时，就显得很不方便。因此就引出本章OLED 液晶显示。本章学习使用 Hi3861 的 I2C 控制 OLED 液晶显示字符图形。通过本章学习，大家可以尝试将之前在串口监视器显示的数据信息放在 OLED 上显示。本章分为如下几部分内容：

[24.1 实验介绍](#24.1 实验介绍)

[24.1.1 实验简介](#24.1.1 实验简介)

[24.1.2 实验目的](#24.1.2 实验目的)

[24.1.3 IIC 函数使用](#24.1.3 IIC 函数使用)

[24.1.3.1 hi_i2c_init()函数](#24.1.3.1 hi_i2c_init()函数)

[24.1.3.2 hi_i2c_deinit()函数](#24.1.3.2 hi_i2c_deinit()函数)

[24.1.3.3 hi_i2c_write()函数](#24.1.3.3 hi_i2c_write()函数)

[24.1.3.4 hi_i2c_read()函数](#24.1.3.4 hi_i2c_read()函数)

[24.1.3.5 hi_i2c_set_baudrate()函数](#24.1.3.5 hi_i2c_set_baudrate()函数)

[24.2 硬件设计](#24.2 硬件设计)

[24.3 软件设计](#24.3 软件设计)

[24.4 实验现象](#24.4 实验现象)

24.1 实验介绍

24.1.1 实验简介

OLED，即有机发光二极管（ Organic Light Emitting Diode）。 OLED 由于同时具备自发光，不需背光源、对比度高、厚度薄、视角广、反应速度快、可用于挠曲性面板、使用温度范围广、构造及制程较简单等优异之特性，被认为是下一代的平面显示器新兴应用技术。 LCD 都需要背光，而 OLED 不需要，因为它是自发光的。这样同样的显示 OLED 效果要来得更好一些。以目前的技术， OLED 的尺寸还难以大型化，但是分辨率确可以做到很高。我们使用的是 0.96 寸 OLED显示屏，内部驱动芯片是 SSD1306，如下图所示：

该屏有以下特点：

●0.96 寸 OLED 有黄蓝，白，蓝三种颜色可选；其中黄蓝是屏上 1/4 部分为黄光，下 3/4 为蓝；而且是固定区域显示固定颜色，颜色和显示区域均不能修改；白光则为纯白，也就是黑底白字；蓝色则为纯蓝，也就是黑底蓝字。

●分辨率为 128*64

●多种接口方式； OLED 裸屏总共种接口包括： 6800、 8080 两种并行接口方式、 3 线或 4 线的串行 SPI 接口方式、 IIC 接口方式（只需要 2 根线就可以控制 OLED），这五种接口是通过屏上的 BS0-BS2 来配置的。

本教程使用的是 0.96 寸 OLED（IIC 接口）模块，如下所示：

管脚功能介绍：

GND：电源地； VDD：电源正（3-5.5V）； SCK： I2C 时钟管脚； SDA： I2C 数据管脚；

I2C 是用于设备之间通信的双线协议，在物理层面，它由 2 条线组成： SCL和 SDA，分别是时钟线和数据线。也就是说不同设备间通过这两根线就可以进行通信。

Hi3861 有 2 硬件 I2C 接口，硬件 I2C 接口通过配置可在多个 IO 口使用。软件 I2C 接口可通过配置在任意 IO 口使用，相当于使用 IO 口模拟 I2C 时序。本实验使用硬件 I2C 来与 OLED 通信。

24.1.2 实验目的

通过硬件 I2C 控制 OLED 液晶显示字符。

24.1.3 IIC 函数使用

24.1.3.1 hi_i2c_init()函数

初始化 I2C 设备，并指定波特率；函数原型：

cpp 复制代码

hi_u32 hi_i2c_init(hi_i2c_idx id, hi_u32 baudrate);

参数：

id： I2C 设备 ID，可选择如下：

baudrate： I2C 通信波特率

返回值： 0 成功， 1 失败；

24.1.3.2 hi_i2c_deinit()函数

退出 I2C 模块；函数原型：

cpp 复制代码

hi_u32 hi_i2c_deinit(hi_i2c_idx id);

参数：

id： I2C 设备 ID。

返回值： 0 成功， 1 失败；

24.1.3.3 hi_i2c_write()函数

将数据写入 I2C 设备；函数原型：

cpp 复制代码

hi_u32 hi_i2c_write(hi_i2c_idx id, hi_u16 device_addr, const hi_i2c_data *i2c_data);

参数：

id： I2C 设备 id

device_addr： I2C 设备地址

i2c_data：指向要写入/接收的数据的指针，包括写入和读取数据长度等；

返回值： 0 成功， 1 失败；

24.1.3.4 hi_i2c_read()函数

从 I2C 设备读取数据；函数原型：

cpp 复制代码

hi_u32 hi_i2c_read(hi_i2c_idx id, hi_u16 device_addr, const hi_i2c_data *i2c_data);

参数：

id： I2C 设备 id

device_addr： I2C 设备地址

i2c_data：指向要写入/接收的数据的指针，包括写入和读取数据长度等；

返回值： 0 成功， 1 失败；

24.1.3.5 hi_i2c_set_baudrate()函数

设置 I2C 设备波特率；函数原型：

cpp 复制代码

hi_u32 hi_i2c_set_baudrate(hi_i2c_idx id, hi_u32 baudrate);

参数：

id： I2C 设备 id

baudrate： I2C 通信波特率

返回值： 0 成功， 1 失败；

24.2 硬件设计

本实验使用到硬件资源如下：

（1） 0.96 寸 IIC 接口 OLED 模块

（2） Hi3861 GPIO

OLED 接口电路如下：

从上图可知，板载 OLED 接口均连接到指定 IO。

24.3 软件设计

将前面章节创建好的工程模板，复制一份，重命名为 20_oled，如下所示：

然后在如下路径下新建 bsp_oled.c、 bsp_oled.h 和文件：

oledfont.h 文件用于存放 OLED 显示所需字库数据。

（1）修改 demo 文件夹下的 BUILD.gn 文件，如下所示：

（2）添加工程编译文件路径，如下所示

（3）修改 bsp_oled.c 文件，代码如下：

cpp 复制代码

/**
 ****************************************************************************************************
 * @file        bsp_oled.c
 * @author      普中科技
 * @version     V1.0
 * @date        2024-06-05
 * @brief       OLED液晶显示实验
 * @license     Copyright (c) 2024-2034, 深圳市普中科技有限公司
 ****************************************************************************************************
 * @attention
 *
 * 实验平台:普中-Hi3861
 * 在线视频:https://space.bilibili.com/2146492485
 * 公司网址:www.prechin.cn
 * 购买地址:
 *
 */

#include "bsp_oled.h"
#include <unistd.h>
#include "hi_time.h"
#include "hi_i2c.h"
#include "oledfont.h" 


//OLED的显存
//存放格式如下.
//[0]0 1 2 3 ... 127	
//[1]0 1 2 3 ... 127	
//[2]0 1 2 3 ... 127	
//[3]0 1 2 3 ... 127	
//[4]0 1 2 3 ... 127	
//[5]0 1 2 3 ... 127	
//[6]0 1 2 3 ... 127	
//[7]0 1 2 3 ... 127 		   
static uint8_t OLED_GRAM[128][8];

//IIC发送数据
uint32_t iic_senddata(uint8_t *data, size_t size)
{
    hi_i2c_data i2cData = {0};
    i2cData.send_buf = data;
    i2cData.send_len = size;

    return hi_i2c_write(SSD1306_I2C_IDX, SSD1306_I2C_ADDR, &i2cData);
}

//IIC写命令
uint32_t write_iic_cmd(uint8_t cmd)
{
	uint8_t buffer[] = {0x00, cmd};
    return iic_senddata(buffer, sizeof(buffer));
}

//IIC写数据
uint32_t write_iic_data(uint8_t dat)
{
	uint8_t buffer[] = {0x40, dat};
    return iic_senddata(buffer, sizeof(buffer));
}

//向SSD1306写入一个字节。
//dat:要写入的数据/命令
//cmd:数据/命令标志 0,表示命令;1,表示数据;
void oled_wr_byte(uint8_t dat,uint8_t cmd)
{
	if(cmd)
		write_iic_data(dat);
	else
		write_iic_cmd(dat);
}

//更新显存到LCD		 
void oled_refresh_gram(void)
{
	int i,n;		    
	for(i=7;i>=0;i--) //修改刷新方向 
	{  
		oled_wr_byte (0xb0+i,OLED_CMD);    //设置页地址（0~7）
		oled_wr_byte (0x00,OLED_CMD);      //设置显示位置---列低地址
		oled_wr_byte (0x10,OLED_CMD);      //设置显示位置---列高地址   
		for(n=0;n<128;n++)oled_wr_byte(OLED_GRAM[n][i],OLED_DATA); 
	}   
}

void oled_set_pos(unsigned char x, unsigned char y) 
{ 
	oled_wr_byte(0xb0+y,OLED_CMD);
	oled_wr_byte(((x&0xf0)>>4)|0x10,OLED_CMD);
	oled_wr_byte((x&0x0f)|0x01,OLED_CMD); 
}   	  
//开启OLED显示    
void oled_display_on(void)
{
	oled_wr_byte(0X8D,OLED_CMD);  //SET DCDC命令
	oled_wr_byte(0X14,OLED_CMD);  //DCDC ON
	oled_wr_byte(0XAF,OLED_CMD);  //DISPLAY ON
}
//关闭OLED显示     
void oled_display_off(void)
{
	oled_wr_byte(0X8D,OLED_CMD);  //SET DCDC命令
	oled_wr_byte(0X10,OLED_CMD);  //DCDC OFF
	oled_wr_byte(0XAE,OLED_CMD);  //DISPLAY OFF
}
		
//清屏函数,清完屏,整个屏幕是黑色的!和没点亮一样!!!	  
void oled_clear(void)  
{  
	uint8_t i,n;		    
	for(i=0;i<8;i++)  
	{    
		for(n=0;n<128;n++)
		{
			OLED_GRAM[n][i]=0;
		}
	}
	oled_refresh_gram();//更新显示 
}

//m^n函数
uint32_t oled_pow(uint8_t m,uint8_t n)
{
	uint32_t result=1;	 
	while(n--)result*=m;    
	return result;
}

//画点 
//x:0~127
//y:0~63
//t:1 填充 0,清空				   
void oled_drawpoint(uint8_t x,uint8_t y,uint8_t t)
{
	uint8_t pos,bx,temp=0;
	if(x>127||y>63)return;//超出范围了.
	pos=7-y/8;
	bx=y%8;
	temp=1<<(7-bx);
	if(t)OLED_GRAM[x][pos]|=temp;
	else OLED_GRAM[x][pos]&=~temp;		    
}

//x1,y1,x2,y2 填充区域的对角坐标
//确保x1<=x2;y1<=y2 0<=x1<=127 0<=y1<=63	 	 
//dot:0,清空;1,填充	  
void oled_fill(uint8_t x1,uint8_t y1,uint8_t x2,uint8_t y2,uint8_t dot)  
{  
	uint8_t x,y;  
	for(x=x1;x<=x2;x++)
	{
		for(y=y1;y<=y2;y++)
		{ 	
			oled_drawpoint(x,y,dot);	
		}
	}													    
}

//填充矩形
//x0,y0:矩形的左上角坐标
//width,height:矩形的尺寸
//color:颜色
void oled_fill_rectangle(uint8_t x0,uint8_t y0,uint8_t width,uint8_t height,uint8_t color)
{	  							   
	if(width==0||height==0)return;//非法.	 
	oled_fill(x0,y0,x0+width-1,y0+height-1,color);	   	   
}

//画线
//x1,y1:起点坐标
//x2,y2:终点坐标  
void oled_drawline(uint8_t x1, uint8_t y1, uint8_t x2, uint8_t y2,uint8_t color)
{
	uint8_t t; 
	char xerr=0,yerr=0,delta_x,delta_y,distance; 
	char incx,incy,uRow,uCol; 
	delta_x=x2-x1; //计算坐标增量 
	delta_y=y2-y1; 
	uRow=x1; 
	uCol=y1; 
	if(delta_x>0)incx=1; //设置单步方向 
	else if(delta_x==0)incx=0;//垂直线 
	else {incx=-1;delta_x=-delta_x;} 
	if(delta_y>0)incy=1; 
	else if(delta_y==0)incy=0;//水平线 
	else{incy=-1;delta_y=-delta_y;} 
	if( delta_x>delta_y)distance=delta_x; //选取基本增量坐标轴 
	else distance=delta_y; 
	for(t=0;t<=distance+1;t++ )//画线输出 
	{  
		oled_drawpoint(uRow,uCol,color);//画点 
		xerr+=delta_x ; 
		yerr+=delta_y ; 
		if(xerr>distance) 
		{ 
			xerr-=distance; 
			uRow+=incx; 
		} 
		if(yerr>distance) 
		{ 
			yerr-=distance; 
			uCol+=incy; 
		} 
	}  
}

//画大点函数
//x0,y0:坐标
//color:颜色
//以(x0,y0)为中心,画一个9个点的大点
void oled_draw_bigpoint(uint8_t x0,uint8_t y0,uint8_t color)
{
	uint8_t i,j;
	uint8_t x,y;				    
	if(x0>=1)x=x0-1;
	else x=x0;
	if(y0>=1)y=y0-1;
	else y=y0;
	for(i=y;i<y0+2;i++)
	{
		for(j=x;j<x0+2;j++)oled_drawpoint(j,i,color);
	}  						   
}

//画垂直线
//x0,y0:坐标
//len:线长度
//color:颜色
void oled_draw_vline(uint8_t x0,uint8_t y0,uint8_t len,uint8_t color)
{
	if((len==0)||(x0>Max_Column-1)||(y0>Max_Row-1))return;
	oled_fill(x0,y0,x0,y0+len-1,color);	
}

//画水平线
//x0,y0:坐标
//len:线长度
//color:颜色
void oled_draw_hline(uint8_t x0,uint8_t y0,uint8_t len,uint8_t color)
{
	if((len==0)||(x0>Max_Column-1)||(y0>Max_Row-1))return;
	oled_fill(x0,y0,x0+len-1,y0,color);	
}

//画实心圆
//x0,y0:坐标
//r半径
//color:颜色
void oled_fill_circle(uint8_t x0,uint8_t y0,uint8_t r,uint8_t color)
{											  
	uint16_t i;
	uint16_t imax = ((uint32_t)r*707)/1000+1;
	uint16_t sqmax = (uint32_t)r*(uint32_t)r+(uint32_t)r/2;
	uint16_t x=r;
	oled_draw_hline(x0-r,y0,2*r,color);
	for (i=1;i<=imax;i++) 
	{
		if ((i*i+x*x)>sqmax) 
		{
			// draw lines from outside  
			if (x>imax) 
			{
				oled_draw_hline (x0-i+1,y0+x,2*(i-1),color);
				oled_draw_hline (x0-i+1,y0-x,2*(i-1),color);
			}
			x--;
		}
		// draw lines from inside (center)  
		oled_draw_hline(x0-x,y0+i,2*x,color);
		oled_draw_hline(x0-x,y0-i,2*x,color);
	}
}

//画椭圆
//x0,y0:坐标
//rx:x方向半径
//ry:y方向半径
void oled_draw_ellipse(uint8_t x0, uint8_t y0, uint8_t rx, uint8_t ry,uint8_t color) 
{
	uint16_t OutConst, Sum, SumY;
	uint8_t x,y;
	uint8_t xOld;
	uint8_t _rx = rx;
	uint8_t _ry = ry;
	if(rx>x0||ry>y0)return;//非法.
	OutConst = _rx*_rx*_ry*_ry+(_rx*_rx*_ry>>1);  // Constant as explaint above 
	// To compensate for rounding  
	xOld = x = rx;
	for (y=0; y<=ry; y++) 
	{
		if (y==ry)x=0; 
		else 
		{
			SumY =((uint16_t)(rx*rx))*((uint32_t)(y*y)); // Does not change in loop  
			while(Sum = SumY + ((uint16_t)(ry*ry))*((uint32_t)(x*x)),(x>0) && (Sum>OutConst)) x--;
		}
		// Since we draw lines, we can not draw on the first iteration		    
		if (y) 
		{
			oled_drawline(x0-xOld,y0-y+1,x0-x,y0-y,color);
			oled_drawline(x0-xOld,y0+y-1,x0-x,y0+y,color);
			oled_drawline(x0+xOld,y0-y+1,x0+x,y0-y,color);
			oled_drawline(x0+xOld,y0+y-1,x0+x,y0+y,color);
		}
		xOld = x;
	}
}

//画矩形	  
//(x1,y1),(x2,y2):矩形的对角坐标
void oled_drawRectangle(uint8_t x1, uint8_t y1, uint8_t x2, uint8_t y2,uint8_t color)
{
	oled_drawline(x1,y1,x2,y1,color);
	oled_drawline(x1,y1,x1,y2,color);
	oled_drawline(x1,y2,x2,y2,color);
	oled_drawline(x2,y1,x2,y2,color);
}

//在指定位置画一个指定大小的圆
//(x,y):中心点
//r    :半径
void oled_draw_circle(uint8_t x0,uint8_t y0,uint8_t r,uint8_t color)
{
	char a,b;
	char di;
	a=0;b=r;	  
	di=3-(r<<1);             //判断下个点位置的标志
	while(a<=b)
	{
		oled_drawpoint(x0+a,y0-b,color);             //5
 		oled_drawpoint(x0+b,y0-a,color);             //0           
		oled_drawpoint(x0+b,y0+a,color);             //4               
		oled_drawpoint(x0+a,y0+b,color);             //6 
		oled_drawpoint(x0-a,y0+b,color);             //1       
 		oled_drawpoint(x0-b,y0+a,color);             
		oled_drawpoint(x0-a,y0-b,color);             //2             
  		oled_drawpoint(x0-b,y0-a,color);             //7     	         
		a++;
		//使用Bresenham算法画圆     
		if(di<0)di +=4*a+6;	  
		else
		{
			di+=10+4*(a-b);   
			b--;
		} 						    
	}
}  

//在指定位置显示一个字符,包括部分字符
//x:0~127
//y:0~63
//mode:0,反白显示;1,正常显示				 
//size:选择字体 12/16/24
void oled_showchar(uint8_t x,uint8_t y,uint8_t chr,uint8_t size,uint8_t mode)
{      			    
	uint8_t temp,t,t1;
	uint8_t y0=y;
	uint8_t csize=(size/8+((size%8)?1:0))*(size/2);		//得到字体一个字符对应点阵集所占的字节数
	chr=chr-' ';//得到偏移后的值		 
    for(t=0;t<csize;t++)
    {   
		if(size==12)temp=ascii_1206[chr][t]; 	 	//调用1206字体
		else if(size==16)temp=ascii_1608[chr][t];	//调用1608字体
		else if(size==24)temp=ascii_2412[chr][t];	//调用2412字体
		else return;								//没有的字库
        for(t1=0;t1<8;t1++)
		{
			if(temp&0x80)oled_drawpoint(x,y,mode);
			else oled_drawpoint(x,y,!mode);
			temp<<=1;
			y++;
			if((y-y0)==size)
			{
				y=y0;
				x++;
				break;
			}
		}  	 
    }          
}

//显示2个数字
//x,y :起点坐标	 
//len :数字的位数
//size:字体大小
//num:数值(0~4294967295);	 		  
void oled_shownum(uint8_t x,uint8_t y,uint32_t num,uint8_t len,uint8_t size)
{         	
	uint8_t t,temp;
	uint8_t enshow=0;						   
	for(t=0;t<len;t++)
	{
		temp=(num/oled_pow(10,len-t-1))%10;
		if(enshow==0&&t<(len-1))
		{
			if(temp==0)
			{
				oled_showchar(x+(size/2)*t,y,' ',size,1);
				continue;
			}else enshow=1; 
		 	 
		}
	 	oled_showchar(x+(size/2)*t,y,temp+'0',size,1); 
	}
} 

//显示字符串
//x,y:起点坐标  
//size:字体大小 
//*p:字符串起始地址 
void oled_showstring(uint8_t x,uint8_t y,const uint8_t *p,uint8_t size)
{	
    while((*p<='~')&&(*p>=' '))//判断是不是非法字符!
    {       
        if(x>(X_WIDTH-(size/2))){x=0;y+=size;}
        if(y>(Y_WIDTH-size)){y=x=0;oled_clear();}
        oled_showchar(x,y,*p,size,1);	 
        x+=size/2;
        p++;
    }  	
}

//显示汉字
//x,y:起点坐标  
//pos:数组位置汉字显示
//size:字体大小 
//mode:0,反白显示;1,正常显示
void oled_showfontHZ(uint8_t x,uint8_t y,uint8_t pos,uint8_t size,uint8_t mode)
{
	uint8_t temp,t,t1;
	uint8_t y0=y;  
	uint8_t csize=(size/8+((size%8)?1:0))*(size);//得到字体一个字符对应点阵集所占的字节数	 
	if(size!=12&&size!=16&&size!=24)return;	//不支持的size
	 
	for(t=0;t<csize;t++)
	{   												   
		if(size==12)temp=FontHzk[pos][t]; 	 	//调用1206字体
		else if(size==16)temp=FontHzk[pos][t];	//调用1608字体
		else if(size==24)temp=FontHzk[pos][t];	//调用2412字体
		else return;								//没有的字库
        for(t1=0;t1<8;t1++)
		{
			if(temp&0x80)oled_drawpoint(x,y,mode);
			else oled_drawpoint(x,y,!mode);
			temp<<=1;
			y++;
			if((y-y0)==size)
			{
				y=y0;
				x++;
				break;
			}
		}  	 
	}  	
} 

//显示BMP图片128×64
//起始点坐标(x,y),x的范围0～127，y为页的范围0～7
void oled_drawBMP(uint8_t x0, uint8_t y0,uint8_t x1, uint8_t y1,uint8_t BMP[])
{ 	
 	uint16_t j=0;
 	uint8_t x,y;
  
  	if(y1%8==0)y=y1/8;      
  	else y=y1/8+1;
	for(y=y0;y<y1;y++)
	{
		oled_set_pos(x0,y);
    	for(x=x0;x<x1;x++)
	    {      
	    	oled_wr_byte(BMP[j++],OLED_DATA);	    	
	    }
	}
}

//oled初始化
void oled_init(void)
{
	uint32_t result;

	hi_gpio_init();
    // gpio_9 复用为 I2C_SCL
    hi_io_set_pull(HI_IO_NAME_GPIO_9, HI_IO_PULL_UP);
    hi_io_set_func(HI_IO_NAME_GPIO_9, HI_IO_FUNC_GPIO_9_I2C0_SCL);
    // gpio_10 复用为 I2C_SDA
    hi_io_set_pull(HI_IO_NAME_GPIO_10, HI_IO_PULL_UP);
    hi_io_set_func(HI_IO_NAME_GPIO_10, HI_IO_FUNC_GPIO_10_I2C0_SDA);

    result = hi_i2c_init(SSD1306_I2C_IDX, SSD1306_I2C_SPEED);
    if (result != HI_ERR_SUCCESS) 
	{
        printf("I2C SSD1306 Init status is 0x%x!!!\r\n", result);
        return result;
    }
	usleep(100*1000);//100ms

	oled_wr_byte(0xAE,OLED_CMD); //关闭显示
	oled_wr_byte(0xD5,OLED_CMD); //设置时钟分频因子,震荡频率
	oled_wr_byte(80,OLED_CMD);   //[3:0],分频因子;[7:4],震荡频率
	oled_wr_byte(0xA8,OLED_CMD); //设置驱动路数
	oled_wr_byte(0X3F,OLED_CMD); //默认0X3F(1/64) 
	oled_wr_byte(0xD3,OLED_CMD); //设置显示偏移
	oled_wr_byte(0X00,OLED_CMD); //默认为0

	oled_wr_byte(0x40,OLED_CMD); //设置显示开始行 [5:0],行数.
													    
	oled_wr_byte(0x8D,OLED_CMD); //电荷泵设置
	oled_wr_byte(0x14,OLED_CMD); //bit2，开启/关闭
	oled_wr_byte(0x20,OLED_CMD); //设置内存地址模式
	oled_wr_byte(0x02,OLED_CMD); //[1:0],00，列地址模式;01，行地址模式;10,页地址模式;默认10;
	oled_wr_byte(0xA1,OLED_CMD); //段重定义设置,bit0:0,0->0;1,0->127;
	oled_wr_byte(0xC0,OLED_CMD); //设置COM扫描方向;bit3:0,普通模式;1,重定义模式 COM[N-1]->COM0;N:驱动路数
	oled_wr_byte(0xDA,OLED_CMD); //设置COM硬件引脚配置
	oled_wr_byte(0x12,OLED_CMD); //[5:4]配置
		 
	oled_wr_byte(0x81,OLED_CMD); //对比度设置
	oled_wr_byte(0xEF,OLED_CMD); //1~255;默认0X7F (亮度设置,越大越亮)
	oled_wr_byte(0xD9,OLED_CMD); //设置预充电周期
	oled_wr_byte(0xf1,OLED_CMD); //[3:0],PHASE 1;[7:4],PHASE 2;
	oled_wr_byte(0xDB,OLED_CMD); //设置VCOMH 电压倍率
	oled_wr_byte(0x30,OLED_CMD); //[6:4] 000,0.65*vcc;001,0.77*vcc;011,0.83*vcc;

	oled_wr_byte(0xA4,OLED_CMD); //全局显示开启;bit0:1,开启;0,关闭;(白屏/黑屏)
	oled_wr_byte(0xA6,OLED_CMD); //设置显示方式;bit0:1,反相显示;0,正常显示	    						   
	oled_wr_byte(0xAF,OLED_CMD); //开启显示	

	oled_clear();
}

（4）修改 bsp_oled.h 文件，代码如下：

cpp 复制代码

/**
 ****************************************************************************************************
 * @file        bsp_oled.h
 * @author      普中科技
 * @version     V1.0
 * @date        2024-06-05
 * @brief       OLED液晶显示实验
 * @license     Copyright (c) 2024-2034, 深圳市普中科技有限公司
 ****************************************************************************************************
 * @attention
 *
 * 实验平台:普中-Hi3861
 * 在线视频:https://space.bilibili.com/2146492485
 * 公司网址:www.prechin.cn
 * 购买地址:
 *
 */

#ifndef BSP_OLED_H
#define BSP_OLED_H

#include "cmsis_os2.h"
#include "hi_io.h"
#include "hi_gpio.h"


#define SSD1306_I2C_ADDR        0x78         // 器件的I2C从机地址
#define SSD1306_I2C_IDX         0             // 模块的I2C总线号
#define SSD1306_I2C_SPEED       100000       // 100KHz


#define SIZE 16
#define XLevelL		0x00
#define XLevelH		0x10
#define Max_Column	128
#define Max_Row		64
#define	Brightness	0xFF 
#define X_WIDTH 	128
#define Y_WIDTH 	64

#define OLED_CMD  0	//写命令
#define OLED_DATA 1	//写数据

//函数声明
void oled_wr_byte(uint8_t dat,uint8_t cmd);	    
void oled_display_on(void);
void oled_display_off(void);
void oled_set_pos(unsigned char x, unsigned char y);	   							   		    
void oled_init(void);
void oled_refresh_gram(void);
void oled_clear(void);
void oled_drawpoint(uint8_t x,uint8_t y,uint8_t t);
void oled_fill(uint8_t x1,uint8_t y1,uint8_t x2,uint8_t y2,uint8_t dot);
void oled_fill_rectangle(uint8_t x0,uint8_t y0,uint8_t width,uint8_t height,uint8_t color);
void oled_drawline(uint8_t x1, uint8_t y1, uint8_t x2, uint8_t y2,uint8_t color);
void oled_drawRectangle(uint8_t x1, uint8_t y1, uint8_t x2, uint8_t y2,uint8_t color);
void oled_fill_circle(uint8_t x0,uint8_t y0,uint8_t r,uint8_t color);
void oled_draw_bigpoint(uint8_t x0,uint8_t y0,uint8_t color);
void oled_draw_vline(uint8_t x0,uint8_t y0,uint8_t len,uint8_t color);
void oled_draw_hline(uint8_t x0,uint8_t y0,uint8_t len,uint8_t color);
void oled_fill_circle(uint8_t x0,uint8_t y0,uint8_t r,uint8_t color);
void oled_draw_ellipse(uint8_t x0, uint8_t y0, uint8_t rx, uint8_t ry,uint8_t color) ;
void oled_showchar(uint8_t x,uint8_t y,uint8_t chr,uint8_t size,uint8_t mode);
void oled_shownum(uint8_t x,uint8_t y,uint32_t num,uint8_t len,uint8_t size);
void oled_showstring(uint8_t x,uint8_t y,const uint8_t *p,uint8_t size); 
void oled_showfontHZ(uint8_t x,uint8_t y,uint8_t pos,uint8_t size,uint8_t mode);
void oled_drawBMP(uint8_t x0, uint8_t y0,uint8_t x1, uint8_t y1,uint8_t BMP[]);

#endif

（5）修改 template.c 文件，代码如下：

cpp 复制代码

/**
 ****************************************************************************************************
 * @file        template.c
 * @author      普中科技
 * @version     V1.0
 * @date        2024-06-05
 * @brief       OLED液晶显示实验
 * @license     Copyright (c) 2024-2034, 深圳市普中科技有限公司
 ****************************************************************************************************
 * @attention
 *
 * 实验平台:普中-Hi3861
 * 在线视频:https://space.bilibili.com/2146492485
 * 公司网址:www.prechin.cn
 * 购买地址:
 *
 ****************************************************************************************************
 * 实验现象：oled液晶显示字符信息
 *
 ****************************************************************************************************
 */

#include <stdio.h>
#include <unistd.h>

#include "ohos_init.h"
#include "cmsis_os2.h"

#include "bsp_led.h"
#include "bsp_oled.h"


//LED任务
osThreadId_t LED_Task_ID; //led任务ID

void LED_Task(void)
{
    led_init();//LED初始化

    while (1) 
    {
        LED(1); 
        usleep(200*1000); //200ms
        LED(0);
        usleep(200*1000); //200ms
    }
}
//LED任务创建
void led_task_create(void)
{
    osThreadAttr_t taskOptions;
    taskOptions.name = "LEDTask";            // 任务的名字
    taskOptions.attr_bits = 0;               // 属性位
    taskOptions.cb_mem = NULL;               // 堆空间地址
    taskOptions.cb_size = 0;                 // 堆空间大小
    taskOptions.stack_mem = NULL;            // 栈空间地址
    taskOptions.stack_size = 1024;           // 栈空间大小 单位:字节
    taskOptions.priority = osPriorityNormal; // 任务的优先级

    LED_Task_ID = osThreadNew((osThreadFunc_t)LED_Task, NULL, &taskOptions); // 创建任务1
    if (LED_Task_ID != NULL)
    {
        printf("ID = %d, Create LED_Task_ID is OK!\n", LED_Task_ID);
    }
}

//控制任务
osThreadId_t OLED_Task_ID; //任务ID

void OLED_Task(void)
{
    oled_init();
    
    oled_clear();
	oled_showstring(0,0,"Hello World",12);
	oled_showstring(0,15,"Hello World",16);
	oled_showfontHZ(0,35,0,16,1);
	oled_showfontHZ(1*16,35,1,16,1);
	oled_refresh_gram();
    
    while (1) 
    {
        usleep(10*1000); //10ms
    }
}
//任务创建
void oled_task_create(void)
{
    osThreadAttr_t taskOptions;
    taskOptions.name = "oledTask";       // 任务的名字
    taskOptions.attr_bits = 0;               // 属性位
    taskOptions.cb_mem = NULL;               // 堆空间地址
    taskOptions.cb_size = 0;                 // 堆空间大小
    taskOptions.stack_mem = NULL;            // 栈空间地址
    taskOptions.stack_size = 1024;           // 栈空间大小 单位:字节
    taskOptions.priority = osPriorityNormal; // 任务的优先级

    OLED_Task_ID = osThreadNew((osThreadFunc_t)OLED_Task, NULL, &taskOptions); // 创建任务
    if (OLED_Task_ID != NULL)
    {
        printf("ID = %d, Task Create OK!\n", OLED_Task_ID);
    }
}

/**
 * @description: 初始化并创建任务
 * @param {*}
 * @return {*}
 */
static void template_demo(void)
{
    printf("普中-Hi3861开发板--OLED液晶显示实验\r\n");
    led_task_create();
    oled_task_create();//任务创建
}
SYS_RUN(template_demo);

24.4 实验现象

将程序下载到开发板内（可参考"2.2.5 程序下载运行"章节），打开串口调试助手"\5--开发工具\4-串口调试助手\UartAssist.exe" ，波特率设置为115200，实验现象： OLED 液晶显示字符。