Debian-Pi-Aarch64/docs/notes/hardware/SSD1306.md

231 lines
6.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

## 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
```
apt-get install python-pip python3-pip -y
python -m pip install --upgrade pip setuptools wheel
apt-get install python-pil python3-pil -y
pip3 install Adafruit_GPIO
pip3 install Adafruit_SSD1306
pip3 install Adafruit_BBIO
git clone https://github.com/adafruit/Adafruit_Python_SSD1306.git
cd Adafruit_Python_SSD1306
sudo python setup.py install
cd Adafruit_Python_SSD1306/examples/
cp Adafruit_Python_SSD1306/examples/stats.py /opt/
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)
```