# 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="https://2221155863-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LNA8_b8wmabHgJ0QXoJ%2Fuploads%2F8nHchKrJXxOny6zmvZCo%2FCleanShot%202024-08-01%20at%2013.29.33%402x.png?alt=media&#x26;token=ae874f1d-225c-478d-bc21-a8f69ffd18b2" alt=""><figcaption></figcaption></figure> <figure><img src="https://2221155863-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LNA8_b8wmabHgJ0QXoJ%2Fuploads%2F4Btes4b2YxcRJeWRRWoa%2FCleanShot%202024-08-01%20at%2013.28.05%402x.png?alt=media&#x26;token=0b2b59be-d5cf-46e7-8db2-205cd3ba550a" 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: 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://docs.datacake.de/dashboards/widgets/sos-widget.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.