nebulous/infinitude

Infinitude

镜像概述和主要用途

Infinitude是Carrier Infinity Touch及兼容恒温器的替代Web服务，旨在为用户提供直接的网络控制能力，替代依赖Carrier/Bryant服务器的方案。它允许通过Web界面控制温度设定点、时间表和经销商信息，并提供开放的RESTish API，同时支持可选的RS485总线监控以获取设备高分辨率数据。

核心功能和特性

• Web控制：直接通过Web界面管理温度设定点、运行时间表及经销商信息。
• 开放API：提供RESTish API接口，支持第三方系统集成与数据访问。
• RS485监控：可选监控Carrier/Bryant RS485(ABCD)总线，通过串口设备（如/dev/ttyUSB0）或网络串口桥（如192.168.1.42:23）读取恒温器、空气处理器等设备数据，支持实时寄存器状态追踪与变化字节高亮显示。
• 灵活配置：通过环境变量自定义运行参数，包括日志级别、请求间隔、运行模式等。
• 多架构支持：提供多架构Docker镜像，适配不同硬件平台。

使用场景和适用范围

适用于Carrier/Bryant/ICP ION恒温器用户，尤其适合以下场景：

• 需要本地网络直接控制恒温器，避免依赖厂商服务器。
• 希望通过API集成智能家居系统（如Home Assistant）。
• 需要监控 HVAC 系统详细运行数据（如通过RS485总线）。

兼容性说明：仅兼容特定恒温器固件版本，Carrier/Bryant/ICP ION恒温器最新工作固件版本为4.05，新版本可能不兼容，建议避免升级或降级至该版本（详见https://github.com/nebulous/infinitude/issues/148%EF%BC%89%E3%80%82

安装与使用方法

Docker安装（推荐）

预构建镜像可在https://hub.docker.com/r/nebulous/infinitude%E8%8E%B7%E5%8F%96%EF%BC%8C%E6%94%AF%E6%8C%81%E5%A4%9A%E6%9E%B6%E6%9E%84%E3%80%82

基本运行命令

bash
docker run --rm -v $PWD/state:/infinitude/state -p 3000:3000 nebulous/infinitude

带环境变量的自定义配置

bash
docker run --rm -v $PWD/state:/infinitude/state \
  -e APP_SECRET='自定义Cookie签名字符串' \
  -e PASS_REQS='1020' \  # 请求厂商服务器的最小间隔（秒），0表示永不请求
  -e MODE='production' \  # 运行模式：production（默认）或development（详细日志）
  -e SERIAL_TTY='/dev/ttyUSB0' \  # 可选RS485串口设备路径
  -e LOGLEVEL='info' \  # 日志级别（参考Mojo::Log标准）
  -p 3000:3000 \
  nebulous/infinitude

Docker Compose部署

使用项目内置https://github.com/nebulous/infinitude/blob/master/docker-compose.yaml%EF%BC%9A

bash
docker-compose up

配置参数说明

通过环境变量配置容器，支持以下参数：

恒温器配置步骤

1. 在恒温器的高级无线设置中，将代理服务器地址和端口指向Infinitude主机的IP和端口（默认3000）。
2. 启动Infinitude容器（注意：通信未加密，仅在可信网络中使用）。

注意事项

• RS485功能：默认构建中RS485通信为只读模式，不支持控制；通过CarBus库写入恒温器表0x40的控制功能目前处于实验阶段。
• 非触摸式恒温器：旧款非触摸式恒温器的RS485控制可参考https://github.com/acd/infinitive%E3%80%82

相关项目

• https://github.com/MizterB/homeassistant-infinitude-beyond
• https://github.com/acd/infinitive