README.md
1# HiSpark WiFi-IoT 套件样例开发--harmonyos-ssd1306
2
3
4
5[HiSpark WiFi-IoT开发套件](https://item.taobao.com/item.htm?spm=a1z10.1-c-s.w5003-23341819265.1.bf644a82Da9PZK&id=622343426064&scene=taobao_shop) 首发于HDC 2020，是首批支持OpenHarmony 2.0的开发套件，亦是官方推荐套件，由润和软件HiHope量身打造，已在OpenHarmony社区和广大OpenHarmony开发者中得到广泛应用。
6
7
8
9
10
11## 一、I2C API
12
13| API名称 | 说明 |
14| ------------------------------------------------------------ | ------------------------------- |
15| I2cInit (WifiIotI2cIdx id, unsigned int baudrate) | 用指定的波特速率初始化I2C设备 |
16| I2cDeinit (WifiIotI2cIdx id) | 取消初始化I2C设备 |
17| I2cWrite (WifiIotI2cIdx id, unsigned short deviceAddr, const WifiIotI2cData *i2cData) | 将数据写入I2C设备 |
18| I2cRead (WifiIotI2cIdx id, unsigned short deviceAddr, const WifiIotI2cData *i2cData) | 从I2C设备中读取数据 |
19| I2cWriteread (WifiIotI2cIdx id, unsigned short deviceAddr, const WifiIotI2cData *i2cData) | 向I2C设备发送数据并接收数据响应 |
20| I2cRegisterResetBusFunc (WifiIotI2cIdx id, WifiIotI2cFunc pfn) | 注册I2C设备回调 |
21| I2cSetBaudrate (WifiIotI2cIdx id, unsigned int baudrate) | 设置I2C设备的波特率 |
22
23## 二、ssd1306 API
24
25本样例提供了一个HarmonyOS IoT硬件接口的SSD1306 OLED屏驱动库，其功能如下：
26
27* 内置了128*64 bit的内存缓冲区，支持全屏刷新;
28* 优化了屏幕刷新速率，实测最大帧率10fps;
29* `libm_port`是从musl libc中抽取的`sin`和`cos`的实现；
30 * 用于规避链接Hi3861 SDK中的libm_flash.a报错的问题;
31* `gif2imgs.py` 可用于将gif动图中的帧分离出来;
32 * 依赖 pillow 包，可以使用 `pip install pillow` 命令安装；
33* `img2code.py` 可用于将图片转为C数组，每个字节表示8个像素；
34 * 依赖 opecv-python 包，可以使用 `pip install opencv-python` 命令安装；
35
36* 使用Harmony OS的IoT硬件接口;
37* 接口简洁易于使用、易于移植;
38* 内置了测试程序，可直接进行测试;
39
40| API名称 | 说明 |
41| ------------------------------------------------------------ | -------------------------- |
42| void ssd1306_Init(void) | 初始化 |
43| void ssd1306_Fill(SSD1306_COLOR color) | 以指定的颜色填充屏幕 |
44| void ssd1306_SetCursor(uint8_t x, uint8_t y) | 定位光标 |
45| void ssd1306_UpdateScreen(void) | 更新屏幕内容 |
46| char ssd1306_DrawChar(char ch, FontDef Font, SSD1306_COLOR color) | 在屏幕缓冲区绘制1个字符 |
47| char ssd1306_DrawString(char* str, FontDef Font, SSD1306_COLOR color) | 将完整字符串写入屏幕缓冲区 |
48| void ssd1306_DrawPixel(uint8_t x, uint8_t y, SSD1306_COLOR color) | 在屏幕缓冲区中绘制一个像素 |
49| void ssd1306_DrawLine(uint8_t x1, uint8_t y1, uint8_t x2, uint8_t y2, SSD1306_COLOR color) | 用Bresenhem算法画直线 |
50| void ssd1306_DrawPolyline(const SSD1306_VERTEX *par_vertex, uint16_t par_size, SSD1306_COLOR color) | 绘制多段线 |
51| void ssd1306_DrawRectangle(uint8_t x1, uint8_t y1, uint8_t x2, uint8_t y2, SSD1306_COLOR color) | 绘制矩形 |
52| void ssd1306_DrawArc(uint8_t x, uint8_t y, uint8_t radius, uint16_t start_angle, uint16_t sweep, SSD1306_COLOR color) | 绘图角度 |
53| void ssd1306_DrawCircle(uint8_t par_x, uint8_t par_y, uint8_t par_r, SSD1306_COLOR color) | 用Bresenhem算法画圆 |
54| void ssd1306_DrawBitmap(const uint8_t* bitmap, uint32_t size) | 绘图位图 |
55| 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) | 绘制区域 |
56
57## 三、如何编译
58
591. 将此目录复制到openharmony源码的根目录下
60
612. 修改openharmony源码的`build/lite/product/wifiiot.json`文件：
62
63 将`//applications/sample/wifi-iot/app`替换为`//12_ssd1306:app`保存；
64
653. 在openharmony源码目录下执行：`python build.py wifiiot`
66
67
68## 四、编译错误解决
69
70本项目代码使用了IoT硬件子系统的I2C API接口，需要连接到hi3861的I2C相关接口；默认情况下，Hi3861的I2C编译配置没有打开，编译时会有如下错误：
71
72```txt
73riscv32-unknown-elf-ld: ohos/libs/libhal_iothardware.a(hal_wifiiot_i2c.o): in function `.L0 ':
74hal_wifiiot_i2c.c:(.text.HalI2cWrite+0x12): undefined reference to `hi_i2c_write'
75riscv32-unknown-elf-ld: hal_wifiiot_i2c.c:(.text.HalI2cInit+0x12): undefined reference to `hi_i2c_init'
76scons: *** [output/bin/Hi3861_wifiiot_app.out] Error 1
77BUILD FAILED!!!!
78```
79
80**解决方法**
81
82需要修改vendor\hisi\hi3861\hi3861\build\config\usr_config.mk文件：
83`# CONFIG_I2C_SUPPORT is not set`行，修改为：`CONFIG_I2C_SUPPORT=y`
84
85## 五、效果演示
86
871. 播放gif：https://www.bilibili.com/video/BV1Af4y1B7TD/
88 * 使用本项目中的转换脚本将gif每一帧画面提取出来，转成bitmap数组，程序里循环播放
892. 播放视频：https://www.bilibili.com/video/BV1DK4y1f7yw/
90 * C/S架构，开发板作为客户端，PC作为服务端，使用TCP传输每帧画面（因为视频帧数较多，开发板闪存放不下）
91 * 播放项目源码： https://gitee.com/hihopeorg/harmonyos_oled_player
92
93## 六、参考链接
94
95本项目是基于afiskon的stm32-ssd1306移植的，对部分细节做了修改和优化，原项目链接：
96
97* https://github.com/afiskon/stm32-ssd1306
98
99
100
101### 【套件支持】
102
103##### 1. 套件介绍 http://www.hihope.org/pro/pro1.aspx?mtt=8
104
105##### 2. 套件购买 https://item.taobao.com/item.htm?id=622343426064&scene=taobao_shop
106
107##### 3. 技术资料
108
109- Gitee码云网站（OpenHarmony Sample Code等) **https://gitee.com/hihopeorg**
110
111- HiHope官网-资源中心（SDK包、技术文档下载）[**www.hihope.org**](http://www.hihope.org/)
112
113##### 4. 互动交流
114
115- 润和HiHope技术交流-微信群（加群管理员微信13605188699，发送文字#申请加入润和官方群#，予以邀请入群）
116- HiHope开发者社区-论坛 **https://bbs.elecfans.com/group_1429**
117- 润和HiHope售后服务群（QQ：980599547）
118- 售后服务电话（025-52668590）
){kind=link}
){kind=link}