Skip to main content

CHESTER Clime

This article describes the core functionality, hardware description, and example JSON message of the catalog application CHESTER Clime.

danger

When upgrading firmware from v1.x.x to version v2.0.0 and newer - it is necessary to backup configuration.

caution

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 mainboard
  • CHESTER-S2 - External hygrometer
  • CHESTER-E1-LP - Enclosure with SMA pigtail

See Ordering Codes for more details.

Firmware build shield options: 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 mainboard
  • CHESTER-Z - Backup module
  • CHESTER-S2 - External hygrometer
  • CHESTER-E1-LP - Enclosure with SMA pigtail

See Ordering Codes for more details.

Firmware build shield options: 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 hardware of this application consists of the following ordering codes:

  • CHESTER-M-BCGLS - Standard mainboard
  • CHESTER-S1-BCMP - Integrated multi-sensor
  • CHESTER-E7-LP - Enclosure with SMA pigtail

See Ordering Codes for more details.

Firmware build shield options: ctr_lte ctr_s1

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 mainboard
  • CHESTER-E8-LP - Enclosure with 8 cable glands (RM8L-4S)

See Ordering Codes for more details.

Firmware build shield options: 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 mainboard
  • CHESTER-S2 - External hygrometer
  • CHESTER-E8-LP - Enclosure with 8 cable glands (RM8L-4S)

See Ordering Codes for more details.

Firmware build shield options: 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 mainboard
  • CHESTER-X3A:A - 2x Pt100/Pt1000 interface
  • CHESTER-E13-LP - Enclosure with SMA pigtail and 2 cable PG7 glands

See Ordering Codes for more details.

Firmware build shield options: ctr_lte ctr_rtd_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).

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.

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-Z) or hygrometer (CHESTER-S2):

app config event-report-delay 1
app config event-report-rate 30

Specific Commands

info

You can easily explore the whole command tree structure - start with the help command.

caution

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>

Firmware

danger

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 Catalog Applications Firmware chapter.

Example JSON Message

In this example JSON you can see data from all three variants

  • CHESTER Clime has its own hygrometer structure.
  • CHESTER Clime IAQ has its own iaq_sensor structure.
  • CHESTER Clime 1W has its own w1_thermometers structure.
  • CHESTER Clime RTD has its own rtd_thermometers structure.

Hygrometer events are:

  • alarm_hi_activated
  • alarm_hi_deactivated
  • alarm_lo_activated
  • alarm_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
},
"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
}
]
}
]
}