From f3daa8eb0af2d02afd2f6078a1cd5d686f7c8c1a Mon Sep 17 00:00:00 2001 From: Paul Cutler Date: Thu, 28 Jul 2022 12:33:31 -0500 Subject: [PATCH 1/3] Add ESP mode tutorial using MicroPython --- en/tutorials/1.1/esp.md | 57 +++++++++------------------- img/en/tutorials/rp2040_buttons.png | Bin 0 -> 9983 bytes 2 files changed, 18 insertions(+), 39 deletions(-) create mode 100644 img/en/tutorials/rp2040_buttons.png diff --git a/en/tutorials/1.1/esp.md b/en/tutorials/1.1/esp.md index 3d76255..c8d4186 100644 --- a/en/tutorials/1.1/esp.md +++ b/en/tutorials/1.1/esp.md @@ -1,47 +1,35 @@ --- layout: default -title: Adafruit Boards and Mu +title: ESP Boards and Mu i18n: en --- -# Adafruit Boards and Mu - -[Adafruit](http://adafruit.com/) make a wide variety of amazing microcontroller -based boards which are capable of running their own version of MicroPython -called [CircuitPython](https://www.adafruit.com/circuitpython). These boards -range from the incredibly small to powerful boards with tons of built-in -hardware features. Even better, Adafruit have nurtured and grown a thriving -online community associated with CircuitPython and their amazing line of -boards. This is a supportive and helpful place to be if you're a beginner -coder -- especially if you're into making small embedded computers (such as the -boards made by Adafruit) do funky stuff with real-world peripherals, then this -is the place for you. - -Mu's Adafruit mode is made in collaboration with Adafruit and makes it very -easy to create projects and write code for their line of boards. For example, -your Python code to run on Adafruit boards is *stored on the boards*. Mu -understands this and will detect and open files on any device plugged into your -regular computer. - -The extra functionality provided by Adafruit mode is contained in the following +# Raspberry Pi Pico boards and Mu + +ESP8266 and ESP32 boards are small, cheap and connect to the Internet. +These boards are capable of running +[MicroPython](https://www.raspberrypi.com/documentation/microcontrollers/micropython.html). + +The extra functionality provided by ESP MicroPython mode is contained in the following buttons:
- Buttons from the Adafruit mode + Buttons for rp2040 mode
-The "Serial" button opens a serial data connection to the Adafruit board you +The "Run" button runs your Python code and opens the REPL pane to display any output. + +The "Files" button opens two panes below the code editor. The left pane lists files stored +on your microcontroller and the right pane lists files stored on your computer. + +The "REPL" button opens a serial data connection to the Raspberry Pi Pico board you may have connected to your computer. This will result in a new pane between the text editor and Mu's footer. Any serial data emitted from the device will -appear here. If you need to drop into the CircuitPython REPL you should make -sure the pane has keyboard focus (just click it!) and then type CTRL-C, as -shown below: +appear here. You can interact with the MicroPython REPL by clicking in the REPL pane +to have focus. -
- Adafruit serial -
-
+You can only have Files or REPL open at a time. The "Plotter" button opens Mu's plotter. If your device is outputting tuples of numbers via the serial connection, the plotter will display them as a @@ -49,12 +37,3 @@ graph. This is incredibly useful for visualising any data you might be measuring via the device. For more information read the [tutorial about Mu's plotter](plotter). -
- Adafruit plotter -
-
- -If you're looking for things to do with your Adafruit board, there's no better -place to look than the -[Adafruit Learning System](https://learn.adafruit.com/category/circuitpython) -on their website. diff --git a/img/en/tutorials/rp2040_buttons.png b/img/en/tutorials/rp2040_buttons.png new file mode 100644 index 0000000000000000000000000000000000000000..a74bee6144cd800952d6ecb36844adb83c36f4c7 GIT binary patch literal 9983 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 Ls!YvGv+(}`@5r8v literal 0 HcmV?d00001 From e72492d3329081d423c7d4f8fa0a314f9e292f8f Mon Sep 17 00:00:00 2001 From: Paul Cutler Date: Thu, 28 Jul 2022 12:36:43 -0500 Subject: [PATCH 2/3] Fix header title for ESP mode --- en/tutorials/1.1/esp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en/tutorials/1.1/esp.md b/en/tutorials/1.1/esp.md index c8d4186..58756f5 100644 --- a/en/tutorials/1.1/esp.md +++ b/en/tutorials/1.1/esp.md @@ -4,7 +4,7 @@ title: ESP Boards and Mu i18n: en --- -# Raspberry Pi Pico boards and Mu +# ESP822 and ESP32 boards and Mu ESP8266 and ESP32 boards are small, cheap and connect to the Internet. These boards are capable of running From 6a18765cc7ecf42e40996ffd7e98b3a2594775b4 Mon Sep 17 00:00:00 2001 From: Paul Cutler Date: Fri, 29 Jul 2022 06:41:15 -0500 Subject: [PATCH 3/3] Fix typo in header --- en/tutorials/1.1/esp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en/tutorials/1.1/esp.md b/en/tutorials/1.1/esp.md index 58756f5..7b6e48a 100644 --- a/en/tutorials/1.1/esp.md +++ b/en/tutorials/1.1/esp.md @@ -4,7 +4,7 @@ title: ESP Boards and Mu i18n: en --- -# ESP822 and ESP32 boards and Mu +# ESP8266 and ESP32 boards and Mu ESP8266 and ESP32 boards are small, cheap and connect to the Internet. These boards are capable of running