HiSense Air Conditioners

This program implements the Ayla Networks LAN API to interact with HiSense WiFi Air Conditioner module, models AEH-W4B1 and AEH-W4E1, as well as Fujitsu FGLair.

As discussed here, the program doesn't seem to fit the AEH-W4A1 module, which relies on entirely different protocol (implemented by the apps Hi-Smart Life, AirConnect, Smart Cool, AC WIFI and טורנדו WiFi). Please let me know if you have a different experience, or tried it with other modules.

The module is installed in A/Cs and humidifiers that are either manufactured or only branded by many other companies. These include Beko, Westinghouse, Winia, Tornado, York and more.

This program is not affiliated with Ayla Networks, HiSense, Fujitsu, any of their subsidiaries, or any of their resellers.

Prerequisites

1. Air Conditioner with HiSense AEH-W4B1 or AEH-W4E1 installed.

2. Have Python 3.7 installed. If using Raspberry Pi, either upgrade to Raspbian Buster, or manually install it in Raspbian Stretch.

3. Download and install aircon module:

   python3.7 setup.py install

4. Configure the A/C with the dedicated app. Links to each app are available in the table below. Log into the app, associate the A/C and connect it to the network, as described in the app documentation.

5. Once everything has been configured, the A/C can be blocked from connecting to the internet, as it will no longer be needed. Set it a static IP address in the router, and write it down.

6. Run discovery command to fetch the LAN keys that will allow connecting to the A/C. Pass it your login credentials, as well as the code for your app from the list below:

   Code	App Name	App link
   beko-eu	Beko?
   haxxair	HAXXAIR WIFI REMOTE
   denali-us	Denali Aire
   fglair-eu	FGLair
   field-us	HiSmart Air
   hisense-eu	HiSmart Life
   hisense-us	HiSmart Home
   hismart-eu	Smart-Living
   hismart-us	AI-Home
   huihe-us	SunHome
   mid-eu	WiFi AC
   mid-us	Smiling Air
   oem-eu	Hi-Smart AC
   oem-us	Hisense?
   tornado-us	⁧טורנדו WIFI גרסה 2⁩
   winia-us	위니아 에어컨 홈스마트
   wwh-us	Westinghouse?
   york-us	YORK Smart

   For example:

   python3.7 -m aircon discovery tornado-us [email protected] my_pass

   The CLI will generate a config file, that needs to be passed to the A/C control server below. If you have more than one A/C that you would like to control, create a separate config file for each A/C, and run a separate control process. You can select the A/C that the config is generated for by setting the --device flag to the device name you configured in the app.

Run the A/C control server

1. Download and install aircon module:

   python3.7 setup.py install

2. Test out that you can run the server, e.g.:

   python3.7 -m aircon run --port 8888 --ip 10.0.0.40 --config config.json --mqtt_host localhost

   Parameters:
   • --port or -p - Port for the web server.
   • --ip - The IP address for the A/C.
   • --config - The config file with the credentials to connect to the A/C.
   • --device_type - Choose which configuration to use:
     • ac - Hisense based A/C (default)
     • humidifier - Hisense Humidifier
     • fgl - Fujitsu FGLair, models AP-WA?E, AP-WC?E, AP-WD?E, AP-WF?E
     • fgl_b - Fujitsu FGLair, models AP-WB?E
   • --mqtt_host - The MQTT broker hostname or IP address. Must be set to enable MQTT.
   • --mqtt_port - The MQTT broker port. Default is 1883.
   • --mqtt_client_id - The MQTT client ID. If not set, a random client ID will be generated.
   • --mqtt_user - <user:password> for the MQTT channel. If not set, no authentication is used.
   • --mqtt_topic - The MQTT root topic. Default is "hisense_ac". The server will listen on topics <{mqtt_topic}/{property_name}/command> and publish to <{mqtt_topic}/{property_name}/status>.
   • --log_level - The minimal log level to send to syslog. Default is WARNING.
3. Access e.g. using curl:

   curl -ik 'http://localhost:8888/hisense/status'
   curl -ik 'http://localhost:8888/hisense/command?property=t_power&value=ON'

Run as a service

Assuming your username is "pi"

1. Create a dedicated directory for the script files, and move the files to it. Pass the ownership to root. e.g.:

   sudo mkdir /usr/lib/hisense
   sudo mv config.json /usr/lib/hisense
   sudo chown pi:pi /usr/lib/hisense/*

2. Create a service configuration file (as root), e.g. /lib/systemd/system/hisense.service:

   [Unit]
   Description=Hisense A/C server
   After=network.target
   
   [Service]
   ExecStart=/usr/bin/python3.7 -m aircon run --port 8888 --ip 10.0.0.40 --config config.json --mqtt_host localhost
   WorkingDirectory=/usr/lib/hisense
   StandardOutput=inherit
   StandardError=inherit
   Restart=always
   User=pi
   
   [Install]
   WantedBy=multi-user.target

3. Link to it from /etc/systemd/system/:

   sudo ln -s /lib/systemd/system/hisense.service /etc/systemd/system/multi-user.target.wants/hisense.service

4. Enable and start the new service:

   sudo systemctl enable hisense.service
   sudo systemctl start hisense.service

5. If you use MQTT for HomeAssistant or openHAB, the broker should now provide the updated status of the A/C, and accepts commands.

Available Properties

Listed here are the properties available through the API:

Property	Read Only	Values	Comment
f_electricity	x	Integer
f_e_arkgrille	x	0, 1	Alarm from cabinet grille protection
f_e_incoiltemp	x	0, 1	Indoor coil temperature sensor in fault
f_e_incom	x	0, 1	Indoor and outdoor communication in fault
f_e_indisplay	x	0, 1	Communication faulty between indoor control panel and display panel
f_e_ineeprom	x	0, 1	Error in EEPROM of indoor control panel
f_e_inele	x	0, 1	Communication faulty between indoor control panel and indoor power panel
f_e_infanmotor	x	0, 1	Indoor fan motor operation abnormal
f_e_inhumidity	x	0, 1	Indoor humidity sensor in fault
f_e_inkeys	x	0, 1	Communication faulty between indoor control panel and keyboard plate
f_e_inlow	x	0, 1
f_e_intemp	x	0, 1	Indoor temperature sensor in fault
f_e_invzero	x	0, 1	Fault found from indoor voltage crossing zero detection
f_e_outcoiltemp	x	0, 1	The temperature sensor in outdoor coil faulty
f_e_outeeprom	x	0, 1	Outdoor EEPROM error
f_e_outgastemp	x	0, 1	Exhaust temperature sensor faulty
f_e_outmachine2	x	0, 1
f_e_outmachine	x	0, 1
f_e_outtemp	x	0, 1	Outdoor ambient temperature sensor faulty
f_e_outtemplow	x	0, 1
f_e_push	x	0, 1	Communication faulty between WiFi control panel and indoor control panel
f_filterclean	x	0, 1	Does the filter require cleaning
f_humidity	x	Integer	Relative humidity percent
f_power_display	x	0, 1
f_temp_in	x	Decimal	Environment temperature in Fahrenheit
f_voltage	x	Integer
t_backlight		ON, OFF	Turn the display on/off
t_device_info		0, 1
t_display_power		0, 1
t_eco		OFF, ON	Economy mode
t_fan_leftright		OFF, ON	Horizontal air flow
t_fan_mute		OFF, ON	Quite mode
t_fan_power		OFF, ON	Vertical air flow
t_fan_speed		AUTO, LOWER, LOW, MEDIUM, HIGH, HIGHER	Fan Speed
t_ftkt_start		Integer
t_power		OFF, ON	Power
t_run_mode		OFF, ON	Double frequency
t_setmulti_value		Integer
t_sleep		STOP, ONE, TWO, THREE, FOUR	Sleep mode
t_temp		Integer	Temperature in Fahrenheit
t_temptype		CELSIUS, FAHRENHEIT	Displayed temperature unit
t_temp_eight		OFF, ON	Eight heat mode
t_temp_heatcold		OFF, ON	Fast cool heat
t_work_mode		FAN, HEAT, COOL, DRY, AUTO	Work mode

Multiple Air Conditioners

In order to use with multiple Air Conditioners, simply add multiple --config and --type params. MQTT topic will contain your topic defined by flag --mqtt_topic (hisense_ac by default) and device name.

• Note: The smart home hub configuration should adjusted to refer to the right port or topics.

SmartThings and HomeAssistant support

I have built a groovy script to enable SmartThings integration with the Air Conditioner, through the control server above. It currently implements the main functionality (turn on/off, AC mode, fan speed, dimmer etc.).

The groovy file is available here, for download and installation through the Groovy IDE. As I'm continuously improving this script, it would be more efficient to use the IDE's github integration, in order to stay up-to-date.

I've also created a configuration for HomeAssistant, available here to communicate with the server through MQTT. Please let me know if you find issues while using it.

• Note: If you change the --mqtt_topic flag, you should adjust the topics in the HomeAssistant configuration accordingly.