开发文档

显示模型

DS5 对外不是裸 LCD，也不是 i8080 面板透传。外部主机只需要发送统一的逻辑画面，DS5 固件会在内部转换到实际屏幕。

外部主机不要自行按设备倒放方向旋转画面。固件会根据设备设置处理物理屏幕旋转。

引脚定义

提供FPC接口（0.5mm 8pin）和杜邦线接口，引脚定义如下：

供电

DS5 可以通过 USB Type-C 供电，也可以通过接口 Pin 1 供电。使用 Pin 1 供电时，屏幕不需要再接 USB Type-C。

• 独立使用时，直接接 USB Type-C。
• 接入外部系统时，可以由外部系统通过 Pin 1 给 DS5 供电。
• DS5 和外部主机需要共地。
• SPI 信号是 3.3V 逻辑；如果外部主机是 5V 逻辑，需要做电平转换。

接线

外部主机可以是任意支持 SPI mode 0 的 MCU 或开发板；下表里的 GPIO 只是测试 sketch 的默认引脚，可以按你的主机硬件修改。

SPI 是单向数据流，不使用 MISO。建议先使用 1 MHz SPI 时钟。确认稳定后再提高频率。发送新包前必须等待 BUSY_OUT 为低电平。

SPI Protocol v1

一个 SPI transaction 就是一个完整 DS5 packet。协议不支持把一个 packet 拆成多个 CS 窗口。

CS low
  32-byte header
  optional payload
CS high

SPI 参数

Header

所有多字节整数都是 little-endian。CRC32 使用标准 CRC-32/ISO-HDLC。

命令

背光

SET_BACKLIGHT 用来设置 DS5 当前背光颜色和亮度，不会修改设备里保存的背光设置。闪烁、呼吸、渐变等效果由外部主机自己控制，按需要连续发送新的背光状态即可。

关闭背光可以发送 brightness = 0，也可以发送 r = g = b = 0。退出 SPI Bridge 后，设备会恢复自己的背光策略。

画面格式

MONO1

0 表示白，1 表示黑。每个字节保存 8 个像素，LSB first。

byte_index = y * 23 + x / 8
bit_index  = x & 7

GRAY4

0 表示白，15 表示黑。每个字节保存 2 个像素，低 nibble 在前。

byte_index = y * 92 + x / 2
low nibble  = x + 0
high nibble = x + 1

样例代码

仓库里包含一个 Arduino host 示例，默认引脚适合我们测试时使用的开发板；如果你使用其他主机，只需要保留协议和 DS5 侧信号，调整 SPI 初始化和引脚定义即可。

spi_bridge_host_test.ino

测试流程：

1. 打开 DS5 串口，输入 spi bridge status，确认设备支持 SPI Bridge。
2. 按上面的接线表连接外部主机和 DS5。
3. 如有需要，修改样例代码里的主机引脚定义。
4. 把样例 sketch 刷入外部主机，开始发送测试画面。

测试过程中再次查看 spi bridge status，正常情况下可以看到 hello 或 frames 计数增加。

最小发送流程

1. 拉高 HOST_DET。
2. 发送一个或多个 HELLO packet。
3. 等待 BUSY_OUT 为低。
4. 发送完整 FRAME_FULL packet。
5. 每次发送下一帧前，继续等待 BUSY_OUT 为低。

串口诊断命令

串口主要用于调试和技术支持。正常通过 SPI 使用 DS5 时，只需要关注 spi bridge status。串口波特率为 115200。