Upload to specific boards

Some sections in this chapter require embedXcode+.

The following boards and programmers require specific procedures for uploading the sketch:

The next section details the procedure to Restore initial mode on specific boards .

Upload to Adafruit Trinket and Pro Trinket boards

This section requires the embedXcode+ edition.

The Trinket and Pro Trinket boards from Adafruit require a specific procedure.

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

Proceed as follow:

  • Plug the Adafruit board in.

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

  • Wait for the message window:

  • Press the RESET button on the board.

  • The red LED starts flashing.

  • Click on OK.

By default, those boards don't feature a serial-to-USB communication.

For more information,

Upload to Feather M0 and M4 boards

For the Adafruit M0 and M4 boards, Adafruit offers two options to upload the executable to the boards.

The first option is the standard upload procedure through serial over USB.

The second option, called UF2 for USB Flashing Format, turns the board into a mass storage device. Programming is done with a simple drag-and-drop or copy of the executable onto the mass storage device.

Upload to Feather M0 and M4 boards using standard USB

Before uploading using the standard USB procedure,

  • Check the LED on the board is green.

  • Otherwise, double-press the Reset button on the board to enter bootloader mode.

For more information,

Upload to Feather M0 and M4 boards using UF2

For the Adafruit M0 and M4 boards, this drag-and-drop procedure requires a specific format. The executable needs to be converted into a .uf2 file. The utlity for the conversion is provided by the Adafruit nRF52 boards package.

To install the Adafruit nRF52 boards package,

Before uploading,

  • Check a volume called FEATHERBOOT is shown on the desktop.

  • Otherwise, double-press the Reset button on the board to activate it.

For more information on the Feather M0,

For more information on the Feather M4,

Upload to Arduino Yún using Ethernet or WiFi

This section requires the embedXcode+ edition.

Although the Arduino Yún 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 Arduino Yún needs to be known by the Mac.

  • Check that the router has discovered the Arduino Yún and note the IP address.

  • Check the Mac knows the RSA key fingerprint of the Arduino Yún.

  • Also, keep the password of the Arduino Yún at hand.

  • Disconnect all the SPI devices from the ICSP connector as the WiFi module uses SPI to communicate with the Arduino.

It is recommended to proceed with a test of the over-the-air upload with the Arduino IDE, through Ethernet or WiFi, to be sure that the Mac recognises the board and knows the RSA key fingerprint of the Arduino Yún.

Check the SSH connection

To check the router has discovered the Arduino Yún,

  • Open a Terminal window.

  • Type the command arp -a to list all know hosts.

The Arduino Yún board should appear as arduino.local but often has a different name, as host-001.

The default address should be 192.168.240.1 but may differ according to the settings of the network.

To check the Mac knows the RSA key fingerprint of the board,

  • Open a Terminal window and type the command ssh root@ followed by the IP address of the board, 192.168.240.1 in the example.
$ ssh root@192.168.240.1

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

The authenticity of host '192.168.240.1 (192.168.240.1)' 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.

Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added '192.168.240.1' (RSA) to the list of known hosts.

root@192.168.240.1's password:
  • Finally, type in the password to make the connection.
BusyBox v1.19.4 (2013-08-07 16:16:02 CEST) built-in shell (ash)
Enter 'help' for a list of built-in commands.

root@Arduino:~#

The Terminal window s displays the splash screen of the Arduino Yún.

BusyBox v1.19.4 (2014-04-10 11:08:41 CEST) built-in shell (ash)
Enter 'help' for a list of built-in commands.

  _______                     ________        __
 |       |.-----.-----.-----.|  |  |  |.----.|  |_
 |   -   ||  _  |  -__|     ||  |  |  ||   _||   _|
 |_______||   __|_____|__|__||________||__|  |____|
          |__| W I R E L E S S   F R E E D O M
 ----------------------------------------------------

Enter IP address and Password

During the first compilation, embedXcode looks for the Arduino Yún board and checks the password.

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

  • Enter the IP address of the Arduino Yún board.

  • Click on OK to validate or Cancel to cancel.

A message box asks for the password.

  • Enter the password of the Arduino Yún 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 Arduino Yún (WiFi Ethernet) 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.

Warning

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 Arduino Yún installation and over-the-air upload,

Upload the sketch

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

  • Connect the Arduino Yún board to the network through WiFi or Ethernet.

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

Upload a website to the Arduino Yún

embedXcode can upload a website automatically to the Arduino Yún.

There are three requirements. First, upload is done through Ethernet or WiFi connection. Second, the project has a folder named www with at least a file named index.html. Third, the Arduino Yún has a microSD-card inserted on the slot.

During upload, the content of the www folder is copied to the microSD-card automatically and made available with a browser at the address /sd/TemperatureWebPanel.

Once upload is completed, embedXcode open the browser at the website main page.

The TemperatureWebPanel project contains a www folder.

For more information,

Upload to Arduino M0 Pro

The Arduino M0 Pro has two USB connectors: one called native and another called programmer. Both can be used to upload a sketch.

However, the programming port offers a better stability and is required for debugging.

Programming port left, native USB port right

When using the programming port, a windows asks for confirmation.

  • Click on Allow to proceed.

Upload to Arduino Zero

The Arduino Zero has two USB connectors: one called native and another called programmer. Both can be used to upload a sketch.

However, the programming port offers a better stability and is required for debugging.

Programming port left, native USB port right

When using the programming port, a windows asks for confirmation.

  • Click on Allow to proceed.

Upload to chipKIT boards using a programmer-debugger

This section requires the embedXcode+ edition.

To upload to a chipKIT boards with the optional chipKIT PGM programmer-debugger.

Proceed as follow:

  • Plug the chipKIT programmer into the board.

  • Plug the cable into the USB port.

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

embedXcode builds and links the project, and then opens one Terminal window.

The Terminal window hosts the programmer-debugger. The tool first connects to the board, then uploads the executable, and finally runs the project.

To quit the session,

  • Type quit and press the Enter key. 
>quit

Halting...
Target Halted
  • Always quit the Terminal window.

Using the programmer-debugger erases the boot-loader. To upload again without the programmer-debugger,

Upload to LaunchPad C2000

The LaunchPad C2000 boards use a new upload procedure with Energia 17.

Prepare LaunchPad C2000 F28027

Proceed as follow:

  • Unplug the LaunchPad C2000 F28027 board.

  • For the LaunchPad C2000 F28027, configure S4 SERIAL on.

  • Configure S1 BOOT on-on-on or up-up-up.

  • Plug the LaunchPad C2000 board in.

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

The project is uploaded into flash.

Prepare LaunchPad C2000 F28069

Proceed as follow:

  • Unplug the LaunchPad C2000 F28069 board.

  • Remove jumper J6 and place jumper J7.

Configure S1 BOOT on-on-on or up-up-up.

  • Plug the LaunchPad C2000 board in.

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

The project is uploaded into flash.

Prepare LaunchPad C2000 F28069

Proceed as follow:

  • Unplug the LaunchPad C2000 F28069 board.

  • Configure S1 BOOT on-on-on or up-up-up.

  • Plug the LaunchPad C2000 board in.

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

The project is uploaded into flash.

Upload to LaunchPad CC3200 WiFi

The LaunchPad CC3200 WiFi board requires a specific hardware configuration.

For a normal upload, proceed as follow:

  • Unplug the LaunchPad CC3200 WiFi board..

  • Remove the JTAG J8 jumper and the SPO2 jumper.

  • Place a wire from JTAG J8 (emulator side) to SOP 2 (CC3200) side.

Uploading requires TCK connected to SOP 2

  • Plug the LaunchPad CC3200 WiFi board.

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

The project is uploaded into flash and is kept even if the power is disconnected.

For a debugging session, proceed as follow:

  • Unplug the LaunchPad CC3200 WiFi board..

  • Remove the wire from JTAG J8 (emulator side) to SOP 2 (CC3200) side.

  • Place the JTAG J8 jumper.

  • Place the SOP 2 jumper.

Debugging requires TCK and SOP 2 jumpers placed on

  • Plug the LaunchPad CC3200 WiFi board.

  • Launch the target Debug.

The project is uploaded into SRAM and is lost in case the power is disconnected.

Upload to LaunchPad CC3220 WiFi

The LaunchPad CC3220S and CC3220SF WiFi boards require a specific hardware and software configuration.

For a normal upload, proceed as follow:

  • Open Uniflash and select the CC3220SF-LAUNCHXL from the list of devices.

  • Click Start Image Creator.

  • Click New Project

  • Give the project a name, for example CC3220 Development.

  • Select CC3220SF from the Device Type drop-down list.

  • Set Device Mode to Develop.

  • Click Create Project.

  • Click the Connect button.

  • Under General > Settings, make sure Image mode is set to Development.

  • Click the Generate Image button, pictured with a flame. Sometimes, this button is not active. In that case, select the Create Image button instead.

  • Click Program Image (Create & Program).

The LaunchPad CC3220 should be ready for uploading a sketch to. Keep in mind the sketch resides in RAM and is lost if the power is disconnected.

  • Once done, launch Energia and program the CC3220SF with the blinky sketch.

If upload fails, perform the same operation with Uniflash but on Windows.

For more information,

Upload to LaunchPad MSP430F5529 and MSP430FR5969

The LaunchPad MSP430F5529 requires Energia release 10 and the LaunchPad MSP430FR5969 the release 12.

Some versions of the LaunchPads MSP430F5529 and MSP430FR5969 may require an update of the firmware.

To do so,

  • Download Energia release 14 or later.

  • Launch Energia.

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

  • Select the board LaunchPad with MSP430F5529 or LaunchPad with MSP430FR5969

  • Upload the sketch to the LaunchPad.

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.

Upload to Microsoft Azure IoT DevKit

This section requires the embedXcode+ edition.

The Microsoft Azure IoT DevKit offers different options for uploading the sketch to the board.

Upload to Microsoft Azure IoT DevKit Through USB Port

Proceed as follow:

  • Connect the Microsoft Azure IoT DevKit board to the computer.

  • Select the Microsoft IoT DevKit (USB) board.

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

Upload to Microsoft Azure IoT DevKit Through Mass Storage Device

Proceed as follow:

  • Connect the Microsoft Azure IoT DevKit module to the computer.

A new volume called AZ3166 appears.

  • Select the Microsoft IoT DevKit (MSD) board.

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

During the upload process, a warning notification may appear.

  • Click on Close to close the notification.

Upload to NodeMCU 1.0 board

The NodeMCU 1.0 board requires a specific procedure.

Proceed as follow:

Plug the NodeMCU 1.0 board in.

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

  • Wait for the message window:

  • Press the RESET and FLASH buttons on the board.

  • Release the RESET button first.

  • Release then the FLASH button.

  • Click on OK.

For more information,

Upload to ESP8266 NodeMCU boards using WiFi

This section requires the embedXcode+ edition.

Although the ESP8266 and NodeMCU boards require no specific procedure for an over-the-air upload, the WiFi network needs to be installed and configured successfully before any upload.

Over-the-air upload requires that a sketch based on the ArduinoOTA library has been installed previously and is currently running. Otherwise,

  • Build and upload the BasicOTA example using the Arduino IDE.

Before uploading, please

  • Check that the router has discovered the NoteMCU board and note the IP address.

  • It is recommended to proceed with a test of the WiFi connection. Either try pinging the board on the Terminal, or uploading a sketch from the Arduino IDE.

Check the Running Sketch

The over-the-air process is managed by the sketch itself, based on the ArduinoOTA library.

If the ArduinoOTA object isn't running,

  • Build the BasicOTA example.

  • Upload using an USB connection as per section Upload to NodeMCU 1.0 board.

Note

The sketch requires twice its size.

Check the WiFi Connection

To identify the IP addresses of the ESP8266 or NodeMCU board,

  • Open a Terminal window.

  • Run the following command.

$ arp -a
esp_a1b2c3 (192.168.1.209) at 12:ef:34:a1:b2:c3 on en0 ifscope [ethernet]

The address 192.168.1.209 gives access to the board.

  • Test the board is connected with ping.
$ ping 192.168.1.209

Enter IP address

During the first compilation, embedXcode looks for the ESP8266 or NodeMCU board.

If the ESP8266 or NodeMCU board isn't found on the network, a window asks for the IP address.

  • Enter the IP address of the ESP8266 or NodeMCU board.

  • Click on OK to validate or Cancel to cancel.

When validated, the IP address is saved on the board configuration file NodeMCU 0.9 ESP-12 (WiFi) or NodeMCU 1.0 ESP-12E (WiFi) in the project.

The IP address is 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.

Password isn't implemented.

Upload Wiring / Arduino sketch

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

Connect the ESP8266 or NodeMCU board to the network through WiFi.

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

A window may ask for allowing incoming network connections.

  • Click on Allow to proceed.

Note

The sketch requires twice its size.

For more information about the installation and use of the over-the-air upload,

Upload to panStamp boards

This section requires the embedXcode+ edition.

Upload to the panStamp Quantum boards is done with the USB programmer.

Upload to panStamp Quantum board

The panStamp Quantum board requires a specific upload procedure.

Upload to Teensy boards

The Teensy boards based on an ARM MCU require a specific procedure. The procedure applies to the Teensy 3.0, 3.1, 3.2, 3.5 and 3.6 boards.

Proceed as follow:

  • Disconnect all the SPI devices as programming is done through the SPI pins.

  • Plug the Teensy board.

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

During the first upload, a new window asks you to press on the button on the board to start the process.

  • Press the button on the Teensy board.

A final message confirms the end of the operation.

The following uploads no longer require this manual operation.

Manage error messages

In case the wrong board has been selected, the uploader displays an error message.

  • Click OK, select the correct board following the procedure Change the board and start again.

The uploader may display another error message.

  • Check and edit the code accordingly.

  • Click OK and start again.

Use raw HID

The Teensy boards offer a raw HID mode, with a specific driver for Serial over HID.

To configure the project for raw HID,

  • Open the main Makefile.

  • Set the variable TEENSY_USB to the desired USB_RAWHID type.

# Teensy USB options (default)
# ----------------------------------
# !!! Help: http://bit.ly/2BmH31o
TEENSY_USB = USB_RAWHID
  • Ensure NO_SERIAL_CONSOLE is set to true to prevent the serial console from starting automatically.
# Serial console for Fast target
# ----------------------------------
# For Fast target, open serial console, false or true
# !!! Help: http://bit.ly/2AfyA37
#
NO_SERIAL_CONSOLE = true

Once the program has been uploaded to the Teensy board,

  • Open a first Terminal window.

  • Launch the teensy_gateway utility with /Applications/Teensyduino.app/Contents/Java/hardware/tools/teensy_gateway, assuming the Teensyduino application in under the /Applications folder.

  • Open a second Terminal window.

  • Launch telnet 127.0.0.1 28541, or nc 127.0.0.1 28541 if telnet isn't available,

  • Open a third Terminal window.

  • Launch the rawhid_test utility with /Users/ReiVilo/Downloads/rawhid_test, assuming the rawhid_test application in under the /Users/ReiVilo/Downloads/ folder.

To stop,

  • Press Ctrl+C on the Terminal window where teensy_gateway is running.

For more information on raw HID,

Upload to TinyScreen+ board

This section requires the embedXcode+ edition.

If the TinyScreen+ board is unresponsive, the serial port isn't listed or the upload fails, the board may require to be reset.

To reset the TinyScreen+ Board,

  • Power the board through either an USB cable of a battery.

  • Turn the board off.

Then,

  • Press the button closest to the USB port and maintain the button pressed.

  • While maintaining the button pressed, turn the switch on to power the board.

  • Release the button .

For more information on resetting the TinyScreen+ board,

Upload to Udoo Neo board

This section requires the embedXcode+ edition.

Compiled sketches can be uploaded to the Udoo Neo board through an USB connection or using WiFi.

Upload through USB connection

To upload a compiled sketch through USB connection,

  • Plug the Udoo Neo USB cable.

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

Upload using WiFi

The procedure is the same except the IP address has changed.

  • Be sure the Udoo Neo board is connected to the WiFi network.

  • Edit the Udoo Neo (M4) board configuration file and change the IP address for the new one. 

BOARD_PORT = 192.168.7.2

  • Check your board is online.

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

Open a Serial Console

By default, no serial console is opened. The Serial port form the Cortex-M4 MCU is connected to the /dev/ttyMCC on the Cortex-A9 MPU.

To display the serial console, 

$ ssh udooer@192.169.1.23
$ ssh udooer@udoo.local

In this example, the IP address of the board is 192.169.1.23 and its name udoo.

  • Launch the following command 
$ cat /dev/ttyMCC