Zigbee2MQTTZigbee2MQTT
  • Getting started
  • Supported Adapters
  • Supported Devices
  • Installation
  • Configuration
  • Usage
  • FAQ
Devices
  • Zigbee

    • Zigbee network
    • Improve network range and stability
    • Secure your Zigbee network
    • Sniff Zigbee traffic
    • Create a CC2530 router
  • Support new devices

    • Support new devices
    • Support new Tuya devices
    • Find Tuya Data Points
  • Remote Adapter

    • Connect to a remote adapter
    • Connect to a remote Sonoff ZBBridge
  • More

    • 3D cases
    • External converters
    • External extensions
    • Switch to the dev branch
    • Get Tuya and Xiaomi OTA url
  • Forum
  • Discord
  • Issues
  • Donate
GitHub
GitHub (docs)
  • Getting started
  • Supported Adapters
  • Supported Devices
  • Installation
  • Configuration
  • Usage
  • FAQ
Devices
  • Zigbee

    • Zigbee network
    • Improve network range and stability
    • Secure your Zigbee network
    • Sniff Zigbee traffic
    • Create a CC2530 router
  • Support new devices

    • Support new devices
    • Support new Tuya devices
    • Find Tuya Data Points
  • Remote Adapter

    • Connect to a remote adapter
    • Connect to a remote Sonoff ZBBridge
  • More

    • 3D cases
    • External converters
    • External extensions
    • Switch to the dev branch
    • Get Tuya and Xiaomi OTA url
  • Forum
  • Discord
  • Issues
  • Donate
GitHub
GitHub (docs)

Dongguan Pinjia Technology Co.,LTD. PJ3201A

ModelPJ3201A
VendorDongguan Pinjia Technology Co.,LTD.
DescriptionHuman Presence Sensor
Exposespresence, occupancy, closest_target_distance, movement_timeout, idle_timeout, illuminance, far_movement_sensitivity, near_movement_sensitivity, near_presence_sensitivity, far_presence_sensitivity, closest_detection_distance, largest_movement_detection_distance, largest_presence_detection_distance, restore_factory, led_indicator
PictureDongguan Pinjia Technology Co.,LTD. PJ3201A

Notes

Occupancy indicated active movement. The attribute is not directly affected by the movement delay. But the movement delay will affect after what time the presence state is reset if only movement was detected but no presence.

Flip the factory reset to any state to restore factory settings. This will not reset zigbee settings only the sensor default values are loaded.

Options

How to use device type specific configuration

  • illuminance_calibration: Calibrates the illuminance value (percentual offset), takes into effect on next report of device. The value must be a number.

Exposes

Presence (binary)

Indicates whether the device detected presence. Will be true also when movement (occupancy) is detected.. Value can be found in the published state on the presence property. It's not possible to read (/get) or write (/set) this value. If value equals true presence is ON, if false OFF.

Occupancy (binary)

Indicates whether the device detected movement. Will be true when movement. Can remain true even if the target left the detection range. In this case presence will be reset to false reliably.. 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.

Closest target distance (numeric)

the target distance away from the sensor. Value can be found in the published state on the closest_target_distance property. It's not possible to read (/get) or write (/set) this value. The unit of this value is m.

Movement timeout (numeric)

Timeout until the movement (occupancy) is reset when no further movement is detected. (Occupancy -> None). Value can be found in the published state on the movement_timeout 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 {"movement_timeout": NEW_VALUE}. The minimal value is 0 and the maximum value is 43200. The unit of this value is s.

Idle timeout (numeric)

Timeout until the presence is reset when no further presence is detected (Presence -> None). Value can be found in the published state on the idle_timeout 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 {"idle_timeout": NEW_VALUE}. The minimal value is 0 and the maximum value is 43200. The unit of this value is s.

Illuminance (numeric)

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.

Far movement sensitivity (numeric)

the moving detecting sensitivity 1 meter away. Value can be found in the published state on the far_movement_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 {"far_movement_sensitivity": NEW_VALUE}. The minimal value is 0 and the maximum value is 10.

Near movement sensitivity (numeric)

the moving detecting sensitivity within 1 meter. Value can be found in the published state on the near_movement_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 {"near_movement_sensitivity": NEW_VALUE}. The minimal value is 0 and the maximum value is 10.

Near presence sensitivity (numeric)

the presence detecting sensitivity within 1 meter. Value can be found in the published state on the near_presence_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 {"near_presence_sensitivity": NEW_VALUE}. The minimal value is 0 and the maximum value is 10.

Far presence sensitivity (numeric)

the presence detecting sensitivity 1 meter away. Value can be found in the published state on the far_presence_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 {"far_presence_sensitivity": NEW_VALUE}. The minimal value is 0 and the maximum value is 10.

Closest detection distance (numeric)

The closest distance that can be detected. Value can be found in the published state on the closest_detection_distance 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 {"closest_detection_distance": NEW_VALUE}. The minimal value is 0.1 and the maximum value is 7. The unit of this value is m.

Largest movement detection distance (numeric)

The farthest distance that can be detected (moving). Value can be found in the published state on the largest_movement_detection_distance 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 {"largest_movement_detection_distance": NEW_VALUE}. The minimal value is 0.1 and the maximum value is 7. The unit of this value is m.

Largest presence detection distance (numeric)

The farthest distance that can be detected (present). Value can be found in the published state on the largest_presence_detection_distance 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 {"largest_presence_detection_distance": NEW_VALUE}. The minimal value is 0.1 and the maximum value is 7. The unit of this value is m.

Restore factory (binary)

restore_factory. Value can be found in the published state on the restore_factory 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 {"restore_factory": NEW_VALUE}. If value equals ON restore factory is ON, if OFF OFF.

Led indicator (binary)

turn on or off the led . Value can be found in the published state on the led_indicator 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_indicator": NEW_VALUE}. If value equals ON led indicator is ON, if OFF OFF.

Help to make the docu better and edit this page on Github ✌
Last Updated:: 5/7/25, 7:30 PM