Occupancy notification feature

Occupancy notification feature

Alerting mode is available based on PIR data. We call it Occupancy notification feature. It is disabled by default.

The feature will trigger an uplink when the occupancy status changes from EMPTY to OCCUPIED (and/or from OCCUPIED to EMPTY). This can be useful if you have e.g. 30 s sampling period and 10 minute uplink period (send_period = 20). With this feature enabled, the device send an additional uplink immediately (e.g. 30 s) after the occupancy status changes; without this feature, uplinks is transmitted at the regular period.

Uplink messages always have the same format. The payload includes the PIR value: sum of all PIR-events reported since the last uplink. The occupancy status can be derived from the PIR value.

Information about the device logic

  • ACTIVE period: PIR >= 3* events.
  • INACTIVE period: PIR < 3* events.
  • Occupancy status is either EMPTY or OCCUPIED.
  • Occupancy status changes from EMPTY to OCCUPIED after 1* ACTIVE period.
  • Occupancy status changes from OCCUPIED to EMPTY after 20* INACTIVE periods.
  • Occupancy notification flags (default = 0):
    • 0*: Feature disabled.
    • 1*: Trigger immediate uplink when EMPTY -> OCCUPIED.
    • 2*: Trigger immediate uplink when OCCUPIED -> EMPTY.
    • 3*: Trigger immediate uplink when OCCUPIED -> EMPTY or OCCUPIED -> EMPTY.
  • Parameters with * are configurable.

Occupancy feature: device configuration

Param

Name

Default

Comment

4

Occupancy notification flags

0

Default 0: disabled

5

Activity threshold

3

PIR >= 3: ACTIVE, else: INACTIVE

6

Occupied threshold

1

Change EMPTY -> OCCUPIED, if 1 x ACTIVE

7

Empty threshold

20

Change OCCUPIED -> EMPTY, if 20 x INACTIVE