CHESTER Clime
This article describes the core functionality, hardware description, and example JSON message of the catalog application CHESTER Clime.
When upgrading firmware from v1.x.x to version v2.0.0 and newer - it is necessary to backup configuration.
Some of the basics are not provided, as they are common for all CHESTER catalog applications. For example, see the article Platform Management on how to work with the interactive console.
Application Overview
CHESTER Clime is an environmental sensor that samples, aggregates, and sends measured variables.
Application Variants
CHESTER Clime can be ordered in one of these variants:
CHESTER Clime
The catalog application CHESTER Clime measures:
- Temperature
- Humidity
The hardware of this application consists of the following ordering codes:
CHESTER-M-BCGLS- Standard mainboardCHESTER-S2- External hygrometerCHESTER-E1-LP- Enclosure with SMA pigtail
See Ordering Codes for more details.
Firmware build shield options: ctr_lrw ctr_lte ctr_s2
CHESTER Clime Z
The catalog application CHESTER Clime Z measures:
- Temperature
- Humidity
The hardware of this application consists of the following ordering codes:
CHESTER-M-BCGLS- Standard mainboardCHESTER-Z1- Backup moduleCHESTER-S2- External hygrometerCHESTER-E1-LP- Enclosure with SMA pigtail
See Ordering Codes for more details.
Firmware build shield options: ctr_lrw ctr_lte ctr_s2 ctr_z
CHESTER Clime IAQ
The catalog application CHESTER Clime IAQ measures:
- Temperature
- Humidity
- Illuminance
- CO₂ concentration
- Atmospheric pressure
- Motion detection with PIR sensor
Also, the application reports push-button events and provides acoustic and optical feedback. The button LED color also signalizes CO₂ concentration levels.
CHESTER IAQ sends in default the configuration about 800 bytes of data. If you increase the report interval without increasing also aggregation interval, the data buffer might be bigger than the UDP MTU and the packet will not be sent. Device then appears like it is not sending or sends only a fraction of packets.
The hardware of this application consists of the following ordering codes:
CHESTER-M-BCGLS- Standard mainboardCHESTER-S1-BCMP- Integrated multi-sensorCHESTER-X10- External power 6-28V with Li-Ion batteryCHESTER-E7-LP- Enclosure with SMA pigtail
See Ordering Codes for more details.
Firmware build shield options: ctr_lrw ctr_lte ctr_s1 ctr_x10
CHESTER Clime 1W
The catalog application CHESTER Clime 1W supports multiple external DS18B20 1-Wire temperature sensors.
The hardware of this application consists of the following ordering codes:
CHESTER-M-BCGLS- Standard mainboardCHESTER-E8-LP- Enclosure with 8 cable glands (RM8L-4S)
See Ordering Codes for more details.
Firmware build shield options: ctr_lrw ctr_lte ctr_ds18b20
CHESTER Clime 1WH
The catalog application CHESTER Clime 1WH supports CHESTER-S2 + multiple external DS18B20 1-Wire temperature sensors.
The hardware of this application consists of the following ordering codes:
CHESTER-M-BCGLS- Standard mainboardCHESTER-S2- External hygrometerCHESTER-E8-LP- Enclosure with 8 cable glands (RM8L-4S)
See Ordering Codes for more details.
Firmware build shield options: ctr_lrw ctr_lte ctr_ds18b20 ctr_s2
CHESTER Clime RTD
The catalog application CHESTER Clime RTD supports two external Pt1000 4-wire temperature sensors.
The hardware of this application consists of the following ordering codes:
CHESTER-M-BCGLS- Standard mainboardCHESTER-X3A:A- 2x Pt100/Pt1000 interfaceCHESTER-E13-LP- Enclosure with SMA pigtail and 2 cable PG7 glands
See Ordering Codes for more details.
Firmware build shield options: ctr_lrw ctr_lte ctr_rtd_a
CHESTER Clime TC
The catalog application CHESTER Clime TC supports two external type K thermocouple sensors.
The hardware of this application consists of the following ordering codes:
CHESTER-M-BCGLS- Standard mainboardCHESTER-X3B:A- 2x Type K thermocouple interfaceCHESTER-E13-LP- Enclosure with SMA pigtail and 2 cable PG7 glands
See Ordering Codes for more details.
Firmware build shield options: ctr_lrw ctr_lte ctr_tc_a
Measurement and Behavior
- All sensors are sampled with a configurable period (parameter
interval-sample). - Samples are then aggregated in the configurable interval. Minimum, maximum, average, and median are computed from buffered samples for each sensor (parameter
interval-aggreg). - Each aggregated values have its timestamps and are sent in a batch in a report interval period (parameter
interval-report).
CHESTER Clime sends in default the configuration about 500 bytes of data. If you increase the report interval without increasing also aggregation interval, the data buffer might be bigger than the UDP MTU and the packet will not be sent. Device then appears like it is not sending or sends only a fraction of packets.
When equipped with CHESTER-S1. The device also has a push button. When the button is pressed, the blue LED turns on for a second. Also, the beep sound is played from the integrated acoustic buzzer for audible confirmation of the push button press.
Also, the button on the optional CHESTER-S1 by its color reports the state of the CO₂ by green (levels are ok), orange (warning) and red (alarm) thresholds. The button blinks shortly every 5 seconds when powered from a battery and it is permanently on when external power on X10 is applied. Threshold levels and hysteresis are configurable.
Default Configuration
This is the default configuration (printed using the app config show command):
app config interval-sample 60
app config interval-aggreg 300
app config interval-report 1800
Default configuration for hygrometer alarms:
app config hygro-t-alarm-hi-report false
app config hygro-t-alarm-lo-report false
app config hygro-t-alarm-hi-thr 0.0
app config hygro-t-alarm-hi-hst 0.0
app config hygro-t-alarm-lo-thr 0.0
app config hygro-t-alarm-lo-hst 0.0
When equipped with backup (CHESTER-Z1) or hygrometer (CHESTER-S2):
app config event-report-delay 1
app config event-report-rate 30
When equipped with IAQ (CHESTER-S1) you can change CO₂ thresholds and hysteresis which are signalized by button LED color:
app config iaq-led-thr-warning 800.0
app config iaq-led-thr-alarm 1600.0
app config iaq-led-hst 50.0
When equipped with backup (CHESTER-Z1) or external power (CHESTER-X10), you can immediately report changes of the external power events:
app config backup-report-connected true
app config backup-report-disconnected true
Specific Commands
You can easily explore the whole command tree structure - start with the help command.
To apply a new configuration, you need to call config save, which applies the new configuration parameters and reboots the device.
Command to set sample interval in seconds:
app config interval-sample <1-86400>
Command to set aggregate interval in seconds:
app config interval-aggreg <1-86400>
Command to set report interval in seconds:
app config interval-report <30-86400>
Command to enable hygrometer high/low temperature alarm reports:
app config hygro-t-alarm-hi-report false
app config hygro-t-alarm-lo-report false
Command to set hygrometer high/low temperature thresholds in °C:
app config hygro-t-alarm-hi-thr <-40.0..125.0>
app config hygro-t-alarm-lo-thr <-40.0..125.0>
Command to set hygrometer high/low temperature hysteresis in °C:
app config hygro-t-alarm-hi-hst <0.0..100.0>
app config hygro-t-alarm-lo-hst <0.0..100.0>
Command to set the delay between the event and report in seconds (temperature alarm, backup state change):
app config event-report-delay <1-86400>
Command to set the report rate in reports per hour (just for event reports, periodic reports are not counter to this limit):
app config event-report-rate <1-3600>
CHESTER Clime BLE Tag subsystem
The catalog application CHESTER Clime Tag supports up to 8 Teltonika EYE Sensor Bluetooth tags that report temperature and humidity. This subsystem can be activated by following command:
tag config enabled true
After enabling the subsystem, save the configuration in order to restart CHESTER and start the subsystem:
config save
To use these sensors, the device must enroll them first. To enroll a tag, place it in very close proximity to CHESTER, run the following command and wait up to 10 seconds for the device to be discovered.
tag enroll
A optional signal strength threshold (from -128 to 0dbm, -128dbm providing the most range, -40dbm being the default) can be specified to make the enrollment less/more strict.
tag enroll <threshold>
To make the enrollment of these devices permanent, save them to the configuration with command.
config save
Tag configuration:
The packaged sensor should come activated. In case it is not, a magnet must touch the sensor to wake it up from hibernation mode.
The tags can be configured using the EYE APP. We highly suggest updating the tag firmware as the default firmware does not allow some settings.
To configure the device, select it from the list of devices and change the options. The device name, address and serial number are available for the Android version of the application, the IOS version has limited knowledge of the devices.
The suggested configuration is:
| Setting | Value |
|---|---|
| Power signal settings | 4dbm |
| Advertising interval | 10s |
| Active sensors | Temperature, Humidity |
Setup tips:
The working distance between CHESTER and the Teltonika sensors depends on the signal power configuration of the sensor. To test the signal strength at the distance, run the following command and look at the rssi value:
tag read
If the signal strength is lower than -85 dbm, consider boosting the signal power to assure reliable communication.
Firmware
When upgrading firmware from v1.x.x to version v2.0.0 and newer - it is necessary to backup configuration.
The latest firmware is available in the Catalog Applications Firmware chapter.
Example JSON Message
In this example JSON you can see data from all three variants
- CHESTER Clime has its own
hygrometerstructure. - CHESTER Clime IAQ has its own
iaq_sensorstructure. - CHESTER Clime 1W has its own
w1_thermometersstructure. - CHESTER Clime RTD has its own
rtd_thermometersstructure. - CHESTER Clime with backup option (CHESTER-Z1 or CHESTER-X10) has
backupwith external and internal voltages, state and events.
Backup events are:
connecteddisconnected
Hygrometer events are:
alarm_hi_activatedalarm_hi_deactivatedalarm_lo_activatedalarm_lo_deactivated
In each structure with the current configuration, there are six aggregated values. Each aggregated value has its timestamp and is computed from multiple samples, and min, max, avg, and mdn values are calculated.
{
"message": {
"version": 1,
"sequence": 0,
"timestamp": 1668859482
},
"attribute": {
"vendor_name": "HARDWARIO",
"product_name": "CHESTER-M",
"hw_variant": "CGLS",
"hw_revision": "R3.2",
"fw_name": "CHESTER Clime",
"fw_version": "v1.4.0",
"serial_number": "2159018267"
},
"system": {
"uptime": 680967,
"voltage_rest": 3.7,
"voltage_load": 3.66,
"current_load": 36
},
"backup": {
"line_voltage": 24.01,
"batt_voltage": 4.09,
"state": "connected",
"events": [
{
"timestamp": 1668858942,
"type": "connected"
}
]
},
"network": {
"imei": 351358815180770,
"imsi": 901288910018982,
"parameter": {
"eest": 7,
"ecl": 0,
"rsrp": -90,
"rsrq": -8,
"snr": 9,
"plmn": 23003,
"cid": 939040,
"band": 20,
"earfcn": 6447
}
},
"thermometer": {
"temperature": 22.18
},
"accelerometer": {
"acceleration_x": 0.07,
"acceleration_y": -0.16,
"acceleration_z": 9.65,
"orientation": 2
},
"iaq_sensor": {
"temperature": {
"measurements": [
{
"timestamp": 1668857742,
"min": 22.5,
"max": 22.54,
"avg": 22.51,
"mdn": 22.52
},
{
"timestamp": 1668858042,
"min": 22.49,
"max": 22.5,
"avg": 22.49,
"mdn": 22.49
},
{
"timestamp": 1668858342,
"min": 22.47,
"max": 22.48,
"avg": 22.47,
"mdn": 22.47
},
{
"timestamp": 1668858642,
"min": 22.47,
"max": 22.49,
"avg": 22.48,
"mdn": 22.48
},
{
"timestamp": 1668858942,
"min": 22.46,
"max": 22.5,
"avg": 22.48,
"mdn": 22.48
},
{
"timestamp": 1668859242,
"min": 22.45,
"max": 22.47,
"avg": 22.46,
"mdn": 22.47
}
]
},
"humidity": {
"measurements": [
{
"timestamp": 1668857742,
"min": 55.19,
"max": 55.91,
"avg": 55.52,
"mdn": 55.53
},
{
"timestamp": 1668858042,
"min": 55.84,
"max": 56.5,
"avg": 56.14,
"mdn": 56.07
},
{
"timestamp": 1668858342,
"min": 56.01,
"max": 56.2,
"avg": 56.09,
"mdn": 56.07
},
{
"timestamp": 1668858642,
"min": 55.55,
"max": 56.1,
"avg": 55.79,
"mdn": 55.74
},
{
"timestamp": 1668858942,
"min": 55.39,
"max": 55.86,
"avg": 55.6,
"mdn": 55.59
},
{
"timestamp": 1668859242,
"min": 55.1,
"max": 56.29,
"avg": 55.69,
"mdn": 55.61
}
]
},
"illuminance": {
"measurements": [
{
"timestamp": 1668857742,
"min": 4,
"max": 5,
"avg": 4,
"mdn": 4
},
{
"timestamp": 1668858042,
"min": 4,
"max": 6,
"avg": 4,
"mdn": 5
},
{
"timestamp": 1668858342,
"min": 5,
"max": 5,
"avg": 5,
"mdn": 5
},
{
"timestamp": 1668858642,
"min": 4,
"max": 6,
"avg": 5,
"mdn": 5
},
{
"timestamp": 1668858942,
"min": 5,
"max": 7,
"avg": 5,
"mdn": 6
},
{
"timestamp": 1668859242,
"min": 4,
"max": 5,
"avg": 4,
"mdn": 5
}
]
},
"altitude": {
"measurements": [
{
"timestamp": 1668857742,
"min": 244,
"max": 245,
"avg": 244,
"mdn": 244
},
{
"timestamp": 1668858042,
"min": 244,
"max": 245,
"avg": 244,
"mdn": 245
},
{
"timestamp": 1668858342,
"min": 244,
"max": 245,
"avg": 244,
"mdn": 245
},
{
"timestamp": 1668858642,
"min": 244,
"max": 245,
"avg": 244,
"mdn": 244
},
{
"timestamp": 1668858942,
"min": 244,
"max": 245,
"avg": 244,
"mdn": 244
},
{
"timestamp": 1668859242,
"min": 244,
"max": 245,
"avg": 244,
"mdn": 244
}
]
},
"pressure": {
"measurements": [
{
"timestamp": 1668857742,
"min": 98419,
"max": 98425,
"avg": 98422,
"mdn": 98423
},
{
"timestamp": 1668858042,
"min": 98415,
"max": 98418,
"avg": 98416,
"mdn": 98416
},
{
"timestamp": 1668858342,
"min": 98412,
"max": 98417,
"avg": 98414,
"mdn": 98415
},
{
"timestamp": 1668858642,
"min": 98417,
"max": 98422,
"avg": 98419,
"mdn": 98418
},
{
"timestamp": 1668858942,
"min": 98416,
"max": 98421,
"avg": 98419,
"mdn": 98421
},
{
"timestamp": 1668859242,
"min": 98416,
"max": 98422,
"avg": 98419,
"mdn": 98420
}
]
},
"co2_conc": {
"measurements": [
{
"timestamp": 1668857742,
"min": 399,
"max": 400,
"avg": 399,
"mdn": 400
},
{
"timestamp": 1668858042,
"min": 399,
"max": 400,
"avg": 399,
"mdn": 399
},
{
"timestamp": 1668858342,
"min": 399,
"max": 400,
"avg": 399,
"mdn": 400
},
{
"timestamp": 1668858642,
"min": 399,
"max": 400,
"avg": 399,
"mdn": 399
},
{
"timestamp": 1668858942,
"min": 398,
"max": 399,
"avg": 398,
"mdn": 399
},
{
"timestamp": 1668859242,
"min": 399,
"max": 400,
"avg": 399,
"mdn": 399
}
]
},
"motion_count": {
"measurements": [
{
"timestamp": 1668857742,
"value": 0
},
{
"timestamp": 1668858042,
"value": 0
},
{
"timestamp": 1668858342,
"value": 0
},
{
"timestamp": 1668858642,
"value": 0
},
{
"timestamp": 1668858942,
"value": 0
},
{
"timestamp": 1668859242,
"value": 0
}
]
},
"press_count": {
"measurements": [
{
"timestamp": 1668857742,
"value": 0
},
{
"timestamp": 1668858042,
"value": 0
},
{
"timestamp": 1668858342,
"value": 0
},
{
"timestamp": 1668858642,
"value": 0
},
{
"timestamp": 1668858942,
"value": 0
},
{
"timestamp": 1668859242,
"value": 0
}
]
}
},
"hygrometer": {
"temperature": {
"events": [
{
"timestamp": 1668858343,
"type": "alarm_lo_deactivated",
"value": 20.94
}
],
"measurements": [
{
"timestamp": 1668857742,
"min": 22.07,
"max": 22.25,
"avg": 22.17,
"mdn": 22.16
},
{
"timestamp": 1668858042,
"min": 22.05,
"max": 22.23,
"avg": 22.15,
"mdn": 22.15
},
{
"timestamp": 1668858342,
"min": 22.04,
"max": 22.16,
"avg": 22.09,
"mdn": 22.07
},
{
"timestamp": 1668858642,
"min": 22.08,
"max": 22.19,
"avg": 22.11,
"mdn": 22.09
},
{
"timestamp": 1668858942,
"min": 22.07,
"max": 22.16,
"avg": 22.12,
"mdn": 22.12
},
{
"timestamp": 1668859242,
"min": 22.07,
"max": 22.15,
"avg": 22.12,
"mdn": 22.14
}
]
},
"humidity": {
"measurements": [
{
"timestamp": 1668857742,
"min": 54.78,
"max": 55.31,
"avg": 55.1,
"mdn": 55.12
},
{
"timestamp": 1668858042,
"min": 55.12,
"max": 56.16,
"avg": 55.55,
"mdn": 55.52
},
{
"timestamp": 1668858342,
"min": 55.24,
"max": 55.56,
"avg": 55.41,
"mdn": 55.4
},
{
"timestamp": 1668858642,
"min": 54.89,
"max": 56.03,
"avg": 55.33,
"mdn": 55.2
},
{
"timestamp": 1668858942,
"min": 54.75,
"max": 56.73,
"avg": 55.39,
"mdn": 54.98
},
{
"timestamp": 1668859242,
"min": 54.91,
"max": 55.83,
"avg": 55.26,
"mdn": 55.18
}
]
}
},
"w1_thermometers": [
{
"serial_number": 170787196,
"measurements": [
{
"timestamp": 1668857742,
"min": 22.18,
"max": 22.25,
"avg": 22.23,
"mdn": 22.25
},
{
"timestamp": 1668858042,
"min": 22.18,
"max": 22.18,
"avg": 22.18,
"mdn": 22.18
},
{
"timestamp": 1668858342,
"min": 22.18,
"max": 22.18,
"avg": 22.18,
"mdn": 22.18
},
{
"timestamp": 1668858642,
"min": 22.12,
"max": 22.18,
"avg": 22.17,
"mdn": 22.18
},
{
"timestamp": 1668858942,
"min": 22.18,
"max": 22.18,
"avg": 22.18,
"mdn": 22.18
},
{
"timestamp": 1668859242,
"min": 22.18,
"max": 22.18,
"avg": 22.18,
"mdn": 22.18
}
]
}
],
"rtd_thermometers": [
{
"channel": 1,
"measurements": [
{
"timestamp": 1668857742,
"min": 22.18,
"max": 22.25,
"avg": 22.23,
"mdn": 22.25
},
{
"timestamp": 1668858042,
"min": 22.18,
"max": 22.18,
"avg": 22.18,
"mdn": 22.18
},
{
"timestamp": 1668858342,
"min": 22.18,
"max": 22.18,
"avg": 22.18,
"mdn": 22.18
},
{
"timestamp": 1668858642,
"min": 22.12,
"max": 22.18,
"avg": 22.17,
"mdn": 22.18
},
{
"timestamp": 1668858942,
"min": 22.18,
"max": 22.18,
"avg": 22.18,
"mdn": 22.18
},
{
"timestamp": 1668859242,
"min": 22.18,
"max": 22.18,
"avg": 22.18,
"mdn": 22.18
}
]
},
{
"channel": 2,
"measurements": [
{
"timestamp": 1668857742,
"min": 22.18,
"max": 22.25,
"avg": 22.23,
"mdn": 22.25
},
{
"timestamp": 1668858042,
"min": 22.18,
"max": 22.18,
"avg": 22.18,
"mdn": 22.18
},
{
"timestamp": 1668858342,
"min": 22.18,
"max": 22.18,
"avg": 22.18,
"mdn": 22.18
},
{
"timestamp": 1668858642,
"min": 22.12,
"max": 22.18,
"avg": 22.17,
"mdn": 22.18
},
{
"timestamp": 1668858942,
"min": 22.18,
"max": 22.18,
"avg": 22.18,
"mdn": 22.18
},
{
"timestamp": 1668859242,
"min": 22.18,
"max": 22.18,
"avg": 22.18,
"mdn": 22.18
}
]
}
],
"ble_tags": [
{
"addr": "1234567890AB",
"rssi": -81,
"voltage": 3.11,
"humidity": {
"measurements": [
{
"timestamp": 1668857742,
"min": 54.78,
"max": 55.31,
"avg": 55.1,
"mdn": 55.12
},
{
"timestamp": 1668858042,
"min": 55.12,
"max": 56.16,
"avg": 55.55,
"mdn": 55.52
}
]
},
"temperature": {
"measurements": [
{
"timestamp": 1668857742,
"min": 22.18,
"max": 22.25,
"avg": 22.23,
"mdn": 22.25
},
{
"timestamp": 1668858042,
"min": 22.18,
"max": 22.18,
"avg": 22.18,
"mdn": 22.18
}
]
}
},
{
"addr": "BA0987654321",
"rssi": -77,
"voltage": 3.11,
"humidity": {
"measurements": [
{
"timestamp": 1668857742,
"min": 54.78,
"max": 55.31,
"avg": 55.1,
"mdn": 55.12
},
{
"timestamp": 1668858042,
"min": 55.12,
"max": 56.16,
"avg": 55.55,
"mdn": 55.52
}
]
},
"temperature": {
"measurements": [
{
"timestamp": 1668857742,
"min": 22.18,
"max": 22.25,
"avg": 22.23,
"mdn": 22.25
},
{
"timestamp": 1668858042,
"min": 22.18,
"max": 22.18,
"avg": 22.18,
"mdn": 22.18
}
]
}
}
]
}