# harmonyos-ssd1306

**Repository Path**: lyzcc/harmonyos-ssd1306

## Basic Information

- **Project Name**: harmonyos-ssd1306
- **Description**: 鸿蒙OS的SSD1306 OLED显示屏驱动库，使用了鸿蒙的IoT硬件I2C接口
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 11
- **Created**: 2021-12-29
- **Last Updated**: 2021-12-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# harmonyos-ssd1306



支持HarmonyOS IoT硬件接口的SSD1306 OLED屏驱动库;

* 内置了128*64 bit的内存缓冲区，支持全屏刷新;
* 优化了屏幕刷新速率，实测最大帧率10fps;
* `libm_port`是从musl libc中抽取的`sin`和`cos`的实现；
    * 用于规避链接Hi3861 SDK中的libm_flash.a报错的问题;
* `gif2imgs.py` 可用于将gif动图中的帧分离出来;
    * 依赖 pillow 包，可以使用 `pip install pillow` 命令安装；
* `img2code.py` 可用于将图片转为C数组，每个字节表示8个像素；
    * 依赖 opecv-python 包，可以使用 `pip install opencv-python` 命令安装；

## 如何编译

1. 在openharmony源码目录下克隆本项目：`git clone https://gitee.com/hihopeorg/harmonyos-ssd1306`

2. 修改openharmony源码的`build/lite/product/wifiiot.json`文件：

   将`//applications/sample/wifi-iot/app`替换为`//harmonyos-ssd1306:app`保存；

3. 在openharmony源码目录下执行：`python build.py wifiiot`


## 编译错误解决

本项目代码使用了鸿蒙IoT硬件子系统的I2C API接口，需要连接到hi3861的I2C相关接口；默认情况下，Hi3861的I2C编译配置没有打开，编译时会有如下错误：

```txt
riscv32-unknown-elf-ld: ohos/libs/libhal_iothardware.a(hal_wifiiot_i2c.o): in function `.L0 ':
hal_wifiiot_i2c.c:(.text.HalI2cWrite+0x12): undefined reference to `hi_i2c_write'
riscv32-unknown-elf-ld: hal_wifiiot_i2c.c:(.text.HalI2cInit+0x12): undefined reference to `hi_i2c_init'
scons: *** [output/bin/Hi3861_wifiiot_app.out] Error 1
BUILD FAILED!!!!
```

**解决方法**

需要修改vendor\hisi\hi3861\hi3861\build\config\usr_config.mk文件：
`# CONFIG_I2C_SUPPORT is not set`行，修改为：`CONFIG_I2C_SUPPORT=y`

## 效果演示

1. 播放gif：https://www.bilibili.com/video/BV1Af4y1B7TD/
    * 使用本项目中的转换脚本将gif每一帧画面提取出来，转成bitmap数组，程序里循环播放
2. 播放视频：https://www.bilibili.com/video/BV1DK4y1f7yw/
    * C/S架构，开发板作为客户端，PC作为服务端，使用TCP传输每帧画面（因为视频帧数较多，开发板闪存放不下）
    * 播放项目源码： https://gitee.com/hihopeorg/harmonyos_oled_player

## 参考链接

本项目是基于afiskon的stm32-ssd1306移植的，对部分细节做了修改和优化，原项目链接：

* https://github.com/afiskon/stm32-ssd1306