> For the complete documentation index, see [llms.txt](https://ask.simplehw.eu/kb/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ask.simplehw.eu/kb/sensors/button/button-in-api-6.md).

# Button in API 6

The button is the simplest sensor we have on our devices. The device recognizes various types of clicks **based on time** and this is how you control your SimplePack (and your SimpleIndustry).

{% hint style="info" %}
The functionality of the button is rewired to the **reed switch in the SimpleIndustry**, the reed switch behaves like the button in this device, so this article is important for SimpleIndustry users too!
{% endhint %}

### Overview <a href="#overview" id="overview"></a>

**Button functionality**:

1. The button is how you **request downlink (change settings) and arm/disarm devices (activate/deactivate user modes)**.

   [More in the **Basic operations guide** HERE!](https://simplehw.atlassian.net/wiki/spaces/DOC/pages/8519899/API+6+Basic+Operations+With+SimpleHw+Devices)
2. There are two button-based **User modes: Press me (+ WiFi variants) and Blinker**. You can find an overview of both of these modes below.
3. You can also receive **independent alerts** from the button in other modes.

   [More about **independent alerts** HERE!](https://simplehw.atlassian.net/wiki/spaces/DOC/pages/15237121/API+6+Mode-Independent+Information+And+Events#Sensor-triggered-mode-independent-events)
4. The button can also be used to **switch the RC zone** of your device.

   [**Manual zone switch**](https://ask.simplehw.eu/api-6/rc-switch/)

### User modes <a href="#user-modes" id="user-modes"></a>

#### Press me (+ WiFi variants) <a href="#press-me-wifi-variants" id="press-me-wifi-variants"></a>

Simple mode that sends different alerts based on the length of button click - short press, double click, long press, extra long press.

#### Blinker <a href="#blinker" id="blinker"></a>

When the button is clicked, the device sends an alert and the LED will start blinking. When the button is pressed again, a different alert is sent and the blinking stops.

### Relevant registers <a href="#relevant-registers" id="relevant-registers"></a>

| Register hex | Register name          | Value range              | What it is and what it does                                  | Useful for                           |
| ------------ | ---------------------- | ------------------------ | ------------------------------------------------------------ | ------------------------------------ |
| 0x0E         | Device control presets | 8 binary flags           | Bits 3, 4 and 5 control the button. More in the table.       | All modes                            |
| 0x56         | Device control presets | 8 binary flags           | Bit 7 controls LED patterns of short press.                  | Press me + independent button alerts |
| 0x57         | Device control presets | 8 binary flags           | Bits 7 and 6 control disarming by button.                    | All modes                            |
| 0x59         | Button press timing    | 2 sets of 4 binary flags | Customizes the time between various types of button presses. | Press me + independent button alerts |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ask.simplehw.eu/kb/sensors/button/button-in-api-6.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
