Skip to content

Exosite ESH Protocol Definitions

The Exosite smart home (esh) protocol definitions define different device types and semantic for values types.

Name Example Description
class 0 0: HouseHold Devices (家庭電器)
device_id 'F' Describes the type of device. This will also enable/disable different command sets per device. 0: General (通用) 1: AC (冷氣機) 2: Fridge (冰箱) 3: Washing Machine (洗衣機) 4: Dehumidifier (除濕機) 5: TV (電視機) 6: Dryer (烘衣機) 7: Water Boiler (熱泵熱水器) 8: Air Purifier (空氣清淨機) 9: Rice Cooker (電子鍋) A: Water dispenser (開飲機) B: Electric Stove (電磁爐) C: Dish Dryer (烘碗機) D: Microwave (微波爐) E: Total heat exchanger (全熱交換器) F: Fan (電扇)
fields ["H00"] Fields are defined per device family. Each device_id family has a different set of definitions.
esh_version "4.00" The current version of the ESH protocol, the current version is "4.00"
brand "Company" The name of the device offering company.
model "AX4200" The name of this product model.

ESH Table with a designated device_id

A systematic table needs to be constructed for information exchange. You should have the exact conversion table in the firmware. The firmware and the app communicates through the definition of this table. Below shows an example of device id = F (fan). You can create one that meet your needs. If your device uses SAA, it is advised to follow the table defined in the SAANet protocol.

Field Name Value Range R/W Description
H00 0: Off 1: On R+W On/Off
H01 0: Mode 0 1: Mode 1 2: Mode 2 3: Mode 3 ... R+W Fan Mode
H02 0: Automatic Speed 1-24: Speed level R+W Fan Speed 1 - Low speed, 24 - Maximum speed
H03 Min: -128 Max: 127 R Indoor Temperature Celsius
H04 Min: 0 Max: 1440 R+W Sleep Timer (countdown) in minutes
H05 0: Off 1: On R+W Fan Rotation
H06 0: Off 1: On R+W Ion
H07 0: Off 1: On R+W Light
H08 Min: 0 Max: 99 R Indoor Humidity in %
H09 Min: 0 Max: 2359 R+W Timer on This specifies the time of the day on which the fan should enable itself. The time encoded as decimal. E.g. 0100 means 1am 1330 means 1:30pm and so on
H0A Min: 0 Max: 2359 R+W Timer off This specifies the time of the day on which the fan should disable itself. The time encoded as decimal.
H0B Min: 0 Max: 1440 R+W Countdown timer on Number of minutes before the fan enables itself
H0C Min: 0 Max: 1440 R+W Countdown timer off Number of minutes before the fan disables itself
H0D Min: 0 Max: 2359 R+W System time
H0E Min: 0 Max: 1440 R Current in 0.1 Amp units
H0F Min: 0 Max: 1440 R Voltage in V
H10 Min: 0 Max: 1440 R Power factor
H11 Min: 0 Max: 1440 R Power in W
H12 Min: 0 Max: 1440 R kwh in 0.1 kWh units

For questions and more information on the ExoHome™, visit our support site.

Have more questions? Submit a request

Back to top