移植后的代码仓链接:github.com/hihope/harmonyos-ssd1306
功能简介:
-
使用Harmony OS的IoT硬件接口
-
提供字符绘制相关接口,内置四种字体大小的ASCII字符;
-
提供图形绘制相关接口,如绘制直线、矩形、圆形等;
-
内置一个128x64bit内存缓冲区,支持全屏刷新(可以用来实现动画、视频播放);
-
针对SSD1306连续数据发送进行了优化,目前全屏刷新速率能够达到10帧每秒;
-
MIT许可证,可使用到产品级代码中;
API接口如下:
void ssd1306_Init(void); // 初始化
void ssd1306_Fill(SSD1306_COLOR color); // 全屏填充
void ssd1306_SetCursor(uint8_t x, uint8_t y); // 设置光标位置
void ssd1306_UpdateScreen(void); // 更新屏幕,库中有一个内存缓冲区,绘制接口会将图像输出到内存缓冲区中,此接口会将缓冲区内容发送给SSD1306芯片
// 字符绘制相关接口
char ssd1306_DrawChar(char ch, FontDef Font, SSD1306_COLOR color);
char ssd1306_DrawString(char* str, FontDef Font, SSD1306_COLOR color);
// 图形绘制相关接口
void ssd1306_DrawPixel(uint8_t x, uint8_t y, SSD1306_COLOR color);
void ssd1306_DrawLine(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_DrawPolyline(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);
// 绘制矩形区域,可以用于绘制预渲染的汉字位图
void ssd1306_DrawRegion(uint8_t x, uint8_t y, uint8_t w, uint8_t h, const uint8_t* data, uint32_t size, uint32_t stride);
// 全屏绘制位图,[bitmap, size) 表示的内存区域需要需要和屏幕尺寸相同,小于屏幕尺寸使用 DrawRegion
void ssd1306_DrawBitmap(const uint8_t* bitmap, uint32_t size);
// 控制相关接口
void ssd1306_SetContrast(const uint8_t value); // 设置对比度
void ssd1306_SetDisplayOn(const uint8_t on); // 开关
uint8_t ssd1306_GetDisplayOn(void); // 获取开关状态
如何编译:
-
在openharmony源码目录下克隆本项目:git clone github.com/xusiwei/harmonyos-ssd1306
-
修改openharmony源码的build/lite/product/wifiiot.json文件:
将//applications/sample/wifi-iot/app替换为//harmonyos-ssd1306:app保存;
-
在openharmony源码目录下执行:python build.py wifiiot
项目代码中的 ssd1306_demo.c 和 ssd1306_tests.c 为测试代码
几个使用效果展示:
播放视频:www.bilibili.com/video/BV1DK4y1f7yw/
播放gif动图:www.bilibili.com/video/BV1Af4y1B7TD/
测试程序运行效果:www.bilibili.com/video/BV1C5411j7Cs/
作者:思维