Environment Profile (12000-12999)

Environmental sensor messages for weather conditions, temperature, humidity, and hall sensors.

These messages are used by devices reporting environmental sensor values.

Sensor Data Messages

Weather Info (12100)

Reports environmental conditions from the device’s sensors.

{
    "airp": Number,  // optional - air pressure in Pascals
    "humd": Number,  // optional - relative humidity %
    "temp": Number,  // optional - temperature °C
    "lght": Number   // optional - light level
}

Example:

{
    "airp": 102092.358,  // 1020 hPa
    "humd": 67.2,        // 67.2% relative humidity
    "temp": 22.5,        // 22.5°C
    "lght": 270          // Light level
}

Magneto Switch Info (12101)

Hall sensor for detecting doors, windows, or other magnetic field changes.

{
    "hall": Number,      // required - current state
    "hallCount": Number  // optional - state change count
}

Value	Meaning
`hall: 0`	Open
`hall: 1`	Closed

hallCount indicates state changes during the measurement period. For example, 2 means the sensor went A → B → A (one open/close cycle).

Leakage Resistance Data (12102)

ADC reading from a leakage detection sensor.

{
    "resistance": 1023
}

Configuration Messages

Environment Sensor Configuration (12200)

Configure multiple sensor behaviors at once. Sent with tsmEv: 30.

[{
    "tsmId": 12200,
    "transactionId": 199882211,
    "accelerometerMode": 0,
    "weatherMode": 0,
    "hallMode": 0,
    "leakageMode": 0
}]

Field	Values	Description
`accelerometerMode`	`0`: Disabled, `1`: Orientation, `2`: Machine monitoring	Accelerometer behavior
`weatherMode`	`-1`: Disabled, `0`: Report at interval	Weather sensor reporting
`hallMode`	`-1`: Disabled, `0`: Report at interval, `1`: Report changes only	Hall sensor reporting
`leakageMode`	`0`: Disabled, `1`: Report at interval	Leakage sensor reporting

Example - Read current configuration:

[{
    "tsmId": 12200,
    "tsmEv": 30,
    "tsmDstTuid": "TSPDXXSERIAL1",
    "transactionId": 2147
}]

Example - Change accelerometer mode:

[{
    "tsmId": 12200,
    "tsmEv": 30,
    "tsmDstTuid": "TSPDXXSERIAL1",
    "transactionId": 2147,
    "accelerometerMode": 2
}]

Weather Sensor Configuration (12210)

Fine-tune weather sensor behavior and thresholds.

[{
    "tsmId": 12210,
    "transactionId": 199882211,
    "intervalMultiplier": 1,
    "weatherMode": 1,
    "temperatureHysteresis": 0.5,
    "humidityHysteresis": 2,
    "pressureHysteresis": 20,
    "lightHysteresis": 100
}]

Field	Default	Description
`intervalMultiplier`	1	Multiply measurement interval
`weatherMode`	1	`0`: Disabled, `1`: Enabled with hysteresis
`temperatureHysteresis`	0.5	°C change threshold for immediate report
`humidityHysteresis`	2	RH% change threshold
`pressureHysteresis`	20	Pa change threshold
`lightHysteresis`	100	Light level change threshold

When weatherMode: 1, measurements are taken at the measurement interval. Significant changes (exceeding hysteresis thresholds) are reported immediately. Otherwise, values are reported at the reporting interval.

Magneto Switch Configuration (12211)

Configure hall sensor behavior.

[{
    "tsmId": 12211,
    "transactionId": 199882211,
    "intervalMultiplier": 1,
    "hallMode": 1
}]

Field	Default	Description
`intervalMultiplier`	1	Multiply measurement interval
`hallMode`	1	`0`: Disabled, `1`: Track and report state changes

Leakage Sensor Configuration (12212)

Configure leakage detection.

[{
    "tsmId": 12212,
    "transactionId": 199882211,
    "intervalMultiplier": 1,
    "leakageMode": 1,
    "resistanceHysteresis": 10000
}]

Field	Default	Description
`intervalMultiplier`	1	Multiply measurement interval
`leakageMode`	0	`0`: Disabled, `1`: Enabled
`resistanceHysteresis`	10000	Change threshold for immediate report