Status Management

Query the Indoor Unit Status


Command	Direction	Description
status_read	Server → Controller	Query the real-time status of all air conditioners or the air conditioner at the specified address.

Request Example

{
    "sn": 6,
    "cmd": "status_read",
    "uuid": "fa0000014000012402201180001015134",
    "body": {
        "cmd": "addrs", 
        "addrs": ["1-1-1-1"]         
        }
}

Response Example

{ 
    "sn": 6, 
    "cmd": "status_read", 
    "uuid": "fa0000014000012402201180001015134",
    "body": { 
        "cmd":"addrs", 
        "inUnitMessages": [  
             { 
                "a": "1-1-1-1", 
                "o": 1,   
                "ts": 24, 
                "w": 1, 
                "fs": 1,                        
                "fd": 2, 
                "acs": "6608",  
                "rt": 22  
            }
         ]
     }
}

Parameters


Name	Description
cmd	Read the air conditioner status at a minimum interval of 5 s. all: all air conditioners. addrs: specified addresses.
addrs	Specified air condition addresses

Response Fields


Name	Description
cmd	Same as the requested value: all or addrs.
a	Air conditioner address.
o	Power status 0 = Off 1 = On
ts	Set temperature, range: 16–31°C.
w	Working mode 0 = Auto 1 = Cool 2 = Heat 3 = Dehumidification 4 = Ventilation
fs	Fan speed 0 = Auto 1 = High 2 = Medium 3 = Medium-high 4 = Low 5 = Medium-low 6 = Breeze 7 = Powerful
fd	Airflow direction. Reserved field.
acs	Alarm code. LOST indicates that the air conditioner is offline; other codes are fault codes reported by the air conditioner.
rt	Room temperature.

Control the Indoor Unit


Commend	Direction	Description
control_write	Server → Controller	Set the operating status of the air conditioner.

Request Example

{ 
    "sn": 7, 
    "cmd": "control_write", 
    "uuid": "fa0000014000012402201180001015134", 
    "body": {        
        "addrs": [     
            "1-1-1-1", 
            "1-2-1-2" 
        ], 
        "onOff": 1,      
        "tempSet": 24,   
        "workMode": 1, 
        "fanSpeed": 1, 
        "fanDirect": 1 
    }
}

Response Example

{
    "sn": 7,
    "cmd": "control_write",
    "uuid": "fa0000014000012402201180001015134",
    "body": {
        "errorCode": 0 
    }
}

Parameters


Name	Description
addrs	Air conditioner address.
onOff	Power status 0 = Off 1 = On
tempSet	Set temperature, range: 16–31°C.
workMode	Working mode 0 = Auto 1 = Cool 2 = Heat 3 = Ventilation 4 = Dehumidification
fanSpeed	Fan speed 0 = Auto 1 = High 2 = Medium 3 = Medium-high 4 = Low 5 = Medium-low 6 = Breeze 7 = Powerful
fanDirect	Airflow direction. Reserved.

Response Filed


Name	Description
errorCode	0: Command received successfully. For other values, see ErrorCode

Status Automatic Periodic Reporting


Command	Direction	Description
device_report_config	Server → Controller	Enable or disable periodic air conditioner status reporting and configure the reporting interval
status_report	Controller → Server	Periodically reports the status of specified air conditioners based on the configured start time and reporting interval.

Request Example

{ 
    "sn": 10, 
    "cmd": "device_report_config", 
    "uuid": "fa0000014000012402201180001015134", 
    "body": {     
        "act": 1,  
        "interval": 1800 
    } 
}

Response Example

{
    "sn": 10,
    "cmd": "device_report_config",
    "uuid": "fa0000014000012402201180001015134",
    "body": {
        "errorCode": 0 
    }
}

{ 
    "sn": 0, 
    "cmd": "status_report", 
    "uuid": "fa0000014000012402201180001015134", 
    "body": { 
            "cmd":"addrs",  
            "inUnitMessages": [  
            { 
                "a": "1-1-1-1",    
                "o": 1,   
                "ts": 24, 
                "w": 1, 
                "fs": 1,  
                "fd": 2, 
                "acs": "6608", 
                "rt": 22 
            } 
        ] 
    } 
}

Parameters


Name	Description
act	Periodic reporting 0 = Disabled 1 = Enabled
interval	Reporting interval, Unit: s. Defaults: 1800s.

Response Fields


Name	Description
errorCode	0: Command received successfully. For other values, see ErrorCode

Query Periodic Reporting Configuration


Command	Direction	Description
device_report_config_read	Server → Controller	Query the periodic reporting configuration.

Request Example

{ 
    "sn": 11, 
    "cmd": "device_report_config_read", 
    "uuid": "fa0000014000012402201180001015134", 
    "body": {
    } 
}

Response Example

{
    "sn": 11,
    "cmd": "device_report_config_read",
    "uuid": "fa0000014000012402201180001015134",
    "body": {
            "act": 0,        
            "interval": 300, 
            "errorCode":0   
    }
}

Response Fields


Field	Description
act	0 = Disabled, 1 = Enabled
interval	Reporting interval, Unit: s.
errorCode	0: Command received successfully. For other values, see ErrorCode

Status Change Automatic reporting


Command	Direction	Description
device_update_config	Server → Controller	Enable or disable automatic reporting of air conditioner status changes.
status_report	Controller → Server	When any air conditioner status item changes, the controller reports the updated information.

Request Example

{ 
    "sn": 12, 
    "cmd": "device_update_config", 
    "uuid": "fa0000014000012402201180001015134",
    "body": {      
        "auto": 1,   
    } 
}

Response Example

{
    "sn": 12,
    "cmd": "device_update_config",
    "uuid": "fa0000014000012402201180001015134",
    "body": {
        "errorCode": 0 
    }
}

{ 
    "sn": 0, 
    "cmd": "status_report", 
    "uuid": "fa0000014000012402201180001015134", 
    "body": { 
        "cmd":"addrs", 
        "inUnitMessages": [ 
            {
                "a": "1-1-1-1",    
                "o": 1,  
                "ts": 24, 
                "w": 1, 
                "fs": 1,       
                "fd": 2, 
                "acs": "6608",  
                "rt": 22 
            }
        ] 
    } 
}

Parameters


Name	Description
auto	0 = Disabled, 1 = Enabled (default)

Response Fields


Field	Description
errorCode	0: Command received successfully. For other values, see ErrorCode.

Query Status Change Reporting Configuration


Command	Direction	Description
device_update_config_read	Server → Controller	Check whether automatic reporting of air conditioner status changes is enabled.

Request Example

{ 
    "sn": 13, 
    "cmd": "device_update_config_read", 
    "uuid": "fa0000014000012402201180001015134",
    "body": {
    } 
}

Response Example

{
    "sn": 13,
    "cmd": "device_update_config_read",
    "uuid": "fa0000014000012402201180001015134",
    "body": {
            "auto": 1,       
            "errorCode":0    
            }
}

Response Fields


Field	Description
auto	0 = Disabled, 1 = Enabled
errorCode	0: Command received successfully. For other values, see ErrorCode.