Soil moisture sensor - Arteco ZS-304Z soil_warning definition incorrect (HA "is not a Number" log errror)

[djgrazzy]

What happened?

I have this soil moisture meter identified as https://www.zigbee2mqtt.io/devices/ZS-304Z.html#arteco-zs-304z
Initial value in mqtt is
"soil_warning": null,
attemting to set it to 10 via the zigbee2mqtt web gui results in mqtt showing
"soil_warning": false,

Publishing zigbee2mqtt/FRIENDLY_NAME/set with payload {"soil_warning": 10}
mqtt remains as "soil_warning": false,

Error in Home assistant logs

Payload '{"battery_state":"middle","humidity":67,"humidity_calibration":0,"illuminance":5,"illuminance_calibration":0,"last_seen":"2026-01-22T15:53:02+11:00","linkquality":131,"soil_calibration":0,"soil_moisture":42,"soil_sampling":"","soil_warning":false,"temperature":23.2,"temperature_calibration":0,"water_warning":"none"}' is not a Number

What did you expect to happen?

Per zigbee2mqtt.io
Value should report set value 0-100.

Soil warning (numeric)
Soil water shortage humidity value. Value can be found in the published state on the soil_warning property. It's not possible to read (/get) this value. To write (/set) a value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set with payload {"soil_warning": NEW_VALUE}. The minimal value is 0 and the maximum value is 100. The unit of this value is %.

I believe this is supposed to change the behaviour of "Water warning" states of "none" and "alarm".

Water warning (enum)
Water shortage warning. Value can be found in the published state on the water_warning property. It's not possible to read (/get) or write (/set) this value. The possible values are: none, alarm.

Battery state (enum)

How to reproduce it (minimal and precise)

initialise device, wait for initial values to come through and or publish zigbee2mqtt/FRIENDLY_NAME/set with payload {"soil_warning": 10}

Zigbee2MQTT version

2.7.2

Adapter firmware version

20220219

Adapter

Sonoff Zigbee 3.0 USB Dongle P

Setup

Home Assistant OS Addon, VM with USB passthrough

Device database.db entry

No response

Debug log

[1/22/2026, 3:59:22 PM] z2m:mqtt: MQTT publish: topic 'zigbee2mqtt/Plant Sensor - Heart Leaf Philodendron', payload '{"battery_state":"middle","humidity":70,"humidity_calibration":0,"illuminance":5,"illuminance_calibration":0,"last_seen":"2026-01-22T15:59:23+11:00","linkquality":109,"soil_calibration":0,"soil_moisture":44,"soil_sampling":"","soil_warning":false,"temperature":22.9,"temperature_calibration":0,"water_warning":"none"}'
[1/22/2026, 3:59:22 PM] z2m:mqtt: MQTT publish: topic 'zigbee2mqtt/Plant Sensor - Heart Leaf Philodendron', payload '{"battery_state":"middle","humidity":70,"humidity_calibration":0,"illuminance":5,"illuminance_calibration":0,"last_seen":"2026-01-22T15:59:23+11:00","linkquality":112,"soil_calibration":0,"soil_moisture":45,"soil_sampling":"","soil_warning":false,"temperature":22.9,"temperature_calibration":0,"water_warning":"none"}'

Notes

I have not updated my coordinator firmware in a long time, possible cause?

[djgrazzy]

coordinator firmware updated to latest 20250321. No Change

[boldiebold]

Same for me

[github-actions]

This issue is stale because it has been open 60 days with no activity. Remove stale label or comment or this will be closed in 7 days

[djgrazzy]

Out of curiosity I might pair it with a tuya hub and have a look at the ID's and fields later today and report back.

[djgrazzy]

Out of curiosity I might pair it with a tuya hub and have a look at the ID's and fields later today and report back.

Paired to a tuya hub but only get temp and humidity with zero values before I recalled and realised there was a different version to the ZigBee2mqtt version specific to work with tuya.

Current workaround is to simple disable water warning and soil warning entities in HA and use my own automation.

[ChrisK91]

I'm running into the same issue. My sensor only exposis soil_warning, disabling this entity seems to work around the issue. My error log reads 2026-06-15 18:03:18.851 WARNING (MainThread) [homeassistant.components.mqtt.number] Payload '{"battery_state":"high","humidity":67,"humidity_calibration":0,"illuminance":241,"illuminance_calibration":0,"linkquality":156,"soil_calibration":0,"soil_moisture":16,"soil_sampling":600,"soil_warning":false,"temperature":23.3,"temperature_calibration":0,"water_warning":"alarm"}' is not a Number in case it helps...

[jadero]

I debugged this sensor since it wouldn't work out-of-the-box with ZHA.
Assigning anything higher than 1 to DP110 makes it immediately jump back to 1, so it looks like this is a boolean switch used to enable the water warning. The limits seem to be hardcoded inside the sensor (correct me if I am wrong).

Here is my ZHA quirk I came up with the help of Google Gemini and my own findings:

"""Vollständiger ZHA-Quirk für Arteco ZS-304Z Bodensensor (1:1 Z2M Feature-Parität)."""

import zigpy.types as t
from zhaquirks.builder import EntityPlatform, EntityType, UnitOfTime
from zhaquirks.tuya.builder import TuyaQuirkBuilder
from zigpy.quirks.v2 import (
    BinarySensorDeviceClass,
    SensorDeviceClass,
    SensorStateClass,
)


class BatteryStateType(t.enum8):
    """Battery State Enum"""

    Niedrig = 0x00
    Mittel = 0x01
    Hoch = 0x02


(
    TuyaQuirkBuilder("Arteco", "ZS-304Z")
    # Alle bekannten Fingerprint-Varianten für das Matching:
    .applies_to("_TZE284_0ints6wl", "TS0601")
    .applies_to("_TZE284_yzr43ayq", "TS0601")
    .applies_to("_TZE284_65gzcss7", "TS0601")
    .applies_to("_TZE284_k7p2q5d9", "TS0601")
    .applies_to("_TZE2841000000_0ints6wl", "TS0601")

    # ==================== SENSORMESSWERTE ====================
    .tuya_soil_moisture(dp_id=3)                       # DP 3: Bodenfeuchtigkeit (%)
    .tuya_temperature(dp_id=5, scale=10)               # DP 5: Temperatur (°C)
    .tuya_humidity(dp_id=101)                          # DP 101: Luftfeuchtigkeit (%)
    .tuya_sensor(
        dp_id=102,
        attribute_name="illuminance",
        type=t.uint16_t,
        device_class=SensorDeviceClass.ILLUMINANCE,
        state_class=SensorStateClass.MEASUREMENT,
        unit="lx",
        translation_key="illuminance",
        fallback_name="Beleuchtungsstärke",
    )                                                  # DP 102: Beleuchtungsstärke (lx)

    # ==================== DIAGNOSE / BATTERIE ====================
    .tuya_enum(
        dp_id=14,
        attribute_name="battery_state",
        enum_class=BatteryStateType,
        entity_type=EntityType.DIAGNOSTIC,
        entity_platform=EntityPlatform.SENSOR,
        translation_key="battery_state",
        fallback_name="Batteriezustand",
    )                                                   # DP 14: low: 16.67%, middle:16.68-83.33%, high: 83.34-100%

    # ==================== WARNUNGEN & ALARME ====================
    .tuya_binary_sensor(
        dp_id=111,
        attribute_name="water_warning",
        device_class=BinarySensorDeviceClass.PROBLEM,
        entity_type=EntityType.STANDARD,
        translation_key="water_warning",
        fallback_name="Trockenheitswarnung",
    )                                                  # DP 111: alarm/none -> ON/OFF

    # ==================== EINSTELLUNGEN & KALIBRIERUNG ====================
    .tuya_number(
        dp_id=103,
        attribute_name="soil_sampling",
        type=t.uint16_t,
        min_value=5,
        max_value=3600,
        step=1,
        unit=UnitOfTime.SECONDS,
        entity_type=EntityType.CONFIG,
        translation_key="soil_sampling",
        fallback_name="Messintervall Bodenfeuchtigkeit",
    )                                                  # DP 103: Abtastintervall (5 s bis 3600 s)
    .tuya_number(
        dp_id=104,
        attribute_name="soil_calibration",
        type=t.int8s,
        min_value=-30,
        max_value=30,
        step=1,
        unit="%",
        entity_type=EntityType.CONFIG,
        translation_key="soil_calibration",
        fallback_name="Kalibrierung Bodenfeuchtigkeit",
    )                                                  # DP 104: Offset Bodenfeuchtigkeit (-30 % bis +30 %)
    .tuya_number(
        dp_id=105,
        attribute_name="humidity_calibration",
        type=t.int8s,
        min_value=-30,
        max_value=30,
        step=1,
        unit="%",
        entity_type=EntityType.CONFIG,
        translation_key="humidity_calibration",
        fallback_name="Kalibrierung Luftfeuchtigkeit",
    )                                                  # DP 105: Offset Luftfeuchte (-30 % bis +30 %)
    .tuya_number(
        dp_id=106,
        attribute_name="illuminance_calibration",
        type=t.int16s,
        min_value=-1000,
        max_value=1000,
        step=1,
        unit="lx",
        entity_type=EntityType.CONFIG,
        translation_key="illuminance_calibration",
        fallback_name="Kalibrierung Beleuchtungsstärke",
    )                                                  # DP 106: Offset Beleuchtungsstärke (-1000 lx bis +1000 lx)
    .tuya_number(
        dp_id=107,
        attribute_name="temperature_calibration",
        type=t.int8s,
        min_value=-2.0,
        max_value=2.0,
        step=0.1,
        multiplier=0.1,
        unit="°C",
        entity_type=EntityType.CONFIG,
        translation_key="temperature_calibration",
        fallback_name="Kalibrierung Temperatur",
    )                                                  # DP 107: Offset Temperatur (-2 °C bis +2 °C)
    .tuya_switch(
        dp_id=110,
        attribute_name="soil_warning",
        entity_type=EntityType.STANDARD,
        translation_key="soil_warning",
        fallback_name="Warnung bei trockenem Boden",
    )                                                  # DP 110: Schalter Warnung Bodenfeuchtigkeit

    .skip_configuration()
    .add_to_registry()
)