SchemaBMS Event Bus

Schemas

View as Markdown

MetadataBase

Minimum fields present on every metadata message.

NameTypeRequiredDescription
objectTypestringYesCanonical object type. Matches the objectType MQTT topic segment.
pointTypestringYesCanonical point type. Matches the pointType MQTT topic segment.

IntegrationPublisherFields

Fields added to metadata for integration-published points. Integrations MUST publish values to the exact topic corresponding to integration — do not construct it independently.

NameTypeRequiredDescription
integrationstringYesIntegration identifier responsible for publishing this value.

StateTextField

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

EquipmentPointEngUnit

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

EquipmentMeasurementModeBase

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

rackLocationIdentifiers

Rack-specific identifier fields added to all Rack metadata messages.

NameTypeRequiredDescription
rackLocationNamestringYesHuman-readable rack name as defined by the BMS.
rackLocationIdstringYesStable unique identifier for the rack.

PowerMeterIdentifiers

PowerMeter-specific identifier fields added to all PowerMeter metadata messages.

NameTypeRequiredDescription
objectNamestringYesHuman-readable name of the electrical device.
objectIdstringYesStable unique identifier for the electrical device.
servesIdarray<string>YesList of objectIds of entities served by this power meter.

EquipmentCommonFields

Optional fields common to all generic equipment metadata, regardless of identifier mode.

NameTypeRequiredDescription
processAreaarray<string>NoList of process areas or sub-system locations within the equipment

EquipmentNamedObjectMode

Object Mode: use when the object is identified directly by name and ID.

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

EquipmentAssociateMode

Associate Mode: use when the object is referenced via an association identifier.

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

EquipmentIntegrationIdentifierFields

Extends EquipmentIntegrationMetadataBase: adds integration for integration-published equipment points.

NameTypeRequiredDescription
integrationstringYesIntegration responsible for publishing this value.

SystemIntegrationIdentifiers

Required integration field for integration-published System metadata messages.

NameTypeRequiredDescription
integrationstringYesIntegration identifier.

RackMetadataBase

Rack-specific identifier fields added to all Rack metadata messages.

NameTypeRequiredDescription
objectTypestringYesCanonical object type. Matches the objectType MQTT topic segment.
pointTypestringYesCanonical point type. Matches the pointType MQTT topic segment.
rackLocationNamestringYesHuman-readable rack name as defined by the BMS.
rackLocationIdstringYesStable unique identifier for the rack.

RackIntegrationMetadataBase

Fields added to metadata for integration-published points. Integrations MUST publish values to the exact topic corresponding to integration — do not construct it independently.

NameTypeRequiredDescription
objectTypestringYesCanonical object type. Matches the objectType MQTT topic segment.
pointTypestringYesCanonical point type. Matches the pointType MQTT topic segment.
rackLocationNamestringYesHuman-readable rack name as defined by the BMS.
rackLocationIdstringYesStable unique identifier for the rack.
integrationstringYesIntegration identifier responsible for publishing this value.

PowerMeterMetadataBase

PowerMeter-specific identifier fields added to all PowerMeter metadata messages.

NameTypeRequiredDescription
objectTypestringYesCanonical object type. Matches the objectType MQTT topic segment.
pointTypestringYesCanonical point type. Matches the pointType MQTT topic segment.
objectNamestringYesHuman-readable name of the electrical device.
objectIdstringYesStable unique identifier for the electrical device.
servesIdarray<string>YesList of objectIds of entities served by this power meter.

EquipmentMetadataBase

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

EquipmentIntegrationMetadataBase

Extends EquipmentIntegrationMetadataBase: adds integration for integration-published equipment points.

Extends EquipmentIntegrationMetadataBase: adds integration for integration-published equipment points.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

SystemIntegrationMetadataBase

Required integration field for integration-published System metadata messages.

NameTypeRequiredDescription
objectTypestringYesCanonical object type. Matches the objectType MQTT topic segment.
pointTypestringYesCanonical point type. Matches the pointType MQTT topic segment.
integrationstringYesIntegration identifier.

RackBmsPointType

Valid pointType values for BMS-published Rack points.

Allowed values: RackLiquidSupplyTemperature, RackLiquidReturnTemperature, RackLiquidFlow, RackLiquidDifferentialPressure, RackLiquidDifferentialPressureSp, RackControlValvePosition, RackPower, RackLeakDetect, RackLeakSensorFault, RackLiquidIsolationStatus, RackElectricalIsolationStatus

RackIntegrationPointType

Valid pointType values for Integration-published Rack points.

Allowed values: RackLeakDetectTray, RackLiquidIsolationRequest, RackElectricalIsolationRequest

PowerMeterPointType

Valid pointType values for PowerMeter points (all BMS-published).

Allowed values: Voltage, PowerFactor, Frequency, ApparentPower, ActivePower, Current, CurrentLimit, PhaseCurrent

EquipmentBmsPointType

Valid pointType values for BMS-published generic equipment points.

Allowed values: LiquidTemperature, LiquidDifferentialPressure, LiquidFlow, LiquidPressure, Status, Available, ValvePosition, PumpSpeed, FanSpeed, DamperPosition, AirTemperature, AirDifferentialPressure, AirFlow, AirPressure, Sound, GenericPoint

EquipmentIntegrationPointType

Valid pointType values for Integration-published generic equipment points.

Allowed values: LiquidTemperatureSpRequest, GenericPoint

EquipmentObjectType

Valid objectType values for generic equipment channels.

Allowed values: CDU, CoolingTower, HX, CRAH, CRAC, AHU, Chiller, BESS, UPS, ATS, Generator, Shunt, Breaker, Valve, Pump, Fan, Damper, Sensor, Tank, GenericObject

SystemBmsPointType

Valid pointType values for BMS-published System points.

Allowed values: HeartbeatTimestampBms, HeartbeatEchoBms, Status, Available, GenericPoint

SystemIntegrationPointType

Valid pointType values for Integration-published System points.

Allowed values: HeartbeatTimestampIntegration, HeartbeatEchoIntegration, Status, Available, GenericPoint

RackLiquidSupplyTemperatureFields

NameTypeRequiredDescription
pointTypestringNoValues: RackLiquidSupplyTemperature
objectTypestringNoValues: Rack
engUnitstringYesValues: C

RackLiquidReturnTemperatureFields

NameTypeRequiredDescription
pointTypestringNoValues: RackLiquidReturnTemperature
objectTypestringNoValues: Rack
engUnitstringYesValues: C

RackLiquidFlowFields

NameTypeRequiredDescription
pointTypestringNoValues: RackLiquidFlow
objectTypestringNoValues: Rack
engUnitstringYesValues: LPM

RackLiquidDifferentialPressureFields

NameTypeRequiredDescription
pointTypestringNoValues: RackLiquidDifferentialPressure
objectTypestringNoValues: Rack
engUnitstringYesValues: kPa

RackControlValvePositionFields

NameTypeRequiredDescription
pointTypestringNoValues: RackControlValvePosition
objectTypestringNoValues: Rack
engUnitstringYesValues: %

RackPowerFields

NameTypeRequiredDescription
pointTypestringNoValues: RackPower
objectTypestringNoValues: Rack
engUnitstringYesValues: kW

RackLeakDetectFields

0 = No Leak, 1 = Leak. No engUnit.

NameTypeRequiredDescription
pointTypestringNoValues: RackLeakDetect
objectTypestringNoValues: Rack
stateTextarray<map<string, any>>YesState label mapping for leak detection.

RackLeakSensorFaultFields

0 = No Fault, 1 = Fault. No engUnit.

NameTypeRequiredDescription
pointTypestringNoValues: RackLeakSensorFault
objectTypestringNoValues: Rack
stateTextarray<map<string, any>>YesState label mapping for leak sensor fault status.

RackLiquidIsolationStatusFields

0=NotIsolated, 1=Isolated. No engUnit.

NameTypeRequiredDescription
pointTypestringNoValues: RackLiquidIsolationStatus
objectTypestringNoValues: Rack
stateTextarray<map<string, any>>YesState label mapping for liquid isolation status.

RackElectricalIsolationStatusFields

0 = NotIsolated, 1 = Isolated. No engUnit.

NameTypeRequiredDescription
pointTypestringNoValues: RackElectricalIsolationStatus
objectTypestringNoValues: Rack
stateTextarray<map<string, any>>YesState label mapping for electrical isolation status.

RackLeakDetectTrayFields

0 = No Leak, 1 = Leak (tray sensor). No engUnit. Integration-published value.

NameTypeRequiredDescription
pointTypestringNoValues: RackLeakDetectTray
objectTypestringNoValues: Rack
stateTextarray<map<string, any>>YesState label mapping for tray leak detection.

RackLiquidIsolationRequestFields

0 = Not Requested, 1 = Requested, -1 = Unknown. Integration-published value.

NameTypeRequiredDescription
pointTypestringNoValues: RackLiquidIsolationRequest
objectTypestringNoValues: Rack
stateTextarray<map<string, any>>YesState label mapping for liquid isolation request.

RackElectricalIsolationRequestFields

0 = Not Requested, 1 = Requested. Integration-published value.

NameTypeRequiredDescription
pointTypestringNoValues: RackElectricalIsolationRequest
objectTypestringNoValues: Rack
stateTextarray<map<string, any>>YesState label mapping for electrical isolation request.

VoltageFields

NameTypeRequiredDescription
pointTypestringNoValues: Voltage
objectTypestringNoValues: PowerMeter
engUnitstringYes

PowerFactorFields

Dimensionless 0–1. engUnit not required.

NameTypeRequiredDescription
pointTypestringNoValues: PowerFactor
objectTypestringNoValues: PowerMeter

FrequencyFields

NameTypeRequiredDescription
pointTypestringNoValues: Frequency
objectTypestringNoValues: PowerMeter
engUnitstringYes

ApparentPowerFields

NameTypeRequiredDescription
pointTypestringNoValues: ApparentPower
objectTypestringNoValues: PowerMeter
engUnitstringYes

ActivePowerFields

NameTypeRequiredDescription
pointTypestringNoValues: ActivePower
objectTypestringNoValues: PowerMeter
engUnitstringYes

CurrentFields

NameTypeRequiredDescription
pointTypestringNoValues: Current
objectTypestringNoValues: PowerMeter
engUnitstringYes

CurrentLimitFields

NameTypeRequiredDescription
pointTypestringNoValues: CurrentLimit
objectTypestringNoValues: PowerMeter
engUnitstringYes

PhaseCurrentFields

PhaseCurrent additionally requires phase to identify which electrical phase. Accepts letter form (A, B, C) or numeric form (1, 2, 3); both are valid representations of the same three-phase system. 3 metadata messages per meter, one per phase.

NameTypeRequiredDescription
pointTypestringNoValues: PhaseCurrent
objectTypestringNoValues: PowerMeter
engUnitstringYes
phasestringYesElectrical phase identifier. Letter form (A/B/C) and numeric form (1/2/3) are both accepted to align with publisher conventions. Values: A, B, C, 1, 2, 3

LiquidTemperatureFields

NameTypeRequiredDescription
pointTypestringNoValues: LiquidTemperature
engUnitstringYesValues: C
isSetpointbooleanNoOptional. When true, indicates this point is a setpoint (a target value written to control equipment behavior).

LiquidDifferentialPressureFields

Measurement fields for LiquidDifferentialPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

NameTypeRequiredDescription
pointTypestringNoValues: LiquidDifferentialPressure
isSetpointbooleanNoOptional. When true, indicates this point is a setpoint (a target value written to control equipment behavior).

LiquidFlowFields

Measurement fields for LiquidFlow. Typical engUnit: LPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

NameTypeRequiredDescription
pointTypestringNoValues: LiquidFlow
isSetpointbooleanNoOptional. When true, indicates this point is a setpoint (a target value written to control equipment behavior).

LiquidPressureFields

Measurement fields for LiquidPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

NameTypeRequiredDescription
pointTypestringNoValues: LiquidPressure
isSetpointbooleanNoOptional. When true, indicates this point is a setpoint (a target value written to control equipment behavior).

StatusFields

NameTypeRequiredDescription
pointTypestringNoValues: Status
integrationstringNoOptional integration identifier. When present, this integration is responsible for publishing the value for this point.
stateTextarray<map<string, any>>YesState label mapping for operating status (values vary by equipment vendor).

AvailableFields

NameTypeRequiredDescription
pointTypestringNoValues: Available
integrationstringNoOptional integration identifier. When present, this integration is responsible for publishing the value for this point.
stateTextarray<map<string, any>>YesState label mapping for availability status (values vary by equipment vendor).

ValvePositionFields

Measurement fields for ValvePosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

NameTypeRequiredDescription
pointTypestringNoValues: ValvePosition

PumpSpeedFields

Measurement fields for PumpSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

NameTypeRequiredDescription
pointTypestringNoValues: PumpSpeed

FanSpeedFields

Measurement fields for FanSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

NameTypeRequiredDescription
pointTypestringNoValues: FanSpeed

DamperPositionFields

Measurement fields for DamperPosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

NameTypeRequiredDescription
pointTypestringNoValues: DamperPosition

AirTemperatureFields

NameTypeRequiredDescription
pointTypestringNoValues: AirTemperature
engUnitstringYesValues: C
isSetpointbooleanNoOptional. When true, indicates this point is a setpoint (a target value written to control equipment behavior).

AirDifferentialPressureFields

Measurement fields for AirDifferentialPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

NameTypeRequiredDescription
pointTypestringNoValues: AirDifferentialPressure
isSetpointbooleanNoOptional. When true, indicates this point is a setpoint (a target value written to control equipment behavior).

AirFlowFields

Measurement fields for AirFlow. Typical engUnit: CFM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

NameTypeRequiredDescription
pointTypestringNoValues: AirFlow
isSetpointbooleanNoOptional. When true, indicates this point is a setpoint (a target value written to control equipment behavior).

AirPressureFields

Measurement fields for AirPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

NameTypeRequiredDescription
pointTypestringNoValues: AirPressure
isSetpointbooleanNoOptional. When true, indicates this point is a setpoint (a target value written to control equipment behavior).

LeakDetectFields

0 = No Leak, 1 = Leak. No engUnit.

NameTypeRequiredDescription
pointTypestringNoValues: LeakDetect
stateTextarray<map<string, any>>YesState label mapping for leak detection.

AirRelativeHumidityFields

Measurement fields for AirRelativeHumidity. Typical engUnit: %RH. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

NameTypeRequiredDescription
pointTypestringNoValues: AirRelativeHumidity
isSetpointbooleanNoOptional. When true, indicates this point is a setpoint (a target value written to control equipment behavior).

LiquidTemperatureSpRequestFields

Setpoint request written by an integration (e.g., MEPAI) to a CDU. BMS publishes metadata; the integration publishes the value to respective value topic namespace identified by integration

NameTypeRequiredDescription
pointTypestringNoValues: LiquidTemperatureSpRequest
objectTypestringNoValues: CDU
engUnitstringYesValues: C

GenericObjectLiquidTemperatureSpRequestFields

Setpoint request for a GenericObject. BMS publishes metadata; the integration publishes the value to the derived topic.

NameTypeRequiredDescription
pointTypestringNoValues: LiquidTemperatureSpRequest
objectTypestringNoValues: GenericObject
engUnitstringYesValues: C

SoundFields

NameTypeRequiredDescription
pointTypestringNoValues: Sound
engUnitstringYes

HeartbeatTimestampBmsFields

BMS-published heartbeat timestamp. The BMS publishes its own timestamp every 10 s; one instance globally, consumed by all connected integrations. objectName and objectId identify the BMS itself (the publisher). The integration field is NOT used on this point — integration is reserved for value-publisher identity, and the BMS is the publisher here. scope optionally identifies which MQTT topics this heartbeat covers.

NameTypeRequiredDescription
pointTypestringNoValues: HeartbeatTimestampBms
objectNamestringYesHuman-readable name of the BMS publishing this heartbeat.
objectIdstringYesStable identifier for the BMS publishing this heartbeat (e.g., "BMS"). One instance per BMS.
scopestringNoIdentifies which MQTT topics this heartbeat covers.

HeartbeatEchoBmsFields

BMS echoes back the timestamp received from a specific integration. Published by the BMS (one instance per connected integration). The integration whose timestamp is being echoed is identified by objectName and objectId — by convention, objectId matches the same string used as that integration’s integration metadata value on its other points (e.g., objectId: "MEPAI1"). The integration field is intentionally NOT present on this point: integration denotes the value-publisher elsewhere in the spec, and the BMS is the publisher here. The integration being echoed is encoded in objectId, not in integration. scope optionally identifies which BMS MQTT-client/topic namespace this echo is associated with — used when the BMS runs multiple MQTT clients connected to DSX Exchange.

NameTypeRequiredDescription
pointTypestringNoValues: HeartbeatEchoBms
objectNamestringYesHuman-readable name of the integration whose timestamp is being echoed.
objectIdstringYesStable identifier of the integration whose timestamp is being echoed (e.g., "MEPAI1"). Matches that integration’s integration metadata value on its other points.
scopestringNoOptional. Identifies which BMS MQTT-client/topic namespace this echo is associated with.

HeartbeatTimestampIntegrationFields

Integration-published heartbeat timestamp. Each connected integration publishes its own timestamp every 10 s; one instance per integration. objectName and objectId identify the integration publishing this heartbeat. By convention, objectId matches the same string used as this integration’s integration metadata value on its other points (e.g., objectId: "MEPAI1" with integration: "MEPAI1"). The integration field is required via the integration metadata base and drives the value topic.

NameTypeRequiredDescription
pointTypestringNoValues: HeartbeatTimestampIntegration
objectNamestringYesHuman-readable name of the integration publishing this heartbeat.
objectIdstringYesStable identifier of the integration publishing this heartbeat (e.g., "MEPAI1"). By convention, matches the integration metadata value used by this integration on its other points.

HeartbeatEchoIntegrationFields

Integration echoes the BMS timestamp. Each integration publishes its own echo of the BMS timestamp, allowing the BMS to confirm round-trip with that specific integration (one instance per connected integration). The BMS whose timestamp is being echoed is identified by objectName and objectId (e.g., objectId: "BMS"). The integration field is required via the integration metadata base and drives the value topic.

NameTypeRequiredDescription
pointTypestringNoValues: HeartbeatEchoIntegration
objectNamestringYesHuman-readable name of the BMS whose timestamp is being echoed.
objectIdstringYesStable identifier of the BMS whose timestamp is being echoed (e.g., "BMS").

RackLiquidSupplyTemperatureMetadata

Rack-specific identifier fields added to all Rack metadata messages.

NameTypeRequiredDescription
objectTypestringYesValues: Rack
pointTypestringYesValues: RackLiquidSupplyTemperature
rackLocationNamestringYesHuman-readable rack name as defined by the BMS.
rackLocationIdstringYesStable unique identifier for the rack.
engUnitstringYesValues: C

RackLiquidReturnTemperatureMetadata

Rack-specific identifier fields added to all Rack metadata messages.

NameTypeRequiredDescription
objectTypestringYesValues: Rack
pointTypestringYesValues: RackLiquidReturnTemperature
rackLocationNamestringYesHuman-readable rack name as defined by the BMS.
rackLocationIdstringYesStable unique identifier for the rack.
engUnitstringYesValues: C

RackLiquidFlowMetadata

Rack-specific identifier fields added to all Rack metadata messages.

NameTypeRequiredDescription
objectTypestringYesValues: Rack
pointTypestringYesValues: RackLiquidFlow
rackLocationNamestringYesHuman-readable rack name as defined by the BMS.
rackLocationIdstringYesStable unique identifier for the rack.
engUnitstringYesValues: LPM

RackLiquidDifferentialPressureMetadata

Rack-specific identifier fields added to all Rack metadata messages.

NameTypeRequiredDescription
objectTypestringYesValues: Rack
pointTypestringYesValues: RackLiquidDifferentialPressure
rackLocationNamestringYesHuman-readable rack name as defined by the BMS.
rackLocationIdstringYesStable unique identifier for the rack.
engUnitstringYesValues: kPa

RackLiquidDifferentialPressureSpFields

NameTypeRequiredDescription
pointTypestringNoValues: RackLiquidDifferentialPressureSp
objectTypestringNoValues: Rack
engUnitstringYesValues: kPa
isSetpointbooleanNoOptional inclusion. Indicates this point is a target value written to control equipment behavior.

RackLiquidDifferentialPressureSpMetadata

Rack-specific identifier fields added to all Rack metadata messages.

NameTypeRequiredDescription
objectTypestringYesValues: Rack
pointTypestringYesValues: RackLiquidDifferentialPressureSp
rackLocationNamestringYesHuman-readable rack name as defined by the BMS.
rackLocationIdstringYesStable unique identifier for the rack.
engUnitstringYesValues: kPa
isSetpointbooleanNoOptional inclusion. Indicates this point is a target value written to control equipment behavior.

RackControlValvePositionMetadata

Rack-specific identifier fields added to all Rack metadata messages.

NameTypeRequiredDescription
objectTypestringYesValues: Rack
pointTypestringYesValues: RackControlValvePosition
rackLocationNamestringYesHuman-readable rack name as defined by the BMS.
rackLocationIdstringYesStable unique identifier for the rack.
engUnitstringYesValues: %

RackPowerMetadata

Rack-specific identifier fields added to all Rack metadata messages.

NameTypeRequiredDescription
objectTypestringYesValues: Rack
pointTypestringYesValues: RackPower
rackLocationNamestringYesHuman-readable rack name as defined by the BMS.
rackLocationIdstringYesStable unique identifier for the rack.
engUnitstringYesValues: kW

RackLeakDetectMetadata

0 = No Leak, 1 = Leak. No engUnit.

NameTypeRequiredDescription
objectTypestringYesValues: Rack
pointTypestringYesValues: RackLeakDetect
rackLocationNamestringYesHuman-readable rack name as defined by the BMS.
rackLocationIdstringYesStable unique identifier for the rack.
stateTextarray<map<string, any>>YesState label mapping for leak detection.

RackLeakSensorFaultMetadata

0 = No Fault, 1 = Fault. No engUnit.

NameTypeRequiredDescription
objectTypestringYesValues: Rack
pointTypestringYesValues: RackLeakSensorFault
rackLocationNamestringYesHuman-readable rack name as defined by the BMS.
rackLocationIdstringYesStable unique identifier for the rack.
stateTextarray<map<string, any>>YesState label mapping for leak sensor fault status.

RackLiquidIsolationStatusMetadata

0=NotIsolated, 1=Isolated. No engUnit.

NameTypeRequiredDescription
objectTypestringYesValues: Rack
pointTypestringYesValues: RackLiquidIsolationStatus
rackLocationNamestringYesHuman-readable rack name as defined by the BMS.
rackLocationIdstringYesStable unique identifier for the rack.
stateTextarray<map<string, any>>YesState label mapping for liquid isolation status.

RackElectricalIsolationStatusMetadata

0 = NotIsolated, 1 = Isolated. No engUnit.

NameTypeRequiredDescription
objectTypestringYesValues: Rack
pointTypestringYesValues: RackElectricalIsolationStatus
rackLocationNamestringYesHuman-readable rack name as defined by the BMS.
rackLocationIdstringYesStable unique identifier for the rack.
stateTextarray<map<string, any>>YesState label mapping for electrical isolation status.

RackLeakDetectTrayMetadata

0 = No Leak, 1 = Leak (tray sensor). No engUnit. Integration-published value.

NameTypeRequiredDescription
objectTypestringYesValues: Rack
pointTypestringYesValues: RackLeakDetectTray
rackLocationNamestringYesHuman-readable rack name as defined by the BMS.
rackLocationIdstringYesStable unique identifier for the rack.
integrationstringYesIntegration identifier responsible for publishing this value.
stateTextarray<map<string, any>>YesState label mapping for tray leak detection.

RackLiquidIsolationRequestMetadata

0 = Not Requested, 1 = Requested, -1 = Unknown. Integration-published value.

NameTypeRequiredDescription
objectTypestringYesValues: Rack
pointTypestringYesValues: RackLiquidIsolationRequest
rackLocationNamestringYesHuman-readable rack name as defined by the BMS.
rackLocationIdstringYesStable unique identifier for the rack.
integrationstringYesIntegration identifier responsible for publishing this value.
stateTextarray<map<string, any>>YesState label mapping for liquid isolation request.

RackElectricalIsolationRequestMetadata

0 = Not Requested, 1 = Requested. Integration-published value.

NameTypeRequiredDescription
objectTypestringYesValues: Rack
pointTypestringYesValues: RackElectricalIsolationRequest
rackLocationNamestringYesHuman-readable rack name as defined by the BMS.
rackLocationIdstringYesStable unique identifier for the rack.
integrationstringYesIntegration identifier responsible for publishing this value.
stateTextarray<map<string, any>>YesState label mapping for electrical isolation request.

PowerMeterVoltageMetadata

PowerMeter-specific identifier fields added to all PowerMeter metadata messages.

NameTypeRequiredDescription
objectTypestringYesValues: PowerMeter
pointTypestringYesValues: Voltage
objectNamestringYesHuman-readable name of the electrical device.
objectIdstringYesStable unique identifier for the electrical device.
servesIdarray<string>YesList of objectIds of entities served by this power meter.
engUnitstringYes

PowerMeterPowerFactorMetadata

Dimensionless 0–1. engUnit not required.

NameTypeRequiredDescription
objectTypestringYesValues: PowerMeter
pointTypestringYesValues: PowerFactor
objectNamestringYesHuman-readable name of the electrical device.
objectIdstringYesStable unique identifier for the electrical device.
servesIdarray<string>YesList of objectIds of entities served by this power meter.

PowerMeterFrequencyMetadata

PowerMeter-specific identifier fields added to all PowerMeter metadata messages.

NameTypeRequiredDescription
objectTypestringYesValues: PowerMeter
pointTypestringYesValues: Frequency
objectNamestringYesHuman-readable name of the electrical device.
objectIdstringYesStable unique identifier for the electrical device.
servesIdarray<string>YesList of objectIds of entities served by this power meter.
engUnitstringYes

PowerMeterApparentPowerMetadata

PowerMeter-specific identifier fields added to all PowerMeter metadata messages.

NameTypeRequiredDescription
objectTypestringYesValues: PowerMeter
pointTypestringYesValues: ApparentPower
objectNamestringYesHuman-readable name of the electrical device.
objectIdstringYesStable unique identifier for the electrical device.
servesIdarray<string>YesList of objectIds of entities served by this power meter.
engUnitstringYes

PowerMeterActivePowerMetadata

PowerMeter-specific identifier fields added to all PowerMeter metadata messages.

NameTypeRequiredDescription
objectTypestringYesValues: PowerMeter
pointTypestringYesValues: ActivePower
objectNamestringYesHuman-readable name of the electrical device.
objectIdstringYesStable unique identifier for the electrical device.
servesIdarray<string>YesList of objectIds of entities served by this power meter.
engUnitstringYes

PowerMeterCurrentMetadata

PowerMeter-specific identifier fields added to all PowerMeter metadata messages.

NameTypeRequiredDescription
objectTypestringYesValues: PowerMeter
pointTypestringYesValues: Current
objectNamestringYesHuman-readable name of the electrical device.
objectIdstringYesStable unique identifier for the electrical device.
servesIdarray<string>YesList of objectIds of entities served by this power meter.
engUnitstringYes

PowerMeterCurrentLimitMetadata

PowerMeter-specific identifier fields added to all PowerMeter metadata messages.

NameTypeRequiredDescription
objectTypestringYesValues: PowerMeter
pointTypestringYesValues: CurrentLimit
objectNamestringYesHuman-readable name of the electrical device.
objectIdstringYesStable unique identifier for the electrical device.
servesIdarray<string>YesList of objectIds of entities served by this power meter.
engUnitstringYes

PowerMeterPhaseCurrentMetadata

PhaseCurrent additionally requires phase to identify which electrical phase. Accepts letter form (A, B, C) or numeric form (1, 2, 3); both are valid representations of the same three-phase system. 3 metadata messages per meter, one per phase.

NameTypeRequiredDescription
objectTypestringYesValues: PowerMeter
pointTypestringYesValues: PhaseCurrent
objectNamestringYesHuman-readable name of the electrical device.
objectIdstringYesStable unique identifier for the electrical device.
servesIdarray<string>YesList of objectIds of entities served by this power meter.
engUnitstringYes
phasestringYesElectrical phase identifier. Letter form (A/B/C) and numeric form (1/2/3) are both accepted to align with publisher conventions. Values: A, B, C, 1, 2, 3

LiquidTemperatureMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

LiquidDifferentialPressureMetadata

Measurement fields for LiquidDifferentialPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for LiquidDifferentialPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

LiquidFlowMetadata

Measurement fields for LiquidFlow. Typical engUnit: LPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for LiquidFlow. Typical engUnit: LPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

LiquidPressureMetadata

Measurement fields for LiquidPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for LiquidPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

StatusMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

AvailableMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

ValvePositionMetadata

Measurement fields for ValvePosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for ValvePosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

PumpSpeedMetadata

Measurement fields for PumpSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for PumpSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

FanSpeedMetadata

Measurement fields for FanSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for FanSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

DamperPositionMetadata

Measurement fields for DamperPosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for DamperPosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

AirTemperatureMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

AirDifferentialPressureMetadata

Measurement fields for AirDifferentialPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirDifferentialPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

AirFlowMetadata

Measurement fields for AirFlow. Typical engUnit: CFM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirFlow. Typical engUnit: CFM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

AirPressureMetadata

Measurement fields for AirPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

SoundMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

LiquidTemperatureSpRequestMetadata

Setpoint request written by an integration (e.g., MEPAI) to a CDU. BMS publishes metadata; the integration publishes the value to respective value topic namespace identified by integration

Setpoint request written by an integration (e.g., MEPAI) to a CDU. BMS publishes metadata; the integration publishes the value to respective value topic namespace identified by integration

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

SystemHeartbeatTimestampBmsMetadata

BMS-published heartbeat timestamp. The BMS publishes its own timestamp every 10 s; one instance globally, consumed by all connected integrations. objectName and objectId identify the BMS itself (the publisher). The integration field is NOT used on this point — integration is reserved for value-publisher identity, and the BMS is the publisher here. scope optionally identifies which MQTT topics this heartbeat covers.

NameTypeRequiredDescription
objectTypestringYesCanonical object type. Matches the objectType MQTT topic segment.
pointTypestringYesValues: HeartbeatTimestampBms
objectNamestringYesHuman-readable name of the BMS publishing this heartbeat.
objectIdstringYesStable identifier for the BMS publishing this heartbeat (e.g., "BMS"). One instance per BMS.
scopestringNoIdentifies which MQTT topics this heartbeat covers.

SystemHeartbeatEchoBmsMetadata

BMS echoes back the timestamp received from a specific integration. Published by the BMS (one instance per connected integration). The integration whose timestamp is being echoed is identified by objectName and objectId — by convention, objectId matches the same string used as that integration’s integration metadata value on its other points (e.g., objectId: "MEPAI1"). The integration field is intentionally NOT present on this point: integration denotes the value-publisher elsewhere in the spec, and the BMS is the publisher here. The integration being echoed is encoded in objectId, not in integration. scope optionally identifies which BMS MQTT-client/topic namespace this echo is associated with — used when the BMS runs multiple MQTT clients connected to DSX Exchange.

NameTypeRequiredDescription
objectTypestringYesCanonical object type. Matches the objectType MQTT topic segment.
pointTypestringYesValues: HeartbeatEchoBms
objectNamestringYesHuman-readable name of the integration whose timestamp is being echoed.
objectIdstringYesStable identifier of the integration whose timestamp is being echoed (e.g., "MEPAI1"). Matches that integration’s integration metadata value on its other points.
scopestringNoOptional. Identifies which BMS MQTT-client/topic namespace this echo is associated with.

SystemHeartbeatTimestampIntegrationMetadata

Integration-published heartbeat timestamp. Each connected integration publishes its own timestamp every 10 s; one instance per integration. objectName and objectId identify the integration publishing this heartbeat. By convention, objectId matches the same string used as this integration’s integration metadata value on its other points (e.g., objectId: "MEPAI1" with integration: "MEPAI1"). The integration field is required via the integration metadata base and drives the value topic.

NameTypeRequiredDescription
objectTypestringYesCanonical object type. Matches the objectType MQTT topic segment.
pointTypestringYesValues: HeartbeatTimestampIntegration
integrationstringYesIntegration identifier.
objectNamestringYesHuman-readable name of the integration publishing this heartbeat.
objectIdstringYesStable identifier of the integration publishing this heartbeat (e.g., "MEPAI1"). By convention, matches the integration metadata value used by this integration on its other points.

SystemHeartbeatEchoIntegrationMetadata

Integration echoes the BMS timestamp. Each integration publishes its own echo of the BMS timestamp, allowing the BMS to confirm round-trip with that specific integration (one instance per connected integration). The BMS whose timestamp is being echoed is identified by objectName and objectId (e.g., objectId: "BMS"). The integration field is required via the integration metadata base and drives the value topic.

NameTypeRequiredDescription
objectTypestringYesCanonical object type. Matches the objectType MQTT topic segment.
pointTypestringYesValues: HeartbeatEchoIntegration
integrationstringYesIntegration identifier.
objectNamestringYesHuman-readable name of the BMS whose timestamp is being echoed.
objectIdstringYesStable identifier of the BMS whose timestamp is being echoed (e.g., "BMS").

SystemObjectTypeFields

NameTypeRequiredDescription
objectTypestringNoValues: System

SystemStatusMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

SystemAvailableMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

BESSObjectTypeFields

NameTypeRequiredDescription
objectTypestringNoValues: BESS

UPSObjectTypeFields

NameTypeRequiredDescription
objectTypestringNoValues: UPS

ATSObjectTypeFields

NameTypeRequiredDescription
objectTypestringNoValues: ATS

GeneratorObjectTypeFields

NameTypeRequiredDescription
objectTypestringNoValues: Generator

ShuntObjectTypeFields

NameTypeRequiredDescription
objectTypestringNoValues: Shunt

BreakerObjectTypeFields

NameTypeRequiredDescription
objectTypestringNoValues: Breaker

CDUObjectTypeFields

NameTypeRequiredDescription
objectTypestringNoValues: CDU

CoolingTowerObjectTypeFields

NameTypeRequiredDescription
objectTypestringNoValues: CoolingTower

HXObjectTypeFields

NameTypeRequiredDescription
objectTypestringNoValues: HX

CRAHObjectTypeFields

NameTypeRequiredDescription
objectTypestringNoValues: CRAH

CRACObjectTypeFields

NameTypeRequiredDescription
objectTypestringNoValues: CRAC

AHUObjectTypeFields

NameTypeRequiredDescription
objectTypestringNoValues: AHU

ChillerObjectTypeFields

NameTypeRequiredDescription
objectTypestringNoValues: Chiller

ValveObjectTypeFields

NameTypeRequiredDescription
objectTypestringNoValues: Valve

PumpObjectTypeFields

NameTypeRequiredDescription
objectTypestringNoValues: Pump

FanObjectTypeFields

NameTypeRequiredDescription
objectTypestringNoValues: Fan

DamperObjectTypeFields

NameTypeRequiredDescription
objectTypestringNoValues: Damper

SensorObjectTypeFields

NameTypeRequiredDescription
objectTypestringNoValues: Sensor

TankObjectTypeFields

NameTypeRequiredDescription
objectTypestringNoValues: Tank

GenericObjectObjectTypeFields

NameTypeRequiredDescription
objectTypestringNoValues: GenericObject

BESSStatusMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

BESSAvailableMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

UPSStatusMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

UPSAvailableMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

ATSStatusMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

ATSAvailableMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

GeneratorStatusMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

GeneratorAvailableMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

ShuntStatusMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

ShuntAvailableMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

BreakerStatusMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

BreakerAvailableMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

ValveValvePositionMetadata

Measurement fields for ValvePosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for ValvePosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

PumpPumpSpeedMetadata

Measurement fields for PumpSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for PumpSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

FanFanSpeedMetadata

Measurement fields for FanSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for FanSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

DamperDamperPositionMetadata

Measurement fields for DamperPosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for DamperPosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

ValveAvailableMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

PumpAvailableMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

FanAvailableMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

DamperAvailableMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

SensorAvailableMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

SensorLiquidTemperatureMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

SensorLiquidDifferentialPressureMetadata

Measurement fields for LiquidDifferentialPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for LiquidDifferentialPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

SensorLiquidFlowMetadata

Measurement fields for LiquidFlow. Typical engUnit: LPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for LiquidFlow. Typical engUnit: LPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

SensorLiquidPressureMetadata

Measurement fields for LiquidPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for LiquidPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

SensorAirTemperatureMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

SensorAirDifferentialPressureMetadata

Measurement fields for AirDifferentialPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirDifferentialPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

SensorAirFlowMetadata

Measurement fields for AirFlow. Typical engUnit: CFM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirFlow. Typical engUnit: CFM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

SensorAirPressureMetadata

Measurement fields for AirPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

SensorSoundMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

SensorLeakDetectMetadata

0 = No Leak, 1 = Leak. No engUnit.

0 = No Leak, 1 = Leak. No engUnit.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

SensorAirRelativeHumidityMetadata

Measurement fields for AirRelativeHumidity. Typical engUnit: %RH. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirRelativeHumidity. Typical engUnit: %RH. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CDULiquidTemperatureMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

CDULiquidDifferentialPressureMetadata

Measurement fields for LiquidDifferentialPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for LiquidDifferentialPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CDULiquidFlowMetadata

Measurement fields for LiquidFlow. Typical engUnit: LPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for LiquidFlow. Typical engUnit: LPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CDULiquidPressureMetadata

Measurement fields for LiquidPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for LiquidPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CDUStatusMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

CDUAvailableMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

CDUValvePositionMetadata

Measurement fields for ValvePosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for ValvePosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CDUPumpSpeedMetadata

Measurement fields for PumpSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for PumpSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CDUFanSpeedMetadata

Measurement fields for FanSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for FanSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CDUDamperPositionMetadata

Measurement fields for DamperPosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for DamperPosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CDUAirTemperatureMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

CDUAirDifferentialPressureMetadata

Measurement fields for AirDifferentialPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirDifferentialPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CDUAirFlowMetadata

Measurement fields for AirFlow. Typical engUnit: CFM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirFlow. Typical engUnit: CFM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CDUAirPressureMetadata

Measurement fields for AirPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CDULeakDetectMetadata

0 = No Leak, 1 = Leak. No engUnit.

0 = No Leak, 1 = Leak. No engUnit.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

CDUAirRelativeHumidityMetadata

Measurement fields for AirRelativeHumidity. Typical engUnit: %RH. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirRelativeHumidity. Typical engUnit: %RH. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CoolingTowerLiquidTemperatureMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

CoolingTowerLiquidDifferentialPressureMetadata

Measurement fields for LiquidDifferentialPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for LiquidDifferentialPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CoolingTowerLiquidFlowMetadata

Measurement fields for LiquidFlow. Typical engUnit: LPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for LiquidFlow. Typical engUnit: LPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CoolingTowerLiquidPressureMetadata

Measurement fields for LiquidPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for LiquidPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CoolingTowerStatusMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

CoolingTowerAvailableMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

CoolingTowerValvePositionMetadata

Measurement fields for ValvePosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for ValvePosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CoolingTowerPumpSpeedMetadata

Measurement fields for PumpSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for PumpSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CoolingTowerFanSpeedMetadata

Measurement fields for FanSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for FanSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CoolingTowerDamperPositionMetadata

Measurement fields for DamperPosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for DamperPosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CoolingTowerAirTemperatureMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

CoolingTowerAirDifferentialPressureMetadata

Measurement fields for AirDifferentialPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirDifferentialPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CoolingTowerAirFlowMetadata

Measurement fields for AirFlow. Typical engUnit: CFM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirFlow. Typical engUnit: CFM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CoolingTowerAirPressureMetadata

Measurement fields for AirPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CoolingTowerLeakDetectMetadata

0 = No Leak, 1 = Leak. No engUnit.

0 = No Leak, 1 = Leak. No engUnit.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

CoolingTowerAirRelativeHumidityMetadata

Measurement fields for AirRelativeHumidity. Typical engUnit: %RH. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirRelativeHumidity. Typical engUnit: %RH. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

HXLiquidTemperatureMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

HXLiquidDifferentialPressureMetadata

Measurement fields for LiquidDifferentialPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for LiquidDifferentialPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

HXLiquidFlowMetadata

Measurement fields for LiquidFlow. Typical engUnit: LPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for LiquidFlow. Typical engUnit: LPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

HXLiquidPressureMetadata

Measurement fields for LiquidPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for LiquidPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

HXStatusMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

HXAvailableMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

HXValvePositionMetadata

Measurement fields for ValvePosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for ValvePosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

HXPumpSpeedMetadata

Measurement fields for PumpSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for PumpSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

HXFanSpeedMetadata

Measurement fields for FanSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for FanSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

HXDamperPositionMetadata

Measurement fields for DamperPosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for DamperPosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

HXAirTemperatureMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

HXAirDifferentialPressureMetadata

Measurement fields for AirDifferentialPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirDifferentialPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

HXAirFlowMetadata

Measurement fields for AirFlow. Typical engUnit: CFM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirFlow. Typical engUnit: CFM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

HXAirPressureMetadata

Measurement fields for AirPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

HXLeakDetectMetadata

0 = No Leak, 1 = Leak. No engUnit.

0 = No Leak, 1 = Leak. No engUnit.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

HXAirRelativeHumidityMetadata

Measurement fields for AirRelativeHumidity. Typical engUnit: %RH. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirRelativeHumidity. Typical engUnit: %RH. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CRAHLiquidTemperatureMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

CRAHLiquidDifferentialPressureMetadata

Measurement fields for LiquidDifferentialPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for LiquidDifferentialPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CRAHLiquidFlowMetadata

Measurement fields for LiquidFlow. Typical engUnit: LPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for LiquidFlow. Typical engUnit: LPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CRAHLiquidPressureMetadata

Measurement fields for LiquidPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for LiquidPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CRAHStatusMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

CRAHAvailableMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

CRAHValvePositionMetadata

Measurement fields for ValvePosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for ValvePosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CRAHPumpSpeedMetadata

Measurement fields for PumpSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for PumpSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CRAHFanSpeedMetadata

Measurement fields for FanSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for FanSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CRAHDamperPositionMetadata

Measurement fields for DamperPosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for DamperPosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CRAHAirTemperatureMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

CRAHAirDifferentialPressureMetadata

Measurement fields for AirDifferentialPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirDifferentialPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CRAHAirFlowMetadata

Measurement fields for AirFlow. Typical engUnit: CFM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirFlow. Typical engUnit: CFM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CRAHAirPressureMetadata

Measurement fields for AirPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CRAHLeakDetectMetadata

0 = No Leak, 1 = Leak. No engUnit.

0 = No Leak, 1 = Leak. No engUnit.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

CRAHAirRelativeHumidityMetadata

Measurement fields for AirRelativeHumidity. Typical engUnit: %RH. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirRelativeHumidity. Typical engUnit: %RH. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CRACLiquidTemperatureMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

CRACLiquidDifferentialPressureMetadata

Measurement fields for LiquidDifferentialPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for LiquidDifferentialPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CRACLiquidFlowMetadata

Measurement fields for LiquidFlow. Typical engUnit: LPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for LiquidFlow. Typical engUnit: LPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CRACLiquidPressureMetadata

Measurement fields for LiquidPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for LiquidPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CRACStatusMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

CRACAvailableMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

CRACValvePositionMetadata

Measurement fields for ValvePosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for ValvePosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CRACPumpSpeedMetadata

Measurement fields for PumpSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for PumpSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CRACFanSpeedMetadata

Measurement fields for FanSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for FanSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CRACDamperPositionMetadata

Measurement fields for DamperPosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for DamperPosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CRACAirTemperatureMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

CRACAirDifferentialPressureMetadata

Measurement fields for AirDifferentialPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirDifferentialPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CRACAirFlowMetadata

Measurement fields for AirFlow. Typical engUnit: CFM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirFlow. Typical engUnit: CFM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CRACAirPressureMetadata

Measurement fields for AirPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

CRACLeakDetectMetadata

0 = No Leak, 1 = Leak. No engUnit.

0 = No Leak, 1 = Leak. No engUnit.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

CRACAirRelativeHumidityMetadata

Measurement fields for AirRelativeHumidity. Typical engUnit: %RH. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirRelativeHumidity. Typical engUnit: %RH. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

AHULiquidTemperatureMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

AHULiquidDifferentialPressureMetadata

Measurement fields for LiquidDifferentialPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for LiquidDifferentialPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

AHULiquidFlowMetadata

Measurement fields for LiquidFlow. Typical engUnit: LPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for LiquidFlow. Typical engUnit: LPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

AHULiquidPressureMetadata

Measurement fields for LiquidPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for LiquidPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

AHUStatusMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

AHUAvailableMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

AHUValvePositionMetadata

Measurement fields for ValvePosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for ValvePosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

AHUPumpSpeedMetadata

Measurement fields for PumpSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for PumpSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

AHUFanSpeedMetadata

Measurement fields for FanSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for FanSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

AHUDamperPositionMetadata

Measurement fields for DamperPosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for DamperPosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

AHUAirTemperatureMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

AHUAirDifferentialPressureMetadata

Measurement fields for AirDifferentialPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirDifferentialPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

AHUAirFlowMetadata

Measurement fields for AirFlow. Typical engUnit: CFM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirFlow. Typical engUnit: CFM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

AHUAirPressureMetadata

Measurement fields for AirPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

AHULeakDetectMetadata

0 = No Leak, 1 = Leak. No engUnit.

0 = No Leak, 1 = Leak. No engUnit.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

AHUAirRelativeHumidityMetadata

Measurement fields for AirRelativeHumidity. Typical engUnit: %RH. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirRelativeHumidity. Typical engUnit: %RH. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

ChillerLiquidTemperatureMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

ChillerLiquidDifferentialPressureMetadata

Measurement fields for LiquidDifferentialPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for LiquidDifferentialPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

ChillerLiquidFlowMetadata

Measurement fields for LiquidFlow. Typical engUnit: LPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for LiquidFlow. Typical engUnit: LPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

ChillerLiquidPressureMetadata

Measurement fields for LiquidPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for LiquidPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

ChillerStatusMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

ChillerAvailableMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

ChillerValvePositionMetadata

Measurement fields for ValvePosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for ValvePosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

ChillerPumpSpeedMetadata

Measurement fields for PumpSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for PumpSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

ChillerFanSpeedMetadata

Measurement fields for FanSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for FanSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

ChillerDamperPositionMetadata

Measurement fields for DamperPosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for DamperPosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

ChillerAirTemperatureMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

ChillerAirDifferentialPressureMetadata

Measurement fields for AirDifferentialPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirDifferentialPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

ChillerAirFlowMetadata

Measurement fields for AirFlow. Typical engUnit: CFM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirFlow. Typical engUnit: CFM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

ChillerAirPressureMetadata

Measurement fields for AirPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

ChillerLeakDetectMetadata

0 = No Leak, 1 = Leak. No engUnit.

0 = No Leak, 1 = Leak. No engUnit.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

ChillerAirRelativeHumidityMetadata

Measurement fields for AirRelativeHumidity. Typical engUnit: %RH. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirRelativeHumidity. Typical engUnit: %RH. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

TankLiquidTemperatureMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

TankLiquidDifferentialPressureMetadata

Measurement fields for LiquidDifferentialPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for LiquidDifferentialPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

TankLiquidFlowMetadata

Measurement fields for LiquidFlow. Typical engUnit: LPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for LiquidFlow. Typical engUnit: LPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

TankLiquidPressureMetadata

Measurement fields for LiquidPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for LiquidPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

TankStatusMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

TankAvailableMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

TankValvePositionMetadata

Measurement fields for ValvePosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for ValvePosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

TankPumpSpeedMetadata

Measurement fields for PumpSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for PumpSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

TankFanSpeedMetadata

Measurement fields for FanSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for FanSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

TankDamperPositionMetadata

Measurement fields for DamperPosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for DamperPosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

TankAirTemperatureMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

TankAirDifferentialPressureMetadata

Measurement fields for AirDifferentialPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirDifferentialPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

TankAirFlowMetadata

Measurement fields for AirFlow. Typical engUnit: CFM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirFlow. Typical engUnit: CFM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

TankAirPressureMetadata

Measurement fields for AirPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

TankLeakDetectMetadata

0 = No Leak, 1 = Leak. No engUnit.

0 = No Leak, 1 = Leak. No engUnit.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

TankAirRelativeHumidityMetadata

Measurement fields for AirRelativeHumidity. Typical engUnit: %RH. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirRelativeHumidity. Typical engUnit: %RH. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

GenericObjectLiquidTemperatureMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

GenericObjectLiquidDifferentialPressureMetadata

Measurement fields for LiquidDifferentialPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for LiquidDifferentialPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

GenericObjectLiquidFlowMetadata

Measurement fields for LiquidFlow. Typical engUnit: LPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for LiquidFlow. Typical engUnit: LPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

GenericObjectLiquidPressureMetadata

Measurement fields for LiquidPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for LiquidPressure. Typical engUnit: kPa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

GenericObjectStatusMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

GenericObjectAvailableMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

GenericObjectValvePositionMetadata

Measurement fields for ValvePosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for ValvePosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

GenericObjectPumpSpeedMetadata

Measurement fields for PumpSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for PumpSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

GenericObjectFanSpeedMetadata

Measurement fields for FanSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for FanSpeed. Typical engUnit: RPM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

GenericObjectDamperPositionMetadata

Measurement fields for DamperPosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for DamperPosition. Typical engUnit: %. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

GenericObjectAirTemperatureMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

GenericObjectAirDifferentialPressureMetadata

Measurement fields for AirDifferentialPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirDifferentialPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

GenericObjectAirFlowMetadata

Measurement fields for AirFlow. Typical engUnit: CFM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirFlow. Typical engUnit: CFM. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

GenericObjectAirPressureMetadata

Measurement fields for AirPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirPressure. Typical engUnit: Pa. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

GenericObjectSoundMetadata

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Optional fields common to all generic equipment metadata, regardless of identifier mode.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

GenericObjectLeakDetectMetadata

0 = No Leak, 1 = Leak. No engUnit.

0 = No Leak, 1 = Leak. No engUnit.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

GenericObjectAirRelativeHumidityMetadata

Measurement fields for AirRelativeHumidity. Typical engUnit: %RH. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Measurement fields for AirRelativeHumidity. Typical engUnit: %RH. The identifier (named-object XOR associate) and measurement (engUnit XOR stateText) constraints are independent and enforced by EquipmentMeasurementModeBase.

Requires a non-empty engUnit string (mutually exclusive with stateText).

NameTypeRequiredDescription
engUnitstringYesEngineering unit for the measurement.

Required for state/status/alarm points that carry no engineering unit.

NameTypeRequiredDescription
stateTextarray<map<string, any>>YesState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

GenericObjectLiquidTemperatureSpRequestMetadata

Setpoint request for a GenericObject. BMS publishes metadata; the integration publishes the value to the derived topic.

Setpoint request for a GenericObject. BMS publishes metadata; the integration publishes the value to the derived topic.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

GenericPointFields

Field fragment for a vendor-specific or unmapped GenericPoint. processArea is required.

engUnit and stateText are both optional but mutually exclusive — include at most one. See the two variants below.

Field fragment for a vendor-specific or unmapped GenericPoint. processArea is required.

engUnit and stateText are both optional but mutually exclusive — include at most one. See the two variants below.

Continuous measurement with a known engineering unit. When engUnit is prese…

NameTypeRequiredDescription
engUnitstringNoEngineering unit for the measurement.

Binary or enumerated state point. When stateText is present, engUnit must…

NameTypeRequiredDescription
stateTextarray<map<string, any>>NoState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).

GenericEquipmentPointMetadata

Field fragment for a vendor-specific or unmapped GenericPoint. processArea is required.

engUnit and stateText are both optional but mutually exclusive — include at most one. See the two variants below.

Field fragment for a vendor-specific or unmapped GenericPoint. processArea is required.

engUnit and stateText are both optional but mutually exclusive — include at most one. See the two variants below.

Object Mode

  • objectName and objectId are required.
  • servesId is optional in Named-object mode.
  • associateId must not be present.

Incompatible with EquipmentAssociateMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
objectNamestringYesHuman-readable equipment name.
objectIdstringYesStable unique identifier for the equipment.
servesIdarray<string>NoOptional list of objectIds of entities this equipment serves. Only valid in Named-object mode. Only valid in Named-object mode — must not appear in Associate mode.

Associate Mode

  • associateId is required.
  • objectName, objectId, and servesId must not be present.

Incompatible with EquipmentNamedObjectMode — validators enforce this via the parent oneOf.

NameTypeRequiredDescription
associateIdstringYesIdentifier of the associated entity.

GenericPowerMeterPointMetadata

Field fragment for a vendor-specific or unmapped GenericPoint. processArea is required.

engUnit and stateText are both optional but mutually exclusive — include at most one. See the two variants below.

Field fragment for a vendor-specific or unmapped GenericPoint. processArea is required.

engUnit and stateText are both optional but mutually exclusive — include at most one. See the two variants below.

Continuous measurement with a known engineering unit. When engUnit is prese…

NameTypeRequiredDescription
engUnitstringNoEngineering unit for the measurement.

Binary or enumerated state point. When stateText is present, engUnit must…

NameTypeRequiredDescription
stateTextarray<map<string, any>>NoState label mapping. Each entry maps a numeric state value to its human-readable label (e.g., [{value: 0, text: "Off"}, {value: 1, text: "On"}]).