Step 2: Run Setup Tool

Use the setup tool to flash the latest firmware on the Intel® Edison development board via a convenient wizard. The setup tool also lets you enable SSH and Wi-Fi* connectivity to your board, as described in the following steps.

Terminology 101

  • Firmware is the operating system of embedded microcontrollers. The default firmware on the Intel® Edison board is a version of Linux* built using the Yocto Project*.
  • Flashing is the process of overwriting the firmware on the board's memory, much like applying system updates on your computer.

Do you have a different OS?
Go to the setup tool step for Windows* 64-bit, Windows* 32-bit, or Linux*.

Are you using Android Things*?
Android Things* (formerly called Brillo*) is an alternative operating system from Google* based on Android that can run on the Intel® Edison board instead of the default Linux* OS built using the Yocto Project*. Go to the System Image Downloads page to get Intel® Edison image for Android Things*.

Download the Latest Yocto* Poky Image

The Flash Tool searches for the Yocto* Poky image which is now replaced with a patched version. Prior to using the Flash Firmware option in the setup tool, you first need to store the latest Yocto* Poky image files on your computer. Go to the Downloads page for Intel® Edison at, and download the Latest Yocto* Poky Image. Extract the files and note the path of the image directory.

Download and Run the Setup Tool

  1. Get the latest setup tool for Mac OS X* from listed under the Installers heading.

  2. Double-click the downloaded TAR file to extract the setup tool application.

  3. Double-click the extracted APP file to launch the setup tool.

  4. Follow the setup tool on-screen instructions, clicking Next where needed. On the Set up options page, click Flash Firmware.
    Note: The installation requires administrative rights. When prompted, enter the password for your computer user account.

    Running the setup tool

  5. Select the image to flash onto your board:
    • Select Use existing image located at. Browse and select the image you previously stored in your working directory.
  6. Click Next. When requested by the setup tool, plug in your board to your computer using the device mode cable.

    Photographic diagram for setting the microswitch for device mode
    On the Arduino* expansion board: The microswitch is toggled down towards the two micro USB ports. A USB cable with a micro-B type connector can now be plugged into the top micro USB port, and the other end plugged into your computer.

    Device mode for mini breakout board
    On the mini breakout board: Plug in a USB cable with a micro-B type connector, and plug the other end into your computer.

    Is the setup tool not detecting your board?
    A step-by-step troubleshooting guide can be found in the Troubleshooting and Tips section.

  7. The setup tool will attempt to flash your board. The entire flashing process may take up to 10 minutes. Once finished, continue to set a password and enable SSH for the board in the steps below.

    Due to many factors (although mainly related to USB drivers), sometimes the setup tool cannot flash your board.

    Intel® Edison board did not update warning message

    If you get an error message about an unsuccessful image update while using the setup tool, use the manual process for flashing your board in the Troubleshooting and Tips section.

Set a Password and Enable SSH

You must enable SSH on the Wi-Fi* interface of the Intel® Edison board in order to wirelessly program your board. Setting a device password on an Intel® Edison board will enable SSH.

  1. On the Set up options page, click Enable Security.

  2. You can set a custom name for your Intel® Edison board. A unique device name will help in identifying your board if there are multiple boards nearby, like at a hackathon or workshop.

    Type a name for your board in the field, then click Set name. Once you see the confirmation message, click Next.

  3. Type a password for your board, then click Set password. Once you see the confirmation message message, click Next.

Connect the board to your Wi-Fi Network

  1. On the Set up options page, click Connect Wi-Fi. Wait up to one minute as your computer scans for available Wi-Fi networks.

  2. From the Detected networks drop-down list, select your network.

  3. From the Security drop-down list, select the network's security type.

  4. Provide your login and password information, then connect to your Wi-Fi network.

Connecting to Wi-Fi

Once you are finished with the setup tool, you can close it.

The setup tool is not just for initial setup.
If you want to re-flash or update the firmware on your Intel® Edison board in the future, change the device name or password, or connect your board to Wi-Fi, you can re-run the setup tool.

Keep Going

Your Intel® Edison board should now be up-to-date with the latest firmware. Start communicating with your board; continue to Step 3: Choose your IDE.

For more complete information about compiler optimizations, see our Optimization Notice.