enPact Device MQTT API 1.0.0 documentation

enPact Device MQTT API 1.0.0

application/json

Overview

This API provides real-time telemetry data from enPact N4-2 IoT devices connected to the Enpact cloud platform. The devices are temperature monitoring and relay control units that publish their state periodically via MQTT.

Connection Details

Broker: partners.iot.enpact.cloud
Port: 8883 (MQTT over TLS)
Authentication: Mutual TLS (mTLS)

Certificate Requirements

To connect, you need the following files:

CA Certificate: Root CA certificate (AmazonRootCA1.pem)
Client Certificate: Your device certificate (.crt file)
Private Key: Your private key (.key file)

Example Connection (mosquitto)

mosquitto_sub -h partners.iot.enpact.cloud -p 8883 \
  --cafile AmazonRootCA1.pem \
  --cert your-certificate.pem.crt \
  --key your-private.pem.key \
  -t 'es-lite/#' -v

Device Identification

Devices are identified by their MAC address, with IDs following the pattern: esl-n4-2-{macAddress} (e.g., esl-n4-2-fc012cdac244)

esl - enPact product identifier
n4-2 - Hardware/firmware version
{macAddress} - 12-character hexadecimal MAC address

Sensor & Field Reference

Field	Description
`tc`	MCU (microcontroller) temperature
`t1`	Coolant In temperature
`t2`	Coolant Out temperature
`t3`	Space temperature
`t4`	Aux/Product temperature
`ta`	Average temperature
`p`	Energy Saver mode active
`r1`	Compressor Energy Saver mode (true = saving energy)
`r2`	Fan Allowed To Run (true = allowed, false = disabled)

Notes

Temperature values are in degrees Celsius
Negative temperatures (around -50 to -60) typically indicate a disconnected or faulty sensor
To connect, customers must request a certificate bundle from enPact Support

Servers

mqtt://partners.iot.enpact.cloud:8883/mqtt 3.1.1production
enPact IoT Cloud MQTT Broker
Security:
X509:
Mutual TLS (mTLS) authentication.

Required files (provided by enPact Support):

Root CA certificate

Client certificate

Private key
#production

Operations

RECEIVE es-lite/{deviceId}/state
Receives real-time state updates from enPact devices. Each device publishes its current sensor readings and relay states periodically.

Subscribe to receive state updates from a specific device
Subscribe to this operation to receive periodic state updates from a specific enPact device. Messages are published approximately every few seconds when the device is online.

Operation IDreceiveDeviceState
Available only on servers:
- production
object
deviceId
required
string
Unique device identifier in the format esl-n4-2-{macAddress}. Example: esl-n4-2-fc012cdac244

Examples values:
"esl-n4-2-fc012cdac244"
"esl-n4-2-30eda0216d8c"
"esl-n4-2-8cbfea84bb84"
Message format:
Device State Message
Current state of an enPact device including temperatures and relay status
application/json
Message IDstateMessage
object [Device State]
Telemetry data from an enPact temperature monitoring device

p
required
boolean
Indicates the device operating mode. When true, the device will attempt energy-saving control when appropriate. When false, the device is in passive monitoring mode (temperatures only, no control).

Examples values:
true
false
tc
required
number
format: float
Internal temperature of the device's microcontroller (MCU) in degrees Celsius. Useful for monitoring device health and detecting overheating.

Examples values:
26.1
25.5
t1
required
number
format: float
Temperature of the coolant entering the system, in degrees Celsius. Negative values (typically -50 to -60) indicate a disconnected or faulty sensor.

Examples values:
22.5
-55.4
t2
required
number
format: float
Temperature of the coolant exiting the system, in degrees Celsius. The difference between t2 and t1 indicates heat transfer efficiency.

Examples values:
22.2
20.8
t3
required
number
format: float
Ambient/space temperature being monitored, in degrees Celsius. This is typically the temperature of the controlled environment.

Examples values:
23.8
22.2
t4
required
number
format: float
Auxiliary or product temperature sensor reading, in degrees Celsius. Can be used for monitoring specific product temperatures. Negative values indicate a disconnected or faulty sensor.

Examples values:
23.5
-51.3
ta
number
format: float
Calculated average temperature from the connected sensors.

Examples values:
23
21.9
r1
required
boolean
Compressor Energy Saver mode state. true = compressor energy saver mode is enabled (saving energy). false = compressor energy saver mode is disabled (normal operation).

Examples values:
false
true
r2
required
boolean
Fan operation permission state. true = fan is allowed to run. false = fan is being disabled.

Examples values:
true
false
Additional properties are allowed.
Examples
#1 Example - Energy saver active
Device with energy saver enabled, all sensors connected
{ "p": true, "tc": 26.1, "t1": 22.5, "t2": 22.2, "t3": 23.8, "t4": 23.5, "ta": 23, "r1": false, "r2": true }

#2 Example - Disconnected coolant sensor
Device with coolant-in sensor disconnected (negative reading)
{ "p": true, "tc": 25.5, "t1": -55.4, "t2": 20.8, "t3": 22.2, "t4": 23.5, "ta": 21.9, "r1": false, "r2": true }

#3 Example - Energy saver disabled
Energy saver off, compressor energy saver active
{ "p": false, "tc": 24.8, "t1": -46.6, "t2": 35.7, "t3": 19.3, "t4": 34, "r1": true, "r2": true }
RECEIVE es-lite/#
Subscribe to this topic pattern to receive state updates from all enPact devices. Useful for monitoring the entire device fleet.

Subscribe to receive state updates from all devices
Subscribe using the wildcard topic es-lite/# to monitor all devices simultaneously. Useful for dashboards and fleet monitoring applications.

Operation IDreceiveAllDeviceStates
Available only on servers:
- production
Message format:
Device State Message
Current state of an enPact device including temperatures and relay status
application/json
Message IDstateMessage
object [Device State]
Telemetry data from an enPact temperature monitoring device

p
required
boolean
Indicates the device operating mode. When true, the device will attempt energy-saving control when appropriate. When false, the device is in passive monitoring mode (temperatures only, no control).

Examples values:
true
false
tc
required
number
format: float
Internal temperature of the device's microcontroller (MCU) in degrees Celsius. Useful for monitoring device health and detecting overheating.

Examples values:
26.1
25.5
t1
required
number
format: float
Temperature of the coolant entering the system, in degrees Celsius. Negative values (typically -50 to -60) indicate a disconnected or faulty sensor.

Examples values:
22.5
-55.4
t2
required
number
format: float
Temperature of the coolant exiting the system, in degrees Celsius. The difference between t2 and t1 indicates heat transfer efficiency.

Examples values:
22.2
20.8
t3
required
number
format: float
Ambient/space temperature being monitored, in degrees Celsius. This is typically the temperature of the controlled environment.

Examples values:
23.8
22.2
t4
required
number
format: float
Auxiliary or product temperature sensor reading, in degrees Celsius. Can be used for monitoring specific product temperatures. Negative values indicate a disconnected or faulty sensor.

Examples values:
23.5
-51.3
ta
number
format: float
Calculated average temperature from the connected sensors.

Examples values:
23
21.9
r1
required
boolean
Compressor Energy Saver mode state. true = compressor energy saver mode is enabled (saving energy). false = compressor energy saver mode is disabled (normal operation).

Examples values:
false
true
r2
required
boolean
Fan operation permission state. true = fan is allowed to run. false = fan is being disabled.

Examples values:
true
false
Additional properties are allowed.
Examples
#1 Example - Energy saver active
Device with energy saver enabled, all sensors connected
{ "p": true, "tc": 26.1, "t1": 22.5, "t2": 22.2, "t3": 23.8, "t4": 23.5, "ta": 23, "r1": false, "r2": true }

#2 Example - Disconnected coolant sensor
Device with coolant-in sensor disconnected (negative reading)
{ "p": true, "tc": 25.5, "t1": -55.4, "t2": 20.8, "t3": 22.2, "t4": 23.5, "ta": 21.9, "r1": false, "r2": true }

#3 Example - Energy saver disabled
Energy saver off, compressor energy saver active
{ "p": false, "tc": 24.8, "t1": -46.6, "t2": 35.7, "t3": 19.3, "t4": 34, "r1": true, "r2": true }

Messages

#1Device State Message
Current state of an enPact device including temperatures and relay status
- application/json
Message IDDeviceStateMessage
object [Device State]
Telemetry data from an enPact temperature monitoring device

p
required
boolean
Indicates the device operating mode. When true, the device will attempt energy-saving control when appropriate. When false, the device is in passive monitoring mode (temperatures only, no control).

Examples values:
true
false
tc
required
number
format: float
Internal temperature of the device's microcontroller (MCU) in degrees Celsius. Useful for monitoring device health and detecting overheating.

Examples values:
26.1
25.5
t1
required
number
format: float
Temperature of the coolant entering the system, in degrees Celsius. Negative values (typically -50 to -60) indicate a disconnected or faulty sensor.

Examples values:
22.5
-55.4
t2
required
number
format: float
Temperature of the coolant exiting the system, in degrees Celsius. The difference between t2 and t1 indicates heat transfer efficiency.

Examples values:
22.2
20.8
t3
required
number
format: float
Ambient/space temperature being monitored, in degrees Celsius. This is typically the temperature of the controlled environment.

Examples values:
23.8
22.2
t4
required
number
format: float
Auxiliary or product temperature sensor reading, in degrees Celsius. Can be used for monitoring specific product temperatures. Negative values indicate a disconnected or faulty sensor.

Examples values:
23.5
-51.3
ta
number
format: float
Calculated average temperature from the connected sensors.

Examples values:
23
21.9
r1
required
boolean
Compressor Energy Saver mode state. true = compressor energy saver mode is enabled (saving energy). false = compressor energy saver mode is disabled (normal operation).

Examples values:
false
true
r2
required
boolean
Fan operation permission state. true = fan is allowed to run. false = fan is being disabled.

Examples values:
true
false
Additional properties are allowed.

Schemas

object [Device State]
Telemetry data from an enPact temperature monitoring device

p
required
boolean
Indicates the device operating mode. When true, the device will attempt energy-saving control when appropriate. When false, the device is in passive monitoring mode (temperatures only, no control).

Examples values:
true
false
tc
required
number
format: float
Internal temperature of the device's microcontroller (MCU) in degrees Celsius. Useful for monitoring device health and detecting overheating.

Examples values:
26.1
25.5
t1
required
number
format: float
Temperature of the coolant entering the system, in degrees Celsius. Negative values (typically -50 to -60) indicate a disconnected or faulty sensor.

Examples values:
22.5
-55.4
t2
required
number
format: float
Temperature of the coolant exiting the system, in degrees Celsius. The difference between t2 and t1 indicates heat transfer efficiency.

Examples values:
22.2
20.8
t3
required
number
format: float
Ambient/space temperature being monitored, in degrees Celsius. This is typically the temperature of the controlled environment.

Examples values:
23.8
22.2
t4
required
number
format: float
Auxiliary or product temperature sensor reading, in degrees Celsius. Can be used for monitoring specific product temperatures. Negative values indicate a disconnected or faulty sensor.

Examples values:
23.5
-51.3
ta
number
format: float
Calculated average temperature from the connected sensors.

Examples values:
23
21.9
r1
required
boolean
Compressor Energy Saver mode state. true = compressor energy saver mode is enabled (saving energy). false = compressor energy saver mode is disabled (normal operation).

Examples values:
false
true
r2
required
boolean
Fan operation permission state. true = fan is allowed to run. false = fan is being disabled.

Examples values:
true
false
Additional properties are allowed.

Overview

Connection Details

Certificate Requirements

Example Connection (mosquitto)

Device Identification

Sensor & Field Reference

Notes

Servers

Security:

Operations

RECEIVE es-lite/{deviceId}/state

Examples

#1 Example - Energy saver active

#2 Example - Disconnected coolant sensor