1.0 OLED

此图转载优信电子

有机发光二极管（OrganicLight-Emitting Diode，OLED），又称有机电激光显示，有机发光半导体（OrganicElectroluminesence Display，OLED），是指有机半导体材料和发光材料在电场驱动下通过载流子注入和复合而发光的现象。本篇通过0.96寸OLED包采用I2C软串口示例程序演示。

1.1产品特性:

OLED(Organic Light-Emitting Diode):有机发光二极管又称有机激光显示，OLED 显示技术具有自发光的特点，采用非常薄的有机材料涂层和玻璃基板，当电流通过时，这些有机材料会发光，OLED显示屏视角大，功耗低。OLED由于同时具有自发光、无背光源（仅通电不亮，驱动程序和接线正确）、对比度高、厚度薄、视角广、响应速度快、柔性面板、使用温度范围广、结构简单、工艺简单等优良特点。第一个接触的12864屏幕是LCD是的，需要背光，功耗高，而且OLED功耗低，更适合小系统；由于发光材料的不同，在不同的环境中，OLED的显示效果更佳。模块电源可为3.3V也可以是5V,不需要修改模块电路，OLED屏幕有多个控制指令，可以控制OLED亮度、对比度、开关升压电路等指令。操作方便，功能丰富。汉字可以显示，ASClI、图案等。同时，为方便产品应用，预留4个M3固定孔，方便用户固定在机壳上。

1.2产品参数:

1.高分辨率:12864(和12864LCD相同的分辨率，但是OLED屏幕单位面积像素点多) 2.超广视角:大于160° 3.超低功耗:正常显示0.06W 4.宽供电范围:直流3.3V-5V 5.工业级:工作温度范围-30℃~70℃ 6、体积小:27mm27mm*2mm 7.通信方式:l2C 8:、亮度、对比度可以通过程序指令控制 9.使用寿命不少于16000小时 10、OLED屏幕内部驱动芯片：SSD1306

2. RT-theard配置

2.1 硬件需求

1、需要0.96寸I2C驱动的OLED动态显示屏幕，SDA—p511(p50b);SCL—p512(p50c)，公式首先去掉了三个p，以便p以511为例，最终转换的数字是 “(5x16x16) (1x10) 1”算出来为 1291 转换为16进制为0x50b。注：在程序中，字符需要转换为数字。

实现功能： OLED屏幕；画直线，矩形框，画圆，画光标，字体。板载按钮中断交互，LED3 1Hz频闪。

ssd1306屏幕地址看电阻接线x3c(以后需要) 2、RA6M4开发板 3、USB下载线，ch340串口和6条母线，rx—p613;tx—p614

2.2 软件配置

Renesas RA6M4开发板环境配置参考：基于 RT-Thread Studio的CPK-RA6M4 开发板环境建设】 1、新建项目RA6M4-IIC工程 2、点击RT-theard Setting，在软件包下添加软件包，然后搜索ssd相关软件支持包，点击添加，然后出现相应的包。 3、配置ssd306，右键选择配置项上述地址0在软件包中配置x3c，开启示例 5硬件中，启动I2C，设置端口

6.保存所有刚性配置，更新当前配置文件保存是灰色的，保存为蓝色。

3. 代码分析

1.刚加载软件包packages在文件夹下，示例代码是 ssd1306_tests.c

/* * Copyright (c) 2020, RudyLo <luhuadong@163.com> * * SPDX-License-Identifier: MIT License * * Change Logs: * Date Author Notes * 2020-11-15 luhuadong the first version */  #include <rtthread.h> #include <rtdevice.h> #include <board.h>  #include <string.h> #include <stdio.h> #include "ssd1306.h" #include "ssd1306_tests.h"  void ssd1306_TestBorder() { 
             ssd1306_Fill(Black);      uint32_t start = rt_tick_get();
    uint32_t end = start;
    uint8_t x = 0;
    uint8_t y = 0;
    do { 
        
        ssd1306_DrawPixel(x, y, Black);

        if((y == 0) && (x < 127))
            x++;
        else if((x == 127) && (y < 63))
            y++;
        else if((y == 63) && (x > 0)) 
            x--;
        else
            y--;

        ssd1306_DrawPixel(x, y, White);
        ssd1306_UpdateScreen();
    
        rt_thread_mdelay(5);
        end = rt_tick_get();
    } while((end - start) < 8000);
   
    rt_thread_mdelay(1000);
}

void ssd1306_TestFonts()
{ 
        
    ssd1306_Fill(Black);
    ssd1306_SetCursor(2, 0);
    ssd1306_WriteString("Font 16x26", Font_16x26, White);
    ssd1306_SetCursor(2, 26);
    ssd1306_WriteString("Font 11x18", Font_11x18, White);
    ssd1306_SetCursor(2, 26+18);
    ssd1306_WriteString("Font 7x10", Font_7x10, White);
    ssd1306_SetCursor(2, 26+18+10);
    ssd1306_WriteString("Font 6x8", Font_6x8, White);
    ssd1306_UpdateScreen();
}

void ssd1306_TestFPS()
{ 
        
    ssd1306_Fill(White);
   
    uint32_t start = rt_tick_get();
    uint32_t end = start;
    int fps = 0;
    char message[] = "ABCDEFGHIJK";
   
    ssd1306_SetCursor(2,0);
    ssd1306_WriteString("Testing...", Font_11x18, Black);
   
    do { 
        
        ssd1306_SetCursor(2, 18);
        ssd1306_WriteString(message, Font_11x18, Black);
        ssd1306_UpdateScreen();
       
        char ch = message[0];
        memmove(message, message+1, sizeof(message)-2);
        message[sizeof(message)-2] = ch;

        fps++;
        end = rt_tick_get();
    } while((end - start) < 5000);
   
    rt_thread_mdelay(1000);

    char buff[64];
    fps = (float)fps / ((end - start) / 1000.0);
    snprintf(buff, sizeof(buff), "~%d FPS", fps);
   
    ssd1306_Fill(White);
    ssd1306_SetCursor(2, 18);
    ssd1306_WriteString(buff, Font_11x18, Black);
    ssd1306_UpdateScreen();
}

void ssd1306_TestLine()
{ 
        
    ssd1306_Line(1,1,SSD1306_WIDTH - 1,SSD1306_HEIGHT - 1,White);
    ssd1306_Line(SSD1306_WIDTH - 1,1,1,SSD1306_HEIGHT - 1,White);
    ssd1306_UpdateScreen();
    return;
}

void ssd1306_TestRectangle()
{ 
        
    uint32_t delta;

    for(delta = 0; delta < 5; delta ++) 
    { 
        
        ssd1306_DrawRectangle(1 + (5*delta),1 + (5*delta) ,SSD1306_WIDTH-1 - (5*delta),SSD1306_HEIGHT-1 - (5*delta),White);
    }
    ssd1306_UpdateScreen();
    return;
}

void ssd1306_TestCircle()
{ 
        
    uint32_t delta;

    for(delta = 0; delta < 5; delta ++) 
    { 
        
        ssd1306_DrawCircle(20* delta+30, 30, 10, White);
    }
    ssd1306_UpdateScreen();
    return;
}

void ssd1306_TestArc()
{ 
        
    ssd1306_DrawArc(30, 30, 30, 20, 270, White);
    ssd1306_UpdateScreen();
    return;
}

void ssd1306_TestPolyline()
{ 
        
    SSD1306_VERTEX loc_vertex[] =
    { 
        
        { 
        35,40},
        { 
        40,20},
        { 
        45,28},
        { 
        50,10},
        { 
        45,16},
        { 
        50,10},
        { 
        53,16}
    };

    ssd1306_Polyline(loc_vertex,sizeof(loc_vertex)/sizeof(loc_vertex[0]),White);
    ssd1306_UpdateScreen();
    return;
}

void ssd1306_TestAll()
{ 
        
    ssd1306_Init();

    ssd1306_TestFPS();
    rt_thread_mdelay(3000);

    ssd1306_TestBorder();

    ssd1306_TestFonts();
    rt_thread_mdelay(3000);

    ssd1306_Fill(Black);
    ssd1306_TestRectangle();
    ssd1306_TestLine();
    rt_thread_mdelay(3000);

    ssd1306_Fill(Black);
    ssd1306_TestPolyline();
    rt_thread_mdelay(3000);

    ssd1306_Fill(Black);
    ssd1306_TestArc();
    rt_thread_mdelay(3000);

    ssd1306_Fill(Black);
    ssd1306_TestCircle();
    rt_thread_mdelay(3000);
}

#ifdef FINSH_USING_MSH
MSH_CMD_EXPORT(ssd1306_TestAll, test ssd1306 oled driver);
#endif

2、此库包含画直线（ssd1306_TestPolyline();）、矩形框（ssd1306_TestRectangle();）、画圆（ssd1306_TestCircle();）、画光标（ssd1306_TestArc();）、字体（ssd1306_TestFonts();）。调用时直接在串口CMD命令输入“ssd1306_TestAll”，即可查看对应切换。 3、main.c文件在re_gen文件夹下，主程序围绕“hal_entry();”函数（在src文件夹） main.c

/* generated main source file - do not edit */
#include "hal_data.h"
            int main(void) { 
        
              hal_entry();
              return 0;
            }

hal_entry.c

/* * Copyright (c) 2006-2021, RT-Thread Development Team * * SPDX-License-Identifier: Apache-2.0 * * Change Logs: * Date Author Notes * 2021-10-10 Sherman first version * 2021-11-03 Sherman Add icu_sample */

#include <rtthread.h>
#include "hal_data.h"
#include <rtdevice.h>

#define LED3_PIN BSP_IO_PORT_01_PIN_06
#define USER_INPUT "P105"

void hal_entry(void)
{ 
        
    rt_kprintf("\nHello RT-Thread!\n");

    while (1)
    { 
        
        rt_pin_write(LED3_PIN, PIN_HIGH);
        rt_thread_mdelay(500);
        rt_pin_write(LED3_PIN, PIN_LOW);
        rt_thread_mdelay(500);
    }
}

void irq_callback_test(void *args)
{ 
        
    rt_kprintf("\n IRQ00 triggered \n");
}

void icu_sample(void)
{ 
        
    /* init */
    rt_uint32_t pin = rt_pin_get(USER_INPUT);
    rt_kprintf("\n pin number : 0x%04X \n", pin);
    rt_err_t err = rt_pin_attach_irq(pin, PIN_IRQ_MODE_RISING, irq_callback_test, RT_NULL);
    if(RT_EOK != err)
    { 
        
        rt_kprintf("\n attach irq failed. \n");
    }
    err = rt_pin_irq_enable(pin, PIN_IRQ_ENABLE);
    if(RT_EOK != err)
    { 
        
        rt_kprintf("\n enable irq failed. \n");
    }
}
MSH_CMD_EXPORT(icu_sample, icu sample);

4. 下载验证

1、编译重构编译成功

2、下载程序下载成功

3、CMD串口调试

然后板载复位输入：ssd1306_TestAll，开始显示！🎉🎉🎉 效果如下这样我们就可以天马行空啦!

参考文献；【基于 RT-Thread Studio的CPK-RA6M4 开发板环境搭建】

资讯详情

【Renesas RA6M4开发板之I2C（模拟）驱动ssd1306 OLED屏幕】

【Renesas RA6M4开发板之I2C(模拟)驱动ssd1306 OLED屏幕】