Merge pull request #1203 from arduino/jacobhylen/number-micropython101chapters

[MKC-1061]MicroPython 101 revision

Author: jacobhylen

content/micropython-course/course/00.introduction-arduino/intro-to-arduino.md

@@ -1,6 +1,6 @@
 ---
 featured: micropython-101
-title: 'Introduction to Arduino'
+title: '1. Introduction to Arduino'
 description: 'Learn about the Arduino platform'
 author: 'Karl Söderby'
 hero_image: "./hero-banner.png"

content/micropython-course/course/01.introduction-python/02.intro-to-micropython.md

@@ -3,7 +3,7 @@ author: 'Karl Söderby'
 hero_image: "./hero-banner.png"
 micropython_type: "101"
 featured: micropython-101
-title: 'Introduction to MicroPython'
+title: '2. Introduction to MicroPython'
 description: 'Learn about the Arduino platform'
 ---
 
@@ -146,39 +146,67 @@ For example, to use a module for a specific sensor, we need to install it **exte
 
 ### Install External Modules
 
-To install an external module, we are going to use something called `mip`. With `mip`, we can install a module on the board directly, by connecting to Wi-Fi and downloading the module directly to the board. So how do we do this?
+To install an external module, we are going to use a package manager called `mip`. With `mip`, we can install a module on the board by connecting to Wi-Fi® and downloading the module directly to the board. Installing external modules is done in two steps:
 
-Below is a script that first connects to Wi-Fi®, and then downloads a specific module. In this case, we will provide a URL to a file stored on GitHub (the raw file). In this case, we will install the `lis3dh` module, which will be used later on in this course.
+1. Establish a Wi-Fi connection.
 
-Please note that you need to add your own Wi-Fi® network and password in the `WIFI_NETWORK` and `WIFI_PASSWORD` fields.
+2. Download the module from a specific URL using `mip`.
+
+To connect to your local Wi-Fi you can upload the following script to `boot.py` file. We choose `boot.py` because we want to make sure our board connects to the internet as soon as it boots up.
+
+**Connect to Wi-Fi**
+
+![Wi-Fi script inside boot.py](./assets/boot.png)
+
+***Please note that you need to add your own Wi-Fi network and password in the `WIFI_NETWORK` and `WIFI_PASSWORD` fields.***
 
 ```python
 """
-This script first connects to Wi-Fi,
-then installs the module specified
-in the URL variable.
+This script connects to Wi-Fi
 """
 
 import network
-import mip
 
 WIFI_NETWORK='YOUR_NETWORK_NAME'
 WIFI_PASSWORD='YOUR_NETWORK_PASSWORD'
 
-# add the URL of the module you want to install
-URL = "https://raw.githubusercontent.com/tinypico/tinypico-micropython/master/lis3dh%20library/lis3dh.py"
-
 wlan = network.WLAN(network.STA_IF)
 wlan.active(True)
 wlan.connect(WIFI_NETWORK, WIFI_PASSWORD)
 
 print()
 print("Connected to ",WIFI_NETWORK)
+```
+ Press run and you should see `Connected to <your Wi-Fi>` being printed inside the REPL.
+
+ ![Successful connection](./assets/wifiConnected.png)
+
+ **Install external modules**
+
+ Next, you need to run a script that installs the external module from a specific URL. Upload the following script to `main.py`.
 
-mip.install(URL)
+![Module installation script inside main.py](./assets/main.png)
+
+```python
+'''
+This script installs external modules using mip
+'''
+
+import mip
+mip.install("https://raw.githubusercontent.com/tinypico/tinypico-micropython/master/lis3dh%20library/lis3dh.py")
 ```
 
-Once you run the script successfully, you will have installed the module on your board.
+Press run and you should see the following inside the REPL:
+
+![Successful download](./assets/download.png)
+
+In this case, we will provide a URL to a file stored on GitHub (the raw file). The script installs the `lis3dh` module, which will be used later on in this course.
+
+You can verify that the module was installed correctly by pressing `Files` and checking inside the `lib` folder. You should see a file called `lis3dh.py` inside.
+
+![Installed module](./assets/libFolderIn.png)
+
+When asked later in the course to install external modules simply paste the provided script into `main.py` and press run.
 
 ### Removing Modules
 
@@ -215,9 +243,9 @@ OSError: -202
 
 Some things to check are:
 - Did you enter your network credentials properly?
-- Did you already connect to Wi-Fi®?
+- Did you already connect to Wi-Fi?
 
-If the error persist, you can try to "soft-reset" the board, by clicking the **"Reset"** button, and run the script again.
+If the error persists, you can try to "soft-reset" the board, by clicking the **"Reset"** button, and run the script again.
 
 ![](assets/reset.png)
 

content/micropython-course/course/01.introduction-python/assets/boot.png

@@ -3,7 +3,7 @@ author: 'Jacob Hylen'
 hero_image: "./hero-banner.png"
 micropython_type: "101"
 featured: micropython-101
-title: 'MicroPython Installation Guide'
+title: '3. MicroPython Installation Guide'
 description: 'Learn how to install a code editor needed to program your board with MicroPython.'
 ---
 
@@ -33,15 +33,7 @@ First, [download the app here](https://labs.arduino.cc/en/labs/micropython). It
 
 If you're on macOS, move the application to your **Applications** folder.
 
-**2. Put the Board in Bootloader Mode**
-
-Before we can install MicroPython, we need to place our board in a "bootloader" mode as we call it. This will make it possible to send a new firmware to it.
-
-Connect your board to your computer, and connect B1 to GND with a jumper wire, tweezers, or something else metallic you have handy. Once you see a green light on the board, press the reset button on the board. If you remove the connection between B1 and GND, you should see a dim purple light if this step was successful. If not, then try again.
-
-![Bootloader Mode](./assets/bootloader.png)
-
-**3. Download the Firmware Installer**
+**2. Download the Firmware Installer**
 
 The **Firmware Installer** program will help install MicroPython on your board.
 
@@ -51,21 +43,21 @@ First [download the app here](), and extract the files to a folder on your compu
 
 If you're on macOS, move the application to your **Applications** folder.
 
-**4. Flash Firmware**
+**3. Flash Firmware**
 
 Now open the Firmware Installer tool, select the Arduino Nano ESP32, and press **"Install MicroPython"**. Wait for the installer to do its magic and after some seconds, we are ready to go!
 
 ![Installer with Board Selected](./assets/installer.png)
 
 If the installer doesn't find the MicroPython firmware automatically, you can download it manually from [here](./assets/nanoesp32_micropython.bin)
 
-**5. Connect your Code Editor and Board**
+**4. Connect your Code Editor and Board**
 
 In the Arduino Lab for MicroPython app, press **connect** in the top left corner and choose the serial port that comes up. This is your Nano ESP32.
 
 ![Connect to your Board](./assets/connect.png)
 
-**6. Verify**
+**5. Verify**
 
 Now, to verify things are working as they should, copy the script script below into your `main.py` file, and run it by clicking the **"Run"** button.
 

content/micropython-course/course/01.introduction-python/assets/download.png

@@ -2,7 +2,7 @@
 author: 'Karl Söderby'
 hero_image: "./hero-banner.png"
 featured: micropython-101
-title: 'Python Crash Course'
+title: '4. Python Crash Course'
 description: 'Learn some Python fundamentals that will help you create MicroPython scripts.'
 ---