Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add ESP mode tutorial using MicroPython #78

Open
wants to merge 3 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
57 changes: 18 additions & 39 deletions en/tutorials/1.1/esp.md
Original file line number Diff line number Diff line change
@@ -1,60 +1,39 @@
---
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
# ESP8266 and ESP32 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:

<div class="row">
<img src="/img/en/tutorials/adafruit_buttons.png" alt="Buttons from the Adafruit mode" class="img-responsive center-block img-rounded movie"/>
<img src="/img/en/tutorials/rp2040_buttons.png" alt="Buttons for rp2040 mode" class="img-responsive center-block img-rounded movie"/>
<br/>
</div>

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.

<div class="row">
<img src="/img/en/tutorials/adafruit_serial.gif" alt="Adafruit serial" class="img-responsive center-block img-rounded movie"/>
<br/>
</div>
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
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).

<div class="row">
<img src="/img/en/tutorials/adafruit_plotter.gif" alt="Adafruit plotter" class="img-responsive center-block img-rounded movie"/>
<br/>
</div>

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.
Binary file added img/en/tutorials/rp2040_buttons.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.