rpi-pico-ssd1306-library's Introduction

Raspberry Pico SSD1306 + GFX Library

Based on Adafruit GFX Library https://github.com/adafruit/Adafruit-GFX-Library

Usage

Hardware

Connect your SSD1306 oled display to i2c1 port (you can change it during initialization)

SDA->GPIO2
SCL->GPIO3
GND->GND
VCC->3V3(OUT)

Software

The library needs only two files to run SSD1306.hpp and SSD1306.cpp. This gives you the ability to display a bitmap or array of pixels. You need the GFX library to make it easier to create images for your display. (GFX.hpp and GFX.cpp)

logo.hpp is an example showing how to create bitmaps. fonts.hpp contains one font.

Example

Repo provides an example of how a library can be used.

git clone https://github.com/mbober1/RPi-Pico-SSD1306-library.git
cd RPi-Pico-SSD1306-library/example/
mkdir build
cd build

Change path to pico-sdk in CMakeLists.txt (line 3)

cmake ..
make -j4

Make your own logo

http://www.majer.ch/lcd/adf_bitmap.php

Features

Support 128x32 displays
DMA Support
Description of each function

rpi-pico-ssd1306-library's People

Contributors

Stargazers

Watchers

rpi-pico-ssd1306-library's Issues

Height pixels divided by 2

I have a RPi Pico and a I2C 0.91" oled 128x32 display.

With this code the result is a reactangle of 10x5 instead of 10x10 (see image). The second block exceed the vertical no of pixels. Counting the shown vertical pixel it are 16 instead of 32.

    i2c_init(i2c1, 100000);
    gpio_set_function(2, GPIO_FUNC_I2C);
    gpio_set_function(3, GPIO_FUNC_I2C);
    gpio_pull_up(2);
    gpio_pull_up(3);

    GFX oled(0x3C, 128, 32, i2c1);
    oled.clear();
    oled.drawFillRectangle(0, 0, oled.getWidth(), oled.getHeight(), colors::BLACK);
    oled.drawFillRectangle(0, 0, 10, 10, colors::WHITE);
    oled.drawFillRectangle(5, 20, 20, 20, colors::WHITE);
    oled.display();

When I define the height as 64 I get an actual height of 32.

    GFX oled(0x3C, 128, 64, i2c1);
    oled.clear();
    oled.drawFillRectangle(0, 0, oled.getWidth(), oled.getHeight(), colors::BLACK);
    oled.drawFillRectangle(0, 0, 10, 10, colors::WHITE);
    oled.drawFillRectangle(5, 20, 20, 20, colors::WHITE);
    oled.drawFillRectangle(0, 20, 5, 30, colors::WHITE);
    oled.display();