homebridge-infinitude-plus
v1.0.2
Published
Infinitude Plugin for Homebridge — Modern TypeScript rewrite with Homebridge 2.0 support, Eve history, and custom UI
Maintainers
Readme
homebridge-infinitude
Infinitude Plugin for Homebridge. Enable Carrier/Bryant Infinity Touch Thermostats in HomeKit.
What is Infinitude? Infinitude is an alternative web service for Carrier Infinity Touch and other compatible thermostats. It allows read and control of your Infinity system locally over your network (no serial connection needed).
Behavior
This plugin will create thermostat accessories for each enabled zone in infinitude.
- In
OFFmode, it will set infinitude activity for that zone tooff, unlessshutOffAwayis true. - In
HEATorCOOLmode, it will set infinitude activity to the set temperature in the relevant mode. - In
AUTOmode, it will set infinitude activity for that zone toAutoto automatically adjust between heating and cooling points. This implementation currently is not working fully. - If you have a thermostat schedule, the temperature change will be made temporarily within the current profile using the plugin's
holdUntilvalue.
Other settings:
- If
holdUntilis specified, it will setotmrto the specified hour.
HomeKit Features:
- Thermostat Control: Set Target Temperature for Heat & Cooling. Infinitude values
htspandclsprespectively. - Current Temperature: Dislays current temperature reported by the zone thermostat. Infinitude values
rt - Hardware Display Unit: control temperature unit (Celcius/Fahrenheit) of physical Theromstat.
- Filter Life Level: Displays life of Filter,
100being brand new and0needing replacement. Infinitude valuefiltrlvl - Current Relative Humidity: Displays indoor humidity reported by Thermostat. Infinitude value
rh - Mode Switches: Change Infinity Thermostat modes with HomeKit switches (Optional) (Not Ready Yet)
- Fan: Currently provides data on whether the fan is On or Off. Control is Read/Write - HOWEVER, Infinitude does not provide a way to determine if a Fan is running under Auto or Manual. Suggested use with caution and temporary overrides only, allowing Infinity to properly control the fan.
- Outdoor Temperature Sensor: Adds Temperature Sensor to use Infinity Outdoor temperature for home automation. Uses
OATvalue. - Temperature Data History: Uses the fakegato library to store data history in HomeKit. Visible only in Eve For HomeKit app.
Install (Not Ready Yet)
Use Homebridge-UI-X and Search for homebridge-infinitude-plus
OR
run sudo npm i -g homebridge-infinitude-plus
Custom Homebridge UI
- Configuration - Easy configuration for your Infinitude controls
- Visibility - Displays the status or your Infinitude Instance and allows you to open or preview your Infinitude dashboard.
Homebridge Configuration
{
"platform": "InfinitudePlatform",
"thermostats": [
{
"name": "Home",
"advancedDetails": {
"manufacturer": "Default-Manufacturer",
"model": "Default-Model",
"serial": "Default-SerialNumber"
},
"url": "http://<infinitude host>:<infinitude port>",
"shutOffAway": false,
"holdUntilNextActivity": false,
"useFan": false,
"useOutdoorTemperatureSensor": true
},
{
"name": "Office",
"advancedDetails": {
"manufacturer": "Default-Manufacturer",
"model": "Default-Model",
"serial": "Default-SerialNumber"
},
"url": "http://<infinitude host>:<infinitude port>",
"shutOffAway": false,
"holdUntilNextActivity": false,
"useFan": false,
"useOutdoorTemperatureSensor": false
}
]
}If running Infinitude & Homebridge on same devive, e.g., Raspberry Pi, use LocalHost 127.0.0.1 for url.
Running Infinitude
Running Infinitude on Homebridge Raspbian Image
Local Control
If you want to keep your IOT devices completely local, you can accomplish this with Infinitude. The carrier web services seem harmless, but local control is often a desirable preference for speed, reliability, and future-proofing against cloud services being sunset. To support local-only control, you will need to use your firewall to block access from your Infinitude Client to the following hostnames:
- legacy.api.iot.carrier.com
- www.api.ing.carrier.com
Local communication between your Thermostat-Infinitude-HomeKit will function, but the Carrier and other official apps will no longer work.
Useful HomeKit Automations / Scenes Ideas:
You can use HomeKit to completely control your thermostat's schedule.
Scenes - Use scenes to create desired temperature profiles for both Heat & Cool, e.g.,:
- Climate Home - desired settings for during the day when I am home.
- Climate Away - desired settings for while the house is empty.
- Climate Sleep - desired settings for while we sleep.
Automations - Use time and location based Automations to trigger my scenes. e.g.,:
- At 6:00 AM - Climate Home
- At 11:00 PM - Climate Sleep
- When Last Person Leaves - Climate Away
- When First Person Arrives - Climate Home
Shortcuts - Use personal automations in Shortcuts for advanced functions like Air Filter Reminders:
