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）
