notes on using the arduino ide with the adafruit feather nrf52 bluefruit le

Adafruit Feather nRF52 Bluefruit LE – nRF52832

All of this work is done on my MacBook Pro with macOS Mojave 10.14.6 (I haven’t upgraded beyond Mojave yet because I don’t see the need on the MacBook, and if I need macOS 10.15 it’s installed on my Mac Mini).

First, let’s sort out my (miss) adventures with Arduino IDE. It started a few days ago when I decided to do something with the Feather, a device I’d purchased nearly a year prior. I’d plugged it in several times when it first arrived and I’d used the Arduion IDE’s Serial Monitor (Tools > Serial Monitor) to check it. It shipped with the StandardFirmataBLE sketch compiled and installed, so I was able to see the device’s internal configuration on the Serial Monitor as well as test it with Adafruit’s Bluefruit LE Connect app. I then put it aside and wound up forgetting about it until just recently. Adafruit still sells the device today, which is good.

It was during this restart I noticed that my version of the Arduino IDE was at 1.8.7, but the website had released 1.8.10. So I downloaded the latest IDE software and installed it.

After the IDE updated I updated the Feather’s bootloader software. That went off without a hitch. Then I started to look at the sample sketches for the board that Adafruit provides. Since it already came with the Firmata sketch installed and running, I found the source in the samples and attempted to recompile and upload. That’s when everything went screwy. Here’s an example of the error output.

Arduino: 1.8.10 (Mac OS X), Board: "Adafruit Bluefruit Feather nRF52832, 0.2.13 SoftDevice s132 6.1.1, Level 0 (Release)"

/Users/wbeebe/Git/arduino/libraries/Servo/src/nrf52/Servo.cpp: In member function 'void Servo::writeMicroseconds(int)':
/Users/wbeebe/Git/arduino/libraries/Servo/src/nrf52/Servo.cpp:92:12: error: 'g_APinDescription' was not declared in this scope
  instance=(g_APinDescription[pin].ulPWMChannel & 0xF0)/16;
            ^~~~~~~~~~~~~~~~~
/Users/wbeebe/Git/arduino/libraries/Servo/src/nrf52/Servo.cpp: In member function 'int Servo::readMicroseconds()':
/Users/wbeebe/Git/arduino/libraries/Servo/src/nrf52/Servo.cpp:123:12: error: 'g_APinDescription' was not declared in this scope
  instance=(g_APinDescription[pin].ulPWMChannel & 0xF0)/16;
            ^~~~~~~~~~~~~~~~~
Multiple libraries were found for "Firmata.h"
 Used: /private/var/folders/d9/n152_yx519121c0nlmlds71c0000gn/T/AppTranslocation/2101D1AD-76B6-4A4E-A36D-936C2672D030/d/Arduino.app/Contents/Java/libraries/Firmata
Multiple libraries were found for "Adafruit_LittleFS.h"
 Used: /Users/wbeebe/Library/Arduino15/packages/adafruit/hardware/nrf52/0.14.6/libraries/Adafruit_LittleFS
Multiple libraries were found for "InternalFileSystem.h"
 Used: /Users/wbeebe/Library/Arduino15/packages/adafruit/hardware/nrf52/0.14.6/libraries/InternalFileSytem
Multiple libraries were found for "bluefruit.h"
 Used: /Users/wbeebe/Library/Arduino15/packages/adafruit/hardware/nrf52/0.14.6/libraries/Bluefruit52Lib
Multiple libraries were found for "Servo.h"
 Used: /Users/wbeebe/Git/arduino/libraries/Servo
 Not used: /private/var/folders/d9/n152_yx519121c0nlmlds71c0000gn/T/AppTranslocation/2101D1AD-76B6-4A4E-A36D-936C2672D030/d/Arduino.app/Contents/Java/libraries/Servo
 Not used: /Users/wbeebe/Library/Arduino15/packages/adafruit/hardware/nrf52/0.14.6/libraries/Servo
Multiple libraries were found for "Wire.h"
 Used: /Users/wbeebe/Library/Arduino15/packages/adafruit/hardware/nrf52/0.14.6/libraries/Wire
exit status 1
Error compiling for board Adafruit Bluefruit Feather nRF52832.

Lots of error messages. The key to a solution is line 20, but I’ll get to that. In the meantime I went slumming on the Internet for solutions, none of which really worked, so that don’t bear repeating here. What finally got me out of this mess and allowed the sketch to compile is the removal of the libraries folder pointed to in line 20 (which none of the on-line experts never mentioned). I don’t know what happened except that something got out of sync in the upgrade to Arduino IDE 1.8.10, and that caused a cascade effect in the error messages. When I removed the libraries folder and then reloaded the Adafruit nRF52 specific libraries again, everything was just fine. The libraries folder was recreated by the IDE.

In the mean time I decided to try to run a sketch that simply flashed the LEDs on the Feather board. The listing follows.

#include <Arduino.h>

/**
 * Sketch demonstrates mutli-tasking using the Scheduler.
 * Demo creates a loop2() that runs in 'parallel' with loop().
 * - loop() toggles LED_RED every 1 second
 * - loop2() toggles LED_BLUE every 300 milliseconds
 */

void setup() {
    // whb Nov 2019
    // This must be performed first or else nothing else will work.
    // No, I don't know exactly why.
    //
    Serial.begin(115200);

    // LED_RED & LED_BLUE pins are already initialized outputs.
    // Create loop2() using Scheduler to run in 'parallel' with loop()
    //
    Scheduler.startLoop(loop2);
}

/**
 * Toggle the Red LED every second
 */
void loop() {
    digitalToggle(LED_RED); // Toggle LED 
    delay(1000);            // wait for a second
}

/**
 * Toggle the Blue LED every 300 milliseconds
 */
void loop2() {
    digitalToggle(LED_BLUE); // Toggle LED 
    delay(300);              // wait for a half second  
}

There’s far more comments than code, and that’s after not including the boilerplate block comment at the start of the code. This is from an example sketch provided when you install the Adafruit libraries. So I compiled and uploaded it, and the lights didn’t flash. Ok. I went online to Adafruit’s Feather documentation and copied an even simpler sketch that just flashed the red LED. Again, compiled and uploaded and nothing happened. The red LED just glimmered, like it did while the upload to the Feather was taking place.

I went back and looked at the major Firmata sketch, and at setup specifically, and that’s when the light went off. So I added line 15 above, and bingo, the lights started to flash like they’re supposed to. I played with a number of other sketches like this one. Load them without the Serial.begin() and nothing worked. Add that single line and it worked as advertised.

I also like this sketch because it points to the use of freeRTOS in the code. Keep in mind that the processor in the feather is a 32-bit ARM Cortex M4 processor running at 64MHz with 64K of RAM and 256K of Flash. It’s more than enough for basic embedded work, including freeRTOS. When I think back to the late 1970s and early 1980s I would have given anything to have this back when all that was available were Commodore 64s and Apple ][s and TRS-80s and the original IBM PC. This even blows the original Macintosh away with its 8MHz Motorola 68000. And here it all is now, on a board not much bigger than a stick of chewing gum and all for just $25 instead of the hundreds to thousands back then. Anyway…

The Arduino and its environment are now stable again, and I can build (in C, and possible C++) “sketches” for the Feather. This goes along with my Circuit Playground and my little Adafruit 32U4 powered robot. All of my code is checked into my Github location, https://github.com/wbeebe/arduino

updating the java jdk path in intellij idea on macos

I have a very short fuse when it comes to wading through bad advice found on the web, especially old technical advice. Case in point, how to update a current release of IntelliJ IDEA’s Java/JDK path to an external JDK already installed on your machine.

I’m currently trying to do some work with:

  • Java/OpenJDK 11.0.5 LTS release distributed by AdoptOpenJDK using
  • IntelliJ IDEA Community Edition 2019.2 on
  • macOS Mojave 10.14.6.

When I started to try and use that Java release, IntelliJ couldn’t seem to find it, and I couldn’t seem to configure IntelliJ where to look. After looking at six-year-old directions via the web that were mostly right I finally figured it out. Here’s what to do with the latest release of IntelliJ.

Open the File menu and select Project Structure. This used to be buried in Other Settings, which is where all those older directions tell you to go. Now it’s out in the open, probably because of the shift from Java8 to Java9 and beyond that’s been occurring every six months since Java9 was released Setember 2018.

A dialog will show up as shown below.

In my example I’ve already set up to use Java 11.0.5. To add a new location, click the red folder on the far right, where you see the help balloon in the screen capture above. Clicking that will open a regular folder/file dialog allowing you to pick he location where your specific Java release is located on your Mac. Once you’ve set up the correct location click OK and go back to editing in the IntelliJ IDE.

I hate searching for technical information on the web, because it is without exception for older (many times far older) software than what you’re currently working with. The majority of it is old crap from Stack Overflow. And as far as I can tell, none of the search engines are capable of bubbling up current information, let alone correct information. I mean, you should have seen what I also got looking for the answer to this question.

You’re welcome.