Skip to content

openhab/openhab-syno-spk

Repository files navigation

openhab-syno-spk - Synology DSM Software Package

This project build a Synology DiskStation SPK install package for openHAB (Home Automation Server).

Comments, suggestions and contributions are welcome!

License

These packaging files are licensed as follows: LICENSE Please inform yourself of the other licenses used by the software which come with openHAB and openHAB itself. While using these packaging files and all contents of resulting software package, you agreee with all licenses included.

Download

Download the SPK package from the releases section and follow the instructions below.

Documentation

Prerequirements

  • Download the SPK from our project package. You will find per OpenHAB release one download. The package comes with all required software.
  • (Backup and) uninstall the previous installation based on our old package. You can identify the old package by it's icon.
    image

Installation

  1. Open your "Package Center" and click on the "Manual Install" button to start the install using the SPK file you have downloaded.
    Screenshot_20210104_194226

  2. Click on the "Browse" button and select the SPK file you wish to install.
    Screenshot_20210104_194650

  3. Configure your installation by making adjustments on the following pages. Generally we recommend to keep the default settins. Especially on the expert pages.

  4. Confirm the installation

  5. Optional: Register the Z-Wave script to be executed on system start. It is required to give OpenHAB permissions to access your dongle.

    1. Open your "Control Panel"
      Screenshot_20210126_204910
    2. Choose "Task Scheduler"
      Screenshot_20210126_212029
    3. Create a new "Triggered Task" based on a "User-defined script".
      Screenshot_20210126_212128
    4. Call the rule "openHAB Enable serial", choose as user root and ensure the event "Boot-up" is selected.
      Screenshot_20210126_212319
    5. Continue in the "Task Settings" tab and insert 'bash /var/packages/openHAB/target/helper/serial-enable.sh' as user-defined script.
      Screenshot_20210126_212343
    6. You can find the content of the script for technical details here in the repo.

Troubleshooting

The openHAB log files can be found here:

  • /var/log/packages/openHAB.log - Made by Synology's software center
  • /var/packages/openHAB/userdata/logs/ - General logs made by openHAB instance
  • /var/packages/openHAB/openHAB.log - Log made by the service management

Contributing

GitHub issues GitHub forks GitHub stars

Contribution guidelines

Useful links: