Troubleshooting and Tips

Running into issues with any of the steps in this Get Started with the Intel® Edison Development Board on Windows* 64-bit guide?

Do you have a different OS?
Refer to Troubleshooting & Tips for Windows* 32-bit, Mac* OS X*, or Linux*.

  1. Scan the topics on this page for common issues, solutions, and tips.

  2. Search for additional issues in Intel® Edison Board Platform Support.

  3. Search the Support Community for the Intel® Edison board. You can also post your questions to the community forum.

Common issues, solutions, and tips

Working directly with your board with serial communication

Once you begin developing on the Intel® Edison board, you'll likely want to communicate directly with your board using Linux commands. To do so, set up a serial communication with your board. For steps, see Setting up a serial terminal on a system with Windows*. This section covers tips and troubleshooting for connecting to your board.

Wi-Fi* and connectivity

This section contains tips for checking and establishing Wi-Fi* connectivity with your board in a serial communication session. For steps to set up a session, see Setting up a serial terminal on a system with Windows*.


What external power supply should be used with the Arduino* expansion board?

Use a direct current (DC) power supply rated as follows:
  • 7-15 V DC
  • At least 1500mA
  • Center/inner pin is positive pole

For more details on using external power, refer to the Connecting Cables appendix page for the Arduino* expansion board.


I don't have access to a DC power supply.

In many cases, you can use the device mode micro USB cable to power your board.

Side-by-side example of connecting to the device mode port on the Arduino* expansion board and the mini breakout board

With the Arduino* expansion board (shown on the left), data transfer occurs over the top micro USB connector. With the mini breakout board (right), it is the bottom micro USB connector.

However, if you are using only the device mode micro USB cable for power and you are experiencing unexpected behavior, your computer's USB port may not be reliably supplying power to the board.

Things you can try:
  • If you are connecting the board to a laptop, plug in your laptop’s AC adapter.
  • Use a powered USB hub.

The setup tool is not detecting my board.

Follow these debugging steps in the order shown:

  1. Is the Intel® Edison compute module securely seated on the breakout board?

    A loosely connected Intel® Edison compute module will produce unexpected behaviors. Press firmly down on the Intel® Edison compute module just below the words “What will you make?” to ensure the compute module is connected to your board.

    Examples of Intel® Edison compute module seated improperly and properly

  2. Is your Intel® Edison board powered on?

    A green LED indicator should light up and stay lit when the device mode and/or DC power supply cables are connected. View details for the Arduino* expansion board or the mini breakout board.

  3. Do you have the device cable connected?

    Connect a micro-B type USB cable to the device mode micro USB port of your Intel® Edison breakout board and the other end to your computer.

    Side-by-side example of connecting to the device mode port on the Arduino* expansion board and the mini breakout board

    With the Arduino* expansion board (shown on the left), the data transfer occurs over the top micro USB connector. With the mini breakout board (right), it is the bottom micro USB connector.

  4. Is your board in device mode?

    If you are working with an Arduino* expansion board, the microswitch should be toggled down towards the two micro USB ports.

    Photographic diagram for setting the microswitch for device mode

    If you are working with a mini breakout board, it has a single USB 2.0 interface. The mini breakout board will automatically switch into device mode when a USB cable with a micro-B connector is used.

    Example of micro-B USB cable used for device mode

  5. Add additional power.

    If you are using only the device mode micro USB cable for power and you are experiencing unexpected behavior, your computer's USB port may not be reliably supplying power to the board.

    Things you can try:
    • If you are connecting the board to a laptop, plug in your laptop’s AC adapter.
    • Use a powered USB hub.
    • Use an external DC power supply. Refer to the Connecting Cables appendix page for the Arduino* expansion board or mini breakout board for more details.
  6. Try a different micro USB cable and/or computer USB port.

    It is not uncommon for unexpected behaviors to occur due to bad or incompatible USB cables or USB ports. For example:

    • Some micro USB cables are meant for charging only and cannot communicate data between the Intel® Edison board and a computer.
    • If the Intel® Edison board is plugged into a USB 3.0 port, you may experience some issues with it not being powered correctly. In that case, use a DC power supply for your board, or try putting a USB 2.0 hub (preferably powered) in between your computer and your Intel® Edison board.
  7. Look for conflicting USB drivers.

    Do you have the USB Device Driver Development Kit (a kit for making USB device drivers) installed? This driver conflicts with the Intel® Edison USB driver. Try this:

    • Rename the USB Device Driver Development Kit driver (Windows/System32/drivers/libusbk.dll) to something else, like libusbk.dll.temp.
    • Restart your computer.
    • Try again with the Intel® Edison board.
    • When you wish to use the USB Device Driver kit, re-name libusbk.dll.temp back to libusbk.dll.

I don't know the password for my board.

Use the setup tool to set a new password for your board, as described in Step 2: Run the Setup Tool for Windows* 64-bit.

You can also flash your board again, which resets your board to a blank password. However, you'll need to set a new password to re-enable SSH for your board.


The setup tool cannot flash my board.

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


How do I update/flash the Intel® Edison board firmware manually?

Running the setup tool is the preferred method for flashing the firmware onto an Intel® Edison board, however there are times where you must manually copy files and run scripts in order to flash your board.

This process uses dfu-util, an open source program that implements the USB DFU (USB Device Firmware Upgrade) protocol.

  1. Download the pre-built Yocto* complete image from software.intel.com/iot/hardware/edison/downloads listed under the "Intel® Edison Board Firmware Software Release" heading.

  2. Right-click on the downloaded ZIP file and select Extract.

    The firmware image file contents will be extracted into a new folder named edison-iotdk-image-[release].

  3. Download the latest copy of dfu-util.exe and libusb-1.0.dll from the dfu-util site.

    Direct file links:
    At the time of writing, 0.8 was the latest binary release. Download dfu-util.exe and libusb-1.0.dll.

  4. Place dfu-util.exe and libusb-1.0.dll in the same folder you extracted the firmware image file to (for example, edison-iotdk-image-[release]).

  5. Open a new Windows* Command Prompt window.

    Quick launch tip: Click Windows* Start menu, type cmd, and then press Enter.

  6. Use the command line to navigate to the folder you extracted the firmware image to. For example:

    cd C:\Users\[User]\Downloads\edison-iotdk-image-[release]

  7. Run the flashall script, and then follow the onscreen prompts.

    flashall.bat

  8. When requested by the script, plug in your board to your computer using the device mode cable.

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

  9. The flashall script can take up to 5 minutes to complete the flashing process.

    Do not power off or unplug your board during the flashing process
    Unless requested by the script, interrupting the flashing process by unplugging the power cable may leave your board in a non-working state.

Once flashing is complete, you will need to set your device password again. Use the setup tool or manually set the password by setting up a serial connection to your board and entering the configure_edison --wifi command in PuTTY.


My board stopped responding.

If your board stops responding and you cannot get your Intel® Edison board to reboot, you may need to re-flash the firmware on the board to reset it back to a working state.

To flash your board, follow the steps in Step 2: Run Setup Tool.


How do I open Windows* Device Manager?

Windows* 7:

  1. Open Windows* Start menu.
  2. Start typing device manager in the search field.
  3. Select Device Manager under Control Panel.

Device Manager in the Windows 7 Start Menu

Windows* 8 and 10:

  1. Go into Windows* Desktop mode.
  2. Right-click on the Windows* Start menu button.
  3. Select Device Manager.

Device Manager in the Windows 8 Start Menu


Which COM port number should be used for making UART (serial) connections?

Use the COM port number shown next to USB Serial Port in your Windows* Device Manager.

USB Serial Port entry in Device Manager

In the example, it is COM10 but your computer will have unique COM port number assignments and will likely be different from the screenshot.

Do not use the COM number for Intel Edison USB Composite Device or Intel Edison Virtual Com Port. Those ports are for other features and not for serial communication.


There is no USB Serial Port device listed in Device Manager.

Follow these debugging steps in the order shown:

  1. Is the Intel® Edison compute module securely seated on the breakout board?

    A loosely connected Intel® Edison compute module will produce unexpected behaviors. Press firmly down on the Intel® Edison compute module just below the words “What will you make?” to ensure the compute module is connected to your board.

    Example of Intel® Edison compute module seated improperly and properly.

  2. Is your Intel® Edison board powered on?

    A green LED indicator should light up and stay lit when the device mode and/or DC power supply cables are connected. View details for the Arduino* expansion board or the mini breakout board.

  3. Do you have the UART/serial cable connected?

    Connect a micro-B type USB cable to the UART/serial micro USB port of your Intel® Edison breakout board and the other end to your computer.

    Side-by-side example of connecting to the UART/serial port on the Arduino* expansion board and the mini breakout board

    With the Arduino* expansion board (shown on the left), serial communication occurs over the bottom micro USB connector. With the mini breakout board (right), it is the top micro USB connector.

  4. Do you have the serial drivers installed?

    A serial connection cannot be detected without FTDI USB serial drivers. Go to Step 2: Run Setup Tool to install the required USB drivers.


Which COM port should be used with the Arduino* IDE?

Use the COM port number shown next to Intel Edison Virtual Com Port in your Windows* Device Manager. A step-by-step guide is outlined in Blinking an LED with the Arduino* IDE.

Intel Edison Virtual COM port entry in Device Manager


There is no Intel Edison Virtual Com Port device listed in Device Manager.

Follow these debugging steps in the order shown:

  1. Do you have the Intel® Edison board drivers installed?

    If you do not see drivers for Intel Edison USB Composite Device and Intel Edison Virtual Com Port in Windows* Device Manager, the Intel® Edison board drivers were not installed.

    Intel® Edison board COM port entries in Device Manager highlighted

    These USB drivers are installed with the setup tool. If you haven't already, go to Step 2: Run Setup Tool to install all the required USB drivers.

  2. Restart your computer.

    If you have already completed Step 2: Run Setup Tool, try restarting your computer to ensure driver changes take effect.

  3. The remaining debugging steps are the same as The setup tool is not detecting my board. Continue there.


Toggle Wi-Fi* on and off using ifconfig.

Having problems connecting to a Wi-Fi* network using configure_edison --wifi? Try running the following commands in a serial communication session with your board:

ifconfig usb0 down
ifconfig wlan0 down
ifconfig usb0 up
ifconfig wlan0 up

Then run the Wi-Fi* configuration wizard again:

configure_edison --wifi


Use the Wi-Fi* command line interface (wpa_cli) to connect to a network.

Are you having problems connecting to a Wi-Fi* network using configure_edison --wifi? Try using the Wi-Fi* command line interface (wpa_cli) to set up Wi-Fi*. Read about it in Connecting to a Wireless Network via Linux* for Intel® Edison Board.


What is the IP address of my board?

After running configure_edison --wifi and successfully connecting to a Wi-Fi* network, you will be shown your IP address in the Done message.

Done message after using the --wifi option

To get the current Wi-Fi* IP address of your board without going through the setup process again, run the following command:

configure_edison --showWiFiIP

The IP address for the Wi-Fi* interface will be outputted to the shell.

Using the --showWiFiIP option

Alternatively, enter the command:

ifconfig

Then look for the wlan0 IP address show as inet addr.

Example of an IP address using ifconfig


How do I know if my Intel® Edison board is online and accessible?

To verify that your Intel® Edison board is online, you can try:

  1. From the Intel® Edison board's shell, ping a publicly accessible domain such as google.com and wait for a response.

    ping google.com

    (Use the Ctrl+C keyboard command to exit the ping process.)

You can try a few things to verify that your Intel® Edison board is accessible:

  1. View the built-in status web page running on your Intel® Edison board by visiting the IP address in a web browser on another computer (or mobile phone) on the same Wi-Fi* network.

    Example of message displayed when successfully connected to a network

    For example, using the example above, visit http://10.0.1.11 or http://edison.local in a web browser, where the IP address was 10.0.1.11 and the device name was "edison").

  2. Using Command Prompt or Terminal, ping your board from another computer on the same network using the IP address obtained above.

    ping 10.0.1.11

    (Use the Ctrl+C keyboard command to exit the ping process.)

Note: Many large companies have strict Internet security policies and restrict direct IP address access of computers and devices that are on the same internal network. Check with your system administrator if you have issues.
For more complete information about compiler optimizations, see our Optimization Notice.