Digistump Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
======Pro OLED Shield Kit Tutorial======

=====Product Description:=====
[[https://s3.amazonaws.com/digispark/images/m/oled1.JPG|{{https://s3.amazonaws.com/digispark/images/t/oled1.JPG}}]]
[[https://s3.amazonaws.com/digispark/images/m/oled2.JPG|{{https://s3.amazonaws.com/digispark/images/t/oled2.JPG}}]]

This is an unassembled kit and requires basic soldering. This is designed for use with the Digispark development board, which is not included.

=====Parts:=====

^ Part       ^ Quantity          ^Identification^
| Pro Combo PCB|1| |
| 4.7K (4K7) Ohm 1/4W resistor 1% or 5%|2| Yellow - Violet - Red|
| I2C OLED Module |1||
| 1x40pin male 0.1" pitch header| 21 pins worth| |


**Resistor Values:** For more information on how to identify the value of the resistors we recommend these sites:
A nice simple resistor calculator: http://www.ealnet.com/m-eal/resistor/resistor.htm
A comprehensive article on identification: http://www.diyaudioandvideo.com/Electronics/Color/

**Soldering:** If you are new to soldering we recommend the following tutorials:
Soldering Basics (http://www.sparkfun.com/tutorials/106) and Soldering Crash Course from the folks at Sparkfun (http://www.sparkfun.com/tutorials/354).
How to solder from the Curious Inventor: http://store.curiousinventor.com/guides/How_to_Solder

Adafruit has this excellent guide that starts with the tools needed and then shows detailed pictures, including some of the common problems that beginners experience (http://learn.adafruit.com/adafruit-guide-excellent-soldering)

**We assume for these assembly instructions that you know the basics of thru-hole soldering. If you don't check out the links above, these boards are very easy to solder - we promise!**


=====Assembly:=====


[[https://s3.amazonaws.com/digispark/images/m/oled1.JPG|{{https://s3.amazonaws.com/digispark/images/t/oled1.JPG}}]]

Solder resistors one at a time. Solder the leads and clip off the excess. Repeat for both resistors.

[[https://s3.amazonaws.com/digispark/images/m/comboi2c1.JPG|{{https://s3.amazonaws.com/digispark/images/t/comboi2c1.JPG}}]]


Cut two lengths of male headers each 9 pins long and one 3 pins long. Insert into corresponding positions (on the bottom of the board) and solder each pin.

**Tip:** Inserting the headers into a breadboard and then placing the board on top can make this process easier.

**Note:** If you are using stackable headers, use them here instead of the standard male headers.

[[https://s3.amazonaws.com/digispark/images/m/comboi2c2.JPG|{{https://s3.amazonaws.com/digispark/images/t/comboi2c2.JPG}}]]

Insert the OLED module into the front of the board matching the pins labeled for the OLED module. Solder the pins on the back, optionally snip off the excess.

[[https://s3.amazonaws.com/digispark/images/m/oled3.JPG|{{https://s3.amazonaws.com/digispark/images/t/oled3.JPG}}]]

[[https://s3.amazonaws.com/digispark/images/m/oled2.JPG|{{https://s3.amazonaws.com/digispark/images/t/oled2.JPG}}]]

=====Programming:=====

**CAN YOU HELP?** There is a mystery line of garbage that doesn't clear on the side of the screen - can you fix the library?

Grab the library at: https://github.com/Defragster/OLEDPRO
Move the MicroLCDpro folder into your arduino libraries folder

**Fix for garbage left after clear:** reduce the number of bytes per transfer block in MicroLCDPro.cpp/LCD_SSD1306::clear around line #630 (width >>= 4; make j go to 16 couple of lines further down).

See [[https://github.com/mschorer/MicrOledPro|MicrOledPro on github]] (yes, it's basically a fork, but it can be deployed directly into arduinos library folder)
Digistump Wiki

User Tools

Site Tools

Page Tools
