Raspberry-ssd1306

ssd1306 Command Line Tool for RaspberryPi.
This may works with other boards like OrangePi/NanoPi.

You can operate from command line.
You can choose Hardware-SPI/Software-SPI/I2C Interface.

Software requirement

• WiringPi Library
  This project uses the wiringPiSetup() function to initialize GPIOs.
  If you use it on a board other than the RPI board, you may need to change the WiringPi number.
  As far as I know, there are these libraries.
  • WiringPi for OrangePi
  • WiringPi for BananaPi
  • WiringPi for NanoPi
  • WiringPi for Pine-64

Command line parameters

+1 String : String for #1 line(Use External Font)
+2 String : String for #2 line(Use External Font)
+3 String : String for #3 line(Use External Font)
+4 String : String for #4 line(Use External Font)
+a String : String for #1 line(Use Internal Font)
+b String : String for #2 line(Use Internal Font)
+c String : String for #3 line(Use Internal Font)
+d String : String for #4 line(Use Internal Font)
-1 : delete #1 line
-2 : delete #2 line
-3 : delete #3 line
-4 : delete #4 line
+R n : Set inverse mode #n Line
-R n : Unset inverse mode #n Line
+U n : Set underline mode #n Line
-U n : Unset underline mode #n Line
+L : Scroll Up 1Line
-L : Scroll Down 1Line
P1 n : Set start colum n to line#1
P2 n : Set start colum n to line#2
P3 n : Set start colum n to line#3
P4 n : Set start colum n to line#4
r : remove all string
s : show display

You can use within script.
#!/bin/bash
./oled r
./oled +1 "ABCDEFG"
./oled +2 "abcdefg"
./oled +3 "1234567"
./oled +4 "Hello World!!"
sudo ./oled s

Wire connection for Hardware SPI

(*)You can change to another pin.
#define RST 1 // You can change
#define DC 0 // You can change

Wire connection for Software SPI

(*)You can change to another pin.
#define MOSI 12 // You can change
#define SCLK 14 // You can change
#define RST 1 // You can change
#define DC 0 // You can change
#define CS 10 // You can change

Wire connection for I2C

Install SSD1306 for Hardware SPI (128x64)

git clone https://github.com/nopnop2002/Raspberry-ssd1306
cd Raspberry-ssd1306
cc -o oled oled.c fontx.c -lwiringPi -lpthread -DSPI
bash ./test.sh

Install SSD1306 for Hardware SPI (128x32)

git clone https://github.com/nopnop2002/Raspberry-ssd1306
cd Raspberry-ssd1306
cc -o oled oled.c fontx.c -lwiringPi -lpthread -DSPI -DX32

The number of lines which can be indicated is only 2 lines.

Install SH1106 for Hardware SPI (128x64)

git clone https://github.com/nopnop2002/Raspberry-ssd1306
cd Raspberry-ssd1306
cc -o oled oled.c fontx.c -lwiringPi -lpthread -DSPI -DOFFSET=2
bash ./test.sh

Left:1.3 inch SH1106
Right:0.96 inch SSD1306

Install SSD1306 for Software SPI (128x64)

git clone https://github.com/nopnop2002/Raspberry-ssd1306
cd Raspberry-ssd1306
cc -o oled oled.c fontx.c -lwiringPi -lpthread -DSOFT_SPI
bash ./test.sh

Install SSD1306 for Software SPI (128x32)

git clone https://github.com/nopnop2002/Raspberry-ssd1306
cd Raspberry-ssd1306
cc -o oled oled.c fontx.c -lwiringPi -lpthread -DSOFT_SPI -DX32

Install SH1106 for Software SPI (128x64)

git clone https://github.com/nopnop2002/Raspberry-ssd1306
cd Raspberry-ssd1306
cc -o oled oled.c fontx.c -lwiringPi -lpthread -DSOFT_SPI -DOFFSET=2
bash ./test.sh

Install SSD1306 for I2C (128x64)

git clone https://github.com/nopnop2002/Raspberry-ssd1306
cd Raspberry-ssd1306
cc -o oled oled.c fontx.c -lwiringPi -lpthread -DI2C
bash ./test.sh

Install SSD1306 for I2C (128x32)

git clone https://github.com/nopnop2002/Raspberry-ssd1306
cd Raspberry-ssd1306
cc -o oled oled.c fontx.c -lwiringPi -lpthread -DI2C -DX32

The number of lines which can be indicated is only 2 lines.

Install SH1106 for I2C (128x64)

git clone https://github.com/nopnop2002/Raspberry-ssd1306
cd Raspberry-ssd1306
cc -o oled oled.c fontx.c -lwiringPi -lpthread -DI2C -DOFFSET=2
bash ./test.sh

Left:1.3 inch SH1106
Right:0.96 inch SSD1306

Change font style

You can choose the font style.
Please change here.

  // You can change font file
  Fontx_init(fx,"./fontx/ILGH16XB.FNT","./fontx/ILGZ16XB.FNT"); // 16Dot Gothic
//  Fontx_init(fx,"./fontx/ILMH16XB.FNT","./fontx/ILMZ16XB.FNT"); // 16Dot Mincyo

Font File

You can add your original fonts.
The format of the font file is the FONTX format.
Your font file is put in fontx directory.

Please refer this page about FONTX format.

Font File Editor(FONTX Editor)

There is a font file editor.
This can be done on Windows 10.
Developer page is here.

This tool uses the following as default fonts:

• fontx/ILGH16XB.FNT // 8x16Dot Gothic
• fontx/ILMH16XB.FNT // 8x16Dot Mincyo

Changing this file will change the font.

Left : OrangePi + SPI Module
Right : RaspberryPi + I2C Module

Line1-2 : External Font
Line3-4 : Internal Font

Underline and Invert

Set start colum

RaspberryPi ZERO HAT + OLED

OrangePi ZERO HAT + OLED