# Actuators

![Actuator settings](/files/ETJAHdkkK8JJ1YLrgpVb)

Actuators such as agitators, pumps, or ring heaters are configured with a name and a GPIO output. If needed, an actuator can use PWM (pulse-width modulation). In Brautomat, PWM means either timed on/off switching or an analog PWM signal, depending on the selected PWM mode.

Power is entered in percent:

* 100% = always on
* 50% = equal on/off cycle in digital PWM mode

Digital PWM is intended for relays and SSR outputs. It uses a fixed 5000 ms cycle and processes power in 5% steps. There is no separate configurable duty-cycle parameter for actuators.

Analog PWM uses a fixed 1000 Hz PWM signal. This mode is intended for suitable PWM inputs, not for switching relays.

During operation, you can change power with the `+` and `-` buttons in the actuator table. These buttons are visible only when PWM is enabled for that actuator.

Digital PWM control is suitable for relays and SSR outputs. It is not intended as direct speed control for agitator motors.

![Overview of actuators](/files/hyCrrj9sH85EMpLcj0Np)

## Webhook

Set the actuator GPIO parameter to `-` to show webhook fields in the web interface. Then enter the base URL and the switching command:

![webhook](/files/1jJXtR7awmMDV6M7nLZm)

Example: Shelly 1PM

Turn on Shelly 1PM: <http://192.168.1.5/relay/0?turn=on>\
Turn off Shelly 1PM: <http://192.168.1.5/relay/0?turn=off>

Webhook base URL for Shelly 1PM: <http://192.168.1.5/relay/0?turn=> (without `on` and `off`). The webhook switch parameter should be set to `on/off`.

Tasmota example URL: <http://192.168.1.5/cm?cmnd=Power1%201>


---

# 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://innuendopi.gitbook.io/brautomat32/act.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.
