Build Instructions

Collapse

• 1

  Instructions are at Github

  https://github.com/Web3-Pi/raspberry-pi-lcd-dashboard

  Requirements

  • Python >= 3.9
  • Run on Raspberry Pi 4 and 5
  • Raspberry Pi OS or Ubuntu
  • SPI interface enabled
  • 1.69" LCD display with ST7789V2 Driver
  • Waveshare 24382
  • Seeed Studio 104990802
  • (Optional) 3D printed model of Argon Neo 5 cover
  • (Optional) Argon Neo 5 enclosure

  
  Assembly

  
  1. Connect wires

  Connect the display to the Raspberry Pi according to the diagram below.

  The colors of the cables may vary depending on the supplier and batch. Focus on the function and pin number, not the color.

  The diagram is valid for Raspberry Pi 4 and Pi 5

  If on Raspberry Pi 5 your LCD backlight is flickering connect `BL` to `3.3V PIN 17`

  2. Mount display module

  Mount the display in the printed enclosure cover. The display is held in place by four clips. Make sure all 3D printing support residues are removed and the surface to which the display adheres is flat. Install the display by sliding one side under the clips first, then pressing the other side down. Do not use excessive force to avoid damaging the display. The display should fit in easily.

  Since each 3D printer may be calibrated differently, it may be necessary to adjust the scale of the 3D model in the slicer software before printing. Our prints are done on Original Prusa i3 MK3S+

  3. Mount enclosure cover

  Mount the enclosure cover and secure it with two screws. Make sure to arrange the cables inside the enclosure so they do not obstruct the fan and minimize interference with cooling.

  Installation

  To enable the display, the SPI interface must be enabled.To do this, execute the following command and then reboot the device:

  sudo sed -i '/^#dtparam=spi=on/s/^#//' /boot/firmware/config.txt
  sudo reboot

  
  Download the repository.

  sudo apt-get -y install git
  git clone https://github.com/Web3-Pi/raspberry-pi-lcd-dashboard.git

  Then, you can run the program as a service. The program will start automatically with the system startup.

  Alternatively, you can run it once. The program will stop when you close the console.

  Run as a service - (recommended)
  

  cd raspberry-pi-lcd-dashboard
  chmod +x *.sh
  sudo ./create_service.sh

  To stop the program, execute sudo systemctl stopdashboard.service
  To uninstall the service, execute sudo ./remove_service.sh

  or run one time

  If you do not want to run the program as a service, you can run it once.

  Note: Do not use both methods simultaneously.
  

  cd raspberry-pi-lcd-dashboard
  chmod +x *.sh
  sudo ./run.sh

  To stop the program, press Ctrl+C.

  Customization

  In the file `dashboard.py`, there is a flag SHOW_PER_CORE that determines whether the CPU usage percentage should be in the range of 0-100% or 0-400%.
  

  0-400% represents the sum load of each core in the Raspberry Pi.
  

  # Choose how to display CPU usage percentages
  SHOW_PER_CORE = False
  # False = [0 - 100%]
  # True  = [0 - 400%]

   
  note: Restart the service after making changes.
  

  sudo systemctl restart dashboard.service

  3D Model

  The models are free, so anyone can print them on a 3D printer.

  3D Printing

  We recommend printing with PETG filament due to the Raspberry Pi's high operating temperatures.

  To ensure the snap-fits print correctly, enable supports everywhere.

  Use a 0.4 mm nozzle.

  0.2 mm layer height or smaller.

  Our models are printed on Original Prusa i3 MK3S+

View all instructions