> ## Documentation Index
> Fetch the complete documentation index at: https://docs.owlintegrations.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Commands

> Send commands to a Papa Duck gateway and track their status

Commands let you trigger an action on a Papa Duck gateway directly from OWL DMS — no reflashing required. Use them to check that a gateway is reachable, adjust its battery sleep window, or change its radio transmit power.

Commands are sent from the gateway's detail page and reach every gateway in range of that Papa Duck.

## Sending a Command

<Steps>
  <Step title="Open the gateway">
    Go to a Papa Duck's detail page and find the **Commands** section.
  </Step>

  <Step title="Choose a command">
    Pick a command from the dropdown. A short description explains what it does.
  </Step>

  <Step title="Enter values">
    If the command needs parameters, fill them in. OWL DMS checks your values as you type and flags anything out of range.
  </Step>

  <Step title="Send and confirm">
    Click **Send command**, then confirm in the dialog. Your command is on its way.
  </Step>
</Steps>

## Available Commands

<CardGroup cols={1}>
  <Card title="Ping" icon="satellite-dish">
    Checks that the gateway is reachable right now. No parameters needed.
  </Card>

  <Card title="Sleep thresholds" icon="battery-half">
    Sets the battery voltage window the gateway sleeps and wakes within. Enter a **minimum** and **maximum** voltage between 2.5V and 4.5V — the minimum must be lower than the maximum. As you type, an estimated battery percentage is shown to help you pick sensible values.
  </Card>

  <Card title="Set radios" icon="tower-broadcast">
    Sets the gateway's radio transmit power. Enter a whole number between 14 and 22 — higher values increase range but use more power.
  </Card>
</CardGroup>

## Tracking Command Status

The **Recent activity** list under the Commands section shows the commands you've sent to this gateway, newest first. Each entry shows the command name, a status badge, and when it was last updated.

| Status         | Meaning                                                |
| -------------- | ------------------------------------------------------ |
| **Dispatched** | The command has been sent and is on its way.           |
| **Accepted**   | The gateway received the command.                      |
| **Complete**   | The command finished successfully.                     |
| **Rejected**   | The gateway received the command but could not run it. |
| **Failed**     | The command could not be delivered.                    |
| **Timed out**  | No response was received in time.                      |
| **Cancelled**  | The command was cancelled before it completed.         |

Use the refresh button to update the list. If a command fails, its error message appears beneath the entry.

<Note>
  If the command history can't be reached, your commands still go through — only their status won't show up in the activity list.
</Note>

## Troubleshooting

* **The Commands section says the gateway can't receive commands.** The gateway is missing its network target and isn't ready for commands yet. Confirm the device is set up and reporting in.
* **My values won't send.** Check the on-screen hints — voltages must be between 2.5V and 4.5V (minimum lower than maximum), and radio transmit power must be a whole number between 14 and 22.