Skip to main content

Scripts and Automations

11. Scripts and Automations

The Scripts and Automations feature in SLZB-OS lets you create and run your own automation logic directly on the coordinator, without needing an external controller to send every command. Scripts can respond to events, toggle GPIOs, interact with the Zigbee hub, or perform other custom actions.


image.png

11.1 Overview

  • Scripts are executed by the coordinator’s firmware.

  • They can be triggered automatically (on boot) or run manually.

  • They support features such as an HTTP client to fetch or send data over the network.

  • This feature is intended for advanced users familiar with automation logic and scripting.

For examples and full API documentation, refer to the official repository:
???? https://github.com/smlight-tech/slzb-os-scripts


11.2 Script Manager

The Script Manager section contains the list of available scripts and their control options:

Field / Button Description
Status Shows whether the script is enabled/disabled.
Filename The name of the script file stored in the coordinator.
Run on boot Toggle to run the script automatically after the device boots.
Actions Buttons to edit, run, stop, or delete the script.

11.3 Adding a Script

  1. Click the “+” button in Script Manager to create a new script.

  2. Enter your code in the built-in script editor.

  3. Save the script — it will appear in the list with its filename.

  4. Optionally enable Run on boot.


11.4 Running a Script

  • To run a script manually, click the Run action button next to it.

  • The script will execute immediately and perform its programmed logic.


11.5 Editing / Updating a Script

  • Click the Edit button for the script you want to modify.

  • Make changes in the script editor and save.

  • If “Run on boot” is enabled, the updated script will take effect at the next reboot.


11.6 Removing a Script

  • Click the Delete button.

  • Confirm deletion — the file will be removed from the coordinator.


11.7 Notes & Best Practices

  • Test scripts carefully before enabling Run on boot, to avoid loops or undesired behaviors.

  • The HTTP client functionality enables integration with external APIs or local services.

  • Avoid blocking operations or excessive network calls to keep the coordinator responsive.

  • Store scripts in a safe location outside the coordinator for backup, as they may be lost on a full reset.