update README

This commit is contained in:
Shuanglei Tao
2025-10-15 17:47:44 +08:00
parent 1ac6b8473f
commit 913ee75126
5 changed files with 56 additions and 36 deletions

View File

@@ -1,44 +1,11 @@
# EPD-nRF5
电子墨水屏固件,带有一个[网页版上位机](https://tsl0922.github.io/EPD-nRF5/),可以通过蓝牙传输图像到墨水屏,也可以把墨水屏设置为日历模式(支持农历、节气、节假日调休显示)。
墨水屏日历固件,支持农历、节气、节假日调休显示,也可以通过蓝牙传输图像到墨水屏作为相框使用。日历界面已适配常见的 4.2 寸和 7.5 寸墨水屏分辨率,且同一个固件可驱动不同尺寸屏幕(可通过上位机在线切换屏幕尺寸和驱动)。
支持的主控芯片有: `nrf51822` / `nrf51802` / `nrf52811` / `nrf52810`支持的墨水屏驱动有:`UC8176` / `UC8276` / `SSD1619` / `SSD1683` / `JD79668`(黑白/三色/四色墨水屏),同时还支持自定义墨水屏到 MCU 的引脚映射支持睡眠唤醒NFC / 无线充电器),支持蓝牙 OTA 固件升级。
支持的主控芯片有: `nrf51822` / `nrf51802` / `nrf52811` / `nrf52810`墨水屏方面支持常见的 `UC81xx` / `SSD16xx` 系列驱动(黑白/三色/四色),同时还支持自定义墨水屏到 MCU 的引脚映射支持睡眠唤醒NFC / 无线充电器),支持蓝牙 OTA 固件升级。
![](docs/images/3.jpg)
## 支持设备
- 老五 4.2 寸价签,黑白双色版本
```
MCUnrf51822
RAM16K
ROM128K
驱动UC8176 (EPD_4in2)
屏幕引脚0508090A0B0C0D
线圈引脚07
```
![](docs/images/1.jpg)
- 老五 4.2 寸价签,黑白红三色版本
```
MCUnrf51802
RAM16K
ROM256K
驱动UC8176 (EPD_4in2b_V2)
屏幕引脚0A0B0C0D0E0F10
线圈引脚09
LED引脚03/04/05 (有三个 LED任选一个使用
```
![](docs/images/2.jpg)
- 其它基于 `nrf51822` / `nrf51802` / `nrf52811` / `nrf52810` 的价签,理论上都支持
## 上位机
本项目自带一个基于浏览器蓝牙接口实现的网页版上位机,可使用手机或电脑打开下面地址使用,或者在本地直接双击打开 `html/index.html` 来使用。
@@ -51,6 +18,14 @@
上位机支持多种图片抖动算法,且可以对图片进行涂鸦、添加文字。除了显示图片作为电子相框外,还可以切换到日历模式,显示月历、农历节气、节假日、放假调休等信息。
## 支持设备
[查看文档](docs/devices.md)。
## 开发编译
[查看文档](docs/develop.md)。
## 致谢
本项目使用或参考了以下项目的代码:

View File

@@ -43,4 +43,4 @@ pacman -S make mingw-w64-x86_64-gcc
修改 GUI 目录下的代码后,重新执行上面的 make 命令编译即可。
> **注意:** GUI 目录下的代码不可依赖平台相关的东西,比如单片机特有的 API 接口,否则在 Windows 下编译会失败。正确的做法是:在调用 `DrawGUI(gui_data_t *data, buffer_callback draw, display_mode_t mode)` 函数前就把数据算好并放到 `gui_data_t` 里,然后通过 `data` 参数传进去。
> **注意:** GUI 目录下的代码不可依赖平台相关的东西,比如单片机特有的 API 接口,否则在 Windows 下编译会失败。正确的做法是:在调用 `DrawGUI` 函数前就把数据算好并放到 `gui_data_t` 里,然后通过 `data` 参数传进去。

45
docs/devices.md Normal file
View File

@@ -0,0 +1,45 @@
## 支持设备
只要是基于 `nrf51822` / `nrf51802` / `nrf52811` / `nrf52810` 的价签,理论上都支持。
下面列举几个适配了的价签驱动板。
### 老五 4.2 寸价签,黑白双色版本
- MCUnrf51822
- RAM16K
- ROM128K
- 驱动UC8176
- 屏幕引脚0508090A0B0C0D
- 线圈引脚07
![](images/1.jpg)
### 老五 4.2 寸价签,黑白红三色版本
- MCUnrf51802
- RAM16K
- ROM256K
- 驱动UC8176
- 屏幕引脚0A0B0C0D0E0F10
- 线圈引脚09
- LED引脚03/04/05 (有三个 LED任选一个使用
![](images/2.jpg)
### 思飞 52810
- MCUnrf52810
- RAM24K
- ROM192K
![](images/5.jpg)
### 盒马/阿里 52811
- MCUnrf52811
- RAM24K
- ROM192K
![](images/6.jpg)

BIN
docs/images/5.jpg Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 471 KiB

BIN
docs/images/6.jpg Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 332 KiB