> For the complete documentation index, see [llms.txt](https://innuendopi.gitbook.io/brautomat32/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://innuendopi.gitbook.io/brautomat32/act.md).

# Actuators

![Actuator settings](https://4263638218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcd8WaQiNhLpQ99hwjXzs%2Fuploads%2Fgit-blob-3274f06f72044597d4ebdeb2bbea0deb5f22c419%2Faktoren_einstellungen.jpg?alt=media)

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.

For relays, PWM means timed on/off switching to control power, not continuous speed control.

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.

Numeric actuator commands in a mash plan set the current PWM power. The configured PWM value remains the starting value for manual operation. Deleting an actuator preserves the running state of subsequent actuators. GPIOs already assigned to kettles, sensors or system functions cannot also be assigned to an actuator.

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](https://4263638218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcd8WaQiNhLpQ99hwjXzs%2Fuploads%2Fgit-blob-8d0b811f522578a4caa41ddcf9a7279d028d911c%2Faktoren.jpg?alt=media)

## Webhook

Editing or deleting an actuator switches off its previous webhook target. OFF requests are retried after connection failures and HTTP error responses. Until OFF receives an HTTP 2xx response, no new ON request is accepted for the same target. Failed ON requests are not retried automatically. An HTTP acknowledgement is not physical switching feedback. A reboot waits for outstanding OFF acknowledgements and can therefore remain pending if a webhook target stays unreachable. When the request store is full, a target change is rejected instead of losing the previous target's OFF request.

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

![webhook](https://4263638218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcd8WaQiNhLpQ99hwjXzs%2Fuploads%2Fgit-blob-b7f226d024ac4f153df02318a57afcacec134d17%2Faktoren_webhook1.jpg?alt=media)

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>
