Install the Wiring / Arduino Framework

embedXcode supports the most popular boards running on the Wiring / Arduino framework.

The IDEs of the boards bring all the tools and libraries related to them, except the Spark platform and the mbed framework.

Using the IDEs of the boards allows an easy and safe installation for embedXcode.

The IDEs include the tool-chain and the framework, all the core and application libraries and the required utilities.

For each platform,

  • First install the IDEs of the boards under the /Applications folder.

  • Then launch the IDEs and define the path of the sketchbook folder in the menu IDE > Preferences > Sketchbook location.

  • Avoid spaces in the name and path of the sketchbook folder.

For more information about the Wiring / Arduino framework,

Some platforms and boards may be discontinued.

Install Other Frameworks

To install another framework,

For the Cosa framework,

For the Yocto SDK on the Intel Edison board,

For the MCU SDK on the Intel Edison board,

For the Linaro SDK on the BeagleBone board,

Select Your Platform

. . . . . .
4D Systems Adafruit ArduCAM Arduino chipKIT DFRobot
Espressif Intel LaunchPad LightBlue MediaTek Microduino
Microsoft Moteino NodeMCU panStamp RedBear RFduino
Robotis Seeeduino Simblee STM32duino Teensy TinyCircuits
Udoo Neo Other

Check the IDE and Plug-In Options

The Wiring / Arduino framework is used by many different platforms, resulting in a complex set of IDEs, plug-ins, add-ons and libraries.

For exact references,

Standard IDEs

The standard IDEs are developed by the makers of boards. They are self-contained and used by other platforms, being either modified or complemented with plug-ins and add-ons.

They came with their own specific name.

. Platform Version Name
Arduino 1.8 Arduino
LaunchPad 1.6.10E18 Energia
Maple 0.0.12 MapleIDE
Robotis 1.0.2 ROBOTIS_OpenCM
Wiring 1.0 (0101) Wiring

Arduino Boards Manager

The Arduino 1.8.1 IDE downloads and installs those platforms through the Boards Manager.

. Platform Boards Boards for
Adafruit AVR, SAMD Arduino
ArduCAM ESP8266 Arduino
Arduino AVR, SAM, SAMD, nRF52 Arduino
chipKIT PIC32 Arduino
Cosa AVR Arduino
Digistump AVR, Oak Arduino
Espressif ESP8266 Arduino
Intel Galileo, Edison, Curie Arduino
Little Robot Friends Arduino
Microsoft Arduino
MediaTek One, Duo, ARM Arduino
Moteino AVR Arduino
panStamp AVR, MSP430 Arduino
RedBear nRF51822, STM32F2 Arduino
RFduino Arduino
Simblee Arduino
Glowdeck Arduino
Udoo Neo Arduino 1.6.5

For exact references,

Energia Boards Manager

The Energia 1.6.10E18 IDE downloads and installs those platforms through the Boards Manager.

. Platform Boards Boards for
LaunchPad CC1310, CC3200, MSP432, Tiva C Energia 1.6.10E18

For exact references,

Plug-Ins and Add-Ons

For those platforms, a standard IDE is modified with a plug-in or an add-on. However, the modified IDE can be renamed to avoid possible conflicts.

. Platform Plug-in for Suggested name
Glowdeck Arduino 1.8 Glowdeck
LightBlue Arduino 1.8 LightBlueIDE
Microduino Arduino 1.0 Microduino
Microduino Maple 0.0.12 MapleIDE
Teensy Arduino 1.8 Teensyduino

embedXcode finds the installation automatically, either as a plug-in or as a standalone IDE with the suggested name.

For exact references,

IDE-Less Platforms

Some boards only require a library for a standard IDE. Other boards are IDE-less and rely on a whole SDK managed directly by embedXcode.

. Platform Standalone IDE Library for
4D Systems - chipKIT
DFRobot - Arduino 1.6.5
Particle - -

For exact references,

Install the Adafruit Platform

This section requires embedXcode+.

The Adafruit platform includes the Flora, Gemma, Trinket, Trinket Pro and Feather boards.

The installation is performed with the Boards Manager on the Arduino 1.8 IDE.

Install the Adafruit Platform

If you plan to use the Adafruit board,

  • Download and install the supported versions of the Arduino IDE under the /Applications folder, as described in the section Install the Arduino Platform . Other releases don't work.

  • Launch it.

  • Define the path of the sketchbook folder in the menu Arduino > Preferences > Sketchbook location.

  • Avoid spaces in the name and path of the sketchbook folder.

  • Follow the procedure Install Additional Boards on Arduino .

  • Call the Boards Manager and check the Adafruit platform is listed.

If the Adafruit platform isn’t listed on the Boards Manager,

  • Open the Preferences.

  • Add the following URL on a separate line, as described in section Add URLs for New Boards .

https://www.adafruit.com/package_adafruit_index.json
  • Select the boards and click on Install.

For more information on the installation of the Adafruit boards,

The Feather nRF52 board requires the installation of additional tools.

For both the Trinket and Trinket Pro, Adafruit acknowledges stability issues with the direct USB upload.

For the Trinket Pro, Adafruit recommends to use a standard FTDI programmer for a better reliability.

For more information,

For debugging against the Feather M0, use the Segger J-Link emulator.

For more information,

Connect the Board

The Adafruit boards are under the menu Tools > Board.

Install the ArduCAM Platform

This section requires embedXcode+.

The ArduCAM platform includes the ArduCAM ESP8266 and the ArduCAM CC3200 boards.

The installation for the ArduCAM CC3200 board requires the Energia IDE.

The installation for the ArduCAM ESP8266 board requires the Boards Manager on the Arduino 1.8 IDE.

Install the ArduCAM CC3200 Board

If you plan to use the ArduCAM CC3200 board,

For more information on the installation of the ArduCAM CC3200 board,

The ArduCAM CC3200 board is under the menu Tools > Board.

Install the ArduCAM ESP8266 Board

If you plan to use the ArduCAM ESP8266 board,

  • Download and install the supported versions of the Arduino IDE under the /Applications folder, as described in the section Install the Arduino Platform . Other releases don't work.

  • Launch it.

  • Define the path of the sketchbook folder in the menu Arduino > Preferences > Sketchbook location.

  • Avoid spaces in the name and path of the sketchbook folder.

  • Follow the procedure Install Additional Boards on Arduino .

  • Call the Boards Manager and check the ArduCAM platform is listed.

If the ArduCAM platform isn’t listed on the Boards Manager,

  • Open the Preferences.

  • Add the following URL on a separate line, as described in section Add URLs for New Boards .

http://www.arducam.com/downloads/ESP8266_UNO/package_ArduCAM_index.json
  • Select the boards and click on Install.

For more information on the installation of the ArduCAM ESP8266 board,

The ArduCAM ESP8266 board is under the menu Tools > Board.

Install the Arduino Platform

The IDE for all the Arduino boards is called Arduino with release 1.8.

Install the Arduino IDE

If you plan to use the Arduino boards,

  • Download and install Arduino 1.8.0 or later from Arduino  under the /Applications folder. Other releases don't work.

  • Launch it.

Release 1.8 of the Arduino.CC IDE is required for macOS 10.12 Sierra.

Please note that all releases of Arduino previous to release 1.8, including 0023, 1.0 and 1.5, and series 1.6 and 1.7, are deprecated and not longer supported

  • Define the path of the sketchbook folder in the menu Arduino > Preferences > Sketchbook location.

  • Avoid spaces in the name and path of the sketchbook folder.

In this example, the sketchbook folder is /User/ReiVilo/Documents/Projects/Arduino. The same procedure applies for the other IDEs: Energia, Maple, Teensy or Wiring.

The Arduino 1.8 IDE provides two procedures to manage additional boards and libraries.

The Arduino 1.8 IDE comes with only one architecture installed, the 8-bit ATmega. The 32-bit architecture nRF52 for Arduino Primo requires a specific procedure detailed at Install the nRF52 Boards. The 32-bit architectures SAM for Arduino Due and SAMD for Arduino Zero and M0 require a specific procedure detailed at Install the SAM and SAMD boards.

embedXcode+ allows to locate the Arduino IDE in another folder.

Install the nRF52 Boards

The standard installation doesn't include all the boards: the Arduino Primo needs to be installed manually.

  • Select the board and click on Install.

For more information on the installation of the additional boards on the Arduino IDE,

Install the SAM and SAMD Boards

The standard installation doesn't include all the boards: the Arduino Due and the Arduino Zero need to be installed manually.

  • Select the board and click on Install.

For more information on the installation of the additional boards on the Arduino IDE,

Install External Debugger for Arduino Due

This section requires embedXcode+.

The Arduino Zero includes its own debugger.

The Arduino Due requires an external debugger, like the Segger J-Link. For more information,

Install the Driver for the Arduino Tian Board

The Arduino Tian board requires a specific driver on Mac OS X.

  • Open the Arduino IDE.

  • Call the menu Tools > Install Driver.

  • Follow the instructions.

For more information on the Arduino Tian installation,

Install Additional Boards on Arduino

Starting release 1.6.5, the Arduino IDE includes a Boards Manager for downloading and installing additional boards. It relies on a list of URLs set in the Preferences pane.

Install Additional Boards

  • Call the menu Tools > Board > Boards Manager...

A new window lists all the boards available, already installed or ready for installation, based on a set of URLs.

  • Select the board and click on Install.

  • Click OK.

If the board isn’t listed, the URL needs to be added manually.

For more information on the installation of the additional boards on the Arduino IDE,

Add URLs for New Boards

The Boards Manager lists the boards based on a set of URLs. To add a new board, the relevant URL should be added. The URL corresponds to a JSON file.

https://www.adafruit.com/package_adafruit_index.json
  • Call the menu Arduino > Preferences or press Cmd+,.

This is the preference window, with a list of URLs at Additional Boards Manager URLs.

  • Click on the button at the right of Additional Boards Manager URLs.

  • Paste the URL with the JSON file. There should be one URL per line.

  • Click OK.

  • Call the menu Tools > Board > Boards Manager...

Update the Boards

  • Check and update the boards when new releases are available.

Before updating the board, make sure the new release is supported by embedXcode.

  • Call the menu Tools > Board > Boards Manager...

  • Set the Type to Upgradable.

The window displays all the boards to be updated.

  • Select the board and click on Update.

  • Once all boards are updated, click on Close.

After updating the board, check the release number and update the About.mk file, as described in section Check and Update the Boards Reference List .

Check Supported Boards

This procedure has been tested successfully with the following boards:

  • Arduino Due, M0 and Zero, Star Otto, Primo

  • Intel Curie, Galileo and Edison

  • ArduCAM ESP8266

  • Adafruit

  • chipKIT

  • Cosa

  • Digistump

  • ESP8266

  • Little Robot Friends

  • MediaTek LinkIt

  • Microsoft

  • Moteino

  • panStamp AVR and NRG

  • RedBear

  • RFduino

  • Seeeduino

  • Simblee

  • TinyCircuits

  • Udoo Neo

Install Additional Libraries on Arduino

Starting release 1.6.5, the Arduino IDE includes a Libraries Manager for downloading and installing additional libraries. It relies on a list of URLs managed centrally by Arduino.

Install Additional Libraries

  • Call the menu Sketch > Include Library > Manage Libraries...

A new window lists all the libraries available, already installed or ready for installation, based on a set of URLs.

  • Select the board and click on Install.

    • Click OK..

If the board isn’t listed, the URL needs to be added manually.

For more information on the installation of the additional boards on the Arduino IDE,

Install the chipKIT Platform

This section requires embedXcode+.

The installation of the chipKIT platform is performed with the Boards Manager on the Arduino 1.8 IDE.

The previous stand-alone IDE, MPIDE, is no longer supported.

Install the chipKIT Platform

If you plan to use the chipKIT boards,

  • Download and install the supported versions of the Arduino IDE under the /Applications folder, as described in the section Install the Arduino Platform .

  • Launch it.

  • Define the path of the sketchbook folder in the menu Arduino > Preferences > Sketchbook location.

  • Avoid spaces in the name and path of the sketchbook folder.

  • Follow the procedure Install Additional Boards on Arduino .

  • Call the Boards Manager and check the chipKIT boards are listed.

If the chipKIT boards aren't listed on the Boards Manager,

  • Open the Preferences.

  • Add the following URL on a separate line, as described in section Add URLs for New Boards .

https://github.com/chipKIT32/chipKIT-core/raw/master/package_chipkit_index.json
  • Select the boards and click on Install.

The procedure also installs the network and WiFi libraries required by the chipKIT WF32 and WiFire boards, and by the chipKIT WiFi shield for other boards.

Some boards like the chipKIT uC32 may require an update of the boot-loader.

For more information on the installation process,

Install Debugging Tools for chipKIT Boards

This section requires embedXcode+.

Debugging has been tested successfully on the following boards:

  • chipKIT Uno32 with the chipKIT PGM programmer-debugger.

Debugging the chipKIT boards requires a compatible programmer like the chipKIT PGM and the official debugger MDB tool, part of the official Microchip MPLABX  IDE.

  • Download MPLABX for OS X from Microchip, release 2.10 or later.

  • Install MPLABX with the default settings. mplab_ide is located in the folder /Applications/microchip.

Install the 4D Systems Platform

This section requires embedXcode+.

The 4D Systems boards combine a colour touch screen with a controller. The IoD boards are powered by an ESP8266 MCU while the PICadillo board runs on a PIC32.

Install the 4D Systems gen4 IoD Boards

If you plan to use the gen4 IoD boards from 4D Systems:

  • First install the ESP8266 platform as described in the procedure Install the ESP8266 Platform .

  • Download the graphics library GFX4d  by 4D Systems.

  • Unzip the file.

  • Copy the folders on the libraries folder, included in the sketchbook folder.

The gen4 IoD board needs to be added to the list of the boards.

  • Launch the Finder and go for the boards.txt file of the ESP8266 boards package.

  • Press Cmd+Shift+G and enter the path ~/Library/Arduino15/Arduino15/packages/esp8266/hardware/esp8266, and select the folder with the most recent version, for example 2.3.0.

  • Click on Go.

  • Open the boards.txt file.

Add the following lines at the end of the boards.txt file.

##############################################################
gen4iod.name=4D Systems gen4 IoD Range
gen4iod.upload.tool=esptool
gen4iod.upload.speed=921600
gen4iod.upload.resetmethod=nodemcu
gen4iod.upload.maximum_size=434160
gen4iod.upload.maximum_data_size=81920
gen4iod.upload.wait_for_upload_port=true
gen4iod.serial.disableDTR=true
gen4iod.serial.disableRTS=true
gen4iod.build.mcu=esp8266
gen4iod.build.f_cpu=160000000L
gen4iod.build.board=GEN4_IOD
gen4iod.build.core=esp8266
gen4iod.build.variant=generic
gen4iod.build.flash_mode=qio
gen4iod.build.flash_size=512K
gen4iod.build.flash_ld=eagle.flash.512k0.ld
gen4iod.build.flash_freq=80
gen4iod.build.debug_port=
gen4iod.build.debug_level=
gen4iod.menu.CpuFrequency.160=160 MHz
gen4iod.menu.CpuFrequency.160.build.f_cpu=160000000L
gen4iod.menu.CpuFrequency.80=80 MHz
gen4iod.menu.CpuFrequency.80.build.f_cpu=80000000L
gen4iod.menu.UploadSpeed.115200=115200
gen4iod.menu.UploadSpeed.115200.upload.speed=115200
gen4iod.menu.UploadSpeed.9600=9600
gen4iod.menu.UploadSpeed.9600.upload.speed=9600
gen4iod.menu.UploadSpeed.57600=57600
gen4iod.menu.UploadSpeed.57600.upload.speed=57600
gen4iod.menu.UploadSpeed.256000.windows=256000
gen4iod.menu.UploadSpeed.256000.upload.speed=256000
gen4iod.menu.UploadSpeed.230400.linux=230400
gen4iod.menu.UploadSpeed.230400.macosx=230400
gen4iod.menu.UploadSpeed.230400.upload.speed=230400
gen4iod.menu.UploadSpeed.460800.linux=460800
gen4iod.menu.UploadSpeed.460800.macosx=460800
gen4iod.menu.UploadSpeed.460800.upload.speed=460800
gen4iod.menu.UploadSpeed.512000.windows=512000
gen4iod.menu.UploadSpeed.512000.upload.speed=512000
gen4iod.menu.UploadSpeed.921600=921600
gen4iod.menu.UploadSpeed.921600.upload.speed=921600

Unfortunately, the listing provided at section 12.1 Programming the IoD with the Arduino IDE of the gen4-IoD Datasheet is not formatted correctly. Copying-pasting it directly into the boards.txt file raises error on macOS.

For more information on the installation of the board,

  • Please refer to the manufacturer documentation on the gen4 IoD  page on the 4D Systems website.

Install the 4D Systems PICadillo Board

If you plan to use the PICadillo board from 4D Systems:

  • First install the chipKIT platform as described in the procedure Install the chipKIT Platform .

  • Download the DisplayCore library  by Majenko Technologies.

  • Unzip the file.

  • Copy the folders on the libraries folder, included in the sketchbook folder.

  • Connect the board

The PICadillo-35T board is under the menu Tools > Board > 4D Systems.

For more information on the board,

  • Please refer to the manufacturer documentation on the PICadillo-35T  page.

For more information on the library,

Install the DFRobot Platform

This section requires embedXcode+.

If you plan to use the DFRobot platform:

  • Download and install the supported versions of the Arduino IDE under the /Applications folder, as described in section Install the Arduino Platform . Other releases don't work.

  • Launch it.

  • Define the path of the sketchbook folder in the menu Arduino > Preferences > Sketchbook location.

The BLuno board integrates Bluetooth 4.0 or BLE into a standard Arduino Uno board and the Wido board integrates WiFi into a standard Arduino Leonardo board.

Install the DFRobot BLuno Board

The Bluetooth connection of the DFRobot BLuno board is managed by the dedicated PlainProtocol library.

  • Download and install the PlainProtocol library as a standard Arduino library.

For more details on examples,

  • Please refer to the reference pages for simple and the advanced  usage.

On embedXcode,

  • Select the Arduino Uno board or the DFRobot BLuno board to compile and upload the sketch to the board.

Install the DFRobot Wido Board

The WiFi connection of the DFRobot Wido board is managed by the CC3200 MCU with intergrated WiFi radio..

  • Download and install the CC3000 Library as a standard Arduino library.

For learn more about examples,

  • Please refer to the reference pages for different examples .

On embedXcode,

  • Select the Arduino Leonardo board or the DFRobot Wido board to compile and upload the sketch to the board.

embedXcode+ allows to locate the Arduino IDE in another folder.

Install the Espressif Platform

The installation for the ESP8266 and ESP32 boards on the Wiring / Arduino framework is performed with the Boards Manager on the Arduino 1.8 IDE.

Install the ESP8266 Platform

If you plan to use the ESP8266 boards,

  • Download and install the supported versions of the Arduino IDE under the /Applications folder, as described in the section Install the Arduino Platform .

  • Launch it.

  • Define the path of the sketchbook folder in the menu Arduino > Preferences > Sketchbook location.

  • Avoid spaces in the name and path of the sketchbook folder.

  • Follow the procedure Install Additional Boards on Arduino .

  • Call the Boards Manager and check the ESP8266 platform is listed.

If the ESP8266 platform isn’t listed on the Boards Manager,

  • Open the Preferences.

  • Add the following URL on a separate line, as described in section Add URLs for New Boards .

http://arduino.esp8266.com/stable/package_esp8266com_index.json
  • Select the boards and click on Install.

For more information on the installation process,

  • Please refer to the Read Me page on the ESP8266 repository.

Install the ESP32 Platform

This section requires embedXcode+.

If you plan to use the ESP32 boards,

  • Download and install the supported versions of the Arduino IDE under the /Applications folder, as described in the section Install the Arduino Platform .

  • Launch it.

  • Define the path of the sketchbook folder in the menu Arduino > Preferences > Sketchbook location.

  • Avoid spaces in the name and path of the sketchbook folder.

The board package for the ESP32 is still in beta and not available as a board package on the GitHib repository .

However, DFRobot provides a board package for the FireBeetle ESP32 board .

If the ESP32 platform isn’t listed on the Boards Manager,

  • Open the Preferences.

  • Add the following URL on a separate line, as described in section Add URLs for New Boards .

https://git.oschina.net/dfrobot/FireBeetle-ESP32/raw/master/package_esp32_index.json
  • Select the boards and click on Install.

The board package from DFRobot only supports the FireBeetle ESP32 board. To add support for the other boards, especially the official ESP32 DevKitC,

  • Launch the Finder and go for the boards.txt file of the ESP8266 boards package.

  • Press Cmd+Shift+G and enter the path ~/Library/Arduino15/Arduino15/packages/esp8266/hardware/esp8266, and select the folder with the most recent version, for example 2.3.0.

  • Click on Go.

  • Open the boards.txt file.

  • Download the boards.txt from the ESP32 Arduino GitHub repository ,

  • Open it and copy-paste its content to the previous boards.txt file.

For more information on the installation process,

Install the USB Drivers

Depending on the board, a 3.3 V FTDI programmer may be required. The ESP8266-based board requires up to 400 mA. For more information,

Connect the Board

The ESP8266 boards are under the menu Tools > Board.

Install the LaunchPad Platform

The official IDE for the MSP430G2, MSP430F, MSP430FR, MSP432, Tiva C Series and CC3200 LaunchPad boards is Energia. Since release 18, Energia is based on the Arduino 1.6.5 IDE, and features the Boards Manager and the Libraries Manager.

Install the Energia IDE

If you plan to use the LaunchPad boards,

  • Download and install Energia release 1.6.10E18 under the /Applications folder. Energia is the official IDE for the LaunchPad platform.

  • Launch it.

  • Define the path of the sketchbook folder in the menu Energia > Preferences > Sketchbook location.

  • Avoid spaces in the name and path of the sketchbook folder.

In this example, the sketchbook folder is /User/ReiVilo/Documents/Projects/Energia.

The Energia 1.6.10E18 IDE provides two procedures to manage additional boards and libraries.

For more information on installing Energia,

Some LaunchPads may require the installation of additional tools or the update of the firmware.

Energia manages two architectures: 16-bit MSP430 and 32-bit ARM for CC3200, MSP432 and Tiva C.

Energia comes with only one architecture installed, the 16-bit MSP430G2. The 32-bit architectures MSP432, CC3200 and Tiva C require a specific procedure detailed at Install the 32-bit LaunchPad boards.

Energia 1.6.10E18 no longer supports the C2000 LaunchPad and CC2650 SensorTag. For the C2000 LaunchPad,

Install the LaunchPad MSP430G2 Boards

If you plan to use the LaunchPad MSP430G2 boards, you need to install a driver.

  • Proceed with the installation.

Once completed, the installation reboots the computer.

Install the LaunchPad MSP430F5529 and MSP430FR5969 Boards

If you plan to use the LaunchPad MSP430F5529 and MSP430FR5969 boards, you need to check that the firmware of the programmer is up-to-date.

  • Download Energia and install it.

  • Launch Energia.

  • Create a new sketch, for example the blinky sketch.

  • Perform an upload of the sketch with Energia.

  • If the firmware needs to be updated, a window pops-up.

  • In that case, follow the instructions.

  • Call the menu Tools > Update programmer.

  • Check that the upload of the sketch works correctly.

  • If necessary, repeat the update of the programmer.

  • Close Energia.

Install Previous MSP430 Package for More Compact Code

The code built with the MSP430 board package from Energia 0101E12 is more compact than the code obtained with Energia 1.6.10E18. This is especially important for the MSP430G2553 MCU, which includes 512 bytes of RAM only. The special board LaunchPad MSP430G2553 (compact) calls the MSP430 board package from Energia 12.

To use it,

  • Follow the procedure Migrate Previous MSP430 Board Package to Energia 18

  • Select the LaunchPad MSP430G2553 (compact) board instead of the LaunchPad MSP430G2553 board.

Install the 32-bit LaunchPad Boards

The standard installation doesn't include all the boards: the MSP432, CC3200 and Tiva C need to be installed manually.

  • Follow the procedure Install Additional Boards on Energia.

  • Call the Boards Manager and check the MSP432, CC1310, CC3200 and Tiva C boards are listed.

  • Select the board and click on Install.

For more information on the installation of the additional boards on the Energia IDE,

Install the CC3200 LaunchPad

If you plan to use the CC3200 LaunchPad,

On the LaunchPad CC3200, analog inputs are limited to 1,5 V. Higher voltages may damage the MCU. The LaunchPad CC3200 supports two frameworks: Energia and Energia MT based on TI-RTOS.

Install the MSP432 LaunchPad

If you plan to use the MSP432 LaunchPad,

The LaunchPad MSP432 comes in two releases, a pre-series in black and the final series in red.

Black for pre-series and red for final series red

There are two board packages. The Energia MSP432 EMT Red boards package supports the red final series board only, while the Energia MSP432 EMT boards package supports both the pre-series black board and the final series red board.

As a consequence,

  • Select the LaunchPad MSP432P401 EMT board configuration file for the pre-series black board and the final series red board.

  • Select the LaunchPad MSP432P401 Red EMT board configuration file for the final series red board.

The LaunchPad MSP432 only supports the Energia MT framework, based on TI-RTOS.

Install the LaunchPad C2000 Boards and CC2650 SensorTag

Although Energia 1.6.10E18 no longer supports the C2000 LaunchPad platform and the CC2650 SensorTag, the corresponding files can be migrated from the previous release 0101E0017 of Energia.

Install Debug Tools for the LaunchPad Boards

This section requires embedXcode+.

Debugging has been tested successfully on the following boards:

  • Most of the LaunchPad boards, including MSP430G2, MSP430F5529, LM4F120 Stellaris now TM4C123 Tiva C, CC3200 WiFi, MSP432,

  • Experimenter Board MSP430FR5739.

The LaunchPads MSP430G2 and MSP430F5529 and the Experimenter Board MSP430FR5739 require no additional tool as the debugger is already provided by the Energia IDE.

The LaunchPad LM4F120 Stellaris now TM4C123 Tiva C, the LaunchPad TM4C129 Connected and the LaunchPad CC3200 WiFi require the installation of an additional tool, namely OpenOCD.

The installation of OpenOCD can be done using either Homebrew or MacPorts. It is recommended to use only one among those tools.

OpenOCD requires the previous installation of libusb , a library that provides an easy access to USB devices.

  • Install OpenOCD for LaunchPads with Homebrew

To install OpenOCD with Homebrew,

  • Open a Terminal window.

  • Launch the following command to install Homebrew.

$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
  • Launch the following command to install libusb.
$ brew install libusb
  • Launch the following command to install openOCD.
$ brew install openocd

Some LaunchPad boards require a specific installation of OpenOCD. This is done by specifying options during installation.

For example, the CC3200 requires the following options:

$ brew install openocd --enable-legacy-ft2232_ftd2xx --enable-ti-icdi

For more information,

  • Please refer to the OpenOCD documentation  and to the websites of the respective manufacturers of the boards.

For more information on the installation of OpenOCD for the LaunchPad CC3200,

Install OpenOCD for LaunchPads with MacPorts

To install OpenOCD with MacPorts,

  • Download and install MacPorts .

  • Open a Terminal window.

  • Launch the following command to install libusb.

$ sudo port install libusb
  • Launch the following command to install openOCD.
$ sudo port install openocd +ti

Update to Energia 1.6.10E18

Release 1.6.10E18 of Energia changes the boards tags and discontinues support for the CC2650 SensorTag and C2000 LaunchPad boards.

For the conversion table and the update procedure,

For the installation and use of Energia release 0101E0017 for CC2650 SensorTag and C2000 LaunchPad boards,

Install Java 8

The Energia 1.8 IDE isn't self-contained and requires the installation of the Java 8 JDK for external utilities. If the Java 8 JDK isn't available, Energia prompts an error message.

If you don't plan to use the Energia IDE, there is no need for installing the Java 8 JDK as embedXcode doesn't require it.

  • Go to Java SE Development Kit 8 Downloads  on the Oracle website.

  • Download and install the jdk-8u111-macosx-x64 package.

  • Relaunch Energia 1.8 IDE.

Find More Information

All the LaunchPad boards feature a built-in hardware debugger. Learn more on how to use the debugger at the chapter Debug the Project.

embedXcode+ allows to locate the the Energia IDE in another folder.

Install Additional Boards on Energia

Starting release 1.6.10E18, the Energia IDE includes a Boards Manager for downloading and installing additional boards. It relies on a list of URLs set in the Preferences pane.

Install Additional Boards

  • Call the menu Tools > Board > Boards Manager...

A new window lists all the boards available, already installed or ready for installation, based on a set of URLs.

  • Select the board and click on Install.

  • Click OK.

If the board isn’t listed, the URL needs to be added manually.

For more information on the installation of the additional boards on the Energia IDE,

Add URLs for New Boards

The Boards Manager lists the boards based on a set of URLs. To add a new board, the relevant URL should be added. The URL corresponds to a JSON file.

https://www.adafruit.com/package_adafruit_index.json
  • Call the menu Energia > Preferences.

This is the preference window, with a list of URLs at Additional Boards Manager URLs.

  • Click on the button at the right of Additional Boards Manager URLs.

  • Paste the URL with the JSON file. There should be one URL per line.

  • Click OK.

  • Call the menu Tools > Board > Boards Manager...

Update the Boards

Check and update the boards when new releases are available. Before updating the board, make sure the new release is supported by embedXcode.

  • Call the menu Tools > Board > Boards Manager...

  • Set the Type to Upgradable.

The window displays all the boards to be updated.

  • Select the board and click on Update.

Check Supported Boards

This procedure has been tested successfully with the following boards:

  • Energia MSP432, TivaC, CC3200 and CC1310

Install Boards from Previous Releases of Energia

Although Energia 1.6.10E18 no longer supports the C2000 LaunchPad platform and the CC2650 SensorTag, the corresponding files can be migrated from the previous release 0101E0017 of Energia.

  • Proceed with Install Energia 0101E0017 IDE.

  • For the C2000 LaunchPad boards, follow the procedures Install the LaunchPad C2000 Boards and Migrate the LaunchPad C2000 Boards to Energia 18.

  • For the CC2650 SensorTag, follow the procedure Migrate the CC2650 SensorTag to Energia 18.

Similarly, Energia 12 builds a more compact code than Energia 1.6.10E18 against the MSP430G2 boards. This is especially relevant for the MSP430G2553 MCU with only 512 bytes of RAM.

  • Proceed with Install Energia 0101E0012 IDE.

  • Follow the procedure Migrate Previous MSP430 Board Package to Energia 18.

Install Energia 0101E0017 IDE

If you plan to use the C2000 LaunchPad or the CC2650 SensorTag,

  • Download and install Energia release 0101E0017 under the /Applications folder. Energia is the official IDE for the LaunchPad platform.

  • Rename Energia as Energia-17.app to avoid any conflict with the current release of Energia.

  • Launch it.

  • Define the path of the sketchbook folder in the menu Energia > Preferences > Sketchbook location.

  • Avoid spaces in the name and path of the sketchbook folder.

In this example, the sketchbook folder is /User/ReiVilo/Documents/Projects/Energia.

For more information on installing Energia,

Some LaunchPads may require the installation of additional tools or the update of the firmware.

Energia manages three architectures: 16-bit MSP430, 16-bit C2000 and 32-bit ARM.

Install the LaunchPad C2000 Boards

If you plan to use the LaunchPad C2000 F28027, F28069 and F28377 boards, you need to install the specific tool-chain.

There are two versions of the tools with different licences.

  • Locate the registration-free short-term support v15.3.0.STS C2000 Code Generation Tools section and then select the version for Mac OS X.

  • Download and unzip ti_cgt_c2000_15.3.0_osx_installer.zip.

  • Launch the ti_cgt_c2000_15.3.0_osx_installer.

  • Follow the instructions and note the destination directory.

As an alternative,

  • Locate the C2000 Code Generation Tools v6.4.2 section and then select the version for Mac OS X.

  • Go though the registration process. Once the registration is approved, proceed with the download.

  • Open a Terminal window and change the directory to where the downloaded file is located.

$ cd ~/Downloads 
  • Change the authorisation of the downloaded file to make it executable.
$ sudo chmod +X ti_cgt_c2000_6.4.3_mac_installer.sh 
  • Launch the installer.
$ ./ti_cgt_c2000_6.4.3_mac_installer.sh 

Once the licence agreement is accepted, the installer unzips the file and creates the folder c2000_6.4.3.

Once the C2000 Code Generation Tools are installed,

  • Open the /Applications folder and find the Energia-17 application.

  • Select the Energia icon, call the contextual menu and select Show Package Content.

  • Navigate to the Energia-17.app/Contents/Resources/Java/hardware/tools folder.

  • Copy the ti-cgt-c2000_15.3.0 folder or the c2000_6.4.3 folder and paste it under the tools folder to obtain Contents/Resources/Java/hardware/tools/ti-cgt-c2000_15.3.0 or Contents/Resources/Java/hardware/tools/c2000_6.4.3.

  • Change the name of the ti-cgt-c2000_15.3.0 folder or the c2000_6.4.3 folder for c2000.

  • Launch Energia and check that the LaunchPad (C2000) with TMS320F28027 (60MHz) board and the board appear on the menu Tools > Boards.

Please note that, due to the partial compatibility of the C2000 Code Generation Tools with GCC, some features as click-to-error, warning messages and debugging are not available.

Migrate the LaunchPad C2000 Boards to Energia 18

To migrate the C2000 platform from Energia 17 to Energia 1.6.10E18,

  • Open a Terminal window.

  • Create the target folders.

$ mkdir -p ~/Library/Energia15/packages/energia/hardware/c2000/0.9.0

$ mkdir -p ~/Library/Energia15/packages/energia/tools/c2000/15.3.0
  • Copy the folders into the new ones
$ cp -R /Applications/Energia-17.app/Contents/Resources/Java/hardware/c2000/* ~/Library/Energia15/packages/energia/hardware/c2000/0.9.0/

$ cp -R /Applications/Energia-17.app/Contents/Resources/Java/hardware/tools/c2000/*

~/Library/Energia15/packages/energia/tools/c2000/15.3.0

The Energia-17.app application refers to the Energia 17 IDE.

  • Please note the Energia 1.6.10E18 IDE does not support the C2000 platform officially.

Migrate the CC2650 SensorTag to Energia 18

To migrate the CC2650 SensorTag from Energia 17 to Energia 1.6.10E18,

  • Open a Terminal window.

  • Create the target folder.

$ mkdir -p /Library/Energia15/packages/energia/hardware/cc26xx/0.9.0/system/
  • Copy the folders into the new ones.
$ cp -R /Applications/IDE/Energia-17.app/Contents/Resources/Java/hardware/cc2600emt/* /Library/Energia15/packages/energia/hardware/cc26xx/0.9.0/

$ cp -R /Applications/IDE/Energia-17.app/Contents/Resources/Java/hardware/emt/* /Library/Energia15/packages/energia/hardware/cc26xx/0.9.0/system/

The Energia-17.app application refers to the Energia 17 IDE.

  • Please note the Energia 1.6.10E18 IDE does not support the CC2650 SensorTag officially.

Install Energia 0101E0012 IDE

If you plan to use the MSP430 board package from Energia 12,

  • Download release 12 for the Energia download page  and install it.

  • Rename Energia as Energia-12.app to avoid any conflict with the current release of Energia.

  • Launch it.

  • Define the path of the sketchbook folder in the menu Energia > Preferences > Sketchbook location.

Migrate Previous MSP430 Board Package to Energia 18

To migrate the MSP430 platform from Energia 12 to Energia 1.6.10E18,

  • Open a Terminal window.

  • Create the target folder.

$ mkdir -p ~/Library/Energia15/packages/energia/hardware/msp430/0.1.2
  • Copy the folder into the new one.
$ cp -R /Applications/Energia-12.app/Contents/Resources/Java/hardware/msp430/* ~/Library/Energia15/packages/energia/hardware/msp430/0.1.2/
  • Use the LaunchPad MSP430G2553 (compact) board.

The Energia-12.app application refers to the Energia 12 IDE.

  • Please note the Energia 1.6.10E18 IDE does not support the previous MSP430 boards package officially.

Install Additional Libraries on Energia

Starting release 1.6.10E18, the Energia IDE includes a Libraries Manager for downloading and installing additional libraries. It relies on a list of URLs managed centrally by Energia.

Install Additional Libraries

  • Call the menu Sketch > Include Library > Manage Libraries...

A new window lists all the libraries available, already installed or ready for installation.

  • Select the library and click on Install.

  • Click OK.

For more information on the installation of the additional boards on the Energia IDE,

Install the LightBlue Platform

This section requires embedXcode+.

The installation of the LightBlue platform includes a plug-in and modifies the Arduino IDE.

Install the LightBlue Plug-In

If you plan to use the LightBlue Bean board by Punch Through Design board:

  • Download and install the supported versions of the Arduino IDE under the /Applications folder, as described in the section Install the Arduino Platform . Other releases don't work.

  • Download and launch the Bean Loader .

As the IDE for LightBlue boards modifies the Arduino IDE, you may want to have a separate modified Arduino IDE for the LightBlue boards.

  • Change the name to LightBlueIDE and the icon to avoid any confusion with the standard Arduino.

  • Download and install the Bean Loader App for OS X plug-in release 1.8.1.

  • Launch it.

  • Click on Associate.

  • Select the Arduino 1.0 or the LightBlueIDE application and click on Associate.

embedXcode identifies the IDE automatically among Arduino and LightBlueIDE.

For more information on the installation process,

+ Install the Bean Command Line Loader

The Bean Command Line Loader is a complement for the Bean Loader. It provides a command-line interface that eases automation with embedXcode.

The package contains node.js and npm. node.js is a platform for network applications.

And npm is a package manager for node.js.

  • Open a Terminal window.

  • Enter the following command to download the Bean Command Line Loader package.

$ sudo npm install -g bean-sdk

For more information on the Bean Command Line Loader,

  • Please refer to the Node.js SDK/CLI . page on the on the LightBlue website.

Connect the Board

The LightBlue board appears under the menu Tools > Board.

embedXcode+ allows to locate the LightBlueIDE in another folder.

Install the MediaTek LinkIt Platform

This section requires embedXcode+.

The installation for the MediaTek LinkIt boards is performed with the Boards Manager on the Arduino 1.8 IDE.

Install the LinkIt One Board

If you plan to use the MediaTek LinkIt One board,

  • Download and install the supported versions of the Arduino IDE under the /Applications folder, as described in the section Install the Arduino Platform .

  • Launch it.

  • Define the path of the sketchbook folder in the menu Arduino > Preferences > Sketchbook location.

  • Avoid spaces in the name and path of the sketchbook folder.

  • Follow the procedure Install Additional Boards on Arduino .

  • Call the Boards Manager and check the LinkIt One platform is listed.

If the LinkIt One platform isn’t listed on the Boards Manager,

  • Open the Preferences.

  • Add the following URL on a separate line, as described in section Add URLs for New Boards .

http://download.labs.mediatek.com/package_mtk_linkitone_index.json
  • Select the board and click on Install.

  • Download and install the USB COM port driver for LinkIt ONE development board .

embedXcode+ allows to locate the Arduino IDE in another folder.

Connect the Board

You may need to upgrade the board’s firmware, as explained at the Update Your Board’s Firmware  page.

The MediaTek LinkIt One board appears under the menu Tools > Board.

For more information,

Install the LinkIt Smart 7688 Duo Board

If you plan to use the MediaTek LinkIt Smart 7688 Duo board,

  • Download and install the supported versions of the Arduino IDE under the /Applications folder, as described in the section Install the Arduino Platform .

  • Launch it.

  • Define the path of the sketchbook folder in the menu Arduino > Preferences > Sketchbook location.

  • Avoid spaces in the name and path of the sketchbook folder.

  • Follow the procedure Install Additional Boards on Arduino .

  • Call the Boards Manager and check the LinkIt Smart 7688 Duo platform is listed.

If the LinkIt Smart 7688 Duo platform isn’t listed on the Boards Manager,

  • Open the Preferences.

  • Add one of the following URLs on a separate line, as described in section Add URLs for New Boards .

http://download.labs.mediatek.com/package_mtk_linkit_smart_7688_index.json

http://download.labs.mediatek.com/package_mtk_linkit_smart_7688_test_index.json
  • Select the board and click on Install.

embedXcode+ allows to locate the Arduino IDE in another folder.

Connect the Board

You may need to upgrade the board’s firmware, as explained at the MediaTek LinkIt Smart 7688 Hardware Development Kits  page.

The MediaTek LinkIt One board appears under the menu Tools > Board.

For more information,

Install the LinkIt 7697 Board

If you plan to use the MediaTek LinkIt 7697 board,

  • Download and install the supported versions of the Arduino IDE under the /Applications folder, as described in the section Install the Arduino Platform .

  • Launch it.

  • Define the path of the sketchbook folder in the menu Arduino > Preferences > Sketchbook location.

  • Avoid spaces in the name and path of the sketchbook folder.

  • Follow the procedure Install Additional Boards on Arduino .

  • Call the Boards Manager and check the LinkIt Smart 7688 Duo platform is listed.

If the LinkIt 7697 platform isn’t listed on the Boards Manager,

  • Open the Preferences.

  • Add one of the following URLs on a separate line, as described in section Add URLs for New Boards .

http://download.labs.mediatek.com/package_mtk_linkit_7697_index.json
  • Select the board and click on Install.

embedXcode+ allows to locate the Arduino IDE in another folder.

Install the Microduino Platform

This section requires embedXcode+.

The Microduino platform includes two architectures, one 8 bits and another 32 bits, each with its dedicated IDE.

The 8-bit ATmega architecture includes the Microduino-Core with an ATmega328P at 16 MHz and 5V, the Microduino-Core+ with an ATmega644PA at 16 MHz and 5V and the Microduino-Core USB with an ATmega32u4 at 16 MHz. Those boards run on a plug-in for the Arduino IDE.

The 32-bit architecture corresponds to the Microduino-Core STM32 board, and uses the MapleIDE or the STM32duino platform for the Arduino 1.6.5 IDE.

Install the Microduino Platform for ATmega

If you plan to use the Microduino-Core with an ATmega328P at 16 MHz and 5V, the Microduino-Core+ with an ATmega644PA at 16 MHz and 5V or the Microduino-Core USB with an ATmega32u4 at 16 MHz,

  • Download and install the supported versions of the Arduino IDE under the /Applications folder, as described in the section Install the Arduino Platform .

  • Select the Arduino icon, call the contextual menu and select Show Package Content.

  • Navigate to the Content/Resources/Java/Hardware folder for Arduino 1.0.6 or navigate to the Content/Java/Hardware folder Arduino 1.6.1 and 1.7.

  • Download the Microduino plug-in .

  • Open the .zip file.

  • Copy-paste the unzipped folder Microduino into the Content/Resources/Java/Hardware folder for Arduino 1.0.6.

Similarly, copy-paste the content of the unzipped folder libraries into the Contents/Resources/Java/libraries folder for Arduino 1.0.6.

  • Copy-paste the unzipped folder Microduino into the Content/Java/Hardware folder Arduino 1.6.1 and 1.7.

The Microduino folder already contains the libraries.

  • Launch the modified Arduino IDE.

  • Define the path of the sketchbook folder in the menu Arduino > Preferences > Sketchbook location.

  • Avoid spaces in the name and path of the sketchbook folder.

As the IDE for Microduino boards modifies the Arduino IDE, you may want to have a separate modified Arduino IDE for the Microduino boards.

  • Change the name to Microduino and the icon to avoid any confusion with the standard Arduino IDE.

embedXcode identifies the IDE automatically among Arduino and Microduino.

The Microduino boards appear under the menu Tools > Board.

embedXcode+ allows to locate the Arduino or Microduino IDE in another folder.

Install the Microduino Platform for STM32

The Microduino-Core STM32 board is compatible with the Maple Mini. The IDE used is the MapleIDE or the STM32duino platform for the Arduino 1.6.5 IDE.

If you plan to use the MapleIDE,

  • Follow the instructions provided at the section Install the Maple Platform.

  • Download and install the MapleIDE.

  • Define the path of the sketchbook folder.

  • Install the utility for the uploader.

  • Define the integer standard types.

The Microduino-Core STM32 suffers from the same limitation the Maple environment does: two important libraries, strings.h and stream.h, are not implemented.

If you plan to use the STM32duino platform for the Arduino 1.6.5 IDE,

For more information on the installation of the Microduino-Core STM32,

Connect the Board

Optionally, to replace Maple Mini by Microduino-Core STM32 in the Tools > Board menu,

  • Download the file boards.txt from from the Microduino Tutorials GitHub repository .

  • Copy the downloaded boards.txt file into the /Applications/MapleIDE.app/Contents/Resources/Java/hardware folder to replace the existing one.

embedXcode+ allows to locate the MapleIDE in another folder.

The STM32duino platform provides an alternative solution for the Maple boards.

Install the Microsoft Platform

This section requires embedXcode+.

The Microsoft IoT DevKit platform combines a Cortex-M4 and a WiFi radio and a large assortment of sensors. The installation of the Microsoft platform is performed with the Boards Manager on the Arduino 1.8 IDE.

Install the Microsoft Platform

If you plan to use the Microsoft platform,

  • Download and install the supported versions of the Arduino IDE under the /Applications folder, as described in the section Install the Arduino Platform .

  • Launch it.

  • Define the path of the sketchbook folder in the menu Arduino > Preferences > Sketchbook location.

  • Avoid spaces in the name and path of the sketchbook folder.

  • Follow the procedure Install Additional Boards on Arduino .

  • Call the Boards Manager and check the Microsoft platform is listed.

If the Microsoft platform isn’t listed on the Boards Manager,

  • Open the Preferences.

  • Add the following URL on a separate line, as described in section Add URLs for New Boards .

https://raw.githubusercontent.com/VSChina/azureiotdevkit_tools/master/package_azureboard_index.json
  • Select the board and click on Install.

For more information on the installation of the Arduino IDE,

For more information on the Azure installation,

For more information,

Fix the Compiler Error

Compiling against the AZ3166 with standard tools may raise the error Expected ')' before numeric constant.

Install the Moteino Platform

This section requires embedXcode+.

The Moteino platform by LowPowerLab combines an ATMega328 with a RFM69 sub-1GHz or a RFM95 LoRa radio. The installation of the Moteino platform is performed with the Boards Manager on the Arduino 1.8 IDE.

An external FTDI programmer is required.

Install the Moteino Platform

If you plan to use the Moteino platform,

  • Download and install the supported versions of the Arduino IDE under the /Applications folder, as described in the section Install the Arduino Platform .

  • Launch it.

  • Define the path of the sketchbook folder in the menu Arduino > Preferences > Sketchbook location.

  • Avoid spaces in the name and path of the sketchbook folder.

  • Follow the procedure Install Additional Boards on Arduino .

  • Call the Boards Manager and check the Moteino platform is listed.

If the Moteino platform isn’t listed on the Boards Manager,

  • Open the Preferences.

  • Add the following URL on a separate line, as described in section Add URLs for New Boards .

https://lowpowerlab.github.io/MoteinoCore/package_LowPowerLab_index.json
  • Select the board and click on Install.

For more information on the installation of the Arduino IDE,

Install the Libraries

The RFM69 sub-1GHz-based board requires the RFM69 library , while the RFM95 LoRa-based board requires the LoRa library  from RadioHead .

Optionally, the Moteino platform requires the installation of the SPIFlash library if the SPI flash is populated, and the WirelessHEX69 library for wireless programming.

For each library,

  • Download the compressed .zip file.

  • Unzip the file.

  • Copy the resulting folder as a user's library on the Libraries sub-folder of the sketchbook folder.

The user's libraries are stored on the Libraries or libraries sub-folder under the sketchbook folder.

For more information on the LoRa radio,

For more information on the wireless programming,

Connect the Board

The Moteino boards appear under the menu Tools > Board.

For more information on the installation of the panStamp plug-in,

  • Please refer to the Moteino page the LowPowerLab website.

Install the NodeMCU Board

The NodeMCU board  is based on an ESP8266-12 but features a built-in serial over USB interface.

Although promoted for Lua, the board can be programmed using the Wiring / Arduino framework as the other ESP8266 boards.

If you plan to use the NodeMCU board:

  • Follow the procedure Install the ESP8266 Platform.

The NodeMCU board is considered a a generic ESP8266 board under the menu Tools > Board.

The default uploader provided with the IDE, esptool, supports all the ESP8266-based boards, including the NodeMCU 0.9 and 1.0 boards, since release 0.4.5.

embedXcode+ allows to locate the Arduino or ESP8266 IDE in another folder.

Install the CH340 Driver

The NodeMCU 0.9 uses the CH340 serial to USB programmer, which requires the installation of a specific driver.

Release 1.2 of the driver is signed and thus no longer requires disabling the driver signing verification on Mac OS X.

A more detailed procedure is provided at How to Use Cheap Chinese Arduinos That Come With CH340G / CH341G Serial/USB Chip (Windows & Mac OS-X) .

  • In case a prior version of the driver was installed, uninstall it first.

For more information,

  • Please refer to the WCH website  and to the instructions included in the ReadMe file, available in English.

Install the CP2102 Driver

The NodeMCU 1.0 uses the CP2102 serial to USB programmer, which requires the installation of a specific driver.

For more information,

Install the panStamp Platform

This section requires embedXcode+.

The panStamp platform features a sub-1 GHz radio and includes two architectures, one 8 bits and another 16 bits. Both are managed by the same plug-in. The installation is performed with the Boards Manager on the Arduino 1.8 IDE.

The 8-bit architecture corresponds to the panStamp AVR with an ATmega328P at 16 MHz and 5V, while the 16-bit architecture corresponds to the panStamp NG based on the MSP430.

Install the panStamp Platform

If you plan to use the panStamp platform,

  • Download and install the supported versions of the Arduino IDE under the /Applications folder, as described in the section Install the Arduino Platform .

  • Launch it.

  • Define the path of the sketchbook folder in the menu Arduino > Preferences > Sketchbook location.

  • Avoid spaces in the name and path of the sketchbook folder.

  • Follow the procedure Install Additional Boards. Call the Boards Manager and check the two panStamp platforms are listed.

If the panStamp platforms aren’t listed on the Boards Manager,

  • Open the Preferences.

  • Add the following URL on a separate line, as described in section Add URLs for New Boards .

http://panstamp.org/arduino/package_panstamp_index.json
  • Select the boards and click on Install.

For more information on the installation of the panStamp plug-in,

  • Please refer to the First Steps page the panStamp website.

Connect the Board

The panStamp boards appear under the menu Tools > Board.

For more information on the installation of the panStamp plug-in,

  • Please refer to the First Steps page the panStamp website.

Install the RFduino Platform

This section requires embedXcode+.

The installation of the RFduino board is performed with the Boards Manager on the Arduino 1.8 IDE.

Install the RFduino Platform

If you plan to use the RFduino platform,

  • Download and install the supported versions of the Arduino IDE under the /Applications folder, as described in the section Install the Arduino Platform .

  • Launch it.

  • Define the path of the sketchbook folder in the menu Arduino > Preferences > Sketchbook location.

  • Avoid spaces in the name and path of the sketchbook folder.

  • Follow the procedure Install Additional Boards on Arduino .

  • Call the Boards Manager and check the RFduino platform is listed.

If the RFduino platform isn’t listed on the Boards Manager,

  • Open the Preferences.

  • Add the following URL on a separate line, as described in section Add URLs for New Boards .

http://rfduino.com/package_rfduino_index.json
  • Select the board and click on Install.

For more information on the installation of the RFduino board on the Arduino IDE,

  • Please refer to the Installation page on the RFduino website.

Connect the Board

The RFduino board is under the menu Tools > Board.

Install the RedBear Platform for Wiring / Arduino

This section requires embedXcode+.

The RedBear boards feature different connectivities and MCUs. All run with the Wiring / Arduino framework.

There are three families of boards with Bluetooth Low Energy connectivity. Each one features a specific MCU. The AVR MCU has a separate Bluetooth Low Energy radio. The nRF51822 SoC from Nordic combines a Bluetooth Low Energy radio with a Cortex-M0 MCU. So does the nRF52832 SoC also from Nordic but with a Cortex-M4 MCU.

The RedBear boards with WiFi connectivity are based on the CC3200 and are supported natively by Energia release 0101E0017 or later. The CC3200 from Texas Instruments combines a WiFi radio with a Cortex-M4 MCU.

The RedBear Duo board provides dual WiFi and Bluetooth Low Energy connectivity and features a Cortex-M3 MCU.

Some of the RedBear boards also support the mbed framework. For more information,

Install the RedBear AVR Platform for Wiring / Arduino

If you plan to use the RedBear AVR boards on the Wiring / Arduino framework,

  • Download and install the supported versions of the Arduino IDE under the /Applications folder, as described in the section Install the Arduino Platform .

  • Launch it.

  • Define the path of the sketchbook folder in the menu Arduino > Preferences > Sketchbook location.

  • Avoid spaces in the name and path of the sketchbook folder.

  • Follow the procedure Install Additional Boards on Arduino .

  • Call the Boards Manager and check the RedBear AVR platform is listed.

If the RedBear AVR platform isn’t listed on the Boards Manager,

  • Open the Preferences.

  • Add the following URL on a separate line, as described in section Add URLs for New Boards .

https://redbearlab.github.io/arduino/package_redbearlab_index.json
  • Select the boards and click on Install.

For more information on the installation of the RedBear boards,

The ReadBear Blend boards require two libraries: the BLE SDK for Arduino and the RBL nRF8001. A third one, BLE Peripheral, is recommended.

  • Select the libraries and click on Install.

For more information on the installation of the RedBear libraries,

For more information on the installation of the RedBear boards,

Install the RedBear nRF51822 Platform for Wiring / Arduino

If you plan to use the RedBear boards on the Wiring / Arduino framework,

  • Download and install the supported versions of the Arduino IDE under the /Applications folder, as described in the section Install the Arduino Platform .

  • Launch it.

  • Define the path of the sketchbook folder in the menu Arduino > Preferences > Sketchbook location.

  • Avoid spaces in the name and path of the sketchbook folder.

  • Follow the procedure Install Additional Boards on Arduino .

  • Call the Boards Manager and check the RedBear nRF51822 platform is listed.

If the RedBear nRF51822 platform isn’t listed on the Boards Manager,

  • Open the Preferences.

  • Add the following URL on a separate line, as described in section Add URLs for New Boards .

https://redbearlab.github.io/arduino/package_redbearlab_index.json
  • Select the boards and click on Install.

For more information on the installation of the RedBear boards,

The RedBear boards based on the nRF51822 can run with the Arduino framework as well as the mbed framework. However, once used on mbed mode, the boot-loader required by Arduino is no longer available and needs to be restored.

The process also installs the library in charge of Bluetooth Low Energy. For more information on the use of the RedBear boards,

Connect the nRF51822-Based Board

The RedBear boards are under the menu Tools > Board.

Install the RedBear nRF52832 Boards

This section requires embedXcode+.

If you plan to use the RedBear nRF52832 boards on the Wiring / Arduino framework, the installation process includes three elements: the Arduino IDE, the DFU utility and the BLE stack.

For more information on the RedBear Duo installation,

To install the Wiring / Arduino framework,

  • Download and install the supported versions of the Arduino IDE under the /Applications folder, as described in the section Install the Arduino Platform .

  • Launch it.

  • Define the path of the sketchbook folder in the menu Arduino > Preferences > Sketchbook location.

  • Avoid spaces in the name and path of the sketchbook folder.

  • Follow the procedure Install Additional Boards on Arduino .

  • Call the Boards Manager and check the RedBear nRF52832 platform is listed.

If the RedBear nRF52832 platform isn’t listed on the Boards Manager,

  • Open the Preferences.

  • Add the following URL on a separate line, as described in section Add URLs for New Boards .

https://redbearlab.github.io/arduino/package_redbear_nRF5x_beta_index.json
  • Select the boards and click on Install.

For more information on the installation of the RedBear boards,

Install the RedBear Duo Board

This section requires embedXcode+.

If you plan to use the RedBear Duo board on the Wiring / Arduino framework, the installation process includes three elements: the Arduino IDE, the DFU utility and the BLE stack. For more information on the RedBear Duo installation,

To install the Wiring / Arduino framework,

  • Download and install the supported versions of the Arduino IDE under the /Applications folder, as described in the section Install the Arduino Platform .

  • Launch it.

  • Define the path of the sketchbook folder in the menu Arduino > Preferences > Sketchbook location.

  • Avoid spaces in the name and path of the sketchbook folder.

  • Follow the procedure Install Additional Boards on Arduino .

  • Call the Boards Manager and check the RedBear Duo platform is listed.

If the RedBear Duo platform isn’t listed on the Boards Manager,

  • Open the Preferences.

  • Add the following URL on a separate line, as described in section Add URLs for New Boards .

https://redbear.github.io/arduino/package_redbear_index.json
  • Select the boards and click on Install.

For more information on the installation of the RedBear boards,

The Arduino IDE conflicts with the GCC tool-chain installed for the RedBear Duo board. The Arduino IDE looks for any GCC tool-chain, and uses the RedBear's instead of the Arduino's.

  • Rename the folder ~/Library/Arduino15/packages/RedBear/tools/arm-none-eabi-gcc to ~/Library/Arduino15/packages/RedBear/tools/arm-none-eabi-gcc-redbear.

  • Edit ~/Library/Arduino15/packages/RedBear/hardware/STM32F2/0.2.7/platform.txt.

  • Change line 8 from

compiler.path={runtime.tools.arm-none-eabi-gcc-4.9-2015-q3.path}/bin/

to

compiler.path={runtime.tools.arm-none-eabi-gcc-redbear-4.9-2015-q3.path}/bin/

For more information,

To install the uploader dfu-util,

  • Open a Terminal window.

  • Launch the following command to install Homebrew, if it isn't already available.

$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
  • Run the installation of dfu-util.
$ brew install dfu-util
  • Check the installation in the /usr/local/bin folder.
$ ls /usr/local/bin/dfu*

For more information,

The RedBear Duo uses the BTstack by BlueKitchen for Bluetooth Low Energy. To install it,

Connect the RedBear Duo Board

The RedBear boards are under the menu Tools > Board.

Install the RedBear CC3200 Platform for Energia

As for the LaunchPad CC3200, analog inputs are limited to 1,5 V and digital inputs are not 5 V-tolerant. Higher voltages may damage the MCU. If you plan to use the RedBear boards based on the CC3200 with the Energia IDE, follow the procedure Install the LaunchPad Platform.

Download and install the Energia release 0101E0017 under the /Applications folder. Energia release 0101E0017 supports the RedBear CC3200-based boards natively, with two frameworks: Energia and Energia Multi Tasking.

  • Launch the Energia IDE.

  • Define the path of the sketchbook folder in the menu Arduino > Preferences > Sketchbook location.

  • Connect the CC3200-Based Board

The RedBear boards are under the menu Tools > Board.

The RedBear CC3200 and RedBear WiFi mini support two frameworks: Energia and Energia MT based on TI-RTOS. embedXcode+ allows to locate the Energia IDE in another folder.

Install the Robotis Platform

This section requires embedXcode+.

If you plan to use the Robotis OpenCM9.04 board:

  • Download and install the Robotis OpenCM IDE under the /Applications folder.

  • Launch it.

  • Define the path of the sketchbook folder in the menu ROBOTIS > Preferences > Sketchbook location.

  • Avoid spaces in the name and path of the sketchbook folder.

Install Java 6

The Robotis OpenCM IDE requires Java 6. If it isn't available, an error message suggests to install it.

  • Click on More Info... or go to Download Java for OS X 2015-001  on the Apple website.

  • Download and install the javaforosx.dmg package.

  • Relaunch the Robotis OpenCM IDE.

Define Integer Standard Types

Just like the Maple IDE, Robotis OpenCM only knows [u]int{8|16|32|64} types and ignores the C99 standard [u]int{8|16|32|64}_t types.

If you plan to use libraries designed for another platform and want to ensure C99 compatibility,

Open the /Applications/ROBOTIS_OpenCM.app/Contents/Resources/Java/hardware/robotis/cores/robotis/libpandora_types.h file.

Add this #include to the libpandora_types.h file, although stdint.h defines other types.

#include <stdint.h>

As an alternative,

  • Open the /Applications/ROBOTIS_OpenCM.app/Contents/Resources/Java/hardware/robotis/cores/robotis/libpandora_types.h file.

  • Add the definitions for the [u]int{8|16|32|64}_t types.

// Added C99 Standard Types
#define uint8_t uint8
#define uint16_t uint16
#define uint32_t uint32
#define uint64_t uint64
#define int8_t int8
#define int16_t int16
#define int32_t int32
#define int64_t int64

Just like Maple, the Robotis OpenCM environment misses two important libraries: strings.h and stream.h.

embedXcode+ allows to locate the Robotis OpenCM in another folder.

Install the Seeeduino Platform

The installation of the Seeeduino platform is performed with the Boards Manager on the Arduino 1.8 IDE.

Please note upload to this board hasn't been tested.

Install the Seeeduino AVR Platform

If you plan to use the Seeeduino boards,

  • Download and install the supported versions of the Arduino IDE under the /Applications folder, as described in the section Install the Arduino Platform .

  • Launch it.

  • Define the path of the sketchbook folder in the menu Arduino > Preferences > Sketchbook location.

  • Avoid spaces in the name and path of the sketchbook folder.

  • Follow the procedure Install Additional Boards on Arduino . Call the Boards Manager and check the Seeeduino AVR boards are listed.

If the Seeeduino boards aren't listed on the Boards Manager,

  • Open the Preferences.

  • Add the following URL on a separate line, as described in section Add URLs for New Boards .

https://raw.githubusercontent.com/Seeed-Studio/Seeed_Platform/master/package_seeeduino_boards_index.json
  • Select the boards and click on Install.

For more information on the installation process,

Install the Simblee Platform

This section requires embedXcode+.

The installation of the Simblee board is performed with the Boards Manager on the Arduino 1.8 IDE.

Please note upload to this board hasn't been tested.

Install the Simblee Platform

If you plan to use the Simblee platform,

  • Download and install the supported versions of the Arduino IDE under the /Applications folder, as described in the section Install the Arduino Platform .

  • Launch it.

  • Define the path of the sketchbook folder in the menu Arduino > Preferences > Sketchbook location.

  • Avoid spaces in the name and path of the sketchbook folder.

  • Follow the procedure Install Additional Boards on Arduino .

  • Call the Boards Manager and check the Simblee platform is listed.

If the Little Robot Friends platform isn’t listed on the Boards Manager,

  • Open the Preferences.

  • Add the following URL on a separate line, as described in section Add URLs for New Boards .

https://www.simblee.com/package_simblee166_index.json
  • Select the board and click on Install.

For more information on the installation of the RFduino board on the Arduino IDE,

Connect the Board

The Simblee board is under the menu Tools > Board.

Install the STM32duino Platform

The STM32duino project provides an easy solution for boards based on the STM32F1xx, STM32F3xx and STM32F4xx MCUs. It comes as a package compatible with the Boards Manager of the the Arduino 1.8 IDE.

If you plan to use the Arduino STM32duino package,

  • Download and install the supported versions of the Arduino IDE under the /Applications folder, as described in the section Install the Arduino Platform .

  • Launch it.

  • Define the path of the sketchbook folder in the menu Arduino > Preferences > Sketchbook location.

  • Avoid spaces in the name and path of the sketchbook folder.

  • Follow the procedure Install Additional Boards on Arduino .

  • Call the Boards Manager and check the STM32F1xx boards are listed.

If the STM32F1xx boards aren’t listed on the Boards Manager,

  • Open the Preferences.

  • Add the following URL on a separate line, as described in section Add URLs for New Boards .

http://dan.drown.org/stm32duino/package_STM32duino_index.json
  • Select the boards and click on Install.

For more information on the installation of the Arduino IDE,

  • Please refer to the Arduino STM32 page on the GitHub repository.

Install the Teensy Platform

If you plan to use the Teensy boards,

  • Download and install the supported versions of the Arduino IDE under the /Applications folder, as described in the section Install the Arduino Platform . Other releases don't work.

  • Download the Teensyduino plug-in.

  • Open the .dmg file.

  • Proceed with the installation.

  • Launch Arduino.

  • Define the path of the sketchbook folder in the menu Arduino > Preferences > Sketchbook location.

  • Avoid spaces in the name and path of the sketchbook folder.

Starting release 1.21 of the Teensyduino IDE, support for the Teensy boards is now a plug-in for the Arduino 1.8 IDE.

The Teensyduino installation adds Teensy-specific libraries into the Arduino IDE. It manages two architectures: 8-bit ATmega and 32-bit ARM.

Connect the Board

The Teensy boards are under the menu Tools > Board. For the Teensy 3.2, just select the Teensy 3.1 board.

As the IDE for Teensy boards modifies the Arduino IDE, you may want to have a separate modified Arduino IDE for the Teensy boards.

Change the name to Teensyduino and the icon to avoid any confusion with the standard Arduino.

embedXcode identifies the IDE automatically among Arduino and Teensyduino.

embedXcode+ allows to locate the Arduino or Teensyduino IDE in another folder.

Install the TinyCircuits Platform

This section requires embedXcode+. The installation for the TinyCircuits platform is performed with the Boards Manager and the Library Manager on the Arduino 1.6.5 IDE.

Install the TinyScreen+ Board

If you plan to use the TinyScreen+ board,

  • Download and install the supported versions of the Arduino IDE under the /Applications folder, as described in the section Install the Arduino Platform .

  • Launch it.

  • Define the path of the sketchbook folder in the menu Arduino > Preferences > Sketchbook location.

  • Avoid spaces in the name and path of the sketchbook folder.

  • Follow the procedure Install Additional Boards on Arduino .

  • Call the menu Tools > Boards > Boards Manager.

  • Check the Arduino SAMD platform for Arduino Zero and Arduino MKR1000 is already installed. Otherwise, install the Arduino SAMD platform.

  • Check the TinyCircuits SAMD platform is listed.

  • Select the board and click on Install.

If the TinyCircuits SAMD platform isn’t listed on the Boards Manager,

  • Open the Preferences.

  • Add the following URL on a separate line, as described in section Add URLs for New Boards .

http://files.tinycircuits.com/ArduinoBoards/package_tinycircuits_index.json
  • Return to the Boards Manager.

  • Select the board and click on Install.

For more information on the installation of the TinyScreen+ board,

Install the TinyScreen Library

To install the TinyScreen Library,

  • Launch the Arduino IDE.

  • Call the menu Sketch > Include Library > Manage Libraries...

A new window lists all the libraries, already installed or available for download.

  • Search the list for the TinyScreen library.

  • Click on Install.

The IDE downloads and installs the library.

  • Click on OK.

If the library doesn't show up even after adding the URL with the JSON file,

  • Download the TinyScreen Library .

  • Unzip the file.

  • Copy the resulting folder as a user's library on the Libraries sub-folder of the sketchbook folder.

The user's libraries are stored on the Libraries or libraries sub-folder under the sketchbook folder.

For more information on the installation of the TinyScreen library,

Install the Udoo Neo Platform

This section requires embedXcode+.

The installation for the Udoo Neo platform is performed with the Boards Manager on the Arduino 1.6.5 IDE.

Install the Udoo Neo Platform

If you plan to use the Udoo Neo board,

If you don't plan to use the Udoo Neo board with the Arduino IDE, there is no need for installing release 1.6.5 of the Arduino IDE as embedXcode doesn't require it.

Release 1.6.5 is required to use the Arduino IDE, as more recent releases of the Arduino IDE don't support the Udoo Neo platform.

  • Launch it.

  • Define the path of the sketchbook folder in the menu Arduino > Preferences > Sketchbook location.

  • Avoid spaces in the name and path of the sketchbook folder.

  • Follow the procedure Install Additional Boards on Arduino .

  • Call the Boards Manager and check the Udoo Neo platform is listed.

If the Udoo Neo platform isn’t listed on the Boards Manager,

  • Open the Preferences.

  • Add the following URL on a separate line, as described in section Add URLs for New Boards .

https://udooboard.github.io/arduino-board-package/package_udoo_index.json

Select the boards and click on Install.

For more information on the installation of the Udoo Neo board,

Connect the Board

The Udoo Neo board is under the menu Tools > Board.

No serial console is displayed after the upload of the sketch to the board. Use either a SSH or a VNC connection to display the output redirected to /dev/ttyMCC. For more information,

Install Another Platform

For other boards, the procedures are the same. For boards based on a Processing-based Wiring-derived Arduino-like IDE,

  • Download and install the corresponding Processing-based Wiring-derived Arduino-like IDE under the /Applications folder.

  • Launch it.

  • Define the path of the sketchbook.

For boards installed as a package with the Boards Manager of the Arduino IDE,

Install Utilities for Other AVR MCUs

This section requires embedXcode+.

Some boards aren’t defined by Arduino, so you need to add them. A list is supplied by the the avrduderc.txt file located in the embedXcode folder and needs to be copied into the user’s home folder.

  • Open the Terminal and launch the following commands
$ cd ~/Documents/embedXcode
$ cp avrduderc.txt ~/.avrduderc

For more information,

Similarly, if you plan to use other MCUs from AVR, you may need to install a more recent version of AVRDUDE, as Arduino still uses release 5.11 dated August 2011.

To install a more recent release of AVRDUDE,

  • Download AVRDUDE release 6.0.1 or later,

  • Unzip the compressed file,

  • Open the Terminal and launch the following commands, with path_to_avrdude being the path to avrdude-6.0.1, ~/Downloads/avrdude-6.0.1 in the example.

$ cd ~/Downloads/avrdude-6.0.1
$ ./configure; make; make install

To know where avrdude has been installed,

  • Launch the command
$ which avrdude

/usr/local/bin/avrdude

To check the release and know where the configuration file is located,

  • Launch the command
$ /usr/local/bin/avrdude -v
avrdude: Version 6.0.1, compiled on Nov 2 2013 at 17:50:28
Copyright (c) 2000-2005 Brian Dean, http://www.bdmicro.com/
Copyright (c) 2007-2009 Joerg Wunsch
System wide configuration file is "/usr/local/etc/avrdude.conf"

The configuration file for AVRDUDE is located at /usr/local/etc/avrdude.conf.

Install Drivers for Programmers and Debuggers

This section requires embedXcode+.

Some boards require specific drivers.

Install the FTDI Driver

If you plan to use a programmer like the 5V FTDI basic from Sparkfun , the USB ASP from Protostack , the USB tinyISP from Adafruit , the USB Spoke POV dongle or similar, you may need to install the FTDI drivers,

Rebooting the Mac is compulsory, otherwise the drivers aren’t taken into account.

For more information,

When a board with a FTDI is connected to the Mac with a serial console open on a Terminal window, always use the following procedure to close the session.

  • Use the Ctrl+A Ctrl+K key sequence.

  • Then press Y to confirm.

Otherwise, the USB port is no longer listed. This is a bug on Mac OS X 10.11.4.

Install the OpenOCD Driver

The Open On-Chip Debugger, or OpenOCD, provides tools for programming and debugging MCUs. It runs with other software like GDB from the GCC tool-chain.

It requires a hardware programmer-debugger. The installation of OpenOCD can be done using either Homebrew or MacPorts. It is recommended to use Homebrew.

OpenOCD requires the previous installation of libusb , a library that provides an easy access to USB devices. To install OpenOCD with Homebrew,

  • Open a Terminal window.

  • Launch the following command to install Homebrew.

$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
  • Launch the following command to install libusb.
$ brew install libusb

Launch the following command to install openOCD.

$ brew install openocd

Some boards require a specific installation of OpenOCD. This is done by specifying options during installation.

$ brew install openocd --enable_ft2232_libftdi --enable-stlink

Those options can be combined with those for other boards.

For more information,

  • Please refer to the OpenOCD documentation  and to the websites of the respective manufacturers of the boards.

Install Utilities for Segger Debugger

This section requires embedXcode+.

The Segger J-Link is a very popular JTAG and SWD emulator for ARM cores. It comes with a full software suite.

Segger provides a comprehensive software suite that works better than OpenOCD with the Segger J-Link programmer-debugger.

If you plan to use the Segger J-Link debugger,

By default, the software is located at /Applications/SEGGER.

If the IDEs are located in another folder, as described at section Set the Folder for Standard IDEs ,

  • Move the /Applications/SEGGER folder onto the specific folder for IDEs.

In this example, the specific folder is called IDE and the full path is /Applications/IDE/SEGGER.

It is important to keep the JLink symbolic link to the current version, here JLink_V60g. If the symbolic link has been lost,

  • Open a Terminal window.

  • Enter the commands to select the folder and create the symbolic link.

$ cd /Applications/IDE/SEGGER
$ sudo ln -s JLink_V60g/ JLink

For more information about the Segger J-Link emulator,

Install the Segger Ozone Graphical Debugger

Segger provides Ozone, a free graphical debugger, to use with the Segger J-Link.

If you plan to use the Segger Ozone graphical debugger,

  • Proceed first with the installation of the latest release of the Segger J-Link debugger as per the [Install the Segger J-Link Software Suite]!h(apter1/Section4/#install-the-segger-j-link-software-suite] procedure.

  • Ensure the release of J-Link is 6.12i or later.

  • Download the latest release of the Ozone J-Link Debugger for Mac OS X , version 2.22o or later.

  • Install the software.

By default, the software is located at /Applications/SEGGER/Ozone.

If the IDEs are located in another folder, as described at section Set the Folder for Standard IDEs ,

  • Move the /Applications/SEGGER/Ozone folder onto the Segger sub-folder of the specific folder for IDEs, In the example, the specific folder is called IDE and the full path is /Applications/IDE/SEGGER/Ozone.