Controller Initialization Interface

Controller Online Report

Command Direction Description
online Controller → Server After connecting to the server, the controller periodically sends an Online Message until it receives an air conditioner status query command. Default interval: 200 s.

Response Example

{
    "sn": 0,  
    "cmd": "online", 
    "uuid": "fa0000014000012402201180001015134",   
    "body": { 
            "t":1700789219,  
            "date":"2023-11-24 09:26:59", 
            } 
}
Response Fields
Name Description
t Unix timestamp
date Current time

Query Controller General Information

Commend Direction Description
general_read Server → Controller Query the basic information about the controller.

Request Example

{
    "sn": 2,
    "cmd": "general_read", 
    "uuid": "fa0000014000012402201180001015134",
    "body": {
    }
}

Response Example

{
    "sn": 2,
    "cmd": "general_read",
    "uuid": "fa0000014000012402201180001015134",
    "body": {
        "rtc": {
            "date": "2023-11-24 09:26:59" 
        },
        "ver": "81.207.0.0.90",   
        "protocol_ver": "2.15",    
        "dbt": 2500,           
        "dbu": 56,             
        "auth": 1,             
        "concentrator_id": 1,  
        "watch": 0,           
        "watcht": 1000        
    }
}
Response Filed
Name Description
date Controller time
ver Controller firmware version
protocol_ver JSON protocol version
dbt Total database capacity
dbu Percentage of database capacity used
auth Authorization status: 0 = Unauthorized, 1 = Authorized
concentrator_id Controller index, used as the first segment of the four-part air conditioner address
watch Long-running operation monitoring: 0 = Disabled, 1 = Enabled. Disabled by Default: disable.
watcht Power off the air conditioner when the continuous operating time exceeds the specified time. Unit: min.

Configure Controller General Information

Command Direction Description
general_write Server → Controller Configure basic controller information on the server

Request Example

{
    "sn": 3,
    "cmd": "general_write",
    "uuid": "fa0000014000012402201180001015134",
    "body": {
        "concentrator_id": 1,  
        "rtc": {                
            "date": "2023-11-24 09:26:59" 
             },
        "restart": 500, 
        "watch": 0, 
        "watcht": 1000 
    }
}
Response Example
{
    "sn": 3,
    "cmd": "general_write",
    "uuid": "fa0000014000012402201180001015134",
    "body": {
        "errorCode": 0 
    }
}
Parameters
Name Description
concentrator_id Controller index, used as the first segment of the four-part air conditioner address
rtc.date Time synchronization via severs.
restart Restarts the controller after the specified delay. Unit: ms.
watch Long-running operation monitoring: 0 = Disabled, 1 = Enabled. Disabled by Default: disable.
watcht Power off the air conditioner when the continuous operating time exceeds the specified time. Unit: min.
Response Fields
Name Description
errorCode 0: Command received successfully. For other values, see ErrorCode.

Query AC Channel Information

Command Direction Description
node_online Server → Controller Qurry the current air condition channel information.
Request Example
{
    "sn": 4,
    "cmd": "node_online",
    "uuid": "fa0000014000012402201180001015134",
    "body": {
    }
}
Response Example
{ 
    "sn": 4, 
    "cmd": "node_online", 
    "uuid": "fa0000014000012402201180001015134", 
    "body": { 
        "nodes": [ 
            { 
                "i": "1", 
                "v": "18.127.222.0.09", 
                "t": "2023-11-24 09:26:59", 
                "r": "98", 
                "s": "0", 
                "b": "1" 
                "sys_num": 10, 
                "ou_num" : 14, 
                "iu_num" : 160 
            }, 
            { 
                "i": "3", 
                "v": "18.127.222.0.09", 
                "t": "2023-11-24 09:26:59", 
                "r": "98", 
                "s": "4", 
                "b": "1" 
                "sys_num": 10, 
                "ou_num" : 14, 
                "iu_num" : 160 
            }, 
            { 
                "i": "9", 
                "v": "18.127.222.0.09", 
                "t": "2023-11-24 09:26:59", 
                "r": "98", 
                "s": "4", 
                "b": "1" 
                "sys_num": 10,
                "ou_num" : 14,
                "iu_num" : 160
            } 
        ] 
    } 
}
Response Fields
Field Description
nodes[].i AC channel ID
nodes[].v Channel Firmware version
nodes[].t Current channel time
nodes[].r Running time since the current power-on
nodes[].s Channel status.
  • 0 = Normal / Search completed
  • 2 = Upgrading
  • 16 = Searching
  • 255 = Initializing
nodes[].b AC brand code
nodes[].sys_num Number of refrigeration systems
nodes[].ou_num Number of outdoor units
nodes[].iu_num Number of indoor units

Query AC Device Information

Command Direction Description
property_read Server → Controller The server retrieves the address information of all discovered air conditioners or a specified air conditioner.
Request Example
{
    "sn": 5, 
    "cmd": "property_read",
    "uuid": "fa0000014000012402201180001015134", 
    "body": {
        "inUnitMessages": {
            "addrs": [] 
        }
    }
}
Response Example
{
    "sn": 5, 
    "cmd": "property_read",
    "uuid": "fa0000014000012402201180001015134",
    "body": {
        "inUnitMessages": [  
            {
                "addr": "1-1-1-1", 
                "power": 35, 
                "brand": 1, 
                "type": "v" 
            },
            {
                "addr": "1-1-1-2",
                "power": 68,
                "brand": 1,
                "type": "v"
            }
        ], 
    }
}
Parameter
Field Description
addrs Leave this field empty to query all outdoor units. To query a specific outdoor unit, enter its address information.
Response Fields
Field Description
inUnitMessages[] List of air conditioning units
addr Four-part air conditioner address
power Indoor unit capacity, unit: 100 W
brand Air conditioner brand
type v: Refrigerant system