TA65-TBMQTT API reference¶
Overview¶
TA65-TBMQTT is an implementation of ThingsBoard MQTT protocol client (MQTT is a lightweight publish/subscribe messaging protocol).
Features¶
- MQTT protocol:
- Support MQTT over TCP
- NOT support MQTT over SSL with mbedtls, MQTT over Websocket, MQTT over Websocket Secure
- Easy to setup with URI
- Multiple instances (Multiple clients in one application)
- Support subscribing, publishing, authentication, last will messages, keep alive pings and all 3 QoS levels (it should be a fully functional client)
- Base on ThingsBoard MQTT API reference:
- Support telemetry upload API
- Support client-side & shared attributes, and attributes API:
- Request attribute values from the server
- Publish attribute update to the server
- Subscribe to attribute updates from the server
- Support PRC API:
- Server-side RPC: one-way and two-way
- Client-side RPC
- Not support Claiming API
MQTT Special¶
- Curently support
mqtt
schemes - Curently NOT support
mqtts
,ws
,wss
schemes - MQTT over TCP samples:
mqtt://mqtt.eclipse.org
: MQTT over TCP, default port 1883:mqtt://mqtt.eclipse.org:1884
: MQTT over TCP, port 1884:
Flow Chart¶
Tip
The range of values for message fields is referred to in the following sections, see Telemetry (Timeseries data), Shared attributes, Client-side attributes and Server-side RPC.
TELE.01 Timeseries Data Upload¶
- Chart:
- Message:
// Message Type: Telemetry upload (MQTT, PUBLISH) // Topic: v1/devices/me/telemetry // Payload: {"roomTemp":26.2,"changeOverTemp":26.3,"floorTemp":26.3, "wifiRssi":220,"iram":161868,"spiram":4194252}
See roomTemp, changeOverTemp (only for TA65-FC), floorTemp (only for TA65-FH), wifiRssi, iram and spiram.
See uploadFreq.
CTRL.01 Control Mode¶
- Chart:
- Message 1:
// Message Type: publish client-side attributes update to the server (MQTT, PUBLISH) // Topic: v1/devices/me/attributes // Payload: {"controlMode":"On"}
- Message 2:
// Message Type: receive server-side RPC request from the server (MQTT, PUBLISH) // Topic: v1/devices/me/rpc/request/$request_id // Payload: {"method":"remoteSetControlMode","params":"Off"}
See controlMode and remoteSetControlMode.
CTRL.02 Fan Mode & Fan Status¶
- Chart:
- Message 1:
// Message Type: publish client-side attributes update to the server (MQTT, PUBLISH) // Topic: v1/devices/me/attributes // Payload: {"fanMode":"Auto"}
- Message 2:
// Message Type: publish client-side attributes update to the server (MQTT, PUBLISH) // Topic: v1/devices/me/attributes // Payload: {"fanStatus":"Low"}
- Message 3:
// Message Type: receive server-side RPC request from the server (MQTT, PUBLISH) // Topic: v1/devices/me/rpc/request/$request_id // Payload: {"method":"remoteSetFanMode","params":"Med"}
See fanMode (only for TA65-FC), fanStatus (only for TA65-FC) and remoteSetFanMode (only for TA65-FC).
CTRL.03 Set Point & Override Status¶
- Chart:
- Message 1:
// Message Type: publish client-side attributes update to the server (MQTT, PUBLISH) // Topic: v1/devices/me/attributes // Payload: {"spValue":27.5}
- Message 2:
// Message Type: publish client-side attributes update to the server (MQTT, PUBLISH) // Topic: v1/devices/me/attributes // Payload: {"overrideStatus":false}
- Message 3:
// Message Type: receive server-side RPC request from the server (MQTT, PUBLISH) // Topic: v1/devices/me/rpc/request/$request_id // Payload: {"method":"remoteSetSpValue","params":34}
- Example 4:
// Message Type: receive server-side RPC request from the server (MQTT, PUBLISH) // Topic: v1/devices/me/rpc/request/$request_id // Payload: {"method":"remoteSetOverrideStatus","params":{}}
See spValue, overrideStatus, remoteSetSpValue and remoteSetOverrideStatus .
PRG.01 Program Mode & Program Status¶
- Chart:
- Message 1:
// Message Type: publish client-side attributes update to the server (MQTT, PUBLISH) // Topic: v1/devices/me/attributes // Payload: {"prgMode":"Every-day"}
- Message 2:
// Message Type: publish client-side attributes update to the server (MQTT, PUBLISH) // Topic: v1/devices/me/attributes // Payload: {"prgNextEnable":true}
- Message 3:
// Message Type: publish client-side attributes update to the server (MQTT, PUBLISH) // Topic: v1/devices/me/attributes // Payload: {"prgNextSetpoint":24.5}
- Message 4:
// Message Type: publish client-side attributes update to the server (MQTT, PUBLISH) // Topic: v1/devices/me/attributes // Payload: {"prgNextDaysTime":"Wed, 06:00 PM"}
- Message 5:
// Message Type: receive server-side RPC request from the server (MQTT, PUBLISH) // Topic: v1/devices/me/rpc/request/$request_id // Payload: {"method":"remoteSetPrgMode","params":"Sun_mon-fri_sat"}
See prgMode, prgNextEnable, prgNextSetpoint, prgNextDaysTime and remoteSetPrgMode.
PRG.02 Program Setpoint & Time¶
- Chart:
- Message 1:
// Message Type: publish client-side attributes update to the server (MQTT, PUBLISH) // Topic: v1/devices/me/attributes // Payload: {"prgSpTime00":"10:00"}
- Message 2:
// Message Type: publish client-side attributes update to the server (MQTT, PUBLISH) // Topic: v1/devices/me/attributes // Payload: {"prgSpValue00":27.5}
- Message 3:
// Message Type: receive server-side RPC request from the server (MQTT, PUBLISH) // Topic: v1/devices/me/rpc/request/$request_id // Payload: {"method":"remoteSetPrgSpTime27","params":"23:00"}
- Message 4:
// Message Type: receive server-side RPC request from the server (MQTT, PUBLISH) // Topic: v1/devices/me/rpc/request/$request_id // Payload: {"method":"remoteSetPrgSpValue14","params":21.5}
See prgSpTimeXX, prgSpValueXX, remoteSetPrgSpTimeXX and remoteSetPrgSpValueXX.
SET.01 Upload Device Attributes when the device is started¶
- Chart:
- Message 1:
// Message Type: publish client-side attributes update to the server (MQTT, PUBLISH) // Topic: v1/devices/me/attributes // Payload: {"model":"TA65-FC-TB","mac":"24:0A:C4:2C:EB:C8", "wifiFWVersion":"1.5.4.0","mcuFWVersion":"1.4.4.1", "wifiRSSIMin":0,"wifiRssiMax":255,"wifiRssiStep":1, "uploadFreqMin":2,"uploadFreqMax":2592000,"uploadFreqStep":1, "syncTimeFreqMin":1800,"syncTimeFreqMax":2592000,"syncTimeFreqStep":1}
- Message 2:
// Message Type: publish client-side attributes update to the server (MQTT, PUBLISH) // Topic: v1/devices/me/attributes // Payload: {"currentTempUnit":"°C", "envirTempMin":0,"envirTempMax":50,"envirTempStep":0.1, "spValueMin":5,"spValueMax":40,"spValueStep":0.5, "internalOffsetMin":-5,"internalOffsetMax":5,"internalOffsetStep":0.5}
- Message 3:
// Message Type: publish client-side attributes update to the server (MQTT, PUBLISH) // Topic: v1/devices/me/attributes // Payload: {"floorTempLimitedMin":20,"floorTempLimitedMax":40,"floorTempLimitedStep":0.5, "switchingDiffHeatingMin":1,"switchingDiffHeatingMax":4,"switchingDiffHeatingStep":0.5, "switchingDiffCoolingMin":1,"switchingDiffCoolingMax":4,"switchingDiffCoolingStep":0.5, "changeOverTempHeatingMin":27,"changeOverTempHeatingMax":40,"changeOverTempHeatingStep":0.5, "changeOverTempCoolingMin":10,"changeOverTempCoolingMax":25,"changeOverTempCoolingStep":0.5}
See model, mac, wifiFWVersion, mcuFWVersion, wifiRSSIMin, wifiRssiMax, wifiRssiStep, uploadFreqMin, uploadFreqMax, uploadFreqStep, syncTimeFreqMin, syncTimeFreqMax and syncTimeFreqStep.
See currentTempUnit, envirTempMin, envirTempMax, envirTempStep, spValueMin, spValueMax, spValueStep, internalOffsetMin, internalOffsetMax and internalOffsetStep.
See floorTempLimitedMin (only for TA65-FH), floorTempLimitedMax (only for TA65-FH), floorTempLimitedStep (only for TA65-FH), switchingDiffHeatingMin, switchingDiffHeatingMax, switchingDiffHeatingStep, switchingDiffCoolingMin, switchingDiffCoolingMax, switchingDiffCoolingStep, changeOverTempHeatingMin (only for TA65-FC), changeOverTempHeatingMax (only for TA65-FC), changeOverTempHeatingStep (only for TA65-FC), changeOverTempCoolingMin (only for TA65-FC), changeOverTempCoolingMax (only for TA65-FC) and changeOverTempCoolingStep (only for TA65-FC).
SET.02 Settings¶
- Chart:
- Message 1a:
// Message Type: publish client-side attributes update to the server (MQTT, PUBLISH) // Topic: v1/devices/me/attributes // Payload: {"tempUnit":"°C"}
- Message 1b:
// Message Type: receive server-side RPC request from the server (MQTT, PUBLISH) // Topic: v1/devices/me/rpc/request/$request_id // Payload: {"method":"remoteSetTempUnit","params":"°F"}
- Message 2a:
// Message Type: publish client-side attributes update to the server (MQTT, PUBLISH) // Topic: v1/devices/me/attributes // Payload: {"timeFormat":"12hours"}
- Message 2b:
// Message Type: receive server-side RPC request from the server (MQTT, PUBLISH) // Topic: v1/devices/me/rpc/request/$request_id // Payload: {"method":"remoteSetTimeFormat","params":"24hours"}
- Message 3a:
// Message Type: publish client-side attributes update to the server (MQTT, PUBLISH) // Topic: v1/devices/me/attributes // Payload: {"method":"remoteSetInternalOffset","params":-3.5}
- Message 3b:
// Message Type: receive server-side RPC request from the server (MQTT, PUBLISH) // Topic: v1/devices/me/rpc/request/$request_id // Payload: {"internalOffset":-3.5}
- Message 4a:
// Message Type: publish client-side attributes update to the server (MQTT, PUBLISH) // Topic: v1/devices/me/attributes // Payload: {"switchingDiffHeating":3.5}
- Message 4b:
// Message Type: receive server-side RPC request from the server (MQTT, PUBLISH) // Topic: v1/devices/me/rpc/request/$request_id // Payload: {"method":"remoteSetSwitchingDiffHeating","params":3.5}
- Message 5a:
// Message Type: publish client-side attributes update to the server (MQTT, PUBLISH) // Topic: v1/devices/me/attributes // Payload: {"switchingDiffCooling":2.5}
- Message 5b:
// Message Type: receive server-side RPC request from the server (MQTT, PUBLISH) // Topic: v1/devices/me/rpc/request/$request_id // Payload: {"method":"remoteSetSwitchingDiffCooling","params":2.5}
- Message 6a:
// Message Type: publish client-side attributes update to the server (MQTT, PUBLISH) // Topic: v1/devices/me/attributes // Payload: {"systemMode":"Cool"}
- Message 6b:
// Message Type: receive server-side RPC request from the server (MQTT, PUBLISH) // Topic: v1/devices/me/rpc/request/$request_id // Payload: {"method":"remoteSetSystemMode","params":"Heat"}
- Message 7a:
// Message Type: publish client-side attributes update to the server (MQTT, PUBLISH) // Topic: v1/devices/me/attributes // Payload: {"sensorMode":"Internal"}
- Message 7b:
// Message Type: receive server-side RPC request from the server (MQTT, PUBLISH) // Topic: v1/devices/me/rpc/request/$request_id // Payload: {"method":"remoteSetSensorMode","params":"External"}
- Message 8a:
// Message Type: publish client-side attributes update to the server (MQTT, PUBLISH) // Topic: v1/devices/me/attributes // Payload: {"floorTempLimited":29.5}
- Message 8b:
// Message Type: receive server-side RPC request from the server (MQTT, PUBLISH) // Topic: v1/devices/me/rpc/request/$request_id // Payload: {"method":"remoteSetFloorTempLimited","params":29.5}
- Message 9a:
// Message Type: publish client-side attributes update to the server (MQTT, PUBLISH) // Topic: v1/devices/me/attributes // Payload: {"adaptiveControl":false}
- Message 9b:
// Message Type: receive server-side RPC request from the server (MQTT, PUBLISH) // Topic: v1/devices/me/rpc/request/$request_id // Payload: {"method":"remoteSetAdaptiveControl","params":true}
- Message 10a:
// Message Type: publish client-side attributes update to the server (MQTT, PUBLISH) // Topic: v1/devices/me/attributes // Payload: {"forceVent":true}
- Message 10b:
// Message Type: receive server-side RPC request from the server (MQTT, PUBLISH) // Topic: v1/devices/me/rpc/request/$request_id // Payload: {"method":"remoteSetForceVent","params":false}
- Message 11a:
// Message Type: publish client-side attributes update to the server (MQTT, PUBLISH) // Topic: v1/devices/me/attributes // Payload: {"changeOverMode":"Heat"}
- Message 11b:
// Message Type: receive server-side RPC request from the server (MQTT, PUBLISH) // Topic: v1/devices/me/rpc/request/$request_id // Payload: {"method":"remoteSetChangeOverMode","params":"Auto"}
- Message 12a:
// Message Type: publish client-side attributes update to the server (MQTT, PUBLISH) // Topic: v1/devices/me/attributes // Payload: {"changeOverTempHeating":27}
- Message 12b:
// Message Type: receive server-side RPC request from the server (MQTT, PUBLISH) // Topic: v1/devices/me/rpc/request/$request_id // Payload: {"method":"remoteSetChangeOverTempHeating","params":27}
- Message 13a:
// Message Type: publish client-side attributes update to the server (MQTT, PUBLISH) // Topic: v1/devices/me/attributes // Payload: {"changeOverTempCooling":11.5}
- Message 13b:
// Message Type: receive server-side RPC request from the server (MQTT, PUBLISH) // Topic: v1/devices/me/rpc/request/$request_id // Payload: {"method":"remoteSetChangeOverTempCooling","params":10}
See tempUnit and remoteSetTempUnit, timeFormat and remoteSetTimeFormat, internalOffset and remoteSetInternalOffset, switchingDiffHeating and remoteSetSwitchingDiffHeating, switchingDiffCooling and remoteSetSwitchingDiffCooling.
See systemMode and remoteSetSystemMode, sensorMode and remoteSetSensorMode, floorTempLimited and remoteSetFloorTempLimited, adaptiveControl and remoteSetAdaptiveControl.(only for TA65-FH)
See forceVent and remoteSetForceVent, changeOverMode and remoteSetChangeOverMode, changeOverTempHeating and remoteSetChangeOverTempHeating, changeOverTempCooling and remoteSetChangeOverTempCooling.(only for TA65-FC)
ADM.01 Request all remote parameters when the device is started¶
- Chart:
- Message 1:
// Message Type: request attribute values from the server (MQTT, PUBLISH) // Topic: v1/devices/me/attributes/request/$request_id // Payload: {"sharedKeys":"cloudHost,uploadFreq,syncTimeFreq,timezone,timeNTPServer"}
- Message 2:
// Message Type: receive response (MQTT, PUBLISH) // Topic: v1/devices/me/attributes/response/$request_id // Payload: {"shared":{"cloudHost":"mqtt://192.168.21.222", "uploadFreq":120,"syncTimeFreq":3600, "timezone":120,"timeNTPServer":"pool.ntp.org"}}
See cloudHost, uploadFreq, syncTimeFreq, timezone and timeNTPServer.
ADM.02 Network Parameters & Timer Parameters¶
- Chart:
- Message 1:
// Message Type: receive attribute update from the server (MQTT, PUBLISH) // Topic: v1/devices/me/attributes // Payload: {"cloudHost":"mqtt://192.168.21.222"}
- Message 2:
// Message Type: receive attribute update from the server (MQTT, PUBLISH) // Topic: v1/devices/me/attributes // Payload: {"uploadFreq":120}
- Message 3:
// Message Type: receive attribute update from the server (MQTT, PUBLISH) // Topic: v1/devices/me/attributes // Payload: {"syncTimeFreq":3600}
See cloudHost, uploadFreq and syncTimeFreq.
ADM.03 Remote Sync Time¶
- Chart:
- Message 1:
// Message Type: receive attribute update from the server (MQTT, PUBLISH) // Topic: v1/devices/me/attributes // Payload: {"timezone":480}
- Message 2:
// Message Type: receive attribute update from the server (MQTT, PUBLISH) // Topic: v1/devices/me/attributes // Payload: {"timeNTPServer":"pool.ntp.org"}
- Message 3:
// Message Type: receive server-side RPC request from the server (MQTT, PUBLISH) // Topic: v1/devices/me/rpc/request/$request_id // Payload: {"method":"remoteSyncTimeRequest","params":{}}
See timezone, timeNTPServer and remoteSyncTimeRequest.
ADM.04 FUOTA (firmware update over the air)¶
- Chart:
- Message 1a:
// Message Type: receive server-side RPC request from the server (MQTT, PUBLISH) // Topic: v1/devices/me/rpc/request/$request_id // Payload: {"method":"remoteWiFiFUOTA", "params":"http://192.168.1.106/TA65-FC_WiFi.ino.bin"}
- Message 1b:
// Message Type: send response (MQTT, PUBLISH) // Topic: v1/devices/me/rpc/response/$request_id // Payload: {"method":"remoteWiFiFUOTA","results":{"result":"success"}}
- Message 2a:
// Message Type: receive server-side RPC request from the server (MQTT, PUBLISH) // Topic: v1/devices/me/rpc/request/$request_id // Payload: {"method":"remoteMcuFUOTA", "params":"http://192.168.1.106/TA65-FC_MCU.bin"}
- Message 2b:
// Message Type: send response (MQTT, PUBLISH) // Topic: v1/devices/me/rpc/response/$request_id // Payload: {"method":"remoteMcuFUOTA","results":{"result":"success"}}
See remoteWiFiFUOTA and remoteMcuFUOTA.
ADM.05 Remote Get Memeory Usage¶
- Chart:
- Message 1a:
// Message Type: receive server-side RPC request from the server (MQTT, PUBLISH) // Topic: v1/devices/me/rpc/request/$request_id // Payload: {"method":"remoteGetMemoryUsage"}
- Message 1b:
// Message Type: send response (MQTT, PUBLISH) // Topic: v1/devices/me/rpc/response/$request_id // Payload: {"iram":162592,"spiram":4194252}
See remoteGetMemoryUsage.
ADM.06 Remote Reboot Device¶
- Chart:
- Message 1:
// Message Type: receive server-side RPC request from the server (MQTT, PUBLISH) // Topic: v1/devices/me/rpc/request/$request_id // Payload: {"method":"remoteRebootDevice","params":{}}
See remoteRebootDevice.
ADM.07 Remote Clear Wi-Fi Config¶
- Chart:
- Message 1:
// Message Type: receive server-side RPC request from the server (MQTT, PUBLISH) // Topic: v1/devices/me/rpc/request/$request_id // Payload: {"method":"remoteClearWiFiConfig","params":{}}
Telemetry (Timeseries data)¶
Tip
All of these telemetry (timeseries data) is uploaded every uploadFreq seconds.
roomTemp¶
changeOverTemp¶
floorTemp¶
wifiRssi¶
iram¶
spiram¶
Timeseries | Type | Unit | Min | Max | Step/Precision | Value | TA65 -FC |
TA65 -FH |
Memo |
---|---|---|---|---|---|---|---|---|---|
roomTemp | float | currentTempUnit | envirTempMin | envirTempMax | envirTempStep | ● | ● | Room temperature | |
changeOverTemp | float | currentTempUnit | envirTempMin | envirTempMax | envirTempStep | ● | Change Over Temperatue |
||
floorTemp | float | currentTempUnit | envirTempMin | envirTempMax | envirTempStep | ● | Floor Temperatue | ||
wifiRssi | int | currentTempUnit | wifiRssiMin | wifiRssiMax | wifiRssiStep | ● | ● | Received Signal Strength Indicator |
|
iram | int | byte | ● | ● | Memory Usage, Only for Debug |
||||
spiram | int | byte | ● | ● | Memory Usage, Only for Debug |
Client-side attributes¶
Client-side attribute (static/fixed)¶
model¶
mac¶
wifiFWVersion¶
mcuFWVersion¶
Client-side attribute (static/fixed) |
Type | Unit | Value | TA65 -FC |
TA65 -FH |
Memo |
---|---|---|---|---|---|---|
model | string | “TA65-FC-TB”, “TA65-FH-TB” |
● | ● | Product Model | |
mac | string | eg: “34:02:86:5F:23:A9” |
● | ● | Mac Address | |
wifiFWVersion | string | eg: “1.5.5” |
● | ● | WiFi Module F/W version |
|
mcuFWVersion | string | eg: “1.5.4” |
● | ● | Main MCU F/W version |
Client-side attribute (static/fixed, metadata)¶
wifiRssiMin¶
wifiRssiMax¶
wifiRssiStep¶
uploadFreqMin¶
uploadFreqMax¶
uploadFreqStep¶
syncTimeFreqMin¶
syncTimeFreqMax¶
syncTimeFreqStep¶
Client-side attribute (static/fixed, metadata) |
Type | Unit | Value | TA65 -FC |
TA65 -FH |
Memo |
---|---|---|---|---|---|---|
wifiRssiMin | int | 0 | ● | ● | the minimum value of wifiRssi |
|
wifiRssiMax | int | 255 | ● | ● | the maximum value of wifiRssi |
|
wifiRssiStep | int | 1 | ● | ● | the step value of wifiRssi |
|
uploadFreqMin | int | second | 2 | ● | ● | the minimum value of uploadFreq |
uploadFreqMax | int | second | 30*24*3600 | ● | ● | the maximum value of uploadFreq |
uploadFreqStep | int | second | 1 | ● | ● | the step value of uploadFreq |
syncTimeFreqMin | int | second | 30*60 | ● | ● | the minimum value of syncTimeFreq |
syncTimeFreqMax | int | second | 30*24*3600 | ● | ● | the maximum value of syncTimeFreq |
syncTimeFreqStep | int | second | 1 | ● | ● | the step value of syncTimeFreq |
Client-side attribute (semi-static)¶
currentTempUnit¶
tempResolution¶
envirTempMin¶
envirTempMax¶
envirTempStep¶
spValueMin¶
spValueMax¶
spValueStep¶
internalOffsetMin¶
internalOffsetMax¶
internalOffsetStep¶
floorTempLimitedMin¶
floorTempLimitedMax¶
floorTempLimitedStep¶
switchingDiffHeatingMin¶
switchingDiffHeatingMax¶
switchingDiffHeatingStep¶
switchingDiffCoolingMin¶
switchingDiffCoolingMax¶
switchingDiffCoolingStep¶
changeOverTempHeatingMin¶
changeOverTempHeatingMax¶
changeOverTempHeatingStep¶
changeOverTempCoolingMin¶
changeOverTempCoolingMax¶
changeOverTempCoolingStep¶
Client-side attribute (semi-static) |
Type | Unit | Value | TA65 -FC |
TA65 -FH |
Memo |
---|---|---|---|---|---|---|
currentTempUnit | string | “°C” / “°F” | ● | ● | Centigrade, Fahrenheit |
|
envirTempMin | float | currentTempUnit | 0.0 (°C) / 32 (°F) | ● | ● | the minimum value of roomTemp changeOverTemp, floorTemp |
envirTempMax | float | currentTempUnit | 50.0 (°C) / 120 (°F) | ● | ● | the maximum value of roomTemp changeOverTemp, floorTemp |
envirTempStep | float | currentTempUnit | 0.1 (°C) / 0.5 (°F) | ● | ● | the step value of roomTemp changeOverTemp, floorTemp |
spValueMin | float | currentTempUnit | 5.0 (°C) / 40 (°F) | ● | ● | the minimum value of spValue prgSpValueXX |
spValueMax | float | currentTempUnit | 40.0 (°C) / 104 (°F) | ● | ● | the maximum value of spValue prgSpValueXX |
spValueStep | float | currentTempUnit | 0.5 (°C) / 1.0 (°F) | ● | ● | the step value of spValue prgSpValueXX |
internalOffsetMin | float | currentTempUnit | -5.0 (°C) / -10 (°F) | ● | ● | the minimum value of internalOffset |
internalOffsetMax | float | currentTempUnit | 5.0 (°C) / 10 (°F) | ● | ● | the maximum value of internalOffset |
internalOffsetStep | float | currentTempUnit | 0.1 (°C) / 0.5 (°F) | ● | ● | the step value of internalOffset |
floorTempLimitedMin | float | currentTempUnit | 20.0 (°C) / 68 (°F) | ● | the minimum value of floorTempLimited |
|
floorTempLimitedMax | float | currentTempUnit | 5.0 (°C) / 10 (°F) | ● | the maximum value of floorTempLimited |
|
floorTempLimitedStep | float | currentTempUnit | 40.0 (°C) / 104 (°F) | ● | the step value of floorTempLimited |
|
switchingDiffHeatingMin | float | currentTempUnit | 0.5 (°C) / 1 (°F) | ● | ● | the minimum value of switchingDiffHeating |
switchingDiffHeatingMax | float | currentTempUnit | 4.0 (°C) / 8 (°F) | ● | ● | the maximum value of switchingDiffHeating |
switchingDiffHeatingStep | float | currentTempUnit | 0.5 (°C) / 1 (°F) | ● | ● | the step value of switchingDiffHeating |
switchingDiffCoolingMin | float | currentTempUnit | 0.5 (°C) / 1 (°F) | ● | ● | the minimum value of switchingDiffCooling |
switchingDiffCoolingMax | float | currentTempUnit | 4.0 (°C) / 8 (°F) | ● | ● | the maximum value of switchingDiffCooling |
switchingDiffCoolingStep | float | currentTempUnit | 0.5 (°C) / 1 (°F) | ● | ● | the step value of switchingDiffCooling |
changeOverTempHeatingMin | float | currentTempUnit | 27.0 (°C) / 80 (°F) | ● | the minimum value of changeOverTempHeating |
|
changeOverTempHeatingMax | float | currentTempUnit | 40.0 (°C) / 104 (°F) | ● | the maximum value of changeOverTempHeating |
|
changeOverTempHeatingStep | float | currentTempUnit | 0.5 (°C) / 1 (°F) | ● | the step value of changeOverTempHeating |
|
changeOverTempCoolingMin | float | currentTempUnit | 10.0 (°C) / 50 (°F) | ● | the minimum value of changeOverTempCooling |
|
changeOverTempCoolingMax | float | currentTempUnit | 25.0 (°C) / 77 (°F) | ● | the maximum value of changeOverTempCooling |
|
changeOverTempCoolingStep | float | currentTempUnit | 0.5 (°C) / 1 (°F) | ● | the step value of changeOverTempCooling |
Client-side attribute (application state)¶
fanStatus¶
overrideStatus¶
prgNextEnable¶
prgNextDaysTime¶
prgNextSetpoint¶
Client-side attribute (application state) |
Type | Unit | Value | TA65 -FC |
TA65 -FH |
Memo |
---|---|---|---|---|---|---|
fanStatus | string | “Off”, “Low”, “Med”, “High” |
● | |||
overrideStatus | bool | true, false |
● | ● | see spValue | |
prgNextEnable | bool | true, false |
● | ● | Next program enabled |
|
prgNextDaysTime | float | ● | ● | Next program weekday & time |
||
prgNextSetpoint | float | currentTempUnit | ● | ● | Next program set point |
Client-side attribute (change by server-side RPC, settings)¶
tempUnit¶
timeFormat¶
systemMode¶
sensorMode¶
internalOffset¶
floorTempLimited¶
switchingDiffHeating¶
switchingDiffCooling¶
adaptiveControl¶
forceVent¶
changeOverMode¶
changeOverTempHeating¶
changeOverTempCooling¶
Client-side attribute |
Type | Unit | Min | Max | Step/ Precision |
Value | TA65 -FC |
TA65 -FH |
Memo |
---|---|---|---|---|---|---|---|---|---|
tempUnit | string | “°C” / “°F” | ● | ● | Centigrade, Fahrenheit, see remoteSetTempUnit |
||||
timeFormat | string | “12hours”, “24hours” |
● | ● | see remoteSetTimeFormat | ||||
systemMode | string | “Heat”, “Cool” |
● | see remoteSetSystemMode | |||||
sensorMode | string | “Internal”, “External”, “Combined” |
● | see remoteSetSensorMode | |||||
internalOffset | float | currentTempUnit | internalOffsetMin | internalOffsetMax | internalOffsetStep | “Internal”, “External”, “Combined” |
● | ● | Internal Sensor Temperture Offset, see remoteSetInternalOffset |
floorTempLimited | float | currentTempUnit | floorTempLimitedMin | floorTempLimitedMax | floorTempLimitedStep | ● | floor temperature limited (combined mode), see remoteSetFloorTempLimited |
||
switchingDiffHeating | float | currentTempUnit | switchingDiffHeatingMin | switchingDiffHeatingMax | switchingDiffHeatingStep | ● | ● | Switching Differential Heating, see remoteSetSwitchingDiffHeating |
|
switchingDiffCooling | float | currentTempUnit | switchingDiffCoolingMin | switchingDiffCoolingMax | switchingDiffCoolingStep | ● | ● | Switching Differential Cooling, see remoteSetSwitchingDiffCooling |
|
adaptiveControl | bool | true, false |
● | see remoteSetAdaptiveControl | |||||
forceVent | bool | true, false |
● | Force Ventialation, see remoteSetForceVent |
|||||
changeOverMode | string | “Heat”, “Cool”, “Auto” |
● | see remoteSetChangeOverMode | |||||
changeOverTempHeating | float | currentTempUnit | changeOverTempHeatingMin | changeOverTempHeatingMax | changeOverTempHeatingStep | ● | Change Over Temp Heating, see remoteSetChangeOverTempHeating |
||
changeOverTempCooling | float | currentTempUnit | changeOverTempCoolingMin | changeOverTempCoolingMax | changeOverTempCoolingStep | ● | Change Over Temp Cooling, see remoteSetChangeOverTempCooling |
Client-side attribute (change by server-side RPC, control & program)¶
controlMode¶
fanMode¶
spValue¶
prgMode¶
prgSpTimeXX¶
0 <= XX <= 27, prgSpTime00 ~ prgSpTime27
prgSpValueXX¶
0 <= XX <= 27, prgSpValue00 ~ prgSpValue27
Client-side attribute |
Type | Unit | Min | Max | Step/ Precision |
Value | TA65 -FC |
TA65 -FH |
Memo |
---|---|---|---|---|---|---|---|---|---|
controlMode | string | “Off”, “On” |
● | ● | see remoteSetControlMode | ||||
fanMode | string | “Auto”, “Low”, “Med”, “High” |
● | see remoteSetFanMode | |||||
spValue | float | currentTempUnit | spValueMin | spValueMax | spValueStep | ● | ● | see remoteSetSpValue, see overrideStatus |
|
prgMode | string | “No-program”, “One-day”, “Sun_mon-fri_sat”, “Every-day” |
● | ● | see remoteSetPrgMode | ||||
prgSpTimeXX | string | “hh:mm”, eg: “23:50” |
● | ● | see remoteSetPrgSpTimeXX | ||||
prgSpValueXX | float | currentTempUnit | spValueMin | spValueMax | spValueStep | ● | ● | see remoteSetPrgSpValueXX |
Server-side RPC¶
Server-side RPC (remote change client-side attribute)¶
Tip
- All of these server-side RPC are one-way, no response
- Request format of these server-side RPC: {”method”:”remoteSetTempUnit”, “params”:”°F”}
- params value see Client-side attribute (change by server-side RPC, settings) & Client-side attribute (change by server-side RPC, control & program)
remoteSetTempUnit¶
remoteSetTimeFormat¶
remoteSetSystemMode¶
remoteSetSensorMode¶
remoteSetInternalOffset¶
remoteSetFloorTempLimited¶
remoteSetSwitchingDiffHeating¶
remoteSetSwitchingDiffCooling¶
remoteSetAdaptiveControl¶
remoteSetForceVent¶
remoteSetChangeOverMode¶
remoteSetChangeOverTempHeating¶
remoteSetChangeOverTempCooling¶
remoteSetControlMode¶
remoteSetFanMode¶
remoteSetSpValue¶
remoteSetPrgMode¶
remoteSetPrgSpTimeXX¶
0 <= XX <= 27, remoteSetPrgSpTime00 ~ remoteSetPrgSpTime27
remoteSetPrgSpValueXX¶
0 <= XX <= 27, remoteSetPrgSpValue00 ~ remoteSetPrgSpValue27
Server-side RPC (remote change client-side attribute) |
params value type |
params value |
TA65 -FC |
TA65 -FH |
Memo |
---|---|---|---|---|---|
remoteSetTempUnit | string | “°C” / “°F” | ● | ● | tempUnit |
remoteSetTimeFormat | string | “12hours” “24hours” |
● | ● | timeFormat |
remoteSetSystemMode | string | “Heat” “Cool” |
● | systemMode | |
remoteSetSensorMode | string | “Internal” “External” “Combined” |
● | sensorMode | |
remoteSetInternalOffset | float | ● | ● | internalOffset | |
remoteSetFloorTempLimited | float | ● | floorTempLimited | ||
remoteSetSwitchingDiffHeating | float | ● | ● | switchingDiffHeating | |
remoteSetSwitchingDiffCooling | float | ● | ● | switchingDiffCooling | |
remoteSetAdaptiveControl | bool | true false |
● | adaptiveControl | |
remoteSetForceVent | bool | true false |
● | forceVent | |
remoteSetChangeOverMode | string | “Heat” “Cool” “Auto” |
● | changeOverMode | |
remoteSetChangeOverTempHeating | float | ● | changeOverTempHeating | ||
remoteSetChangeOverTempCooling | float | ● | changeOverTempCooling | ||
remoteSetControlMode | string | “Off” “On” |
● | ● | controlMode |
remoteSetFanMode | string | “Auto” “Low” “Med” “High” |
● | fanMode | |
remoteSetSpValue | float | ● | ● | spValue | |
remoteSetPrgMode | string | “No-program” “One-day” “Sun_mon-fri_sat” “Every-day” |
● | ● | prgMode |
remoteSetPrgSpTimeXX | string | “hh:mm”, eg: “23:50” |
● | ● | remoteSetPrgSpTime00 ~ remoteSetPrgSpTime27, see prgSpTimeXX |
remoteSetPrgSpValueXX | float | ● | ● | remoteSetPrgSpValue00 ~ remoteSetPrgSpValue27, see prgSpValueXX |
Server-side RPC (remote control)¶
remoteSetOverrideStatus¶
remoteSyncTimeRequest¶
remoteClearWiFiConfig¶
remoteRebootDevice¶
remoteWiFiFUOTA¶
remoteMcuFUOTA¶
remoteGetMemoryUsage¶
Server-side RPC | one-way | two-way |
Request | Response | TA65 -FC |
TA65 -FH |
Memo |
---|---|---|---|---|---|---|
remoteSetOverrideStatus | one-way | {“method”:”remoteSetOverrideStatus”, “params”:{}} |
● | ● | Assign a prgSpValueXX to spValue, 0 <= XX <= 27 |
|
remoteSyncTimeRequest | one-way | {“method”:”remoteSyncTimeRequest”, “params”:{}} |
● | ● | ||
remoteClearWiFiConfig | one-way | {“method”:”remoteClearWiFiConfig”, “params”:{}} |
● | ● | ||
remoteRebootDevice | one-way | {“method”:”remoteRebootDevice”, “params”:{}} |
● | ● | ||
remoteWiFiFUOTA | two-way | {“method”:”remoteWiFiFUOTA”, “params”:”http://192.168.1.2/x.img”} |
{“method”:”remoteWiFiFUOTA”, “results”:{“result”:”success”}}, or {“method”:”remoteWiFiFUOTA”, “results”:{“result”:”failure”, “description”:”xxx”}} |
● | ● | |
remoteMcuFUOTA | two-way | {“method”:”remoteMcuFUOTA”, “params”:”http://192.168.1.1/y.img”} |
{“method”:”remoteMcuFUOTA”, “results”:{“result”:”success”}}, or {“method”:”remoteMcuFUOTA”, “results”:{“result”:”failure”, “description”:”xxx”}} |
● | ● | |
remoteGetMemoryUsage | two-way | {“method”:”remoteGetMemoryUsage”, “params”:{}} |
{“method”:”remoteGetMemoryUsage”, “results”:{“iram”:123123, “spiram”:2345678}} |
● | ● |