1 - Hardware
0.96inch OLED Module MC096GX
| Name |
Color 1 |
Color 2 |
Color 3 |
| Disp Color |
white |
blue |
yellow/blue Double Color |
| SKU |
MC096GW |
MC096GB |
MC096GY |
| item |
content |
| Size |
0.96(inch) |
| Type |
OLED |
| OLED Chip |
SSD1306 |
| Resolution |
128*64 (Pixel) |
| Module Port |
IIC，①-GND,②-VCC,③-SCL,④-SDA |
| Disp Area |
21.744x10.864(mm) |
| Module Size |
27.3x27.8(mm) |
| Viewing Angle |
>160° |
| Work Temp. |
-20℃~60℃ |
| Save Temp. |
-30℃~70℃ |
| Operating Volt. |
3.3V / 5V |
| Power Consumption |
To be determined |
| Product weight (including packaging） |
8 (g) |
| PIN |
Mode |
Note |
| 1 |
GND |
OLED Power Ground |
| 2 |
VCC |
OLED Power (3.3V~5V) |
| 3 |
SCL |
OLED IIC BUS timer signal |
| 4 |
SDA |
OLED IIC BUS date signal |
2 - Raspberry Pi 4B
(1). I2C Config
cat /boot/config.txt | grep i2c_arm
dtparam=i2c_arm=on
(2). PIN Connect
| PI GPIO NO. |
OLED |
PI |
| GND |
GND |
1 |
| 3 |
VCC |
3V3 |
| 5 |
SDA |
SDA |
| 9 |
SCL |
SCL |
(3). Install
sudo apt-get install python-pip python3-pip -y
sudo python -m pip install --upgrade pip setuptools wheel
sudo apt-get install python-pil python3-pil -y
sudo pip install Adafruit_GPIO
sudo pip install Adafruit_SSD1306
sudo pip install Adafruit_BBIO
git clone https://github.com/adafruit/Adafruit_Python_SSD1306.git
cd Adafruit_Python_SSD1306
sudo python setup.py install
sudo pip install RPi.GPIO
cd Adafruit_Python_SSD1306/examples/
cp Adafruit_Python_SSD1306/examples/stats.py /opt/
sudo python /opt/stats.py
(4). stats.py
# Copyright (c) 2017 Adafruit Industries
# Author: Tony DiCola & James DeVito
#
# Permission is hereby granted, free of charge, to any person obtaining a copy
# of this software and associated documentation files (the "Software"), to deal
# in the Software without restriction, including without limitation the rights
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
# copies of the Software, and to permit persons to whom the Software is
# furnished to do so, subject to the following conditions:
#
# The above copyright notice and this permission notice shall be included in
# all copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
# THE SOFTWARE.
import time
import Adafruit_GPIO.SPI as SPI
import Adafruit_SSD1306
from PIL import Image
from PIL import ImageDraw
from PIL import ImageFont
import subprocess
# Raspberry Pi pin configuration:
RST = None # on the PiOLED this pin isnt used
# Note the following are only used with SPI:
DC = 23
SPI_PORT = 0
SPI_DEVICE = 0
# Beaglebone Black pin configuration:
# RST = 'P9_12'
# Note the following are only used with SPI:
# DC = 'P9_15'
# SPI_PORT = 1
# SPI_DEVICE = 0
# 128x32 display with hardware I2C:
#disp = Adafruit_SSD1306.SSD1306_128_32(rst=RST)
# 128x64 display with hardware I2C:
#disp = Adafruit_SSD1306.SSD1306_128_64(rst=RST)
# Note you can change the I2C address by passing an i2c_address parameter like:
disp = Adafruit_SSD1306.SSD1306_128_64(rst=RST, i2c_address=0x3C)
# Alternatively you can specify an explicit I2C bus number, for example
# with the 128x32 display you would use:
# disp = Adafruit_SSD1306.SSD1306_128_32(rst=RST, i2c_bus=2)
# 128x32 display with hardware SPI:
# disp = Adafruit_SSD1306.SSD1306_128_32(rst=RST, dc=DC, spi=SPI.SpiDev(SPI_PORT, SPI_DEVICE, max_speed_hz=8000000))
# 128x64 display with hardware SPI:
# disp = Adafruit_SSD1306.SSD1306_128_64(rst=RST, dc=DC, spi=SPI.SpiDev(SPI_PORT, SPI_DEVICE, max_speed_hz=8000000))
# Alternatively you can specify a software SPI implementation by providing
# digital GPIO pin numbers for all the required display pins. For example
# on a Raspberry Pi with the 128x32 display you might use:
# disp = Adafruit_SSD1306.SSD1306_128_32(rst=RST, dc=DC, sclk=18, din=25, cs=22)
# Initialize library.
disp.begin()
# Clear display.
disp.clear()
disp.display()
# Create blank image for drawing.
# Make sure to create image with mode '1' for 1-bit color.
width = disp.width
height = disp.height
image = Image.new('1', (width, height))
# Get drawing object to draw on image.
draw = ImageDraw.Draw(image)
# Draw a black filled box to clear the image.
draw.rectangle((0,0,width,height), outline=0, fill=0)
# Draw some shapes.
# First define some constants to allow easy resizing of shapes.
padding = -2
top = padding
bottom = height-padding
# Move left to right keeping track of the current x position for drawing shapes.
x = 0
# Load default font.
font = ImageFont.load_default()
# Alternatively load a TTF font. Make sure the .ttf font file is in the same directory as the python script!
# Some other nice fonts to try: http://www.dafont.com/bitmap.php
# font = ImageFont.truetype('Minecraftia.ttf', 8)
while True:
# Draw a black filled box to clear the image.
draw.rectangle((0,0,width,height), outline=0, fill=0)
# Shell scripts for system monitoring from here : https://unix.stackexchange.com/questions/119126/command-to-display-memory-usage-disk-usage-and-cpu-load
cmd = "hostname -I | cut -d\' \' -f1"
IP = subprocess.check_output(cmd, shell = True )
cmd = "top -bn1 | grep load | awk '{printf \"CPU Load: %.2f\", $(NF-2)}'"
CPU = subprocess.check_output(cmd, shell = True )
cmd = "free -m | awk 'NR==2{printf \"Mem: %s/%sMB %.2f%%\", $3,$2,$3*100/$2 }'"
MemUsage = subprocess.check_output(cmd, shell = True )
cmd = "df -h | awk '$NF==\"/\"{printf \"Disk: %d/%dGB %s\", $3,$2,$5}'"
Disk = subprocess.check_output(cmd, shell = True )
cmd = "echo $(uname -r |sed 's/Release-OPENFANS+//'|sed 's/v8//'|sed 's/202.//')$(cat /boot/version|awk -F'-' '{print $6}')"
Ver = subprocess.check_output(cmd, shell = True )
cmd = "/usr/bin/get_cpu|grep Freq|awk '{print $3}'|sed 's/Mhz/ Mhz/'"
Freq = subprocess.check_output(cmd, shell = True )
cmd = "/usr/bin/get_cpu|grep Temp|awk '{print $3}'"
Temp = subprocess.check_output(cmd, shell = True )
# Write two lines of text.
draw.text((x, top+0), "Freq: " + str(Freq), font=font, fill=255)
draw.text((x, top+8), "Temp: " + str(Temp), font=font, fill=255)
draw.text((x, top+16), str(CPU), font=font, fill=255)
draw.text((x, top+25), str(MemUsage), font=font, fill=255)
draw.text((x, top+35), str(Disk), font=font, fill=255)
draw.text((x, top+45), "IP: " + str(IP), font=font, fill=255)
draw.text((x, top+55), "Ver: " + str(Ver),font=font, fill=255)
# Display image.
disp.image(image)
disp.display()
time.sleep(.1)