This project shows the implementation of the OLED driver using a SparkFun Micro OLED Breakout (Qwiic) board with BGM220 Explorer Kit based on I2C communication.
The SparkFun Micro OLED Breakout (Qwiic) board carries a monochrome, 64 x 48px and blue-on-black OLED display. It uses an SSD1306 controller to drive the display. Its built-in functionalities include contrast control, normal or inverse image display, vertical and horizontal scrolling functions and more. It can be used for applications where bright and crisp blue text or icons need to be displayed such as MP3 player, home appliances.
For more information about the SSD1306 controller, see the specification page.
Please note that this is a monochrome OLED driver.
You simply connect a SparkFun Micro OLED Breakout (Qwiic) board to a BGM220 Explorer Kit board using a Qwiic cable.
Note: There are several jumpers on SparkFun Micro OLED Breakout (Qwiic) board that can be changed to facilitate several different functions. The first of which is the ADDR jumper. The ADDR jumper can be used to change the I2C address of the board. The default jumper is open by default, pulling the address pin high and giving us an I2C address of 0X3D. Closing this jumper will ground the address pin, giving us an I2C address of 0X3C.
The second of which is the I2C pull-up jumper. If multiple boards are connected to the I2C bus, the equivalent resistance goes down, increasing your pull-up strength. If multiple boards are connected on the same bus, make sure only one board has the pull-up resistors connected.
To test this application, you should connect the BMG220 Explorer Kit Board to the PC using a micro USB cable.
-
From the Launcher Home, add the BRD4314A to My Products, click on it, and click on the EXAMPLE PROJECTS & DEMOS tab. Find the example project with filter micro oled.
-
Click Create button on the Third Party Hardware Drivers - SSD1306 - Micro OLED Breakout Qwiic (Sparkfun) example. Example project creation dialog pops up -> click Create and Finish and Project should be generated.
-
Build and flash this example to the board.
-
Create a "Platform - Empty C Example" project for the "BGM220 Explorer Kit Board" using Simplicity Studio 5. Use the default project settings. Be sure to connect and select the BGM220 Explorer Kit Board from the "Debug Adapters" on the left before creating a project.
-
Copy the file
app/example/sparkfun_micro_oled_ssd1306/app.cinto the project root folder (overwriting existing file). -
Install the software components:
- Open the .slcp file in the project.
- Select the SOFTWARE COMPONENTS tab.
- Install the following components:
- [Platform] → [Driver]→ [Button] → [Simple Button] → default instance name: btn0.
- [Third Party Hardware Drivers] → [Display & LED] → [SSD1306 - Micro OLED Breakout (Sparkfun) - I2C]
- [Third Party Hardware Drivers] → [Services] → [GLIB - OLED Graphics Library]
-
Build and flash the project to your device.
Note:
-
Make sure that the SDK extension already be installed. If not please follow this documentation.
-
SDK Extension must be enabled for the project to install "SSD1306 - Micro OLED Breakout (Sparkfun) - I2C" component.
After initialization, the OLED displays the text with the font 6x8. If Button 0 is pressed the OLED will display an image with some graphic effects.
The OLED display will look something like the GIF below.
To report bugs in the Application Examples projects, please create a new "Issue" in the "Issues" section of third_party_hw_drivers_extension repo. Please reference the board, project, and source files associated with the bug, and reference line numbers. If you are proposing a fix, also include information on the proposed fix. Since these examples are provided as-is, there is no guarantee that these examples will be updated to fix these issues.
Questions and comments related to these examples should be made by creating a new "Issue" in the "Issues" section of third_party_hw_drivers_extension repo.