review first steps complete

karlsoderby · karlsoderby · commit 4c6016d86ac5 · 2024-10-31T11:19:41.000+01:00
diff --git a/content/micropython/03.micropython/00.first-steps/00.into-micropython/intro-micropython.md b/content/micropython/03.micropython/00.first-steps/00.into-micropython/intro-micropython.md
@@ -2,7 +2,7 @@
 title: 'Introduction to MicroPython'
 description: 'Learn about the fundamentals of Micropython on Arduino boards.'
 author: 'Pedro Lima'
-hero_image: "./hero-banner.png"
+tags: [MicroPython, Introduction]
 ---
 
 MicroPython is a lightweight implementation of Python 3 designed to run on microcontrollers and embedded systems. Think of it as a mini-version of Python, tailored for hardware with limited resources like memory and processing power. Despite its smaller size, MicroPython retains the simplicity and flexibility of Python, making it an excellent option for programming hardware.
diff --git a/content/micropython/03.micropython/00.first-steps/01.install-guide/installing-micropython.md b/content/micropython/03.micropython/00.first-steps/01.install-guide/installing-micropython.md
@@ -2,8 +2,8 @@
 featured: micropython-101
 title: 'Installing MicroPython'
 description: 'Learn how to install MicroPython on your Arduino board.'
-author: 'Pedro Lima & Karl Söderby'
-hero_image: "./hero-banner.png"
+author: 'Pedro Lima'
+tags: [MicroPython, Installation]
 ---
 
 # Installing MicroPython
@@ -40,7 +40,7 @@ MicroPython is officially supported on several Arduino boards. Here’s a list o
 - [MicroPython Firmware Installer](https://labs.arduino.cc/en/labs/micropython-installer) - the firmware installer is needed to install MicroPython on our Arduino board. 
 - [Arduino Lab for Micropython](https://labs.arduino.cc/en/labs/micropython) - Arduino Lab for MicroPython is an editor where we can create and run MicroPython scripts on our Arduino board.
 
-***Note that the editor is also available online, at [Arduino Cloud - Arduino Labs for MicroPython](https://lab-micropython.arduino.cc/)
+***Note that the editor is also available online, at [Arduino Cloud - Arduino Labs for MicroPython](https://lab-micropython.arduino.cc/)***
 
 ## Install MicroPython
 
diff --git a/content/micropython/03.micropython/00.first-steps/02.first-sketch/first-sketch.md b/content/micropython/03.micropython/00.first-steps/02.first-sketch/first-sketch.md
@@ -2,33 +2,51 @@
 title: 'My First Script'
 description: 'Learn how to write a basic MicroPython script to blink an LED.'
 author: 'Pedro Lima'
-hero_image: "./hero-banner.png"
+tags: [MicroPython, Blink]
 ---
 
-In this tutorial, we'll guide create our very first MicroPython script that will run on an Arduino board. We'll make an LED blink, a classic beginner project that introduces you to basic MicroPython programming concepts.
+In this tutorial, we will create our very first MicroPython script that will run on an Arduino board. Starting of simple, we will make an LED blink, a classic beginner project that will get us familiar with the MicroPython programming environment.
 
-## Hardware & Software Needed
+## Requirements
 
-For this tutorial, you will need a MicroPython compatible Arduino Board:
+Before we start, let's check the requirements:
 
-  - [Arduino Nano 33 BLE]()
-  - [Arduino Nano ESP32]()
-  - [Arduino Nano RP2040 Connect]()
-  - [Arduino GIGA R1 WiFi]()
-  - [Arduino Portenta H7]()
-  - [Arduino Nicla Vision]()
+### MicroPython Compatible Arduino Boards
 
-You will also need the following software installed:
+MicroPython is officially supported on several Arduino boards. Here’s a list of the compatible boards:
 
-  - [Arduino Lab for MicroPython](https://labs.arduino.cc/en/labs/micropython).
+- [Portenta C33](https://store.arduino.cc/products/portenta-c33)
+- [Arduino GIGA R1 WiFi](https://store.arduino.cc/products/arduino-giga-r1-wifi)
+- [Portenta H7](https://store.arduino.cc/products/portenta-h7)
+- [Portenta H7 Lite](https://store.arduino.cc/products/portenta-h7-lite)
+- [Portenta H7 Lite Connected](https://store.arduino.cc/products/portenta-h7-lite-connected)
+- [Opta](https://store.arduino.cc/products/opta)
+- [Opta Wifi](https://store.arduino.cc/products/opta-wifi)
+- [Opta RS485](https://store.arduino.cc/products/opta-rs485)
+- [Arduino Nano RP2040 Connect](https://store.arduino.cc/products/arduino-nano-rp2040-connect)
+- [Nicla Vision](https://store.arduino.cc/products/nicla-vision)
+- [Arduino Nano 33 BLE](https://store.arduino.cc/products/arduino-nano-33-ble)
+- [Arduino Nano 33 BLE Rev2](https://store.arduino.cc/products/arduino-nano-33-ble-rev2)
+- [Arduino Nano 33 BLE Sense](https://store.arduino.cc/products/arduino-nano-33-ble-sense)
+- [Arduino Nano 33 BLE Sense Rev2](https://store.arduino.cc/products/arduino-nano-33-ble-sense-rev2)
+- [Arduino Nano ESP32](https://store.arduino.cc/products/arduino-nano-esp32)
 
-## Board and Editor Setup
 
-Blinking an LED is a simple yet effective way to get started with MicroPython while still understanding how to control hardware using code.
+### Software Requirements
+
+- [Arduino Lab for Micropython](https://labs.arduino.cc/en/labs/micropython) - Arduino Lab for MicroPython is an editor where we can create and run MicroPython scripts on our Arduino board.
+
+***Note that the editor is also available online, at [Arduino Cloud - Arduino Labs for MicroPython](https://lab-micropython.arduino.cc/)***
 
-1. Connect your Arduino board to your computer via USB.
-2. Open the Arduino Lab for MicroPython application.
-3. Click on the **Connect** button, and select the board from the list.
+## Board and Editor Setup
+
+1. Open the [Arduino Lab for MicroPython]() application.
+2. Plug the Arduino board into the computer using a USB cable.
+    ![Connect board to computer.]()
+3. Press the connection button on the top left corner of the window.
+    ![Connect the editor to the board.]()
+4. The connected Arduino board should appear, and we can click it:
+    ![Select board.]()
 
 ***Need help installing MicroPython on your board? Visit the [MicroPython installation guide]().***
 
@@ -44,6 +62,9 @@ Once your board is connected, we can start writing code! Below you will find a b
   import machine
   import time
 
+  # The pin used for built-in LED varies
+  # GIGA: 0 (green), Nano ESP32: 0 (green), Nano RP2040 Connect: 25
+  # Nano BLE Sense: 13
   led = machine.Pin(25, machine.Pin.OUT)
 
   while True:
@@ -53,44 +74,19 @@ Once your board is connected, we can start writing code! Below you will find a b
       time.sleep(1)
   ```
 
-  ***Note: On some boards, the built-in LED might be on a different pin. For example, on the Arduino Nano RP2040 Connect, the built-in LED is on pin `25`. Check your board's documentation to confirm the correct pin number.***
+  ***Note: The built-in LED pin varies from board to board. For example, on the Arduino Nano RP2040 Connect, the built-in LED is on pin `25`.***
 
-3. Click the **Run** or **Upload** button in your editor to transfer the script to your board.
+3. Click the **Run** button in your editor to transfer the script to your board.
+   ![Run the script.]()
 
-Once the script is running, the LED on your board should start blinking at one-second intervals. This means your MicroPython script has loaded successfully.
+Once the script is running, the LED on the board should start blinking at one-second intervals. This means our MicroPython script has loaded successfully.
 
 ![LED blinking on your board.]()
 
-## Programming Concepts Explained
-
-Let's break down the key programming concepts used in this script:
-
-### `machine` Module
-
-The machine module is a built-in MicroPython library that provides direct access to your board's hardware components. It allows you to control and interact with the microcontroller's features, such as:
-
--**Pins:** Configure and control digital and analog pins.
--**Timers:** Set up timers for scheduling tasks.
--**Communication Interfaces:** Use protocols like I2C, SPI, and UART.
--**Hardware-Specific Functions:** Access features unique to your microcontroller.
-
-In our script, we use the machine.Pin class to interact with a specific pin on the board. By creating a Pin object, we can control the voltage level of that pin, which in turn controls the LED.
-
-### `time` Module
-
-The time module provides functions for managing time-related tasks. It allows you to add delays, measure time intervals, and schedule events. Key functions include:
-
--**time.sleep(seconds):** Pauses the execution of your script for the specified number of seconds. It accepts floating-point numbers for sub-second delays.
--t**ime.ticks_ms():** Returns the number of milliseconds(ms) since the board was last reset.
--**time.ticks_us()**: Returns the number of microseconds(us) since the board was last reset.
--In our script, ``time.sleep(1)`` pauses the program for one second. This creates a delay between turning the LED on and off, controlling the blink rate.
-
-### `while True` Loop
-
-A `while True` loop creates an infinite loop, allowing the code inside it to run repeatedly. This is essential for tasks that need to run continuously, like blinking an LED.
-
 ### Code Breakdown
 
+Let's take a look at the code, line by line, to understand what is happening:
+
 - **Import Modules**:
 
   ```python
@@ -126,6 +122,31 @@ A `while True` loop creates an infinite loop, allowing the code inside it to run
   - Wait for another second.
   - Repeat the cycle.
 
+## Understanding Programming Concepts
+
+Let's break down the key programming concepts used in this script:
+
+### `machine` Module
+
+The machine module is a built-in MicroPython library that provides direct access to your board's hardware components. It allows you to control and interact with the microcontroller's features, such as:
+
+- **Pins:** Configure and control digital and analog pins.
+- **Timers:** Set up timers for scheduling tasks.
+- **Communication Interfaces:** Use protocols like I2C, SPI, and UART.
+- **Hardware-Specific Functions:** Access features unique to your microcontroller.
+
+In our script, we use the `machine.Pin` class to interact with a specific pin on the board. By creating a `Pin` object, we can control the voltage level of that pin, which in turn controls the LED.
+
+### `time` Module
+
+The time module provides functions for managing time-related tasks. It allows you to add delays, measure time intervals, and schedule events. Key functions include:
+
+- `time.sleep(seconds)` Pauses the execution of your script for the specified number of seconds. It accepts floating-point numbers for sub-second delays.
+
+### `while True` Loop
+
+A `while True` loop creates an infinite loop, allowing the code inside it to run repeatedly. This is essential for tasks that need to run continuously, like blinking an LED.
+
 ## Modification: Make the LED Blink Faster
 
 Let's modify the script to make the LED blink faster. We'll change the delay from 1 second to 0.2 seconds.
@@ -140,25 +161,25 @@ led = machine.Pin(25, machine.Pin.OUT)
 
 while True:
     led.value(1)
-    time.sleep(2)
+    time.sleep(0.5) # 0.5 seconds
     led.value(0)
-    time.sleep(2)
+    time.sleep(0.5) # 0.5 seconds
 ```
 
 ### Steps
 
-1. Change the `time.sleep(1)` lines to `time.sleep(2)`.
+1. Change the `time.sleep(1)` lines to `time.sleep(0.5)`.
 2. Upload the modified script to your board.
-3. Observe that the LED now blinks faster, turning on and off every 2 seconds.
+3. Observe that the LED now blinks faster, turning on and off every 0.5 seconds.
 
-## Conclusion
+## Summary
 
-Congratulations! You've written and modified your first MicroPython script on an Arduino board. This exercise introduced you to:
+Great work! We have now written and modified our first MicroPython script on an Arduino board. This exercise introduced:
 
 - Importing modules (`machine`, `time`)
 - Initializing hardware components (LED)
 - Using loops (`while`)
 - Controlling time delays (`time.sleep()`)
 
-These concepts are key for a vast majoraty of the operations you will be performing when writing your own programs and are present in the industry at large.
+These concepts are key for a vast majoraty of operations we can perform while writing MicroPython programs.
 
