Comments: Qwiic Micro OLED Hookup Guide

I am now talking to the OLED from a C/C++ program on the Raspberry Pi 3 B+.

There is no data register, so you can skip that part of the initialization and just do the rest. Despite what the data sheet says, the OLED is 64x48, as stated in the product description. The DRAM buffer appears to be 128x64 (8 pages by 128 columns). The DRAM for the display starts on page 2 and column 32.

Here are the key bits of code:

#include <unistd.h>
#include <wiringPiI2C.h>

#define addrOLEDJumperOpen   0x3D
#define addrOLEDJumperClosed 0x3C

#define ctrlCommand 0x00
#define ctrlData    0x40

m_addrI2C = fJumperClosed ? addrOLEDJumperClosed : addrOLEDJumperOpen;

m_fd = wiringPiI2CSetup(m_addrI2C);

void OLED::SetPageAddress(uint8_t page)
{
    Assert(0 <= page && page < cpageDisplayBuffer);
    page += 2;
    SendCommand(0xB0 + page);
}

void OLED::SetColumnAddress(uint8_t col)
{
    Assert(0 <= col && col < ccolDisplayBuffer);
    col += 32;
    SendCommand(0x10 + (col>>4));
    SendCommand(0x00 + (col&0x0f));
}

void OLED::SendCommand(uint8_t cmd)
{
    wiringPiI2CWriteReg8(m_fd, ctrlCommand, cmd);
}

void OLED::SendData(uint8_t b)
{
    wiringPiI2CWriteReg8(m_fd, ctrlData, b);
}

Just to follow up, here's a basic hello_world.py example using the luma.oled library to run the Qwiic Micro OLED on a Raspberry Pi 3:

#!/usr/bin/env python

from luma.core.interface.serial import i2c
from luma.core.render import canvas
from luma.oled.device import ssd1306

# define device for Qwiic Micro OLED
serial = i2c(port=1, address=0x3D)
device = ssd1306(serial, width=64, height=48, rotate=0)


def main():
      #repeat until Ctrl-C keyboard interrupt
      while True:
           with canvas(device) as draw:
               draw.rectangle(device.bounding_box, outline="white", fill="black")
               draw.text((10, 2), "Hello,", fill="white")
               draw.text((10, 12), "World!", fill="white")

 if __name__ == "__main__":
     try:
          main()
     except KeyboardInterrupt:
          pass

I got the Qwiic Micro OLED with a Raspberry Pi bundle, but the sample code here is for Arduino. Is there's a corresponding library and sample code for the Pi? I've read up on the wiringPi library and the SSD1306 data sheet, but I'm not having any luck getting it to work.