Published August 19, 2017 © CC0

128x64 OLED Display an Calliope Mini über I2C

Um ein paar Zeilen Text darzustellen, soll so ein schickes kleines OLED Display an den Calliope angeschlossen werden.

IntermediateWork in progress1 hour764

128x64 OLED Display an Calliope Mini über I2C

Things used in this project

Hardware components

Calliope mini

Seeed Studio SeeedStudio 4 Pin Female Jumper To Grove 4 Pin Conversion Cable

Amazon Product ID B01AD62W56

AZDelivery 1x 128 x 64 Pixel 0,96 Zoll OLED Display

Amazon Product ID B01L9GC470

Resistor 4.75k ohm

Pull up Widerstände laut Doku benötigt, ging aber auch so.

Software apps and online services

Calliope mini Calliope PXT Editor

Story

Auch bei diesem I2C Projekt war die erste Hürde, die richtige Initialisierung zu finden. Das verwendete OLED Display, bzw. der SSD1306 Treiber funktioniert hier so, dass ein einfacher Befehl ohne Parameter mit 0x00 angekündigt und danach übertragen wird, also 0x00AE für "Display Aus".

Ein Befehl mit Parameter wird in zwei Schritten übergeben: erst kommt 0x00, dann der Befehl, dann 0x00 und der Parameter, also 0x00D5 gefolgt von 0x0080 für eine SETDISPLAYCLOCKDIV von 0x80.

Die notwendigen Initialierungsbefehle und ihre Parameter habe ich hier entnommen (auch das .h File beachten): https://github.com/adafruit/Adafruit_SSD1306/blob/master/Adafruit_SSD1306.cpp

Andere Displays verlangen wohl 0x80, um einen Befehl bzw. dessen Parameter anzukündigen. In jedem Fall werden keine "Register" wie bei anderen I2C Geräten verwendet.

Bei der I2C Adresse gab es auch Verwirrung, in der Doku steht 0x3C oder 0x3D und hinten auf dem Display steht 0x78 oder 0x7A. Funktioniert hat dann 0x3C. Der Initialisierungscode spricht alle vier Adressen an. (Siehe Kommentare unten, es handelt sich um den Unterschied 7-Bit vs. 8-Bit Darstellung)

Um einen Text zu schreiben, kann man sich Buchstaben selber bauen: (ein vertikaler Strich ist 0xFF, muss mit 0x40 als Daten angekündigt werden, also als 16BE 0x40FF geschrieben werden; oder man sucht sich einen passenden Font. Hier habe ich einen gefunden, der funktioniert: https://github.com/achilikin/bdfe/blob/master/font88.h

Nach der Initialisierung die Position auf Null setzen und das Display löschen, siehe Code Beispiel.

Pull Up Widerstände: laut SSD1306 / OLED Display Dokumentation sind Pull Up Widerstände (z.B. 4.7k) zwischen VCC/3.3V und SCL sowie SDA notwendig, aber es hat bei mir mit einem kurzen Grove Kabel auch ohne funktioniert. Update: was daran liegen wird, dass auf dem Calliope Mini selbst Pull Up Widerstände drauf sind.

Hinweis: falls das Display nach der Initialisierung nicht aufleuchtet und Du Fehler in Deinem Code korrigiert hast, auf jeden Fall das Display vor einem neuen Versuch stromlos machen, um zu verhindern, dass das Display in einem unklaren Zustand keine Befehle mehr annimmt.

Update: in dem Code war das "Sonderzeichen" "<" (Kleiner) durch "<" ersetzt, keine Ahnung, wie das passiert ist: jetzt korrigiert.

let adr:number[]=[0x3C,0x3D,0x78,0x7A]
let ini:number[]=[0x00AE,0x00D5,0x0080,0x00A8,0x003F,0x00D3,0x0000,0x008D,0x0014,0x0020,0x0000,0x00A1,0x00C8,0x00DA,0x0012,0x0081,0x00CF,0x00D9,0x00F1,0x00DB,0x0040,0x00A4,0x00A6,0x002E,0x00AF,0x00A7]
for (let i = 0; i < adr.length; i++) {
    basic.showNumber(adr[i])
    for (let j = 0; j < ini.length; j++) {
        pins.i2cWriteNumber(adr[i], ini[j], NumberFormat.UInt16BE)
        control.waitMicros(40)
    }
}

// I2C Adresse setzen
let adr = 0x3C
// Display initialisieren
let ini: number[] =[0x00AE, 0x00D5, 0x0080, 0x00A8, 0x003F, 0x00D3, 0x0000, 0x008D, 0x0014, 0x0020, 0x0000, 0x00A1, 0x00C8, 0x00DA, 0x0012, 0x0081, 0x00CF, 0x00D9, 0x00F1, 0x00DB, 0x0040, 0x00A4, 0x00A6, 0x002E, 0x00AF]
for (let i = 0; i < ini.length; i++) {
    pins.i2cWriteNumber(adr, ini[i], NumberFormat.UInt16BE)
    control.waitMicros(40)
}
// Position auf 0 setzen und Display löschen
let cpn: number[] =[0x0021, 0x0000, 0x007F, 0x0022, 0x0000, 0x0007]
for (let j = 0; j < cpn.length; j++) {
    pins.i2cWriteNumber(adr, cpn[j], NumberFormat.UInt16BE)
}
for (let k = 0; k < 1023; k++) {
    pins.i2cWriteNumber(adr, 0x4000, NumberFormat.UInt16BE)
    control.waitMicros(40)
}
// HALLO schreiben
let hw: number[] =[0x4000, 0x407F, 0x4008, 0x4008, 0x4008, 0x4008, 0x4008, 0x407F, 0x4000, 0x4040, 0x4070, 0x401C, 0x4017, 0x401C, 0x4070, 0x4040, 0x4000, 0x407F, 0x4040, 0x4040, 0x4040, 0x4040, 0x4040, 0x4000, 0x4000, 0x407F, 0x4040, 0x4040, 0x4040, 0x4040, 0x4040, 0x4000, 0x4000, 0x401C, 0x4022, 0x4041, 0x4041, 0x4041, 0x4022, 0x401C]
for (let p = 0; p < hw.length; p++) {
    pins.i2cWriteNumber(adr, hw[p], NumberFormat.UInt16BE)
    control.waitMicros(40)
}

Credits

HHF

12 projects • 14 followers

"Papa, warum hast Du Dir auch einen Calliope gekauft?" - "Weil Ihr Eure ja nicht mehr hergebt!"

128x64 OLED Display an Calliope Mini über I2C

Things used in this project

Hardware components

Software apps and online services

Story

Code

Initialisierung des OLED Displays

Hallo auf das Display schreiben

Credits

HHF

Comments

Embed the widget on your own site

128x64 OLED Display an Calliope Mini über I2C

128x64 OLED Display an Calliope Mini über I2C

Things used in this project

Hardware components

Software apps and online services

Story

Code

Initialisierung des OLED Displays

Hallo auf das Display schreiben

Credits

HHF

Comments

Related channels and tags