虽然这个博客文章将特别详细说明如何使用pmodoledrgb.与chipkit mx3.，它对将PMODOLEDRGB UP和运行并通过SPI传播我们的大多数Chipkit板也将非常有用。这里提供的示例将介绍如何使用必要的软件设置如何正确连接硬件，以及如何使用一些简单库函数绘制显示屏上的形状。
它恰好是在我们期间尝试过的好时机Pmod夏天出售!
PMODOLEDRGB是19.99美元的RGB有机LED显示屏，可将其插入到任何PMOD主机端口中。PMOD主机端口可以在三个不同的Chipkit板上找到。它们是chipkit mx3，Chipkit Pro MX4.和Chipkit Pro MX7.．此外，这是chipKIT Pmod盾可以与之使用Chipkit UC32.和chipkit wf32.，方便添加Pmod主机端口。如果你的董事会是chipKIT Max32或者是Chipkit Wi-Fire然后需要一些额外的电线。所有的chipKIT板都具有来自Microchip PIC32MX或PIC32MZ微控制器家族的32位PIC32微控制器。
软件和图书馆
为了学习这个例子，你需要下载mide;你们可以看到在这里．我们还有Instructable (使用MPIDE上传代码)，一步一步地通过如何下载软件，并与任何chipKIT板启动和运行。我将MPIDE ZIP文件解压缩到我的Documents文件夹中。
脚步：
安装pmodoledrgb库在这里．
提取pmodoledrgb_lib_mpide.zip.zip.
将“OLEDRGB”文件夹复制到您的文档> mpide >库文件夹中。如果该文件夹不存在，请打开MPIDE自动生成该文件夹。
复制完成后，重新启动MPIDE并单击打开按钮。您应该看到OLEDRGB.在下拉菜单中，如下图所示。
该PMODOLEDRGB库包含几种有用的功能，使与PMODOLEDRGB更简单的接口。它负责电路板和PMOD之间发生的所有时间和单独的SPI传输。
连接硬件
这是一开始绊倒的东西。要知道的是，PModoledRGB库使用DSPI0对象类，该类不是标准SPI库的一部分，而是数字SPI库（DSPI）的一部分。这种功能均可意味着在使用PMODOLEDRGB库时，必须将PMODOLEDRGB插入到DSPI0访问的SPI端口。在Chipkit Pro MX3上，在PMOD端口JE上找到，如下图所示。如果您使用的是不同的Chipkit板，请参阅表1，有用，每个板上的DSPI0可访问哪些SPI端口。请注意，PMODOLEDRGB库中有两个，而不会进一步调整代码。
| chipKIT董事会 | DSPI0 | SPI港口 | RM节 | 有Pmod港口 | Pmod盾兼容 |
| 最大32. | spi2a. | J13 | 3.5外围I / O功能 | 没有 | 没有 |
| Uc32 | 不支持 | N / A. | 3.5外围I / O功能 | 没有 | 是的 |
| MX3 | 不支持 | N / A. | 7串行外围接口（SPI） | 是的 | 没有 |
| 箴MX4 | SPI2. | 简森-巴顿 | 10串行外围接口（SPI） | 是的 | 没有 |
| vifire. | SPI2. | J7 | 10.3 SPI | 没有 | 没有 |
| WF32 | SPI2. | J10 | 10.2 SPI. | 没有 | 是的 |
| 箴MX7 | SPI1. | JD | 10串行外围接口（SPI） | 是的 | 没有 |
表1显示了Chipkit板上将与PMODOLEDRGB库平稳起到哪些端口以及电路板的崩溃具有PMOD主机端口，并且可以使用Chipkit PMOD屏蔽。
在显示器上绘制图形
打开MPIDE（如果不是）并通过单击创建新的草图开放的,滚动到1.基础知识，并打开BareMinimum项目。
去文件并点击另存为。命名并保存。接下来，我们需要包含必要的库。在你的程序的开头添加以下代码行:
# include < DSPI.h >
# include < OLEDrgb.h >
Oledrgb Oledrgb;
这将包括SPI和OLEDRGB库，并将实例化名为OLEDRGB的OLEDRGB对象。在Setup（）函数中，添加以下行：
OLEDRGB.BEGIN（）;
该功能完成PmodOLEDrgb正常运行所必须完成的上电顺序和配置。它应该如下图所示。
您可以在库中包含的OLEDrgb.c文件中找到几个函数。这些函数包括DrawPixel、DrawLine、DrawRectangle和DrawBitmap。还有一个名为BuildRGB(红、绿、蓝)的辅助函数，它将RGB颜色格式化为2个字节，PmodOLEDrgb可以读取这些字节。
调用oledrgb.drawpixel（50,15，oledrgb.buildrgb（255,0,0）将在坐标绘制一个像素(50, 15)彩色的红色的．
调用OLEDrgb。DrawLine(10、20、45、5,oldrgb。BuildRGB(0,255, 0))将绘制一条线（10,20）到（45,5）彩色的绿色．
调用OledRGB.DrawRectangle（10,20,80,60，OLEDRGB.BuildRGB（0,255,0），TRUE，OLEDRGB.BuildRGB（0,0,0,255）将画出一个绿色矩形的（10,20）到（80,60）．真正的表示它将被填充，最后一个参数设置填充蓝色。
插入您的chipKIT板到您的计算机通过USB和选择它在MPIDE点击工具>板> Chipkit> Chipkit MX3(或其他chipKIT板)．单击，选择单板所插的串口工具>串口> COM ___．要知道要选择的串行端口，请在PC上检查设备管理器，该端口专用于USB接口。一旦设置了，请单击“上传按钮将其上传到您的董事会！您应该看到下面的图像的某些组合，具体取决于您是否包含了所有三个示例函数。
希望这对开始使用PmodOLEDrgb和chipKIT PIC32产品是有用的。有关如何显示位图的更多信息和说明，请参见我们的教程在编程PMODOLEDRGB上ChipKIT Pro MX7．有关此处使用的任何产品的更多信息，请访问我们的维基．
别忘了看看我们的PMOD夏季销售在PMODOLEDRGB上的价格良好！
