Merge branch 'main' into jacobhylen/uno-ds

Author: jacobhylen

content/learn/02.microcontrollers/01.digital-pins/digital-pins.md

@@ -8,7 +8,7 @@ The pins on the Arduino can be configured as either inputs or outputs.  This doc
 
 ## Properties of Pins Configured as INPUT
 
-Arduino (Atmega) pins default to inputs, so they don't need to be explicitly declared as inputs with pinMode() when you're using them as inputs. Pins configured this way are said to be in a **high-impedance state**. Input pins make extremely small demands on the circuit that they are sampling, equivalent to a series resistor of 100 megohm in front of the pin. This means that it takes very little current to move the input pin from one state to another, and can make the pins useful for such tasks as implementing [a capacitive touch sensor](https://playground.arduino.cc/Code/CapacitiveSensor), reading an LED as a [photodiode](https://playground.arduino.cc/Learning/LEDSensor), or reading an analog sensor with a scheme such as [RCTime.](https://arduino.cc/en/Tutorial/RCtime)
+Arduino (Atmega) pins default to inputs, so they don't need to be explicitly declared as inputs with pinMode() when you're using them as inputs. Pins configured this way are said to be in a **high-impedance state**. Input pins make extremely small demands on the circuit that they are sampling, equivalent to a series resistor of 100 megohm in front of the pin. This means that it takes very little current to move the input pin from one state to another, and can make the pins useful for such tasks as implementing [a capacitive touch sensor](https://playground.arduino.cc/Code/CapacitiveSensor), reading an LED as a [photodiode](https://playground.arduino.cc/Learning/LEDSensor), or reading an analog sensor with a scheme such as [RCTime](/tutorials/generic/capacitance-meter).
 
 This also means however, that pins configured as pinMode(pin, INPUT) with nothing connected to them, or with wires connected to them that are not connected to other circuits, will report seemingly random changes in pin state, picking up electrical noise from the environment, or capacitively coupling the state of a nearby pin.
 

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.