new-home-gpio
| Crates.io | new-home-gpio |
| lib.rs | new-home-gpio |
| version | 1.0.1 |
| source | src |
| created_at | 2020-05-21 21:59:36.618531 |
| updated_at | 2020-05-24 17:16:30.571782 |
| description | 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. |
| homepage | |
| repository | https://gitlab.com/Y_Software/new-home-gpio |
| max_upload_size | |
| id | 244328 |
| size | 26,192 |
(YannikSc)
documentation
README
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:
- An already setup new-home-core
- An already setup new-home-ui
- The IP of your Raspberry PI which runs the application
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.