> For the complete documentation index, see [llms.txt](https://docs.datacake.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.datacake.de/dashboards/widgets/sos-widget.md).

# SOS Widget

The SOS Widget is an interactive feature designed to display the status of alarm devices, particularly useful for devices like the IO Things IO Button. This widget provides a clear visual indicator when an SOS signal is received, and includes a unique interactive feature for managing the SOS state.

<div><figure><img src="/files/Q0BHcwHTv4KmKd30xayR" alt=""><figcaption></figcaption></figure> <figure><img src="/files/kCK89wAm35gc7nkT84Co" alt=""><figcaption></figcaption></figure></div>

## Key Features

* **Interactive Boolean Display**: The SOS Widget functions similarly to a Boolean widget, displaying `true` or `false` states. However, it includes additional interactive capabilities.
* **SOS State Indicator**: When a device sends a `true` value for the SOS field, the widget displays this as an active SOS state, alerting operators to an emergency.
* **Clear Button**: Unique to the SOS Widget is the "Clear" button. This button allows operators to manually reset the SOS state. Upon clicking, the selected field's value is set to `false`, clearing the SOS alert on the widget.

## Usage

1. **SOS Signal**: When an SOS device, such as the IO Button, sends a `true` value indicating an SOS event, the SOS Widget will display this state on the dashboard.
2. **Resetting SOS State**: To acknowledge and clear the SOS alert, an operator can click the "Clear" button on the widget. This action sends a `false` value to the field, resetting the SOS state displayed.

## Application

The SOS Widget is ideal for monitoring emergency signals from devices that do not automatically reset their SOS status. It provides a reliable method for operators to manage and document the resolution of SOS events.

## Video

Watch an interactive tutorial on using the SOS widget in this video.

{% embed url="<https://www.youtube.com/watch?t=23s&v=OvfusdjeHCo>" %}


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.datacake.de/dashboards/widgets/sos-widget.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.