用途:通过 HTTP 控制 GeekMagic SmallTV Ultra(ESP8266 + 240x240 TFT),并支持上传内容与固件开发。
主要能力:设置主题(1-7)、亮度、城市;上传 JPEG/GIF 到相册或天气屏;读取 /v.json、/space.json 等状态端点;提供替代固件安装与自写固件(PlatformIO + TFT_eSPI)指引。
使用方式:先读取 .claude/geekmagic-smalltv-ultra.local.md 获取 device_ip,并用 curl -s http://{IP}/v.json 验证型号为 SmallTV-Ultra。核心调用:curl "http://{IP}/set?{param}={value}",成功返回 OK。上传命令:curl -F "file=@dashboard.jpg" "http://{IP}/doUpload?dir=/image/",再 GET /set?img=... 与 /set?theme=3 显示。
限制与安全:所有端点无认证且立即执行;/wifisave 空参数、/set?reset=1、/set?reboot=1、/set?clear=image|gif、/delete 等破坏性操作须经用户明确确认。设备约 80KB RAM、约 1.2MB 空闲存储,单线程、无 HTTPS;原厂固件不支持任意文本,需渲染为 240x240 图片,天气屏 GIF 必须 80x80px。改刷固件前须核对型号并备份原厂 .bin。设备 IP、型号、固件版本等具体取值以实际 /v.json 为准。其余未提供。