Intesis WMP (IntesisHome / IntesisBox)

Control ducted and ductless HVAC through an Intesis (HMS Networks) WMP adapter — the IntesisHome Wi-Fi controllers (e.g. INWMPUNI001I000) and IntesisBox WMP gateways that bridge Mitsubishi Electric, Daikin, Fujitsu, Panasonic, LG, Samsung, Toshiba, Hitachi and Gree indoor units to a control system. GEM talks to the adapter over the local ASCII WMP protocol (TCP 3310) — no cloud dependency and no login.

Each adapter fronts one indoor unit, exposed as a single GEM climate zone: on/off, mode, setpoint, fan speed and vane position, with live room-temperature and state feedback pushed by the adapter.

Prerequisites

• An Intesis WMP-capable adapter or gateway. Intesis makes several product lines; only the ones that speak WMP work here. The Universal Wi-Fi controllers (INWMP…) and the IntesisBox WMP gateways do; the older ASCII-protocol IntesisBox VRF gateways do not.
• The adapter commissioned onto the LAN. For Wi-Fi controllers, complete the initial IntesisHome app onboarding once so the unit is bound to the indoor unit and joined to Wi-Fi. After that the local WMP port is served regardless of cloud connectivity.
• TCP 3310 reachable from the GEM server. WMP has no authentication, so keep the adapter on a controls VLAN and restrict access at the network layer.

Setup steps

1. Give the adapter a static IP or DHCP reservation.
2. In /admin/devices, add a device with driver Intesis WMP. Enter the adapter IP; leave WMP Port at 3310.
3. If the site works in Fahrenheit, set Temperature Unit to F. The wire protocol is always Celsius — GEM converts on the way in and out.
4. Save and reload the device. On connect the driver reads ID / INFO / LIMITS:* and discovers which modes, fan speeds and vane positions this indoor unit actually supports.
5. In /admin/zones, create one climate zone whose Address is the WMP unit (AC) number — 1 for a single Wi-Fi adapter.

Attribute reference

Device attributes

Attribute	Required	Default	Purpose
ip	yes	—	LAN IP or hostname of the adapter.
port	no	3310	WMP TCP port.
temp_unit	no	C	C or F — the unit used for setpoint/room temp in GEM.
status_interval	no	60000	Backstop re-read interval (ms). CHN change notifications are the primary state channel; this only covers a missed one.

The driver also writes model, mac and firmware onto the device from the ID response.

Zone attributes (written by the driver)

Attribute	Meaning
state	on / off (from ONOFF).
system_mode	Canonical HVAC mode: off when powered off, else auto / heat / cool / dry / fan.
device_mode	Raw MODE datapoint independent of power state.
setpoint	Target temperature in the configured unit (SETPTEMP).
temperature	Room temperature in the configured unit (AMBTEMP, read-only).
fan_mode	Fan speed as a WMP value (auto or a numeric step).
swing	Up/down vane position (VANEUD).
vane_lr	Left/right vane position (VANELR) where supported.
system_modes / fan_modes / swing_modes	Discovered capability lists (JSON) from LIMITS:*.
min / max	Setpoint range in the configured unit, from LIMITS:SETPTEMP.
error_status / error_code	Fault reporting from ERRSTATUS / ERRCODE.

Zone address format

A plain integer — the WMP indoor-unit (AC) number.

• A single Wi-Fi adapter is always 1.
• A multi-unit IntesisBox WMP gateway addresses units 1..N; create one zone per unit.

Protocol notes

WMP is a line-oriented ASCII protocol:

• Client → adapter: ID, INFO, LIMITS:<fn>, GET,<ac>:<fn>, SET,<ac>:<fn>,<value>.
• Adapter → client: ID:…, INFO:…, LIMITS:<fn>,[…], CHN,<ac>:<fn>,<value>, ACK, ERR.

CHN is the state channel. The adapter emits an unsolicited CHN whenever a datapoint changes from any source — the mobile app, the wall remote, or this driver — so once connected GEM tracks changes in real time. GET,<ac>:* primes state on connect and runs on the status interval as a backstop.

Temperatures (SETPTEMP, AMBTEMP) are tenths of a degree Celsius on the wire; 210 is 21.0 °C. The sentinel 32768 means "no setpoint" (common in FAN/DRY mode on some units) and is ignored.

note

ONOFF and MODE are independent datapoints. Selecting a mode in GEM sends ONOFF,ON alongside the MODE change so a mode selection also powers the zone on, matching the other GEM HVAC drivers. Turning the zone off leaves the last mode intact on the hardware.

Known limitations

• Function support is unit-dependent. Only the datapoints the adapter returns in LIMITS:* are controllable. A fan or vane command for a function the indoor unit does not implement is a no-op on the hardware.
• Fan speeds are raw WMP values (auto plus numeric steps such as 1–4), not named low/medium/high. The number of steps varies by indoor unit, so a forced name mapping would be wrong on many of them; the discovered list is published to fan_modes on the zone.
• Single setpoint. WMP exposes one SETPTEMP, not separate heat/cool setpoints, so auto-changeover dual setpoints are not represented.
• Humidity, filter-sign reset, and holiday/scheduling datapoints are not mapped in this driver.

Troubleshooting

Symptom	Check
Connection refused on 3310	Confirm the adapter IP and that it has finished joining Wi-Fi (the IntesisHome app shows it online). WMP is served only on the LAN interface; a cloud outage does not disable it.
Connects but no state ever appears	Verify the zone address matches the WMP AC number (1 for a single unit). A wrong AC number is silently ignored by the adapter. Live state also appears on the next physical change even if the initial bulk read is refused.
Setpoint rejected (ERR)	The value is outside LIMITS:SETPTEMP for this unit, or the unit is in a mode with no setpoint (FAN). Check min/max on the zone.
Fan or vane command does nothing	That function is not in LIMITS:* for this indoor unit and cannot be controlled.
State lags reality	The adapter pushes CHN on change; if it went quiet, the status_interval backstop re-reads every datapoint. Lower it if needed.

What we don't yet support

• Multi-setpoint / dual-setpoint auto changeover (WMP models a single SETPTEMP).
• Humidity control and filter-reset datapoints.
• UDP auto-discovery — devices are added by fixed IP.