{"id":14042,"date":"2016-05-19T11:00:15","date_gmt":"2016-05-19T18:00:15","guid":{"rendered":"https:\/\/blog.digilentinc.com\/?p=14042"},"modified":"2021-06-16T14:13:11","modified_gmt":"2021-06-16T21:13:11","slug":"how-to-use-the-pmodoledrgb-display-with-chipkit-microcontroller-boards","status":"publish","type":"post","link":"https:\/\/digilent.com\/blog\/how-to-use-the-pmodoledrgb-display-with-chipkit-microcontroller-boards\/","title":{"rendered":"How to Use the PmodOLEDrgb Display with chipKIT Microcontroller Boards"},"content":{"rendered":"
\"chiKIT
chipKIT board with PmodOLEDrgb.<\/figcaption><\/figure>\n

Although this blog post will specifically detail how to use the PmodOLEDrgb<\/a>\u00a0with the chipKIT MX3<\/a>, it will also be very useful for getting the PmodOLEDrgb up and running and communicating via SPI on most of our chipKIT boards. The example provided here will cover how to get set up with the necessary software, how to properly connect the hardware, and how to use some simple library functions to draw shapes on the display.<\/p>\n

\n

And it happens to be a great time to try this out during our Pmod Summer Sale!<\/a><\/p>\n

\n

The PmodOLEDrgb is a 19.99$ RGB organic LED display that plugs nicely into any Pmod host port. Pmod host ports can be found on three different chipKIT boards. They are the chipKIT MX3, chipKIT Pro MX4<\/a>\u00a0and chipKIT Pro MX7<\/a>. Additionally, the chipKIT Pmod Shield<\/a>\u00a0can be used with the chipKIT uC32<\/a>\u00a0and chipKIT WF32<\/a>\u00a0to conveniently add Pmod host ports. If your board is either the chipKIT Max32<\/a>\u00a0or the chipKIT Wi-FIRE<\/a>\u00a0then some extra wires will be needed. All chipKIT boards feature a 32-bit PIC32 microcontroller from the Microchip PIC32MX or PIC32MZ microcontroller families.<\/p>\n

Software and Libraries<\/strong><\/p>\n

You will need MPIDE downloaded in order to follow this example; you can get that\u00a0here<\/a>. We also have an Instructable (Uploading Code with MPIDE<\/a>)\u00a0that goes step by step through how to download the software and get up and running with any chipKIT board. I extracted the MPIDE ZIP file to my Documents folder.<\/p>\n

Steps:<\/strong><\/p>\n

Install the PmodOLEDrgb libraries here<\/a>.<\/p>\n

Extract\u00a0pmodoledrgb_lib_mpide.zip<\/strong><\/p>\n

Copy the “OLEDrgb” folder into your\u00a0Documents>mpide>libraries<\/strong>\u00a0folder. If this folder doesn’t exist, open up MPIDE to automatically generate the folders.<\/p>\n

Once it is copied, restart MPIDE and click the\u00a0Open<\/strong>\u00a0button. You should see\u00a0OLEDrgb<\/strong>\u00a0<\/strong>in the drop down menu as depicted below.<\/p>\n

\"MPIDE
After following the above steps you should see PmodOLEDrgb in the Open button drop down menu.<\/figcaption><\/figure>\n

This PmodOLEDrgb library contains several useful functions that make interfacing with the PmodOLEDrgb much simpler. It takes care of all of the timing and individual SPI transmissions that happen between your board and the Pmod.<\/p>\n

Connecting the Hardware<\/strong><\/p>\n

This is what tripped me up at first. What\u2019s important to know is that the PmodOLEDrgb library uses the DSPI0 object class, which is not part of the standard SPI library, but rather part of the Digilent SPI library (DSPI). What this functionally means is that when using the PmodOLEDrgb library, the PmodOLEDrgb must be plugged into an SPI port that is accessed by DSPI0. On the chipKIT Pro MX3, this is found on Pmod port JE, as seen in the image below. If you are using a different chipKIT board, please refer to table 1 for a useful breakdown of which SPI ports are accessible by DSPI0 on each board. Note that there are two for which the PmodOLEDrgb library will not work without further tweaking of the code.<\/p>\n\n\n\n\n\n\n\n\n\n\n
chipKIT board<\/strong><\/td>\nDSPI0<\/strong><\/td>\nSPI port <\/strong><\/td>\nRM section<\/strong><\/td>\nHas Pmod Ports<\/strong><\/td>\n\u00a0Pmod Shield Compatible<\/strong><\/td>\n<\/tr>\n
Max 32<\/td>\nSPI2A<\/td>\nJ13<\/td>\n3.5 Peripheral I\/O Functions<\/td>\nNo<\/td>\nNo<\/td>\n<\/tr>\n
Uc32<\/td>\nNot supported<\/td>\nn\/a<\/td>\n3.5 Peripheral I\/O Functions<\/td>\nNo<\/td>\nYes<\/td>\n<\/tr>\n
MX3<\/td>\nNot supported<\/td>\nn\/a<\/td>\n7 Serial Peripheral Interface (SPI)<\/td>\nYes<\/td>\nNo<\/td>\n<\/tr>\n
Pro MX4<\/td>\nSPI2<\/td>\nJB<\/td>\n10 Serial Peripheral Interface (SPI)<\/td>\nYes<\/td>\nNo<\/td>\n<\/tr>\n
WiFire<\/td>\nSPI2<\/td>\nJ7<\/td>\n10.3 SPI<\/td>\nNo<\/td>\nNo<\/td>\n<\/tr>\n
WF32<\/td>\nSPI2<\/td>\nJ10<\/td>\n10.2 SPI<\/td>\nNo<\/td>\nYes<\/td>\n<\/tr>\n
Pro MX7<\/td>\nSPI1<\/td>\nJD<\/td>\n10 Serial Peripheral Interface (SPI)<\/td>\nYes<\/td>\nNo<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Table 1 showing which ports on which chipKIT boards will function smoothly with the PmodOLEDrgb library as well as a breakdown of which boards have Pmod host ports and which will work with the chipKIT Pmod shield.<\/p>\n

Drawing Shapes on the Display<\/strong><\/p>\n

Open MPIDE (if it isn\u2019t already) and create a new sketch by clicking\u00a0Open,<\/strong>\u00a0<\/strong>scrolling down to\u00a01.Basics<\/strong>, and opening the\u00a0BareMinimum<\/strong>\u00a0project.<\/p>\n

Go to\u00a0File<\/strong>\u00a0and click\u00a0Save As.<\/strong>\u00a0<\/strong>Name and save it. Next we need to include the necessary libraries. Add the following lines to the beginning of your program:<\/p>\n

#include <DSPI.h>
\n#include <OLEDrgb.h><\/p>\n

Oledrgb OLEDrgb;<\/p>\n

This will include the SPI and the OLEDrgb libraries, and will instantiate an Oledrgb object named OLEDrgb. Inside the setup() function, add the following line:<\/p>\n

OLEDrgb.begin();<\/p>\n

This function goes through the powering on sequence and configuration that the PmodOLEDrgb must go through to operate correctly. It should look like the image below .<\/p>\n

\"new
Example MPIDE code showing powering on sequence and inclusion of necessary libraries.<\/figcaption><\/figure>\n

You can find several functions within the OLEDrgb.c file included in the library. These functions include DrawPixel, DrawLine, DrawRectangle, and DrawBitmap. There is also a helper function called BuildRGB (red,green,blue), this formats the RGB color into 2 bytes that can be read by the PmodOLEDrgb.<\/p>\n

Calling OLEDrgb.DrawPixel(50, 15, OLEDrgb.BuildRGB(255, 0, 0)) will draw a pixel at coordinate\u00a0(50,15)<\/strong>\u00a0colored\u00a0red<\/strong>.<\/p>\n

Calling OLEDrgb.DrawLine(10, 20, 45, 5, OLEDrgb.BuildRGB(0, 255, 0)) will draw a line from\u00a0(10,20)<\/strong>\u00a0<\/strong>to\u00a0(45, 5)<\/strong>\u00a0<\/strong>colored\u00a0green<\/strong>.<\/p>\n

Calling OLEDrgb.DrawRectangle(10, 20, 80, 60, OLEDrgb.BuildRGB(0, 255, 0), true, OLEDrgb.BuildRGB(0,0,255)) will draw a\u00a0green<\/strong>\u00a0rectangle from\u00a0(10,20)<\/strong>\u00a0to\u00a0(80,60)<\/strong>.\u00a0True<\/strong>\u00a0<\/strong>signifies that it will be filled in, and the last parameter sets that the fill will be\u00a0blue.<\/strong><\/p>\n

\"MPIDE
Example code to draw a dot, line and rectangle on the display simultaneously.<\/figcaption><\/figure>\n

Plug your chipKIT board into your computer via USB and select it in MPIDE by clicking\u00a0Tools>Board>chipKIT>chipKIT MX3 <\/strong>(or other chipKIT board)<\/strong>. Select the serial port that your board is plugged into by clicking\u00a0Tools>Serial Port>COM_\u00ad\u00ad__<\/strong>. In order to know which serial port to select, check the device manager on your PC for which port is dedicated to the USB interface. Once you are all set up, click the\u00a0Upload<\/strong>\u00a0button to upload it to your board! You should see some combination of the image below depending on whether or not you included all three example functions.<\/p>\n

\"oledrgb
Final product of above code.<\/figcaption><\/figure>\n

Hopefully this was useful in getting started with the PmodOLEDrgb and chipKIT PIC32 products. For more information, as well as instructions on how to display a bitmap, see our Instructable<\/a> on Programming the PmodOLEDrgb on the ChipKIT Pro MX7<\/a>. For more information on any of the products used here, please visit our Wiki<\/a>.<\/p>\n

And don’t forget to check out our Pmod Summer Sale<\/a> for a great price on the PmodOLEDrgb!<\/p>\n

0<\/span><\/a><\/div><\/div>
Be the 1st to vote.<\/div><\/div>
<\/div>","protected":false},"excerpt":{"rendered":"

Talesa takes you through how to get the PmodOLEDrgb up and running with our chipKIT boards.<\/p>\n","protected":false},"author":26,"featured_media":14046,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"categories":[38,1563],"tags":[],"ppma_author":[4491],"class_list":["post-14042","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-expansion-modules","category-guide"],"jetpack_featured_media_url":"https:\/\/digilent.com\/blog\/wp-content\/uploads\/2016\/05\/oledrgb-with-square-line-dot.jpg","authors":[{"term_id":4491,"user_id":26,"is_guest":0,"slug":"talesab","display_name":"Talesa Bleything","avatar_url":"https:\/\/secure.gravatar.com\/avatar\/4ebebd593afbf3d758e9127934708634ab09aeaa7fcfcf6151f4e9ceb9cf6d0e?s=96&d=mm&r=g","1":"","2":"","3":"","4":"","5":"","6":"","7":"","8":"","9":"","10":""}],"post_mailing_queue_ids":[],"_links":{"self":[{"href":"https:\/\/digilent.com\/blog\/wp-json\/wp\/v2\/posts\/14042","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/digilent.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/digilent.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/digilent.com\/blog\/wp-json\/wp\/v2\/users\/26"}],"replies":[{"embeddable":true,"href":"https:\/\/digilent.com\/blog\/wp-json\/wp\/v2\/comments?post=14042"}],"version-history":[{"count":0,"href":"https:\/\/digilent.com\/blog\/wp-json\/wp\/v2\/posts\/14042\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/digilent.com\/blog\/wp-json\/wp\/v2\/media\/14046"}],"wp:attachment":[{"href":"https:\/\/digilent.com\/blog\/wp-json\/wp\/v2\/media?parent=14042"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/digilent.com\/blog\/wp-json\/wp\/v2\/categories?post=14042"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/digilent.com\/blog\/wp-json\/wp\/v2\/tags?post=14042"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/digilent.com\/blog\/wp-json\/wp\/v2\/ppma_author?post=14042"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}