From 21c32cfb341d2dc0dec66ae6aec40d6f3afd3323 Mon Sep 17 00:00:00 2001 From: Hel Gibbons Date: Wed, 19 Oct 2022 17:22:50 +0100 Subject: [PATCH] revamp installing micropython page --- dfu_mode.png | Bin 0 -> 56467 bytes setting-up-micropython.md | 59 +++++++++++++++++++++++++++----------- 2 files changed, 42 insertions(+), 17 deletions(-) create mode 100644 dfu_mode.png diff --git a/dfu_mode.png b/dfu_mode.png new file mode 100644 index 0000000000000000000000000000000000000000..fdac4bfec1c3f803a59e0dacecb15c109a5575c5 GIT binary patch literal 56467 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
  • n7J&7`n+{v?~SRf6QH{iB*^Yg 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 cwR!JoJ~5hIeSPb%n}vVVy?e9Z*GGT+Hz>% literal 0 HcmV?d00001 diff --git a/setting-up-micropython.md b/setting-up-micropython.md index 8eb5ebf5..9202b341 100644 --- a/setting-up-micropython.md +++ b/setting-up-micropython.md @@ -1,28 +1,53 @@ -# Setting up MicroPython +# Installing MicroPython -If you just want to use MicroPython then setup is a breeze as we've already built the firmware for you and you can simply drag it onto your Pico to get started. +We provide pre-built MicroPython images which include all the drivers that include all the libraries and drivers you'll need to use our [supported products](https://github.com/pimoroni/pimoroni-pico#supported-products) To install MicroPython, you'll need to **copy the appropriate .uf2 file from the releases page to your device while it's in DFU/bootloader mode.** -If you want to use our products with your Raspberry Pi Pico then you must use our pre-built firmware as it contains all of the drivers needed. +## Which file do I need to download? -To setup your Raspberry Pi Pico with our MicroPython firmware follow these steps: +On the releases page you'll find a bunch of different .uf2 files for use on different RP2040 boards (if you can't see them, click on the arrow next to 'assets' to expand the list). -## Step 1 -Disconnect the USB cable from your Raspberry Pi Pico. +- [Releases page](https://github.com/pimoroni/pimoroni-pico/releases) -## Step 2 -Press and hold the "BOOTSEL" switch on top of the Raspberry Pi Pico. +| Board | What uf2 file to use | Notes | +| ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | +| Raspberry Pi Pico and most other RP2040 boards without wireless (Plasma 2040, Interstate 75, Servo 2040, Motor 2040, Tiny 2040 2MB) | **pimoroni-pico** | | +| Raspberry Pi Pico W and Pico W Aboard products (Automation 2040 W, Inventor 2040 W, Inky Frame, Plasma Stick) | **pimoroni-picow** | | +| Badger 2040 | **pimoroni-badger2040** or **pimoroni-badger2040-without-badger-os** | Download **pimoroni-badger2040** for built in examples! | +| Tufty 2040 | **pimoroni-tufty2040** | | +| Pimoroni Pico LiPo | **pimoroni-picolipo_4mb** or **pimoroni-picolipo_8mb** | Includes support for the increased flash memory on these boards | +| Tiny 2040 8MB | **pimoroni-tiny2040** | Includes support for the increased flash memory on this board | -## Step 3 -Plug the USB cable back into your Raspberry Pi Pico (making sure to keep the "BOOTSEL" button pressed while you do it!). +## Entering DFU/bootloader mode -This should put your Raspberry Pi Pico into firmware update mode. It will appear as a new disk drive on your computer with the name **RPI-RP2**. +### If you have a board with a reset button: -## Step 4 -Download our custom MicroPython firmware image from [the releases page](https://github.com/pimoroni/pimoroni-pico/releases). +Lucky you! With your board plugged into your computer, just **hold down the BOOTSEL button and tap RESET**. A new drive should pop up on your computer called 'RPI_RP2'. -## Step 5 -Copy the downloaded firmware image onto the **RPI-RP** drive. +### If you have a board without a reset button: -The firmware will now upload to your Raspberry Pi Pico and when it has finished uploading (which takes around five seconds) the Pico will restart itself. +- **Disconnect the USB cable from your board.** +- **Press and hold the 'BOOTSEL' button.** +- **Plug the USB cable back into your board (making sure to keep 'BOOTSEL' pressed).** A new drive should pop up on your computer called 'RPI_RP2'. -Hurrah! You're setup and good to go! +Here's what the 'RPI-RP2' drive looks like in Windows: + +![](dfu_mode.png) + +## Copying the firmware to your board + +**Copy the downloaded firmware image across to the 'RPI-RP2' drive**. Once it has finished uploading (which takes a few seconds) the Pico will restart itself. + +⚠ Note that once your board restarts running MicroPython it will no longer show up as a drive. To program it and to transfer files to and from it you'll need to use an interpreter, such as Thonny or Mu. + +- [Download Thonny](https://thonny.org/) +- [Download Mu](https://codewith.mu/) + +You can also transfer files to boards running MicroPython using command line tools, like `mpremote`. + +- https://docs.micropython.org/en/latest/reference/mpremote.html + +## Where are the examples? + +Note that most of our MicroPython images don't include examples, so you'll need to copy across the ones you want using Thonny. You can find all our MicroPython examples at the link below. + +- [MicroPython examples](https://github.com/pimoroni/pimoroni-pico/tree/main/micropython/examples)