Repository files navigation

Simple library for using ssd1306 displays with the Raspberry Pi Pico and the pico-sdk.

• copyfont.h,ssd1306.c andssd1306.h to your project
• see example

• onlinedocumentation
• seessd1306.h and example

• setPICO_SDK_PATH
• gotoexample
• mkdir build && cd build && cmake .. && make
• copy thessd1306-example.uf2 to your Pico

The library can draw monochrome bitmaps using the functionsssd1306_bmp_show_image andssd1306_bmp_show_image_with_offset.

For converting an image to the supported format, you can do the following:

• installImageMagick
• useconvert you_image.png -monochrome your_image.bmp

For embedding your image, you can use tools likebin2c (included in thehxtools package on Debian).

Alternatively, you can you the version included in this repo:

• go in thetools/ directory
• make
• usage:./bin2c your_image.bmp your_image.h

You may also take a look at the example in theexample/ directory.

You can also use or own fonts when drawing withssd1306_draw_char_with_font orssd1306_draw_string_with_font.The format is:

1. a 1-D uint8_t array
2. structure of the array:
   1. the first element of the array is theheight
   2. the second element of the array is thewidth
   3. the third element of the array is theadditional spacing between chars
   4. the fourth element of the array is thethe first ascii character, this array stores
   5. the fifth element of the array is thethe last ascii character, this array stores
   6. the following elements encode the pixels of the characters vertically line by line (see); a line can be encoded as more than oneuint8_t values, when theheight is greater than 8;please look atfont.h and the fonts in theexample/ directory