Device states

• Introduction

• Manual change of the device state

• Automated change of the device state

  • Automated arming

  • Automated disarming

• Events (uplink messages) relevant for device states

Introduction

If your SimpleHw device uses API 6, there are three possible states the device will be in:

1. Disarmed (not active and no messages will be sent in default settings)

2. Arming (state between disarmed and armed, time-limited, default is 15 seconds)

3. Armed (active and ready to monitor and send messages)

---

4. Zone switching mode (it’s only possible to manually switch the Sigfox RC zone, nothing else - this is the only device state that is not closely tied to the user mode and is implemented in the firmware in order for you to be able to change RC zones manually - more here: https://ask.simplehw.eu/api-6-rc-switch)

Device state depends on the user mode your device is in. A few modes do NOT require arming and are active all the time - namely Blinker and Press me and its WiFi enabled variants. Most API 6 devices are shipped in basic Press me mode, which means they do not require arming - with the exception of SimplePack 4.0 Plus Magnetic Switch (shipped in 0x0C Reed switch on/off) and SimpleIndustry Legionella (shipped in 0x1D Legionella mode).

If you’re using any other mode than Blinker or any Press me version, your device will be disarmed by default. There are several ways to arm the device and these can be grouped into two major groups.

Manual change of the device state

Cycle: Disarmed → Arming → Armed → Disarmed

Manual arming means pressing the SimplePack or SimplePack Plus button or activating the SimpleLeak by placing it in water and removing it after a few seconds. This will start arming the device and after the departure delay timer countdown expires, the device will be armed and actively monitoring its environment.

This is closely described in the Basic Operations With SimpleHw Devices guide.

Disarming the device manually will be the same as disarming the device any other way: device state will change (armed → disarmed). Manual disarm can be distinguished by the uplink event it generates.

---

Automated change of the device state

Cycle: Disarmed → Armed → Disarmed

You will skip the arming state when automated arming and disarming configuration is active (by default, it isn’t). There are two automated options for both arming and disarming:

Automated arming

Method	Triggered by	Additional information
Auto-arm	Time	Value of downlink register 0x10 in SimpleTime. Countdown starts when downlink is received.
Force-arm	Downlink	Set bit 7 of downlink register 0x40 to 1. Device state changes from disarmed to armed when downlink is received.

Automated disarming

Method	Triggered by	Additional information
Disarming alert	Alert 1, 2 or 3	Set bit 5 of downlink registers 0x23, 0x26 and 0x29 to 1. Device disarms when the respective alert is sent.
Force-disarm	Downlink	Set bit 6 of downlink register 0x40 to 1. Device state changes from armed to disarmed when downlink is received.

---

Events (uplink messages) relevant for device states

There is a set of mode-independent events that inform you about device state changes. Here’s a table:

Hex	Event name	Device state change	Trigger
0x10	Arming started	Disarmed → arming	SimplePack: button press (short is default) SimpleLeak: water detection
0x11	Armed	Arming → armed	Departure delay timer countdown expired
0x12	Autoarmed	Disarmed → armed	Auto-arm timer countdown expired
0x13	Disarmed by event	Armed → disarmed	Event set to disarm the device sent
0x14	Disarmed by interaction	Armed → disarmed	SimplePack: button press (long is default) SimpleLeak: turned upside down for 10s
0x17	Force-armed	Disarmed → armed	Force-arming downlink received
0x18	Force-disarmed	Armed → disarmed	Force-disarming downlink received