Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gavinlyonsrepo/ssd1306_oled_rpi
C++ Library to support the I2C 128X64 OLED Display Module driven by the SSD1306 controller for the Raspberry pi SBC eco-system.
https://github.com/gavinlyonsrepo/ssd1306_oled_rpi
128x32 128x64 128x64oled cpp display display-library i2c-bus library oled oled-display oled-display-ssd1306 oled-displays oled-ssd1306 raspberry raspberry-pi raspberry-pi-3 raspberrypi rpi ssd1306 ssd1306-oled
Last synced: about 1 month ago
JSON representation
C++ Library to support the I2C 128X64 OLED Display Module driven by the SSD1306 controller for the Raspberry pi SBC eco-system.
- Host: GitHub
- URL: https://github.com/gavinlyonsrepo/ssd1306_oled_rpi
- Owner: gavinlyonsrepo
- License: gpl-3.0
- Created: 2021-05-26T20:10:43.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-07-11T09:13:59.000Z (5 months ago)
- Last Synced: 2024-07-11T10:42:26.575Z (5 months ago)
- Topics: 128x32, 128x64, 128x64oled, cpp, display, display-library, i2c-bus, library, oled, oled-display, oled-display-ssd1306, oled-displays, oled-ssd1306, raspberry, raspberry-pi, raspberry-pi-3, raspberrypi, rpi, ssd1306, ssd1306-oled
- Language: C++
- Homepage: https://gavinlyonsrepo.github.io/
- Size: 298 KB
- Stars: 21
- Watchers: 4
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# SSD1306_OLED_RPI
## Table of contents
* [Overview](#overview)
* [Installation](#installation)
* [Test](#test)
* [Hardware](#hardware)
* [Software](#software)
* [API Documentation](#api-documentation)
* [I2C](#i2c)
* [Fonts](#fonts)
* [Bitmaps](#bitmaps)
* [Output](#output)
* [Notes and issues](#notes-and-issues)
## Overview
* Name : SSD1306_OLED_RPI
* Description :
0. Library to support the I2C 128X64 OLED Display Module
driven by the SSD1306 controller for the Raspberry PI.
1. Dynamic install-able system level Raspberry Pi C++ library.
2. Inverse color, rotate, sleep, scroll and contrast control.
3. Default font is Extended ASCII, scalable font.
4. 12 fonts included.
5. Graphics class included.
6. Bitmaps supported.
7. Hardware I2C
8. Also tested on 128X32 display size. Should work for 96X16 display size.
9. Dependency: bcm2835 Library
* Author: Gavin Lyons
* Development Tool chain.
1. Raspberry PI 3 model b
2. C++, g++ (Debian 12.2.0)
3. Raspbian , Debian 12 bookworm OS, , 64 bit.
4. kernel : aarch64 Linux 6.1.0-rpi7-rpi-v8
5. [bcm2835 Library 1.74 dependency](http://www.airspayce.com/mikem/bcm2835/). Provides low level I2C bus, delays and GPIO control.
## Installation
1. Install the dependency bcm2835 Library if not installed (See Notes and issues)
* The bcm2835 library is a dependency and provides I2C bus, delays and GPIO control.
* Install the C libraries of bcm2835, [Installation instructions here](http://www.airspayce.com/mikem/bcm2835/)
2. Download the SSD1306_OLED_RPI library
* Open a Terminal in a folder where you want to download,build & test library
* Run following command to download from github.
```sh
curl -sL https://github.com/gavinlyonsrepo/SSD1306_OLED_RPI/archive/1.6.1.tar.gz | tar xz
```
3. Run "make" to run the makefile in repo base folder to install library, it will be
installed to usr/lib and usr/include
```sh
cd SSD1306_OLED_RPI-1.6.1
make
sudo make install
```
## Test
1. Next step is to test OLED and installed library with an example.
Wire up your OLED. Next enter the examples folder and run the makefile in THAT folder,
This makefile builds the examples file using the just installed library.
and creates a test exe file in "bin".
The default example file is "hello world", user should see hello world on the OLED
by end of these steps.
```sh
cd examples/
make
make run
```
2. There are multiple examples files to try out.
To decide which one the makefile builds simply edit "SRC" variable at top of the makefile in examples folder.
in the "User SRC directory Option Section". Pick an example "SRC" directory path and ONE ONLY.
Comment out the rest and repeat: make and make run.
| Filepath | File Function | Screen Size |
| ---- | ---- | ---- |
| src/HELLO_WORLD | Basic use case | 128x64 |
| src/BITMAP | Shows use of bitmaps | 128x64 |
| src/CLOCK_DEMO | A basic clock Demo | 128x64 |
| src/OLED_FUNCTIONS |Test functions like scroll, rotate etc | 128x64 |
| src/SPEED_TEST | Frame rate per second test | 128x64 |
| src/TEXT_GRAPHICS |Tests Text , fonts and graphics | 128x64 |
## Hardware
Manufacturers diagram showing connections.
## Software
### API Documentation
The Software is commented for "doxygen". If users uses "doxygen" software
an application programming interface document can be generated.
### I2C
Hardware I2C.
1. I2C Address is set by default to 0x3C(your module could be different,
user can change argument passed into "OLEDbegin" method).
2. I2C Clock rate can be a passed into in the LCD class constructor method as a argument,
User can pass 1 of 4 BCM2835_I2C_CLOCK_DIVIDER values 2500, 626 150 or 148.
See image below.
3. In the event of an error writing a byte, debug info with error code will be written to console.
This error code is the bcm2835I2CReasonCodes enum. Debug flag must be set to true to see this output.
See image below for bcm2835I2CReasonCodes.
For more info on bcm2835I2CClockDivider & bcm2835I2CReasonCodes see [bcm2835 doc's for details](http://www.airspayce.com/mikem/bcm2835/group__constants.html)
### Fonts
Font data table:
| num | enum name | Char size XbyY | ASCII range | Size bytes | Scale-able |
| ------ | ------ | ------ | ------ | ------ | ----- |
| 1 | $_Default | 5x8 |0-0xFF, Full Extended|1275 |Y|
| 2 | $_Thick | 7x8 |0x20-0x5A, no lowercase letters |406|Y|
| 3 | $_SevenSeg | 4x8 |0x20-0x7A |360|Y|
| 4 | $_Wide | 8x8 |0x20-0x5A, no lowercase letters|464|Y|
| 5 | $_Tiny | 3x8 |0x20-0x7E |285|Y|
| 6 | $_Homespun | 7x8 |0x20-0x7E |658|Y|
| 7 | $_Bignum | 16x32 |0x2D-0x3A ,0-10 - . / : |896|N|
| 8 | $_Mednum | 16x16 |0x2D-0x3A ,0-10 - . / :|448|N|
| 9 | $_ArialRound| 16x24 | 0x20-0x7E |4608|N|
| 10 | $_ArialBold | 16x16 |0x20-0x7E |3072|N|
| 11 | $_Mia| 8x16 | 0x20-0x7E |1520|N|
| 12 | $_Dedica | 6x12 |0x20-0x7E |1152|N|
1. $ = OLEDFontType
2. A print class is available to print out many data types.
3. Fonts 1-6 are byte high(at text size 1) scale-able fonts, columns of padding added by SW.
4. Font 7-8 are large numerical fonts and cannot be scaled(just one size).
5. Fonts 9-12 large Alphanumeric fonts and cannot be scaled(just one size)
Font Methods:
| Font num | Method name| Size parameter | Notes |
| ------ | ------ | ------ | ------ |
| 1-6 | drawChar| Yes |draws single character |
| 1-6 | drawText | Yes|draws character array |
| 7-12 | drawChar| No|draws single character |
| 7-12 | drawText | No|draws character array |
| All | print | ~|Polymorphic print class which will print out most data types |
These methods return a enum( OLED_Return_Codes_e), non-zero in event of an error, see API doc., such as wrong font chosen , ASCII character outside
chosen fonts range, character out of screen bounds and invalid character array pointer object.
### Bitmaps
Two different bitmaps methods can be used.
| num | Method name | data addressing | Notes |
| ------ | ------ | ------ | ------ |
| 1 | OLEDBitmap() |horizontal| Draws bitmaps to the buffer |
| 2 | OLEDBuffer() |vertical | Write a full screen bitmap direct to screen, used internally|
Bitmaps can be turned to data [here at link]( https://javl.github.io/image2cpp/)
See example file "BITMAP" for more details.
## Output
Output of the example file "CLOCK_DEMO".
## Notes and issues
1. To test on a different size of display edit the myOLEDwidth & myOLEDheight
variables in examples files.
| Display size | Supported | Tested |
| ------ | ------ | ------ |
| 128x64 | Yes | Yes |
| 128x32 | Yes | Yes |
| ???x16 | Yes | NO |
## See Also
[Combined Display library 'Display_Lib_RPI'](https://github.com/gavinlyonsrepo/Display_Lib_RPI)