trmnl-paper-screen

name

trmnl-paper-screen

description

Use when the user wants to push, deploy, or update screen content on a TRMNL device via a LaraPaper instance. Builds the JSON payload with device credentials (MAC address + device API key) and sends to `/api/screens`. After an actual send, it can read back `image_url` from the current screen endpoint, review the rendered result, and route layout fixes back to `trmnl-paper-blade`. Also use when they say "send to device," "update the display," "deploy this screen," or need to construct the LaraPaper screen update request for already-prepared markup.

trmnl-paper-screen

概览

负责把已有 markup 通过 POST /api/screens 推送到 LaraPaper。实际发送成功后，再取回当前渲染图（路径见 references/api-screens.md），审查展示是否正常、是否适合 e-paper；若有问题，则把问题清单回传给 trmnl-paper-blade 做下一轮修正。

工作流

1. 确认 markup 是否就绪

   • 没有 → 先用 trmnl-paper-blade 生成，再回到这里
   • 有 → 继续

2. 收集参数（四个都必须）：

   参数	说明	示例
   base URL	LaraPaper 实例地址，必须带 scheme	https://larapaper.example.com
   mac_address	设备 MAC，服务端会自动转大写	AA:BB:CC:DD:EE:FF
   device API key	设备级 API key（不是 APP_KEY）	abc123...
   markup	要推送的 Blade / HTML 内容	<x-trmnl::screen>...</x-trmnl::screen>

3. 默认 dry-run：预览完整请求体（凭据已脱敏），用户明确要求时才实际 POST；如需查看原始凭据，仅 dry-run 可加 。