ClawdMochi Docs

ClawdMochi 散件安装教程

ClawdMochi 散件组装图文教程,包含材料检查、屏幕安装、螺丝固定、接线、固件烧录与合盖步骤。

ClawdMochi 展示图

ClawdMochi 散件安装教程

安装前请先完整看一遍本教程。外壳、屏幕和排线都比较精细,安装时不要用蛮力按压、硬塞或强行合盖。

重要提醒:切忌“大力出奇迹”。如果某一步感觉卡住,请先停下来检查方向、位置和线序。

1. 检查材料包

客户收到的套件已是拆开状态,无需再拆背板。请先确认材料是否齐全:

  • 已拆开的外壳和背板
  • 6 枚螺丝
  • 1 块屏幕
  • 8 根连接线

拆开后的材料包

2. 放入屏幕

从壳体正面将屏幕放入开孔,使显示面朝外。请注意屏幕方向,不要放反,也不要用力挤压屏幕边缘。

放入屏幕后的背面

屏幕放好后,从正面确认屏幕平整贴住前壳,不应明显翘起或歪斜。

屏幕正面贴合效果

3. 固定屏幕

拧入 4 枚螺丝固定屏幕。

注意:螺丝只需要固定到位即可,不要拧得过紧。过度拧紧可能会挤压屏幕,导致屏幕边缘或局部发白。

固定屏幕后背面

4. 连接排线

将 8 根连接线分开,按下表逐根连接。三种固件版本使用相同的屏幕接线,无需下载其他教程查看。

屏幕引脚ESP32-C3 GPIO说明
VCC3V3只能接 3.3V
GNDGND地线
SDAGPIO 10SPI MOSI
SCLGPIO 8SPI SCK
RSTGPIO 2复位
DCGPIO 1数据 / 命令
CSGPIO 4片选
BLGPIO 3背光

认引脚位置

成品开发板已焊好排针,板上的丝印文字会被排针挡住,无法直接读出引脚名称。请对照下面的引脚图按位置数针:拿住开发板,让 USB-C 接口朝上、正面(有元件的一面)朝向自己,从最靠近 USB 的一端往下数,就是图中 1–8 号位置的顺序。标橙色的 8 个位置就是需要接屏幕的引脚,其余引脚全部空着。

ESP32-C3 SuperMini 引脚图

连接排线

5. 烧录固件

连接完成后,用支持数据传输的 USB 线连接设备,然后先下载 ClawdMochi 客户交付包(2026-08-08)。解压后按设备版本进入 资料-wifi版/资料-有线版/资料-蓝牙版/,再选择电脑系统对应的烧录目录:

  1. Windows:打开 烧录-Windows/,双击 flash-windows.bat,按提示选择 COM 口。
  2. macOS:打开 烧录-macOS/,双击 双击烧录.command;也可在该目录的终端中运行 bash flash-mac.sh
  3. 烧录完成后,拔掉再重新插上设备。蓝牙版平时用蓝牙控制,但烧录时同样必须使用 USB 数据线。

烧录前请关闭 Arduino IDE、串口监视器等可能占用串口的软件;必须使用数据线,纯充电线无法烧录。

烧录完成并重新插上设备后,如果屏幕变灰但不亮,通常说明接线顺序有误。请立即断电,重新核对每一根线的位置后再上电测试。

常见问题:屏幕边缘出现白色漏光

这是固定屏幕的螺丝拧得过紧造成的挤压,不是屏幕故障。找到出现白色漏光的位置,将该位置附近的固定螺丝稍微松开一点即可;不要一次松得太多,也不要拆下螺丝。调整后查看屏幕边缘,漏光消失或明显减轻即可。

ClawdMochi 一键烧录教程

6. 合上背板

烧录与开机测试都正常后,合上背板,拧回 2 枚背板螺丝。请确认 USB-C 接口位于外壳开孔处,便于后续连接电脑。

完成合盖