/rtt-ssd1306

RT-Thread package for working with OLEDs based on SSD1306, SH1106, SH1107 and SSD1309, supports I2C and SPI. Inspired by stm32-ssd1306.

Primary LanguageCMIT LicenseMIT

rtt-ssd1306

RT-Thread package for working with OLEDs based on SSD1306, SH1106, SH1107 and SSD1309, supports I2C and SPI. Inspired by stm32-ssd1306.

1、介绍

ssd1306 是兼容基于 SSD1306、SH1106、SH1107 和 SSD1309 的 OLED 驱动软件包,支持 I2C 和 SPI 接口。参考 afiskon 的 stm32-ssd1306 项目进行移植,对接 RT-Thread 操作系统。

目前支持 RT-Thread 软件 I2C 接口,后续将完善对硬件 I2C 和 SPI 的支持。

1.1 目录结构

名称 说明
examples 例子目录
inc 头文件目录
src 源代码目录
tools 工具目录

1.2 许可证

ssd1306 软件包遵循 MIT 许可,详见 LICENSE 文件。

2、获取 ssd1306 软件包

使用 ssd1306 package 需要在 RT-Thread 的包管理器中选择它,具体路径如下:

RT-Thread online packages --->
    peripheral libraries and drivers --->
        [*] ssd1306: OLEDs based on SSD1306, SH1106, SH1107 and SSD1309 driver  --->

然后让 RT-Thread 的包管理器自动更新,或者使用 pkgs --update 命令更新包到 BSP 中。

3、API 说明

初始化

void ssd1306_Init(void);

填充

void ssd1306_Fill(SSD1306_COLOR color);

刷新屏幕

void ssd1306_UpdateScreen(void);

画像素

void ssd1306_DrawPixel(uint8_t x, uint8_t y, SSD1306_COLOR color);

打印字符

char ssd1306_WriteChar(char ch, FontDef Font, SSD1306_COLOR color);

打印字符串

char ssd1306_WriteString(char* str, FontDef Font, SSD1306_COLOR color);

设置光标

void ssd1306_SetCursor(uint8_t x, uint8_t y);

画直线

void ssd1306_Line(uint8_t x1, uint8_t y1, uint8_t x2, uint8_t y2, SSD1306_COLOR color);

画弧线

void ssd1306_DrawArc(uint8_t x, uint8_t y, uint8_t radius, uint16_t start_angle, uint16_t sweep, SSD1306_COLOR color);

画圆

void ssd1306_DrawCircle(uint8_t par_x, uint8_t par_y, uint8_t par_r, SSD1306_COLOR color);

画折线

void ssd1306_Polyline(const SSD1306_VERTEX *par_vertex, uint16_t par_size, SSD1306_COLOR color);

画矩形

void ssd1306_DrawRectangle(uint8_t x1, uint8_t y1, uint8_t x2, uint8_t y2, SSD1306_COLOR color);

4、联系方式