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
Little Robot Friends Maple Particle 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. 

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 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 Little Robot Friends Platform

This section requires embedXcode+.

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 the Little Robot Friends board.

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 an 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 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 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
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
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