Repository files navigation

A Java library to drive the popular monochrome 128x64 pixel OLED display (SSD1306)from a Raspberry Pi. The display can be bought from Adafruit or from a lot of ebayvendors.

This is basically a rough port of Adafruit's SSD1306 library for Arduino whichcan be found here:https://github.com/adafruit/Adafruit_SSD1306

You can then use the library in your Maven projects like this (it's on Maven Central):

<dependency>    <groupId>de.pi3g.pi</groupId>    <artifactId>pi-oled</artifactId>    <version>1.2</version></dependency>

The hardware should be connected to the i2c bus. Where the i2c bus pinsare located can be looked up e.g. here:http://elinux.org/RPi_Low-level_peripherals#General_Purpose_Input.2FOutput_.28GPIO.29

Then you can use the library like this:

OLEDDisplay display = new OLEDDisplay();display.drawStringCentered("Hello World!", Font.FONT_5X8, 25, true);display.update();

Note that you always need to call update() after you changed the content of the displayto actually get the content displayed on the hardware.

Also note that the default constructor assumes you have connected the display toi2c port 1 and the display's i2c address is 0x3C. If this is not the case youcan use one of the constructors with more parameters.

The entire project is build with maven. Just clone the master branch, change to the cloned directory and run maven like this:

mvn install

This should build everything correctly.