Control and monitor your Tripp Lite portable air conditioner from Home Assistant over Telnet.
Supported hardware: This integration works only with the Tripp Lite SRCOOLNET SNMP Webcard Interface Module (Remote Cooling Management for SRCOOL12K / SRXCOOL12K). It does not support direct telnet to SRCOOL units without this adapter, and it does not support the SRCOOLNETLX adapter.
- Set target temperature (63 °F – 86 °F)
- Fan speed: Low, Medium, High, Auto
- Shut down the unit from Home Assistant (see Limitations)
- Dehumidify Mode — toggles the AC unit’s dehumidifying operating mode (separate from normal cooling). Use when you want the unit to focus on moisture removal rather than standard rack/room cooling.
- Water Tank Full —
onwhen the condensate tank needs draining (useful for automations and notifications)
Status and identification values are exposed as individual sensors, including:
| Category | Examples |
|---|---|
| Runtime | Return air temperature, target temperature, operating mode, fan speed, auto fan, quiet mode, water status |
| Identification | Device name, vendor, product, serial number, location, region, asset tag, port name |
| Preferences | Units |
| Card diagnostics | OS, MAC address, driver/engine version, driver file status (hidden by default — see below) |
All entities attach to a single device in the Home Assistant device registry.
- Config flow only (no YAML)
- Reconfigure / reauth when Telnet credentials change
- Brand images under
custom_components/tripp_lite_srcool/brand/(Home Assistant 2026.3+)
| Entity | Type | Writable | Notes |
|---|---|---|---|
| Tripp Lite SRCOOL | climate |
Temp, fan, shutdown | COOL mode display only — cannot power on via telnet |
| Dehumidify Mode | switch |
Yes | Independent of climate setpoint/fan |
| Water Tank Full | binary_sensor |
No | Derived from water status text |
| Status sensors | sensor |
No | One entity per telnet field |
| Card diagnostics | sensor (diagnostic) |
No | Enable Show diagnostic entities on the device page |
The Dehumidify Mode switch controls a separate operating mode on the AC unit (telnet Devices → Preferences → Dehumidifying Status):
- Off — normal cooling behavior
- On — unit runs in dehumidify mode
This is not the same as the climate card, fan speed, or water tank status:
- It does not turn cooling on or off by itself
- It is not a humidifier (the unit removes moisture when enabled)
- Running dehumidify for long periods may fill the condensate tank sooner — watch Water Tank Full
A read-only Dehumidifying Status sensor also exists but is hidden as a diagnostic entity (redundant with the switch).
The SRCOOLNET Telnet interface has important constraints:
| Topic | Behavior |
|---|---|
| Power on | Not available via telnet. Controls menu item 1 is Reboot SNMP Card, not start. Selecting COOL on the climate entity is ignored; only OFF (shutdown) is sent to the device. Power the unit on from the front panel or PowerAlert web UI. |
| Polling | One async Telnet session per host, 60 s interval. A host-level lock prevents overlapping sessions during reconfigure validation. The adapter does not tolerate frequent or overlapping requests. |
| Dependencies | Requires telnetlib3 (PyPI; auto-installed by Home Assistant). Python 3.13 compatible from v0.6.0+. |
| Quiet mode | Read-only — no telnet control path |
| Diagnostics | Card firmware/details refresh on startup and every hour; cached between refreshes |
The device registry is populated from Telnet identification and diagnostics screens:
| Field | Source |
|---|---|
| Model | Product (e.g. SR(X)COOL12K) |
| Manufacturer | Vendor (Tripp Lite) |
| Firmware | PowerAlert driver version (card firmware) |
| Serial number | Unit serial from Identification screen |
| Configuration URL | http://<host> from integration settings |
The Date Installed sensor reflects when the card driver was installed — it is not the firmware version.
These sensors are categorized as diagnostic and hidden by default:
- Card: OS, agent type, MAC address, card serial, driver/engine version, driver file status
- Dehumidifying Status (raw text; use the Dehumidify Mode switch instead)
To show them: open the device page → Device info → enable Show diagnostic entities.
- Home Assistant Core 2024.9 or later (brand images require 2026.3+)
- HACS (recommended) or manual install
- Tripp Lite SRCOOLNET with Telnet enabled
- Network reachability from Home Assistant to the adapter
- Open HACS → Integrations → ⋮ → Custom repositories.
- Add repository URL
https://github.com/Shaffer-Softworks/Tripp-lightand category Integration. - Search for Tripp Lite SRCOOL, download, and restart Home Assistant.
- Go to Settings → Devices & services → Add integration → Tripp Lite SRCOOL.
mkdir -p config/custom_components
git clone https://github.com/Shaffer-Softworks/Tripp-light.git /tmp/tripp-light
cp -R /tmp/tripp-light/custom_components/tripp_lite_srcool config/custom_components/Restart Home Assistant, then add the integration from Settings → Devices & services.
| Field | Description |
|---|---|
| Host | IP address or hostname of the SRCOOLNET adapter |
| Port | Telnet port (default 23) |
| Username | Telnet username (often localadmin) |
| Password | Telnet password |
Use Reconfigure on the integration entry if credentials change. Reconfigure with unchanged credentials validates the existing session without opening a second connection. When credentials change, the live session disconnects briefly for validation, then the integration reloads. After upgrading to 0.6.0+, reload the integration once so Home Assistant installs telnetlib3.
Set on GitHub so HACS validation passes:
- Description: e.g. “Home Assistant custom integration for Tripp Lite SRCOOLNET Remote Cooling Management over Telnet.”
- Topics:
home-assistant,homeassistant,hacs,hacs-integration
Use the bundled compose stack to test the integration without touching production Home Assistant:
cd docker
docker compose up -dOpen http://localhost:8125, complete onboarding, then add Tripp Lite SRCOOL. The integration source is bind-mounted from this repo.
See docker/README.md for logs, reload, reset, and verification scripts.
pip install pytest pytest-asyncio pytest-homeassistant-custom-component telnetlib3
pytest tests/