Content revision

Author: karlsoderby

content/micropython/01.basics/01.overview/overview.md

@@ -3,24 +3,20 @@ title: Overview
 description: An introduction to Arduino and MicroPython
 author: Francesca Sanfilippo
 micropython_type: basics
-next_article: "/micropython/basics/board-installation"
-previous_article: "/micropython"
 ---
 
 MicroPython is an implementation of the Python programming language, and includes some of the standard Python libraries. It is designed to run on microcontrollers with constrained environments.
 
-In this sequence of guides, you will amongst other things, learn how to:
+In this sequence of guides, you will among other things, learn how to:
 - Install MicroPython on your Arduino board,
-- Install the suggested editor (Arduino Labs for MicroPython),
+- Install an editor with support for MicroPython,
 - How to make basic scripts that can for example blink an LED, read an analog pin and print things to the terminal (REPL).
 
 You do not need any prior knowledge in either programming with Arduino or MicroPython, but it is recommended to know the basics of Python.
 
 What you need to do it is have a Compatible Board and a Code Editor. You can choose between two alternatives:
-- Arduino Lab for MicroPython: an experimental editor from Arduino, designed for simpler projects.
-- OpenMV: an editor for  more complex projects, such as computer vision.
-
-Check the pages of Compatibles Board and Code Editor to go on.
+- **Arduino Lab for MicroPython:** an experimental editor from Arduino, designed for simpler projects.
+- **OpenMV:** an editor for  more complex projects, such as computer vision.
 
 ## Python vs C/C++.
 
@@ -31,5 +27,4 @@ There's a big difference between how we program an Arduino board with the Arduin
 
 ## Python vs MicroPython
 
-MicroPython was created to work under constrained conditions, like a small environment. The main difference between Python and MicroPython is that MicroPython does not have the full standard Python language, it is only a subset of it.
-
+MicroPython was created to work under constrained conditions, like a small environment. The main difference between Python and MicroPython is that MicroPython does not have the full standard Python language, it is only a subset of it.

content/micropython/01.basics/02.board-installation/board-installation.md

@@ -5,8 +5,6 @@ author: Francesca Sanfilippo, Karl Söderby & Jacob Hylén
 micropython_type: basics
 featured: micropython
 hero_image: "./hero-banner.png"
-next_article: "/micropython/basics/overview"
-previous_article: "/micropython/basics/code-editors"
 ---
 
 So what do you need to start your first project with MicroPython and Arduino? First, you will need a compatible board. In this page, you will find the compatible boards, with instructions on how to install them.

content/micropython/01.basics/03.code-editors/assets/mpylabs-ss.png

@@ -5,24 +5,26 @@ author: Francesca Sanfilippo & Karl Söderby
 micropython_type: basics
 featured: micropython
 hero_image: "./hero-banner.png"
-next_article: "/micropython/basics/micro-python-basics"
-previous_article: "/micropython/basics/board-installation"
 ---
 
 To write and load scripts to your board, you will also need a Code Editor. In this page, you will find two alternatives:
-- Arduino Lab for MicroPython: an experimental editor from Arduino, designed for simpler projects.
-- OpenMV: an editor for  more complex projects, such as computer vision.
+- **Arduino Lab for MicroPython:** an experimental editor from Arduino, designed for simpler projects.
+- **OpenMV:** an editor for  more complex projects, such as computer vision.
 
 ## Arduino Lab for MicroPython
 
 Arduino Lab for MicroPython is a software that supports programming Arduino boards with MicroPython. Through the customized editor, we can install MicroPython, and upload scripts directly to the board.  The editor is able to manage the files and you can see what is uploaded on the board and vice versa.
 
-![Arduino Lab for MicroPython]()
+![Arduino Lab for MicroPython](assets/mpylabs-ss.png)
+
+- [Download Arduino Lab for MicroPython](https://labs.arduino.cc/en/labs/micropython).
 
 ## OpenMV Editor
 
 OpenMV is a platform that supports programming Arduino boards with MicroPython. Through the OpenMV editor, we can install MicroPython and upload scripts directly to the board. There's also a number of examples available directly in the editor.
 
-You can download it from the [OpenMV downloads page]() for more detailed guide on how to install the editor.
+![OpenMV editor.](assets/openmv-ss.png)
+
+- [Download OpenMV](https://openmv.io/pages/download).
 
-***You can also check out the full list of examples in the [OpenMV's GitHub repository]().***
+***You can also check out the full list of examples in the [OpenMV's GitHub repository](https://github.com/openmv/openmv/tree/master/scripts/examples/10-Arduino-Boards).***

content/micropython/01.basics/03.code-editors/assets/openmv-ss.png

@@ -3,23 +3,19 @@ title: MicroPython Basics
 description: An introduction to MicroPython
 author: Francesca Sanfilippo & Karl Söderby
 micropython_type: basics
-next_article: "/micropython/basics/digital-analog-pins"
-previous_article: "/micropython/basics/code-editors"
 ---
 
-As you read in the Overview, MicroPython is an implementation of Python. In this page, you will find some basic and intermediate MicroPython scripts that can be used by any Arduino board. This includes some very common concepts such as variables, loops, delays, prints and more.
+As you read in the Overview, MicroPython is an implementation of Python. In this page, you will find some basic and intermediate MicroPython scripts that can be used by any Arduino board. This includes some very common concepts such as variables, loops, delays, how to print and more.
 
 ***There are some differences between MicroPython and Python, which mostly concern standard library and types, but also some language-level features.***
 
-After you download Arduino Lab for MicroPython from the Arduino Labs page, click the file for your system, extract and run the application. The interface is similar to Arduino IDE.  
+After you download [Arduino Lab for MicroPython](https://labs.arduino.cc/en/labs/micropython), click the file for your system, extract and run the application. The interface is similar to Arduino IDE.
 
 First of all, we need to connect our board to the computer via USB.
 
-![Connect the board via USB.]()
-
 After connecting the board, click on the connect button, and select the port. 
 
-![Connect and select the port.]()
+![Connect and select the port.](assets/labs-connect.png)
 
 Now that you have connected your board, let’s create a file that will contain the script that will run on your board. Click on New button to create your file. The editor automatically creates the main file in the board.
 

content/micropython/01.basics/03.code-editors/code-editors.md

@@ -3,8 +3,6 @@ title: Digital and Analog Pins
 description: Learn how to use digital and analog Pins with Micropython
 author: Francesca Sanfilippo & Karl Söderby
 micropython_type: basics
-next_article: "/micropython/basics/board-api"
-previous_article: "/micropython/basics/micropython-basics"
 ---
 
 In this chapter we will learn about managing digital and analog pins. 
@@ -13,7 +11,7 @@ All the compatibles boards have a series of pins, most of these pins work as a g
 
 There are essentially two types of pins, analog and digital pins. Digital pins can be set to either HIGH (usually 5V or 3.3V) or LOW (0V). You can use that to e.g. read a button state or to toggle an LED.
 
-***Important: unfortunately, the MicroPython implementation does not match the pinout of your board. This means, that if you want to use for example, digital pin (5), it might be digital pin (27) on one board, or digital pin (14) on another. Please visit the [Arduino MicroPython boards pin mapping article]().***
+***Important: unfortunately, the MicroPython implementation does not match the regular pinout of your board. This means, that if you want to use for example, digital pin (5), it might be digital pin (27) on one board, or digital pin (14) on another. Please visit the [Board API article](/micropython/basics/board-api) to see what the pin map for your board is.***
 
 ## Digital Pins
 
@@ -56,10 +54,6 @@ while True:
     time.sleep(1)
 ```
 
-The result is:
-
-![Onboard LED Blinking.]()
-
 ### Digital Read (Pull Up)
 
 In this example we read a digital value from a digital pin, using the `PULL_UP` mode. Here, we declare the pin an input through the `Pin.IN` command.

content/micropython/01.basics/04.micropython-basics/assets/labs-connect.png

@@ -977,7 +977,7 @@ while (True):
 
 ![Portenta H7.](assets/portenta.png)
 
-***Note that the [Portenta H7 Lite]() and [Portenta H7 Lite Connected]() boards are compatible with most examples listed here, as they are variations of the Portenta H7.***
+***Note that the [Portenta H7 Lite](/hardware/portenta-h7-lite) and [Portenta H7 Lite Connected](/hardware/portenta-h7-lite-connected) boards are compatible with most examples listed here, as they are variations of the Portenta H7.***
 
 ### GPIO Map