bitbank2/oled_96

A simple C library (Linux + Arduino) for drawing text and graphics on SSD1306/SH1106 OLED displays

This code is now deprecated

Please use my newer OLED library --> ss_oled
It includes both Arduino and Linux support

https://github.com/bitbank2/ss_oled

** OLED_96 **

OLED_96 is a simple C library for working with SSD1306/SH1106 OLED displays when connected to the I2C bus. Tested on various ARM SBCs and Arduinos. The idea is to provide a simple interface for C programmers to make use of those low-cost OLED displays without having to read the data sheet or figure out I2C programming.

Written by Larry Bank
Project started 1/15/2017
[email protected]

Latest Changes:
---------------
The Linux version now supports the 3 display sizes
The Arduino version now includes support for my BitBang_I2C library so that any
two GPIO pins can be used to drive the display.
The library now supports 3 sizes of SSD1306 displays (and SH1106): 132x64, 128x64, 128x32, and 64x32

Features:
--------

• Efficient individual pixel drawing
  
• Small, Medium and large fonts (6x8, 8x8, 16x32)
  
• Invert and flip 180 options (entire display)
  
• Optional inverted text
  
• Brightness control
  
• Support for 64x32, 128x32, 128x64 and 132x64 (SH1106) displays
  
• Line draw function

*NEW* Display a Windows BMP (Arduino version).
This code was added to make it simpler to display a full screen logo bitmap by just copying a 1-bpp Windows BMP into the flash memory and calling 1 function.

If you find this code useful, please consider buying me a cup of coffee

oled_96's Issues

how to run it

Hi,

I have tried to run it from Ubuntu but I got:
-bash: ./sample: cannot execute binary file: Exec format error

before:
make
make sample
+x to sample
./sample

uname -m
returns: x86_64

file sample
returns: sample: ELF 64-bit LSB relocatable, x86-64, version 1 (SYSV), not stripped

Wrong channel in sample.c (Failed to open i2c bus)

Hey, thanks for sharing your library.
I just cloned it and wanted to give it a try, but I couldn't get it working at frist.

Before I spend any more time, I wanted to compile and test the example, so simply builded and ran it, without looking to closely at the other files. Unfortunately I kept getting "Failed to open i2c bus".

I thought it was a permission issue, but could not resolve it. Only later I saw that oledinit's first parameter is the channel, which is set to 0 in the example, eventhough the comment netxt to it says the call opens the bus on channel 1.

You might want to adjust that line from

i=oledInit(0, 0x3c, 0, 0); // for Raspberry Pi, use channel 1

i=oledInit(1, 0x3c, 0, 0); // for Raspberry Pi, use channel 1

Best regards
Daniel

syntax examples

Can you provide command and syntax examples for this?
The 'compact library' part is appealing, but needing to pick through the source to figure out how to use it is tedious. Or are there examples aside from https://github.com/bitbank2/oled_96/blob/master/sample.c that aren't linked here?

Installing on OpenWrt(LEDE)

Try to install the latest router OS OpenWrt/LEDE 17.04.1 on a Pi3, gaves me some errors because of the structure of OpenWrt, in makefile and make_sample:
in line 3

CFLAGS=-mfloat-abi=hard -c -Wall -O2

Otherwise I get the error "...uses VFP register arguments" during compile.
line 8 and 9:

sudo cp liboled96.a /usr/lib ;\
sudo cp oled96.h /usr/include

After these changes it works fine. But I have to start the sample executable with the interpreter like

/lib/ld-musl-armhf.so.1 --library-path /lib ./sample

So its not a big issue. Just inform y and others could run into the same.
BTW I would like to thank you for y effort to publish this stuff, it helps me in Pi programming a lot.

Best regards,
Nic

Licensing?

Hello Larry,

I would like to start a derivative project based on this code but I can't find a reference on what license is this code released on. Can you please set a license? I highly recommend MIT but of course you are free to choose.

Thanks.-

How to change display size linux

Hello,

I have tested your library and was trying to see how to change the display size from 128x64 to 128x32. I'be only just received my oled display today and when I ran the sample code only the big text is readable.
The rest is to compressed to read.

Thanks

Font change

Hi,

I would like to change font type to Adafruit_GFX Glyph types.
I have checked your font library. How did you created your font lib?
Do you any idea how can I use gfx fonts?

unvanted pixels are on the display

Hi,

do you have any idea why some unvanted pixels are on the display?
Around the text it looks like clean.

https://www.dropbox.com/s/ljl9jrj557sofiz/Display.jpeg?dl=0

EDIT: Invert mode has 7 extra lines after Fill display.

https://www.dropbox.com/s/njihbj1jj3luuix/DisplayInvert.jpeg?dl=0

Br, Zsolt