- \n
- \n
Raspberry Pi Pico \/ RP2040-zero<\/strong><\/p>\n<\/li>\n
- \n
SSD1306 OLED Display<\/strong>
*Uses I2C connection.<\/p>\n<\/li>\n- \n
Jumper Wires, Breadboard<\/strong> (or an environment for direct wiring)<\/p>\n<\/li>\n
- \n
Thonny IDE<\/strong> (IDE for MicroPython)<\/p>\n<\/li>\n<\/ul>\n
\nInstalling the SSD1306 Library<\/h2>\n
The MicroPython standard library does not include the SSD1306 library by default. Therefore, we will use Thonny to install the library.<\/p>\n
- \n
- \n
Launch Thonny<\/strong>
Connect your Raspberry Pi Pico to your PC and launch Thonny.<\/p>\n<\/li>\n- \n
Tools > Manage packages<\/strong>
Select “Tools” → “Manage packages…” from the top menu.
\n![\"Manage](\"https:\/\/donguri3.net\/wp-content\/uploads\/2025\/03\/4fb951c4d6d5b44ce4f6c0df1f98198f.png\")
<\/a><\/p>\n<\/li>\n- \n
Type “ssd1306” in the search box<\/strong>
Type “ssd1306” into the search box and run the search.
\n![\"Search](\"https:\/\/donguri3.net\/wp-content\/uploads\/2025\/03\/1181badc044b1a43985a89054fa7d8c0.png\")
<\/a><\/p>\n<\/li>\n- \n
Select and Install the Library<\/strong>
Select “ssd1306” from the search results and click the install button.
\n![\"Install](\"https:\/\/donguri3.net\/wp-content\/uploads\/2025\/03\/94d9e3124af85bb2bb7c3c0907eee166.png\")
<\/a>
Once the installation is complete, verify thatlib\/ssd1306.py<\/code> has been created by going to “View > Files” on the Raspberry Pi Pico.
\n![\"ssd1306](\"https:\/\/donguri3.net\/wp-content\/uploads\/2025\/03\/1da92789a8347e329869bfa94985c432-e1741584145973.png\")
<\/a><\/p>\n<\/li>\n<\/ol>\n
\nCreating main.py and Writing the Code<\/h2>\n
Copy the following code into a new file in Thonny and save it as
main.py<\/code> on the Raspberry Pi Pico.<\/p>\nfrom machine import Pin, I2C\nimport ssd1306\n\n# using default address 0x3C\ni2c = I2C(1, sda=Pin(14), scl=Pin(15))\ndisplay = ssd1306.SSD1306_I2C(128, 32, i2c, addr=0x3C)\n\n# Print Hello World on the first line\ndisplay.text('Hello, World!', 0, 0, 1)\ndisplay.show()<\/pre>\nKey points of this code:<\/p>\n
- \n
- \n
![\"Pin](\"https:\/\/donguri3.net\/wp-content\/uploads\/2025\/03\/1-1.png\")
<\/a>Pin assignment of the RP2040-zero clone<\/figcaption><\/figure>\n I2C Initialization<\/strong>
Uses I2C ID 1, withPin(14)<\/code> andPin(15)<\/code> as SDA and SCL respectively. Please check the pin assignments for your specific board; pins 14 and 15 on the RP2040-zero correspond to I2C1, hence the value 1. The display’s I2C address is0x3C<\/code> (you can verify this withi2c.scan()<\/code> if necessary).<\/p>\n<\/li>\n- \n
Using the ssd1306 Library<\/strong>
Imports the installed library and creates an SSD1306 display object.<\/p>\n<\/li>\n- \n
Displaying Text<\/strong>
Displays “Hello, World!” on the first line usingdisplay.text<\/code> and updates the display withdisplay.show()<\/code>.<\/p>\n<\/li>\n<\/ul>\n
\nExecution Results<\/h2>\n
Running this
main.py<\/code> will display the text “Hello, World!” on the SSD1306 display.
\n![\"I2C](\"https:\/\/donguri3.net\/wp-content\/uploads\/2025\/03\/IMG_15791-scaled-e1741655802989-1024x768.jpg\")
<\/a><\/p>\n
\nTroubleshooting<\/h2>\n
Actually, when I initially skipped soldering the RP2040-zero pins and just plugged it into a breadboard, I encountered the following error:<\/p>\n
Traceback (most recent call last):\n File \"\", line 6, in \n File \"\/lib\/ssd1306.py\", line 119, in __init__\n File \"\/lib\/ssd1306.py\", line 38, in __init__\n File \"\/lib\/ssd1306.py\", line 75, in init_display\n File \"\/lib\/ssd1306.py\", line 124, in write_cmd\nOSError: [Errno 5] EIO<\/pre>\n
The cause was that the OLED display was not receiving power. By soldering properly and ensuring that each pin is securely connected, the error will be resolved and it will function correctly.<\/p>\n
References<\/h2>\n
- \n
- class I2C
\nclass I2C \u2013 a two-wire serial protocol \u2014 MicroPython latest documentation<\/a><\/li>\n- SSD1306 OLED Library
\n14. Using the SSD1306 OLED Display \u2014 MicroPython latest documentation (Japanese)<\/a><\/li>\n<\/ul>\n
\nSummary<\/h2>\n
- \n
- \n
Installing the ssd1306 Library<\/strong>
Easily installed using Thonny’s package management feature.<\/p>\n<\/li>\n- \n
Writing main.py<\/strong>
Initializing I2C, creating the display object, and displaying text is very straightforward.<\/p>\n<\/li>\n- \n
Troubleshooting<\/strong>
It is important to carefully check the hardware side (soldering, wiring, pull-up resistors).<\/p>\n<\/li>\n<\/ol>\nThis completes the basic steps for displaying “Hello, World!” on an SSD1306 OLED display using the Raspberry Pi Pico. Feel free to use this content as a base to try out various display contents!<\/p>\n","protected":false},"excerpt":{"rendered":"
In this article, we will introduce how to display “Hello, World!” on an SSD1306 OLED display using […]<\/p>\n","protected":false},"author":4,"featured_media":878,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_locale":"en_US","_original_post":"https:\/\/donguri3.net\/?p=879","footnotes":""},"categories":[1163],"tags":[265,47,277,262,321,272,325,274],"class_list":["post-4986","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-electronics-microcontroller","tag-micropython","tag-python","tag-raspberry-pi-pico","tag-rp2040-zero","tag-ssd1306","tag-thonny","tag-325","tag-274","en-US"],"_links":{"self":[{"href":"https:\/\/donguri3.net\/wp-json\/wp\/v2\/posts\/4986","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/donguri3.net\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/donguri3.net\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/donguri3.net\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/donguri3.net\/wp-json\/wp\/v2\/comments?post=4986"}],"version-history":[{"count":1,"href":"https:\/\/donguri3.net\/wp-json\/wp\/v2\/posts\/4986\/revisions"}],"predecessor-version":[{"id":4989,"href":"https:\/\/donguri3.net\/wp-json\/wp\/v2\/posts\/4986\/revisions\/4989"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/donguri3.net\/wp-json\/wp\/v2\/media\/878"}],"wp:attachment":[{"href":"https:\/\/donguri3.net\/wp-json\/wp\/v2\/media?parent=4986"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/donguri3.net\/wp-json\/wp\/v2\/categories?post=4986"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/donguri3.net\/wp-json\/wp\/v2\/tags?post=4986"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
- \n
- SSD1306 OLED Library
- \n
- \n
- \n