{"id":4079,"date":"2020-06-13T15:20:08","date_gmt":"2020-06-13T20:20:08","guid":{"rendered":"https:\/\/dev.iachieved.it\/iachievedit\/?p=4079"},"modified":"2020-06-13T15:20:08","modified_gmt":"2020-06-13T20:20:08","slug":"exploring-hifive1-rev-b-gpios-with-platformio","status":"publish","type":"post","link":"https:\/\/dev.iachieved.it\/iachievedit\/exploring-hifive1-rev-b-gpios-with-platformio\/","title":{"rendered":"Exploring HiFive1 Rev B GPIOs with PlatformIO"},"content":{"rendered":"

In our last post<\/a> we looked at the GPIO pins of the SiFive HiFive1 Rev B board<\/a>, and in this one we will continue doing so, but let’s take a look at PlatformIO<\/a> on that journey. PlatformIO bills itself as “A new generation ecosystem for embedded development” and aims to really simplify pulling together all of the tools needed for embedded development. In our introduction to the HiFive1 Rev B<\/a> we outlined all of the packages you needed to install and configure to get started with the board. Cross-compilers, JTAG daemons, remote debug tools, SDKs, and so on. What if we could skip all that, not just for one microcontroller platform, but for hundreds of them? Enter PlatformIO.<\/p>\n

Installing PlatformIO<\/h2>\n

PlatformIO, while compatible with a number of popular editors (Sublime Text, Atom, etc.), really shines with Visual Studio Code<\/a>. While VSCode has features I don’t find appealing (horizontal bars on my code), it is very configurable and I can turn them off and enable Emacs keybindings. After some time with VSCode and PlatformIO, I really began enjoying how straightforward it was to work with the HiFive1 Rev B.<\/p>\n

Installing PlatformIO is simple with Visual Studio Code. Open the Extensions<\/em> panel and search:<\/p>\n

\"\"<\/a><\/p>\n

Click on Install<\/em>. You’ll see a “landing page” of sorts for PlatformIO and a window open up on the bottom indicating it is being installed and configured.<\/p>\n

\"\"<\/a><\/p>\n

Once PlatformIO is installed we’ll create a project for use with our HiFive1 Rev B board. Click on the PlatformIO Projects<\/em> button and then Create New Project<\/em>.<\/p>\n

\"\"<\/a><\/p>\n

This is where PlatformIO really shines. There are over 800 boards to choose from, and depending on the board, multiple frameworks to work with. For example, with the HiFive1 Rev B you can use either the Freedom E SDK<\/a> (which we use), or the Zephyr RTOS<\/a>.<\/p>\n

Creating a New File<\/h2>\n

Obviously we’ll need to write some code, so in your project right-click on src<\/em> and select New File<\/em>.<\/p>\n

\"\"<\/a><\/p>\n

Visual Studio Code will prompt you to name the file in the project explorer; ours is named simply main.c<\/code>. We’ll do the GPIO equivalent of a Hello World by blinking the onboard green LED:<\/p>\n

#include <stdio.h>\n#include <time.h>\n#include <metal\/gpio.h>\n\nvoid delayForSeconds(unsigned seconds) {\n    time_t timeout;\n    timeout = time(NULL) + seconds;\n  while (timeout > time(NULL));\n}\n\nint main(void) {\n  struct metal_gpio* gpio_device = metal_gpio_get_device(0);\n  if (!gpio_device) {\n    printf(\"Unable to obtain GPIO device\\n\");\n    return -1;\n  }\n\n  while (1) {\n    metal_gpio_enable_output(gpio_device, 19);  \/\/ Turn on onboard green LED\n    delayForSeconds(1);\n    metal_gpio_disable_output(gpio_device, 19); \/\/ Turn off\n    delayForSeconds(1);\n  }\n\n  return 0;\n}<\/pre>\n
Building and Uploading<\/h2>\n
PlatformIO automates and streamlines installation of the correct toolchain, debugger, SDK and so on.  To build your project there is a checkmark on the bottom of the editor window; if you hover over it you’ll see the label PlatformIO: Build<\/em>.  Click on it and scroll through the output to see what PlatformIO is doing; I’ve found it very helpful to read everything that is going on.<\/p>\n
\"\"<\/a><\/p>\n
Uploading your project to the HiFive1 Rev B is as simple as clicking the right arrow that is labeled PlatformIO: Upload<\/em>.  Again, if this is your first time using PlatformIO on a given environment you can see it’s installing what’s necessary to upload to your board.<\/p>\n
\"\"<\/a><\/p>\n
Here is a great example of what PlatformIO is doing in the background:<\/p>\n
\"\"<\/a><\/p>\n
While it’s possible to do this by hand (and we have!), how nice it is to have it done automatically for you.<\/p>\n
Serial Output<\/h3>\n
PlatformIO does have the ability to open a serial monitor to your HiFive1 Rev B board, though you may have to do a bit of configuration here.  Open the project’s platformio.ini<\/code> and ensure that your environment configuration has monitor_speed=115200<\/code> set.  This will tell PlatformIO to use 115200 baud to communicate on the serial port.  Then open the serial monitor with the “electric plug” icon and choose the first usbmodem<\/code> port you see.<\/p>\n
I typically prefer to use screen<\/code> on macOS for this – the console output in Visual Studio Code is nice, but I’m used to screen<\/code> and like having it in a separate terminal window altogether.  For example, typing screen \/dev\/cu.usbmodemIDENTIFIER 115200<\/code> (where IDENTIFIER<\/code> will be specific to your machine) will bring up the serial console to the board.<\/p>\n
Testing the GPIO Pins<\/h2>\n
Okay, PlatformIO is ready to go and we’re going to take a look at the GPIO pins on the HiFive1 Rev B again.  I’ve learned a bit since writing about them in this post<\/a>.  For starters, digital pin 14 on the header is not connected<\/b> and there is no mapping of a pin from the GPIO device.<\/p>\n
\"\"<\/a><\/p>\n
In addition, pins 11, 12, and 13 on the header correspond to the MOSI, MISO, and SCK signals for the SPI device; since they are tied to SPI writing a digital one to them has no effect.  On the other hand, you can write a 1 to pin 10 (SPI SS) and get an output.<\/p>\n
That said, you can<\/em> use the I2C pins (digital pins 18 and 19) and write a digital one or zero to them as long as we’re willing to give them up as I2C pins.<\/p>\n
Pins 15 and 16 are interesting.  If you look at the HiFive1 Rev B schematic for J4 (the Arduino 6 pin block on the bottom left of the ESP32) you see GPIO 9 and GPIO10 map to DIG15 and DIG16.  But then going over here we see that:<\/p>\n