Files
bacnet_stack/apps/blinkt/README.md
T
Kari Argillander 369da70f2a Strip tabs and trailing white spaces, and fix end of files (#748)
* format: Strip trailing whitespaces

We want to get rid of trailing whitespaces completly as they make just git
noice. Much better to start using automated tools to get rid of them once and
not getting them back again. This way git history will be cleaner and review
easier.

Commit was generated with:

    pre-commit run --all-files trailing-whitespace

* format: Files should have exactly one new line end of them

It is good practice that every file has one new line. It is not now days so
mandatory but it also is not nice if file has lot of newlines end of it. We will
use pre-commit which takes automatically care about this so let's fix all.

Commit was generated with:

    pre-commit run --all-files end-of-file-fixer

* format: Convert tabs to spaces

Project mostly use spaces over tabs. When mixing tabs and spaces this usually
makes formatting issues and also when changing those in commits it will make lot
of git noise. We will force spaces most of the time and use pre-commit to fix.

Commit was generated with:

    pre-commit run --all-files remove-tabs

---------

Co-authored-by: Kari Argillander <kari.argillander@fidelix.com>
2024-08-25 14:13:57 -05:00

93 lines
2.5 KiB
Markdown

# Raspberry Pi connected to a Blinkt! RGB card demo
This demo includes a BACnet server with Color objects and service handlers
for the eight RGB (red-green-blue) LEDs attached to the Blinkt! card.
## Installation
The demo uses pigpiod (Pi GPIO Daemon) and developer library. To install
and run the daemon at powerup (and immediately):
$ sudo apt install libpigpio-dev libpigpiod-if-dev pigpiod
$ sudo systemctl enable pigpiod
$ sudo systemctl start pigpiod
## WiFi Power
If you are using a Raspberry Pi with WiFi, you will likely want
to disable WiFi Power saving. Under Raspberry Pi OS, so the following.
### Startup service in systemd
To manage to start programs you should use systemd Unit files.
File name: /etc/systemd/system/wlan0pwr.service
You can edit the file using the systemd edit:
rpi ~$ sudo systemctl --full --force edit wlan0pwr.service
In the empty editor insert these statements, save them and quit the editor:
[Unit]
Description=Disable wlan0 powersave
After=network-online.target
Wants=network-online.target
[Service]
Type=oneshot
ExecStart=/sbin/iw wlan0 set power_save off
[Install]
WantedBy=multi-user.target
Enable the new service with:
rpi ~$ sudo systemctl enable wlan0pwr.service
## Building the Blinkt! BACnet Application
Build from the root folder:
$ make blinkt
## Running the Blinkt! BACnet Application
Run from the bin/ folder:
$ ./bin/bacblinkt 9009
## Blinkt! as a Startup service with systemd
To manage to start programs you should use systemd Unit files.
Here is a very simple template you can use to start to solve your problem.
Create a new service with:
rpi ~$ sudo systemctl --full --force edit bacnet.service
In the empty editor insert these statements, save them and quit the editor:
[Unit]
Description=BACnet Service
After=network-online.target
[Service]
ExecStart=/home/pi/bacnet.sh
[Install]
WantedBy=network-online.target
Enable the new service after the next reboot with:
rpi ~$ sudo systemctl enable bacnet.service
Create your bacnet.sh shell script in your home folder (change from pi if
that is not your home folder). Use the shell script to set any environment
variables that you want, or configuration settings for the bin/bacblinkt
application such as a specific device ID.
A simplistic bacnet.sh script will look like this (with stdout/stderr to /dev/null):
#!/bin/bash
/home/pi/bacnet-stack/bin/bacblinkt 9009 > /dev/null 2>&1