Skip to content

Installation

Jump to bottom
Piotr Skowronek edited this page May 8, 2022 · 9 revisions
  • install Raspberry Pi OS Bullseye Raspbian Buster on SD card using this instruction
  • enable and configure WiFi before you start the system - more here
  • set user name and its password (since April 2022), check this instruction how to do it without Raspberry PI Imager
  • to have a proper access to UART for PM sensor, remove from /boot/cmdline.txt the following fragment console=serial0,115200
  • now boot your RPi from sdcard
  • find the IP of RPi by scanning your local network or take a look at your router to find a new device connected to your network
  • SSH to your raspberry: ssh [email protected]
  • Reconfigure your RPi to:
    • configure you Waveshare display and touch input - for 3.5inch Type A the instructions are here
      • if you experience problems running X on LCD, then you may try this or this(Guide 2, change fb0 to fb1)
    • boot into Desktop mode with a default user - follow these instructions
    • enable I2C - follow these instructions
    • turn off screen blanking, see this and a comment in this
    • reconfigure Alsa to use USB sound card by default - edit /usr/share/alsa/alsa.conf and set defaults.ctl.card and defaults.pcm.card to number returned from aplay -l for your chosen soundcard (more details here).
    • update speaker volume and microphone by using alsamixer
  • install git: sudo apt install git
  • being in home directory issue the following command to fetch this project: git clone https://github.com/pskowronek/home-air-quality-and-assistant.git
  • go to the project directory: cd ~/home-air-quality-and-assistant and run the installer: ./install.sh - this should hopefully walk you thru to install everything you need
    • if it fails then please try to analyze any error statements and follow instructions if provided
    • use Raspbian Buster. If you have Stretch then consider upgrading to Buster (quite good instructions are here)
    • before you report a bug, try to google it first :)
  • the installer above should ask you whether you want to register 3 services: visualizer, brightness, assistant (all of them are optional, for instance you can have the assistant without the other two). This will let those services to be automatically run when Raspberry boots up (more details here)
    • verify if any given service works by invoking the following command(s):
      • sudo systemctl start visualizer.service
      • sudo systemctl start brightness.service
      • sudo systemctl start assistant.service
    • reboot the device to verify if it works as expected
    • logs can be observed by tracing /var/log/syslog: sudo tail -f /var/log/syslog
  • follow these schemes how to connect all the things together (some soldering might be required)
Clone this wiki locally