Docs Initial Review

SFEMark · SFEMark · commit 7a2e301b1702 · 2025-03-13T11:33:08.000-06:00
Initial review of docs update. Minor edits to existing .md files &amp; adding board files to assets folder.
diff --git a/docs/arduino.md b/docs/arduino.md
@@ -1,7 +1,3 @@
----
-icon: simple/arduino
----
-
 !!! attention
 	If this is your first time using Arduino, please read through our tutorial on [installing the Arduino IDE](https://learn.sparkfun.com/tutorials/installing-arduino-ide). If you have not installed an Arduino library before, we recommend you check out our [installation guide](https://learn.sparkfun.com/tutorials/installing-an-arduino-library).
 
@@ -19,6 +15,4 @@ Click "OK" to close this menu then navigate to the Boards Manager tool and searc
 [![Screenshot of board manager tool searching for pico.](./assets/img/arduino_boards.jpg){ width="600"}](./assets/img/arduino_boards.jpg "Click to enlarge")
 </figure>
 
-For more information on using the Arduino-Pico boards package, check out their [documentation page](https://arduino-pico.readthedocs.io/en/latest/index.html).
-
-## Examples
+For more information on using the Arduino-Pico boards package, check out their [documentation page](https://arduino-pico.readthedocs.io/en/latest/index.html). Head over to the Quick Start guide for an Arduino example demonstrating how to connect to a WiFi network, download data from a site and control the RGB LED.
diff --git a/docs/assets/board_files/SparkFun_IoT_RedBoard-RP2350-Dimensions.jpg b/docs/assets/board_files/SparkFun_IoT_RedBoard-RP2350-Dimensions.jpg
diff --git a/docs/assets/board_files/SparkFun_IoT_RedBoard-RP2350-Schematic.pdf b/docs/assets/board_files/SparkFun_IoT_RedBoard-RP2350-Schematic.pdf
diff --git a/docs/assets/board_files/SparkFun_IoT_RedBoard-RP2350.zip b/docs/assets/board_files/SparkFun_IoT_RedBoard-RP2350.zip
diff --git a/docs/hardware_assembly.md b/docs/hardware_assembly.md
diff --git a/docs/hardware_overview.md b/docs/hardware_overview.md
@@ -1,7 +1,3 @@
----
-icon: material/cog
----
-
 This document gives a detailed overview of the RedBoard IoT - RP2350 and all components present on the board.
 
 ## IoT RedBoard - RP2350 Overview
diff --git a/docs/introduction.md b/docs/introduction.md
@@ -1,25 +1,22 @@
-
-
+![SparkFun IoT RedBoard - RP2350)](docs/assets/img/iot-redboard-rp2350-gh-banner.png "SparkFun 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]()
+* [IoT RedBoard - RP2350](https://www.sparkfun.com/sparkfun-iot-redboard-rp2350.html)
+* [USB-C Cable](https://www.sparkfun.com/usb-a-to-usb-c-cable-1m-usb-2-0-flexible-silicone.html)
 
-## Major Topics Covered
+## 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.
 
-. 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
-
 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.
+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.
 
 ## Resources and Support Documentation 
 
diff --git a/docs/micropython.md b/docs/micropython.md
@@ -1,7 +1,3 @@
-
-
-
-
 ## Setup
 
 MicroPython is an application of the Python 3 language that runs on microcontrollers like the IoT RedBoard - RP2350 that allows you to easily interact with the board directly over a USB serial interface through either a command line interface or your preferred Python IDE such as [Thonny](https://thonny.org/). We'll do a quick overview of how to download MicroPython firmware on to the RedBoard IoT - RP2350 but for a complete overview of using MicroPython with this and other RP2350 boards, head over to Raspberry Pi's documentation by clicking the button below:
@@ -12,12 +8,10 @@ MicroPython is an application of the Python 3 language that runs on microcontrol
 
 ## UF2 Firmware
 
-As of this writing, we're waiting on the next release of MicroPython to include UF2 files for the IoT RedBoard - RP2350 so to get users started before then, we have Beta releases of MicroPython firmware available [here](https://github.com/sparkfun/micropython/releases) or by clicking the button below:
+The SparkFun IoT RedBoard - RP2350 is available in the main release of MicroPython [here](https://micropython.org/download/). Search for "SparkFun IoT RedBoard - RP2350" on the MicroPython downloads page for the correct firmware. This release does **not** include PSRAM support.  of MicroPython to include UF2 files for the IoT RedBoard - RP2350 so to get users started before then, we have Beta releases of MicroPython firmware available [here](https://github.com/sparkfun/micropython/releases) or by clicking the button below:
 
 <center>
     [SparkFun MicroPython Beta Releases](https://github.com/sparkfun/micropython/releases){ .md-button .md-button--primary}
 </center>
 
-Simply download the latest release and then put the IoT RedBoard - RP2350 into UF2 bootloader mode and open the location the board appeared as a USB storage device (it should appear as "RP2350"). Next, simply drag and drop the UF2 file into the RP2350 folder and the board should reboot. After the board reboots, open up your preferred MicroPython IDE (or command line interface) and you can start interacting with your RedBoard IoT. Read on to the MicroPython examples section for a few quick examples to make sure everything is working properly.
-
-## Examples
+Download the latest release and then put the IoT RedBoard - RP2350 into UF2 bootloader mode and open the location the board appeared as a USB storage device (it should appear as "RP2350"). Next, drag and drop the UF2 file into the RP2350 folder and the board should reboot. After the board reboots, open up your preferred MicroPython IDE (or command line interface) and you can start interacting with your RedBoard IoT. Head over to the Quick Start guide for an example project that shows how to connect the board to a WiFi network, download data from a website and control the RGB LED.
diff --git a/docs/picosdk.md b/docs/picosdk.md
@@ -1,8 +1,4 @@
-
-
-
-
-## Raspberry Pi Pico SDK
+## Pico SDK Setup & Documentation
 
 The Pico C SDK is a C/C++ development kit for Raspberry Pi microcontrollers including the RP2350. Click on the links below for complete documentation on installing and using the SDK.
 
@@ -16,6 +12,4 @@ The Pico C SDK is a C/C++ development kit for Raspberry Pi microcontrollers incl
 
 ### RedBoard IoT - RP2350 Board Definition
 
-When using the Pico SDK, make sure to use v2.1 or later and select `sparkfun_thingplus_rp2350` for the board. We recommend using [Microsoft VS Code](https://code.visualstudio.com/) with the [Pico SDK Extension](https://marketplace.visualstudio.com/items?itemName=raspberry-pi.raspberry-pi-pico).
-
-## Examples
+When using the Pico SDK, make sure to use v2.1 or later and select `sparkfun_iotredboard_rp2350` for the board. We recommend using [Microsoft VS Code](https://code.visualstudio.com/) with the [Pico SDK Extension](https://marketplace.visualstudio.com/items?itemName=raspberry-pi.raspberry-pi-pico).
diff --git a/docs/quickstart.md b/docs/quickstart.md
@@ -1,8 +1,6 @@
+Welcome to the SparkFun IoT RedBoard - RP2350 Quick Start Guide showing how to set up and use the RM2 wireless chip to connect to a WiFi network, request and download data on the number and names of astronauts currently on the International Space Station. 
 
-
-
-
-Welcome to the SparkFun IoT RedBoard - RP2350 Quick Start Guide showing how to set up and use the RM2 wireless chip to connect to a WiFi network, request and download data on the number and names of astronauts currently on the International Space Station. 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.
+If you're not familiar with using development boards or the development environments covered in this guide, refer to the [Hardware](./hardware_overview.md) & [Software](./uf2.md) sections for a detailed overview of the board along with instructions on setting up and programming the IoT RedBoard - RP2350.
 
 ## Basic Assembly
 
diff --git a/docs/resources.md b/docs/resources.md
@@ -0,0 +1,7 @@
+For more information on the SparkFun IoT RedBoard - RP2350, check out the following resources:
+
+* [Schematic (PDF)](./assets/board_files/SparkFun_IoT_RedBoard-RP2350-Schematic.pdf)
+* [KiCad Files (ZIP)](./assets/board_files/SparkFun_IoT_RedBoard-RP2350.zip)
+* [Board Dimensions](./assets/board_files/SparkFun_IoT_RedBoard-RP2350-Dimensions.jpg)
+* [RP2350 Datasheet](./assets/component_documentation/)
+* [GitHub Repository](https://github.com/sparkfun/SparkFun_IoT_RedBoard-RP2350)
diff --git a/docs/uf2.md b/docs/uf2.md
@@ -1,7 +1,3 @@
-
-
-
-
 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?
@@ -10,16 +6,9 @@ UF2 stands for USB Flashing Format, which was developed by Microsoft for PXT (no
 
 ## 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>
+Putting the IoT RedBoard - RP2350 into bootloader mode only requires a couple of presses of the BOOT and RESET buttons. Enter the bootloader with the following steps:
 
-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".
+* Press and hold down the BOOT button.
+* While holding BOOT button, press and release the RESET button.
+* Release the BOOT button
+* Device should appear as a USB storage device called "RP2350"
