{"id":858,"date":"2014-08-12T12:53:44","date_gmt":"2014-08-12T10:53:44","guid":{"rendered":"https:\/\/tinusaur.org\/?page_id=858"},"modified":"2022-01-01T23:04:05","modified_gmt":"2022-01-01T21:04:05","slug":"ssd1306xled","status":"publish","type":"page","link":"https:\/\/tinusaur.org\/projects\/ssd1306xled\/","title":{"rendered":"SSD1306xLED"},"content":{"rendered":"\n<p><strong><u>IMPORTANT UPDATE:<\/u><\/strong><\/p>\n\n\n\n<p>We are launching a crowdfunding campaign for the <a href=\"https:\/\/www.crowdsupply.com\/tinusaur\/oled-display-kit\">Tinusaur OLED Kit<\/a> based on the SSD1306 displays and this its page:&nbsp;<a href=\"https:\/\/www.crowdsupply.com\/tinusaur\/oled-display-kit\">https:\/\/www.crowdsupply.com\/tinusaur\/oled-display-kit<\/a>.<\/p>\n\n\n\n<p>There is also a short video explaining what is this new kit about:<\/p>\n\n\n\n<figure class=\"wp-block-embed-youtube wp-block-embed is-type-video is-provider-youtube wp-embed-aspect-16-9 wp-has-aspect-ratio\"><div class=\"wp-block-embed__wrapper\">\n<iframe loading=\"lazy\" title=\"Crowdfunding Campaign for the Tinusaur OLED Display Kit\" width=\"1200\" height=\"675\" src=\"https:\/\/www.youtube.com\/embed\/aVOKMeWRLFI?feature=oembed\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" allowfullscreen><\/iframe>\n<\/div><\/figure>\n\n\n\n<div style=\"height:100px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>Original page content below &#8230;<\/p>\n\n\n\n<hr class=\"wp-block-separator\" \/>\n\n\n\n<p>SSD1306xLED is a C library for working with the <a title=\"SSD1306 - 128 x 64, Dot Matrix OLED\/PLED Segment\/Common Driver with Controller\" href=\"http:\/\/www.solomon-systech.com\/en\/product\/display-ic\/oled-driver-controller\/ssd1306\/\" target=\"_blank\" rel=\"noopener\">SSD1306<\/a> display driver to control dot matrix <a title=\"organic light-emitting diode\" href=\"http:\/\/en.wikipedia.org\/wiki\/OLED\" target=\"_blank\" rel=\"noopener\">OLED<\/a>\/PLED 128&#215;64 displays. It is intended to be used with the Tinusaur board but should also work with any other board based on <a title=\"ATtiny85 - high-performance, low-power Atmel 8-bit AVR RISC-based microcontroller\" href=\"http:\/\/www.atmel.com\/devices\/attiny85.aspx\" target=\"_blank\" rel=\"noopener\">ATtiny85<\/a> or similar <a title=\"Microcontroller\" href=\"http:\/\/en.wikipedia.org\/wiki\/Microcontroller\" target=\"_blank\" rel=\"noopener\">microcontroller<\/a>.<\/p>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter\"><img loading=\"lazy\" decoding=\"async\" width=\"600\" height=\"450\" src=\"https:\/\/tinusaur.org\/wp-content\/uploads\/sites\/9\/2014\/08\/20140829_142451_ssd1306xled_04_cs600x450fx.png\" alt=\"SSD1306xLED library for OLED\/PLED 128x64\" class=\"wp-image-893\" srcset=\"https:\/\/tinusaur.org\/wp-content\/uploads\/sites\/9\/2014\/08\/20140829_142451_ssd1306xled_04_cs600x450fx.png 600w, https:\/\/tinusaur.org\/wp-content\/uploads\/sites\/9\/2014\/08\/20140829_142451_ssd1306xled_04_cs600x450fx-300x225.png 300w, https:\/\/tinusaur.org\/wp-content\/uploads\/sites\/9\/2014\/08\/20140829_142451_ssd1306xled_04_cs600x450fx-256x192.png 256w\" sizes=\"(max-width: 600px) 100vw, 600px\" \/><\/figure><\/div>\n\n\n\n<p>The 128\u00d764 OLED is controlled by a&nbsp;<a title=\"SSD1306 - 128 x 64, Dot Matrix OLED\/PLED Segment\/Common Driver with Controller\" href=\"http:\/\/www.solomon-systech.com\/en\/product\/display-ic\/oled-driver-controller\/ssd1306\/\" target=\"_blank\" rel=\"noopener\">SSD1306<\/a> circuit and could be interfaced over <a title=\"I\u00b2C (Inter-Integrated Circuit)\" href=\"http:\/\/en.wikipedia.org\/wiki\/I%C2%B2C\" target=\"_blank\" rel=\"noopener\">I\u00b2C<\/a>.<\/p>\n\n\n\n<p>The code could be divided in 3 pieces:<\/p>\n\n\n\n<ol><li>Communication over I\u00b2C with the SSD1306;<\/li><li>Sending graphical commands to the display;<\/li><li>High-level functions such as printing characters.<\/li><\/ol>\n\n\n\n<p>The I\u00b2C communication part is based on a code from the&nbsp;IIC_wtihout_ACK library that is available on the Internet but its original website (<a title=\"IIC_wtihout_ACK\" href=\"http:\/\/www.14blog.com\/archives\/1358\" target=\"_blank\" rel=\"noopener\">http:\/\/www.14blog.com\/archives\/1358<\/a>) is no longer functional. Basically, the&nbsp;SSD1306xLED library &nbsp;makes&nbsp;SSD1306&nbsp;to work with&nbsp;ATtiny85 and Tinusaur.<\/p>\n\n\n\n<h1 class=\"wp-block-heading\">How to use it<\/h1>\n\n\n\n<p>Using this library to control an OLDE display is very easy. The necessary header files that should be included with the program could be found in the source code repository &#8211; the link&nbsp;is&nbsp;at the bottom of this document.<\/p>\n\n\n\n<p>First, the controlling PINs should be specified in the source code:<\/p>\n\n\n<pre class=\"brush: cpp; title: ; notranslate\" title=\"\">\n#define SSD1306_SCL PB2 \/\/ SCL, Pin 3 on SSD1306 Board\n#define SSD1306_SDA PB0 \/\/ SDA, Pin 4 on SSD1306 Board\n<\/pre>\n\n\n\n<p>There are defaults, of course, but make sure they work for you.<\/p>\n\n\n\n<p>There is also I2C slave address specified in the source code but you probably don&#8217;t want to change that.<\/p>\n\n\n\n<p>Second, the display controller should be initialized.<\/p>\n\n\n<pre class=\"brush: cpp; title: ; notranslate\" title=\"\">\n_delay_ms(40);\nssd1306_init();\n<\/pre>\n\n\n\n<p>The delay is necessary if the initialization is at the beginning of the program. This is required&nbsp;by&nbsp;the&nbsp;SSD1306 circuit as it needs time to initialize itself after power-on.<\/p>\n\n\n\n<p>Then, the simplest example would be to clear the screen (fill it out with blanks) and output some&nbsp;text.<\/p>\n\n\n<pre class=\"brush: cpp; title: ; notranslate\" title=\"\">\nssd1306_fillscreen(0x00);\nssd1306_setpos(0, 10);\nssd1306_string_font6x8(&quot;Hello World!&quot;);\n<\/pre>\n\n\n\n<p>The <strong>ssd1306_string_font6x8<\/strong> function call will output at the specified by the <strong>ssd1306_setpos<\/strong> function&nbsp;coordinates the provided text using 6&#215;8 character font.<\/p>\n\n\n\n<p>Similarly, a bitmap could be output on the screen with the following code:<\/p>\n\n\n<pre class=\"brush: cpp; title: ; notranslate\" title=\"\">\nssd1306_draw_bmp(0,0,128,8, img1_128x64c1);\n<\/pre>\n\n\n\n<p>The above function call specifies (0,0) coordinates, width of 128 pixels and height of 8 bytes &#8211; 64 pixels.<\/p>\n\n\n\n<h1 class=\"wp-block-heading\">Documentation<\/h1>\n\n\n\n<p>This project often changes so more current information could be found in the source code repository &#8211; in the text files and source files as well.<\/p>\n\n\n\n<h1 class=\"wp-block-heading\">Source code<\/h1>\n\n\n\n<p>The source code along with very simple example is available on Bitbucket at this address:&nbsp;<a title=\"SSD1306xLED - Drivers for SSD1306 controlled dot matrix OLED\/PLED 128x64 displays\" href=\"https:\/\/bitbucket.org\/tinusaur\/ssd1306xled\" target=\"_blank\" rel=\"noopener\">https:\/\/bitbucket.org\/tinusaur\/ssd1306xled<\/a><\/p>\n\n\n\n<p>This&nbsp;SSD1306xLED library still needs more work and some improvements.<\/p>\n\n\n\n<figure class=\"wp-block-embed\"><div class=\"wp-block-embed__wrapper\">\nhttps:\/\/vine.co\/v\/OBuvIuhYdT7\n<\/div><\/figure>\n","protected":false},"excerpt":{"rendered":"<p>IMPORTANT UPDATE: We are launching a crowdfunding campaign for the Tinusaur OLED Kit based on the SSD1306 displays and this its page:&nbsp;https:\/\/www.crowdsupply.com\/tinusaur\/oled-display-kit. There is also a short video explaining what is this new kit about: Original page content below &#8230; SSD1306xLED is a C library for working with the SSD1306 display driver to control dot &#8230; <a title=\"SSD1306xLED\" class=\"read-more\" href=\"https:\/\/tinusaur.org\/projects\/ssd1306xled\/\" aria-label=\"Read more about SSD1306xLED\">Read more<\/a><\/p>\n","protected":false},"author":54,"featured_media":1700,"parent":654,"menu_order":11,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v22.3 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>SSD1306xLED - The Tinusaur Project<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/tinusaur.org\/projects\/ssd1306xled\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"SSD1306xLED - The Tinusaur Project\" \/>\n<meta property=\"og:description\" content=\"IMPORTANT UPDATE: We are launching a crowdfunding campaign for the Tinusaur OLED Kit based on the SSD1306 displays and this its page:&nbsp;https:\/\/www.crowdsupply.com\/tinusaur\/oled-display-kit. There is also a short video explaining what is this new kit about: Original page content below &#8230; SSD1306xLED is a C library for working with the SSD1306 display driver to control dot ... Read more\" \/>\n<meta property=\"og:url\" content=\"https:\/\/tinusaur.org\/projects\/ssd1306xled\/\" \/>\n<meta property=\"og:site_name\" content=\"The Tinusaur Project\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/tinusaur\/\" \/>\n<meta property=\"article:modified_time\" content=\"2022-01-01T21:04:05+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/tinusaur.org\/wp-content\/uploads\/sites\/9\/2016\/06\/20140829_142451_ssd1306xled_04_rcs1230x1230fx.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"1230\" \/>\n\t<meta property=\"og:image:height\" content=\"1230\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:site\" content=\"@tinusaur\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/tinusaur.org\/projects\/ssd1306xled\/\",\"url\":\"https:\/\/tinusaur.org\/projects\/ssd1306xled\/\",\"name\":\"SSD1306xLED - The Tinusaur Project\",\"isPartOf\":{\"@id\":\"https:\/\/tinusaur.org\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/tinusaur.org\/projects\/ssd1306xled\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/tinusaur.org\/projects\/ssd1306xled\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/tinusaur.org\/wp-content\/uploads\/sites\/9\/2016\/06\/20140829_142451_ssd1306xled_04_rcs1230x1230fx.jpg\",\"datePublished\":\"2014-08-12T10:53:44+00:00\",\"dateModified\":\"2022-01-01T21:04:05+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/tinusaur.org\/projects\/ssd1306xled\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/tinusaur.org\/projects\/ssd1306xled\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/tinusaur.org\/projects\/ssd1306xled\/#primaryimage\",\"url\":\"https:\/\/tinusaur.org\/wp-content\/uploads\/sites\/9\/2016\/06\/20140829_142451_ssd1306xled_04_rcs1230x1230fx.jpg\",\"contentUrl\":\"https:\/\/tinusaur.org\/wp-content\/uploads\/sites\/9\/2016\/06\/20140829_142451_ssd1306xled_04_rcs1230x1230fx.jpg\",\"width\":1230,\"height\":1230,\"caption\":\"Tinusaur SSD1306XLED SSD1306 OLED Display Llibary\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/tinusaur.org\/projects\/ssd1306xled\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/tinusaur.org\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Projects\",\"item\":\"https:\/\/tinusaur.org\/projects\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"SSD1306xLED\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/tinusaur.org\/#website\",\"url\":\"https:\/\/tinusaur.org\/\",\"name\":\"The Tinusaur Project\",\"description\":\"BE SMARTER! Make, play and learn with the Tinusaur microcontroller boards.\",\"publisher\":{\"@id\":\"https:\/\/tinusaur.org\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/tinusaur.org\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/tinusaur.org\/#organization\",\"name\":\"Tinusaur\",\"url\":\"https:\/\/tinusaur.org\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/tinusaur.org\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/org.tinusaur.net\/wp-content\/uploads\/sites\/9\/2018\/09\/cropped-tinusaur09a_c1440x1440t21.png\",\"contentUrl\":\"https:\/\/org.tinusaur.net\/wp-content\/uploads\/sites\/9\/2018\/09\/cropped-tinusaur09a_c1440x1440t21.png\",\"width\":512,\"height\":512,\"caption\":\"Tinusaur\"},\"image\":{\"@id\":\"https:\/\/tinusaur.org\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/www.facebook.com\/tinusaur\/\",\"https:\/\/twitter.com\/tinusaur\",\"https:\/\/www.instagram.com\/tinusaur\/\",\"https:\/\/www.linkedin.com\/company\/tinusaur\",\"https:\/\/www.pinterest.com\/tinusaur\/_created\/\",\"https:\/\/www.youtube.com\/tinusaur\"]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"SSD1306xLED - The Tinusaur Project","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/tinusaur.org\/projects\/ssd1306xled\/","og_locale":"en_US","og_type":"article","og_title":"SSD1306xLED - The Tinusaur Project","og_description":"IMPORTANT UPDATE: We are launching a crowdfunding campaign for the Tinusaur OLED Kit based on the SSD1306 displays and this its page:&nbsp;https:\/\/www.crowdsupply.com\/tinusaur\/oled-display-kit. There is also a short video explaining what is this new kit about: Original page content below &#8230; SSD1306xLED is a C library for working with the SSD1306 display driver to control dot ... Read more","og_url":"https:\/\/tinusaur.org\/projects\/ssd1306xled\/","og_site_name":"The Tinusaur Project","article_publisher":"https:\/\/www.facebook.com\/tinusaur\/","article_modified_time":"2022-01-01T21:04:05+00:00","og_image":[{"width":1230,"height":1230,"url":"https:\/\/tinusaur.org\/wp-content\/uploads\/sites\/9\/2016\/06\/20140829_142451_ssd1306xled_04_rcs1230x1230fx.jpg","type":"image\/jpeg"}],"twitter_card":"summary_large_image","twitter_site":"@tinusaur","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/tinusaur.org\/projects\/ssd1306xled\/","url":"https:\/\/tinusaur.org\/projects\/ssd1306xled\/","name":"SSD1306xLED - The Tinusaur Project","isPartOf":{"@id":"https:\/\/tinusaur.org\/#website"},"primaryImageOfPage":{"@id":"https:\/\/tinusaur.org\/projects\/ssd1306xled\/#primaryimage"},"image":{"@id":"https:\/\/tinusaur.org\/projects\/ssd1306xled\/#primaryimage"},"thumbnailUrl":"https:\/\/tinusaur.org\/wp-content\/uploads\/sites\/9\/2016\/06\/20140829_142451_ssd1306xled_04_rcs1230x1230fx.jpg","datePublished":"2014-08-12T10:53:44+00:00","dateModified":"2022-01-01T21:04:05+00:00","breadcrumb":{"@id":"https:\/\/tinusaur.org\/projects\/ssd1306xled\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/tinusaur.org\/projects\/ssd1306xled\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/tinusaur.org\/projects\/ssd1306xled\/#primaryimage","url":"https:\/\/tinusaur.org\/wp-content\/uploads\/sites\/9\/2016\/06\/20140829_142451_ssd1306xled_04_rcs1230x1230fx.jpg","contentUrl":"https:\/\/tinusaur.org\/wp-content\/uploads\/sites\/9\/2016\/06\/20140829_142451_ssd1306xled_04_rcs1230x1230fx.jpg","width":1230,"height":1230,"caption":"Tinusaur SSD1306XLED SSD1306 OLED Display Llibary"},{"@type":"BreadcrumbList","@id":"https:\/\/tinusaur.org\/projects\/ssd1306xled\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/tinusaur.org\/"},{"@type":"ListItem","position":2,"name":"Projects","item":"https:\/\/tinusaur.org\/projects\/"},{"@type":"ListItem","position":3,"name":"SSD1306xLED"}]},{"@type":"WebSite","@id":"https:\/\/tinusaur.org\/#website","url":"https:\/\/tinusaur.org\/","name":"The Tinusaur Project","description":"BE SMARTER! Make, play and learn with the Tinusaur microcontroller boards.","publisher":{"@id":"https:\/\/tinusaur.org\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/tinusaur.org\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/tinusaur.org\/#organization","name":"Tinusaur","url":"https:\/\/tinusaur.org\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/tinusaur.org\/#\/schema\/logo\/image\/","url":"https:\/\/org.tinusaur.net\/wp-content\/uploads\/sites\/9\/2018\/09\/cropped-tinusaur09a_c1440x1440t21.png","contentUrl":"https:\/\/org.tinusaur.net\/wp-content\/uploads\/sites\/9\/2018\/09\/cropped-tinusaur09a_c1440x1440t21.png","width":512,"height":512,"caption":"Tinusaur"},"image":{"@id":"https:\/\/tinusaur.org\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/tinusaur\/","https:\/\/twitter.com\/tinusaur","https:\/\/www.instagram.com\/tinusaur\/","https:\/\/www.linkedin.com\/company\/tinusaur","https:\/\/www.pinterest.com\/tinusaur\/_created\/","https:\/\/www.youtube.com\/tinusaur"]}]}},"jetpack_sharing_enabled":true,"jetpack-related-posts":[],"jetpack_shortlink":"https:\/\/wp.me\/PdBsNF-dQ","_links":{"self":[{"href":"https:\/\/tinusaur.org\/wp-json\/wp\/v2\/pages\/858"}],"collection":[{"href":"https:\/\/tinusaur.org\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/tinusaur.org\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/tinusaur.org\/wp-json\/wp\/v2\/users\/54"}],"replies":[{"embeddable":true,"href":"https:\/\/tinusaur.org\/wp-json\/wp\/v2\/comments?post=858"}],"version-history":[{"count":1,"href":"https:\/\/tinusaur.org\/wp-json\/wp\/v2\/pages\/858\/revisions"}],"predecessor-version":[{"id":3799,"href":"https:\/\/tinusaur.org\/wp-json\/wp\/v2\/pages\/858\/revisions\/3799"}],"up":[{"embeddable":true,"href":"https:\/\/tinusaur.org\/wp-json\/wp\/v2\/pages\/654"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/tinusaur.org\/wp-json\/wp\/v2\/media\/1700"}],"wp:attachment":[{"href":"https:\/\/tinusaur.org\/wp-json\/wp\/v2\/media?parent=858"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}