硬件接口说明
引脚名称开发者可在硬件资源图中查看，也可在oled模块正面面查看。
硬件连接
程序设计
API分析
oled_init()
unsigned int oled_init();
描述：
初始化oled设备。
参数：
无
返回值：
返回0为成功，反之为失败
oled_deinit()
unsigned int oled_deinit();
描述：
释放oled设备。
参数：
无
返回值：
返回0为成功，反之为失败
oled_display_on()
void oled_display_on(void);
描述：
oled显示开启。
参数：
无
返回值：
无
oled_display_off()
void oled_display_off(void);
描述：
oled显示关闭。
参数：
无
返回值：
无
oled_clear()
void oled_clear(void);
描述：
oled清空屏幕。
参数：
无
返回值：
无
oled_show_char()
void oled_show_char(uint8_t x, uint8_t y, uint8_t chr, uint8_t chr_size);
描述：
oled显示单个英文字符。
参数：
返回值：
无
oled_show_num()
void oled_show_num(uint8_t x, uint8_t y, uint32_t num, uint8_t len, uint8_t size);
描述：
oled显示整数。
参数：
返回值：
无
oled_show_string()
void oled_show_string(uint8_t x, uint8_t y, uint8_t *p, uint8_t chr_size);
描述：
oled显示英文字符串。
参数：
返回值：
无
oled_draw_bmp()
void oled_draw_bmp(unsigned char x0,
unsigned char y0,
unsigned char x1,
unsigned char y1,
unsigned char bmp[]);
描述：
oled显示图片。
参数：
返回值：
无
OLED器件
OLED显示屏
OLED显示屏是0.96寸OLED显示屏，型号为SSD1306，像素为128 * 64。
OLED液晶屏采用i2c通信方式，根据芯片手册说明，从设备地址为 0x3C。
主要代码分析
这部分代码为i2c初始化的代码。首先用 I2cIoInit() 函数将GPIO0_PC1复用为I2C1_SDA_M1，GPIO0_PC2复用为I2C1_SCL_M1。最后调用 LzI2cInit()函数初始化I2C1端口。
if (I2cIoInit(m_i2cBus) != LZ_HARDWARE_SUCCESS)
{
printf("%s, %d: I2cIoInit failed!\n", __FILE__, __LINE__);
return __FILE__;
}
if (LzI2cInit(OLED_I2C_BUS, m_i2c_freq) != LZ_HARDWARE_SUCCESS)
{
printf("%s, %d: I2cIoInit failed!\n", __FILE__, __LINE__);
return __FILE__;
}
具体i2c写操作如下：
static inline void Write_IIC_Command(unsigned char IIC_Command)
{
unsigned char buffer[2];
unsigned int ret;
/* 填充数据，第一个字节是通知OLED芯片，下一个字节是命令 */
buffer[0] = 0x00;
buffer[1] = IIC_Command;
ret = LzI2cWrite(OLED_I2C_BUS, OLED_I2C_ADDRESS, buffer, 2);
if (ret != 0)
{
printf("%s, %s, %d: LzI2cWrite failed(%d)!\n", __FILE__, __func__, __LINE__, ret);
}
}
static inline void Write_IIC_Data(unsigned char IIC_Data)
{
unsigned char buffer[2];
unsigned int ret;
/* 填充数据，第一个字节是通知OLED芯片，下一个字节是数据 */
buffer[0] = 0x40;
buffer[1] = IIC_Data;
ret = LzI2cWrite(OLED_I2C_BUS, OLED_I2C_ADDRESS, buffer, 2);
if (ret != 0)
{
printf("%s, %s, %d: LzI2cWrite failed(%d)!\n", __FILE__, __func__, __LINE__, ret);
}
}
配置SSD1306启动
LOS_Msleep(200);
Oled_WR_Byte(0xAE, OLED_CMD); //--display off
Oled_WR_Byte(0x00, OLED_CMD); //---set low column address
Oled_WR_Byte(0x10, OLED_CMD); //---set high column address
Oled_WR_Byte(0x40, OLED_CMD); //--set start line address
Oled_WR_Byte(0xB0, OLED_CMD); //--set page address
Oled_WR_Byte(0x81, OLED_CMD); // contract control
Oled_WR_Byte(0xFF, OLED_CMD); //--128
Oled_WR_Byte(0xA1, OLED_CMD); //set segment remap
Oled_WR_Byte(0xA6, OLED_CMD); //--normal / reverse
Oled_WR_Byte(0xA8, OLED_CMD); //--set multiplex ratio(1 to 64)
Oled_WR_Byte(0x3F, OLED_CMD); //--1/32 duty
Oled_WR_Byte(0xC8, OLED_CMD); //Com scan direction
Oled_WR_Byte(0xD3, OLED_CMD); //-set display offset
Oled_WR_Byte(0x00, OLED_CMD); //
Oled_WR_Byte(0xD5, OLED_CMD); //set osc division
Oled_WR_Byte(0x80, OLED_CMD); //
Oled_WR_Byte(0xD8, OLED_CMD); //set area color mode off
Oled_WR_Byte(0x05, OLED_CMD); //
Oled_WR_Byte(0xD9, OLED_CMD); //Set Pre-Charge Period
Oled_WR_Byte(0xF1, OLED_CMD); //
Oled_WR_Byte(0xDA, OLED_CMD); //set com pin configuartion
Oled_WR_Byte(0x12, OLED_CMD); //
Oled_WR_Byte(0xDB, OLED_CMD); //set Vcomh
Oled_WR_Byte(0x30, OLED_CMD); //
Oled_WR_Byte(0x8D, OLED_CMD); //set charge pump enable
Oled_WR_Byte(0x14, OLED_CMD); //
Oled_WR_Byte(0xAF, OLED_CMD); //--turn on oled panel
这部分代码将SSD1306的启动配置。
编译调试
修改 BUILD.gn 文件
修改 vendor/lockzhiner/lingpi/sample 路径下 BUILD.gn 文件，指定 b5_oled 参与编译。
"b5_oled",
在主目录下输入编译命令。
hb build -f
运行结果
示例代码编译烧录代码后，按下开发板的RESET按键，通过串口助手查看日志，并请使用带有LCD屏幕显示如下：
========= Oled Process =============
原作者：王小彬 Gitee
更多回帖
