homebridge-lennox-icomfort-cloud
v1.2.0
Published
Homebridge plugin for Lennox iComfort thermostats - supports S30, S40, E30, M30 and older Wifi models via cloud API.
Downloads
101
Maintainers
Readme
Homebridge Lennox iComfort
A Homebridge plugin for Lennox iComfort smart thermostats. Supports S30/S40/E30/M30 systems and older iComfort Wifi models.
Supported Devices
Lennox iComfort S30/S40/E30/M30
- Uses lennoxicomfort.com for connectivity
- Multi-zone support
- Emergency heat control for dual-fuel systems
Lennox iComfort Wifi (Older Models)
- Uses myicomfort.com for connectivity
- Multi-zone support
Features
| Feature | S30/S40/E30/M30 | Wifi | |---------|-----------------|------| | Current Temperature | ✅ | ✅ | | Current Humidity | ✅ | ✅ | | HVAC Mode Control (Off/Heat/Cool/Auto) | ✅ | ✅ | | Temperature Setpoints | ✅ | ✅ | | Auto Mode Thresholds | ✅ | ✅ | | Multi-Zone Support | ✅ | ✅ | | Emergency Heat Switch | ✅ | ❌ |
Installation
Via Homebridge UI (Recommended)
- Search for
homebridge-lennox-icomfort-cloudin the Homebridge UI plugin search - Click Install
- Select your device type (S30/S40/E30/M30 or Wifi)
- Configure with your iComfort account credentials
Via Command Line
npm install -g homebridge-lennox-icomfort-cloudConfiguration
Add the platform to your Homebridge config.json:
For S30/S40/E30/M30 (default)
{
"platforms": [
{
"platform": "LennoxIComfortCloud",
"name": "Lennox iComfort",
"deviceType": "s30",
"username": "[email protected]",
"password": "your-password"
}
]
}For iComfort Wifi
{
"platforms": [
{
"platform": "LennoxIComfortCloud",
"name": "Lennox iComfort",
"deviceType": "wifi",
"username": "[email protected]",
"password": "your-password"
}
]
}Configuration Options
| Option | Required | Default | Description |
|--------|----------|---------|-------------|
| deviceType | No | "s30" | Device type: "s30" or "wifi" |
| username | Yes | - | Your iComfort account email address |
| password | Yes | - | Your iComfort account password |
| name | No | "Lennox iComfort" | Platform name shown in logs |
| pollInterval | No | 10 | How often to poll for updates (seconds) |
| temperatureUnit | No | "auto" | Temperature display: "auto", "C", or "F" |
| enableEmergencyHeat | No | false | (S30/S40/E30/M30 only) Enable emergency heat switch for dual-fuel systems |
Running as a Child Bridge
It is recommended to run this plugin as a child bridge for better stability and isolation.
Credits
This plugin is based on:
- homebridge-lennox-icomfort by akgoode - the original Homebridge plugin that served as the foundation for this project
- icomfort - the npm package for the Wifi API
- lennoxs30api by Pete Rager - the Python library for the modern Lennox cloud API
- Home Assistant Lennox S30 integration by Pete Rager - reference implementation for the S30/S40/E30/M30 API
License
Apache-2.0
Feedback & Issues
Please submit any issues or feature requests to the GitHub Issues page.
