new-home-gpio

Crates.ionew-home-gpio
lib.rsnew-home-gpio
version1.0.1
sourcesrc
created_at2020-05-21 21:59:36.618531
updated_at2020-05-24 17:16:30.571782
descriptionThis is the first application of the new-home system. It controls the GPIO outputs of the Raspberry PI with the help of the sysfs.
homepage
repositoryhttps://gitlab.com/Y_Software/new-home-gpio
max_upload_size
id244328
size26,192
(YannikSc)

documentation

README

Pipeline Status creates.io

New Home GPIO

This is the first application of the new-home system. It controls the GPIO outputs of the Raspberry PI with the help of the sysfs.

Features

Feature Status
Turn a GPIO on/off done
Toggle a GPIO pin done
A channel builder is available in the settings view done
A PWM mode for better handling with PWM devices (like dimming an LED) next

Channel builder

To use the channel builder, you just click on the registered application in the applications view. There you will find 3 combo-boxes which show you the available modes, GPIO pins and actions, which you can perform on a pin.

The shown numbers represent the GPIO pins by their BCM number. For more information on which pin has which number, you can check out https://pinout.xyz/.

Install and setup

Install

To install the application you have to run the (sudo) make install command in the project folder as the root user. This will install all necessary files where they are needed.

Configuration and resources of the application can be found in the /etc/new-home-gpio directory.

Setup

For the setup I assume, that you can, by yourself, connect and troubleshoot your devices to the Raspberry PI GPIO pins.

For this application to work you need some things:

The default port on which the application runs is the 4231, and it listens an all IPv4 and IPv6 interfaces/addresses on the Raspberry PI.

Setup is as easy as for all applications. Add a new application in the Applications view in the UI, enter a name for the application, and the IP:PORT for the Raspberry PI. Now you can add devices to rooms, which are running on the PI. If you need help with the required channel, you can take a look into the settings of the application, where you can find a channel builder.

Uninstall

To uninstall this application you can just run (sudo) make uninstall. This will remove the application and all its configuration permanently.

Footnote

Although the underlying framework (new-home-application and new-home-core) is not yet considered "stable" by the meaning of "api will not change" and "works without any crashes", this application, as it is, is considered stable under this term.

Commit count: 14

cargo fmt