Skip to content

Use Discontinued Wiring / Arduino Frameworks

Some boards and platforms running on the Wiring / Arduino framework are deprecated and no longer supported by their manufacturers.

The legacy boards are still available on release 8.0, and a warning message is displayed during build. 

Release 8.0 of embedXcode is adapted accordingly. Release 9.0 no longer features those boards.

Select Your Platform

. . . . . .
ArduCAM Digistump Glowdeck Intel LightBlue Little Robot Friends
Maple Particle RedBear Robotis Wiring

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.

Upload to ArduCAM CC3200 Board

This section requires embedXcode+.

 The ArduCAM CC3200 board requires a specific procedure.

Proceed as follow:

  • Place the two shunts on FT-RX and FT-TX.

  • Remove the camera from the connector.

  • Plug the ArduCAM CC3200 board in.

  • Launch any of the targets All, Upload or Fast.

  • Plug the camera back into the connector.

Install the Digistump Platform

This section requires embedXcode+.

 The Digistump platform offers different boards. The Digispark is based on the ATtiny85 and requires the installation of a plug-in. The DigiX is fully compatible with the Arduino Due. The Oak is based on the popular ESP8266.

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

Development for the Digistump platform is put on hold.

Install the Digistump Platform

If you plan to use the Digistump 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 Digistump boards are listed. 

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

  • Open the Preferences and add the following URL on a separate line, as described in section Add URLs for New Boards .
http://digistump.com/package_digistump_index.json

Install the Oak Board

If you plan to use the Oak board, additional procedures are required.

Please note many users have failed to get the Digistump Oak board configured properly.

  • Connect the Board

The Digistump boards are under the menu Tools > Board. 

Upload to Digistump Boards

This section requires embedXcode+.

 The Digistump boards require specific procedures.

Upload to Digispark board

To upload to a Digispark board, proceed as follow:

  • Unplug the Digispark board.

  • Launch any of the targets All, Upload or Fast.

  • Wait for the message window:

  • Plug the cable from the Digispark board into the USB port.

  • Wait for the final message.

You can also monitor the upload with the Log Navigator.

  • Open the Log Navigator.

  • Wait for the message Plug in device now...
Running Digispark Uploader...
Plug in device now...
  • Plug the cable from the Digispark board into the USB port.
> Press CTRL+C to terminate the program.
> Device is found!

The uploader connects, erases and then writes the sketch on the Digispark board.

connecting: 20% complete
erasing: 80% complete
> Starting to upload ...
writing: 80% complete
Wait for the final message.
Writing: 100% complete
>> Micronucleus done. Thank you!

For more information,

Upload to Oak

This section requires embedXcode+.

To upload to an Oak board, proceed as follow:

  • Power the Oak board on.

For more information,

Install the Glowdeck Platform

This section requires embedXcode+.

If you plan to use the Glowdeck board,

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

  • Download the Glowdeck plug-in.

  • Launch the Glowdeck Setup application. 

  • 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.

The Glowdeck setup install the Glowdeck-specific boards and libraries into the Arduino IDE. It manages the 32-bit ARM architecture.

In order to differentiate this version of Arduino from other releases of the Arduino IDE,

  • Change the name to Arduino or Glowduino to avoid any confusion with other releases of the Arduino IDE.

embedXcode identifies the IDE automatically among Arduino and Glowduino.

Upload to Glowdeck Board

This section requires embedXcode+.

Compiled sketches can be uploaded to the Glowdeck board using three methods: over-the-air with Bluetooth, through a USB connection or using the Segger J-Link emulator.

Upload Through Bluetooth

The upload with Bluetooth is the recommended method for the board. Proceed as follow:

  • Check Bluetooth is enabled on the Mac.

  • Check the Glowdeck board is on upload mode. All the LEDs should be blue.

Otherwise, power off the board, press on the front button then power on the board while keeping the front button pressed on.

  • Launch any of the targets All, Upload or Fast.

A new window opens and scans for the Glowdeck boards. 

If there is one single Glowdeck board, the upload starts automatically. The blue LEDs glow.

If there are more than one Glowdek board, 

  • Select the board on the drop-down-list.

  • Press Update.

The upload starts. The blue LEDs glow. 

Once upload is completed, the board resets and runs the sketch.

For more information,

  • Please refer to the page on the Glowdeck website.

Upload Through USB

The upload through USB requires a configuration. The uploader displays a reminder if the configuration hasn't been done.

Glowdeck Firmware Loader for macOS
* Glowdeck One-Time MSD Configuration Setup *
Please follow these steps to enable direct firmware uploads (via USB) on macOS.
WARNING: Failure to follow these steps exactly as shown can lead to system instability. Proceed carefully.
1. From a Terminal prompt, type (without the quotations): "sudo vifs"
2. Press Enter - type your Mac password if prompted - and a file editor will open.
3. Press the "i" key to activate insert text mode.
4. Use the keyboard arrows to navigate the cursor to the bottom of the file/screen.
5. Add the following 2 lines, exactly as they appear below, to the bottom/end of the file:
LABEL=GLOWDECK_V1 none msdos rw,noauto 0,0
LABEL=GLOWDECK_V2 none msdos rw,noauto 0,0
6. Press the "Esc" key.
7. Type the following characters (without the quotations) ":wq"
8. Press Enter. The one-time setup procedure is now complete.
9. If connected, disconnect and then reconnect Glowdeck from your computer's USB port.
10. Upload your firmware (you will never need to follow these steps again).
  • Proceed accordingly.

For more information,

  • Please refer to the page at the Glowdeck website.

To upload,

  • Check the Glowdeck board is on upload mode.

All the LEDs should be blue.

  • Otherwise, power off the board, press on the front button then power on the board while keeping the front button pressed on.

  • Connect the Glowdeck board to the Mac.

  • Launch any of the targets All, Upload or Fast.

An error message is displayed. 

  • Just ignore it and click on OK.

A Terminal window opens and asks for the user's password.

Glowdeck Firmware Loader for macOS

Scanning...
Password:
Found GLOWDECK_V1...
Mounting Glowdeck...
Uploading firmware to Glowdeck...
Builds/embeddedcomputing.bin: No such file or directory
Finishing upload...
Disk /Volumes/Glowdeck ejected
Please leave Glowdeck attached while macOS is given time to clear the cache...
..........
Success - dismiss the warning and restart Glowdeck to load firmware.
  • Type the user's password and press Enter.

When the upload is completed, power-cycle the board.

  • Close the Terminal window.

To upload using the Segger J-Link emulator,

  • Always power the Glowdeck first.

  • Connect the Glowdeck board to the Segger J-Link emulator with an adapter cable.

  • Connect the Segger J-Link emulator to the Mac with an USB cable.

  • Press the RESET button on the board.

  • Launch any of the targets All, Upload or Fast.

Install the Intel Platform

This section requires embedXcode+.

The Intel platform includes the Curie, Galileo, Galileo Gen 2 and Edison boards. Those boards support the Wiring / Arduino framework. The installation for the Wiring / Arduino framework is performed with the Boards Manager on the Arduino 1.6 IDE.

embedXcode+ also supports the Yocto SDK and the MCU SDK for the Edison board.

Info

Intel has announced it will stop supporting all its boards, including the Galileo, Edison and Curie boards, starting mid-December 2017.

Install the Intel Platform

If you plan to use the Intel Galileo and Edison 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 two Intel platforms are listed. 

  • Select the boards and click on Install.

For more information on the installation process,

  • Please refer to the Getting Started page on the Intel website. + Connect and Disconnect the Board

The Intel boards appears under the menu Tools > Board. 

Contrary to other boards, the Intel Galileo is not powered through USB.

  • First, always connect the power supply to power the board.

  • Then, check the Power LED is on.

  • Finally, connect the board to the computer through USB.

Power the Intel Galileo

Powering the board directly through USB may damage the board.

Also, there are two versions of the Intel Galileo board, each one with different power requirements, alas incompatible.

For more information,

Power the Intel Edison Breakout Board

For the Intel Edison Breakout Board, powering the board through USB is possible. 

Intel Edison on mini breakout board

Connector ➀ is for power, OTG and uploading Arduino sketches over USB.

Connector ➁ is for serial over USB.

  • Always connect power first to the jack barrel or to connector ➀.

However, an external direct current power supply is recommended. For more information,

Power the Intel Edison Arduino Board

The Intel Edison Arduino Board features a separate USB for OTG. 

Intel Edison on Arduino expansion board

Connector ➀ is for power, Ethernet over USB and uploading Arduino sketches over USB. Move the switch in device mode position, close to connector ➀.

Connector ➁ is for serial over USB.

Connector ➂ provides OTG. Move the switch in host mode position, close to connector ➂.

  • Always connect power first to the jack barrel or to connector ➀.

Plug and Unplug the Intel Edison Board

When plugged-in, the Intel board appears as a new volume called EDISON. 

In that case, it is recommended to unmount the volume before disconnecting the board, otherwise the following message pops-up.

Install the Intel Edison for Yocto SDK

embedXcode+ also supports the Yocto SDK for the Edison board.

Install the Intel Edison for MCU SDK

embedXcode+ also supports the MCU SDK for the Edison board.

Upload to Intel Edison Using WiFi or Ethernet over USB

This section requires embedXcode+.

Although the Intel Edison board requires no specific procedure, the Ethernet or WiFi network needs to be installed and configured successfully before any upload, and the RSA key fingerprint of the Intel Edison needs to be known by the Mac.

Before uploading, please

  • Check that the router has discovered the Intel Edison and note the IP address.

  • Check the Mac knows the RSA key fingerprint of the Intel Edison.

  • Also, keep the password of the Intel Edison at hand.

It is recommended to proceed with a test of the over-the-air connection through Ethernet or WiFi. Either try establishing a SSH connection on the Terminal, or uploading a sketch from the Arduino IDE, to be sure that the Mac recognises the board and knows the RSA key fingerprint of the Intel Edison board.

Check the SSH Connection

The cu.usbmodem port gives a limited access and the cu.usbserial port provides full access but requires to plug-in the second USB cable.

$ ls /dev/cu.*
/dev/cu.usbmodem1413
/dev/cu.usbserial-A123B456

For full access, use instead either WiFi or Ethernet over USB. For more information on how to install WiFi and Ethernet over USB,

To identify the IP addresses of the Intel Edison board,

  • Open a Terminal window.

  • Run the following command.

$ arp -a
host-001 (192.168.1.223) at aa:bb:cc:dd:ee:ff on en0 ifscope [ethernet]
edison (192.168.2.15) at 11:22:33:44:55:66 on en8 ifscope [ethernet]

The three addresses, 192.168.1.223, 192.168.2.15 and edison.local give access to the board with ssh.

  • Connect to the board using ssh.
$ ssh root@192.168.1.223
$ ssh root@edison.local
$ ssh root@192.168.2.15

If the board is unknown, a message asks for confirmation of the RSA key fingerprint.

The authenticity of host '192.168.1.2333 (192.168.1.233)' can't be established.
RSA key fingerprint is 00:11:22:33:44:55:66:77:88:99:aa:bb:cc:dd:ee:ff.
Are you sure you want to continue connecting (yes/no)? yes
  • Enter yes and validate.

A message confirms the RSA key fingerprint has been added to the list of know hosts.

Enter IP Address and Password

During the first compilation, embedXcode looks for the Intel Edison board and checks the password.

If the Intel Edison board isn't found on the network, a window asks for the IP address.

  • Enter the IP address of the Intel Edison board.

  • Click on OK to validate or Cancel to cancel.

A message box asks for the password.

  • Enter the password of the Intel Edison board.

  • Click on OK to validate or Cancel to cancel.

When validated, the IP address and the password are saved on the board configuration file Intel Edison (WiFi) in the project.

The IP address and the password are only asked once.

  • To erase the IP address, just delete the whole line.

  • To edit the IP address, just change the left part after SSH_ADDRESS = on the corresponding line.

Please note the password is not encrypted.

  • To erase the password, just delete the whole line.

  • To edit the password, just change the left part after SSH_PASSWORD = on the corresponding line.

For more information about the Intel Edison installation and over-the-air upload,

Upload Wiring / Arduino Sketch

 Once the checks have been successfully performed, proceed as follow:

  • Connect the Intel Edison board to the network through WiFi or Ethernet over USB.

  • Launch any of the targets All, Upload or Fast.

Upload Native Yocto Application

Once the checks have been successfully performed, proceed as follow:

  • Connect the Intel Edison board to the network through WiFi or Ethernet over USB.

  • Launch any of the targets All, Upload or Fast.

Upload MCU Application

Once the checks have been successfully performed, proceed as follow:

  • Connect the Intel Edison board to the network through WiFi or Ethernet over USB.

  • Launch any of the targets All, Upload or Fast.

For applications developed with the MCU SDK and API, the process checks the availability of the configuration tools on the Edison board and, if necessary, uploads them.

Similarly, if a configuration command has been defined in the main Makefile as described at the section Define the Settings for Edison MCU, the process executes it remotely.

Finally, the process reboots the board to launch the MCU application.

Otherwise, the manual procedure requires to:

  • Open a Terminal window and connect to the Edison board.

  • Launch the utility scripts among init_DIG.sh, init_i2c8.sh, init_mcu_PWM.sh, read_DIG.sh, set_DIG.sh and init_UART1.sh with the relevant parameters.

  • For example, to define pin 7 as an output, execute

# cd ./utilitiesMCU
# sh init_DIG.sh -o 7 -d output
  • Finally, reboot the Intel Edison board with the following command to launch the application:
# reboot

Find the Location of the Wiring / Arduino Sketch

Each kind of sketch goes to a specific location.

For sketches developed with the Wiring / Arduino framework, the sketch is renamed sketch.elf and uploaded under the /sketch folder to obtain /sketch/sketch.elf.

Please note the boot process loads and runs this sketch automatically.

  • To terminate the sketch.elf sketch, run the following command on the Intel Edison board:
# killall -q sketch.elf
  • To run again the sketch.elf sketch, run the following command on the Intel Edison board:
# /sketch/sketch.elf

Find the Location of the Yocto Native Application

For native applications running on Yocto, a sub-folder with the name of the project is created under /home/root/Projects to obtain /home/root/Projects/embed1 if embed1 is the name of the project.

The application is renamed embeddedcomputing and uploaded under /home/root/Projects/embed1 to obtain /home/root/Projects/embed1/embeddedcomputing.

  • To terminate the embeddedcomputing application, run the following command on the Intel Edison board:
# killall -q embeddedcomputing
  • To run again the embeddedcomputing application, run the following command on the Intel Edison board:
# /home/root/Projects/embed1/embeddedcomputing

Find the Location of the MCU Application

 For applications developed with the MCU SDK and API, the application is renamed intel_mcu.bin and uploaded under the /lib/firmware folder to obtain /lib/firmware/intel_mcu.bin.

Please note that, in order to load and run the intel_mcu.bin application, the Edison board needs to be rebooted. This is normally done automatically during the upload process.

To reboot the Edison board manually,

  • Run the following command on the Intel Edison board:
# reboot

To terminate the intel_mcu.bin application,

  • Run the following command on the Intel Edison board:
# rm /lib/firmware/intel_mcu.bin
# reboot

Eject Before Disconnecting the Board

Before disconnecting the Intel Edison board, it is recommended to unmount the volume, otherwise the following message pops-up.

It is also recommend to power off the board before disconnecting it.

  • Run the following command on the Intel Edison board:
# poweroff

Install the LightBlue Platform

This section requires embedXcode+.

Warning

In June 2018, Punch Through Design announced it was discontinuing the Bean boards.

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.

Upload to LightBlue Bean using Bluetooth

This section requires embedXcode+.

The LightBlue Bean offers two options for uploading. The LightBlue Bean Loader requires a manual intervention while the Bean Command Line Loader is fully automatic.

The latter option is enabled automatically when embedXcode+ detects Bean Command Line Loader has been installed and is available.

Upload with the LightBlue Bean Loader

To upload a sketch to a LightBlue Bean board using Bluetooth:

  • Check Bluetooth 4.0 or BLE is turned on.

  • Launch any of the targets All, Upload or Fast.

The new application LightBlue Bean Loader shows the boards available.

  • Right-click on the line of the board and select Connect.

Once the board is connected, right-click again and select Program Sketch.

A final message confirms the end of the operation.

The application LightBlue Bean Loader provides other services.

For more information,

  • Please refer to Upload to Bean with Bean Loader for OS X page at the Punch Through Design website.

Upload with the Bean Command Line Loader

If embedXcode+ detects the Bean Command Line Loader is available, it opts for this option automatically

During the first compilation with a Fast or All target, embedXcode+ scans for LightBlue boards. This process can take up to one minute.

---- Scanning for LightBlue boards ---
myBean+
---- LightBlue boards scanned ---

In case more than one LightBlue boards are detected, a dialogue box asks to choose among the first two.

The name of the LightBlue board is saved on the board configuration file LightBlue Bean (Bluetooth) or LightBlue Bean+ (Bluetooth) in the project.

BEAN_NAME = myBean+

Once the upload is completed, embedXcode+ opens a Terminal window with the serial console of the LightBlue board.

For more information,

Install the Little Robot Friends Platform

This section requires embedXcode+.

Install the Little Robot Friends First Generation

The Little Robot Friends platform consists on two boards, the robot and the dock. The installation of the Little Robot Friends platform is performed with the Boards Manager on the Arduino 1.6 IDE.

With the launch of the second generation of boards, the first generation is no longer supported by Little Robot Friends.

Install the Little Robot Friends Platform

If you plan to use the Little Robot Friends 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 Little Robot Friends platform is listed. 

  • If the Little Robot Friends platform isn’t listed on the Boards Manager, open the Preferences and add the following URL on a separate line, as described in section Add URLs for New Boards .

http://learn.littlerobotfriends.com/downloads/package_littlerobotfriends_index.json
http://learn.littlerobotfriends.com/downloads/package_littlerobotfriends-beta_index.json
  • Select the board and click on Install.

For more information on the installation of the Arduino IDE,

  • Please refer to the Getting Started page on the Little Robot Friends website.

Install the Little Robot Friends 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 LittleRobotFriends 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,

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 Little Robot Friends library for Arduino,

  • Please refer to the Installation page on the Little Robot Friends website.

Connect the Board

Once installation is completed,

  • Check that the Tools > Boards menu on the Arduino IDE mentions the Little Robot Friends board.

Install the Little Robot Friends Second Generation

The second generation features one board based on the SAMD MCU. The installation is performed manually and requires the Arduino 1.8 IDE.

  • Download the LRF Arduino Library 2.2.0 from the Downloads page of the Little Robot Friends website.

  • Unzip the file.

  • Create the folder ~/Documents/Projets/Arduino/hardware/lrf_arduino/samd.

  • Copy the resulting folder under ~/Documents/Projets/Arduino/hardware/lrf_arduino/samd to obtain ~/Documents/Projets/Arduino/hardware/lrf_arduino/samd/samd.

  • Rename the last samd sub-folder to 2.2.0 to obtain ~/Documents/Projets/Arduino/hardware/lrf_arduino/samd/2.2.0.

Install the Maple Platform

This section requires embedXcode+.

The MapleIDE is no longer maintained. Use instead the STM32duino boards package compatible with the Arduino 1.6.5 Boards Manager.

If you plan to use the Maple boards,

  • Download and install MapleIDE 0.0.12 under the /Applications folder.

  • Launch it. 

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

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

  • Install Java 6.

The MapleIDE 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 MapleIDE.

Install the Uploader Utility

Uploading a compiled sketch to the Maple board requires the utility PySerial.

To install PySerial, 

  • Download pyserial 2.6 .

  • Unzip it, for example in ~/Downloads/pyserial-2.6.

  • Open a Terminal window and launch the following commands, with ~/Downloads/pyserial-2.6 being the path to pyserial-2.6 in the example.

$ cd ~/Downloads/pyserial-2.6
$ sudo su
$ python setup.py install

Define Integer Standard Types

Maple 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/MapleIDE.app/Contents/Resources/Java/hardware/leaflabs/cores/maple/libmaple_types.h file.

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

#include <stdint.h>

As an alternative,

  • Open the /Applications/MapleIDE.app/Contents/Resources/Java/hardware/leaflabs/cores/maple/libmaple_types.h file.

  • And 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

The Maple environment misses two important libraries: strings.h and stream.h.

Please note support for Maple is put on hold until a new version of the IDE or new boards are released.

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

The STM32duino platform provides a viable alternative solution for the Maple boards.

Install the Particle Platform

This section requires embedXcode+.

Unlike the other platforms, the Particle Core board doesn’t come with an Arduino-like IDE with everything included.

Particle strongly promotes its online IDE . However, the framework is also available for download. Unfortunately, it is still in beta and doesn't support the Photon.

Installing the Particle platform requires two steps: the first for the framework and the tool-chain, the second for the utilities.

Particle was previously Spark.

Please note the new Photon board is not supported. As a consequence, development for the Particule platform is put on hold.

Install the Tools for Particle

The installation of the tools for Particle is now included in the embedXcode installation package process. 

If the Particle framework is selected, the installer checks whether the tool-chain and the SDK are already installed. If needed, it downloads and installs them.

The Particle framework weights 80 MB, with 76 MB for the GCC tool-chain 76 MB and 4 MB for the SDK. For more details on the installation process,

  • Please refer to the section Install the Template. The installation can be performed manually, as described in the following section.

  • Check the result of the installation

Once the installation has been completed, the folder ~/Library/embedXcode contains the following files. 

Install the Utilities

There are two utilities, one in charge of the management of the Particle cloud, namely the Particle Command Line Interface for the Cloud package, and another for the upload of the binaries to the board.

To install the Particle Command Line Interface,

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 Particle Command Line Interface for the Cloud package.

$ sudo npm install -g particle-cli

For more information on the Particle Command Line Interface,

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*

Configure the Particle Core

To configure the Particle Core,

  • Open a Terminal window.

  • Enter the following command to create your account.

$ particle cloud login
  • Follow the instructions and answer the questions.
Could I please have an email address? 
and a password? *
Got an access token! 12345678901234567890
logged in! { '0': '12345678901234567890' }
Using the setting "access_token" instead 
Using the setting "username" instead 
  • Enter the following command to set your Particle Core.
$ particle cloud login
  • Follow the instructions and answer the questions.
========================================
Setup your account

You are already logged in as 
Logged in! 
Saving access token: 12345678901234567890

----------------------
Finding your core id

Your core id is: aabbccddeeffaabbccddeeff
  • Keep the core id: it is required to upload the sketch using the Particle Cloud.

  • Follow the instructions and answer the questions.

========================================
Setup your wifi

SSID:
Security 0=unsecured, 1=WEP, 2=WPA, 3=WPA2:
Wifi Password:
Attempting to configure wifi on /dev/cu.usbmodem1421

Thanks! Wait about 7 seconds while I save those credentials...

Serial said: Awesome. Now we'll connect!

If you see a pulsing cyan light, your Spark Core
has connected to the Cloud and is ready to go!

If your LED flashes red or you encounter any other problems,
visit https://www.spark.io/support to debug.

 Particle <3 you!

Done! Your core should now restart.

Please wait until your core is breathing cyan and then press ENTER
  • Follow the instructions and answer the questions.
========================================
Claiming your core

Please wait until your core is breathing cyan and then press ENTER

Successfully claimed core aabbccddeeffaabbccddeeff
  • Follow the instructions and answer the questions.
========================================
Shouting rainbows...

Press ENTER if your core is excitedly shouting rainbows
         ,---. 
,--. ,--.    ,--.  | | 
 \ `.' /,---. ,--,--.| ,---. | .' 
 '. /| .-. :' ,-. || .-. || | 
 | | \ --.\ '-' || | | |`--' 
 `--' `----' `--`--'`--' `--'.--. 
         '--' 
----------------------
Naming your core

What would you like to call your core?
Naming core.
  • Keep the core name: it is required to upload the sketch using the Particle Cloud.

For more information about configuring the Particle Core,

Set the Folder for Particle Projects

The folder where the Particle projects are saved is defined during installation. However, should this folder change, you need to define the new location.

For example, if the Particle projects are located on the ~/Documents/Projects/Particle folder,

  • Open the ~/Documents/embedXcode folder.  

  • Double click on Define path to Particle projects. 

A window asks for the folder where the Particle projects are saved.

  • Select an existing folder or create a new one with New Folder.

  • Click Choose.

A notification confirms the new path.

Upload to Particle Boards

This section requires embedXcode+.

Compiled sketches can be upload to the Particle Core board through an USB connection or using the Particle Cloud.

Upload Through USB Connection

To upload a compiled sketch through USB connection, we need to place the Particle Core in DFU mode.

  • Plug the Particle Core USB cable.

  • Launch any of the targets All, Upload or Fast. 

  • Press and keep the MODE button,

  • Press and release the RESET button,

  • Keep the MODE button pressed on until the LED starts flashing yellow.

  • Release the MODE button.

  • Click on OK to proceed with the upload.

For more information,

Upload Using the Particle Cloud

This section requires embedXcode+.

To upload a compiled sketch using the Particle Cloud,

  • Be sure the Particle Core has been claimed and configured as described in the Install the Particle Platform procedure.

  • Check the Particle Core is connected to the Particle Cloud with the LED breathing cyan.

  • Optionally, open a Terminal window and list the boards available.

$ particle list
  • Check your board is online.
Checking with the cloud...
Retrieving cores... (this might take a few seconds)
mySpark (aabbccddeeffaabbccddeeff) is online
  • Launch any of the targets All, Upload or Fast.

The upload may take a while, with the LED blinking magenta then green, and finally breathing cyan.

For more information,

Follow the Manual Procedure

As an alternative, here is the manual procedure: Open the Finder and go to the ~/Library folder.

To do so,

  • Press Cmd+Shift+G and enter the path ~/Library. 

  • Click on Go.

Alternatively,

  • Press Alt while clicking on the Go menu and select Library. 

On the ~/Library folder,

  • Create a new folder inside and name it embedXcode to obtain ~/Library/embedXcode.

To install the Particle framework, 

  • Open the Particle firmware  GitHub repository.

  • Select the feature/hal branch.

  • Download the ZIP file form the GitHub repository and unzip it under ~/Library/embedXcode/Particle.

  • If needed, rename the new folder to obtain ~/Library/embedXcode/Particle/firmware.

To allow version management,

  • Open TextEdit and create a new text file.

  • Enter the version number, in this case 1.

1
  • Save it as ~/Library/embedXcode/Particle/version.txt.

To define the folder where the Particle projects are stored,

  • Open TextEdit and create a new text file.

  • Add the following line and specify the path to the desired folder, ~/Documents/Particle in this example. sketchbook.path=~/Documents/Particle.

  • Save it as ~/Library/embedXcode/Particle/preferences.txt.

For more information about the installation of the Particle SDK,

Because the Particle firmware is hosted and maintained in a GitHub repository, the code evolves on a regular basis. Unfortunately, there is no official release scheme with version numbers. This may rise issues if new and change code goes untested.

For ease of use and stability, embedXcode relies on the pre-compiled distributions installed by the Tools for Particle package under the Particle/build folder.

However, the embedXcode+ edition can also use the source code under the Particle/firmware folder.

To install the GCC for ARM tool-chain, 

  • Download the GCC for ARM tool-chain  release gcc-arm-none-eabi-4_8-2014q3-20140805-mac.

  • Unzip it into ~/Library/embedXcode.

  • If needed, rename the new folder to ~/Library/embedXcode/gcc-arm-none-eabi-4_8-2014q3.

For more information about the installation of the GCC tool-chain,

Install the RedBear Platform for Wiring / Arduino

This section requires embedXcode+.

Warning

In March 2018, RedBear announced it was acquired by Particle. As a consequence, RedBear will terminate support for its boards on September 2019.

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 with 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.

Upload to RedBear CC3200 Boards

This section requires embedXcode+.

 The RedBear CC3200 boards require a specific upload procedure.

Proceed as follow:

  • Plug the RedBear CC3200 board.

  • Launch any of the targets All, Upload or Fast.

After the upload, a window asks you to press on the button on the board to reset the board.

  • Press the RESET button on the RedBear CC3200 board.

  • Click OK on the message window.

Upload to RedBear Duo Board

This section requires embedXcode+.

The RedBear Duo board offers different options for uploading the sketch to the board.

Upload to RedBear Duo Through Native USB Port

Proceed as follow:

  • Connect the RedBear Duo board to the computer.

  • Select the RedBear Duo (Native USB Port) board.

  • Launch any of the targets All, Upload or Fast.

The serial console uses the Serial port.

Proceed as follow:

  • Place the RedBear Duo board onto the RBLink module.

  • Connect the RedBear RBLink module to the computer.

A new volume called RBLink appears.

  • Select the RedBear Duo (RBLink USB Port) board.

  • Launch any of the targets All, Upload or Fast.

A window may ask for allowing incoming network connections.

  • Click on Allow to proceed.

When disconnecting the RBLink board, a warning notification may appear.

  • Click on Close to close the notification.

A safer way consist on ejecting the volume first.

The serial console uses the Serial1 port.

Upload to RedBear Duo Through WiFi

To upload a compiled sketch using the Particle Cloud,

Be sure the RedBear Duo has been claimed and configured as described in the Install the Particle Platform procedure.

  • Power the RedBear Duo board.

  • Check the RedBear Duo is connected to the Particle Cloud with the LED breathing cyan.

  • Optionally, open a Terminal window and list the boards available.

$ particle list
  • Check your board is online.
Checking with the cloud...
Retrieving cores... (this might take a few seconds)
myDuo (aabbccddeeffaabbccddeeff) is online
  • Select the RedBear Duo (WiFi) board.

  • Launch any of the targets All, Upload or Fast.

The upload may take a while, with the LED blinking magenta then green, and finally breathing cyan.

Restore Arduino Mode on RedBear Boards

The RedBear boards run on the Arduino framework as well as on the mbed framework.

However, once the boards have been used in mbed mode, the boot-loader required by Arduino is no longer available. It needs to be restored.

To do so,

  • Plug the board in.

  • The RedBear board appears as a new volume called MBED.

  • Open the Finder and navigate to the folder ~/Library/Arduino15/packages/RedBearLab/hardware/nRF51822, and select the folder with the most recent version, for example 1.0.0.

  • Open the bootloaders folder.

Arduino sketches can now be uploaded again to the board.

For more information,

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.

For more information on the isntallation procedure,

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

Upload to Robotis OpenCM9.04 Board

This section requires embedXcode+.

The Robotis OpenCM9.04 board requires a specific upload procedure.

Proceed as follow:

  • Plug the Robotis OpenCM9.04 board.

  • Launch any of the targets All, Upload or Fast.

Before the upload, a window asks you to press on the button on the board to start the process.

  • Press the RESET button on the Robotis OpenCM9.04 board.

  • Click OK on the message window.

Install the Wiring Platform

This section requires embedXcode+.

If you plan to use the Wiring boards,

  • Download and install Wiring 1.0 build 0101 under the /Applications folder. 
  • Launch it.

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

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

  • The two following files require to be deleted.

/Applications/Wiring.app/Contents/Resources/Java/cores/AVR8Bit/program.cpp
/Applications/Wiring.app/Contents/Resources/Java/cores/AVR8Bit/makefile

Please note support for Wiring is put on hold until a new version of the IDE or new boards are released.

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

Visit the Official Websites

The following section lists the tools for the boards relying on the Wiring / Arduino framework and for which support has been discontinued.

Digistump
IDE Arduino with Boards Manager
Website http://digistump.com
Download http://digistump.com/wiki/digispark/tutorials/connecting
Wiki http://digistump.com/wiki
Forum http://digistump.com/board/
Glowdeck
IDE Glowdeck plug-in for Arduino
Website http://www.Glowdeck.com
Download http://www.Glowdeck.com
Forum http://www.Glowdeck.com
Support http://www.Glowdeck.com
Intel
IDE Arduino with Boards Manager
Website http://www.intel.com/content/www/us/en/do-it-yourself/maker.html
Galileo http://www.intel.com/support/maker/galileo
Edison http://www.intel.com/support/maker/edison
Arduino for Intel https://communities.intel.com/docs/DOC-22226
Forum http://www.intel.com/content/www/us/en/do-it-yourself/forums-and-support.html
LightBlue
IDE LightBlueIDE
Website http://punchthrough.com/bean
Download http://punchthrough.com/bean/getting-started
Forum http://beantalk.punchthrough.com
Little Robot Friends
IDE Arduino with Boards Manager
Website http://www.littlerobotfriends.com
Download http://learn.littlerobotfriends.com/reference/installation.html
Support http://learn.littlerobotfriends.com/reference/index.html
Maple
IDE MapleIDE
Website http://leaflabs.com/devices/
Download http://leaflabs.com/docs/download.html
Wiki http://wiki.leaflabs.com/index.php
Forum http://forums.leaflabs.com
Particle
IDE https://www.particle.io/build
Website https://www.particle.io
Download https://github.com/spark and https://github.com/particleio
Blog http://blog.particle.io
Documentation http://docs.particle.io
Support http://support.particle.io
Forum https://community.particle.io
Protostack
Website http://www.protostack.com
RedBear
IDE Arduino with Boards Manager
Website http://redbearlab.com
Download https://github.com/redbearlab
Wiki http://redbearlab.com/getting-started-nrf51822 and https://github.com/redbear/Duo/blob/master/docs/getting_started.md
Forum https://redbearlab.zendesk.com/home
Robotis
IDE Robotis OpenCM
Website http://support.robotis.com/en/home.htm
Download http://support.robotis.com/en/software/robotis_opencm.htm
Wiring
IDE Wiring
Website http://wiring.org.co
Download http://wiring.org.co/download/
Wiki http://wiki.wiring.co/wiki/Main_Page
Forum http://forum.wiring.co