Skip to content

Commit

Permalink
CHESTER: Add UDP MTU warnings with interval-report/aggreg
Browse files Browse the repository at this point in the history
Signed-off-by: hubmartin <[email protected]>
  • Loading branch information
hubmartin committed Apr 18, 2024
1 parent c1bd6c9 commit 6bc88ab
Show file tree
Hide file tree
Showing 2 changed files with 24 additions and 0 deletions.
16 changes: 16 additions & 0 deletions chester/catalog-applications/chester-clime.md
Original file line number Diff line number Diff line change
Expand Up @@ -74,6 +74,13 @@ The catalog application **CHESTER Clime IAQ** measures:
Also, the application reports **push-button events** and provides **acoustic** and **optical feedback**.
The **button LED** color also **signalizes CO₂ concentration levels**.

:::caution

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 mainboard
Expand All @@ -85,6 +92,8 @@ See [**Ordering Codes**](../ordering-codes.md) 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.
Expand Down Expand Up @@ -132,6 +141,13 @@ Firmware build shield options: `ctr_lrw ctr_lte ctr_rtd_a`
- 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`).

:::caution

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**.
Expand Down
8 changes: 8 additions & 0 deletions chester/catalog-applications/common-functionality.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,14 @@ app config interval-aggreg 300
app config interval-report 1800
```

:::caution

CHESTER sends in default the configuration about 500 bytes of data. If you increase the report interval too much 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.

:::


You can change configuration using the `app config` command, followed by `config save`. Example:

```
Expand Down

0 comments on commit 6bc88ab

Please sign in to comment.