Documentation and information on protocol(s) available on the Wiki. Please contribute!
Infinitude is an alternative web service for Carrier Infinity Touch and compatible thermostats.
Infinitude allows direct web-based control of
- Temperature setpoints (per zone)
- Schedules (7-day, 5-period per zone)
- System mode (heat/cool/auto/off)
- Fan speed per zone
- Hold modes and activity presets
- Vacation scheduling
As well as providing an open RESTish API
Infinitude can also optionally monitor the Carrier/Bryant RS485(ABCD) bus to obtain higher resolution access to values within your thermostat, air handler, heat pump, and other devices. Infinitude provides a serial monitor which keeps track of the current state of registers on the serial bus, and highlights changing bytes to aid in protocol analysis. Serial data can be monitored via an attached serial port or via a networked serial bridge.
With SAM emulation enabled (EMULATE_SAM=1), Infinitude can also write setpoints, mode, fan speed, and hold settings directly to the RS485 bus. SAM emulation is experimental and, like all of Infinitude, use at your own risk.
Infinitude can register itself directly as climate entities in Home Assistant using MQTT Discovery. No separate integration is needed — Infinitude publishes discovery payloads, state, and accepts commands all via MQTT. Requires an MQTT broker (e.g., Mosquitto).
Each enabled zone appears as a climate entity with:
- Current temperature and humidity
- Target temperature (heat/cool/auto modes, including range control)
- HVAC mode, fan mode, and preset modes (home, away, sleep, wake, hold)
- HVAC action (heating/cooling/idle via
zoneconditioning)
System-level sensors (outdoor temperature, filter levels, humidifier state) are also published.
RS485 stream monitoring example video:
Serial-based control of some older non-touch thermostats is provided by the Infinitive project
For Carrier/Bryant/ICP ION thermostats, it seems that the latest working firmware version is 4.05. Some users have held off upgrading to a newer version or have successfully downgraded to a previous version. See issues/148 for a discussion and more information about this issue.
Prebuilt Docker containers are available for multiple architectures on DockerHub, or you can build a container manually with the included Dockerfile. Special thanks go to @scyto for instrumental contributions to the Infinitude containers in general, and multiarch builds in particular.
Infinitude configuration parameters can be passed through environment variables into the container. Support is included for:
| Variable | Description |
|---|---|
| APP_SECRET | Cookie signature string. Matters to almost nobody |
| PASS_REQS | Minimum amount of time to wait(in seconds) between requests to Carrier/Bryant servers. 0 means never. |
| MODE | production(default) or development(more logging) |
| SERIAL_TTY | optional rs485 device string eg /dev/ttyUSB0 |
| SERIAL_SOCKET | optional tcp/rs485 bridge string eg 192.168.1.42:23 |
| LOGLEVEL | optional minimum severity of log messages to print |
| SCAN_THERMOSTAT | truthy values on systems with serial connectivity cause Infinitude to continuously scan each Thermostat table |
| EMULATE_SAM | Enable SAM emulation for RS485 bus writes (1 = enabled) |
| MQTT_BROKER | MQTT broker address (e.g., 192.168.1.3:1883). Enables Home Assistant MQTT Discovery. |
| MQTT_USER | Optional MQTT broker username |
| MQTT_PASS | Optional MQTT broker password |
| MQTT_PREFIX | HA discovery prefix (default: homeassistant) |
| MQTT_TOPIC | MQTT base topic (default: infinitude) |
the published container can be run as
docker run --rm -v $PWD/state:/infinitude/state -p 3000:3000 nebulous/infinitude
with additional config items as ENV vars
docker run --rm -v $PWD/state:/infinitude/state \
-e APP_SECRET='YOUR_SECRET_HERE' \
-e PASS_REQS='1020' \
-e MODE='production' \
-p 3000:3000 \
nebulous/infinitude
or via the included docker-compose file.
docker compose up
The easiest way to run Infinitude is by running a published Docker image, but if you'd like to install manually, these are the basic requirements
- Some flavor of UNIX. Both Linux and OSX are known to work and some have even used Strawberry Perl in Windows.
- Perl — dependencies are listed in the included
cpanfile. Install them withcpanm --installdeps .IO::TermiosandNet::MQTT::Simpleare optional (for RS485 serial and MQTT respectively)
Many users opt to run Infinitude on a Raspberry Pi. This is also most easily accomplished using a Docker image, but More specific manual installation instructions are available on the wiki
Basic hardware capable of running docker or a unix/posix system. This could be a desktop machine, many people use a Raspberry Pi, or any embedded device with sufficient memory and storage. The author runs Infinitude in a Docker container on an Atomic PI, but has also used a Pandaboard and first ran it on the very limited Pogoplug v4 hardware, which at the time(2014) cost less than $10 USD and sat on top of the air handler and allowed for a USB RS485 dongle to interface with it.
See a list of hardware others have used.
- Set your proxy server/port in the advanced wireless settings on the thermostat to point to your infinitude host/port.
- Edit
infinitude.jsonto configure optional settings (RS485 serial, MQTT, etc). - Start Infinitude. This traffic is not encrypted, so only run on a trusted network.
Infinitude is a Mojolicious application, so the simplest way to run it from source is via:
./infinitude daemon
which starts a server in development mode on port 3000.
Or to listen on port 80:
./infinitude daemon -l http://:80
See ./infinitude --help for additional options
With any luck, Carrier will allow the owners of these devices and data direct access rather than this ridiculous work around. If you have one of these thermostats, tell Carrier you'd like direct network access to your thermostat, or at the very least, access to a public API!