https://github.com/tsl0922/epd-nrf5

4.2-inch e-ink display firmware for Nordic nRF51/nRF52, with support for Bluetooth image transfer, NFC wake-up.
https://github.com/tsl0922/epd-nrf5

ble bluetooth e-ink nrf51 nrf51822 nrf52 nrf52811

Last synced: 6 months ago
JSON representation

4.2-inch e-ink display firmware for Nordic nRF51/nRF52, with support for Bluetooth image transfer, NFC wake-up.

• Host: GitHub
• URL: https://github.com/tsl0922/epd-nrf5
• Owner: tsl0922
• License: gpl-3.0
• Created: 2024-11-11T07:24:18.000Z (11 months ago)
• Default Branch: main
• Last Pushed: 2025-04-07T05:16:27.000Z (6 months ago)
• Last Synced: 2025-04-07T17:07:27.179Z (6 months ago)
• Topics: ble, bluetooth, e-ink, nrf51, nrf51822, nrf52, nrf52811
• Language: C
• Homepage: https://tsl0922.github.io/EPD-nRF5/
• Size: 38.9 MB
• Stars: 93
• Watchers: 4
• Forks: 32
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

          
# EPD-nRF5

4.2 寸电子墨水屏固件，带有一个[网页版上位机](https://tsl0922.github.io/EPD-nRF5/)，可以通过蓝牙传输图像到墨水屏，也可以把墨水屏设置为日历模式（支持农历、节气）。

支持 `nrf51822` / `nrf51802` / `nrf52811` / `nrf52810` MCU 作为主控，驱动 IC 为 `UC8176` / `UC8276` / `SSD1619` / `SSD1683` 的 4.2 寸黑白/黑白红墨水屏，同时还支持自定义墨水屏到 MCU 的引脚映射，支持睡眠唤醒（NFC / 无线充电器）。

![](docs/images/3.jpg)

## 支持设备

- 老五 4.2 寸价签，黑白双色版本

    ```

    MCU：nRF51822

    RAM：16K

    ROM：128K

    驱动：UC8176 (EPD_4in2)

    屏幕引脚：0508090A0B0C0D

    线圈引脚：07

    ```

    ![](docs/images/1.jpg)

- 老五 4.2 寸价签，黑白红三色版本

    ```

    MCU：nRF51802

    RAM：16K

    ROM：256K

    驱动：UC8176 (EPD_4in2b_V2)

    屏幕引脚：0A0B0C0D0E0F10

    线圈引脚：09

    LED引脚：03/04/05 （有三个 LED，任选一个使用）

    ```

    ![](docs/images/2.jpg)

- 其它基于 `nrf51822` / `nrf51802` / `nrf52811` / `nrf52810` 的价签，只要你有能力测量出引脚配置，且屏幕驱动在支持列表内，那就可以支持

## 上位机

本项目自带一个基于浏览器蓝牙接口实现的网页版上位机，可通过上面网址访问，或者在本地直接双击打开 `html/index.html` 来使用。

- 地址：https://tsl0922.github.io/EPD-nRF5

- 演示：https://www.bilibili.com/video/BV1KWAVe1EKs

- 交流群: [1033086563](https://qm.qq.com/q/SckzhfDxuu) (点击链接加入群聊)

![](docs/images/0.jpg)

## 开发

> **注意:**

> - 推荐使用 [Keil 5.36](https://img.anfulai.cn/bbs/96992/MDK536.EXE) 或以下版本（如遇到 pack 无法下载，可到群文件下载）

> - `sdk10` 分支为旧版 SDK 代码，蓝牙协议栈占用的空间小一些，用于支持 128K Flash 芯片（不再更新）

这里以 nRF51 版本项目为例 (`Keil/EPD-nRF51.uvprojx`)，项目配置有几个 `Target`：

- `nRF51822_xxAA`: 用于编译 256K Flash 固件

- `flash_softdevice`: 刷蓝牙协议栈用（只需刷一次）

烧录器可以使用 J-Link 或者 DAPLink（可使用 [RTTView](https://github.com/XIVN1987/RTTView) 查看 RTT 日志）。

**刷机流程:**

> **注意:** 这是自己编译代码的刷机流程。如不改代码，强烈建议到 [Releases](https://github.com/tsl0922/EPD-nRF5/releases) 下载编译好的固件，**不需要单独下载蓝牙协议栈**，且有 [刷机教程](https://b23.tv/AaphIZp) （没有 Keil 开发经验的，请不要给自己找麻烦去编译）

1. 全部擦除 (Keil 擦除后刷不了的话，使用烧录器的上位机软件擦除试试)

2. 切换到 `flash_softdevice`，下载蓝牙协议栈，**不要编译直接下载**（只需刷一次）

3. 切换到 `nRF51822_xxAA`，先编译再下载

## 附录

上位机支持的指令列表（指令和参数全部要使用十六进制）：

- 驱动相关：

    - `00`+引脚配置: 设置引脚映射（见上面引脚配置）

    - `01`+驱动 ID: 驱动初始化

    - `02`: 清空屏幕（把屏幕刷为白色）

    - `03`+命令: 发送命令到屏幕（请参考屏幕主控手册）

    - `04`+数据: 写入数据到屏幕内存（同上）

    - `05`: 刷新屏幕（显示已写入屏幕内存的数据）

    - `06`: 屏幕睡眠

- 日历模式：

    - `20`+UNIX 时间戳: 同步时间并开启日历模式

- 系统相关：

    - `90`+配置: 写入自定义配置（重启生效）

    - `91`: 系统重启

    - `92`: 系统睡眠

    - `99`: 恢复默认设置并重启

## 致谢

- 屏幕驱动代码来自微雪 [E-Paper Shield](https://www.waveshare.net/wiki/E-Paper_Shield)

- 网页版上位机代码来自 [atc1441/ATC_TLSR_Paper](https://github.com/atc1441/ATC_TLSR_Paper)