+ π Before you begin, ensure you have all the necessary hardware listed in the SPARROW Bill of Materials (BOM) below: πCLICK TO EXPAND
+
+The following list represents our **recommended Bill of Materials** for assembling SPARROW devices. Components listed under the **Tested & Recommended** column are those on which the official assembly guide was developed and validated.
+
+If you choose alternative components, please be aware that additional steps may be required and potential compatibility issues could arise.
+
+This curated list is designed to simplify the process for beginners and those with limited hardware experience, ensuring a smoother build and reliable performance.
+
+
+
+| **System** | **Item** | **Description** | **Qty** | **Tested/Recommended** |
+| -------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Brain | NVIDIA Jetson Orin Nano Super Developer Kit | AI Edge Compute Device | 1 | NVIDIA Jetson Orin Nano Super Developer Kit |
+| | 2TB PCIe Gen 4 NVMe M.2 Internal Solid State Hard Drive | 2TB SSD Drive | 1 | Samsung 980 PRO SSD MZ-V8P2T0CW |
+| | Pi 3 Click Shield | Pi 3 Click Shield converts the GPIO pins on the NVIDIA Jetson Orin Nano into two mikroBUSβ’ sockets | 1 | MIKROE-2756 |
+| | mikroBUS Shuttle | Mikroe Shuttle is a small add-on board, which is intended to be used with Shuttle click, in order to expand the mikroBUSβ’ with additional stacking options. | 4 | MIKROE-2882 |
+| | mikroBUS Shuttle Click | Shuttle click is a mikroBUS socket expansion board, which provides an easy and elegant solution for stacking up to four click boards\\ on a single mikroBUS | 2 | MIKROE-2880 |
+| | DS3231M I2C Board | Real-time clock module which has an extremely low power consumption, allowing it to be used with a single button cell battery, for an extended period of time | 1 | MIKROE-3770 |
+| | BME688 I2C Board | Compact add-on board that contains a four-in-one environmental measurement solution | 1 | MIKROE-4893 |
+| | SHTC3 I2C Board | The SHTC3 sensors offers the complete measurement system: capacitive RH sensor, bandgap thermal sensor, analog and digital data processing, and the I2C communication interface | 1 | MIKROE-3331 |
+| | I2C Relay Board | Relay board featuring at least one SRD-5VDC-SL-C relays | 1 | MIKROE-3357 |
+| | | | | |
+| Power | 24V 15A MPPT Solar Charge Controller | 24V 15A (at least) MPPT solar charge controller with load output control and usb interface | 1 | Victron Smart Solar MPPT 100V/20A SCC110020160R |
+| | USB Solar Charge Controller Interface | Direct to USB interface connection to devices with a USB port | 1 | Victron Energy VE.Direct to USB interface ASS030530010 |
+| | 100 Watt Solar Panels Monocrystalline Solar Panel | 100 Watt Monocrystalline Solar Panel (at least 2 required working in a 24V matrix) | 2 | ECO-WORTHY 100 Watt Solar Panel US-L02M100-B-1 |
+| | 10AWG Solar Extension Cable 30A/1000V DC PV004, IP67 | Cables that go from the Solar Panels to the Solar Charge Controller (overall length subject to installation) | 1 | ECO-WORTHY 10FT 10AWG Solar Extension Cable 30A/1000V DC, IP67 Waterproof with Compatible Quick Connectors |
+| | 45in Solar Panel Mount Brackets | 45in Solar Panel Mount Brackets, with Foldable Tilt Legs Suitable for 2pcs 100W | 1 | ECO-WORTHY 45in Solar Panel Mount Brackets US-L03TYNSJZJ4-1 |
+| | 24V 50Ah or 100Ah LifePo4 Battery | 24V 50AhΒ 100Ah LifePo4 Battery (capacitiy depending on deployment conditions/location) | 1 | ECO-WORTHY 24V 100Ah LiFePO4 Lithium Battery US-L13070402010-1 |
+| | SAE to O Ring 10AWG Battery Connector Terminal | Fused Battery Cable that goes from the Battery (O-Ring) to the Solar Controller Battery Cable (SAE) | 1 | iGreely 10 Gauge Wire SAE to O Ring Terminal |
+| | 10AWG Solar Panel Connector Cable | Solar Controller Battery Cable (SAE), 10AWG SAE to PV Male & Female Adapter (overall length subject to installation, see assembly instructions on how to modify for this use case) | 1 | iGreely Solar Panel Connector Cable, 10AWG SAE to Male & Female Adapter |
+| | | | | |
+| Build | Outdoor Weatherproof IP65 Electrical Junction Box | Outdoor Weatherproof IP65 Electrical Junction Box, Ventilated Design,Β Use with Mounting Panel & Hinged Cover. Size: 17"x13"x7" | 1 | ANIMACYN Electrical Junction Box, Ventilated Design, Cable Grommets, Indoor/Outdoor Use with Mounting Panel & Hinged Cover. Waterproof IP 65. (Grey Cover, 17.7"x13.7"x7.9") |
+| | 18AWG Speaker Wire (Black+Red) | 18AWG Copper Clad Aluminum Speaker Wire (Black + Red) | 1 | GEARit GEARit Speaker Wire 18 Gauge, Speaker Cable 18AWG |
+| | Displayport Headless EDID Dongle | Displayport monitor emulator required to guarantee image output during remote control of Jetson unit | 1 | BKFK dp Dummy Plug - Display to hdmi Adapter, Luna Display Virtual Window for Home-edid Emulator-Dummy, displayport Headless dummie dongle(DP-1P) |
+| | 5.5mm x 2.5mm 90 Degree Right Angle DC Barrel Male Plug Jack | 5.5mm x 2.5mm 90 Degree Right Angle DC Barrel Plug to Power the Jetson Unit | 1 | Fancasee DC Power Pigtail Cable, 10-Pack 5.5mm x 2.5mm 90 US-CAB-65 |
+| | 5.5mm x 2.1mm DC Female Plug to Bare Wire | Starlink Mini Power DC Female Plug (you can use either a DC female plug to bare wire, or a fully assembled pig tail) | 1 | Tonton 16AWG DC Power Pigtails Cable - 3.3FT, Pure Copper, Orange - 5.5mm x 2.1mm DC Female Plug to Bare Wire Open End |
+| | Zip Ties Assorted Size | Zip Ties Assorted Size, Double Sided Toothed,Heavy Duty Cable Wire Ties | 1 | JIANYANG Zip Ties Assorted Size, 8+12+14+18 Inch |
+| | 10FT USB A to Micro USB Cable | Long Micro USB cable for the Audiomoth | 1 | MOVOYEE Long 10FT USB to Micro USB Cable |
+| | PG7 PG9 PG11 PG13.5 PG16 PG19 Weatherproof Cable Gland Connectors | Weatherproof Cable Gland Connectors to route the cables going in and out of the electrical Junction Box | 1 | LISTENJIALE Cable Gland Waterproof 50 pcs |
+| | | | | |
+| Network | STARLINK Mini Kit | STARLINK Mini Kit - High-Speed Portable Internet for Remote and Mobile Use | 1 | Starlink Mini Antenna Kit |
+| | Starlink Ethernet Adapter RJ45 Coupler Waterproof Compatible | Weatherproof Starlink Compatible RJ45 Coupler | 1 | EAZUSE RJ45 Starlink Ethernet Adapter Gen 3/Mini |
+| | Cat 6 Outdoor Ethernet Cable from Jetson to Starlink | Cat 6 Outdoor Ethernet Cable, 24AWG 10Gbps Waterproof Direct Burial LLDPE UV Jacket (overall length subject to installation) | 1 | VOIETOLT Cat 6 Outdoor Ethernet Cable 30 ft, 24AWG 10Gbps Cat6 Cable Cord Waterproof Direct Burial LLDPE UV Jacket |
+| | 2X WiFi Antenna with MHF4/IPEX to RP-SMA Pigtail Antenna WiFi Cable | Pair of 6dBi Dual Band WiFi RP-SMA Male Antenna +2 x 35CM RP-SMA IPEX MHF4 Pigtail Cable for M.2 NGFF WiFi WLAN Card | 1 | HIGHFINE 2 x 6dBi 2.4GHz 5GHz Dual Band WiFi RP-SMA Male Antenna+2 x 35CM RP-SMA IPEX MHF4 Pigtail Cable for M.2 NGFF WiFi WLAN Card |
+| Optional | 10dBi Long Range Outdoor WiFi Fiberglass Antenna | Optional upgrade to improve overall WiFi Range. Requires additional glands to route the cables through the Junction Box Case, \*\*IMPORTANT NOTE: MHF4/IPEX to RP-SMA Pigtail Antenna WiFi Cable is REQUIRED and must be purchased separately\*\* | 2 | eifagur 10dBi Long Range Dual Band WiFi 2.4GHz 5GHz Fiberglass Antenna |
+| | | | | |
+| Audio | AudioMoth Dev Case | Weatherproof AudioMoth Case | 1 | AudioMoth Dev Case |
+| | AudioMoth Dev Board | AudioMoth Dev board | 1 | AudioMoth Dev Board |
+| | | | | |
+| Camera | 2.4Ghz Solar WiFi Security Camera | Solar Weatherproof WiFi Cameras to be used as the SPARROW Camera Traps (you can use up to 150 cams per SPARROW main unit) | 1 | Reolink Argus Eco+ |
+
+
+
+
+
+To download a PDF version of this BOM list, please visit π [aka.ms/sparrowbom](https://aka.ms/sparrowbom)
+
+SPARROW Bill of Materials (BOM) Β© 2025 by Microsoft is licensed under MIT.
+π To view a copy of this license, visit: [MIT License](https://mit-license.org/)
+
+### β οΈ Important Note on Alternative IΒ²C Boards
+If you choose to use generic IΒ²C boards, please be aware that some modifications to the device address in the code π may be necessary. Different vendors often assign addresses that vary from those provided in this release.
+For simplicity and flexibility, we adopted the Mikroe MikroBUS standard β
, which greatly reduces the barrier to entry thanks to its ease of assembly π§ and standardized interface.
+Our assembly guide π was drafted using Mikroe Click boards, so if you opt for generic IΒ²C boards, expect additional steps not covered in the guide. This approach is recommended only for advanced users π οΈ familiar with hardware integration and troubleshooting.
+
+Generic boards may require custom wiring and code adjustments beyond what is documented here.
+
+π‘ Tip: To ensure a smooth experience, we strongly recommend starting with MikroBUS-compatible modules unless you have prior technical experience with IΒ²C board assemblies, IΒ²C address mapping and board-specific configurations.
+
+### ποΈ Hardware Assembly Instructions
+Follow this step-by-step guide to assemble your SPARROW device with ease. We designed the process around the Mikroe MikroBUS standard for maximum flexibility and simplicity, reducing the skill barrier for new users. Each step includes clear visuals and tips to ensure proper installation of components like sensors, connectors, and power modules.
+
+β οΈ If you choose alternative boards or custom configurations, additional steps may be required and are not covered in this guide. For best results, start with the recommended components and verify connections before powering up. π
+
+To download the SPARROW Hardware Assembly Guide, please visit π [aka.ms/sparrowassembly](https://aka.ms/sparrowassembly)
+
+SPARROW Assembly and Set-Up Guide Β© 2025 by Microsoft is licensed under MIT.
+π To view a copy of this license, visit: [MIT License](https://mit-license.org/)
+
+---
+
+## β‘ 2. One-click Jetson Setup (Recommended)
+
+The repo contains a Jetson configuration script `sparrow_setup.sh` that installs prerequisites, prepares folders, downloads default Triton models, seeds the DS3231 RTC, configures Wi-Fi hotspot, and launches the SPARROW services.
+
+To send data to the SPARROW dashboard you will need to pair it with your account.
+To create an account and obtain an access key visit:
+[https://dashboard.sparrow-earth.com/](https://dashboard.sparrow-earth.com/)
+
+π [View the SPARROW dashboard Terms & Conditions](https://dev.sparrow-earth.com/agreement)
+
+**Script:** Download the SPARROW setup script from this repo once the hardware assembly and Jetson flash is complete (detailed instructions can be found in the build instructions).
+The setup script should be run from `~/Desktop`.
+
+### βΆοΈ Usage
+
+```bash
+cd ~/Desktop
+sudo chmod +x sparrow_setup.sh
+sudo ./sparrow_setup.sh
+
+```
+
+## What the Script Does
+
+### 1οΈβ£ Prereqs & Tooling
+Installs:
+```
+docker, docker-compose, git, curl, wget, uuidgen, smbus2
+```
+
+### 2οΈβ£ Device Identity
+Generates `/etc/unique_id` if missing (single-line UUID).
+
+### 3οΈβ£ Folder Layout (Host)
+Creates `~/Desktop/system` with:
+```
+/system
+βββ docker-compose.yml
+βββ sparrow_setup.sh
+βββ Models/
+β βββ tritonserver/
+β βββ model_repository/
+β βββ megadetectorv6/
+β β βββ 1/
+β β β βββ model.onnx
+β β βββ config.pbtxt
+β βββ AI4GAmazonClassification/
+β β βββ 1/
+β β β βββ model.onnx
+β β βββ config.pbtxt
+β βββ megadetector_birds_v1/
+β βββ 1/
+β β βββ model.onnx
+β βββ config.pbtxt
+βββ sparrow/
+β βββ Dockerfile
+β βββ config/
+β β βββ access_key.txt
+β βββ images/
+β βββ recordings/
+β βββ logs/
+β βββ static/
+β βββ data/
+β βββ gallery/
+βββ starlink/
+ βββ Dockerfile.starlink
+ βββ config/
+ β βββ access_key.txt
+ βββ logs/
+
+```
+
+### 4οΈβ£ Models + Configs
+Downloads three default ONNX models from Zenodo and writes minimal `config.pbtxt` for each Triton repo.
+
+### 5οΈβ£ Access Key
+Prompts for the server access key (obtained from the SPARROW dashboard) and writes it to:
+```
+sparrow/config/access_key.txt
+starlink/config/access_key.txt
+```
+
+### 6οΈβ£ RTC Seeding (DS3231 over I2C bus 7)
+Gets UTC from WorldClock API (fallback: NTP or system UTC) and writes it to the RTC.
+
+### 7οΈβ£ Wi-Fi Hotspot
+Configures a persistent hotspot via NetworkManager:
+**SSID:** `CameraTraps`
+**Password:** `User prompted`
+
+### 8οΈβ£ Docker Build & Launch
+Builds images with BuildKit (no cache), runs `docker-compose up -d`, and tails logs.
+
+---
+
+# 𧩠Software Dependencies
+
+All Python dependencies are inside the containers (no host Python required):
+
+1. `PyTorch`, `torchaudio`, `tritonclient`, `aiosmtpd`, `psutil`, `smbus2`, `pyserial`, etc.
+2. **NVIDIA Triton Inference Server** (explicit model control mode)
+3. **Hardware:** I2C, ALSA audio, and USB serial (compose is configured privileged)
+
+---
+
+# π API References
+
+The client calls these endpoints on `SERVER_BASE_URL`:
+
+| Endpoint | Description |
+|-----------|--------------|
+| `/uploads` | Image + detection metadata |
+| `/audio_uploads` | WAV audio files |
+| `/system_metrics` | System + sensor metrics JSON |
+| `/get_schedule` | Starlink sleep window |
+| `/get_scheduleaudio` | Audio capture settings |
+| `/model_settings` | Classification model + labels |
+| `/model_update` | Triton model manifest |
+
+Each request includes `auth_key` and a `unique_id` derived from `/etc/unique_id`.
+
+---
+
+# π€ Contributing
+
+This project welcomes contributions and suggestions. Most contributions require you to agree to a
+Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
+the rights to use your contribution. For details, visit [Contributor License Agreements](https://cla.opensource.microsoft.com).
+
+When you submit a pull request, a CLA bot will automatically determine whether you need to provide
+a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions
+provided by the bot. You will only need to do this once across all repos using our CLA.
+
+This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
+For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
+contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
+
+---
+
+# βοΈ SPARROW FAQs
+
