Minor docs update

Adding initial UF2 page & minor changes to existing files.

Author: SFEMark

docs/introduction.md

@@ -2,4 +2,23 @@
 
 
 
-The IoT RedBoard - RP2350
+The IoT RedBoard - RP2350 combines the RP2350 microcontroller with the Raspberry Pi Radio Module 2 to provide a powerful and versatile wireless development platform in the Arduino R4 form factor. In this guide we'll cover how to connect the IoT RedBoard - RP2350 to a computer and how to progam it three development environments: Raspberry Pi Pico SDK, MicroPython, or Arduino.
+
+This guide uses just the hardware present on the IoT RedBoard - RP2350 so in order to follow along with this tutorial you'll only need the following items:
+
+* [IoT RedBoard - RP2350]()
+* [USB-C Cable]()
+
+## Major Topics Covered
+
+This document contains three main sections: **Quickstart Guide**, **Hardware** and **Software**. 
+
+The Quickstart Guide assumes a working knowledge of how to use a development board and the required software to program them for your project's needs. It covers a quick assembly and then jumps right into getting the necessary software packages installed to start uploading code in just a few short minutes. The document finishes with simple examples for each development environment showing how to set up and use the RM2 wireless chip to connect to a WiFi network. 
+
+The Hardware page provides a detailed overview of the IoT RedBoard - RP2350 along with all the major components included on the board. Refer to this page for information on things like the RP2350, LEDs, pinout and solder jumpers.
+
+The Software pages are split into each supported development environment along with a page that goes into detail on what the UF2 bootloader is and how to use it on the IoT RedBoard - RP2350. Each software page gives instructions on how to download install its respective development environment, any necessary support packages including board definitions and, where necessary, library packages, and includes a couple simple examples to ensure everything is working properly.
+
+## Resources and Support Documentation 
+
+You'll find the board design files (KiCad files & schematic), relevant documentation (datasheets, white papers, etc.) and other helpful links in the **Resources**. Lastly, the **Support** section includes a Troubleshooting page that includes any helpful tips specific to this board as well as information on how to receive technical support from SparkFun.

docs/quickstart.md

@@ -1,7 +1,7 @@
 
 
 
-Welcome to the SparkFun IoT RedBoard - RP2350 Quick Start Guide. This streamlined version of our standard Hookup Guides assumes a working knowledge of how to use a development board and the required software to program them for your project's needs. It covers a quick assembly and then jumps right into getting the necessary software packages installed to start uploading code in just a few short minutes. The guide finishes with simple examples for each development environment showing how to set up and use the RM2 wireless chip to connect to a WiFi network.
+Welcome to the SparkFun IoT RedBoard - RP2350 Quick Start Guide. This streamlined version of our standard Hookup Guides assumes a working knowledge of how to use a development board and the required software to program them for your project's needs. It covers a quick assembly and then jumps right into getting the necessary software packages installed to start uploading code in just a few short minutes. The document finishes with simple examples for each development environment showing how to set up and use the RM2 wireless chip to connect to a WiFi network.
 
 If you're not familiar with using development boards or the development environments covered in this guide, refer to the Hardware & Software sections for a detailed overview of the board along with instructions on setting up and programming the IoT RedBoard - RP2350.
 
@@ -50,7 +50,66 @@ The IoT RedBoard - RP2350 is supported in **version needed - ML** of the Pico SD
 
 The IoT RedBoard - RP2350 has Beta releases of MicroPython firmware available [here](https://github.com/sparkfun/micropython/releases). Download and install the MicroPython firmware onto your IoT RedBoard - RP2350, open your preferred Python IDE (or CLI) and copy the code below into it:
 
-**Insert example code -ML**
+**Code to Note**:
+LED control. Values are (R,G,B) 0-255. This sets the LED to full Red.
+``` py
+led[0] = (255, 0, 0)
+led.write()
+```
+WiFi network connection. Enter values for network ID and password.
+
+```py
+wlan = network.WLAN(network.STA_IF)
+wlan.active(True)
+wlan.connect('WIFI_NETWORK', 'WIFI_PASSWORD')
+```
+
+``` py
+import network
+import urequests
+import time
+import neopixel
+import machine
+
+# Set up the NeoPixel LED
+pin = machine.Pin("NEOPIXEL")
+led = neopixel.NeoPixel(pin, 1)
+
+# Set the LED to red while connecting to WiFi
+led[0] = (255, 0, 0)
+led.write()
+
+# Connect to a WiFi network
+wlan = network.WLAN(network.STA_IF)
+wlan.active(True)
+wlan.connect('WIFI_NETWORK', 'WIFI_PASSWORD')
+
+# Wait for the connection to complete
+print("Waiting for connection...")
+while not wlan.isconnected():
+	time.sleep(1)
+	print('.', sep='', end='', )
+print('Connected!')
+
+# Set the LED to blue while downloading data
+led[0] = (0, 0, 255)
+led.write()
+
+# Download the list of astronauts currently in space
+print('Downloading list of astronauts currently in space...')
+astronauts = urequests.get("https://corquaid.github.io/international-space-station-APIs/JSON/people-in-space.json").json()
+
+# Print the number of astronauts and their names
+number = astronauts['number']
+print('There are', number, 'astronauts in space.')
+for i in range(number):
+    print(i+1, astronauts['people'][i]['name'])
+
+# Set the LED to green to indicate success
+led[0] = (0, 255, 0)
+led.write()
+
+```
 
 
 

docs/uf2.md

@@ -0,0 +1,25 @@
+
+
+
+
+The IoT RedBoard - RP2350 uses a UF2 bootloader for easy flashing/uploading of code to the board. The UF2 bootloader causes the board to show up on your computer as a USB storage device and does <b>not</b> require any drivers for Windows, Mac OSX, and Linux! This bootloader is used for uploading in both the Pico SDK and MicroPython development environments so let's take a brief look at how to enter bootload mode.
+
+## What is UF2?
+
+UF2 stands for USB Flashing Format, which was developed by Microsoft for PXT (now known as MakeCode) for flashing microcontrollers over the Mass Storage Class (MSC), just like a removable flash drive. The file format is unique, so unfortunately, you cannot simply drag and drop a compiled binary or hex file onto the board. Instead, the format of the file has extra information to tell the processor where the data goes, in addition to the data itself. For more information about UF2, you can read more from the [MakeCode blog](https://makecode.com/blog/one-chip-to-flash-them-all), as well as the [UF2 file format specification](https://github.com/Microsoft/uf2).
+
+## Entering the Bootloader
+
+Putting the IoT RedBoard - RP2350 into bootloader mode only requires a couple of presses of the BOOT and RESET buttons. Start by pressing and holding the BOOT button down:
+
+<figure markdown>
+[![Pressing the BOOT button.](./assets/img/Thing_Plus_RP2350-uF2_BOOT.jpg){ width="600"}](./assets/img/Thing_Plus_RP2350-uF2_BOOT.jpg "Click to enlarge")
+</figure>
+
+Next, press and release the RESET button while still holding down the BOOT button:
+
+<figure markdown>
+[![Photo highlighting RP2350.](./assets/img/Thing_Plus_RP2350-uF2_RESET.jpg){ width="600"}](./assets/img/Thing_Plus_RP2350-uF2_RESET.jpg "Click to enlarge")
+</figure>
+
+Finally, release the BOOT button and the board should be in bootloader mode and appear on your computer as a USB storage device called "RP2350".

mkdocs.yml

@@ -278,6 +278,7 @@ nav:
       - Hardware Overview: hardware_overview.md
       - Hardware Assembly: hardware_assembly.md
     - Software:
+      - UF2 Bootloader: uf2.md
       - Pico SDK: picosdk.md
       - MicroPython: micropython.md
       - Arduino: arduino.md