Hardware Projects¶

Once DietPi has installed the Google AIY voice kit, and rebooted, you will need to setup your Google API account and link the device.

• Follow the link below, to setup Google API and download client keys, required to enable the speech API:
  https://aiyprojects.withgoogle.com/voice#users-guide-1-2--turn-on-the-google-assistant-api
  Remark: When setting up the activity controls, ensure you also enable “Include Chrome browsing history and activity from websites and apps that use Google services”, else she will not function ;)
• Make sure you have one of DietPi’s File Servers installed.
  Once completed, download the client_secret.json and save it to:
  • If using SSH = /mnt/dietpi_userdata/voice-recognizer-raspi/assistant.json
  • If using File Server = voice-recognizer-raspi/assistant.json

• Run the command below, then follow the onscreen link/instructions to setup verification:

  sudo -u dietpi /mnt/dietpi_userdata/voice-recognizer-raspi/env/bin/python3 -u /mnt/dietpi_userdata/voice-recognizer-raspi/src/main.py
  

• Once the “Ok, Google” prompt appears, test the device. Then you can terminate the program with Ctrl+C and restart the services:

dietpi-services restart

The voice software is located there:
/mnt/dietpi_userdata/voice-recognizer-raspi

To check the status of the service run:

dietpi-services status

1. Branch selection: For inexperienced users we recommend the master branch as well: Y
2. Auto updates: It slows down the the startup process a bit, but it anyway takes a while to load all skills, so we recommend this as well: Y
3. Add Mycroft commands to PATH: Chose NO here, since the installer runs as user mycroft, which is no login user, which is why this has no effect: N
4. Check code before submitting: If you are an official Mycroft developer, choose Y, else: N

1. If you did no reboot after install, load Mycroft commands to current shell session: . /etc/bashrc.d/mycroft.sh
2. Start CLI client: mycroft-cli-client
3. You should see and at best hear the invitation to pair your device, e.g.: PairingSkill - INFO - Pairing code: XXYYZZ
4. Visit https://home.mycroft.ai/ to start pairing and configuring your device and skills.

Remark: this requires about 3 GiB of RAM and takes a while, so assure that you have enough memory (4 GiB recommended), in case increase your swap file size and grab yourself a coffee.

cd /mnt/dietpi_userdata/mycroft-core
sudo -u mycroft ./scripts/install-mimic.sh $(nproc)

Our default installation does not include the desktop application. If required, please install a desktop first, then execute the following command to install the GUI afterwards:

apt install pijuice-gui

The PiJuice program can then be launched (LXDE) from LXDE start > Preferences

• SW1 = Power on unit
• SW2 = Power off unit (runs a sample script which can be modified /var/lib/dietpi/dietpi-software/installed/pijuice/pijuice_func1.sh)

• Additional configuration can be made via editing the following file (Full list of available config options):

  nano /var/lib/pijuice/pijuice_config.JSON
  

Restart the service to apply any changes:

systemctl restart pijuice

At the time of writing, this will update firmware on the device to V1.1_2018_01_15, however, please replace the firmware link with the latest version:

wget https://github.com/PiSupply/PiJuice/raw/master/Firmware/PiJuice-V1.1_2018_01_15.elf.binary -O package.binary
chmod +x package.binary
pijuiceboot 14 package.binary

The web interface is accessible via port 8002:

• URL = http://<your.IP>:8002
• Username = webiopi
• Password = raspberry

• Run webiopi-passwd
• Enter the username webiopi
• Enter your new password twice

You must also restart the webiopi service for your new password to take effect:

systemctl restart webiopi

To be able to access your WebIOPi interface over the internet, you may install Remot3.it (Weaved).

The web interface is accessible via port 1880:

• URL = http://<your.IP>:1880

To install the Node-RED dashboard, the user interface of Node-RED, use settings “Manage palette” from programming IDE or run the following command from console:

node-red-admin install node-red-dashboard

Use the following URL to connect to the dashboard from your browser:
https://<your.IP>:1880/ui/

Node-RED, all configs and data is stored in the following location:
/mnt/dietpi_userdata/node-red

To view Node-RED service logs, run the following command from console:

journalctl -u node-red

You can update Node-RED modules via programming IDE. To update the “node-red” core module, run the following command from console:

systemctl stop node-red
cd /mnt/dietpi_userdata/node-red
sudo -u nodered npm up --no-audit node-red
systemctl start node-red

The current Node-RED version can be read in the programming IDE in the burger menu at the right upper corner.

Mosquitto by default listens on network port 1883. Clients need to authenticate with the following credentials:

• Username: mosquitto
• Password: <your global password> (default: dietpi)

• Config directory: /etc/mosquitto
• Config file: /etc/mosquitto/mosquitto.conf
• Password file: /etc/mosquitto/passwd

To change the default authentication password for the dietpi user, run the following command:

mosquitto_passwd /etc/mosquitto/passwd mosquitto

To create a new authentication user, run the following command:

mosquitto_passwd /etc/mosquitto/passwd

After changes have been done, you need to restart the service:

systemctl restart mosquitto

For further details, see the official documentation, linked below.

To view Mosquitto server logs, run the following command:

journalctl -u mosquitto

Mosquitto is installed via its official APT repository, hence the following commands can be used to update it to the latest version:

apt update
apt install mosquitto

DietPi installs Blynk (including user data and config file) to the following location:
/mnt/dietpi_userdata/blynk

Log files can be found in:
/var/log/blynk

We created a systemd service for Blynk, DietPi will automatically start this:

systemctl status blynkserver

DietPi will also install Blynk JS Library, along with this installation. Please skip this section when you reach the Blynk user guide.

The web interface uses port 9443:

• URL = https://<your.IP>:9443/admin
• Default user: admin@blynk.cc
• Default password: admin

These values can be adjusted by editing the config file below.

Remark: The config file changes in the web UI do not have an effect yet: blynkkk/blynk-server#1318

To change settings you need to edit
/mnt/dietpi_userdata/blynk/server.properties
and restart the Blynk server:

systemctl restart blynkserver

To log into your own server, press Log In, then the three dots at the bottom and switch the slider to CUSTOM. There you can enter your own Blynk servers IP/domain and use the above login credentials.

You can then skip creating an external Blynk account and instead go on and create a new project directly: https://docs.blynk.cc/#getting-started-getting-started-with-the-blynk-app-2-create-a-new-project

Once you create a project in the iOS/Android app, run the command:

blynk-client <replace_with_your_auth_code>

Update Blynk with: dietpi-software reinstall 131.

A database server is required for Grafana. As Grafana offers many options (InfluxDB/MySQL), we have not automatically installed either as manual configuration may be preferred.
However, we highly recommend installing InfluxDB.

You can do this using the install steps provided by DietPi-Software tool or running the next command line in the terminal:

dietpi-software install 74

After the InfluxDB is installed, please follow the database creation guide here.

The web interface is accessible via port 3001:

• URL = http://<your.IP>:3001
• Username = admin
• Password = <your global password>

If you have created a database as per the InfluxDB online documentation, please follow these instructions:

• From the Home Dashboard click Add data source, then enter the following information:
  • Type = InfluxDB
  • URL = http://localhost:8086
  • Database = mydb
  • Username = test_user
  • Password = test_password01
  • Leave the remaining items with the default values.
• Click Save & Test
• From the Home Dashboard
  • click New dashboard
  • click Graph
  • click on the example graph
  • Press E to edit the Data Source and the custom query

The data location for Grafana is stored resp. linked with symbolic links to the DietPi userdata directory: /mnt/dietpi_userdata/grafana