Hardware Projects¶

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 Remote.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 i --no-audit node-red@latest
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.

Newer Node-RED versions might require a newer Node.js version. If this is the case, to update Node.js as well, easiest is to reinstall Node-RED. Your additional plugins, data and configs are preserved:

dietpi-software reinstall 122

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 mosquitto 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 <new_user_name>

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

The web interface uses port 9443:

• URL: https://<your.IP>:9443/admin (You may ignore the browser warning, as a self-signed certificate is used by default.)
• Email address: admin@blynk.cc
• Password: <your global password> (default: dietpi)

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

/mnt/dietpi_userdata/blynk

Logs can be viewed via:

journalctl -u blynkserver

and more detailed log files in:

/var/log/blynk

We created a systemd service for Blynk, automatically started by DietPi at boot:

systemctl status blynkserver

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

To change settings you need to edit

/mnt/dietpi_userdata/blynk/server.properties

and restart the Blynk server:

systemctl restart blynkserver

1. Download the Blynk app for Android: https://play.google.com/store/apps/details?id=cc.blynk
2. To log into your own server, press Log In, then the three dots at the bottom and switch the slider to CUSTOM.
3. There you can enter your own Blynk server’s IP/domain and use the above login credentials.
4. Create a new project by following this guide: https://docs.blynk.io/en/getting-started/what-do-i-need-to-blynk
5. The authentication token for the new project can be obtained from the app and as well from the web interface at Users > admin@blynk.cc within the Profile DashBoards section. Use it to connect with your Blynk library Node scripts.

Once you created a project in the iOS/Android app, you may test the connection via /mnt/dietpi_userdata/blynk/client-tcp-local.js. You need to edit the file and replace YOUR_AUTH_TOKEN with the authentication token of your project. Then run it:

/mnt/dietpi_userdata/blynk/client-tcp-local.js

Within the script you can also define event listeners and handlers. By default the value of the virtual pin V1 is printed to console when it changes, and the value of the virtual pin V9 is set to system time seconds whenever the pin is read. For a more interactive test you could hence add the following widgets to your project via app:

1. Add a Button and change its OUTPUT pin to Virtual > V1. Go back and hit the play button. Whenever you push the button in the app, the test script console should print the value changes as defined.
2. Hit the stop button. Add a Value Display, change its INPUT pin to Virtual > V9 and the READING RATE to 1 sec. Go back and hit the start button. While the test script is running, the display widget will not show the server’s system time seconds, updated every 1-2 seconds.

Hit Ctrl+C to exit the test script.

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> (default: dietpi)

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