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 00000000..0f50774b Binary files /dev/null and b/docs/static/mb/device/usb-thin.jpg differ