c_meyer/pxt-calliope
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
bb69ce3199
pxt-calliope/docs/device/windows-app/troubleshoot.md
Peli de Halleux bb69ce3199
super basic trouble shooting page for windows app (#585) 
* super basic trouble shooting page for windows app

* change path

* Edits for the troubleshooting page

* updated text

* undo windows app changes

* New procedure text for upgrade

* Clarify 'save link'

* Arg, typo!

* bumped pxt-core
2017-12-04 22:26:25 -08:00

3.0 KiB
Raw Blame History

Troubleshooting downloads from the Windows 10 App

Is Windows App not downloading your program properly? Let's try to figure out why!

Step 1: Check your cable

Make sure that your @boardname@ is connected to your computer with a micro USB cable. You should see a MICROBIT drive appear in Windows Explorer when it's connected.

If you can't see the drive:

  • Make sure that the USB cable is working. Does the cable work on another computer? If not, find a different cable to use. Some cables may only provide a power connection and don't actually transfer data.

Is the cable good but you still can't see the MICROBIT drive? Hmm, you might have a problem with your @boardname@. Try the additional steps described in the fault finding page at microbit.org. If this doesn't help, you can create a support ticket to notify the Micro:bit Foundation of the problem.

Step 2: Check your firmware version

It's possible that the firmware version on the @boardname@ needs an update. Let's check:

  1. Go to the MICROBIT drive.
  2. Open the DETAILS.TXT file.

  3. Look for a line in the file that says the version number. It should say Version: ...
    If the version is 0234, you NEED to update the firmware on your @boardname@. Follow the upgrade instructions described next.

Upgrade the firmware

  1. Put your @boardname@ into Maintenence Mode. To do this, unplug the USB cable from the @boardname@ and then re-connect the USB cable while you hold down the reset button. Once you insert the cable, you can release the reset button.
  2. You should now see a MAINTENENCE drive instead of the MICROBIT drive like before. Also, a yellow LED light will stay on next to the reset button.
  3. Go to the firmware upgrade page at microbit.org.
  4. Find the link for the HEX file at the bottom of the page. Right-click on the link and choose Save link as (your browser might say Save target or something similar). In the file dialog, click to select the MAINTENENCE drive. Press Save and the firmware file will copy to the @boardname@.
  5. The yellow LED will flash while the HEX file is copying. When the copy finishes, the LED will go off and the @boardname@ resets. The MAINTENENCE drive now changes back to MICROBIT.
  6. The upgrade is complete! You can open the DETAILS.TXT file to check and see that the firmware version changed to the match the version of the HEX file you copied.

~hint

If you want to know more about connecting the board, Maintenence Mode, and upgrading the firmware, read about it in the DAPLink on micro:bit page.

~