Home Assistant

The controller talks to Home Assistant over MQTT. With discovery on, the AC appears in Home Assistant by itself: no YAML and no custom integration.

What you need

Home Assistant 2024.11 or later
An MQTT broker. On Home Assistant OS, install the official Mosquitto broker add-on. With other installation types, run your own broker.
Home Assistant's MQTT integration, connected to that broker
Ideally, a separate MQTT username and password for the controller

Setup

Follow Local setup and choose "Local MQTT (Home Assistant)" under "Connection mode".
In "MQTT broker URI", enter the broker's address, for example mqtt://192.168.1.10:1883. If Mosquitto runs on Home Assistant, use Home Assistant's IP address.
Enter the MQTT username and password, and leave "Enable Home Assistant discovery" ticked.
Finish setup. Once the controller has restarted and connected to the broker, the AC appears under Settings → Devices & services → MQTT in Home Assistant.

A controller that's already set up can switch to local MQTT under "Settings" on its status page.

What appears

Entity	Type	What it does
The AC (named after the device)	climate	Modes off, cool, heat, dry, fan only, auto; fan auto, low, medium, high; vertical swing; setpoint 16–30 °C in 1-degree steps
Sleep	switch	Sleep mode
Turbo	switch	Turbo mode
Horizontal swing	switch	Left-right swing
Room temperature	sensor	Indoor temperature
Error	sensor (diagnostic)	The AC's error code, `none` when all is well

When the controller is offline, these entities show as unavailable.

If it doesn't appear

On the status page, check that "Connection" says "Connected". If it says "Disconnected", check the broker address, username and password.
Check that discovery under "Home Assistant" is "On" and that "Discovery prefix" is homeassistant, matching Home Assistant's MQTT integration (homeassistant is Home Assistant's default).
After a Home Assistant restart, the controller announces itself again automatically; there's nothing to redo.

Advanced: MQTT topics

A configured controller uses these topics, where xxxxxx is its 6-character code in lowercase:

Topic	Purpose
`nhiot/xxxxxx/state`	State JSON (retained)
`nhiot/xxxxxx/avail`	Online status
`nhiot/xxxxxx/cmd`	Commands
`nhiot/xxxxxx/cmd/res`	Command results

Example command (set 26 °C):

{"id":"1","method":"setTemp","params":{"value":26}}

Apple Home through Home Assistant

If you already use Home Assistant, its HomeKit Bridge integration can also add the AC to Apple Home. Alternatively, use the controller's built-in HomeKit; see Apple Home. Use one or the other, not both, or the AC shows up twice in the Home app.