Let's get started.
Step 1: A Complete Video
This video explains all steps in 5 mins. Take a look.
Step 2: Required Items
The following is a list of required items:
- Raspberry Pi + WiFi dongle or Raspberry Pi 3
- Raspberry Pi power supply
- 16 GB microSD card
- microSD card reader
- 126x64 SPI OLED display
- Female to female jumper wires
You will also need a laptop or a PC to setup and access the Raspberry Pi.
Step 3: Flash Raspbian to Your MicroSD Card
Description: First thing we need to do is flash Raspbian on a microSD card. So head to www.raspberrypi.org and download latest version of Raspbian and extract it from the zip file. Now insert an empty microSD card in the microSD card reader. Connect the microSD card reader to your laptop or PC. Bring up the etcher application and burn the extracted Raspbian image on your microSD card.
Step 4: Configure Raspbian for WiFi and SSH
Description: To configure WiFi, open up a terminal on a Linux machine and become root user, cd into Raspbian's root directory. If you are on a Windows machine, open up Raspbian's root directory as administrator. Modify file /etc/network/interfaces as shown in the first image, i.e. change lines for wlan0 to:
iface wlan0 inet dhcp
This will allow your router to assign a random IP address to your Raspberry Pi, but we haven't specified SSID and password for your router, right. The /etc/wpa_supplicant/wpa_supplicant.conf file lets us do exactly that. Look at the second image.
To enable SSH which we will use to securely access headless Raspberry Pi. Create an empty file called 'ssh' in boot directory of Raspbian.
Finally, unmount microSD card from your machine and take it out from the card reader to put it in Raspberry Pi.
Step 5: Connect OLED to Raspberry Pi
Description: Connect SPI OLED display to your Raspberry Pi according to attached image.
Step 6: Finding IP Address of Raspberry Pi
Description: Once OLED is connected to the Raspberry Pi, power on the Raspberry Pi. As we have enabled DHCP, the router will assign a random IP address depending on availability to Raspberry Pi. To securely access a headless Raspberry Pi, we will use SSH for which we will need IP address of Raspberry Pi. To find the IP address of the Raspberry Pi, use applications like angry IP scanner which scans your network for active devices. The attached image shows angry IP scanner showing the IP address of a Raspberry Pi.
Step 7: Enable SPI Interface on Your Raspberry Pi
Description: Once you have IP address of raspberry pi, ssh into your raspberry pi. First thing to do is enable SPI interface.
- Once you are in the Raspberry Pi using 'ssh pi@---.---.---.---', type 'sudo raspi-config ' to get a menu
- Select 'Interfacing Options'
- Select 'SPI'
- It will ask 'Would you like SPI interface to be enabled' select 'yes'
- A confirmation image will appear
- Exit the menu
- Reboot your raspberry pi using 'sudo reboot '
Step 8: Getting Git Repos
Description: Once rebooted, ssh into Raspberry Pi one more time. Now we need to download two git repos. First is from the raspberry pi guy which does handling of SPI interface and second is mine which enables the OLED vital monitor.
- Clone the raspberry pi guys repo using:
- Once done you will see a directory called OLED in your home directory, go inside OLED directory using 'cd'
- You will find a file called OLEDinstall.sh, run it using 'sh OLEDinstall.sh',
- Now clone my git repo using:
- Once done you will find a directory called Raspberry-pi-vital-monitor-via-OLED, cd into it to find a file called OLEDMem_cpu.py that's our master file.
- Copy OLEDMem_cpu.py file to python_examples directory in OLED directory.
- Run this python script using:
sudo python /home/pi/OLED/python-examples/OLEDMem_cpu.py --sleep_time 1
- Script will error out saying 'mpstat: not found', to resolve it install package names sysstat using 'sudo apt-get install sysstat'
- On running OLEDMem_cpu.py one more time you should see a beautiful OLED screen with your Raspberry Pi's stats on it.
I have also included an rc.local file in git repo, you can replace it with file of same name in /etc directory to turn this monitor on every time Raspberry Pi boots automatically.
That's it folks, I hope you liked it. Let me know your experience. BYE.