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

PM25 Attributes

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

PM25/MeasuredValue Attribute

MQTT Topic Pattern:

[PREFIX]/PM25/Attributes/MeasuredValue/Reported

[PREFIX]/PM25/Attributes/MeasuredValue/Desired

MQTT Payload JSON Schema:

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "PM25 Cluster MeasuredValue Attribute Properties",
  "type": "object",
  "properties": {
    "value": {
      "type": "number"
    }
  },
  "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/+/+/PM25/Attributes/MeasuredValue/+'
 
# Example output
 
ucl/by-unid/<UNID>/ep0/PM25/Attributes/MeasuredValue/Desired { "value": <DESIRED_MEASURED_VALUE>}
ucl/by-unid/<UNID>/ep0/PM25/Attributes/MeasuredValue/Reported { "value": <REPORTED_MEASURED_VALUE>}

PM25/MinMeasuredValue Attribute

MQTT Topic Pattern:

[PREFIX]/PM25/Attributes/MinMeasuredValue/Reported

[PREFIX]/PM25/Attributes/MinMeasuredValue/Desired

MQTT Payload JSON Schema:

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "PM25 Cluster MinMeasuredValue Attribute Properties",
  "type": "object",
  "properties": {
    "value": {
      "type": "number"
    }
  },
  "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/+/+/PM25/Attributes/MinMeasuredValue/+'
 
# Example output
 
ucl/by-unid/<UNID>/ep0/PM25/Attributes/MinMeasuredValue/Desired { "value": <DESIRED_MIN_MEASURED_VALUE>}
ucl/by-unid/<UNID>/ep0/PM25/Attributes/MinMeasuredValue/Reported { "value": <REPORTED_MIN_MEASURED_VALUE>}

PM25/MaxMeasuredValue Attribute

MQTT Topic Pattern:

[PREFIX]/PM25/Attributes/MaxMeasuredValue/Reported

[PREFIX]/PM25/Attributes/MaxMeasuredValue/Desired

MQTT Payload JSON Schema:

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "PM25 Cluster MaxMeasuredValue Attribute Properties",
  "type": "object",
  "properties": {
    "value": {
      "type": "number"
    }
  },
  "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/+/+/PM25/Attributes/MaxMeasuredValue/+'
 
# Example output
 
ucl/by-unid/<UNID>/ep0/PM25/Attributes/MaxMeasuredValue/Desired { "value": <DESIRED_MAX_MEASURED_VALUE>}
ucl/by-unid/<UNID>/ep0/PM25/Attributes/MaxMeasuredValue/Reported { "value": <REPORTED_MAX_MEASURED_VALUE>}

PM25/Tolerance Attribute

MQTT Topic Pattern:

[PREFIX]/PM25/Attributes/Tolerance/Reported

[PREFIX]/PM25/Attributes/Tolerance/Desired

MQTT Payload JSON Schema:

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "PM25 Cluster Tolerance Attribute Properties",
  "type": "object",
  "properties": {
    "value": {
      "type": "number"
    }
  },
  "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/+/+/PM25/Attributes/Tolerance/+'
 
# Example output
 
ucl/by-unid/<UNID>/ep0/PM25/Attributes/Tolerance/Desired { "value": <DESIRED_TOLERANCE>}
ucl/by-unid/<UNID>/ep0/PM25/Attributes/Tolerance/Reported { "value": <REPORTED_TOLERANCE>}

PM25/ClusterRevision Attribute

MQTT Topic Pattern:

[PREFIX]/PM25/Attributes/ClusterRevision/Reported

[PREFIX]/PM25/Attributes/ClusterRevision/Desired

MQTT Payload JSON Schema:

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "PM25 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>/PM25/Attributes/ClusterRevision/+'
# Example output
ucl/by-unid/<UNID>/<EP>/PM25/Attributes/ClusterRevision/Desired { "value": <DESIRED_CLUSTER_REVISION> }
ucl/by-unid/<UNID>/<EP>/PM25/Attributes/ClusterRevision/Reported { "value": <REPORTED_CLUSTER_REVISION> }

PM25 Command Support

MQTT Topic Pattern:

[PREFIX]/PM25/SupportedCommands

[PREFIX]/PM25/SupportedGeneratedCommands

MQTT Payload JSON Schema:

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "PM25 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 PM25 cluster under the by-unid topic space:

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

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

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

PM25 Commands

PM25/WriteAttributes Command

MQTT Topic Pattern:

[PREFIX]/PM25/Commands/WriteAttributes

MQTT Payload JSON Schema:

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

Example Mosquitto CLI Tool Usage

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

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

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

PM25/ForceReadAttributes Command

MQTT Topic Pattern:

[PREFIX]/PM25/Commands/ForceReadAttributes

MQTT Payload JSON Schema:

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "PM25 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 PM25 attributes under the by-unid topic space (by sending an empty array):

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

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

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