全志R128驱动OLED屏幕步骤教程

OLED，即有机发光二极管（ Organic Light Emitting Diode）。 OLED 由于同时具备自发光，不需背光源、对比度高、厚度薄、视角广、反应速度快、可用于挠曲性面板、使用温度范围广、构造及制程较简单等优异之特性，被认为是下一代的平面显示器新兴应用技术。

LCD 都需要背光，而 OLED 不需要，因为它是自发光的。这样同样的显示 OLED 效果要来得好一些。以目前的技术，OLED 的尺寸还难以大型化，但是分辨率确可以做到很高。

在此我们使用的是0.96寸OLED显示屏，该屏有以下特点：

0.96 寸 OLED 有黄蓝，白，蓝三种颜色可选；其中黄蓝是屏上 1/4 部分为黄光，下 3/4 为蓝；而且是固定区域显示固定颜色，颜色和显示区域均不能修改；白光则为纯白，也就是黑底白字；蓝色则为纯蓝，也就是黑底蓝字。
分辨率为 128*64
多种接口方式；OLED 裸屏总共种接口包括：6800、8080 两种并行接口方式、3 线或 4 线的串行 SPI 接口方式、 IIC 接口方式（只需要 2 根线就可以控制 OLED 了！），这五种接口是通过屏上的 BS0~BS2 来配置的。

本次使用的是四针的IIC 模块，如下图：

引脚配置如下

R128 Devkit

OLED

PA23

SCL

PA24

SDA

GND

3V3

VCC

载入方案

我们使用的开发板是 R128-Devkit，需要开发 C906 核心的应用程序，所以载入方案选择 r128s2_module_c906

$ source envsetup.sh 
$ lunch_rtos 1

设置 TWI 驱动

运行 mrtos_menuconfig 进入配置页面。前往下列地址找到 TWI Devices

Drivers Options  --- >
    soc related device drivers  --- >
            TWI Devices --- >
            -*- enable twi driver

配置 TWI 引脚

打开你喜欢的编辑器，修改文件：board/r128s2/module/configs/sys_config.fex

增加 TWI0 的配置，参考手册可知 PA23，PA24 的 TWI0 复用为 6

[twi0]
twi0_sck        = port:PA23< 6 >< 1 >< default >< default >
twi0_sda        = port:PA24< 6 >< 1 >< default >< default >

编写程序

打开你喜欢的编辑器，新增文件：lichee/rtos/projects/r128s2/module_c906/src/oled.c 用于编写 OLED 的驱动。

编写 OLED 驱动

使用一个宏储存 TWI 的地址和使用的 TWI 端口，并定义显存。

#define OLED_IIC_ADDR 0x3c
#define OLED_IIC_PORT 0

uint8_t OLED_GRAM[144][8]; /* 显存 */

编写 OLED 的基础操作驱动 TWI 通讯函数。

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

void OLED_WR_Byte(uint8_t dat, uint8_t mode)
{
    twi_msg_t msg;
    twi_port_t port = OLED_IIC_PORT;

    uint8_t buf[2];

    if (mode)
        buf[0] = 0x40;
    else
        buf[0] = 0x00;
    buf[1] = dat;

    msg.flags = 0;
    msg.addr = OLED_IIC_ADDR;
    msg.len = 2;
    msg.buf = buf;
    hal_twi_control(port, I2C_RDWR, &msg);
}

编写 OLED 的驱动函数：显示开关

void OLED_ColorTurn(uint8_t i)
{
    if (i == 0) {
        OLED_WR_Byte(0xA6, OLED_CMD); /* 正常显示 */
    }
    if (i == 1) {
        OLED_WR_Byte(0xA7, OLED_CMD); /* 反色显示 */
    }
}

编写 OLED 的驱动函数：反显设置

void OLED_DisplayTurn(uint8_t i)
{
    if (i == 0) {
        OLED_WR_Byte(0xC8, OLED_CMD); /* 正常显示 */
        OLED_WR_Byte(0xA1, OLED_CMD);
    }
    if (i == 1) {
        OLED_WR_Byte(0xC0, OLED_CMD); /* 反转显示 */
        OLED_WR_Byte(0xA0, OLED_CMD);
    }
}

编写 OLED 的驱动函数：刷新屏幕

void OLED_Refresh(void)
{
    for (int i = 0; i < 8; i++) {
        OLED_WR_Byte(0xb0 + i, OLED_CMD); //设置行起始地址
        OLED_WR_Byte(0x00, OLED_CMD); //设置低列起始地址
        OLED_WR_Byte(0x10, OLED_CMD); //设置高列起始地址
        OLED_WR_Byte(0x78, OLED_DATA);
        OLED_WR_Byte(0x40, OLED_DATA);
        for (int n = 0; n < 128; n++) {
            OLED_WR_Byte(OLED_GRAM[n][i], OLED_DATA);
        }
    }
}

编写 OLED 的驱动函数：清屏

void OLED_Clear(void)
{
    for (int i = 0; i < 8; i++) {
        OLED_WR_Byte(0xb0 + i, OLED_CMD); //设置页地址（0~7）
        OLED_WR_Byte(0x00, OLED_CMD); //设置显示位置—列低地址
        OLED_WR_Byte(0x10, OLED_CMD); //设置显示位置—列高地址
        for (int n = 0; n < 128; n++)
            OLED_GRAM[n][i] = 0;
        OLED_Refresh(); //刷新GRAM内容
    }
}

编写 OLED 的驱动函数：画点

void OLED_DrawPoint(uint8_t x, uint8_t y, uint8_t t)
{
    uint8_t i, m, n;
    i = y / 8;
    m = y % 8;
    n = 1 < < m;
    if (t) {
        OLED_GRAM[x][i] |= n;
    }
    else {
        OLED_GRAM[x][i] = ~OLED_GRAM[x][i];
        OLED_GRAM[x][i] |= n;
        OLED_GRAM[x][i] = ~OLED_GRAM[x][i];
    }
}

编写 OLED 的驱动函数：画线

void OLED_DrawLine(uint8_t x1, uint8_t y1, uint8_t x2, uint8_t y2, uint8_t mode)
{
    int xerr = 0, yerr = 0, delta_x, delta_y, distance;
    int 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_x;
    }
    if (delta_x > delta_y)
        distance = delta_x; //选取基本增量坐标轴
    else
        distance = delta_y;
    for (uint16_t t = 0; t < distance + 1; t++) {
        OLED_DrawPoint(uRow, uCol, mode); //画点
        xerr += delta_x;
        yerr += delta_y;
        if (xerr > distance) {
            xerr -= distance;
            uRow += incx;
        }
        if (yerr > distance) {
            yerr -= distance;
            uCol += incy;
        }
    }
}

编写 OLED 的驱动函数：画园

void OLED_DrawCircle(uint8_t x, uint8_t y, uint8_t r)
{
    int a, b, num;
    a = 0;
    b = r;
    while (2 * b * b >= r * r) {
        OLED_DrawPoint(x + a, y - b, 1);
        OLED_DrawPoint(x - a, y - b, 1);
        OLED_DrawPoint(x - a, y + b, 1);
        OLED_DrawPoint(x + a, y + b, 1);

        OLED_DrawPoint(x + b, y + a, 1);
        OLED_DrawPoint(x + b, y - a, 1);
        OLED_DrawPoint(x - b, y - a, 1);
        OLED_DrawPoint(x - b, y + a, 1);

        a++;
        num = (a * a + b * b) - r * r; //计算画的点离圆心的距离
        if (num > 0) {
            b--;
            a--;
        }
    }
}

编写 OLED 的驱动函数：显示字符

void OLED_ShowChar(uint8_t x, uint8_t y, uint8_t chr, uint8_t size1, uint8_t mode)
{
    uint8_t temp, size2, chr1;
    uint8_t x0 = x, y0 = y;
    if (size1 == 8)
        size2 = 6;
    else
        size2 = (size1 / 8 + ((size1 % 8) ? 1 : 0)) * (size1 / 2); //得到字体一个字符对应点阵集所占的字节数
    chr1 = chr - ' '; //计算偏移后的值
    for (uint8_t i = 0; i < size2; i++) {
        if (size1 == 8) {
            temp = asc2_0806[chr1][i];
        } //调用0806字体
        else if (size1 == 12) {
            temp = asc2_1206[chr1][i];
        } //调用1206字体
        else if (size1 == 16) {
            temp = asc2_1608[chr1][i];
        } //调用1608字体
        else if (size1 == 24) {
            temp = asc2_2412[chr1][i];
        } //调用2412字体
        else
            return;
        for (uint8_t m = 0; m < 8; m++) {
            if (temp & 0x01)
                OLED_DrawPoint(x, y, mode);
            else
                OLED_DrawPoint(x, y, !mode);
            temp > >= 1;
            y++;
        }
        x++;
        if ((size1 != 8) && ((x - x0) == size1 / 2)) {
            x = x0;
            y0 = y0 + 8;
        }
        y = y0;
    }
}

编写 OLED 的驱动函数：显示字符串

void OLED_ShowString(uint8_t x, uint8_t y, uint8_t* chr, uint8_t size1, uint8_t mode)
{
    while ((*chr >= ' ') && (*chr <= '~')) //判断是不是非法字符!
    {
        OLED_ShowChar(x, y, *chr, size1, mode);
        if (size1 == 8)
            x += 6;
        else
            x += size1 / 2;
        chr++;
    }
}

编写 OLED 的驱动函数：显示数字

void OLED_ShowNum(uint8_t x, uint8_t y, uint32_t num, uint8_t len, uint8_t size1, uint8_t mode)
{
    uint8_t temp, m = 0;
    if (size1 == 8)
        m = 2;
    for (uint8_t t = 0; t < len; t++) {
        temp = (num / OLED_Pow(10, len - t - 1)) % 10;
        if (temp == 0) {
            OLED_ShowChar(x + (size1 / 2 + m) * t, y, '0', size1, mode);
        }
        else {
            OLED_ShowChar(x + (size1 / 2 + m) * t, y, temp + '0', size1, mode);
        }
    }
}

编写 OLED 的驱动函数：配置位置

void OLED_Set_Pos(uint8_t x, uint8_t y)
{
    OLED_WR_Byte(0xb0 + y, OLED_CMD);
    OLED_WR_Byte(((x & 0xf0) > > 4) | 0x10, OLED_CMD);
    OLED_WR_Byte((x & 0x0f), OLED_CMD);
}

编写 OLED 的驱动函数：初始化屏幕

void OLED_Init(void)
{
    hal_twi_init(OLED_IIC_PORT); //-- init TWI

    OLED_WR_Byte(0xAE, OLED_CMD);//--turn off oled panel
    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  Set Mapping RAM Display Start Line (0x00~0x3F)
    OLED_WR_Byte(0x81, OLED_CMD);//--set contrast control register
    OLED_WR_Byte(0xCF, OLED_CMD); // Set SEG Output Current Brightness
    OLED_WR_Byte(0xA1, OLED_CMD);//--Set SEG/Column Mapping     0xa0左右反置 0xa1正常
    OLED_WR_Byte(0xC8, OLED_CMD);//Set COM/Row Scan Direction   0xc0上下反置 0xc8正常
    OLED_WR_Byte(0xA6, OLED_CMD);//--set normal display
    OLED_WR_Byte(0xA8, OLED_CMD);//--set multiplex ratio(1 to 64)
    OLED_WR_Byte(0x3f, OLED_CMD);//--1/64 duty
    OLED_WR_Byte(0xD3, OLED_CMD);//-set display offset Shift Mapping RAM Counter (0x00~0x3F)
    OLED_WR_Byte(0x00, OLED_CMD);//-not offset
    OLED_WR_Byte(0xd5, OLED_CMD);//--set display clock divide ratio/oscillator frequency
    OLED_WR_Byte(0x80, OLED_CMD);//--set divide ratio, Set Clock as 100 Frames/Sec
    OLED_WR_Byte(0xD9, OLED_CMD);//--set pre-charge period
    OLED_WR_Byte(0xF1, OLED_CMD);//Set Pre-Charge as 15 Clocks & Discharge as 1 Clock
    OLED_WR_Byte(0xDA, OLED_CMD);//--set com pins hardware configuration
    OLED_WR_Byte(0x12, OLED_CMD);
    OLED_WR_Byte(0xDB, OLED_CMD);//--set vcomh
    OLED_WR_Byte(0x40, OLED_CMD);//Set VCOM Deselect Level
    OLED_WR_Byte(0x20, OLED_CMD);//-Set Page Addressing Mode (0x00/0x01/0x02)
    OLED_WR_Byte(0x02, OLED_CMD);//
    OLED_WR_Byte(0x8D, OLED_CMD);//--set Charge Pump enable/disable
    OLED_WR_Byte(0x14, OLED_CMD);//--set(0x10) disable
    OLED_WR_Byte(0xA4, OLED_CMD);// Disable Entire Display On (0xa4/0xa5)
    OLED_WR_Byte(0xA6, OLED_CMD);// Disable Inverse Display On (0xa6/a7)
    OLED_Clear();
    OLED_WR_Byte(0xAF, OLED_CMD); /*display ON*/  
}

我们把这些驱动放到一个单独的文件里，命名为 oled.c，完整内容如下：

#include < sunxi_hal_twi.h >

#include "oledfont.h"

#define OLED_IIC_ADDR 0x3c
#define OLED_IIC_PORT 0

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

uint8_t OLED_GRAM[144][8]; /* 显存 */

void OLED_WR_Byte(uint8_t dat, uint8_t mode)
{
    twi_msg_t msg;
    twi_port_t port = OLED_IIC_PORT;

    uint8_t buf[2];

    if (mode)
        buf[0] = 0x40;
    else
        buf[0] = 0x00;
    buf[1] = dat;

    msg.flags = 0;
    msg.addr = OLED_IIC_ADDR;
    msg.len = 2;
    msg.buf = buf;
    hal_twi_control(port, I2C_RDWR, &msg);
}

uint32_t OLED_Pow(uint8_t m, uint8_t n)
{
    uint32_t result = 1;
    while (n--)
        result *= m;
    return result;
}

void OLED_ColorTurn(uint8_t i)
{
    if (i == 0) {
        OLED_WR_Byte(0xA6, OLED_CMD); /* 正常显示 */
    }
    if (i == 1) {
        OLED_WR_Byte(0xA7, OLED_CMD); /* 反色显示 */
    }
}

void OLED_DisplayTurn(uint8_t i)
{
    if (i == 0) {
        OLED_WR_Byte(0xC8, OLED_CMD); /* 正常显示 */
        OLED_WR_Byte(0xA1, OLED_CMD);
    }
    if (i == 1) {
        OLED_WR_Byte(0xC0, OLED_CMD); /* 反转显示 */
        OLED_WR_Byte(0xA0, OLED_CMD);
    }
}

void OLED_Refresh(void)
{
    for (int i = 0; i < 8; i++) {
        OLED_WR_Byte(0xb0 + i, OLED_CMD); //设置行起始地址
        OLED_WR_Byte(0x00, OLED_CMD); //设置低列起始地址
        OLED_WR_Byte(0x10, OLED_CMD); //设置高列起始地址
        OLED_WR_Byte(0x78, OLED_DATA);
        OLED_WR_Byte(0x40, OLED_DATA);
        for (int n = 0; n < 128; n++) {
            OLED_WR_Byte(OLED_GRAM[n][i], OLED_DATA);
        }
    }
}

void OLED_Clear(void)
{
    for (int i = 0; i < 8; i++) {
        OLED_WR_Byte(0xb0 + i, OLED_CMD); //设置页地址（0~7）
        OLED_WR_Byte(0x00, OLED_CMD); //设置显示位置—列低地址
        OLED_WR_Byte(0x10, OLED_CMD); //设置显示位置—列高地址
        for (int n = 0; n < 128; n++)
            OLED_GRAM[n][i] = 0;
        OLED_Refresh(); //刷新GRAM内容
    }
}

void OLED_DrawPoint(uint8_t x, uint8_t y, uint8_t t)
{
    uint8_t i, m, n;
    i = y / 8;
    m = y % 8;
    n = 1 < < m;
    if (t) {
        OLED_GRAM[x][i] |= n;
    }
    else {
        OLED_GRAM[x][i] = ~OLED_GRAM[x][i];
        OLED_GRAM[x][i] |= n;
        OLED_GRAM[x][i] = ~OLED_GRAM[x][i];
    }
}

void OLED_DrawLine(uint8_t x1, uint8_t y1, uint8_t x2, uint8_t y2, uint8_t mode)
{
    int xerr = 0, yerr = 0, delta_x, delta_y, distance;
    int 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_x;
    }
    if (delta_x > delta_y)
        distance = delta_x; //选取基本增量坐标轴
    else
        distance = delta_y;
    for (uint16_t t = 0; t < distance + 1; t++) {
        OLED_DrawPoint(uRow, uCol, mode); //画点
        xerr += delta_x;
        yerr += delta_y;
        if (xerr > distance) {
            xerr -= distance;
            uRow += incx;
        }
        if (yerr > distance) {
            yerr -= distance;
            uCol += incy;
        }
    }
}

void OLED_DrawCircle(uint8_t x, uint8_t y, uint8_t r)
{
    int a, b, num;
    a = 0;
    b = r;
    while (2 * b * b >= r * r) {
        OLED_DrawPoint(x + a, y - b, 1);
        OLED_DrawPoint(x - a, y - b, 1);
        OLED_DrawPoint(x - a, y + b, 1);
        OLED_DrawPoint(x + a, y + b, 1);

        OLED_DrawPoint(x + b, y + a, 1);
        OLED_DrawPoint(x + b, y - a, 1);
        OLED_DrawPoint(x - b, y - a, 1);
        OLED_DrawPoint(x - b, y + a, 1);

        a++;
        num = (a * a + b * b) - r * r; //计算画的点离圆心的距离
        if (num > 0) {
            b--;
            a--;
        }
    }
}

void OLED_ShowChar(uint8_t x, uint8_t y, uint8_t chr, uint8_t size1, uint8_t mode)
{
    uint8_t temp, size2, chr1;
    uint8_t x0 = x, y0 = y;
    if (size1 == 8)
        size2 = 6;
    else
        size2 = (size1 / 8 + ((size1 % 8) ? 1 : 0)) * (size1 / 2); //得到字体一个字符对应点阵集所占的字节数
    chr1 = chr - ' '; //计算偏移后的值
    for (uint8_t i = 0; i < size2; i++) {
        if (size1 == 8) {
            temp = asc2_0806[chr1][i];
        } //调用0806字体
        else if (size1 == 12) {
            temp = asc2_1206[chr1][i];
        } //调用1206字体
        else if (size1 == 16) {
            temp = asc2_1608[chr1][i];
        } //调用1608字体
        else if (size1 == 24) {
            temp = asc2_2412[chr1][i];
        } //调用2412字体
        else
            return;
        for (uint8_t m = 0; m < 8; m++) {
            if (temp & 0x01)
                OLED_DrawPoint(x, y, mode);
            else
                OLED_DrawPoint(x, y, !mode);
            temp > >= 1;
            y++;
        }
        x++;
        if ((size1 != 8) && ((x - x0) == size1 / 2)) {
            x = x0;
            y0 = y0 + 8;
        }
        y = y0;
    }
}

void OLED_ShowString(uint8_t x, uint8_t y, uint8_t* chr, uint8_t size1, uint8_t mode)
{
    while ((*chr >= ' ') && (*chr <= '~')) //判断是不是非法字符!
    {
        OLED_ShowChar(x, y, *chr, size1, mode);
        if (size1 == 8)
            x += 6;
        else
            x += size1 / 2;
        chr++;
    }
}

void OLED_ShowNum(uint8_t x, uint8_t y, uint32_t num, uint8_t len, uint8_t size1, uint8_t mode)
{
    uint8_t temp, m = 0;
    if (size1 == 8)
        m = 2;
    for (uint8_t t = 0; t < len; t++) {
        temp = (num / OLED_Pow(10, len - t - 1)) % 10;
        if (temp == 0) {
            OLED_ShowChar(x + (size1 / 2 + m) * t, y, '0', size1, mode);
        }
        else {
            OLED_ShowChar(x + (size1 / 2 + m) * t, y, temp + '0', size1, mode);
        }
    }
}

void OLED_Set_Pos(uint8_t x, uint8_t y)
{
    OLED_WR_Byte(0xb0 + y, OLED_CMD);
    OLED_WR_Byte(((x & 0xf0) > > 4) | 0x10, OLED_CMD);
    OLED_WR_Byte((x & 0x0f), OLED_CMD);
}

void OLED_Init(void)
{
    hal_twi_init(OLED_IIC_PORT); //-- init TWI

    OLED_WR_Byte(0xAE, OLED_CMD);//--turn off oled panel
    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  Set Mapping RAM Display Start Line (0x00~0x3F)
    OLED_WR_Byte(0x81, OLED_CMD);//--set contrast control register
    OLED_WR_Byte(0xCF, OLED_CMD); // Set SEG Output Current Brightness
    OLED_WR_Byte(0xA1, OLED_CMD);//--Set SEG/Column Mapping     0xa0左右反置 0xa1正常
    OLED_WR_Byte(0xC8, OLED_CMD);//Set COM/Row Scan Direction   0xc0上下反置 0xc8正常
    OLED_WR_Byte(0xA6, OLED_CMD);//--set normal display
    OLED_WR_Byte(0xA8, OLED_CMD);//--set multiplex ratio(1 to 64)
    OLED_WR_Byte(0x3f, OLED_CMD);//--1/64 duty
    OLED_WR_Byte(0xD3, OLED_CMD);//-set display offset Shift Mapping RAM Counter (0x00~0x3F)
    OLED_WR_Byte(0x00, OLED_CMD);//-not offset
    OLED_WR_Byte(0xd5, OLED_CMD);//--set display clock divide ratio/oscillator frequency
    OLED_WR_Byte(0x80, OLED_CMD);//--set divide ratio, Set Clock as 100 Frames/Sec
    OLED_WR_Byte(0xD9, OLED_CMD);//--set pre-charge period
    OLED_WR_Byte(0xF1, OLED_CMD);//Set Pre-Charge as 15 Clocks & Discharge as 1 Clock
    OLED_WR_Byte(0xDA, OLED_CMD);//--set com pins hardware configuration
    OLED_WR_Byte(0x12, OLED_CMD);
    OLED_WR_Byte(0xDB, OLED_CMD);//--set vcomh
    OLED_WR_Byte(0x40, OLED_CMD);//Set VCOM Deselect Level
    OLED_WR_Byte(0x20, OLED_CMD);//-Set Page Addressing Mode (0x00/0x01/0x02)
    OLED_WR_Byte(0x02, OLED_CMD);//
    OLED_WR_Byte(0x8D, OLED_CMD);//--set Charge Pump enable/disable
    OLED_WR_Byte(0x14, OLED_CMD);//--set(0x10) disable
    OLED_WR_Byte(0xA4, OLED_CMD);// Disable Entire Display On (0xa4/0xa5)
    OLED_WR_Byte(0xA6, OLED_CMD);// Disable Inverse Display On (0xa6/a7)
    OLED_Clear();
    OLED_WR_Byte(0xAF, OLED_CMD); /*display ON*/  
}

同时提供对应的头文件 oled.h，oledfont.h 由于较大，见文章末尾。

#ifndef __OLED_H
#define __OLED_H

/* 发送一个字节 
 * mode:数据/命令标志 0,表示命令;1,表示数据;
 */
void OLED_WR_Byte(uint8_t dat, uint8_t mode);

/* Pow 函数 */
uint32_t OLED_Pow(uint8_t m, uint8_t n);

/* 反显函数 */
void OLED_ColorTurn(uint8_t i);

/* 屏幕旋转180度 */
void OLED_DisplayTurn(uint8_t i);

/* 更新显存到OLED */
void OLED_Refresh(void);

/* OLED 清屏 */
void OLED_Clear(void);

/* 画点 
 * x: 0~127
 * y: 0~63
 * t: 1 填充 0,清空    
 */
void OLED_DrawPoint(uint8_t x, uint8_t y, uint8_t t);

/* 画线
 * x1, y1: 起点坐标
 * x2, y2: 结束坐标
 */
void OLED_DrawLine(uint8_t x1, uint8_t y1, uint8_t x2, uint8_t y2, uint8_t mode);

/* 画圆
 * x, y: 圆心坐标
 * r: 圆的半径
 */

void OLED_DrawCircle(uint8_t x, uint8_t y, uint8_t r);

/* 在指定位置显示一个字符,包括部分字符
 * x: 0 ~ 127
 * y: 0 ~ 63
 * size1: 选择字体 6x8/6x12/8x16/12x24
 * mode: 0,反色显示; 1,正常显示
 */
void OLED_ShowChar(uint8_t x, uint8_t y, uint8_t chr, uint8_t size1, uint8_t mode);

/* 显示字符串
 * x: 0 ~ 127
 * y: 0 ~ 63
 * *chr: 字符串起始地址 
 * size1: 选择字体 6x8/6x12/8x16/12x24
 * mode: 0,反色显示; 1,正常显示
 */
void OLED_ShowString(uint8_t x, uint8_t y, uint8_t* chr, uint8_t size1, uint8_t mode);

/* 显示数字
 * x: 0 ~ 127
 * y: 0 ~ 63
 * num: 要显示的数字 
 * len: 数字的位数
 * size1: 选择字体 6x8/6x12/8x16/12x24
 * mode: 0,反色显示; 1,正常显示
 */
void OLED_ShowNum(uint8_t x, uint8_t y, uint32_t num, uint8_t len, uint8_t size1, uint8_t mode);

/* 初始化 OLED */
void OLED_Init(void);

#endif

然后把 oled.c 加入编译，修改 lichee/rtos/projects/r128s2/module_c906/Makefile加入

obj-y += src/oled.o

编写主程序

打开你喜欢的编辑器，修改文件：lichee/rtos/projects/r128s2/module_c906/src/main.c

OLED_Init();

OLED_ShowString(12, 16, "====AWOL====", 16, 1);
OLED_ShowString(20, 32, "2023/08/24", 16, 1);

OLED_Refresh();

初始化 OLED，然后显示字符串。

结果

驱动了 OLED 屏

阅读全文

驱动器(142549) 驱动器(142549)
OLED屏(20644) OLED屏(20644)
SPI接口(33894) SPI接口(33894)
IIC总线(20129) IIC总线(20129)
有机发光二极管(15814) 有机发光二极管(15814)
R128(27) R128(27)

如何使用FPGA驱动OLED屏幕

这是FPGA之旅设计的第九例啦！！！本例将介绍如何使用FPGA驱动OLED屏幕，并在接下来的几例中，配合其它模块，进行一些有趣的综合实验。由于使用的OLED屏是IIC接口的，对IIC接口不是很清楚

2022-09-01 10:51:05

2707

全志R128应用开发案例—获取真随机数

R128 内置了TRNG，一个真随机数发生器，随机源是 8 路独立的环形振荡器

2023-10-24 17:49:02

558

全志R128 BLE最高吞吐量测试正确配置测试方法

在R128使用前我们需要了解BLE的最高吞吐量，以方便评估相关功能的开发。

2023-10-27 17:17:27

711

全志R128应用开发案例—适配SPI驱动ST7789V2.4寸LCD

R128 平台提供了 SPI DBI 的 SPI TFT 接口，具有如下特点

2023-11-02 16:44:48

509

R128平台SPI与DBI接口的性能对比

R128平台SPI与DBI接口的性能对比

2023-11-15 09:08:46

412

全志R128内存泄漏调试案例分享

硬件：R128 软件：FreeRTOS + rtplayer\_test(Cedarx)+ AudioSystem

2023-11-20 17:27:35

442

R128点屏踩坑笔记

本文所整理的R128点屏踩坑笔记均是在参考以下应用开发案例进行屏幕适配时遇到的实际开发问题，涵盖了屏幕花屏、屏幕白屏、LVGL显示颜色错误等常见问题的解决方法。

2023-12-03 10:17:48

471

2月全志芯片开源项目分享合集

1、项目名称：全志T113-S3智能家居86屏作者的上一个作品的V3s的随身终端，由于硬件解码一直无法完成适配，于是作者找了另一块性能更强，接口更丰富的T113-S3来替代，并将其应用在智能家居

2024-03-02 14:39:17

OLED屏幕怎么使用

一、使用前的准备首先先将u8g2的模块烧录到nodemcu中，选择OLED 屏幕所支持的u8g图形库，和所需要的字体，如下图：构建完成之后，下载烧录到开发板中。二、u8g2模块的主要函数使用时，首先

2021-12-09 06:28:51

OLED显示流程（简析）

;)和OLED_Refresh_Gram();，（63和48是字符串在屏幕中显示的位置，这里我们不管他。。）这两条语句的拆解步骤如下：1、既然是显示字符串，我们就得调用字符串显示函数：void OLED_ShowString(u8 x

2016-05-07 20:26:24

全志R128 BLE最高吞吐量测试正确配置测试

在R128使用前我们需要了解BLE的最高吞吐量，以方便评估相关功能的开发。首先我们了解一下哪些因素会影响蓝牙的吞吐量： 1、蓝牙版本与PHY：蓝牙设备的版本和物理层（PHY）对于吞吐量有很大

2023-10-16 15:22:00

全志R128 BLE最高吞吐量测试正确配置测试

2023-10-26 16:46:10

全志R128 DSP开发工具安装教程

下的 dsp_raw.bin 拷贝到 R128 根SDK 下的 board/r128s/xxx/bin/ 下，并重命名为rtos_dsp_sun20iw2p1.fex。 R128 SDK 下重新打包烧录，即可

2023-12-28 17:21:12

全志R128 Devkit开发板原理图模块介绍及使用说明

：CH341SER.EXE 购买链接百问科技淘宝店 - 全志R128 DevKit 原理图模块介绍R128 模组R128 模组使用 SMT 贴装于开发板上，外挂陶瓷天线，其中的PA16，PA17脚复用

2024-01-17 09:45:43

全志R128 SDK架构与目录结构

R128 S2 是全志提供的一款 M33(ARM)+C906(RISCV-64)+HIFI5(Xtensa) 三核异构 SoC，同时芯片内部 SIP 有 1M SRAM、8M LSPSRAM、8M

2024-01-05 10:05:44

全志R128驱动OLED屏幕步骤教程

图：引脚配置如下 R128 Devkit OLED PA23 SCL PA24 SDA GND GND 3V3 VCC 载入方案我们使用的开发板是 R128-Devkit，需要开发 C906 核心

2023-10-17 14:59:57

全志R128使用RGB LCD移植方法教程

的 r128-devkit-100ask-rgb 方案，仓库地址: Gitee： https://gitee.com/weidongshan/100ask_r128_demos/tree/master/other/RGB_LCD GitHub

2023-12-18 17:03:25

全志R128使用SPI驱动ST7789V1.47寸LCD

ZJY147S0800TG01，使用的是 SPI 进行驱动。引脚配置如下： [td]R128 DevkitTFT 模块 PA12CS PA13SCL PA18SDA PA9BLK PA20RES

2024-01-02 09:45:46

全志R128入门编写HelloWorld

本文将介绍使用 R128 开发板从串口输出 HelloWorld 的方式介绍 SDK 软件开发流程。载入方案我们使用的开发板是 R128-Devkit，需要开发 C906 核心的应用程序，所以载入

2023-12-29 09:39:08

全志R128内存泄漏调试案例

内存泄露调试案例问题背景硬件：R128 软件：FreeRTOS + rtplayer_test(Cedarx)+ AudioSystem 问题复现复现步骤： rtplayer_test

2023-11-20 16:54:20

全志R128内存泄露调试案例

内存泄露调试案例问题背景硬件：R128 软件：FreeRTOS + rtplayer_test(Cedarx)+ AudioSystem 问题复现复现步骤： rtplayer_test

2023-12-11 10:57:05

全志R128基础组件开发——显示与屏幕驱动①

RTOS 提供了一套完整的屏幕驱动，支持 RGB, i8080, SPI, DBI 格式的屏幕。（1）RGB 接口 RGB接口在全志平台又称HV接口（Horizontal同步和Vertical同步

2024-01-31 14:20:28

全志R128基础组件开发——显示与屏幕驱动②

BUF 表示一个图层，如果一个 BUF 都没有出现，那么将是黑屏，不过和屏驱动本身关系就不大了，应该查看应用层 & 框架层。 err:0 这个表示缺数，如果数字很大且一直变化，屏幕会花

2024-01-31 14:25:39

全志R128基础组件开发指南——SPI LCD 显示驱动

SPI LCD 显示驱动简介 R128 平台提供了 SPI DBI 的 SPI TFT 接口ACCC，具有如下特点： Supports DBI Type C 3 Line/4 Line

2023-10-25 14:36:44

全志R128外设模块配置——ADC按键配置方法

}; 不同平台的配置可能不同，以r128为例，下面是r128的成员config： static struct sunxikbd_config key_config = { .measure

2023-10-20 11:04:10

全志R128平台SPI与DBI点屏性能大对比

SPI 与 DBI 性能对比 R128 平台的 SPI 接口参数如下全双工同步串行接口 Master/Slave模式可配置支持最大96MHz时钟频率支持SPI Mode0/1/2/3 片选

2023-11-13 15:58:05

全志R128应用开发案例——DBI驱动ST7789V1.3寸LCD屏

的 DBI 的写操作。读操作只能通过模拟IO来实现。对于R128这类支持 DBI 接口的CPU，可以选择不去了解 SPI。直接选用 DBI 来驱动屏幕。由于不需要模拟延时和切换数据，屏幕驱动效率将有明显

2023-11-06 11:12:57

全志R128应用开发案例——SPI 驱动 TFT LCD 屏

SPI 驱动 TFT LCD 屏 R128 平台提供了 SPI DBI 的 SPI TFT 接口，具有如下特点： Supports DBI Type C 3 Line/4 Line

2023-10-23 14:29:19

全志R128应用开发案例——SPI驱动ST7789V1.3寸LCD

SPI驱动ST7789V1.3寸LCD R128 平台提供了 SPI DBI 的 SPI TFT 接口，具有如下特点： Supports DBI Type C 3 Line/4 Line

2023-11-06 10:16:13

全志R128应用开发案例——中断方式驱动旋转编码器

r128s2_module_c906 $ source envsetup.sh $ lunch_rtos 1 勾选 GPIO 驱动 mrtos_menuconfig 找到下列驱动 Drivers

2023-10-12 15:51:28

全志R128应用开发案例——中断方式驱动旋转编码器

r128s2_module_c906 $ source envsetup.sh $ lunch_rtos 1 勾选 GPIO 驱动 mrtos_menuconfig 找到下列驱动 Drivers

2023-10-12 15:51:29

全志R128应用开发案例——点亮一颗 LED 灯

r128s2_module_c906 $ source envsetup.sh $ lunch_rtos 1 勾选 GPIO 驱动 mrtos_menuconfig 找到下列驱动 Drivers

2023-10-09 09:50:21

全志R128应用开发案例——获取真随机数

获取真随机数本文案例代码下载地址获取真随机数案例代码 https://www.aw-ol.com/downloads?cat=24 R128 内置了TRNG，一个真随机数发生器，随机源是 8

2023-10-24 17:05:55

全志R128应用开发案例——获取真随机数

获取真随机数本文案例代码下载地址获取真随机数案例代码 https://www.aw-ol.com/downloads?cat=24 R128 内置了TRNG，一个真随机数发生器，随机源是 8

2023-11-13 16:31:39

全志R128应用开发案例——适配SPI驱动ST7789V2.4寸LCD

SPI驱动ST7789V1.47寸LCD R128 平台提供了 SPI DBI 的 SPI TFT 接口，具有如下特点： Supports DBI Type C 3 Line/4 Line

2023-11-02 13:36:52

全志R128按键控制蜂鸣器GPIO配置详解

的应用程序，所以载入方案选择r128s2_module_c906 $ source envsetup.sh $ lunch_rtos 1 勾选 GPIO 驱动 mrtos_menuconfig

2023-11-27 10:16:43

全志R128点屏SPI LCD颜色相关问题

spi 都很难，甚至无法实现。所以 normal spi 只能模拟4 线的DBI的写操作。对于R128这类支持DBI接口的CPU，可以选择不去了解SPI。如果需要用到SPI去驱动显示屏，必须把显示屏

2023-12-06 09:50:28

全志R128硬件设计指南①

~PA29VDD-SYSVDD-IO13.3V/1.8V PB0~PB15VDD-SYSVDD-IO13.3V/1.8V LED电路设计R128集成 LEDC功能，可以直接驱动集成式 LED。集成式 LED一般供电范围是 3.5

2024-01-04 09:23:18

全志R128硬件设计指南②

烧码选择不同的启动介质与启动端口，具体烧码值建议联系全志FAE。建议4FLASH、EMMC的物料选型必须采用全志AVL支持列表里面的型号。建议 RGB1R128支持RGB接口，使用时需保证LCD的IO

2024-01-04 09:30:55

全志R128系统RTOS使用说明

] file 跨核心控制台由于 R128 同时运行三个独立的 RTOS，有些时候需要操作其他核心的 RTOS，每次都要在SDK切换控制台比较麻烦，所以可以使用跨核心控制台操作其他核心的 RTOS 命令

2024-01-05 10:22:34

全志R128芯片如何在FreeRTOS下对代码源文件进行快速预处理？

1.主题FreeRTOS_R128_如何对代码源文件进行快速预处理2.问题背景硬件：R128软件：FreeRTOS客户在日常的开发过程中，会碰到源文件中有许多的宏或许多条件编译的代码，有时候需要

2023-03-17 10:23:40

全志R128芯片RTOS调试指南

:0x0 psplim:0x8142550 usage fault happen, UFSR:0x1, cause:undefine instruction CPU registers: R

2023-11-22 11:03:42

全志R128芯片应用开发案例——驱动 WS2812 流水灯

数据会在第 n 个 LED 的数据前发送，不过这些数据将会是原来 n-1 个 LED 的亮度数据。由于拥有独立的 LEDC 模块，在 R128 平台上驱动 WS2812 类似的 RGB LED

2023-10-10 14:08:22

全志R128芯片应用开发案例——ADC驱动烟雾传感器

C906 核心的应用程序，所以载入方案选择r128s2_module_c906 $ source envsetup.sh $ lunch_rtos 1 勾选 GPADC 驱动

2023-10-16 11:34:18

全志R128芯片应用开发案例——按键输入

按键3脚载入方案我们使用的开发板是 R128-Devkit，需要开发 C906 核心的应用程序，所以载入方案选择r128s2_module_c906 $ source envsetup.sh

2023-10-10 14:34:17

全志R128芯片软件配置——配置引脚复用

的 {PROJECT} 代表不同的方案，例如 module 方案。引脚配置文件配置复用 R128 平台使用 sys_config.fex 作为引脚配置文件，他会在打包时打包编译进入系统，在系统运行时会解析并

2023-10-13 15:32:26

全志R128软件配置——RTOS 软件包配置

说明了解了menuconfig的基本操作，我们再来了解一下 RTOS 的 menuconfig 具体都有是么内容。 Build target sunxi arch 分别选择芯片的系列，对于R128

2023-10-20 15:31:17

全志R128适配 ST7789v LCD

r128s2_module_c906 $ source envsetup.sh $ lunch_rtos 1 设置 SPI 驱动屏幕使用的是SPI驱动，所以需要勾选SPI驱动，运行 mrtos_menuconfig 进入

2023-10-23 09:58:26

全志A33四核处理屏幕开发板的特色是什么？有什么应用？

2022-01-14 06:08:38

全志A64和RK3288有哪些不同

全志A64是什么？有何功能呢？ RK3288是什么？有何功能呢？全志A64和RK3288有哪些不同？

2022-02-10 07:40:35

全志D1S OLED驱动

前言本次使用RT-Smart的IIC驱动OLED屏幕，进行基本的字符串显示,在使用的过程中遇到一些问题，在这里做记录分享，本次以熟悉RT-Smart使用为主。过程本次直接开始添加离线包，环境搭建请

2023-04-12 22:42:17

全志科技主要负责是那一块？

2023-08-08 15:53:40

全志科技正式发布首款AI语音专用芯片R329

3月18日消息，继推出智能语音专用处理器R328之后，近日全志科技正式发布主打AI语音专用的重磅产品R329，这是全志科技首款搭载Arm中国全新AI处理单元（AIPU）的高算力、低功耗AI语音专用芯片。

2020-11-23 14:18:03

RT-Smart使用menuconfig配置后，rtconfig.h没有更新？

上点亮了OLED，我想换屏幕进行显示，需要取消OLED的配置，IIC,OLED例程等。操作步骤：在全志D1S BSP文件夹下使用scons —menuconfig 进行内核配置在RT-Thread

2023-05-12 15:05:57

SF1 RISC-V Core 驱动OLED屏幕

第1章 SF1 RISC-V Core 驱动OLED屏幕本次测评采用安路的SF1 RISC-V内核实现对SPI OLED屏幕的驱动，实现在屏幕上显示信息的功能。1.1 外设串口连接

2023-12-10 10:26:08

SF1 RISC-V Core 驱动OLED屏幕

,GCLK41.2VLED_R J5IO_B6P_2,GCLK51.2VLED_B H5IO_B7N_21.2VLED_G2、 OLED驱动移植板上的OLED屏幕为中景园的OLED屏幕，官方已经提供了相关的屏幕

2023-06-16 21:09:09

STM32是如何驱动OLED屏幕显示中英文字符的

STM32是如何驱动OLED屏幕显示中英文字符的？有哪些具体操作？

2021-10-21 06:56:42

【R128填坑分享】适配LVGL界面图片和文字显示很虚，色阶明显的解决方法

在线文档显示与屏幕驱动相关内容，选择一下参数进行配置，后解决问题文档链接：https://r128.docs.aw-ol.com/sdk_base/disp/#480x480-rgb-86 修复好

2023-10-16 13:29:49

【全志R128外设模块配置】USB外设功能配置

，对于R128 来说，只需要使能USB0）。另外，还要选择功能驱动（Mass Storage，UVC），不然只是使能USB Host 则无法正常运行USB Host 的功能。 USB Host 控制器

2023-10-30 11:37:06

【全志R128开发经验分享】启用USB ADB以及无线ADB配置方法

首先在FreeRTOS的环境下，选择r128_c906_pro： source envsetup.sh lunch_rtos r128s2_pro_c906 USB ADB的配置比较常规，注意以下

2023-10-24 17:29:01

【CW32饭盒派开发板试用体验】驱动OLED屏幕笔记

我自己还有一个oled屏幕，想用这块开发板驱动起来。这个oled是ssd1306，提供i2c和spi两种接口。 OLED，即有机发光二极管( Organic Light Emitting Diode

2023-06-04 09:39:50

【HarmonyOS HiSpark Wi-Fi IoT 套件试用OLED驱动】oled屏的使用和oled驱动测试

在测试HarmonyOS Wi-Fi IoT 套件Hi3861过程，套件上的oled屏幕不亮了，最后排查发现是测试新程序的时候把之前的测试程序入口更改了，无法驱动oled了。论坛上有连志安老师的视频

2020-11-15 20:37:03

【HarmonyOS HiSpark Wi-Fi IoT套件】I2C驱动 Hi3861 驱动OLED屏幕显示

OLED驱动可以看附件视频详细说明Hispark WiFi开发套件又提供一个oled屏幕，但是鸿蒙源码中没有这个屏幕的驱动，我们需要自己去移植。经过一晚上的调试，现在终于在鸿蒙系统上实现OLED屏幕的显示了

2020-10-16 09:26:24

使用全志R128将LVGL运行在SPI TFT GUI上

LVGL 与 SPI TFT GUI 本次使用的是 Dshan_Display Module，如下图：引脚配置如下： R128 Devkit TFT 模块 PA12 CS PA13 SCK

2023-10-23 13:56:44

使用RT-Thread studio开启SPI框架驱动OLED失败是哪个步骤做错了吗

想学习使用SPI框架驱动OLED，就准备把中景园的程序移植到RTT上，参考了网上的步骤，在settings里开启spi，在board.c里复制HAL_SPI_MspInit，在board.h

2022-11-10 10:32:48

使用VSCode调试全志R128的C906 RISC-V核心

Setting CSkyDebugServer->setting->Socket Setting 启动CSkyDebugServer 确保R128正常运行

2023-11-20 17:24:43

使用开源库驱动OLED模块

　　一、OLED模块介绍　　我们的OLDE模块样子如上图所示，整个屏幕有128*64个像素点，我们可以实现对每一个像素点的亮灭控制，以此实现对屏幕显示内容的控制。注意我们并不能控制屏幕上像素的颜色

2023-03-28 15:48:18

关于OCP2133 OLED屏幕驱动的知识点总结的太棒了

关于OCP2133 OLED屏幕驱动的知识点总结的太棒了

2021-06-18 07:47:00

各种OLED屏幕的使用方式的总结

本文主要是笔者在学习单片机过程中，所遇各种OLED屏幕的使用方式的总结归纳。关于SSD1306驱动的OLED屏幕开源程序有很多，其与单片机通信的方式主要有两种，一是SPI通信，二是I2C通信。其中

2021-12-07 07:38:47

在全志R128上启用USB ADB以及无线ADB配置方法

首先在FreeRTOS的环境下，选择r128_c906_pro： source envsetup.sh lunch_rtos r128s2_pro_c906 USB ADB的配置比较常规，注意以下

2023-10-17 17:16:43

在全志R128上进行HiFi5语音算法部署

cmd_my_dsp_asr ./out/ --include=*.binBinary file ./out/r128s3/evb1/r128s2_dsp0_evb1.bin matchesBinary file

2024-01-02 09:55:51

基于stm32的oled屏幕介绍

基于stm32的oled屏幕介绍，STM32 正点原子库函数移植hal库 oled SPI 显示目录1、oled简介2、SPI简介3、hal库oled显示源码4、oled显示汉字，图片##OLED

2021-08-10 08:12:40

如何检测屏幕是lcd还是oled

如何检测屏幕是lcd还是oled，在测试HarmonyOS Wi-Fi IoT 套件Hi3861过程，套件上的oled屏幕不亮了，最后排查发现是测试新程序的时候把之前的测试程序入口更改了，无法驱动oLED了。论坛上有连志...

2021-07-16 07:01:19

小时候画在手腕上的表，我用全志R128让他真正动了起来

——NWatch，并把他移植到了R128开发板上。项目简介本项目基于ZakKemble的开源项目NWatch，与原作者的NWatch不一样的是，作者将其移植到DShanMCU-R128

2023-11-09 17:03:51

开源项目！教你如何复刻自平衡赛车机器人、智能家居中控、竞技机器人先进模糊控制器等

开源项目作品为了方便大家更好提升自己，电子发烧友小编为大家整理了一些工程师大佬设计的开源项目作品，供大家可以参考学习，希望对广大工程师有所帮助。 1.用全志R128复刻自平衡赛车机器人，还实现

2023-12-26 09:17:46

用全志R128复刻自平衡赛车机器人，还实现了三种不同的操控方式

更上一层楼。硬件设计本项目中的自平衡赛车机器人的硬件设计结构非常简单，硬件部分主要由R128开发板和几个驱动模块组成。供电模块自平衡机器人采用锂电池供电的方式，并利用mini360航模电池降压

2023-12-20 10:22:18

纵享丝滑！全志R128+LVGL驱动多尺寸RGB LCD屏幕流畅运行

新晋点屏神器，R128！各种屏幕都能点！高刷、大屏、宽色域......通常来讲，显示器的配置越高，越能给使用者带来优于其它一般配置显示器的体验。但就某些特殊的使用场景来讲，选择配置合适的显示屏幕

2023-12-22 09:52:19

讨论关于STM32驱动两个OLED的方案

最近突发奇想往开发板上接了两个OLED转接板，并排OLED双屏显示，比LCD还拉风，我把库函数每个功能函数都复制一遍，并改了函数名，这样就能驱动两个OLED了，但突发奇想，如何实现两个屏幕拓展显示？即组成128x128，或是256x64，向是电脑两个屏幕拓展显示一样。。

2015-08-20 09:31:12