docs(jetson): reorganize the Jetson docs around setup and developer paths

SUMMARY.md

@@ -19,30 +19,36 @@
   * [DroneCAN GUI Tool Guide](knowledge-base/dronecan-gui-tool-guide.md)
   * [PX4 Log Encryption](knowledge-base/px4-log-encryption.md)
   * [PX4 Setup](knowledge-base/px4-setup.md)
+  * [USB Peripherals](knowledge-base/usb-peripherals.md)
+
+## Software
+
+* [ARK-OS](ark-os/README.md)
+  * [Services](ark-os/services.md)
+  * [Apt: Hold Back Risky Packages](ark-os/apt-hold-back.md)
 
 ## Products
 
 * [Embedded Computers](embedded-computers/README.md)
   * [ARK Just A Jetson](embedded-computers/ark-just-a-jetson/README.md)
-    * [Getting Started](embedded-computers/ark-just-a-jetson/getting-started.md)
-    * [ARK-OS](embedded-computers/ark-just-a-jetson/ark-services/README.md)
-      * [Services](embedded-computers/ark-just-a-jetson/ark-services/services.md)
-    * [Connections](embedded-computers/ark-just-a-jetson/connections.md)
-    * [USB-C Console](embedded-computers/ark-just-a-jetson/usb-c-console.md)
-    * [Camera Overlays](embedded-computers/ark-just-a-jetson/camera-overlays.md)
-    * [Flashing Guide](embedded-computers/ark-just-a-jetson/flashing-guide.md)
-    * [Pinout](embedded-computers/ark-just-a-jetson/pinout.md)
-    * [Block Diagram](embedded-computers/ark-just-a-jetson/block-diagram.md)
-    * [3D Model](embedded-computers/ark-just-a-jetson/3d-model.md)
-    * [IMU ICM-42688P Guide](embedded-computers/ark-just-a-jetson/imu-icm-42688p-guide.md)
-    * [INA238 Power Monitor Guide](embedded-computers/ark-just-a-jetson/ina238-power-monitor-guide.md)
-    * [GPIO Control](embedded-computers/ark-just-a-jetson/gpio-control.md)
-    * [Updating the Flight Controller Firmware](embedded-computers/ark-just-a-jetson/updating-the-flight-controller-firmware.md)
-    * [Power Cycling USB Ports](embedded-computers/ark-just-a-jetson/power-cycling-usb-ports.md)
-    * [USB Wi-Fi Adapters](embedded-computers/ark-just-a-jetson/usb-wi-fi-adapters.md)
-    * [USB Bluetooth Adapters](embedded-computers/ark-just-a-jetson/usb-bluetooth-adapters.md)
-    * [USB Cameras and GPS](embedded-computers/ark-just-a-jetson/usb-cameras-and-gps.md)
-    * [Apt Upgrade Hold Back Risky Packages](embedded-computers/ark-just-a-jetson/apt-upgrade-hold-back-risky-packages.md)
+    * [Set Up Your Jetson](embedded-computers/ark-just-a-jetson/setup/README.md)
+      * [Connect](embedded-computers/ark-just-a-jetson/setup/connect.md)
+      * [Get Online](embedded-computers/ark-just-a-jetson/setup/get-online.md)
+    * [Using ARK-OS](embedded-computers/ark-just-a-jetson/using-ark-os.md)
+      * [Updating the Flight Controller Firmware](embedded-computers/ark-just-a-jetson/updating-the-flight-controller-firmware.md)
+    * [Hardware Reference](embedded-computers/ark-just-a-jetson/hardware.md)
+      * [Pinout](embedded-computers/ark-just-a-jetson/pinout.md)
+      * [Ports and Serial](embedded-computers/ark-just-a-jetson/connections.md)
+      * [IMU ICM-42688P Guide](embedded-computers/ark-just-a-jetson/imu-icm-42688p-guide.md)
+      * [INA238 Power Monitor Guide](embedded-computers/ark-just-a-jetson/ina238-power-monitor-guide.md)
+      * [Block Diagram](embedded-computers/ark-just-a-jetson/block-diagram.md)
+      * [3D Model](embedded-computers/ark-just-a-jetson/3d-model.md)
+      * [GPIO Control](embedded-computers/ark-just-a-jetson/gpio-control.md)
+      * [Camera Overlays](embedded-computers/ark-just-a-jetson/camera-overlays.md)
+      * [Power Cycling USB Ports](embedded-computers/ark-just-a-jetson/power-cycling-usb-ports.md)
+    * [Developer Guide](embedded-computers/ark-just-a-jetson/developer.md)
+      * [Flashing Guide](embedded-computers/ark-just-a-jetson/flashing-guide.md)
+      * [USB-C Console](embedded-computers/ark-just-a-jetson/usb-c-console.md)
   * [ARK Just a Pi](embedded-computers/ark-just-a-pi/README.md)
     * [Getting Started](embedded-computers/ark-just-a-pi/getting-started.md)
     * [Flashing Guide](embedded-computers/ark-just-a-pi/flashing-guide/README.md)
@@ -74,48 +80,46 @@
     * [3D Models and Case Files](flight-controller/ark-pixhawk-autopilot-bus-carrier/3d-models-and-case-files.md)
     * [Pinout](flight-controller/ark-pixhawk-autopilot-bus-carrier/pinout.md)
     * [PX4 Instructions](flight-controller/ark-pixhawk-autopilot-bus-carrier/px4-instructions.md)
-  * [Jetson PABs](products/flight-controller/jetson-pabs/README.md)
-    * [ARK Jetson PAB Carrier](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier/README.md)
-      * [Getting Started](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier/getting-started.md)
-      * [ARK-OS](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier/ark-services/README.md)
-        * [Services](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier/ark-services/services.md)
-      * [Autopilot Connections](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier/autopilot-connections/README.md)
-        * [QGroundControl Connection](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier/autopilot-connections/qgroundcontrol-connection.md)
-        * [MissionPlanner ArduPilot Connection](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier/autopilot-connections/missionplanner-ardupilot-connection.md)
-      * [Updating the Flight Controller Firmware](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier/updating-the-flight-controller-firmware.md)
-      * [Camera Overlays](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier/camera-overlays.md)
-      * [Flashing Guide](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier/flashing-guide.md)
-      * [Pinout](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier/pinout.md)
-      * [Block Diagram](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier/block-diagram.md)
-      * [3D Models and Case Files](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier/3d-models-and-case-files.md)
-      * [Micro USB Console](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier/micro-usb-console.md)
-      * [Mini DisplayPort](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier/mini-displayport.md)
-      * [GPIO Control](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier/gpio-control.md)
-      * [Power Cycling USB Ports](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier/power-cycling-usb-ports.md)
-      * [USB Wi-Fi Adapters](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier/usb-wi-fi-adapters.md)
-      * [USB Bluetooth Adapters](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier/usb-bluetooth-adapters.md)
-      * [USB Cameras and GPS](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier/usb-cameras-and-gps.md)
-      * [Apt Upgrade Hold Back Risky Packages](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier/apt-upgrade-hold-back-risky-packages.md)
-    * [ARK Jetson PAB Carrier V3](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/README.md)
-      * [Getting Started](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/getting-started.md)
-      * [ARK-OS](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/ark-services/README.md)
-        * [Services](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/ark-services/services.md)
-      * [Autopilot Connections](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/autopilot-connections/README.md)
-        * [QGroundControl Connection](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/autopilot-connections/qgroundcontrol-connection.md)
-        * [MissionPlanner ArduPilot Connection](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/autopilot-connections/missionplanner-ardupilot-connection.md)
-      * [Updating the Flight Controller Firmware](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/updating-the-flight-controller-firmware.md)
-      * [Camera Overlays](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/camera-overlays.md)
-      * [Flashing Guide](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/flashing-guide.md)
-      * [Pinout](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/pinout.md)
-      * [Block Diagram](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/block-diagram.md)
-      * [3D Model](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/3d-models-and-case-files.md)
-      * [USB-C Console](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/micro-usb-console.md)
-      * [GPIO Control](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/gpio-control.md)
-      * [Power Cycling USB Ports](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/power-cycling-usb-ports.md)
-      * [USB Wi-Fi Adapters](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/usb-wi-fi-adapters.md)
-      * [USB Bluetooth Adapters](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/usb-bluetooth-adapters.md)
-      * [USB Cameras and GPS](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/usb-cameras-and-gps.md)
-      * [Apt Upgrade Hold Back Risky Packages](products/flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/apt-upgrade-hold-back-risky-packages.md)
+  * [Jetson PABs](flight-controller/jetson-pabs/README.md)
+    * [ARK Jetson PAB Carrier](flight-controller/jetson-pabs/ark-jetson-pab-carrier/README.md)
+      * [Set Up Your Carrier](flight-controller/jetson-pabs/ark-jetson-pab-carrier/setup/README.md)
+        * [Connect](flight-controller/jetson-pabs/ark-jetson-pab-carrier/setup/connect.md)
+        * [Get Online](flight-controller/jetson-pabs/ark-jetson-pab-carrier/setup/get-online.md)
+      * [Using ARK-OS](flight-controller/jetson-pabs/ark-jetson-pab-carrier/using-ark-os.md)
+        * [Autopilot Connections](flight-controller/jetson-pabs/ark-jetson-pab-carrier/autopilot-connections/README.md)
+          * [QGroundControl Connection](flight-controller/jetson-pabs/ark-jetson-pab-carrier/autopilot-connections/qgroundcontrol-connection.md)
+          * [MissionPlanner ArduPilot Connection](flight-controller/jetson-pabs/ark-jetson-pab-carrier/autopilot-connections/missionplanner-ardupilot-connection.md)
+        * [Updating the Flight Controller Firmware](flight-controller/jetson-pabs/ark-jetson-pab-carrier/updating-the-flight-controller-firmware.md)
+      * [Hardware Reference](flight-controller/jetson-pabs/ark-jetson-pab-carrier/hardware.md)
+        * [Pinout](flight-controller/jetson-pabs/ark-jetson-pab-carrier/pinout.md)
+        * [Mini DisplayPort](flight-controller/jetson-pabs/ark-jetson-pab-carrier/mini-displayport.md)
+        * [Block Diagram](flight-controller/jetson-pabs/ark-jetson-pab-carrier/block-diagram.md)
+        * [3D Models and Case Files](flight-controller/jetson-pabs/ark-jetson-pab-carrier/3d-models-and-case-files.md)
+        * [GPIO Control](flight-controller/jetson-pabs/ark-jetson-pab-carrier/gpio-control.md)
+        * [Camera Overlays](flight-controller/jetson-pabs/ark-jetson-pab-carrier/camera-overlays.md)
+        * [Power Cycling USB Ports](flight-controller/jetson-pabs/ark-jetson-pab-carrier/power-cycling-usb-ports.md)
+      * [Developer Guide](flight-controller/jetson-pabs/ark-jetson-pab-carrier/developer.md)
+        * [Flashing Guide](flight-controller/jetson-pabs/ark-jetson-pab-carrier/flashing-guide.md)
+        * [Micro USB Console](flight-controller/jetson-pabs/ark-jetson-pab-carrier/micro-usb-console.md)
+    * [ARK Jetson PAB Carrier V3](flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/README.md)
+      * [Set Up Your Carrier](flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/setup/README.md)
+        * [Connect](flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/setup/connect.md)
+        * [Get Online](flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/setup/get-online.md)
+      * [Using ARK-OS](flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/using-ark-os.md)
+        * [Autopilot Connections](flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/autopilot-connections/README.md)
+          * [QGroundControl Connection](flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/autopilot-connections/qgroundcontrol-connection.md)
+          * [MissionPlanner ArduPilot Connection](flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/autopilot-connections/missionplanner-ardupilot-connection.md)
+        * [Updating the Flight Controller Firmware](flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/updating-the-flight-controller-firmware.md)
+      * [Hardware Reference](flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/hardware.md)
+        * [Pinout](flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/pinout.md)
+        * [Block Diagram](flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/block-diagram.md)
+        * [3D Model](flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/3d-models-and-case-files.md)
+        * [GPIO Control](flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/gpio-control.md)
+        * [Camera Overlays](flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/camera-overlays.md)
+        * [Power Cycling USB Ports](flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/power-cycling-usb-ports.md)
+      * [Developer Guide](flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/developer.md)
+        * [Flashing Guide](flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/flashing-guide.md)
+        * [USB-C Console](flight-controller/jetson-pabs/ark-jetson-pab-carrier-v3/micro-usb-console.md)
   * [ARK Pi6X Flow](flight-controller/ark-pi6x-flow/README.md)
     * [Block Diagram](flight-controller/ark-pi6x-flow/block-diagram.md)
     * [Pinout](flight-controller/ark-pi6x-flow/pinout.md)
@@ -242,15 +246,15 @@
     * [Pinout](accessories/ark-servo-expander/pinout.md)
     * [PX4 Instructions](accessories/ark-servo-expander/px4-instructions.md)
     * [3D Model](accessories/ark-servo-expander/3d-model.md)
-  * [ARK Secondary Avionics Adapter](products/accessories/ark-secondary-avionics-adapter/README.md)
-    * [Pinout](products/accessories/ark-secondary-avionics-adapter/pinout.md)
-    * [3D Model](products/accessories/ark-secondary-avionics-adapter/3d-model.md)
-  * [ARK Primary Avionics Adapter](products/accessories/ark-primary-avionics-adapter/README.md)
-    * [Pinout](products/accessories/ark-primary-avionics-adapter/pinout.md)
-    * [3D Model](products/accessories/ark-primary-avionics-adapter/3d-model.md)
-  * [ARK Pixhawk Payload Bus Breakout](products/accessories/ark-pixhawk-payload-bus-breakout/README.md)
-    * [Pinout](products/accessories/ark-pixhawk-payload-bus-breakout/pinout.md)
-    * [3D Model](products/accessories/ark-pixhawk-payload-bus-breakout/3d-model.md)
+  * [ARK Secondary Avionics Adapter](accessories/ark-secondary-avionics-adapter/README.md)
+    * [Pinout](accessories/ark-secondary-avionics-adapter/pinout.md)
+    * [3D Model](accessories/ark-secondary-avionics-adapter/3d-model.md)
+  * [ARK Primary Avionics Adapter](accessories/ark-primary-avionics-adapter/README.md)
+    * [Pinout](accessories/ark-primary-avionics-adapter/pinout.md)
+    * [3D Model](accessories/ark-primary-avionics-adapter/3d-model.md)
+  * [ARK Pixhawk Payload Bus Breakout](accessories/ark-pixhawk-payload-bus-breakout/README.md)
+    * [Pinout](accessories/ark-pixhawk-payload-bus-breakout/pinout.md)
+    * [3D Model](accessories/ark-pixhawk-payload-bus-breakout/3d-model.md)
 * [Airframes](airframes/README.md)
   * [ARK RIG5](airframes/ark-rig5.md)
   * [ARK RIG7](airframes/ark-rig7.md)

accessories/README.md

@@ -2,16 +2,16 @@
 
 ARK add-on boards and peripheral accessories.
 
-{% content-ref url="../products/accessories/ark-pixhawk-payload-bus-breakout/" %}
-[ark-pixhawk-payload-bus-breakout](../products/accessories/ark-pixhawk-payload-bus-breakout/)
+{% content-ref url="../accessories/ark-pixhawk-payload-bus-breakout/" %}
+[ark-pixhawk-payload-bus-breakout](../accessories/ark-pixhawk-payload-bus-breakout/)
 {% endcontent-ref %}
 
-{% content-ref url="../products/accessories/ark-primary-avionics-adapter/" %}
-[ark-primary-avionics-adapter](../products/accessories/ark-primary-avionics-adapter/)
+{% content-ref url="../accessories/ark-primary-avionics-adapter/" %}
+[ark-primary-avionics-adapter](../accessories/ark-primary-avionics-adapter/)
 {% endcontent-ref %}
 
-{% content-ref url="../products/accessories/ark-secondary-avionics-adapter/" %}
-[ark-secondary-avionics-adapter](../products/accessories/ark-secondary-avionics-adapter/)
+{% content-ref url="../accessories/ark-secondary-avionics-adapter/" %}
+[ark-secondary-avionics-adapter](../accessories/ark-secondary-avionics-adapter/)
 {% endcontent-ref %}
 
 {% content-ref url="ark-servo-expander/" %}

products/accessories/ark-pixhawk-payload-bus-breakout/README.md → accessories/ark-pixhawk-payload-bus-breakout/README.md

@@ -2,7 +2,7 @@
 description: >-
   Pixhawk Payload Bus to Pixhawk-standard JST-GH, with a protected 5 V
   peripheral rail.
-cover: ../../../.gitbook/assets/IMG_6529 edited.JPG
+cover: ../../.gitbook/assets/IMG_6529 edited.JPG
 coverY: 0
 ---
 

products/accessories/ark-primary-avionics-adapter/README.md → accessories/ark-primary-avionics-adapter/README.md

@@ -1,6 +1,6 @@
 ---
 description: A simple 40 pin Molex Pico-Clasp to Pixhawk Standard JST-GH Connectors.
-cover: ../../../.gitbook/assets/IMG_6417 edited.JPG
+cover: ../../.gitbook/assets/IMG_6417 edited.JPG
 coverY: 0
 ---
 

products/accessories/ark-secondary-avionics-adapter/README.md → accessories/ark-secondary-avionics-adapter/README.md

@@ -1,6 +1,6 @@
 ---
 description: A simple 40 pin Molex Pico-Clasp to Pixhawk Standard JST-GH Connectors.
-cover: ../../../.gitbook/assets/IMG_6459 edited.JPG
+cover: ../../.gitbook/assets/IMG_6459 edited.JPG
 coverY: 0
 ---
 

embedded-computers/ark-just-a-jetson/ark-services/README.md → ark-os/README.md

@@ -6,7 +6,7 @@
 
 The web UI is served at [http://jetson.local](http://jetson.local) (or the Jetson's IP). Pages: **System** (hardware and resource info, hostname), **Autopilot** (status, firmware update, reset), **Connections** (WiFi/Ethernet/LTE, data usage), **Services** (start/stop, autostart, logs, config editing), **Video** (live camera stream), and **Logs** (flight log download and upload to Flight Review).
 
-<figure><img src="../../../.gitbook/assets/ark-ui-services.png" alt=""><figcaption><p>Services page — start/stop services, toggle autostart, view logs, edit configs</p></figcaption></figure>
+<figure><img src="../.gitbook/assets/ark-ui-services.png" alt=""><figcaption><p>Services page — start/stop services, toggle autostart, view logs, edit configs</p></figcaption></figure>
 
 ## Services
 

embedded-computers/ark-just-a-jetson/apt-upgrade-hold-back-risky-packages.md → ark-os/apt-hold-back.md

@@ -21,4 +21,4 @@ sudo apt-mark unhold <package>
 sudo apt upgrade <package>
 ```
 
-To move to a newer JetPack release, re-flash with the latest ARK image instead of upgrading in place — see the [Flashing Guide](flashing-guide.md).
+To move to a newer JetPack release, re-flash with the latest ARK image instead of upgrading in place — see your carrier's Flashing Guide.

embedded-computers/ark-just-a-jetson/README.md

@@ -7,4 +7,15 @@ coverY: 0
 
 The ARK Just A Jetson (JAJ) is a compact carrier board for the NVIDIA Jetson Orin NX/Nano module. It provides essential connectivity including USB-C, Ethernet, WiFi/Bluetooth, CSI camera, CAN bus, and GPIO in a minimal form factor.
 
-See the [Getting Started](getting-started.md) guide to begin using your ARK Just A Jetson.
+## Where to Start
+
+**Your bundle arrived preflashed.** It already runs ARK-OS. Go to [Set Up Your Jetson](setup/), then manage it from the ARK-UI web interface.
+
+**You have a bare board, or you want to flash it yourself.** Install a Jetson module and NVMe SSD, then start at the [Flashing Guide](flashing-guide.md).
+
+## Sections
+
+* [Set Up Your Jetson](setup/) — connect to it and get it on your network
+* [Using ARK-OS](using-ark-os.md) — the preinstalled services and web interface
+* [Hardware Reference](hardware.md) — pinout, GPIO, cameras, onboard sensors
+* [Developer Guide](developer.md) — flashing, serial console, building from source