From 684646d3de8d8fcb3f6bf3fa55f1071db944bfe0 Mon Sep 17 00:00:00 2001 From: Peli de Halleux Date: Fri, 24 Mar 2017 07:39:59 -0700 Subject: [PATCH] upgraded download instructions to use "save as" --- clients/macuploader/README.md | 4 ++-- docs/device/crocodile-clips.md | 3 ++- docs/device/foil-circuits.md | 8 +++---- docs/device/usb.md | 13 +++++++--- docs/device/usb/windows-edge.md | 38 +++++++----------------------- docs/device/usb/windows-firefox.md | 30 ++++------------------- docs/device/usb/windows-ie.md | 32 +++++-------------------- pxtarget.json | 1 + 8 files changed, 37 insertions(+), 92 deletions(-) diff --git a/clients/macuploader/README.md b/clients/macuploader/README.md index de3205f4..c59cbd34 100644 --- a/clients/macuploader/README.md +++ b/clients/macuploader/README.md @@ -1,11 +1,11 @@ -# micro:bit uploader for OS X +# @boardname@ uploader for OS X ![](Microbit Uploader/Assets.xcassets/AppIcon.appiconset/icon_256x256.png) This project is a clone of the [Windows 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 -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). ## Install the built version diff --git a/docs/device/crocodile-clips.md b/docs/device/crocodile-clips.md index 04070a35..64d82283 100644 --- a/docs/device/crocodile-clips.md +++ b/docs/device/crocodile-clips.md @@ -34,7 +34,8 @@ Adding a little tape helps keeping the crocodile clips in place. ## 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. -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 input.onPinPressed(TouchPin.P0, () => { diff --git a/docs/device/foil-circuits.md b/docs/device/foil-circuits.md index 609c1ce9..d853cfb4 100644 --- a/docs/device/foil-circuits.md +++ b/docs/device/foil-circuits.md @@ -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. 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 ### 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 * Aluminium foil * tape ### 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) @@ -49,4 +49,4 @@ Tape the second wire on the head of the jack connector. ## See also -[micro:bit pins](/device/pins) +[@boardname@ pins](/device/pins) diff --git a/docs/device/usb.md b/docs/device/usb.md index 017d528b..301a86d2 100644 --- a/docs/device/usb.md +++ b/docs/device/usb.md @@ -6,9 +6,16 @@ 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 +1. Connect your @boardname@ to your computer via USB +2. Click **Download** to download the `.hex` file +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) diff --git a/docs/device/usb/windows-edge.md b/docs/device/usb/windows-edge.md index e72eea0c..03e1b82e 100644 --- a/docs/device/usb/windows-edge.md +++ b/docs/device/usb/windows-edge.md @@ -8,16 +8,9 @@ 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) - -### ~ +1. Connect your @boardname@ to your computer via USB +2. Click **Download** to download the `.hex` file +3. Click the **Save As** button in the bottom bar and save the `.hex` file into the MICROBIT drive ## Requirements @@ -50,38 +43,23 @@ it appears as a new drive under Devices. 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**: +with the file. -![](/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) +4. Click **Save As** +5. Save the ``.hex`` file into 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 +* Once transferred, the code will run automatically on your @boardname@. To rerun + your program, press the reset button on the back of your @boardname@. 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 index 473d6322..a06a955a 100644 --- a/docs/device/usb/windows-firefox.md +++ b/docs/device/usb/windows-firefox.md @@ -10,14 +10,7 @@ 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) - -### ~ +3. Click the **Save As** button and save the `.hex` file into the MICROBIT drive ## Requirements @@ -50,31 +43,16 @@ it appears as a new drive under Devices. 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**. +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 -* 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 +* Once transferred, the code will run automatically on your @boardname@. To rerun + your program, press the reset button on the back of your @boardname@. 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. diff --git a/docs/device/usb/windows-ie.md b/docs/device/usb/windows-ie.md index 786a998e..dc7e8a0c 100644 --- a/docs/device/usb/windows-ie.md +++ b/docs/device/usb/windows-ie.md @@ -8,14 +8,8 @@ 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) - -### ~ +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 ## Requirements @@ -48,32 +42,18 @@ it appears as a new drive under Devices. 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**: +with the file. Click **on the arrow next to Save** and click **Save As** -![](/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) +In the save dialog, save the ``.hex`` file to 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 +* Once transferred, the code will run automatically on your @boardname@. To rerun + your program, press the reset button on the back of your @boardname@. 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. diff --git a/pxtarget.json b/pxtarget.json index 1d38567d..67c1c486 100644 --- a/pxtarget.json +++ b/pxtarget.json @@ -217,6 +217,7 @@ "exampleGallery": "examples", "crowdinProject": "kindscript", "boardName": "micro:bit", + "driveDisplayName": "MICROBIT", "sideDoc": "tutorials/getting-started", "feedbackUrl": "https://www.research.net/r/MCmicro", "browserSupport": [