diff --git a/README.md b/README.md
index f285dd8..b0b4d32 100644
--- a/README.md
+++ b/README.md
@@ -5,6 +5,12 @@ SparkFun Portability Shield
[*SparkFun Portability Shield (DEV-27510)*](https://www.sparkfun.com/products/27510)
+The SparkFun Portability Shield adds all the user interface bits needed to take a SparkFun development board into the field. A LiPo battery connector, charger, fuel gauge, and an on/off switch address your power needs. A friction-fit microSD connector allows for data logging. The 1.3in. OLED and a five-way navigation switch provide an excellent user interface. Locking 0.1in. headers along the shield's edge make it easier to solder male pins in place.
+
+I2C is used to interface with the display, fuel gauge, and five-way navigation switch (GPIO expander PCA9554). SPI is used to communicate with the microSD card. The power switch uses an ideal diode (LM66200) to disconnect the battery from the system for a sleep current of approximately 4μA.
+
+The Portability Shield has been designed to be usable with any compatible main board, with the [RTK Postcard](https://www.sparkfun.com/products/26916) being the first!
+
Head to the [Sparkfun Portability Shield Product Manual](http://docs.sparkfun.com/SparkFun_Portability_Shield/) for technical documentation.
diff --git a/docs/arduino_example.md b/docs/arduino_example.md
index 9e3c007..337cbeb 100644
--- a/docs/arduino_example.md
+++ b/docs/arduino_example.md
@@ -2,4 +2,86 @@
icon: simple/arduino
---
+###Example 1: Navigation Switch
+This example demonstrates how to use the navigation switch and detect if the SD card is inserted. The !INT pin of the GPIO expander IC (PCA9554) triggers an interrupt any time a button is pressed or an SD card is inserted/removed.
+
+The code for this example can be found in the [Firmware](../Firmware/Example1_NavigationSwitch/) folder of this repository. Alternatively, you can expand the link below and copy and paste the code into a shiny new Arduino sketch:
+
+
+
+One thing to note is that you will also need to install the SparkFun I2C Expander Arduino Library if you haven't already. You can click the link from within the code or you can download the zip from [the GitHub Repository](https://github.com/sparkfun/SparkFun_I2C_Expander_Arduino_Library/archive/refs/heads/main.zip)
+
+
+[{ width="90%" }](assets/img/I2CExpanderLibraryInstall.png "Click to enlarge")
+SparkFun I2C Expander Arduino Library Install
+
+
+
+Make sure you've selected the correct board (in this case, we are using the RTK Postcard) and port in the Tools menu and then hit the upload button. Once the code has finished uploading, go ahead and open a [Serial Monitor](https://learn.sparkfun.com/tutorials/terminal-basics). You should see something similar to the following.
+
+
+[{ width="90%" }](assets/img/Example1_Output.jpg "Click to enlarge")
+Example 1 Output
+
+
+
+###Example 2: Fuel Gauge
+This file demonstrates the simple API of the SparkFun MAX17043 Arduino library.
+
+The code for this example can be found in the [Firmware](../Firmware/Example2_FuelGauge/) folder of this repository. Alternatively, you can expand the link below and copy and paste the code into a shiny new Arduino sketch:
+
+You will also need to install the SparkFun MAX1704x Fuel Gauge Arduino Library if you haven't already. You can click the link from within the code or you can download the zip from [the GitHub Repository](https://github.com/sparkfun/SparkFun_MAX1704x_Fuel_Gauge_Arduino_Library/archive/refs/heads/main.zip)
+
+
+[{ width="90%" }](assets/img/MAX17043LibraryInstall.png "Click to enlarge")
+SparkFun MAX1704x Fuel Gauge Arduino Library Install
+
+
+
+Make sure you've selected the correct board and port in the Tools menu and then hit the upload button. Once the code has finished uploading, go ahead and open a [Serial Monitor](https://learn.sparkfun.com/tutorials/terminal-basics) at 115200 baud. You should see the gauge's voltage and state-of-charge (SOC) readings, similar to the following:
+
+
+[{ width="90%" }](assets/img/Example2_Output.jpg "Click to enlarge")
+Example 2 Output
+
+
+
+
+###Example 3: Display
+
+This example demonstrates how to display on the 1.3" OLED and read the fuel gauge. You should have the Portability Shield connected to the RTK Postcard or other controller.
+
+The code for this example can be found in the [Firmware](../Firmware/Example3_Display/) folder of this repository. Alternatively, you can expand the link below and copy and paste the code into a shiny new Arduino sketch:
+
+You will also need to install the SparkFun Qwiic OLED Arduino Library if you haven't already. You can click the link from within the code or you can download the zip from [the GitHub Repository](https://github.com/sparkfun/SparkFun_Qwiic_OLED_Arduino_Library/archive/refs/heads/main.zip)
+
+
+Make sure you've selected the correct board and port in the Tools menu and then hit the upload button. Once the code has finished uploading, you should see the gauge's voltage and state-of-charge (SOC) readings, similar to the following:
+
+
+[{ width="90%" }](assets/img/Example3_Output.jpg "Click to enlarge")
+Example 3 Output
+
+
+
+
+
+###Example 4: SD Card
+
+This example will mount an SD card, analyze the type of card, and output the analysis via the Serial Monitor.
+
+Go ahead and connect the Portability Shield to the RTK Postcard or other controller board. Insert a microSD card into the socket. Cards up to 512GB should work.
+
+The code for this example can be found in the [Firmware](../Firmware/Example4_SD/) folder of this repository. Alternatively, you can expand the link below and copy and paste the code into a shiny new Arduino sketch:
+
+
+
+
+
+Make sure you've selected the correct board and port in the Tools menu and then hit the upload button. Once the code has finished uploading, go ahead and open a [Serial Monitor](https://learn.sparkfun.com/tutorials/terminal-basics) at 115200 baud.
+
+
+[{ width="90%" }](assets/img/Example4_Output.jpg "Click to enlarge")
+Example 4 Output
+
diff --git a/docs/assets/board_files/SparkFun_Portability_Shield.jpg b/docs/assets/board_files/SparkFun_Portability_Shield.jpg
new file mode 100644
index 0000000..d8910a9
Binary files /dev/null and b/docs/assets/board_files/SparkFun_Portability_Shield.jpg differ
diff --git a/docs/assets/board_files/SparkFun_Portability_Shield_BoardDimensions.jpg b/docs/assets/board_files/SparkFun_Portability_Shield_BoardDimensions.jpg
index 03462e4..cd22ca1 100644
Binary files a/docs/assets/board_files/SparkFun_Portability_Shield_BoardDimensions.jpg and b/docs/assets/board_files/SparkFun_Portability_Shield_BoardDimensions.jpg differ
diff --git a/docs/assets/component_documentation/AP2112.pdf b/docs/assets/component_documentation/AP2112.pdf
new file mode 100644
index 0000000..431944e
Binary files /dev/null and b/docs/assets/component_documentation/AP2112.pdf differ
diff --git a/docs/assets/component_documentation/MAX17048_MAX17049-3469099.pdf b/docs/assets/component_documentation/MAX17048_MAX17049-3469099.pdf
new file mode 100644
index 0000000..9df0951
Binary files /dev/null and b/docs/assets/component_documentation/MAX17048_MAX17049-3469099.pdf differ
diff --git a/docs/assets/img/27510-Portability-Shield_Charge.jpg b/docs/assets/img/27510-Portability-Shield_Charge.jpg
new file mode 100644
index 0000000..0f7f04d
Binary files /dev/null and b/docs/assets/img/27510-Portability-Shield_Charge.jpg differ
diff --git a/docs/assets/img/27510-Portability-Shield_DPad.jpg b/docs/assets/img/27510-Portability-Shield_NavSwitch.jpg
similarity index 100%
rename from docs/assets/img/27510-Portability-Shield_DPad.jpg
rename to docs/assets/img/27510-Portability-Shield_NavSwitch.jpg
diff --git a/docs/assets/img/I2CExpanderLibraryInstall.png b/docs/assets/img/I2CExpanderLibraryInstall.png
new file mode 100644
index 0000000..5c45713
Binary files /dev/null and b/docs/assets/img/I2CExpanderLibraryInstall.png differ
diff --git a/docs/assets/img/MAX17043LibraryInstall.png b/docs/assets/img/MAX17043LibraryInstall.png
new file mode 100644
index 0000000..f99f51c
Binary files /dev/null and b/docs/assets/img/MAX17043LibraryInstall.png differ
diff --git a/docs/assets/img/QwiicOLEDLibraryInstall.png b/docs/assets/img/QwiicOLEDLibraryInstall.png
new file mode 100644
index 0000000..524f72f
Binary files /dev/null and b/docs/assets/img/QwiicOLEDLibraryInstall.png differ
diff --git a/docs/github/contribute.md b/docs/github/contribute.md
index 75d0d2b..97dc640 100644
--- a/docs/github/contribute.md
+++ b/docs/github/contribute.md
@@ -4,7 +4,7 @@ Spot an improvement opportunity? Feel free to contribute to our open-source desi
## :material-file-document-multiple: Improve our Documentation
All of this documentation can be modified by you! Please help us make it better.
-* These pages are contained in the [`docs` folder](https://github.com/sparkfun/SparkFun_Portability_Shield/tree/main/docs) of the [SparkFun Portability Shield repository](https://github.com/sparkfun/https://github.com/sparkfun/SparkFun_Portability_Shield/tree/main).
+* These pages are contained in the [`docs` folder](https://github.com/sparkfun/SparkFun_Portability_Shield/tree/main/docs) of the [SparkFun Portability Shield repository](https://github.com/sparkfun/SparkFun_Portability_Shield/tree/main).
### Submit a Correction
diff --git a/docs/hard_copy.md b/docs/hard_copy.md
new file mode 100644
index 0000000..79f1af0
--- /dev/null
+++ b/docs/hard_copy.md
@@ -0,0 +1,9 @@
+---
+icon: material/book-open-variant
+---
+
+Need to download or print our hookup guide?
+
+* [Print :fontawesome-solid-print:](single_page.md) (Single-Page View)
+ * To save as a `*.pdf` file, select the **Printer** or **Destination** labeled ++"Save as PDF"++. *(Instructions will vary based on the browser)*
+
\ No newline at end of file
diff --git a/docs/hardware_overview.md b/docs/hardware_overview.md
index db14a0e..7a122b8 100644
--- a/docs/hardware_overview.md
+++ b/docs/hardware_overview.md
@@ -3,7 +3,7 @@ icon: material/cog
---
## OLED
-The 1.3" OLED is a small, monochrome, blue on black display with a 128 x 64 dot matrix panel and an 7-bit unshifted I2C address of 0x3D. For more information, refer to the [datasheet](https://cdn.sparkfun.com/assets/learn_tutorials/3/0/8/SSD1306.pdf).
+The 1.3" OLED is a small, monochrome, blue on black display with a 128 x 64 dot matrix panel and a 7-bit unshifted I2C address of 0x3D. To change the I2C address to 0x3C, cut the D/C jumper on the back of the board. For more information, refer to the [datasheet](https://cdn.sparkfun.com/assets/learn_tutorials/3/0/8/SSD1306.pdf).
[{ width="75%" }](assets/img/27510-Portability-Shield_OLED.jpg "Click to enlarge")
@@ -13,20 +13,20 @@ The 1.3" OLED is a small, monochrome, blue on black display with a 128 x 64 dot
-## D-Pad
+## Navigation Switch
-The D-Pad allows for navigation of the configuration modes and menus related to the RTK or other loaded software.
+The Navigation Switch allows for navigation of the configuration modes and menus related to the RTK or other loaded software.
-[{ width="75%" }](assets/img/27510-Portability-Shield_DPad.jpg "Click to enlarge")
-DPad
+[{ width="75%" }](assets/img/27510-Portability-Shield_NavSwitch.jpg "Click to enlarge")
+Navigation Switch
## GPIO Expander
-The GPIO expander is used for D-Pad functionality and SD card detection. The 7-bit Unshifted Address is 0x18.
+The TCA9554 GPIO Expander is used for I2C interfacing with the Navigation Switch, 1.3" OLED display, the fuel gauge, and the SD Card Detect. Its 7-bit unshifted address is 0x20.
[{ width="75%" }](assets/img/27510-Portability-Shield_GPIOExpander.jpg "Click to enlarge")
@@ -65,7 +65,7 @@ How handy! There is an On/Off switch at the top of the board.
## Fuel Gauge
-The MAX17048 uses the Li+ battery-modeling algorithm ModelGauge™ to track the battery relative state-ofcharge (SOC) continuously over widely varying charge and discharge conditions. This eliminates current-sense resistor and battery learn cycles required in traditional fuel gauges and allows for the most accurate battery percentage readings. It's 7-bit unshifted address is 0x36. For more information, you can refer to the [datasheet](https://cdn.sparkfun.com/assets/5/2/7/6/6/MAX17048-MAX17049.pdf).
+The MAX17048 uses the Li+ battery-modeling algorithm ModelGauge™ to track the battery relative state-of-charge (SOC) continuously over widely varying charge and discharge conditions. This eliminates current-sense resistor and battery learn cycles required in traditional fuel gauges and allows for the most accurate battery percentage readings. Its 7-bit unshifted address is 0x36. For more information, you can refer to the [datasheet](https://cdn.sparkfun.com/assets/5/2/7/6/6/MAX17048-MAX17049.pdf).
[{ width="75%" }](assets/img/27510-Portability-Shield_FuelGauge.jpg "Click to enlarge")
@@ -85,7 +85,7 @@ The charge circuit charges Li+ batteries at 500mA. The equation below shows our
## MicroSD Card
-The microSD card slot allows for data logging or easy upload of programming files.
+The microSD Socket Friction Fit slot allows for data logging or easy upload of programming files.
!!! warning
Do NOT drive the microSD card pins high if the card is not powered. Damage could occur!
diff --git a/docs/introduction.md b/docs/introduction.md
index cfe7833..f09e55c 100644
--- a/docs/introduction.md
+++ b/docs/introduction.md
@@ -15,7 +15,9 @@ icon: material/book-open-page-variant
-- A small board that adds a display, navigation, logging, and battery management.
+- The SparkFun Portability Shield adds all the user interface bits needed to take a SparkFun dev board into the field. A LiPo battery connector, charger, fuel gauge, and an on/off switch take care of your power needs. A friction-fit microSD connector allow for datalogging. The 1.3" OLED and a 5-way navigation switch allow for an excellent user interface. Locking 0.1" headers along the edge of the shield make it easier to solder male pins in place.
+
+ I2C is used to interface to the display, fuel gauge, and the 5 way navigation switch (GPIO expander PCA9554), SPI is used to communicate with the microSD card. The power switch uses an ideal diode (LM66200) to disconnect the battery from the system for a sleep current of approximately 4μA.
@@ -39,7 +41,7 @@ To follow along with this tutorial, you will need the following materials. You m
GPS-26916
@@ -49,8 +51,6 @@ To follow along with this tutorial, you will need the following materials. You m
-
-
## Suggested Reading
Below are a few tutorials that may help users familiarize themselves with various aspects of the board.
@@ -64,6 +64,13 @@ Below are a few tutorials that may help users familiarize themselves with variou
**What is GPS RTK**
+-
+
+ 
+
+
+ **SparkFun RTK Product Manual**
+
diff --git a/docs/resources.md b/docs/resources.md
index f83599f..600e964 100644
--- a/docs/resources.md
+++ b/docs/resources.md
@@ -6,5 +6,5 @@ For more resources related to the SparkFun Portability Shield, check out the lin
* [Product Page](https://www.sparkfun.com/products/27510)
* [Schematic](assets/board_files/SparkFun_Portability_Shield_Schematic.pdf) (PDF)
* [KiCad Files](assets/board_files/SparkFun_Portability_Shield_KiCadFiles.zip) (ZIP)
-* [Board Dimensions](assets/img/SparkFun_Portability_Shield_BoardDimensions.jpg)
+* [Board Dimensions](assets/board_files/SparkFun_Portability_Shield_BoardDimensions.jpg)
* [Hardware GitHub Respository](https://github.com/sparkfun/SparkFun_Portability_Shield)
diff --git a/docs/single_page.md b/docs/single_page.md
index 7fae6ee..bfc46bc 100644
--- a/docs/single_page.md
+++ b/docs/single_page.md
@@ -14,12 +14,6 @@ icon: fontawesome/solid/scroll
# Hardware Assembly
--8<-- "./docs/hardware_assembly.md:5"
-## Software Setup
---8<-- "./docs/software_setup_and_programming.md:5"
-
-## Arduino Example
---8<-- "./docs/arduino_example.md:5"
-
# Troubleshooting Tips
--8<-- "./docs/troubleshooting.md:5"
