Initial Setup Guide for Jetson Orin Nano Developer Kit
Note
This guide is to supplement the official Jetson Orin Nano Developer Kit Getting Started Guide .
The NVIDIA® Jetson Orin Nano™ Developer Kit is a perfect kit to start your journey of local generative AI evaluation and development.
With the December 2024 software update (JetPack 6.1 (rev.1)), this advanced edge computer delivers up to 70% more performance, making it an even more powerful platform for the era of generative AI.
This guide explains the complete flow from opening the box, updating the firmware if needed, flashing the latest JetPack 6.2 image on SD card, and the initial software setup, so that you will be ready for tutorials listed on this site and other AI projects.
Check your inventory
The following item is needed or highly desired to set up your Jetson Orin Nano Developer Kit.
If you don't have them in your inventory, you want to arrange them and return to this guide once they are available.
What not come in the box - What you need/want to prepare
Storage
- microSD card (64GB or bigger)
- NVMe SSD (Optional, but highly recommended for following tutorials on this site)
Mean to access terminal
You need either of the following set:
- DisplayPort cable, DisplayPort capable monitor and a USB keyboard
- DisplayPort to HDMI cable and HDMI capable monitor (or TV) and a USB keyboard
- USB to TTL Serial cable (Advanced)
🛸 Alternative method : SDK Manager
In case you have an x86 PC running Ubuntu 22.04 or 20.04, then you can flash your Jetson Orin Nano Developer Kit with the latest firmware and JetPack all at once using NVIDIA SDK Manager .
Also, if you wish to not use a microSD card but rather use a large NVMe SSD for the OS and data, then you need to use SDK Manager to flash the latest JetPack on the NVMe SSD.
flowchart LR
A(start) --> B{Want to ditch microSD<br>and only use NVMe SSD?}
B --[YES] --> S[🛸 SDK Manager method]
B --[No] --> C{Have x86 PC running<br> Ubuntu 22.04/20.04?}
C --[YES] --> S
C --[No] --> U[🚀 microSD-only method]
style S stroke-width:3px, fill:#f3e9f2,stroke:#b544c4
style U stroke-width:3px, fill:#d2e9e5,stroke:#0e7a71
Click the button below to jump to a page that explains the alternative setup method using SDK Manager if you want to set your Jetson Orin Nano Developer Kit with an NVMe SSD or just want to flash all at once with your Ubuntu PC.
Otherwise, continue reading on this page for the microSD-only setup method.
Overall flow (microSD-only method)
Jetson Orin Nano Initial Setup Flowchart (microSD-only method)
flowchart
A(start) --> B{1️⃣ Check if Jetson UEFI Firmware<br>is newer than version 36.0}
B --[YES] --> O[6️⃣ Boot with JetPack 6.2 microSD card<br> to schedule firmware update]
B --[No] --> C[2️⃣ Boot with JetPack 5.1.3 microSD card<br>to schedule firmware update]
C --> D[3️⃣ Reboot] --> E{{Firmware update to 5.0 during reboot}}
E --> F[4️⃣ Run QSPI updater] --> G[5️⃣ Reboot] --> H{{QSPI update during reboot - Firmware 36.4.0}}
H --> O
O --> P[7️⃣ Reboot]
P --> Q{{Firmware update to 36.4.3 during reboot}}
Q --> R[8️⃣ Unlock super performance]
R --> S(👍 Start developing on JetPack 6.2)
style C fill:#fee
style D fill:#DEE,stroke:#333
style E stroke-width:2px,stroke-dasharray: 5 5
style F stroke-width:4px
style G fill:#DEE,stroke:#333
style H stroke-width:2px,stroke-dasharray: 5 5
style O fill:#fee
style P fill:#DEE,stroke:#333
style Q stroke-width:2px,stroke-dasharray: 5 5
style R fill:#f2d5ff
Note that it will undergo a total of three (3) reboot cycles.
Walk-through Video
Click here to expand and watch video
1️⃣ Check if Jetson UEFI Firmware version >
36.0
Your Jetson Orin Nano Developer Kit may have the latest firmware ("Jetson UEFI firmware" on QSPI-NOR flash memory) flashed at the factory.
If not, we need to go through a set of procedures to upgrade to the latest firmware. (Luckily, we can now do this all just on Jetson, meaning we don't need to use a host Ubuntu PC any more!)
So let's first check the version of your Jetson UEFI Firmware.
You can take one of the following methods.
- Connect your monitor and USB keyboard to your developer kit.
- Turn on the developer kit by plugging in the bundled DC power supply
- Repeatedly press Esc key on the keyboard, especially after NVIDIA logo boot splash screen first appears on the monitor
- You should see UEFI setup menu screen
- Check the third line from the top (below "Not specified"), which should be the version number of Jetson UEFI firmware
Below image shows that this Jetson Orin Nano Developer Kit unit has the old UEFI firmware, indicating that the unit first needs its firmware/QSPI updated in order to run JetPack 6.x.
-
Connect USB to TTL Serial cable onto the following pins on
J14
"button" header of carrier board located under the Jetson module.-
RXD
(Pin 3) Adafruit adaptor cable Green -
TXD
(Pin 4) Adafruit adaptor cable White -
GND
(Pin 7) Adafruit adaptor cable BlackFor the detail, refer to Jetson Orin Nano Developer Kit Carrier Board Specification .
-
- On your PC, run your console monitor program and open the USB serial port.
- Power on the developer kit by plugging in the bundled DC power supply
- On the PC console, repeatedly press Esc key on the keyboard, especially after NVIDIA logo boot splash screen first appears on the monitor
- You should see UEFI setup menu screen
- Check the third line from the top (below "Not specified"), which should be the version number of Jetson UEFI firmware
Warning
Avoid leaving the device in a black screen state for extended periods or attempting to boot repeatedly with an SD card containing an incompatible JetPack version.
There is a chance that accumulated boot failures may trigger the L4T launcher to always boot into recovery kernel.
If this happens, even after switching to the proper JetPack 5.1.3 SD card, it won't boot from the SD card until we manually change the L4T Launcher setting.
Although we don't recommend for the above stated reason, you could skip to 6️⃣ Boot with JetPack 6.x SD card , and try your luck to see if your Jetson just boots with the JetPack 6.x SD card.
If the Ubuntu desktop does not appear within 3 minutes and the screen remains black (as shown below), it indicates that the unit is running an older UEFI firmware version that is incompatible with the JetPack 6.x SD card.
Turn the unit off, and skip to the next section ( 2️⃣ Boot with JetPack 5.1.3 SD card to schedule firmware update ).
Determine QSPI update is necessary or not
Attention
Select the appropriate tab below based on your firmware version you found in the above step.
If you found your Jetson Orin Nano needs its firmware updated to run JetPack 6.x, click " Firmware < 36.0" tab, and then additional step 2 to 5 will appear for you to follow.
If you know your Jetson Orin Nano has the latest firmware, stay on " Firmware 36.x" tab, and skip to the next section ( 6️⃣ Boot with JetPack 6.x SD card )
Your Jetson Orin Nano needs its firmware updated in order to make JetPack 6.x SD card work.
Perform the following steps (2 to 5).
2️⃣ Boot with JetPack 5.1.3 SD card to schedule firmware update
First, we need to run JetPack 5.1.3 in order to let its
nvidia-l4t-bootloader
package get its bootloader/firmware updater activated, so that the firmware update automatically runs the next time it reboots.
-
Download SD card image on to your PC
On your PC, download JetPack 5.1.3 image for Jetson Orin Nano Developer Kit from the official JetPack 5.1.3 page or from the below direct link button.
Warning
NVIDIA had updated the JetPack 5.1.3 image on 5/28/2024, as the old version had some issue and the following process did not work.
So please download and use the latest image (the new file name isJP513-orin-nano-sd-card-image_b29.zip
). -
Use Balena Etcher to flash image to SD card
If you don't have Balena Etcher on your PC, download from Balena official site .
-
Insert the flashed microSD card into the slot on Jetson module
-
Power-on
Turn on the Jetson Orin Nano Developer Kit with JetPack 5.1.3 SD card inserted by plugging in the DC power supply.
-
Complete the initial software setup (
oem-config
)Info
There is a chance that JetPack 5.1.3 SD card does not show any desktop UI on the attached display (the display remains black).
It would still schedule the UEFI firmware update in the background, so when you power cycle the unit, most likely it will perform the firmware update on the next boot up.
So if this happens, skip to the next step (3️⃣-2).
-
Ensure firmware update is scheduled.
Once Jetson boots into Jetson Linux system, a background service automatically runs to schedule a firmware update (if needed) to be performed during the next boot-up process.
Once you see the following, or just wait about 5 minutes after powering on to ensure the scheduling is done, reboot.
$ sudo systemctl status nv-l4t-bootloader-config [sudo] password for jetson: ● nv-l4t-bootloader-config.service - Configure bootloader service Loaded: loaded (/etc/systemd/system/nv-l4t-bootloader-config.service; enabled; vendor preset: enabled) Active: inactive (dead) since Fri 2024-05-03 13:36:13 PDT; 1min 57s ago Process: 11439 ExecStart=/opt/nvidia/l4t-bootloader-config/nv-l4t-bootloader-config.sh -v (code=exited, status=0/SUCCESS) Main PID: 11439 (code=exited, status=0/SUCCESS)
3️⃣ Reboot and observe firmware update to
5.0
-
Reboot
Reboot your Jetson Orin Nano Developer Kit.
On the Ubuntu desktop click the power icon ( ) and select " Restart... ".
$ sudo reboot
-
Observe firmware update
You should see the following during the boot up process.
Once done, you will boot into JetPack 5.1.3 (again), with underlying firmware updated to
5.0-35550185
.
4️⃣ Run QSPI Updater package to schedule QSPI update
Now that your UEFI firmware is updated to 35.5.0 ( = JetPack 5.1.3 ), it is capable of updating the entire QSPI content to make it ready for JetPack 6.x.
We will run a special tool so that the entire QSPI update is scheduled to run automatically on the next boot-up.
-
Double-check your firmware version is up to date (
35.5.0
= JetPack 5.1.3)Once it reboots back into Jetson Linux system, on Jetson terminal, run the following:
sudo nvbootctrl dump-slots-info
You should see something like the following, with the Current version indicating
35.5.0
.Current version: 35.5.0 Capsule update status: 0 Current bootloader slot: A Active bootloader slot: A num_slots: 2 slot: 0, status: normal slot: 1, status: normal
-
Install QSPI Updater Debian package to trigger the entire QSPI update
On Jetson terminal, run the following:
sudo apt-get install nvidia-l4t-jetson-orin-nano-qspi-updater
Installing the
nvidia-l4t-jetson-orin-nano-qspi-updater
automatically runs its script to schedule the entire QSPI update to be performed during the next boot process, so that the firmware is ready for JetPack 6.x.
5️⃣ Reboot, observe QSPI update, and power off
-
Reboot
Once the QSPI update is scheduled, reboot your Jetson Orin Nano Developer Kit.
-
Observe update
You can observe the QSPI update during the boot up process.
-
Power off
Once the update is done, it reboots and tries to boot, however it will get stuck UNLESS you change the SD card to JetPack 6.x one .
Therefore you should just power off the developer kit simply by disconnecting the DC power supply.
Attention
This part may look very confusing as neither the attached monitor nor the debug UART shows any explicit message on what action to take next.
What is going on here is that the Jetson's firmware (inside the QSPI-NOR flash memory) is now updated, ready for the JetPack 6.x SD card, however it is now incompatible with JetPack 5.1.3 SD card left in the Jetson module's slot, so after the reboot it gets stuck in the boot process.
So there is no issue with this boot halt (or endless rebooting).
Simply power off the device and insert the new SD card.
Your Jetson Orin Nano has the latest firmware that is ready for JetPack 6.x SD card.
Skip to the next section ( 6️⃣ Boot with JetPack 6.x SD card )
6️⃣ Boot with JetPack 6.x SD card
Once we know the onboard firmware is up-to-date and ready for JetPack 6.x, we can boot Jetson Orin Nano Developer Kit with a microSD card for JetPack 6.2.
-
Download SD card image on to your PC
On your PC, download the latest JetPack 6.x image for Jetson Orin Nano Developer Kit from the official JetPack page or from the below direct link button.
-
Use Balena Etcher to flash image to SD card
Insert your microSD card into your PC's SD card slot, and use Balena Etcher to flash the SD card with the image you just downloaded.
If you don't have Balena Etcher on your PC, download from Balena official site .
-
Insert the JetPack 6.2 microSD card into the slot on Jetson module
-
Power-on by plugging the DC power supply
-
Complete the initial software setup (
oem-config
) -
Ensure firmware update is scheduled.
JetPack 6.2 SD card will automatically schedule another firmware/bootloader update in the next (3rd and final) reboot cycle.
$ sudo systemctl status nv-l4t-bootloader-config [sudo] password for jetson: ● nv-l4t-bootloader-config.service - Configure bootloader service Loaded: loaded (/etc/systemd/system/nv-l4t-bootloader-config.service; enabled; vendor preset: enabled) Active: inactive (dead) since Fri 2024-05-03 13:36:13 PDT; 1min 57s ago Process: 11439 ExecStart=/opt/nvidia/l4t-bootloader-config/nv-l4t-bootloader-config.sh -v (code=exited, status=0/SUCCESS) Main PID: 11439 (code=exited, status=0/SUCCESS)
7️⃣ Reboot and observe firmware update to
36.4.3
-
Reboot your Jetson Orin Nano Developer Kit on JetPack 6.1 (rev.1) SD card to trigger the final firmware update (to
36.4.2
).On the Ubuntu desktop click the power icon ( ) and select " Restart... ".
$ sudo reboot
-
Observe firmware update
You should see the following during the boot up process.
Once done, you will boot into JetPack 6.1 (rev.1) again, with the underlying firmware updated to
36.4.2
, which unlock the Super performance.
8️⃣ Unlock Super Performance
Attention
If your are booting with JetPack 6.1 (rev.1) SD card instead of JetPack 6.2 SD card, you may need to execute the following command after the final login and reboot your device.
This ensures that the MAXN performance mode becomes available on your system.
sudo rm -rf /etc/nvpmodel.conf
Switch to MAXN SUPER mode
Note that the default power mode on JetPack 6.2 on Jetson Orin Nano Developer Kit is
25W
.
To switch to the
MAXN SUPER
mode and unlock the unregulated performance, follow below steps:
- Click on the current power mode ( 25W ) by clicking the NVIDIA icon on the right side of the Ubuntu desktop’s top bar.
- Select Power mode from the menu.
- Choose MAXN SUPER to enable maximum performance.
👍 Start developing on JetPack 6.2
🎊
Congratulations!
Your Jetson Orin Nano Developer Kit is set up with JetPack 6.2 and you are ready to develop on JetPack 6.2.
Next step
NVMe SSD installation
Take a look at this page for installing NVMe SSD and setting up Docker with it.