{
  "added_at": "2026-11-09",
  "additional_evidence_urls": [
    "https://github.com/yorgossot/catlink-local/blob/78f275e0c210d22e96ca177285d28fd9fef10990/docs/PROTOCOL.md"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "catlink-local reconstructs the CATLINK Open X litter box's login and MQTT exchanges for local Home Assistant use. Python services answer its login request, decode heartbeats and visits, and bridge state to Mosquitto; protocol notes distinguish confirmed fields from hypotheses.",
  "description_zh": "catlink-local 还原 CATLINK Open X 猫砂盆的登录与 MQTT 通信，供 Home Assistant 在本地使用。Python 服务应答登录请求、解析心跳和如厕记录，并将状态发布到 Mosquitto；协议文档区分已确认字段与推测字段。",
  "entry_url": "https://awesomerea.org/resources/catlink-local-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/catlink-local-case/",
  "evidence_url": "https://github.com/yorgossot/catlink-local/blob/78f275e0c210d22e96ca177285d28fd9fef10990/README.md",
  "group": "cases",
  "id": "catlink-local-case",
  "json_url": "https://awesomerea.org/resources/catlink-local-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/catlink-local-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/catlink-local-case/index.md",
  "name": "catlink-local: reconstructing CATLINK Open X local control",
  "name_zh": "catlink-local：还原 CATLINK Open X 本地控制",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "testing",
    "limits",
    "license"
  ],
  "requirements": [
    "A CATLINK Open X C08 with firmware 04.22, a Linux host, local DNS routing, Mosquitto and Home Assistant are used in the documented setup.",
    "The author reports testing one box and one firmware for days; many protocol fields remain unconfirmed.",
    "Commands are disabled by default and require deliberate setup and supervision around moving parts.",
    "Licensed under MIT."
  ],
  "requirements_zh": [
    "文档中的部署使用 CATLINK Open X C08、04.22 固件、Linux 主机、本地 DNS 重定向、Mosquitto 和 Home Assistant。",
    "作者报告仅在一台设备和一个固件版本上测试了数日；许多协议字段仍未确认。",
    "命令默认关闭；启用后涉及运动部件的操作需要专门配置并有人看护。",
    "采用 MIT 许可证。"
  ],
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/yorgossot/catlink-local",
  "verification": "source-reviewed",
  "verified_at": "2026-11-08"
}