This project is no longer actively worked on in favor of the new version made for Docker. NEW DOCKER VERSION AVAILABLE HERE
The PaPi and DMS LITE is a collaborative effort to collect all the data from a ClusterDuck Protocol network locally. It provides a local interface to see network activity and data traffic. The PaPi was brought to life for areas when there is no internet connection available at all. The PaPi can store data and act as a local MQTT broker to communicate with the PaPa Duck.
There are two different ways to get your data into the PaPi: using a USB Serial connection or WiFi. Using the serial connection, the Raspberry Pi reads the incoming messages from the serial monitor by a wired connection from the papaduck and writes the data into the database. Using the Wifi connection the Raspberry pi turns into an acces point. This allows the Papa Ducks to send data over WiFi to a MQTT broker that writes the data into the database.
The DMS LITE is the open source version of the cloud DMS. DMS LITE gives you simple network activity and data visuals.
The PaPa Duck is running a different Firmware than the regular ClusterDuck Protocol PaPa example.
Raspberry Pi (3B+ preffered)
Micro SD-Card 16GB or more
Mouse and Keyboard
Monitor
Wired Ethernet Connection
Latest Copy of ClusterDuck Protocol
The PaPi and DMS LITE both need some setup before you can start seeing your data. To turn the Raspberry Pi into the PaPi, you will need to install multiple modules.
Both Raspbian images have Python 2 preinstalled but Raspbian Lite does not have python 3 preinstalled. But you will need to set you Pi to use python 3 as default. We recommend using the latest release of Rasbian Desktop with recommened software.
python --version
* if you don't see python 3 continue on to 2.nano ~/.bashrc
alias python='/usr/bin/python3'
python --version
and you should see your default is python 3chmod u+x serial-install.sh
will make the code excutable ./Serial-install.sh
will make the code run The DMS Lite will automatically open in a full sized window.
The next time you boot the Pi CD into the DMS-LITE folder and run the following script.
chmod u+x run.sh
./run.sh
This will launch the scripts and bring you into kiosk mode. Which is full screen full resolution with no bars or anything. to exit out of this either reboot the pi or press fn f4 key to get back to desktop. In your Browser go to Localhost:3000 to see the dms-lite
NOTE: You need to run the two scripts in two separate terminals.
chmod u+x Wifi-install.sh
will make the code excutable ./Wifi-install.sh
will make the code run NOTE: You need an Internet Connection to install the packages and the DMS LITE application. After the Raspberry Pi is turned into an Access Point it doesn't have WiFi capabilities anymore and you will need a LAN connection for final setup.
After you have installed the required dependencies you can the two scripts.
python3 Wifi_sqlwriter.py
npm run start
In your Browser go to Localhost:3000 to see the dms-lite
NOTE: You need to run the two scripts in two separate terminals.