To contribute to this page, edit the following file
Fantem ZB003-X #
Model | ZB003-X |
Vendor | Fantem |
Description | 4 in 1 multi sensor |
Exposes | occupancy, battery, illuminance, temperature, humidity, reporting_time, temperature_calibration, humidity_calibration, illuminance_calibration, pir_enable, led_enable, reporting_enable, sensitivity, keep_time, linkquality |
Picture | ![]() |
Notes #
Device type specific configuration #
How to use device type specific configuration
-
illuminance_lux_precision
: Controls the precision ofilluminance_lux
values, e.g.0
or1
; default1
. To control the precision based on the illuminance_lux value set it to e.g.{1000: 0, 100: 1}
, when illuminance_lux >= 1000 precision will be 0, when illuminance_lux >= 100 precision will be 1. -
illuminance_lux_calibration
: Allows to manually calibrate illuminance values, e.g.95
would take 95% to the illuminance reported by the device; default100
. temperature_precision
: Controls the precision oftemperature
values, e.g.0
,1
or2
; default2
. To control the precision based on the temperature value set it to e.g.{30: 0, 10: 1}
, when temperature >= 30 precision will be 0, when temperature >= 10 precision will be 1.-
temperature_calibration
: Allows to manually calibrate temperature values, e.g.1
would add 1 degree to the temperature reported by the device; default0
. humidity_precision
: Controls the precision ofhumidity
values, e.g.0
,1
or2
; default2
. To control the precision based on the humidity value set it to e.g.{80: 0, 10: 1}
, when humidity >= 80 precision will be 0, when humidity >= 10 precision will be 1.
Exposes #
Occupancy (binary) #
Indicates whether the device detected occupancy.
Value can be found in the published state on the occupancy
property.
It’s not possible to read (/get
) or write (/set
) this value.
If value equals true
occupancy is ON, if false
OFF.
Battery (numeric) #
Remaining battery in %.
Value can be found in the published state on the battery
property.
It’s not possible to read (/get
) or write (/set
) this value.
The minimal value is 0
and the maximum value is 100
.
The unit of this value is %
.
Illuminance (numeric) #
Raw measured illuminance.
Value can be found in the published state on the illuminance
property.
It’s not possible to read (/get
) or write (/set
) this value.
The unit of this value is lx
.
Temperature (numeric) #
Measured temperature value.
Value can be found in the published state on the temperature
property.
It’s not possible to read (/get
) or write (/set
) this value.
The unit of this value is °C
.
Humidity (numeric) #
Measured relative humidity.
Value can be found in the published state on the humidity
property.
It’s not possible to read (/get
) or write (/set
) this value.
The unit of this value is %
.
Reporting_time (numeric) #
Reporting interval in minutes.
Value can be found in the published state on the reporting_time
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 {"reporting_time": NEW_VALUE}
.
Temperature_calibration (numeric) #
Temperature calibration.
Value can be found in the published state on the temperature_calibration
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 {"temperature_calibration": NEW_VALUE}
.
Humidity_calibration (numeric) #
Humidity calibration.
Value can be found in the published state on the humidity_calibration
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 {"humidity_calibration": NEW_VALUE}
.
Illuminance_calibration (numeric) #
Illuminance calibration.
Value can be found in the published state on the illuminance_calibration
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 {"illuminance_calibration": NEW_VALUE}
.
Pir_enable (binary) #
Enable PIR sensor.
Value can be found in the published state on the pir_enable
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 {"pir_enable": NEW_VALUE}
.
If value equals true
pir_enable is ON, if false
OFF.
Led_enable (binary) #
Enabled LED.
Value can be found in the published state on the led_enable
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 {"led_enable": NEW_VALUE}
.
If value equals true
led_enable is ON, if false
OFF.
Reporting_enable (binary) #
Enabled reporting.
Value can be found in the published state on the reporting_enable
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 {"reporting_enable": NEW_VALUE}
.
If value equals true
reporting_enable is ON, if false
OFF.
Sensitivity (enum) #
PIR sensor sensitivity.
Value can be found in the published state on the sensitivity
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 {"sensitivity": NEW_VALUE}
.
The possible values are: low
, medium
, high
.
Keep_time (enum) #
PIR keep time in seconds.
Value can be found in the published state on the keep_time
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 {"keep_time": NEW_VALUE}
.
The possible values are: 0
, 30
, 60
, 120
, 240
.
Linkquality (numeric) #
Link quality (signal strength).
Value can be found in the published state on the linkquality
property.
It’s not possible to read (/get
) or write (/set
) this value.
The minimal value is 0
and the maximum value is 255
.
The unit of this value is lqi
.
Manual Home Assistant configuration #
Although Home Assistant integration through MQTT discovery is preferred, manual integration is possible with the following configuration:
binary_sensor:
- platform: "mqtt"
state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
availability_topic: "zigbee2mqtt/bridge/state"
value_template: "{{ value_json.occupancy }}"
payload_on: true
payload_off: false
device_class: "motion"
sensor:
- platform: "mqtt"
state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
availability_topic: "zigbee2mqtt/bridge/state"
unit_of_measurement: "%"
value_template: "{{ value_json.battery }}"
device_class: "battery"
sensor:
- platform: "mqtt"
state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
availability_topic: "zigbee2mqtt/bridge/state"
unit_of_measurement: "lx"
value_template: "{{ value_json.illuminance }}"
device_class: "illuminance"
sensor:
- platform: "mqtt"
state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
availability_topic: "zigbee2mqtt/bridge/state"
unit_of_measurement: "°C"
value_template: "{{ value_json.temperature }}"
device_class: "temperature"
sensor:
- platform: "mqtt"
state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
availability_topic: "zigbee2mqtt/bridge/state"
unit_of_measurement: "%"
value_template: "{{ value_json.humidity }}"
device_class: "humidity"
sensor:
- platform: "mqtt"
state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
availability_topic: "zigbee2mqtt/bridge/state"
unit_of_measurement: "-"
value_template: "{{ value_json.reporting_time }}"
sensor:
- platform: "mqtt"
state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
availability_topic: "zigbee2mqtt/bridge/state"
unit_of_measurement: "-"
value_template: "{{ value_json.temperature_calibration }}"
sensor:
- platform: "mqtt"
state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
availability_topic: "zigbee2mqtt/bridge/state"
unit_of_measurement: "-"
value_template: "{{ value_json.humidity_calibration }}"
sensor:
- platform: "mqtt"
state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
availability_topic: "zigbee2mqtt/bridge/state"
unit_of_measurement: "-"
value_template: "{{ value_json.illuminance_calibration }}"
binary_sensor:
- platform: "mqtt"
state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
availability_topic: "zigbee2mqtt/bridge/state"
value_template: "{{ value_json.pir_enable }}"
payload_on: true
payload_off: false
binary_sensor:
- platform: "mqtt"
state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
availability_topic: "zigbee2mqtt/bridge/state"
value_template: "{{ value_json.led_enable }}"
payload_on: true
payload_off: false
binary_sensor:
- platform: "mqtt"
state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
availability_topic: "zigbee2mqtt/bridge/state"
value_template: "{{ value_json.reporting_enable }}"
payload_on: true
payload_off: false
sensor:
- platform: "mqtt"
state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
availability_topic: "zigbee2mqtt/bridge/state"
value_template: "{{ value_json.sensitivity }}"
sensor:
- platform: "mqtt"
state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
availability_topic: "zigbee2mqtt/bridge/state"
value_template: "{{ value_json.keep_time }}"
sensor:
- platform: "mqtt"
state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
availability_topic: "zigbee2mqtt/bridge/state"
unit_of_measurement: "lqi"
value_template: "{{ value_json.linkquality }}"
icon: "mdi:signal"