nebulous/infinitude repository overview

⁠Infinitude

⁠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

⁠Serial monitoring / control

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. If Infinitude stops, the thermostat continues operating with a communication error.

⁠Home Assistant Integration via MQTT Discovery

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⁠. Infinitude also provides experimental RS485 serial monitoring and SAM emulation for direct bus control — see the serial configuration options below.

⁠⚠️ Safety Notice

This software communicates with and may control HVAC equipment. It is experimental and not a replacement for OEM hardware. Improper use could result in property damage, equipment damage, or hazardous conditions including frozen pipes, overheating, or loss of heating/cooling. Use is entirely at your own risk. See NOTICE⁠ for additional disclaimer.

Emulation features carry additional risk:

Zone Controller emulation should not be used in the critical HVAC control loop. It is provided for experimentation and testing.

⁠Installation

⁠⚠️ Firmware compatibility: Infinitude is not compatible with all thermostat firmware versions. See the Compatibility Matrix⁠ for known-working combinations — and add yours if it works for you. If your thermostat has auto-updated past a supported version, see issues/148⁠ for discussion.

⁠Docker - Recommended

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:

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

⁠Manual installation Requirements

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

⁠Software

• 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 with cpanm --installdeps .
  • IO::Termios and Net::MQTT::Simple are optional (for RS485 serial and MQTT respectively)

⁠Raspbian-specific

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⁠

⁠Hardware

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.⁠

⁠Usage / Thermostat configuration

• Set your proxy server/port in the advanced wireless settings on the thermostat to point to your infinitude host/port.
• Edit infinitude.json to 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

Infinitude exists because device owners like their Infinity systems and deserve local access to their own equipment and data. We hope manufacturers will continue to expand official local API options for these systems.

⁠See Also

• InfinitESP hardware-based SAM emulator⁠
• Infinitude Home Assistant Integration⁠
• Infinitive project for RS485 control of non-touch thermostats⁠
• Anantha modifies thermostat firmware to intercept AWS IoT control traffic⁠
• ha_carrier - cloud-based Carrier API option⁠