# Downlink Widget

## **Overview**

The Downlink Widget in Datacake allows you to send commands or data directly to your IoT devices from your dashboard. This powerful tool is essential for interacting with your devices, enabling you to trigger actions, change settings, or send data remotely. This documentation will guide you through setting up the widget, configuring its data source, customizing its appearance, and making the most out of this feature.

<figure><img src="/files/CH5UpfuSqdDREoTpmLe1" alt=""><figcaption></figcaption></figure>

### **Key Features**

* **Direct Device Interaction**: Send downlink messages to trigger actions or change settings on your devices.
* **Confirmed Downlink**: Integrated into Datacake's LNS (LoRaWAN Network Server), as well as the Actility integration to ensure commands are successfully received by the device, reducing the need for redundancy.
* **Customizable Appearance**: Tailor the widget's look to match your dashboard's theme.

## Video

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

{% embed url="<https://www.youtube.com/watch?v=Rsyyx9PIgc4>" %}

## **Setting Up the Downlink Widget**

### **1. Adding the Downlink Widget to Your Dashboard**

To add the Downlink Widget:

1. **Navigate to your Dashboard**: Open the dashboard where you want to add the widget.
2. **Add a New Widget**: Click on the 'Add Widget' button.
3. **Select the Downlink Widget**: From the list of available widgets, choose the Downlink Widget. The widget will now appear on your dashboard, ready for configuration.

### **2. Configuring the Widget**

* **Set a Title**: Assign a title to your widget that reflects its purpose or the device it controls. Examples include "Interval = 1 min" or "Reboot".
* **Select Data Source**: Choose the device you want to send the downlink to. The widget will display a list of devices with available downlink definitions. Select the appropriate device and downlink command.
  * **Multiple Devices**: Datacake allows you to control multiple downlinks with a single button. To do this, click on “+Add” and select additional devices and downlinks.

<figure><img src="/files/gMWnzBiaE22MqpH8Htm1" alt=""><figcaption></figcaption></figure>

### **3. Customizing Appearance**

Under the 'Appearance' tab, you can customize the look of your Downlink Widget:

* **Tint Color**: Adjust the background color of the widget card to align with your dashboard's theme.
* **Highlight Color**: Change the font color to ensure visibility, especially if using a darker tint color.
* **Hide Background**: For a more minimalist appearance, you can hide the widget's background, allowing it to blend seamlessly with your dashboard.

Test the widget by clicking on it to send the selected downlink command. If configured correctly, your device should respond, and the widget will confirm that the command was sent successfully.

## **Tips and Best Practices**

* **Ensure Proper Configuration**: Verify that your downlink definitions are correctly set up on the device side for smooth communication.
* **Regular Testing**: Regularly test your downlinks to ensure they function as expected.
* **Use Appearance Customization**: Customize the appearance of your widget to make your dashboard not only functional but also visually appealing.


---

# 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/downlink-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.