From dbaf4067037ddd76b4daab5568bee61bb7d633f6 Mon Sep 17 00:00:00 2001 From: Peli de Halleux Date: Thu, 15 Sep 2016 08:35:01 -0700 Subject: [PATCH] splitted usb transfer instructions --- docs/device/usb.md | 179 +++-------------------------- docs/device/usb/mac-chrome.md | 71 ++++++++++++ docs/device/usb/mac-firefox.md | 73 ++++++++++++ docs/device/usb/mac-safari.md | 70 +++++++++++ docs/device/usb/troubleshooting.md | 24 ++++ docs/device/usb/windows-chrome.md | 81 +++++++++++++ docs/device/usb/windows-edge.md | 89 ++++++++++++++ docs/device/usb/windows-firefox.md | 86 ++++++++++++++ docs/device/usb/windows-ie.md | 88 ++++++++++++++ docs/static/mb/device/usb-thin.jpg | Bin 0 -> 42017 bytes 10 files changed, 595 insertions(+), 166 deletions(-) create mode 100644 docs/device/usb/mac-chrome.md create mode 100644 docs/device/usb/mac-firefox.md create mode 100644 docs/device/usb/mac-safari.md create mode 100644 docs/device/usb/troubleshooting.md create mode 100644 docs/device/usb/windows-chrome.md create mode 100644 docs/device/usb/windows-edge.md create mode 100644 docs/device/usb/windows-firefox.md create mode 100644 docs/device/usb/windows-ie.md create mode 100644 docs/static/mb/device/usb-thin.jpg diff --git a/docs/device/usb.md b/docs/device/usb.md index ae5d8c89..49b65a39 100644 --- a/docs/device/usb.md +++ b/docs/device/usb.md @@ -1,7 +1,5 @@ # Running programs on your micro:bit -How to compile, transfer, and run a program on your micro:bit. - While you're writing and testing your programs, you'll mostly be [running them in the simulator](/device/simulator), but once you've finished your program you can **compile** it and run it on your micro:bit. @@ -12,173 +10,22 @@ The basic steps are: 2. Click **Download** and download the `.hex` file 3. Copy the `.hex` file from your computer onto the micro:bit drive -## Requirements +![](/static/mb/device/usb-thin.jpg) -You need the following things to transfer and run a script on your micro:bit: +## Instructions -* A-Male to Micro USB cable to connect your computer to your micro:bit. This is - the same cable that is commonly used to connect a smart phone to a computer. -* A PC running Windows 7 or later, or a Mac running OS X 10.6 or later +Pick the instructions for your operating system and browser: -## Step 1: Connect your micro:bit to your computer +* [Windows - Microsoft Edge](/device/usb/windows-edge) +* [Windows - Internet Explorer](/device/usb/windows-ie) +* [Windows - Chrome](/device/usb/windows-chrome) +* [Windows - Firefox](/device/usb/windows-firefox) +* [Mac - Safari](/device/usb/mac-safari) +* [Mac - Chrome](/device/usb/mac-chrome) +* [Mac - Firefox](/device/usb/mac-firefox) -First, connect the micro:bit: +### ~hint -1. Connect the small end of the USB cable to the micro USB port on your micro:bit. - -2. Connect the other end of the USB cable to a USB port on your computer. - -Your computer should recognise your micro:bit as a new drive. On computers -running Windows, `MICROBIT` appears as a drive under Devices and drives. On a Mac -it appears as a new drive under Devices. - -**Windows** - -![](/static/mb/device/usb-windows-device.jpg) - -**Mac** - -![](/static/mb/device/usb-osx-device.png) - -## Step 2: Download your program - -1. Open your project on [codethemicrobit.com](https://codethemicrobit.com) -2. Click **Download** -3. When prompted, choose to **save** the compiled file onto your computer. The - prompt will be different depending on which browser you are using, or - whether you are using a Windows computer or a Mac - -### Windows - -#### Chrome - -Your `.hex` file appears as a download at the bottom of the browser. Click on -the arrow next to the name of the file and then click **Show in folder**. - -![](/static/mb/device/usb-windows-chrome.png) - -Drag and drop the `.hex` file from the download folder onto the `MICROBIT` drive. - -#### Firefox - -A window will appear asking whether you want to save or open the `.hex` file. -Select **Save File** and then select **OK**. - -![](/static/mb/device/usb-windows-firefox-1.png) - -The file will then appear in your downloads in the top right of your browser. -Click the **folder icon** next to the filename to open it in Windows Explorer. - -![](/static/mb/device/usb-windows-firefox-2.jpg) - -Drag and drop the `.hex` file from the download folder onto the `MICROBIT` drive. - -#### Microsoft Edge - -A message will appear at the bottom of the browser asking what you want to do -with the file. Click **Save**: - -![](/static/mb/device/usb-windows-edge-1.png) - -Then click **Open folder** and drag and drop the file from your Downloads to -your `MICROBIT` drive. - -![](/static/mb/device/usb-windows-edge-2.png) - -#### Internet Explorer - -A message will appear at the bottom of the browser asking what you want to do -with the file. Click **Save**: - -![](/static/mb/device/usb-windows-ie11-1.png) - -Then click **Open folder** and drag and drop the file from your Downloads to -your `MICROBIT` drive. - -![](/static/mb/device/usb-windows-ie11-2.png) - -### Mac - -#### Safari - -When you select **Download** in Safari a file called `Unknown` will be -downloaded into your Downloads folder. Open your Downloads folder and drag and -drop the file onto your `MICROBIT` drive, under Devices: - -![](/static/mb/device/usb-osx-dnd.png) - -#### Firefox - -A dialogue box will appear, asking whether you would like to open or save your -hex file. Select **Save file** and click **OK** and the file will then appear in -your downloads in the top right of your browser. Right click on the file and -click on **Show in Finder** and the file will appear in your downloads folder. -Select the file and drag and drop it onto your `MICROBIT` drive. - -![](/static/mb/device/usb-osx-firefox-1.jpg) - -![](/static/mb/device/usb-osx-firefox-2.png) - -#### Chrome - -When you select **Download** in Chrome, the file will appear at the bottom of -the browser. Click on the small arrow and select **Show in Finder**. This will -show the file in your download folder. Drag and drop the file onto your -`MICROBIT` drive. - -![](/static/mb/device/usb-osx-chrome.png) - -## Step 3: Transfer the file to your micro:bit - -* Once you've found the folder containing your `.hex` file, drag and drop it - onto your `MICROBIT` drive -* If you're using Windows, you can use **Send to** as described below -* The LED on the back of your micro:bit flashes during the transfer (which - should only take a few seconds). -* Once transferred, the code will run automatically on your micro:bit. To rerun - your program, press the reset button on the back of your micro:bit. The reset - button automatically runs the newest file on the micro:bit. - -**Send to**: If you're using Windows you use *Send to* in File Explorer: - -- In File Explorer, right-click on the hex file (created in Step 2 above), choose **Send to**, and then **MICROBIT**. - -![](/static/mb/device/usb-windows-sendto.jpg) - -By copying the script onto the `MICROBIT` drive, you have programmed it into the -flash memory on the micro:bit, which means even after you unplug the micro:bit, -your program will still run if the micro:bit is powered by battery. - -If you want to save time, you can use the [micro:bit uploader](/uploader) to -automatically deploy hex files to your micro:bit. It works on Windows and is -compatible with any browser. - -## Troubleshooting - -You can’t drag and drop more than one hex file at once onto your micro:bit. If -you try to drag and drop a second hex file onto your micro:bit before the first -file has finished downloading, then the second file may fail in different ways. - -When the first program has been written to the micro:bit, the drive will -disengage. If you drag and drop a second file at this point it may not find the -drive and the second write will fail. - -The errors may look like this: - -**Windows** - -![](/static/mb/device/usb-windows-copy-file-error.jpg) - -**Mac** - -![](/static/mb/device/usb-osx-copy-file-error.png) - -Or it may appear that there are two hex files on your micro:bit so the micro:bit -won’t be able to run multiple files. To rectify this, unplug your micro:bit and -plug it in again. Make sure that your micro:bit appears as `MICROBIT` and not -`MAINTENANCE`. - -### See also - -[Run code in a browser](/device/simulator) +Transfer not working? See some [troubleshooting tips](/device/usb/troubleshooting). +### ~ diff --git a/docs/device/usb/mac-chrome.md b/docs/device/usb/mac-chrome.md new file mode 100644 index 00000000..e0a8e72f --- /dev/null +++ b/docs/device/usb/mac-chrome.md @@ -0,0 +1,71 @@ +# Running programs on your micro:bit + +How to compile, transfer, and run a program on your micro:bit for **Chrome for Mac**. + +While you're writing and testing your programs, you'll mostly be [running them +in the simulator](/device/simulator), but once you've finished your program you +can **compile** it and run it on your micro:bit. + +The basic steps are: + +1. Connect your micro:bit to your computer via USB +2. Click **Download** and download the `.hex` file +3. Copy the `.hex` file from your computer onto the micro:bit drive + +## Requirements + +You need the following things to transfer and run a script on your micro:bit: + +* A-Male to Micro USB cable to connect your computer to your micro:bit. This is + the same cable that is commonly used to connect a smart phone to a computer. +* A PC running Windows 7 or later, or a Mac running OS X 10.6 or later + +## Step 1: Connect your micro:bit to your computer + +First, connect the micro:bit: + +1. Connect the small end of the USB cable to the micro USB port on your micro:bit. + +2. Connect the other end of the USB cable to a USB port on your computer. + +Your computer should recognise your micro:bit as a new drive. On computers +running Windows, `MICROBIT` appears as a drive under Devices and drives. On a Mac +it appears as a new drive under Devices. + +![](/static/mb/device/usb-osx-device.png) + +## Step 2: Download your program + +1. Open your project on [codethemicrobit.com](https://codethemicrobit.com) +2. Click **Download** +3. When prompted, choose to **save** the compiled file onto your computer. The + prompt will be different depending on which browser you are using, or + whether you are using a Windows computer or a Mac + +When you select **Download** in Chrome, the file will appear at the bottom of +the browser. Click on the small arrow and select **Show in Finder**. This will +show the file in your download folder. Drag and drop the file onto your +`MICROBIT` drive. + +![](/static/mb/device/usb-osx-chrome.png) + +## Step 3: Transfer the file to your micro:bit + +* Once you've found the folder containing your `.hex` file, drag and drop it + onto your `MICROBIT` drive +* The LED on the back of your micro:bit flashes during the transfer (which + should only take a few seconds). +* Once transferred, the code will run automatically on your micro:bit. To rerun + your program, press the reset button on the back of your micro:bit. The reset + button automatically runs the newest file on the micro:bit. + +By copying the script onto the `MICROBIT` drive, you have programmed it into the +flash memory on the micro:bit, which means even after you unplug the micro:bit, +your program will still run if the micro:bit is powered by battery. + + +### ~hint + +Transfer not working? See some [troubleshooting tips](/device/usb/troubleshooting). + +### ~ diff --git a/docs/device/usb/mac-firefox.md b/docs/device/usb/mac-firefox.md new file mode 100644 index 00000000..a32d1427 --- /dev/null +++ b/docs/device/usb/mac-firefox.md @@ -0,0 +1,73 @@ +# Running programs on your micro:bit + +How to compile, transfer, and run a program on your micro:bit on **Firefox for Mac**. + +While you're writing and testing your programs, you'll mostly be [running them +in the simulator](/device/simulator), but once you've finished your program you +can **compile** it and run it on your micro:bit. + +The basic steps are: + +1. Connect your micro:bit to your computer via USB +2. Click **Download** and download the `.hex` file +3. Copy the `.hex` file from your computer onto the micro:bit drive + +## Requirements + +You need the following things to transfer and run a script on your micro:bit: + +* A-Male to Micro USB cable to connect your computer to your micro:bit. This is + the same cable that is commonly used to connect a smart phone to a computer. +* A PC running Windows 7 or later, or a Mac running OS X 10.6 or later + +## Step 1: Connect your micro:bit to your computer + +First, connect the micro:bit: + +1. Connect the small end of the USB cable to the micro USB port on your micro:bit. + +2. Connect the other end of the USB cable to a USB port on your computer. + +Your computer should recognise your micro:bit as a new drive. On computers +running Windows, `MICROBIT` appears as a drive under Devices and drives. On a Mac +it appears as a new drive under Devices. + +![](/static/mb/device/usb-osx-device.png) + +## Step 2: Download your program + +1. Open your project on [codethemicrobit.com](https://codethemicrobit.com) +2. Click **Download** +3. When prompted, choose to **save** the compiled file onto your computer. The + prompt will be different depending on which browser you are using, or + whether you are using a Windows computer or a Mac + +A dialogue box will appear, asking whether you would like to open or save your +hex file. Select **Save file** and click **OK** and the file will then appear in +your downloads in the top right of your browser. Right click on the file and +click on **Show in Finder** and the file will appear in your downloads folder. +Select the file and drag and drop it onto your `MICROBIT` drive. + +![](/static/mb/device/usb-osx-firefox-1.jpg) + +![](/static/mb/device/usb-osx-firefox-2.png) + +## Step 3: Transfer the file to your micro:bit + +* Once you've found the folder containing your `.hex` file, drag and drop it + onto your `MICROBIT` drive +* The LED on the back of your micro:bit flashes during the transfer (which + should only take a few seconds). +* Once transferred, the code will run automatically on your micro:bit. To rerun + your program, press the reset button on the back of your micro:bit. The reset + button automatically runs the newest file on the micro:bit. + +By copying the script onto the `MICROBIT` drive, you have programmed it into the +flash memory on the micro:bit, which means even after you unplug the micro:bit, +your program will still run if the micro:bit is powered by battery. + +### ~hint + +Transfer not working? See some [troubleshooting tips](/device/usb/troubleshooting). + +### ~ diff --git a/docs/device/usb/mac-safari.md b/docs/device/usb/mac-safari.md new file mode 100644 index 00000000..108ac694 --- /dev/null +++ b/docs/device/usb/mac-safari.md @@ -0,0 +1,70 @@ +# Running programs on your micro:bit + +How to compile, transfer, and run a program on your micro:bit for **Safari on Mac**. + +While you're writing and testing your programs, you'll mostly be [running them +in the simulator](/device/simulator), but once you've finished your program you +can **compile** it and run it on your micro:bit. + +The basic steps are: + +1. Connect your micro:bit to your computer via USB +2. Click **Download** and download the `.hex` file +3. Copy the `.hex` file from your computer onto the micro:bit drive + +## Requirements + +You need the following things to transfer and run a script on your micro:bit: + +* A-Male to Micro USB cable to connect your computer to your micro:bit. This is + the same cable that is commonly used to connect a smart phone to a computer. +* A PC running Windows 7 or later, or a Mac running OS X 10.6 or later + +## Step 1: Connect your micro:bit to your computer + +First, connect the micro:bit: + +1. Connect the small end of the USB cable to the micro USB port on your micro:bit. + +2. Connect the other end of the USB cable to a USB port on your computer. + +Your computer should recognise your micro:bit as a new drive. On computers +running Windows, `MICROBIT` appears as a drive under Devices and drives. On a Mac +it appears as a new drive under Devices. + +![](/static/mb/device/usb-osx-device.png) + +## Step 2: Download your program + +1. Open your project on [codethemicrobit.com](https://codethemicrobit.com) +2. Click **Download** +3. When prompted, choose to **save** the compiled file onto your computer. The + prompt will be different depending on which browser you are using, or + whether you are using a Windows computer or a Mac + +When you select **Download** in Safari a file called `Unknown` will be +downloaded into your Downloads folder. Open your Downloads folder and drag and +drop the file onto your `MICROBIT` drive, under Devices: + +![](/static/mb/device/usb-osx-dnd.png) + +## Step 3: Transfer the file to your micro:bit + +* Once you've found the folder containing your `.hex` file, drag and drop it + onto your `MICROBIT` drive +* The LED on the back of your micro:bit flashes during the transfer (which + should only take a few seconds). +* Once transferred, the code will run automatically on your micro:bit. To rerun + your program, press the reset button on the back of your micro:bit. The reset + button automatically runs the newest file on the micro:bit. + +By copying the script onto the `MICROBIT` drive, you have programmed it into the +flash memory on the micro:bit, which means even after you unplug the micro:bit, +your program will still run if the micro:bit is powered by battery. + + +### ~hint + +Transfer not working? See some [troubleshooting tips](/device/usb/troubleshooting). + +### ~ diff --git a/docs/device/usb/troubleshooting.md b/docs/device/usb/troubleshooting.md new file mode 100644 index 00000000..57ae3a8f --- /dev/null +++ b/docs/device/usb/troubleshooting.md @@ -0,0 +1,24 @@ +# Troubleshooting Transfer + +You can’t drag and drop more than one hex file at once onto your micro:bit. If +you try to drag and drop a second hex file onto your micro:bit before the first +file has finished downloading, then the second file may fail in different ways. + +When the first program has been written to the micro:bit, the drive will +disengage. If you drag and drop a second file at this point it may not find the +drive and the second write will fail. + +The errors may look like this: + +**Windows** + +![](/static/mb/device/usb-windows-copy-file-error.jpg) + +**Mac** + +![](/static/mb/device/usb-osx-copy-file-error.png) + +Or it may appear that there are two hex files on your micro:bit so the micro:bit +won’t be able to run multiple files. To rectify this, unplug your micro:bit and +plug it in again. Make sure that your micro:bit appears as `MICROBIT` and not +`MAINTENANCE`. diff --git a/docs/device/usb/windows-chrome.md b/docs/device/usb/windows-chrome.md new file mode 100644 index 00000000..8a6652b7 --- /dev/null +++ b/docs/device/usb/windows-chrome.md @@ -0,0 +1,81 @@ +# Running programs on your micro:bit + +How to compile, transfer, and run a program on your micro:bit on **Chrome for Windows**. + +While you're writing and testing your programs, you'll mostly be [running them +in the simulator](/device/simulator), but once you've finished your program you +can **compile** it and run it on your micro:bit. + +The basic steps are: + +1. Connect your micro:bit to your computer via USB +2. Click **Download** and download the `.hex` file +3. Copy the `.hex` file from your computer onto the micro:bit drive + +### ~hint + +You can use the [micro:bit uploader](/uploader) to automatically deploy ``.hex`` files to your micro:bit! +![](/static/uploader/tooltip.png) + +### ~ + +## Requirements + +You need the following things to transfer and run a script on your micro:bit: + +* A-Male to Micro USB cable to connect your computer to your micro:bit. This is + the same cable that is commonly used to connect a smart phone to a computer. +* A PC running Windows 7 or later, or a Mac running OS X 10.6 or later + +## Step 1: Connect your micro:bit to your computer + +First, connect the micro:bit: + +1. Connect the small end of the USB cable to the micro USB port on your micro:bit. + +2. Connect the other end of the USB cable to a USB port on your computer. + +Your computer should recognise your micro:bit as a new drive. On computers +running Windows, `MICROBIT` appears as a drive under Devices and drives. On a Mac +it appears as a new drive under Devices. + +![](/static/mb/device/usb-windows-device.jpg) + +## Step 2: Download your program + +1. Open your project on [codethemicrobit.com](https://codethemicrobit.com) +2. Click **Download** +3. When prompted, choose to **save** the compiled file onto your computer. The + prompt will be different depending on which browser you are using, or + whether you are using a Windows computer or a Mac + +Your `.hex` file appears as a download at the bottom of the browser. Click on +the arrow next to the name of the file and then click **Show in folder**. + +![](/static/mb/device/usb-windows-chrome.png) + +Drag and drop the `.hex` file from the download folder onto the `MICROBIT` drive. + +## Step 3: Transfer the file to your micro:bit + +* Once you've found the folder containing your `.hex` file, drag and drop it + onto your `MICROBIT` drive +* The LED on the back of your micro:bit flashes during the transfer (which + should only take a few seconds). +* Once transferred, the code will run automatically on your micro:bit. To rerun + your program, press the reset button on the back of your micro:bit. The reset + button automatically runs the newest file on the micro:bit. + +In File Explorer, right-click on the hex file (created in Step 2 above), choose **Send to**, and then **MICROBIT**. + +![](/static/mb/device/usb-windows-sendto.jpg) + +By copying the script onto the `MICROBIT` drive, you have programmed it into the +flash memory on the micro:bit, which means even after you unplug the micro:bit, +your program will still run if the micro:bit is powered by battery. + +### ~hint + +Transfer not working? See some [troubleshooting tips](/device/usb/troubleshooting). + +### ~ diff --git a/docs/device/usb/windows-edge.md b/docs/device/usb/windows-edge.md new file mode 100644 index 00000000..404fd271 --- /dev/null +++ b/docs/device/usb/windows-edge.md @@ -0,0 +1,89 @@ +# Running programs on your micro:bit + +How to compile, transfer, and run a program on your micro:bit on **Microsoft Edge**. + +While you're writing and testing your programs, you'll mostly be [running them +in the simulator](/device/simulator), but once you've finished your program you +can **compile** it and run it on your micro:bit. + +The basic steps are: + +1. Connect your micro:bit to your computer via USB +2. Click **Download** and download the `.hex` file +3. Copy the `.hex` file from your computer onto the micro:bit drive + +### ~hint + +You can use the [micro:bit uploader](/uploader) to automatically deploy ``.hex`` files to your micro:bit! +![](/static/uploader/tooltip.png) + +### ~ + +## Requirements + +You need the following things to transfer and run a script on your micro:bit: + +* A-Male to Micro USB cable to connect your computer to your micro:bit. This is + the same cable that is commonly used to connect a smart phone to a computer. +* A PC running Windows 7 or later, or a Mac running OS X 10.6 or later + +## Step 1: Connect your micro:bit to your computer + +First, connect the micro:bit: + +1. Connect the small end of the USB cable to the micro USB port on your micro:bit. + +2. Connect the other end of the USB cable to a USB port on your computer. + +Your computer should recognise your micro:bit as a new drive. On computers +running Windows, `MICROBIT` appears as a drive under Devices and drives. On a Mac +it appears as a new drive under Devices. + +![](/static/mb/device/usb-windows-device.jpg) + +## Step 2: Download your program + +1. Open your project on [codethemicrobit.com](https://codethemicrobit.com) +2. Click **Download** +3. When prompted, choose to **save** the compiled file onto your computer. The + prompt will be different depending on which browser you are using, or + whether you are using a Windows computer or a Mac + +A message will appear at the bottom of the browser asking what you want to do +with the file. Click **Save**: + +![](/static/mb/device/usb-windows-edge-1.png) + +Then click **Open folder** and drag and drop the file from your Downloads to +your `MICROBIT` drive. + +![](/static/mb/device/usb-windows-edge-2.png) + +## Step 3: Transfer the file to your micro:bit + +* Once you've found the folder containing your `.hex` file, drag and drop it + onto your `MICROBIT` drive +* If you're using Windows, you can use **Send to** as described below +* The LED on the back of your micro:bit flashes during the transfer (which + should only take a few seconds). +* Once transferred, the code will run automatically on your micro:bit. To rerun + your program, press the reset button on the back of your micro:bit. The reset + button automatically runs the newest file on the micro:bit. + +In File Explorer, right-click on the hex file (created in Step 2 above), choose **Send to**, and then **MICROBIT**. + +![](/static/mb/device/usb-windows-sendto.jpg) + +By copying the script onto the `MICROBIT` drive, you have programmed it into the +flash memory on the micro:bit, which means even after you unplug the micro:bit, +your program will still run if the micro:bit is powered by battery. + +If you want to save time, you can use the [micro:bit uploader](/uploader) to +automatically deploy hex files to your micro:bit. It works on Windows and is +compatible with any browser. + +### ~hint + +Transfer not working? See some [troubleshooting tips](/device/usb/troubleshooting). + +### ~ diff --git a/docs/device/usb/windows-firefox.md b/docs/device/usb/windows-firefox.md new file mode 100644 index 00000000..58ac7daa --- /dev/null +++ b/docs/device/usb/windows-firefox.md @@ -0,0 +1,86 @@ +# Running programs on your micro:bit + +How to compile, transfer, and run a program on your micro:bit on **Firefox for Windows**. + +While you're writing and testing your programs, you'll mostly be [running them +in the simulator](/device/simulator), but once you've finished your program you +can **compile** it and run it on your micro:bit. + +The basic steps are: + +1. Connect your micro:bit to your computer via USB +2. Click **Download** and download the `.hex` file +3. Copy the `.hex` file from your computer onto the micro:bit drive + +### ~hint + +You can use the [micro:bit uploader](/uploader) to automatically deploy ``.hex`` files to your micro:bit! +![](/static/uploader/tooltip.png) + +### ~ + +## Requirements + +You need the following things to transfer and run a script on your micro:bit: + +* A-Male to Micro USB cable to connect your computer to your micro:bit. This is + the same cable that is commonly used to connect a smart phone to a computer. +* A PC running Windows 7 or later, or a Mac running OS X 10.6 or later + +## Step 1: Connect your micro:bit to your computer + +First, connect the micro:bit: + +1. Connect the small end of the USB cable to the micro USB port on your micro:bit. + +2. Connect the other end of the USB cable to a USB port on your computer. + +Your computer should recognise your micro:bit as a new drive. On computers +running Windows, `MICROBIT` appears as a drive under Devices and drives. On a Mac +it appears as a new drive under Devices. + +![](/static/mb/device/usb-windows-device.jpg) + +## Step 2: Download your program + +1. Open your project on [codethemicrobit.com](https://codethemicrobit.com) +2. Click **Download** +3. When prompted, choose to **save** the compiled file onto your computer. The + prompt will be different depending on which browser you are using, or + whether you are using a Windows computer or a Mac + +A window will appear asking whether you want to save or open the `.hex` file. +Select **Save File** and then select **OK**. + +![](/static/mb/device/usb-windows-firefox-1.png) + +The file will then appear in your downloads in the top right of your browser. +Click the **folder icon** next to the filename to open it in Windows Explorer. + +![](/static/mb/device/usb-windows-firefox-2.jpg) + +Drag and drop the `.hex` file from the download folder onto the `MICROBIT` drive. +## Step 3: Transfer the file to your micro:bit + +* Once you've found the folder containing your `.hex` file, drag and drop it + onto your `MICROBIT` drive +* If you're using Windows, you can use **Send to** as described below +* The LED on the back of your micro:bit flashes during the transfer (which + should only take a few seconds). +* Once transferred, the code will run automatically on your micro:bit. To rerun + your program, press the reset button on the back of your micro:bit. The reset + button automatically runs the newest file on the micro:bit. + +In File Explorer, right-click on the hex file (created in Step 2 above), choose **Send to**, and then **MICROBIT**. + +![](/static/mb/device/usb-windows-sendto.jpg) + +By copying the script onto the `MICROBIT` drive, you have programmed it into the +flash memory on the micro:bit, which means even after you unplug the micro:bit, +your program will still run if the micro:bit is powered by battery. + +### ~hint + +Transfer not working? See some [troubleshooting tips](/device/usb/troubleshooting). + +### ~ diff --git a/docs/device/usb/windows-ie.md b/docs/device/usb/windows-ie.md new file mode 100644 index 00000000..15072e91 --- /dev/null +++ b/docs/device/usb/windows-ie.md @@ -0,0 +1,88 @@ +# Running programs on your micro:bit + +How to compile, transfer, and run a program on your micro:bit on **Internet Explorer**. + +While you're writing and testing your programs, you'll mostly be [running them +in the simulator](/device/simulator), but once you've finished your program you +can **compile** it and run it on your micro:bit. + +The basic steps are: + +1. Connect your micro:bit to your computer via USB +2. Click **Download** and download the `.hex` file +3. Copy the `.hex` file from your computer onto the micro:bit drive + +### ~hint + +You can use the [micro:bit uploader](/uploader) to automatically deploy ``.hex`` files to your micro:bit! +![](/static/uploader/tooltip.png) + +### ~ + +## Requirements + +You need the following things to transfer and run a script on your micro:bit: + +* A-Male to Micro USB cable to connect your computer to your micro:bit. This is + the same cable that is commonly used to connect a smart phone to a computer. +* A PC running Windows 7 or later, or a Mac running OS X 10.6 or later + +## Step 1: Connect your micro:bit to your computer + +First, connect the micro:bit: + +1. Connect the small end of the USB cable to the micro USB port on your micro:bit. + +2. Connect the other end of the USB cable to a USB port on your computer. + +Your computer should recognise your micro:bit as a new drive. On computers +running Windows, `MICROBIT` appears as a drive under Devices and drives. On a Mac +it appears as a new drive under Devices. + +![](/static/mb/device/usb-windows-device.jpg) + +## Step 2: Download your program + +1. Open your project on [codethemicrobit.com](https://codethemicrobit.com) +2. Click **Download** +3. When prompted, choose to **save** the compiled file onto your computer. The + prompt will be different depending on which browser you are using, or + whether you are using a Windows computer or a Mac + +A message will appear at the bottom of the browser asking what you want to do +with the file. Click **Save**: + +![](/static/mb/device/usb-windows-ie11-1.png) + +Then click **Open folder** and drag and drop the file from your Downloads to +your `MICROBIT` drive. + +![](/static/mb/device/usb-windows-ie11-2.png) + +## Step 3: Transfer the file to your micro:bit + +* Once you've found the folder containing your `.hex` file, drag and drop it + onto your `MICROBIT` drive +* If you're using Windows, you can use **Send to** as described below +* The LED on the back of your micro:bit flashes during the transfer (which + should only take a few seconds). +* Once transferred, the code will run automatically on your micro:bit. To rerun + your program, press the reset button on the back of your micro:bit. The reset + button automatically runs the newest file on the micro:bit. + +**Send to**: If you're using Windows you use *Send to* in File Explorer: + +In File Explorer, right-click on the hex file (created in Step 2 above), choose **Send to**, and then **MICROBIT**. + +![](/static/mb/device/usb-windows-sendto.jpg) + +By copying the script onto the `MICROBIT` drive, you have programmed it into the +flash memory on the micro:bit, which means even after you unplug the micro:bit, +your program will still run if the micro:bit is powered by battery. + + +### ~hint + +Transfer not working? See some [troubleshooting tips](/device/usb/troubleshooting). + +### ~ diff --git a/docs/static/mb/device/usb-thin.jpg b/docs/static/mb/device/usb-thin.jpg new file mode 100644 index 0000000000000000000000000000000000000000..0f50774b7ec48a755b778a35e6c4e078fd908d6c GIT binary patch literal 42017 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

V^$ zBH}h$lq!(`>Z46a=Oz{S zxE{4WflBy9!cJbd7)uFBJj@(dm-iLxbRNcOPm=Gey>-S{>e4}GHAU;C4*B?;i-s^` zaX4tHD}q(tI|Nk(IDd#Y=m5lU4fzz$YA5!fPaT?GS-U+)FZPnW|H$%^6r>(4hb{U@0P za_X*4mhuT1GTeWqy7Hu;f|)Z&lI18(6Ty6VAOQu^IiFawP^)H7WF3Q_rpsI)vMZ2- zZpf!fYgbc(g#6~g5eqh~MBYcedRti^Mpx_-GN<>2H;u==2XMmQ3`3cwUM1u+1LAHKNA;+#A(hu2bgY0Q^KZmQIB`9I0X}_$3P|IJQ;1jy}L#vVF z%&yV3;Y&V=JSsKyBe$>}5v5^a-P_tMDoFiAlr|hhTy42fL;a-QIP_{G-;MX7<{Rp< zi@HT+5d{2*fldsuk_s-a;}&2zsUbM5^3CPX1%p9DPt$mm;YUQ)ZHpBOL5u}USI~un zzAaA%7WXVp&2egpCE-E(=)io#5a$?qQ*KdE;4+_ebdn8|n&Splgvhb8cjs+no7_s6t_gqq)Eqft0aB+Nsjckrkoe`pMn z72M42msC2GdR13Qq|tPobFpLca{NO=br=~PnO2PFsIn|wJ*-okw;U#=-xq0*>yDMTade za^8KELWsNi7!E%F&N&I2tbk3y=coYJvyAeQ<*$sOch?*LIrOO$$`a;KSaypNgC!JnyIcz zh>PkOQ0?y}3aXM^dFtyr7hiov4au4L!X?)ByPL4HI`=V!?RJK_b0NSrKdNo60)D2_ zw-4)oXEYIJb72J&8%DHxHl?N%M&NV*%sK(j$brmK*Ti@6BIl|bA?Zvx1TnJ6h)xp_ z&+0vSe!Z?8#+_&LnY);2|%CgJc`xYL%+wD+F{UL;A`+qIa!@jy(e z{0|hBFR~fRXY(>q&e6^Fg8O%G!o=1|QQDNfYS2OsxF(EZlwLfhK^K{||8ylbIcE1b zEZijBAThM4K)#R>Nz8R{AJZzSA${d}txMNxV0T(EJQI9*pDFBqc9hqr!Tl>`E%k5j ze%k!83+|L}xY(`P$YG(kf(NgOo7$S3#+xiUKWyn3V0%gjs40Q}Vs6>PH*~AunX80{ z@CqCRJO2ov;3L?n7rimG&*+g%{}WD-i&*VZ*1aDMlJ~iyhUlTeJ!i@e3MuH^{1dlZ z*GQ)RwK+sk?0|#{~ zgCmMxHp)C_oag<~&}Gos5C#$<(Ucl}(Ro~J1y)Km0@=mSRY3|J$A zUi(5#!Iqz0UHNr->tMwqWC1}&nwtRF=JVQNowqmY(px4RtlrWPW`+xrttVZE9|(cm z_%ov`cQV`x*`6sG!W;#0^31x?n~!TbpIpD@ROkRZ?nMX-!3GAbK@B;ncC6N?lbj&) zw9j@0VBv?tDL6{89B!Ggv8KfY{A15r3SA6GKADv5x_r`$M###KG{rS!9%%wO%DUhX(8sxSu z@f6gDq3$!?>JY-_tpIi@dWv;@Vs5fhh^v0K-TO+O7WHb++DFwj#zc<#KW}f%eoh@;P7Wm> zupB=kMB9gd{yZ>JHhtgMSNW5qLG)2wj^yh|rFC(A{vH}`h%h0YWaZob-7~?P%#)hZ z2P=~HfgVz+maiN&_jrr3^~VzJN! zVC=Jx?&Dh2HHSV-Kv-DnkXDb@TU2PV&$D&U_3>>vEnq5s6@374b$p4dSoZTzm=wUz z9k8d9#-F$>8d-+WujSgZH6Bu?4v@fjCOOI8L4mG@;D!<$bgEeAEzgDCwfMT&nNl}s z(x1qqn3V5JLEV*|%_;ZTi@tcu{JNlLZjVVqg6r|4O5=d@Qs%-ymKG#Ljpm@P*>