Merge pull request #166 from zmumbauer/update-documentation-for-external-antenna

Document external antenna assembly for Satellite1 dev kits

Author: that1guy

README.md

@@ -91,8 +91,8 @@ Don't forget to give the project a star! Thanks again!
 1. Ensure Python and pip are installed on your machine (`python --version`) and (`pip --version`)
 2. Create a Python Virtual Environment (`python -m venv venv`)
 3. Start the Python Environment (`source venv/bin/activate`)
-4. Install Material for MkDocs (`pip install mkdocs-material`)
-5. Serve MkDocs Locally (`mkdocs serve`)
+4. Install the documentation dependencies (`pip install -r requirements.txt`)
+5. Serve MkDocs locally (`mkdocs serve --livereload`)
 
 <p align="right">(<a href="#readme-top">back to top</a>)</p>
 
@@ -138,4 +138,3 @@ FutureProofHomes  - [Website](https://futureproofhomes.net/) - hello@futureproof
 [linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge&logo=linkedin&colorB=555
 [linkedin-url]: https://linkedin.com/in/linkedin_username
 
-

docs/assets/mount_antenna_to_core.png

@@ -1,27 +1,45 @@
-The Satellite1 Dev Kit comes in two pieces:
+## Included Components
+
+The Satellite1 Dev Kit comes in three pieces:
 
 1. The "Hat" (round board)
 2. The "Core" (rectangular board)
+3. The Satellite1.1 external WiFi antenna
+
+## Hardware Assembly
+
+### Step 1: Attach the External Antenna
+
+!!! note
+
+    All dev kits ordered on or after February 17, 2026 include an external antenna for improved Wi-Fi strength. This antenna is required to connect the board to Wi-Fi. If the included antenna is too large for your setup, you can use a smaller antenna with an IPEX connector.
 
-You'll notice a standard Raspberry Pi 40-pin header on the Hat board (marked in red). Carefully align the Core board's 2 rows of pins with the Hat's 40 pin connector and press them together.
+Press the antenna connector onto the connector on the Core board next to the ESP32 chip.
+
+![Attach antenna to Core board](assets/mount_antenna_to_core.png){ width="100%" }
+
+### Step 2: Attach the Core to the Hat
+
+Locate the Raspberry Pi standard 40-pin header on the Hat board. Carefully align the Core board's two rows of pins with the Hat's 40-pin connector, then press the boards together.
 
 !!! note "Press Firmly!"
 
-    The 40-pin should poke through the top of the HAT so that it feels like reading braille with your fingers.
+    The pins should protrude through the top of the Hat enough to be felt with your fingertips.
+
+![Mount Core to Hat](assets/mount_core_to_hat.png){ width="100%" }
 
-![Mount Core to Hat](/assets/mount_core_to_hat.png){ width="100%" }
+!!! note "Compatibility"
 
-!!! note "FUN FACT!"
+    The Satellite1 Hat board can also be mounted to a Raspberry Pi Zero 2 W. Raspberry Pi firmware support is still in development. If you want to help test it, find us in the Discord community.
 
-    By design you can mount the Satellite1 Hat board to a Raspberry Pi Zero 2W.  And yes, we're working on RPI firmware. :) If you're a serious developer and want to help please find us in the Discord community.
+### Step 3: Power Up
 
-## First Boot - Powering On
+!!! warning "Use the Correct USB-C Port"
 
-1. Plug-in to the Hat's USB-C port labeled "CORE/ESP" using the 30W USB-C power adapter & cable supplied in your dev kit.
-    1. !!! warning "Use correct USB-C port"
-        If you plug-in to the "XMOS" port you will not hear audio from the Sat1's amplifier to your speaker.
+    If you plug into the port labeled "XMOS", you will not hear audio from the Sat1 amplifier.
 
+1. Plug in to the Hat's USB-C port labeled "CORE/ESP" using the 30 W USB-C power adapter and cable supplied with your dev kit.
 
-2. Upon first boot, you will see a blue LEDs count down clockwise as the device flashes the XMOS audio processor.
+2. On first boot, the blue LEDs will count down clockwise while the device flashes the XMOS audio processor.
 
-3. Finally, the LEDs will begin to sparkle a warm white color. Congratulations! [Click here to connect your Satellite1 to Home Assistant.](satellite1-connecting-to-ha.md)
+3. When the LEDs begin sparkling warm white, the device is ready. Continue to [Connect Your Satellite1 to Home Assistant](satellite1-connecting-to-ha.md).