Jump to content

Installation Instructions

From RidgeRun Developer Wiki

Follow us on: YouTube Twitter LinkedIn Email Share this page

Share This Page



Installation Instructions

The CIP kernel image, modules, and device tree must be installed on the AGX Xavier or Xavier NX Developer Kit to validate the functionality of the hardware components supported by the Jetson Xavier Long-Term Kernel Support project. Here are instructions to install the binaries on the Jetson board.


Info
The instructions provided in this wiki page assume the AGX Xavier or Xavier NX boards have been flashed with JetPack version 5.1.6 previously. To perform this, check the Flash Image with GUI Installer and Flashing the Board from Cmdline instructions


How to update the kernel with the CIP version

The CIP kernel can be installed on the Jetson Xavier platforms either as an additional boot entry, allowing users to select it from the boot menu, or by replacing the existing kernel on the board. Detailed instructions for both installation methods are provided in the following sections.

Add it as a second boot label

Info
This is the recommended mode for development. It is better to have both the original and the modified kernel active; in case something happens, you can always go back.


1. Copy kernel modules

rsync -avz -e ssh output/modules/lib/modules/5.10.254-cip72-tegra/ <board_user>@<board_ip>:/tmp/5.10.254-cip72-tegra/

2. Copy kernel Image

scp output/arch/arm64/boot/Image <board_user>@<board_ip>:/tmp/

Then, from the board

3. Move modules to the modules directory: make sure the modules folder already present does not have the same name as the one that is being moved.

cd /lib/modules
sudo mv /tmp/5.10.254-cip72-tegra .

4. Copy kernel Image

cd /boot
sudo mv /tmp/Image Image.cip

5. Add a new label to /boot/extlinux/extlinux.conf: this will allow the user to select the kernel to boot at boot time. Edit /boot/extlinux/extlinux.conf and add the following at the end of the file.

For AGX Xavier:

LABEL cip
      MENU LABEL CIP kernel
      LINUX /boot/Image.cip
      FDT /boot/dtb/kernel_tegra194-p2888-0001-p2822-0000.dtb
      INITRD /boot/initrd
      APPEND ${cbootargs} root=/dev/mmcblk0p1 rw rootwait rootfstype=ext4 mminit_loglevel=4 console=ttyTCU0,115200n8 console=tty0 fbcon=map:0 net.ifnames=0 rootfstype=ext4 video=efifb:off nv-auto-config

For the Xavier NX:

LABEL cip
      MENU LABEL CIP kernel
      LINUX /boot/Image.cip
      FDT /boot/dtb/kernel_tegra194-p3668-0000-p3509-0000.dtb
      INITRD /boot/initrd
      APPEND ${cbootargs} root=/dev/mmcblk0p1 rw rootwait rootfstype=ext4 mminit_loglevel=4 console=ttyTCU0,115200n8 console=tty0 fbcon=map:0 net.ifnames=0 rootfstype=ext4 video=efifb:off nv-auto-config

After this, double-check that the extlinux.conf file has 2 labels: primary and CIP, and the primary label is the default.

DEFAULT primary

6. Reboot the board: When the board is booting, the user will be asked to select a label to boot:

Enter to continue boot.
**  WARNING: Test Key is used.  **
......
      L4TLauncher: Attempting Direct Boot
L4T boot options
0: primary kernel
1: CIP kernel
Press 0-1 to boot selection within 3.0 seconds.

Type 0 or let it boot with the primary label. Type 1 to boot with CIP kernel.


Info

Once the board is back again, you can verify you are booting with the new kernel by running

uname -a
Linux ubuntu 5.10.254-cip72-tegra #1 SMP PREEMPT Thu Apr 23 15:28:06 CST 2026 aarch64 aarch64 aarch64 GNU/Linux
The user should see the kernel version and build date, 5.10.254-cip72-tegra #1 SMP PREEMPT Thu Apr 23 15:28:06 CST 2026, for example.


Replace existing kernel on the board

If the user wants to completely replace the existing kernel on the board

1. Copy kernel modules

rsync -avz -e ssh output/modules/lib/modules/5.10.254-cip72-tegra/ <board_user>@<board_ip>:/tmp/5.10.254-cip72-tegra/

2. Copy kernel Image

scp output/arch/arm64/boot/Image <board_user>@<board_ip>:/tmp/

Then, from the board

3. Replace existing kernel modules

cd /lib/modules
sudo mv <existing_modules> <existing_modules>.backup # This is just a backup. As of the moment of writing this wiki, the '''existing_modules''' folder is '''5.10.216-tegra'''
sudo mv /tmp/5.10.254-cip72-tegra .

4. Replace kernel Image

cd /boot
sudo mv Image Image.backup    # backup the current image
sudo mv /tmp/Image Image


Info

After this, just reboot your board. Once the board is back again, you can verify you are booting with the new kernel by running

uname -a
Linux ubuntu 5.10.254-cip72-tegra #1 SMP PREEMPT Thu Apr 23 15:28:06 CST 2026 aarch64 aarch64 aarch64 GNU/Linux
The user should see kernel version and build date, 5.10.254-cip72-tegra #1 SMP PREEMPT Thu Apr 23 15:28:06 CST 2026, for example.




Cookies help us deliver our services. By using our services, you agree to our use of cookies.