update installation tutorial

Author: karlsoderby

content/micropython/03.micropython/modulinos/01.installation/assets/package-installed.png

@@ -7,56 +7,90 @@ hero_image: "./hero-banner.png"
 
 ---
 
-This article will guide you through the installation process for programming the Arduino Modulinos with Micropython. 
+In this tutorial, we will go through the installation process required for programming the Arduino Modulinos with MicroPython. 
 
 ## Goals
 
 The goals of this tutorial are:
 
-- learn how to install MicroPython on your Arduino board.
-- learn how to install MicroPython packages.
-- learn how to run a simpe sketch using MicroPython labs.
+- Learn how to install a MicroPython package on your board (the Modulino package).
 
 ## Hardware & Software Needed
 
-- [MicroPython Labs](https://lab-micropython.arduino.cc/)
+You will need a MicroPython compatible board that works with the Modulinos:
 - [Arduino Nano ESP32](https://store.arduino.cc/products/nano-esp32?queryID=undefined)
+- [Arduino Nano RP2040 Connect](https://store.arduino.cc/en-se/products/arduino-nano-rp2040-connect)
+
+You will also need the following software:
+- [MicroPython Labs](https://lab-micropython.arduino.cc/)
 - [MicroPython Installer](https://labs.arduino.cc/en/labs/micropython-installer)
-- [Modulino MicroPython Package](https://github.com/arduino/arduino-modulino-mpy)
+- [Modulino MicroPython package](https://github.com/arduino/arduino-modulino-mpy)
 
 ## Install MicroPython
 
-If you haven't done so already, you need to install MicroPython on your Arduino board. The easiest way is to install it using the [MicroPython Installer](https://labs.arduino.cc/en/labs/micropython-installer).
+To follow this tutorial, you will need to install MicroPython on your Arduino board. The easiest way is to install it using the [MicroPython Installer](https://labs.arduino.cc/en/labs/micropython-installer).
 
-- Open the installer
+- Open the installer.
 - Connect your board. 
 - If it does not appear press the refresh button.
 - Press "Install MicroPython".
 - Wait for the installation to finish.
 
 ![MicroPython Installer](./assets/microPythonInstaller.png)
 
-## Install Modulino Package
-
-To program Modulinos using MicroPython you must first install the Modulino Package. It's where all the code, necessary to interact with the Modulinos is being stored.
-
-The easiest way of installing it is using `mpremote`.
-
-***If this is your first time using `mpremote`, check out the [Getting Started article]().***
-
-Once you have everything set up, run:
+***More details on installing MicroPython on your board are available in the [MicroPython Installation guide]().***
 
-```bash
-mpremote connect <PORT> mip install github:arduino/arduino-modulino-mpy
-```
-
-![MicroPython Package Installation](./assets/MicroPythonPackageInstallationDone.png)
+## Install Modulino Package
 
-This will install all necessary packages on your Arduino board.
+To program Modulinos using MicroPython we must first install the Modulino package. It's where all the code, necessary to interact with the Modulinos is being stored.
+
+There are two ways of installing a package:
+- Through a terminal
+- 
+
+### Terminal Installation
+
+The easiest way of installing it is using `mpremote`. Currently, we will need a version of Python installed on our computer.
+
+1. Open a terminal, and write the following line:
+   ```bash
+   pip install mpremote 
+   ```
+   This will install `mpremote`, which makes it possible to install packages on our board via your computer.
+2. With `mpremote` installed, we need to run the following command to identify our board's serial port:
+   ```bash
+   mpremote connect list
+   ```
+   
+   Which will give us something like this:
+   
+   ```bash
+   /dev/cu.usbmodem101 ecda3b60a4dccb3f 2341:056b Arduino Nano ESP32
+   ```
+   - The port here is `/dev/cu.usbmodem101`. Copy this.
+
+3. Now, run the following the command. Make sure to replace `<PORT>` with the port of your device obtained in the previous step.
+    ```bash
+    mpremote connect <PORT> mip install github:arduino/arduino-modulino-mpy
+    ```
+
+    Upon completion, we should see something like this in the terminal, to verify the success of the installation:
+    ![Successful installation.](assets/package-installed.png)
+
+4. Great job. We have now installed the Modulino package on your board!
+
+**Troubleshooting:**
+- Make sure your board is connected to your computer.
+- Make sure it is **not** connected in the Arduino Lab for MicroPython, as this might disturb the connection.
+- If you are unable to run `mpremote` in the terminal, this means it is not installed.
+- If you are unable to run `python` in the terminal, make sure you have installed Python (you can download and install it [here](https://www.python.org/downloads/))
+- If you have installed Python and it is still not working, try running `python3` and `pip3` instead.
+- If you installed Python while having the terminal open, try closing the terminal and re-opening it.
+- If you run `mpremote` and there's no board appearing in the list, try re-installing the firmware on your board as it might have failed during installation. 
 
 ## MicroPython Labs
 
-Let's verify that everything was installed and is working correctly. Go to [MicroPython Labs](https://lab-micropython.arduino.cc/) and click on the connect icon in the top left corner.
+We can now verify that everything was installed correctly. Go to [MicroPython Labs](https://lab-micropython.arduino.cc/) and click on the connect icon in the top left corner.
 
 ![MicroPython Labs](./assets/microPythonLabs.png)
 
@@ -70,18 +104,16 @@ You should see a folder called `lib` and a file called `boot.py`. Go ahead and p
 
 ![MicroPython Lab Files](./assets/microPythonLabsFiles.png)
 
-If you see this, it means the package has been installed successfully. If you want to to go even deeper, you can open the modulino folder and have a look at the individual Modulino packages. Don't worry, you don't have to understand what those files mean exactly to continue.
-
-## First Sketch
-
-Copy the following line to the MicroPython Labs Editor and press "Run".
-
-```python
-print("Hello, World!")
-```
-
-You should see "Hello, World", being printed in the commandline.
+If you see this, it means the package has been installed successfully.
 
 ## Next Steps
 
-Now that you have successfully installed everything it's time to program your first Modulino.
+Now that you have successfully installed everything it's time to program your first Modulino. Below are links to the documentation for all Modulinos. They are also accessible in the side menu at [Arduino Docs - MicroPython](https://docs.arduino.cc/micropython/), under "Modulinos".
+
+- [Modulino Distance](/micropython/modulinos/modulino-distance)
+- [Modulino Pixels](/micropython/modulinos/modulino-pixels)
+- [Modulino Buzzer](/micropython/modulinos/modulino-buzzer)
+- [Modulino Buttons](/micropython/modulinos/modulino-buttons)
+- [Modulino Knob](/micropython/modulinos/modulino-knob)
+- [Modulino Movement](/micropython/modulinos/modulino-movement)
+- [Modulino Thermo](/micropython/modulinos/modulino-thermo)