【STM32H7】第19章 ThreadX GUIX的OLED单色屏移植

第19章 ThreadX GUIX的OLED单色屏移植

本章节为大家讲解GUIX的单色屏移植。

19.1初学者重要提示

19.2 OLED移植说明

19.3 GUIX Studio单色屏驱动设计

19.4 实验例程设计框架

19.5实验例程

19.6 总结

19.1 初学者重要提示

OLED单色屏的移植要比前面章节彩屏的移植简单很多。
务必看第11章学习GUIX Studio的使用方法和第12章学习GUIX Studio生成的代码移植到硬件平台的方法。本章要为大家简单介绍GUIX Studio单色屏生成是建立在这两个章节基础上。
我们本章提供的方法用不到动态内存，采用静态方式，并且仅使用内部SRAM，共需2KB的RAM：

OLED驱动本身消耗1KB的RAM空间。
GUIX Studio生成的canvas画布占用1KB的空间。

19.2 OLED移植说明

阅读本章节前，建议已经简单阅读过本教程的第7，8，9或第10章。

注：我们这里以MDK AC5为例进行说明，其它的MDK AC6，Embedded Studio和IAR是一样的。

19.2.1 第1步：不限制任何接口形式的OLED屏

我们这里是采用的FMC并口外接OLED测试，大家使用SPI，I2C等接口形式均可，仅需保证已经实现了基本的打点功能即可。

OLED显示屏规格128*64分辨率，单色屏。集成LDO电源芯片，因此可以直接用3.3V或5V供电：

显示效果：

19.2.2 第2步：添加OLED驱动并初始化

我们这里用到的驱动文件是bsp_fmc_oled.c和bsp_fmc_oled.h。移植前请保证驱动文件的打点功能是正常的。然后将其添加到工程里面：

OLED初始化放在了bsp.c文件的函数bsp_Init里面：

代码语言：javascript复制

/*
*********************************************************************************************************
*    函 数 名: bsp_Init
*    功能说明: 初始化所有的硬件设备。该函数配置CPU寄存器和外设的寄存器并初始化一些全局变量。只需要调用一次
*    形    参: 无
*    返 回 值: 无
*********************************************************************************************************
*/
void bsp_Init(void)
{
    bsp_InitDWT();    /* 初始化DWT时钟周期计数器 */       
    bsp_InitKey();        /* 按键初始化，要放在滴答定时器之前，因为按钮检测是通过滴答定时器扫描 */
    bsp_InitUart();    /* 初始化串口 */
    bsp_InitExtIO();    /* 初始化FMC总线74HC574扩展IO. 必须在 bsp_InitLed()前执行 */    
    bsp_InitLed();        /* 初始化LED */    
    bsp_InitTimer();      /* 初始化滴答定时器 */
    bsp_InitExtSDRAM();/* 初始化SDRAM */

    OLED_InitHard();   /* 初始化OLED */
    OLED_ClrScr(0xFF);    /* 清屏，0x00表示黑底； 0xFF 表示白底 */
}

19.2.3 第3步：OLED的绘制原理

OLED是单色屏，使用一个bit就可以表示是1个像素点，比如1表示亮，0表示灭。我们这里驱动的实现是定义了一个显存空间uint8_t s_ucGRAM[8][128]，占用1K字节，共8行，每行128像素。用户绘制的都是绘制到这个显存里面，需要刷新的时候整体刷新OLED界面即可。这里要注意的是显存每个字节反应到OLED显示屏实际坐标上表示的那些位置的像素点。下面是整体布局：

高是64个COM，宽是128个SEG，每8个COM组成一个Page，共计8个Page。然后再看每个Page的细节，以Page2为例：

每个Page的扫描方式可以认为是从上到下，从左到右，第1列的8个像素值对应的显存变量是s_ucGRAM[2][0]，第2列就是s_ucGRAM[2][1]，以此类推，这一点非常重要，因为我们后面要用到的GUIX Studio生成界面扫描方式不是这样的，它是从左到右，从上到下。

了解了这些知识点就够用了。

19.2.4 第4步：OLED底层驱动实现

OLED的底层驱动实现如下：

代码语言：javascript复制

/*
*********************************************************************************************************
*    函 数 名: stm32_monochrome_buffer_toggle
*    功能说明: 单色屏绘制，直接做整个屏的重绘
*    形    参: 无
*    返 回 值: 无
*********************************************************************************************************
*/
static void stm32_monochrome_buffer_toggle(GX_CANVAS *canvas, GX_RECTANGLE *dirty)
{
    uint8_t *p;

    /* 防止警告 */
    (void)canvas;
    (void)dirty;   
    
    /* 获得OLED画布的地址 */
    p = (uint8_t *)display_1_canvas_memory;
    
    /* 将画布的内容绘制到OLED显存 */
    for (int y= 0; y < 64; y  )
    {
        for (int x = 0; x < 128; x =8)
        {
            OLED_PutPixel(x, y, (p[16*y   x/8]&(0x80))>>7);
            OLED_PutPixel(x 1, y, (p[16*y   x/8]&(0x40))>>6);
            OLED_PutPixel(x 2, y, (p[16*y   x/8]&(0x20))>>5);
            OLED_PutPixel(x 3, y, (p[16*y   x/8]&(0x10))>>4);
            OLED_PutPixel(x 4, y, (p[16*y   x/8]&(0x08))>>3);
            OLED_PutPixel(x 5, y, (p[16*y   x/8]&(0x04))>>2);
            OLED_PutPixel(x 6, y, (p[16*y   x/8]&(0x02))>>1);
            OLED_PutPixel(x 7, y, (p[16*y   x/8]&(0x01))>>0);
        }
    }
    
    /* 将OLED显存的内容实际绘制到OLED */
    OLED_EndDraw();
}

/*
*********************************************************************************************************
*    函 数 名: stm32_graphics_driver_setup_monochrome
*    功能说明: 单色屏驱动接口
*    形    参: 无
*    返 回 值: 无
*********************************************************************************************************
*/
UINT stm32_graphics_driver_setup_monochrome(GX_DISPLAY *display)
{
    _gx_display_driver_monochrome_setup(display, (VOID*)STM32_SCREEN_HANDLE, stm32_monochrome_buffer_toggle);

    return(GX_SUCCESS);
}

这里要注意两点：

驱动OLED单色屏要使用函数_gx_display_driver_monochrome_setup。
函数stm32_monochrome_buffer_toggle里代码的实现是关键。

由于GUIX Studio生成的界面扫描方式与OLED的扫描方式不同，这里的代码实现就是第3步中扫描方式的切换。具体实现的操作是将canvas画布通过函数OLED_PutPixel（注，此函数不是直接往OLED绘制的）绘制到OLED显存，然后调用函数OLED_EndDraw将OLED显存的内容实际绘制到OLED。

19.2.5 第5步：添加驱动接口到GUIX

第4步的函数要通过函数gx_studio_display_configure做配置，这样GUIX就会调用OLED驱动：

代码语言：javascript复制

    /* 配置显示屏 */
    gx_studio_display_configure(DISPLAY_1, stm32_graphics_driver_setup_monochrome,
                                LANGUAGE_ENGLISH, DISPLAY_1_THEME_1, &root);

通过这5步就完成了OLED的移植工作。