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

PhMeasurement Attributes

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

PhMeasurement/MeasuredValue Attribute

MQTT Topic Pattern:

[PREFIX]/PhMeasurement/Attributes/MeasuredValue/Reported

[PREFIX]/PhMeasurement/Attributes/MeasuredValue/Desired

MQTT Payload JSON Schema:

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

PhMeasurement/MinMeasuredValue Attribute

MQTT Topic Pattern:

[PREFIX]/PhMeasurement/Attributes/MinMeasuredValue/Reported

[PREFIX]/PhMeasurement/Attributes/MinMeasuredValue/Desired

MQTT Payload JSON Schema:

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

PhMeasurement/MaxMeasuredValue Attribute

MQTT Topic Pattern:

[PREFIX]/PhMeasurement/Attributes/MaxMeasuredValue/Reported

[PREFIX]/PhMeasurement/Attributes/MaxMeasuredValue/Desired

MQTT Payload JSON Schema:

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

PhMeasurement/Tolerance Attribute

MQTT Topic Pattern:

[PREFIX]/PhMeasurement/Attributes/Tolerance/Reported

[PREFIX]/PhMeasurement/Attributes/Tolerance/Desired

MQTT Payload JSON Schema:

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

PhMeasurement/ClusterRevision Attribute

MQTT Topic Pattern:

[PREFIX]/PhMeasurement/Attributes/ClusterRevision/Reported

[PREFIX]/PhMeasurement/Attributes/ClusterRevision/Desired

MQTT Payload JSON Schema:

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

PhMeasurement Command Support

MQTT Topic Pattern:

[PREFIX]/PhMeasurement/SupportedCommands

[PREFIX]/PhMeasurement/SupportedGeneratedCommands

MQTT Payload JSON Schema:

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

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

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

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

PhMeasurement Commands

PhMeasurement/WriteAttributes Command

MQTT Topic Pattern:

[PREFIX]/PhMeasurement/Commands/WriteAttributes

MQTT Payload JSON Schema:

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

Example Mosquitto CLI Tool Usage

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

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

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

PhMeasurement/ForceReadAttributes Command

MQTT Topic Pattern:

[PREFIX]/PhMeasurement/Commands/ForceReadAttributes

MQTT Payload JSON Schema:

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

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

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

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