upgraded download instructions to use "save as"

This commit is contained in:
Peli de Halleux 2017-03-24 07:39:59 -07:00
parent 62b4168531
commit 684646d3de
8 changed files with 37 additions and 92 deletions

View File

@ -1,11 +1,11 @@
# micro:bit uploader for OS X # @boardname@ uploader for OS X
![](Microbit Uploader/Assets.xcassets/AppIcon.appiconset/icon_256x256.png) ![](Microbit Uploader/Assets.xcassets/AppIcon.appiconset/icon_256x256.png)
This project is a clone of the [Windows This project is a clone of the [Windows
uploader](https://pxt.microbit.org/uploader), but for OS X. Once launched, uploader](https://pxt.microbit.org/uploader), but for OS X. Once launched,
the app runs in your menu bar and will automatically deploy any HEX files to the app runs in your menu bar and will automatically deploy any HEX files to
your `micro:bit`. Like the Windows version, it is compatible with any browser your `@boardname@`. Like the Windows version, it is compatible with any browser
that can run [pxt.microbit.org](http://pxt.microbit.org). that can run [pxt.microbit.org](http://pxt.microbit.org).
## Install the built version ## Install the built version

View File

@ -34,7 +34,8 @@ Adding a little tape helps keeping the crocodile clips in place.
## Example: on pin pressed with random numbers ## Example: on pin pressed with random numbers
This example displays a random number every time the crocodile clip holds `GND` then connects and disconnects the `P0` pin. This example displays a random number every time the crocodile clip holds `GND` then connects and disconnects the `P0` pin.
Each time the crocodile clip is firmly connected and disconnected from pin `P0`, the micro:bit will return a random Number between 0 and the parameter limit. Each time the crocodile clip is firmly connected and disconnected from pin `P0`,
the @boardname@ will return a random Number between 0 and the parameter limit.
```blocks ```blocks
input.onPinPressed(TouchPin.P0, () => { input.onPinPressed(TouchPin.P0, () => {

View File

@ -4,20 +4,20 @@ The large holes at the bottom of the board are designed to attach alligator/croc
to create electrical circuit with other components. to create electrical circuit with other components.
If you do not have crocodile clips at hand, dyou can use wires or even Aluminium foil to acheive the same result. If you do not have crocodile clips at hand, dyou can use wires or even Aluminium foil to acheive the same result.
We will show you how to connect the micro:bit to headphones using Alumunium foil and tape. We will show you how to connect the @boardname@ to headphones using Alumunium foil and tape.
https://youtu.be/mhXYyPuvpz0 https://youtu.be/mhXYyPuvpz0
### Materials ### Materials
* micro:bit and battery pack (you can also power it via USB) * @boardname@ and battery pack (you can also power it via USB)
* a small piece of cardboard * a small piece of cardboard
* Aluminium foil * Aluminium foil
* tape * tape
### Assembly instructions ### Assembly instructions
Tape the micro:bit and battery pack to the card board. Make sure to remove the batteries while you are building your circuit. Tape the @boardname@ and battery pack to the card board. Make sure to remove the batteries while you are building your circuit.
![](/static/mb/device/croc-clips/microbitattached.jpg) ![](/static/mb/device/croc-clips/microbitattached.jpg)
@ -49,4 +49,4 @@ Tape the second wire on the head of the jack connector.
## See also ## See also
[micro:bit pins](/device/pins) [@boardname@ pins](/device/pins)

View File

@ -6,9 +6,16 @@ can **compile** it and run it on your micro:bit.
The basic steps are: The basic steps are:
1. Connect your micro:bit to your computer via USB 1. Connect your @boardname@ to your computer via USB
2. Click **Download** and download the `.hex` file 2. Click **Download** to download the `.hex` file
3. Copy the `.hex` file from your computer onto the micro:bit drive 3. Move the `.hex` file from your computer onto the MICROBIT drive
### ~ hint
In Edge, Internet Explorer and Firefox, you can click on the **Save As** button on the bottom bar and save the ``.hex`` file
directly into the MICROBIT drive!
### ~
![](/static/mb/device/usb-thin.jpg) ![](/static/mb/device/usb-thin.jpg)

View File

@ -8,16 +8,9 @@ can **compile** it and run it on your micro:bit.
The basic steps are: The basic steps are:
1. Connect your micro:bit to your computer via USB 1. Connect your @boardname@ to your computer via USB
2. Click **Download** and download the `.hex` file 2. Click **Download** to download the `.hex` file
3. Copy the `.hex` file from your computer onto the micro:bit drive 3. Click the **Save As** button in the bottom bar and save the `.hex` file into the MICROBIT drive
### ~hint
You can use the [micro:bit uploader](/uploader) to automatically deploy ``.hex`` files to your micro:bit!
![](/static/uploader/tooltip.png)
### ~
## Requirements ## Requirements
@ -50,38 +43,23 @@ it appears as a new drive under Devices.
whether you are using a Windows computer or a Mac 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 A message will appear at the bottom of the browser asking what you want to do
with the file. Click **Save**: with the file.
![](/static/mb/device/usb-windows-edge-1.png) 4. Click **Save As**
5. Save the ``.hex`` file into the **MICROBIT** drive
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 ## 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 * The LED on the back of your micro:bit flashes during the transfer (which
should only take a few seconds). should only take a few seconds).
* Once transferred, the code will run automatically on your micro:bit. To rerun * Once transferred, the code will run automatically on your @boardname@. To rerun
your program, press the reset button on the back of your micro:bit. The reset your program, press the reset button on the back of your @boardname@. The reset
button automatically runs the newest file on the micro:bit. 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 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, 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. 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 ### ~hint
Transfer not working? See some [troubleshooting tips](/device/usb/troubleshooting). Transfer not working? See some [troubleshooting tips](/device/usb/troubleshooting).

View File

@ -10,14 +10,7 @@ The basic steps are:
1. Connect your micro:bit to your computer via USB 1. Connect your micro:bit to your computer via USB
2. Click **Download** and download the `.hex` file 2. Click **Download** and download the `.hex` file
3. Copy the `.hex` file from your computer onto the micro:bit drive 3. Click the **Save As** button and save the `.hex` file into the MICROBIT drive
### ~hint
You can use the [micro:bit uploader](/uploader) to automatically deploy ``.hex`` files to your micro:bit!
![](/static/uploader/tooltip.png)
### ~
## Requirements ## Requirements
@ -50,31 +43,16 @@ it appears as a new drive under Devices.
whether you are using a Windows computer or a Mac 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. A window will appear asking whether you want to save or open the `.hex` file.
Select **Save File** and then select **OK**. Select **Save As** and save it to the MICROBIT drive.
![](/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 ## 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 * The LED on the back of your micro:bit flashes during the transfer (which
should only take a few seconds). should only take a few seconds).
* Once transferred, the code will run automatically on your micro:bit. To rerun * Once transferred, the code will run automatically on your @boardname@. To rerun
your program, press the reset button on the back of your micro:bit. The reset your program, press the reset button on the back of your @boardname@. The reset
button automatically runs the newest file on the micro:bit. 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 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, 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. your program will still run if the micro:bit is powered by battery.

View File

@ -8,14 +8,8 @@ The basic steps are:
1. Connect your micro:bit to your computer via USB 1. Connect your micro:bit to your computer via USB
2. Click **Download** and download the `.hex` file 2. Click **Download** and download the `.hex` file
3. Copy the `.hex` file from your computer onto the micro:bit drive 3. **Click the down arrow next to Save** in the bottom bar and select **Save As**.
4. In the save dialog, save the `.hex` file into the MICROBIT drive
### ~hint
You can use the [micro:bit uploader](/uploader) to automatically deploy ``.hex`` files to your micro:bit!
![](/static/uploader/tooltip.png)
### ~
## Requirements ## Requirements
@ -48,32 +42,18 @@ it appears as a new drive under Devices.
whether you are using a Windows computer or a Mac 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 A message will appear at the bottom of the browser asking what you want to do
with the file. Click **Save**: with the file. Click **on the arrow next to Save** and click **Save As**
![](/static/mb/device/usb-windows-ie11-1.png) In the save dialog, save the ``.hex`` file to the MICROBIT drive.
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 ## 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 * The LED on the back of your micro:bit flashes during the transfer (which
should only take a few seconds). should only take a few seconds).
* Once transferred, the code will run automatically on your micro:bit. To rerun * Once transferred, the code will run automatically on your @boardname@. To rerun
your program, press the reset button on the back of your micro:bit. The reset your program, press the reset button on the back of your @boardname@. The reset
button automatically runs the newest file on the micro:bit. 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 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, 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. your program will still run if the micro:bit is powered by battery.

View File

@ -217,6 +217,7 @@
"exampleGallery": "examples", "exampleGallery": "examples",
"crowdinProject": "kindscript", "crowdinProject": "kindscript",
"boardName": "micro:bit", "boardName": "micro:bit",
"driveDisplayName": "MICROBIT",
"sideDoc": "tutorials/getting-started", "sideDoc": "tutorials/getting-started",
"feedbackUrl": "https://www.research.net/r/MCmicro", "feedbackUrl": "https://www.research.net/r/MCmicro",
"browserSupport": [ "browserSupport": [