-
Notifications
You must be signed in to change notification settings - Fork 22
Fix readme #309
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: dev
Are you sure you want to change the base?
Fix readme #309
Changes from 10 commits
086958e
7522182
131f993
d3e9025
2a204af
ee58b62
656f39b
4dea5a4
09767ba
4a9ca76
350df23
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change | ||||||
|---|---|---|---|---|---|---|---|---|
| @@ -0,0 +1,320 @@ | ||||||||
| # Intel® RealSense™ camera driver for GMSL* interface | ||||||||
|
|
||||||||
| # D457 MIPI on NVIDIA® Jetson AGX Orin™ JetPack 6.x | ||||||||
| The Intel® RealSense™ MIPI platform driver enables the user to control and stream RealSense™ 3D MIPI cameras. | ||||||||
| The system shall include: | ||||||||
| * NVIDIA® Jetson™ platform Supported JetPack versions are: | ||||||||
| - [6.2 production release](https://developer.nvidia.com/embedded/jetpack-sdk-62) | ||||||||
| - [6.1 production release](https://developer.nvidia.com/embedded/jetpack-sdk-61) | ||||||||
| - [6.0 production release](https://developer.nvidia.com/embedded/jetpack-sdk-60) | ||||||||
| * RealSense™ [De-Serialize board](https://store.intelrealsense.com/buy-intel-realsense-des457.html) | ||||||||
| * Jetson AGX Orin™ Passive adapter board from [Leopard Imaging® LI-JTX1-SUB-ADPT](https://leopardimaging.com/product/accessories/adapters-carrier-boards/for-nvidia-jetson/li-jtx1-sub-adpt/) | ||||||||
| * RS MIPI camera [D457](https://store.intelrealsense.com/buy-intel-realsense-depth-camera-d457.html) | ||||||||
|
|
||||||||
|  | ||||||||
|
|
||||||||
|
|
||||||||
| > Note: This MIPI reference driver is based on RealSense™ de-serialize board. For other de-serialize boards, modification might be needed. | ||||||||
|
|
||||||||
| ### Links | ||||||||
| - Intel® RealSense™ camera driver for GMSL* interface [Front Page](./README.md) | ||||||||
| - NVIDIA® Jetson AGX Orin™ board setup - AGX Orin™ [JetPack 6.0](./README_JP6.0.md) setup guide | ||||||||
| - NVIDIA® Jetson AGX Xavier™ board setup - AGX Xavier™ [JetPack 5.x.2](./README_JP5.md) setup guide | ||||||||
| - NVIDIA® Jetson AGX Xavier™ board setup - AGX Xavier™ [JetPack 4.6.1](./README_JP4.md) setup guide | ||||||||
| - Build Tools manual page [Build Manual page](./README_tools.md) | ||||||||
| - Driver API manual page [Driver API page](./README_driver.md) | ||||||||
|
|
||||||||
| ## NVIDIA® Jetson AGX Orin™ board setup | ||||||||
|
|
||||||||
| Please follow the [instruction](https://docs.nvidia.com/sdk-manager/install-with-sdkm-jetson/index.html) to flash JetPack to the NVIDIA® Jetson AGX Orin™ with NVIDIA® SDK Manager or other methods NVIDIA provides. Make sure the board is ready to use. | ||||||||
|
|
||||||||
|
|
||||||||
|
|
||||||||
| ## Build environment prerequisites | ||||||||
| ``` | ||||||||
| sudo apt-get install -y build-essential bc wget flex bison curl libssl-dev xxd tar | ||||||||
| ``` | ||||||||
| ## Build NVIDIA® kernel drivers, dtb and D457 driver | ||||||||
|
|
||||||||
| 1. Clone [realsense_mipi_platform_driver](https://github.com/IntelRealSense/realsense_mipi_platform_driver.git) repo. | ||||||||
| 2. The developers can set up build environment, ARM64 compiler, kernel sources and NVIDIA's Jetson git repositories by using the setup script. | ||||||||
| 3. Apply patches for kernel drivers, nvidia-oot module and tegra devicetree. | ||||||||
| 4. Build project | ||||||||
| 5. Apply build results to target (Jetson). | ||||||||
| 6. Configure target. | ||||||||
|
|
||||||||
| Assuming building for 6.0. One can also build for 6.1, 6.2 just replace the last parameter. | ||||||||
| ``` | ||||||||
| git clone --branch dev --single-branch https://github.com/IntelRealSense/realsense_mipi_platform_driver.git | ||||||||
| cd realsense_mipi_platform_driver | ||||||||
| ./setup_workspace.sh 6.0 | ||||||||
| ./apply_patches.sh 6.0 | ||||||||
| ./build_all.sh 6.0 | ||||||||
| ``` | ||||||||
| Note: dev_dbg() log support will not be enabled by default. If needed, run the `./build_all.sh` script with `--dev-dbg` option like below. | ||||||||
| ``` | ||||||||
| ./build_all.sh --dev-dbg 6.0 | ||||||||
| ``` | ||||||||
|
|
||||||||
|
|
||||||||
|
|
||||||||
| ## JetPack manual build - cross compile x86-64 (CI deploy) | ||||||||
|
|
||||||||
| [NVIDIA® JetPack 6.2: Jetson Linux 36.4.3](https://developer.nvidia.com/embedded/jetson-linux-r3643) | ||||||||
| 1. Download Jetson Linux Driver Package - [JetPack 6.2 BSP sources](https://developer.nvidia.com/downloads/embedded/l4t/r36_release_v4.3/release/jetson_linux_r36.4.3_aarch64.tbz2) | ||||||||
|
Collaborator
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Same |
||||||||
| 2. Download Toolchain ARM64 compiler - [Bootlin Toolchain gcc 11.3](https://developer.nvidia.com/downloads/embedded/l4t/r36_release_v3.0/toolchain/aarch64--glibc--stable-2022.08-1.tar.bz2) | ||||||||
| 3. Apply patches for kernel drivers, nvidia-oot module and tegra devicetree. | ||||||||
| 4. Build cross-compile project on host (Build PC) or natively on target (Jetson). | ||||||||
| 5. Apply build results to target (Jetson). | ||||||||
| 6. Configure target. | ||||||||
|
|
||||||||
| ``` | ||||||||
| # JetPack 6.0 | ||||||||
| mkdir -p l4t-gcc/6.x | ||||||||
| cd ./l4t-gcc/6.x | ||||||||
| wget https://developer.nvidia.com/downloads/embedded/l4t/r36_release_v3.0/toolchain/aarch64--glibc--stable-2022.08-1.tar.bz2 -O aarch64--glibc--stable-final.tar.bz2 | ||||||||
| tar xf aarch64--glibc--stable-final.tar.bz2 --strip-components 1 | ||||||||
| cd ../.. | ||||||||
| wget https://developer.nvidia.com/downloads/embedded/l4t/r36_release_v4.3/sources/public_sources.tbz2 | ||||||||
| tar xjf public_sources.tbz2 | ||||||||
| cd Linux_for_Tegra/source | ||||||||
| tar xjf kernel_src.tbz2 | ||||||||
| tar xjf kernel_oot_modules_src.tbz2 | ||||||||
| tar xjf nvidia_kernel_display_driver_source.tbz2 | ||||||||
| cd ../.. | ||||||||
|
|
||||||||
| ./apply_patches_ext.sh 6.0 Linux_for_Tegra/source | ||||||||
|
|
||||||||
| cp ./nvidia-oot/Makefile Linux_for_Tegra/source | ||||||||
| cp ./kernel/kernel-jammy-src/Makefile Linux_for_Tegra/source/kernel | ||||||||
|
|
||||||||
| # build kernel, dtb and D457 driver | ||||||||
| ./build_all.sh 6.0 ./Linux_for_Tegra/source | ||||||||
| ``` | ||||||||
| Note: dev_dbg() log support will not be enabled by default. If needed, run the `./build_all.sh` script with `--dev-dbg` option like below. | ||||||||
| ``` | ||||||||
| ./build_all.sh --dev-dbg 6.0 ./Linux_for_Tegra/source | ||||||||
| ``` | ||||||||
|
|
||||||||
| ## Archive JetPack 6.x build results (optional) | ||||||||
| For 6.0 the kernel version is 5.15.136-tegra. | ||||||||
| - kernel image : `images/6.0/rootfs/boot/Image` | ||||||||
| - dtb: `images/6.0/rootfs/boot/dtb/tegra234-p3737-0000+p3701-0000-nv.dtb` | ||||||||
| - dtb overlay: `images/6.0/rootfs/boot/tegra234-camera-d4xx-overlay.dtbo` | ||||||||
| - dtb dual camera overlay: `images/6.0/rootfs/boot/tegra234-camera-d4xx-overlay-dual.dtbo` | ||||||||
| - kernel modules: `images/6.0/rootfs/lib/modules/5.15.136-tegra` | ||||||||
|
|
||||||||
| ## Backup JetPack 6.0 boot configuration and drivers (optional) | ||||||||
| ``` | ||||||||
| echo "Backup boot configuration" | ||||||||
| sudo cp /boot/tegra234-p3737-0000+p3701-0000-nv.dtb /boot/tegra234-p3737-0000+p3701-0000-nv-bkp.dtb | ||||||||
| # Note: If using a production board and not a dev kit copy the relevant dtb file below | ||||||||
| sudo cp /boot/tegra234-p3737-0000+p3701-0005-nv.dtb /boot/tegra234-p3737-0000+p3701-0005-nv-bkp.dtb | ||||||||
| ``` | ||||||||
|
|
||||||||
| ## Deploy build results on Jetson target | ||||||||
| On build host, copy build results to the right places. | ||||||||
| Assuming user 'nvidia' on Jetson with ip: `10.0.0.116` (if building natively on Jetson use $USER@localhost): | ||||||||
|
|
||||||||
| ``` | ||||||||
| # Configuration files | ||||||||
| tar czf rootfs.tar.gz -C images/6.2/rootfs boot lib | ||||||||
|
||||||||
| tar czf rootfs.tar.gz -C images/6.2/rootfs boot lib | |
| tar czf rootfs.tar.gz -C images/6.0/rootfs boot lib |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Co-Pilot is right
Copilot
AI
Nov 13, 2025
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Corrected grammar: 'use those commands' should be 'use these commands'.
| If you build locally use those commands: | |
| If you build locally use these commands: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Right again
Copilot
AI
Nov 13, 2025
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Corrected grammar: 'use this commands' should be 'use these commands'.
| In case of scp copy from host use this commands: | |
| In case of scp copy from host use these commands: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Same
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We need to make sure why it didn't work when I ran this readme on a clean machine
Copilot
AI
Nov 13, 2025
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Step 4 heading is incomplete. The line '4.' should include the full description on the same line as 'Verify bootloader configuration' for consistency with other numbered steps.
| 4. | |
| Verify bootloader configuration | |
| 4. Verify bootloader configuration |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is 6.0 doc