Skip to content

Example MQTT commands

Nicholas Humfrey edited this page Jul 11, 2023 · 1 revision

This page gives some example commands for controlling your Faikin device using MQTT. The example use the mosquitto client tools - but other MQTT clients can easily be used.

See these two pages for more details of using MQTT:

Substitute faikin-1 for the hostname that you configured on the settings page.

Substitute mqtt.local for the hostname of your MQTT server.

Update the Faikin module settings

This command changes the following settings:

  • dark mode (LED off in normal operation - good for bedrooms).
  • It disables Home Assistant (less noise if you don't use HA)
  • It sets the maximum and minimum allowed temperatures
  • It disables S21 debug mode
mosquitto_pub \
  -h 'mqtt.local.' \
  -t 'setting/faikin-1' \
  -m '{"dark": true, "ha": false, "tmin": 18, "tmax": 24, "debug": false}'

Turn Air Conditioner unit on and off

Send the on command

mosquitto_pub -h 'mqtt.local.' -t 'command/faikin-1/on' -m ''

Send the off command

mosquitto_pub -h 'mqtt.local.' -t 'command/faikin-1/off' -m ''

Set the target / desired temperature

Send the temp command

mosquitto_pub -h 'mqtt.local.' -t 'command/faikin-1/temp' -m '21'

Restart

Send the restart command

mosquitto_pub -h 'mqtt.local.' -t 'command/faikin-1/restart' -m ''

Listening for messages

The following command might be useful for listening for messages coming from Faikin:

mosquitto_sub -h 'mqtt.aelius.co.uk' -t '+/faikin-bedroom2/#' -v

The key topics are:

  • state/faikin-bedroom2 - the status of "Operating System" that Faikin is built on
  • state/faikin-bedroom2/status - the status of the air conditioner
  • error/faikin-bedroom2/... - error messages