Skip to content

Sensor battery states

gary edited this page Feb 7, 2024 · 8 revisions

Sensor battery state reporting

The Ecowitt Gateway driver includes sensor battery state levels in emitted loop packets. The Ecowitt Gateway driver also displays sensor battery state levels when run directly using the --sensors, --live-data, --test-driver and --test-service command line options. The sensor battery state values reported by the driver vary from sensor to sensor and must be interpreted accordingly to determine the correct sensor battery state.

The following table details the sensor battery state levels reported by the Ecowitt Gateway driver along with possible outputs and low battery indication values.

Sensor Default loop packet field1 Driver output Low battery indication Remarks
WH24 wh24_batt 0 or 1 1
WH25 wh25_batt 0 or 1 1
WH26 wh26_batt 0 or 1 1
WH31 wh31_batt 0 or 1 1
WH32 wh32_batt 0 or 1 1 WH32 is not included in the API but anecdotal evidence shows its battery state is reported and available through the API. Work is ongoing to reliably obtain WH32 battery state data.
WN34 wn34_chx_batt Battery volts <=1.2 Supports up to eight channels (x = 1 to 8)
WN35 wn35_chx_batt Battery volts <=1.2 Supports up to eight channels (x = 1 to 8)
WH40 wh40_batt Battery volts 1 Original hardware version does not report battery voltage and gateway device reports a constant (and incorrect) 1.6V
WH41 wh41_chx_batt 0 - 62 <=1 Supports up to four channels (x = 1 to 4). API lists WH41 but may be WH41 or WH43.
WH45 wh45_batt 0 - 5 <=1
WH51 wh51_chx_batt Battery volts <=1.2 Supports up to eight channels (x = 1 to 8). API states that up to 16 channels are supported but WSView Plus app shows 8 channels only.
WH55 wh55_chx_batt 0 - 5 <=1 Supports up to four channels (x = 1 to 4)
WH57 wh57_batt 0 - 5 <=1
WH65 wh65_batt 0 or 1 1
WH68 wh68_batt Battery volts <=1.2
WS80 ws80_batt Battery volts Note 3.
WS90 w90_batt Battery volts Note 3.

1 These field names are the default names used by the Ecowitt Gateway driver. As with observation fields they may be mapped to other field names by altering the default field map through use of [[field_map]] and/or [[field_map_extensions]] config options.

2 the Ecowitt LAN/Wi-Fi Gateway API states values from 0 to 5 inclusive are used but anecdotal evidence shows value 6 is emitted by WH43 when connected to external DC power.

3 the Ecowitt LAN/Wi-Fi Gateway API does not specify a low battery value for this device.