Unify Framework UCL MQTT Reference 1.7.0
All Files Pages
TemperatureMeasurement Cluster

The following commands and attributes are accepted as JSON payloads for the TemperatureMeasurement cluster.



TemperatureMeasurement Attributes

The following attribute topics are used to retrieve the TemperatureMeasurement cluster state.


TemperatureMeasurement/MeasuredValue Attribute

MQTT Topic Pattern:

[PREFIX]/TemperatureMeasurement/Attributes/MeasuredValue/Reported
[PREFIX]/TemperatureMeasurement/Attributes/MeasuredValue/Desired

MQTT Payload JSON Schema:

{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "TemperatureMeasurement Cluster MeasuredValue Attribute Properties",
"type": "object",
"properties": {
"value": {
"type": "integer"
}
},
"required": [
"value"
]
}

Example Mosquitto CLI Tool Usage

To see desired/reported value for MeasuredValue attribute under the by-unid topic space:

mosquitto_sub -t 'ucl/by-unid/+/+/TemperatureMeasurement/Attributes/MeasuredValue/+'
# Example output
ucl/by-unid/<UNID>/ep0/TemperatureMeasurement/Attributes/MeasuredValue/Desired { "value": <DESIRED_MEASURED_VALUE>}
ucl/by-unid/<UNID>/ep0/TemperatureMeasurement/Attributes/MeasuredValue/Reported { "value": <REPORTED_MEASURED_VALUE>}



TemperatureMeasurement/MinMeasuredValue Attribute

MQTT Topic Pattern:

[PREFIX]/TemperatureMeasurement/Attributes/MinMeasuredValue/Reported
[PREFIX]/TemperatureMeasurement/Attributes/MinMeasuredValue/Desired

MQTT Payload JSON Schema:

{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "TemperatureMeasurement Cluster MinMeasuredValue Attribute Properties",
"type": "object",
"properties": {
"value": {
"type": "integer"
}
},
"required": [
"value"
]
}

Example Mosquitto CLI Tool Usage

To see desired/reported value for MinMeasuredValue attribute under the by-unid topic space:

mosquitto_sub -t 'ucl/by-unid/+/+/TemperatureMeasurement/Attributes/MinMeasuredValue/+'
# Example output
ucl/by-unid/<UNID>/ep0/TemperatureMeasurement/Attributes/MinMeasuredValue/Desired { "value": <DESIRED_MIN_MEASURED_VALUE>}
ucl/by-unid/<UNID>/ep0/TemperatureMeasurement/Attributes/MinMeasuredValue/Reported { "value": <REPORTED_MIN_MEASURED_VALUE>}



TemperatureMeasurement/MaxMeasuredValue Attribute

MQTT Topic Pattern:

[PREFIX]/TemperatureMeasurement/Attributes/MaxMeasuredValue/Reported
[PREFIX]/TemperatureMeasurement/Attributes/MaxMeasuredValue/Desired

MQTT Payload JSON Schema:

{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "TemperatureMeasurement Cluster MaxMeasuredValue Attribute Properties",
"type": "object",
"properties": {
"value": {
"type": "integer"
}
},
"required": [
"value"
]
}

Example Mosquitto CLI Tool Usage

To see desired/reported value for MaxMeasuredValue attribute under the by-unid topic space:

mosquitto_sub -t 'ucl/by-unid/+/+/TemperatureMeasurement/Attributes/MaxMeasuredValue/+'
# Example output
ucl/by-unid/<UNID>/ep0/TemperatureMeasurement/Attributes/MaxMeasuredValue/Desired { "value": <DESIRED_MAX_MEASURED_VALUE>}
ucl/by-unid/<UNID>/ep0/TemperatureMeasurement/Attributes/MaxMeasuredValue/Reported { "value": <REPORTED_MAX_MEASURED_VALUE>}



TemperatureMeasurement/Tolerance Attribute

MQTT Topic Pattern:

[PREFIX]/TemperatureMeasurement/Attributes/Tolerance/Reported
[PREFIX]/TemperatureMeasurement/Attributes/Tolerance/Desired

MQTT Payload JSON Schema:

{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "TemperatureMeasurement Cluster Tolerance Attribute Properties",
"type": "object",
"properties": {
"value": {
"type": "integer"
}
},
"required": [
"value"
]
}

Example Mosquitto CLI Tool Usage

To see desired/reported value for Tolerance attribute under the by-unid topic space:

mosquitto_sub -t 'ucl/by-unid/+/+/TemperatureMeasurement/Attributes/Tolerance/+'
# Example output
ucl/by-unid/<UNID>/ep0/TemperatureMeasurement/Attributes/Tolerance/Desired { "value": <DESIRED_TOLERANCE>}
ucl/by-unid/<UNID>/ep0/TemperatureMeasurement/Attributes/Tolerance/Reported { "value": <REPORTED_TOLERANCE>}



TemperatureMeasurement/ClusterRevision Attribute

MQTT Topic Pattern:

[PREFIX]/TemperatureMeasurement/Attributes/ClusterRevision/Reported
[PREFIX]/TemperatureMeasurement/Attributes/ClusterRevision/Desired

MQTT Payload JSON Schema:

{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "TemperatureMeasurement Cluster ClusterRevision Attribute Properties",
"type": "object",
"properties": {
"value": {
"type": "integer"
}
},
"required": [
"value"
]
}

Example Mosquitto CLI Tool Usage

To see desired/reported value for ClusterRevision attribute under the by-unid topic space:

mosquitto_sub -t 'ucl/by-unid/<UNID>/<EP>/TemperatureMeasurement/Attributes/ClusterRevision/+'
# Example output
ucl/by-unid/<UNID>/<EP>/TemperatureMeasurement/Attributes/ClusterRevision/Desired { "value": <DESIRED_CLUSTER_REVISION> }
ucl/by-unid/<UNID>/<EP>/TemperatureMeasurement/Attributes/ClusterRevision/Reported { "value": <REPORTED_CLUSTER_REVISION> }



TemperatureMeasurement Command Support

MQTT Topic Pattern:

[PREFIX]/TemperatureMeasurement/SupportedCommands
[PREFIX]/TemperatureMeasurement/SupportedGeneratedCommands

MQTT Payload JSON Schema:

{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "TemperatureMeasurement Command Support Properties",
"type": "object",
"properties": {
"value": {
"type": "array",
"items" : {
"type": "string",
"enum": [
]
}
}
}
},
"required": [
"value"
]
}

Example Mosquitto CLI Tool Usage

To see supported commands for TemperatureMeasurement cluster under the by-unid topic space:

mosquitto_sub -t 'ucl/by-unid/<UNID>/<EP>/TemperatureMeasurement/SupportedCommands'
# Example output
ucl/by-unid/<UNID>/<EP>/TemperatureMeasurement/SupportedCommands { "value": [] }

To see supported generated commands for TemperatureMeasurement cluster under the by-unid topic space:

mosquitto_sub -t 'ucl/by-unid/<UNID>/<EP>/TemperatureMeasurement/SupportedGeneratedCommands'
# Example output
ucl/by-unid/<UNID>/<EP>/TemperatureMeasurement/SupportedGeneratedCommands { "value": [] }



TemperatureMeasurement Commands



TemperatureMeasurement/WriteAttributes Command

MQTT Topic Pattern:

[PREFIX]/TemperatureMeasurement/Commands/WriteAttributes

MQTT Payload JSON Schema:

{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "TemperatureMeasurement Cluster WriteAttributes Command Properties",
"type": "object",
"properties": {
},
"required": [
"value"
]
}

Example Mosquitto CLI Tool Usage

To update all TemperatureMeasurement attributes under the by-unid topic space:

mosquitto_pub -t 'ucl/by-unid/<UNID>/<EP>/TemperatureMeasurement/Commands/WriteAttributes' -m '{ }'

‍NOTE: Specify only the list of attributes to write in this command. Unspecified attributes will not be updated.



TemperatureMeasurement/ForceReadAttributes Command

MQTT Topic Pattern:

[PREFIX]/TemperatureMeasurement/Commands/ForceReadAttributes

MQTT Payload JSON Schema:

{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "TemperatureMeasurement Cluster ForceReadAttributes Command Properties",
"type": "object",
"properties": {
"value": {
"type": "array"
"items": {
"type": "string",
"enum": [
"MeasuredValue",
"MinMeasuredValue",
"MaxMeasuredValue",
"Tolerance"
]
}
}
},
"required": [
"value"
]
}

Example Mosquitto CLI Tool Usage

To force read all TemperatureMeasurement attributes under the by-unid topic space (by sending an empty array):

mosquitto_pub -t 'ucl/by-unid/<UNID>/<EP>/TemperatureMeasurement/Commands/ForceReadAttributes' -m '{ "value": [] }'

To force read one of the TemperatureMeasurement attributes under the by-unid topic space:

mosquitto_pub -t 'ucl/by-unid/<UNID>/<EP>/TemperatureMeasurement/Commands/ForceReadAttributes' -m '{ "value": ["MeasuredValue"] }'