[#74775] Added jetpack 6.x links

zakrent · pkatarzynski · commit ee9d6446c9a5 · 2025-05-05T17:35:43.000+02:00
diff --git a/doc/requirements.txt b/doc/requirements.txt
@@ -1,3 +1,4 @@
 https://github.com/antmicro/antmicro-sphinx-utils/archive/main.zip
 sphinx_tabs
 sphinx-tippy
+sphinx-inline-tabs
diff --git a/doc/source/board_overview.md b/doc/source/board_overview.md
@@ -10,7 +10,9 @@ You can find out more about the Jetson Orin Baseboard in this [blog article](htt
 * [Open Source Portal](https://opensource.antmicro.com/projects/jetson-orin-baseboard/)
 
 They provide 3D renders and the board stackup definition, as well as an interactive preview of the board schematic.
-A [PDF schematic](https://github.com/antmicro/jetson-orin-baseboard/blob/main/doc/jetson-orin-baseboard-schematic.pdf) of the board is also available.
+
+You can also browse board-specific assets in the GitHub [releases](https://github.com/antmicro/jetson-orin-baseboard/releases) section.
+The assets provided here include PDF schematics and mechanical (STEP) models of the board assemblies in certain revisions.
 
 ## IO map
 
@@ -29,12 +31,11 @@ The board can be powered with the following sources:
 ### 1. DC Connector
 
 Jetson Orin Baseboard can be powered with a stable DC voltage via the on-board locking DC connector ([`J12`](#J12)) with Molex Nano-Fit plug (see the [Power Supply](getting_started.md#power-supply) section for details related to Nano-Fit power harness assembly).
-You can use an external DC adapter for powering the board or a battery pack with rechargeable or non-rechargeable batteries, as long as the provided voltage fits within the accepted range (9-20VDC or up to 15 V on rev. <= 1.1.7).
-Please note that Jetson Orin Baseboard does not support battery charging.
-
-:::{note}
-Since rev. >= 1.3.0, the SOM supply power path is automatically switched between `VCC_IN` and onboard `5V DC-DC` depending on the `MODULE_ID` pin status. For older releases, SOM is supplied from `5V DC-DC`.
-:::
+You can use an external DC adapter for powering the board or a battery pack with rechargeable or non-rechargeable batteries, as long as the provided voltage fits within the accepted range (9-20VDC for board revision >= 1.3.0 and up to 15 V on rev. <= 1.1.7).
+In board revision >= 1.3.0, the power supply voltage provided to the SoM is switched between `VCC_IN` power rail and 5V power rail provided by the on-board step down DC-DC converter depending on the `MODULE_ID` pin status.
+This enables the use of the Jetson Orin NX in "super" mode which requires a minimum power supply voltage of 8V.
+If you plan to power the Jetson Orin Baseboard from a battery pack, please note that battery (re-) charging is currently not supported in the design. 
+Adjusting the power supply scenario for specific battery types and charging strategy can be implemented via a custom modification of the baseboard PCB design. 
 
 ### 2. Power over Ethernet
 
@@ -51,7 +52,7 @@ Those ports are maintained by the on-board USB-C Power Delivery controller (Texa
 This controller needs to be configured in order to make it implement one of the desired power source/sink negotiation scenarios.
 
 :::{note}
-The recommended power supply voltage negotiated with the USB-C PD controller for power sink mode is 15VDC or 20VDC for rev. >= 1.1.8.
+The recommended power supply voltage negotiated with the USB-C PD controller for power sink mode is 20VDC (15VDC for board revisions <= 1.3.0).
 If you plan to power up the Jetson Orin Baseboard through the USB PD source, make sure it meets [power requirements](getting_started.md#2-power-supply) for stable operation.
 :::
 
@@ -63,13 +64,13 @@ You can generate your own configuration file with the [TPS6598X-CONFIG](https://
 Please refer to the Jetson Orin Baseboard [schematics](https://github.com/antmicro/jetson-orin-baseboard/blob/main/doc/jetson-orin-baseboard-schematic.pdf) to identify the USB port and power supply rail associated with it to generate a valid power profile setting while using the `TPS6598X-CONFIG` tool.
 Also please refer to the [TPS65987DDH and TPS65988DH Host Interface Technical Reference Manual](https://www.ti.com/lit/ug/slvubh2b/slvubh2b.pdf) for further details.
 
-There are three ways to upload the configuration:
+There are several ways to write the USB-C PD configuration to the on-board controller:
 * Via an external SPI Flash programmer connected to the [`J9`](#J9)
-* Via the [TPS65988-config tool](https://github.com/antmicro/antmicro-jetson-orin-baseboard-tps65988-config)
-  * From Jetson Orin (user space)
-  * From the USB-C ([`J3`](#J3)) debug console interface port (only for rev. >= 1.1.9)
+* Via the [antmicro-jetson-orin-baseboard-tps65988-config](https://github.com/antmicro/antmicro-jetson-orin-baseboard-tps65988-config) tool
+  * From the Jetson Orin SoM BSP (user space)
+  * From the host (PC) via the USB-C ([`J3`](#J3)) debug console interface port (in baseboard revisions >= 1.1.9)
 
-The recommended and least demanding method is [flashing from the debug console interface port](#tps65988-config-tool-via-the-debug-console-interface-port).
+If you happen to have some of the most recent baseboard revision (>= 1.1.9), the easiest method to use is [flashing from the debug console interface port](#tps65988-config-tool-via-the-debug-console-interface-port).
 
 ### External SPI Flash programmer
 #### 1. Collect the hardware
@@ -153,7 +154,7 @@ Erasing and writing flash chip... Erase/write done.
 Verifying flash... VERIFIED.
 ```
 
- *  You can repeat the previous command to ensure that the binary file has been written successfully:
+ * You can repeat the previous command to ensure that the binary file has been written successfully:
 
 Expected outcome:
 ```
@@ -164,17 +165,17 @@ Erase/write done.
 
 ### TPS65988-config tool from Jetson Orin user space
 
-The TPS65988-config flashing script can be found in this [repository](https://github.com/antmicro/antmicro-jetson-orin-baseboard-tps65988-config).
+The TPS65988-config flashing script can be found in the [antmicro-jetson-orin-baseboard-tps65988-config](https://github.com/antmicro/antmicro-jetson-orin-baseboard-tps65988-config) repository.
 
 #### 1. Prepare hardware
 
-To properly execute this script, boot the Jetson, and connect to it via [debug console](#connect-the-debug-console) or via SSH. Since the PD controller is not yet configured at this point, the baseboard has to be powered from either the [`J12`](#J12) or via PoE connected to the [`J6`](#J6).\
+To properly execute this script, boot the Jetson Orin Baseboard, and connect to it via the [debug console](getting_started.md#connect-the-debug-console) or via SSH. 
+Since the PD controller is not yet configured at this point, the baseboard has to be powered from either the [`J12`](#J12) or via PoE connected to the [`J6`](#J6).
 Internet connection is also suggested.
 
 #### 2. Install dependencies
-Log into Jetson Orin
-
-Clone this [repository](https://github.com/antmicro/antmicro-jetson-orin-baseboard-tps65988-config) and install `smbus2` package with `pip`
+Log into Jetson Orin module.
+Clone the [antmicro-jetson-orin-baseboard-tps65988](https://github.com/antmicro/antmicro-jetson-orin-baseboard-tps65988-config) repository and install the `smbus2` package using `pip`
 
 ```
 git clone https://github.com/antmicro/antmicro-jetson-orin-baseboard-tps65988-config.git
@@ -197,6 +198,7 @@ Write completed 43968 bytes written
 The PD Controller has been flashed successfully
 Performing cold reset
 ```
+
 ### TPS65988-config tool via the debug console interface port
 This option allows for flashing the USB-C Power Delivery controller without SoM or external power.
 
@@ -209,15 +211,15 @@ This option allows for flashing the USB-C Power Delivery controller without SoM
 
 On the host PC:
 
-Clone this [repository](https://github.com/antmicro/antmicro-jetson-orin-baseboard-tps65988-config) and install `smbus2` package with `pip`
+Clone the [antmicro-jetson-orin-baseboard-tps65988-config](https://github.com/antmicro/antmicro-jetson-orin-baseboard-tps65988-config) repository and install the `smbus2` package with `pip`
 
 ```
 git clone https://github.com/antmicro/antmicro-jetson-orin-baseboard-tps65988-config.git
 pip3 install smbus2
 cd antmicro-jetson-orin-baseboard-tps65988-config
 ```
 
-#### 3. Flash the config
+#### 3. Write the configuration
 ```
 python3 TPS65988_flash.py --erase --write ./JOBrev1_1_6.bin --ft230x
 ```
@@ -241,30 +243,5 @@ The overall height of the set depends on the cooling module attached.
 The base setup with a default cooling module is 37 mm or 1.45 inch tall.
 The KiCad PCB design files include mechanical layers with dimensions specified for the fastening holes and notable components.
 The board with the Jetson Module, M.2 storage and cooling module weighs 164g (5.78oz).
-The mechanical STEP model of the Jetson Orin Baseboard is provided in the [1.1.6 design release](https://github.com/antmicro/jetson-orin-baseboard/releases/tag/rev.1.1.6-ch) available on GitHub.
-
-
-## DC-DC converters stress test
-
-Revision `1.1.8` introduced changes to the DC-DC converters that allowed the board to be powered from up to 20V. Below you can find the results from stress test of the two main converters: `Vcc to 5V` and `Vcc to 3V3`. Both of these converters were implemented using the same controller: `SIC431AED-T1-GE3`.
-
-Test were performed under following conditions:
-* Input voltage: 9V, 12V, 15V, 20V
-* Load current: 0A - 13A (Electronic load: `RND 320-KEL103`)
-* Ambient temperature: 24°C
-* Incremental steps of 0.1A between 0.1A - 0.5A, and 1A step between 1A - 13A
-* Input voltage and output load leads were soldered directly to input/output capacitors
-
-:::{figure-md}
-![](img/5V_eff_temp_vs_output_curr.png)
-
-Efficiency, temperature and output voltage versus output current of the `5V` converter
-:::
-
-:::{figure-md}
-![](img/3V3_eff_temp_vs_output_curr.png)
-
-Efficiency, temperature and output voltage  versus output current of the `3V3` converter
-:::
-
+The mechanical STEP models of the Jetson Orin Baseboard in notable revisions are provided in the [releases](https://github.com/antmicro/jetson-orin-baseboard/releases/) sections available on GitHub.
 
diff --git a/doc/source/conf.py b/doc/source/conf.py
@@ -50,6 +50,7 @@
 extensions = default_extensions
 extensions.append("sphinx_tippy")
 extensions.append("myst_parser")
+extensions.append("sphinx_inline_tabs")
 
 myst_enable_extensions = default_myst_enable_extensions
 myst_substitutions = {"project": project}
diff --git a/doc/source/getting_started.md b/doc/source/getting_started.md
@@ -12,7 +12,6 @@ To get started with the Jetson Orin Baseboard, you'll need the following hardwar
 ### 1. Jetson SoM
 
 The Jetson Orin Baseboard is electrically compatible with the NVIDIA Jetson Orin NX, Jetson Orin Nano [family of SoMs](https://developer.nvidia.com/embedded/jetson-modules) including Super modes of those SoMs.
-The provided reference BSP has been developed for NVIDIA Jetson Orin NX 16GB (900-13767-0000-000) but it should work with other modules as well.
 
 ### 2. Power supply
 
@@ -28,10 +27,13 @@ The Jetson Orin Baseboard supports three power supply scenarios:
 
 * DC locking connector ([`J12`](#J12)) which accepts a 2-wire Molex Nano-Fit plug.
   You can use an off-the-shelf Nano-Fit Cable assembly (Molex/[451300203](https://www.molex.com/en-us/products/part-detail/451300203)) or build a custom one from a Nano-Fit receptacle (Molex/[1053071202](https://www.molex.com/en-us/products/part-detail/1053071202)) and pre-crimped wires (Molex/[797582130](https://www.molex.com/en-us/products/part-detail/797582130)).
-  The Jetson Orin Baseboard can be powered with a benchtop PSU or AC/DC wall adapter providing DC voltage in the 9-20 VDC (up to 15 V for revision <= 1.1.7) range.
+  The Jetson Orin Baseboard can be powered with a benchtop PSU or AC/DC wall adapter providing DC voltage.
+  The recommended power supply voltage range for Jetson Orin Baseboard in revision <= 1.1.7 is 9-15 VDC.
+  The recommended power supply voltage range for Jetson Orin Baseboard in revision >= 1.3.0 is 9-20 VDC.
   If you are using a DC locking connector - please observe the polarity marked in the render below.
 
-Power consumption of the device varies depending on the used SOM version, utilized peripherals and specific application. We recommend using minimum 30W rated power supply for Jetson Orin Nano series and minimum 45W for Jetson Orin NX series.
+Power consumption of the device varies depending on the used SoM version, utilized peripherals and specific application. 
+We recommend using minimum a 30W rated power supply for the Jetson Orin Nano series and minimum 45W for the Jetson Orin NX series.
 
 :::{figure-md}
 ![](img/job_power_connection.png)
@@ -83,7 +85,8 @@ Remember to connect the cooling fan plug into the [`J10`](#J10) fan receptacle.
 Optionally, you can fasten the SoM to the baseboard with two metric M2.5 (5mm long) bolts.
 
 :::{caution}
-Hot Plugging of the SoM is not supported. Please disconnect all power sources from the board and wait minimum 10s before disconnecting the SoM.
+The baseboard does not support hot-swapping of the SoM. 
+Please disconnect all power sources from the baseboard and wait minimum 10s before removing/inserting the SoM.
 :::
 
 ### 3. Install the storage
@@ -117,7 +120,6 @@ At this point you should have 3 USB-C cables connected to the board and providin
 Jetson Orin Baseboard ready for flashing.
 :::
 
-
 ## Flash the BSP image
 
 Jetson Orin Baseboard comes with a reference BSP image of a Yocto-based system built on top of the [meta-antmicro](https://github.com/antmicro/meta-antmicro) layer.
@@ -131,20 +133,43 @@ First, create a workspace directory that will contain all of the files you will
 ```bash
 export WORK="$HOME/antmicro-job-bsp"
 mkdir -p $WORK
+cd $WORK
 ```
 Download the BSP image into the previously created workspace directory.
-The image archive is around 283MB in size.
+Make sure there is no other BSP image already downloaded there.
+Please use the tabs provided below to pick the reference BSP image suitable for the Jetson Orin SoM variant you plan to use with the baseboard.
+The latest available reference BSP image is based on JetPack 6.1.
 
+````{tab} Orin NX 16 GB
 ```bash
-cd $WORK
-wget https://dl.antmicro.com/projects/nvidia-jetson-orin-baseboard-demo-p3509-a02-p3767-0000-20240723125144.tegraflash.tar.gz
+wget https://dl.antmicro.com/projects/nvidia-jetson-orin-baseboard-demo-p3768-0000-p3767-0000.rootfs-20250402101110.tegraflash.tar.gz
+```
+````
+
+````{tab} Orin NX 8 GB
+```bash
+wget https://dl.antmicro.com/projects/nvidia-jetson-orin-baseboard-demo-p3768-0000-p3767-0001.rootfs-20250402101038.tegraflash.tar.gz
+```
+````
+
+````{tab} Orin Nano 8 GB
+```bash
+wget https://dl.antmicro.com/projects/nvidia-jetson-orin-baseboard-demo-p3768-0000-p3767-0003.rootfs-20250402101039.tegraflash.tar.gz
 ```
+````
+
+````{tab} Orin Nano 4 GB
+```bash
+wget https://dl.antmicro.com/projects/nvidia-jetson-orin-baseboard-demo-p3768-0000-p3767-0004.rootfs-20250402100946.tegraflash.tar.gz
+```
+````
+
 Next, unpack the BSP image:
 
 ```bash
 mkdir -p $WORK/bsp
 cd $WORK/bsp
-tar xvzf $WORK/nvidia-jetson-orin-baseboard-demo-p3509-a02-p3767-0000-20240723125144.tegraflash.tar.gz
+tar xvzf $WORK/*.tegraflash.tar.gz
 ```
 
 ### 2. Install dependencies
@@ -291,6 +316,9 @@ When it successfully boots, you will be asked for login and password:
 ```
 p3509-a02-p3767-0000 login:
 ```
+:::{note}
+Please note that the login prompt may differ depending on the SoM and the BSP version you used for flashing.
+:::
 
 Use the following login credentials to get access to the system:
 
diff --git a/doc/source/release_notes.md b/doc/source/release_notes.md
@@ -1,45 +1,39 @@
 # Revision changelog
 
-Each release of the Antmicro Jetson Orin Baseboard comes with release notes. Release notes typically consist of changelog with respect to previous revision. The number of each subchapter corresponds with the revision tag on GitHub Repository.
-
-Revisions:
-
-* [Rev.1.3.4](#134)
-* [Rev.1.3.0](#130)
-* [Rev.1.1.6](#116---aug-7-2024)
+This chapter provides a brief changelog along with comments and remarks specified for each board [release](https://github.com/antmicro/jetson-orin-baseboard/releases) defined in the GitHub repository.
 
 ## 1.3.4
-Fixes known bugs and improves usefulness of the Jetson Orin Baseboard during high power modes.
 
-**Changes:**
+Introduced design tweaks to the SoM power path switching under high loads.
 
-* Added LED indicator for high power module detection
-* Replaced LM37100 load switch with TPS259474
-* Replaced FB1 with 0R for SoM_VIN stability under high load
-* Fixed power-up circuitry bug preventing module from powering down when >15V was applied on input
+Changelog:
 
+* Added LED indicator for high power module detection
+* Replaced `LM37100` load switch with `TPS259474`
+* Replaced `FB1` with 0R to ensure the `SoM_VIN` rail stability under high load
+* Trimmed power-up circuitry to make the SoM boot properly with input voltages >15V
 
 ## 1.3.0
-Adds support for Nvidia [Super Mode](https://developer.nvidia.com/blog/nvidia-jetpack-6-2-brings-super-mode-to-nvidia-jetson-orin-nano-and-jetson-orin-nx-modules/). Additionally, improves manufacturability and testability of the device.
 
-**Changes:**
+Added support for so called [Super Mode](https://developer.nvidia.com/blog/nvidia-jetpack-6-2-brings-super-mode-to-nvidia-jetson-orin-nano-and-jetson-orin-nx-modules/) provided in the JetPack 6.x release.
+Additionally this release introduced features that improve manufacturability and testability of the baseboard.
+
+Changelog:
 
 * Added support for Jetson Orin NX/Nano with Super update
   * Detection of the high power modules
   * Jetson Orin NX series modules (high power modules) are now powered directly from supply voltage
 * Configuration of TPS65988 is now available via USB-C 3 Debug (J3)
-* Tag Connect can be configured to access internal SPI and I2C buses
-* Added fiducials for pick and place machines
+* TAG Connect can be configured to access internal SPI and I2C buses
+* Added more fiducials for calibrating pick and place machines
 * Changed SPI MISO pull-up (R131) value to 10k
 * Replaced DC/DC converters (U1, U40) to support input voltage up to 20V
   * Increased declared minimal input voltage to 8.4V
 * Improved SoM_VIN decoupling
-* Changed Test Points positions for easier access
-* Improved markings placement
-* Updated components footprints after feedback from manufacturer
-
+* Changed the arrangement of Test Points for easier access during In-Circuit Testing (ICT)
+* Improved silkscreen markings
+* Tweaked footprints of selected components to optimize the reflow-assembly yield
 
-## 1.1.6 - Aug 7, 2024
-First commercially available Antmicro Jetson Orin Baseboard revision. This project contains open hardware design files for a baseboard supporting NVIDIA Jetson Orin Nano and Jetson Orin NX System on Modules.
+## 1.1.6
 
-The key features of the design can be found in this [README](https://github.com/antmicro/jetson-orin-baseboard/tree/rev.1.1.6-ch?tab=readme-ov-file#key-features).
+This is the first revision of the Jetson Orin Baseboard made commercially available.
