jetson-flash

A set of tools that allows users to flash balenaOS on supported Jetson devices.

About

Jetson Flash will extract the balenaOS image from a downloaded provisioned image (such as from balenaCloud) and then flash that image to a Jetson board connected to a host PC via USB.

This tool invokes NVIDIA’s proprietary software to properly partition the boot media (such as eMMC) and place the required balenaOS software in the necessary location to make it bootable. Even on Jetson boards without eMMC, this tool may be necessary to initially flash balenaOS because of the way JetPack uses onboard QSPI flash memory for the bootloader. (In those cases, this tool can write to the QSPI so the device will be able to boot balenaOS from the SD card.)

Instructions

Choose your device from the list below for step-by-step instructions:

Don't see your device listed?

• Use the closest match above to the Jetson module on your carrier board
• Reach out to us on the balena Forums

License

The project is licensed under the Apache 2.0 license.

Photo by Mélody P on Unsplash

Change Log

All notable changes to this project will be documented in this file automatically by Versionist. DO NOT EDIT THIS FILE MANUALLY! This project adheres to Semantic Versioning.

v0.5.90

(2025-07-16)

• speed up docker build when using cache [Ryan Cooke]

v0.5.89

(2025-06-26)

• lib/resin-jetson-flash: Update Nano eMMC and JN30B Nano to L4T 32.7.6 [Alexandru Costache]

v0.5.88

(2025-06-17)

• lib/resin-jetson-flash: Update Jetson TX2 to L4T 32.7.6 [Alexandru Costache]

v0.5.87

(2025-03-18)

• Update all devices to L4T 36.4.3 - JP6 [Alexandru Costache]

v0.5.86

(2025-02-21)

• package: Bump ext2fs and balena-image-fs [Alexandru Costache]

v0.5.85

(2025-01-13)

• docs: Add flashing instructions for community supported boards [Alexandru Costache]
• jetson-nano: Fix BSP machine in docs [Alexandru Costache]

v0.5.84

(2024-12-02)

• flash_orin: Add flag for QSPI direct writing [Alexandru]

v0.5.83

(2024-11-20)

• patch: Move all docs to a flat directory structure [Vipul Gupta (@vipulgupta2048)]

v0.5.82

(2024-10-29)

• patch: Replace absolute README links with relative [Vipul Gupta (@vipulgupta2048)]

v0.5.81

(2024-10-25)

• Update Orin links in various pages [Alan Boris]

v0.5.80

(2024-10-24)

• Create device type specific docs for jetson flash [Alan Boris]

v0.5.79

(2024-10-15)

• Orin_Flash: Set cvb_eeprom_read_size to 0 prior rcm-boot [Alexandru Costache]

v0.5.78

(2024-09-23)

• Update README for non-Docker lz4 package requirement [Ken Bannister]

v0.5.77

(2024-08-09)

• README: Update AGX Orin 64GB machine name [Alexandru]

v0.5.76

(2024-08-09)

• Add Jetson AGX Orin 64GB Devkit provisioning support [Alexandru Costache]

v0.5.75

(2024-08-06)

• README: Update L4T version for Seeed reComputer J3010 and J4012 [Alexandru Costache]

v0.5.74

(2024-07-16)

• README: Mention extracted BSP cache path [Alexandru]

v0.5.73

(2024-07-08)

• README: Add important note on versions used for production vs draft releases [Alexandru Costache]
• Orin provisioning container: Update Orin NX Devkit and Orin Nano devkit to L4T 36.3 [Alexandru Costache]

v0.5.72

(2024-06-13)

• README: Use jetson-flash-image for container tag [Alexandru]

v0.5.71

(2024-06-11)

• README: Improve description for Orin Nano/Orin NX flashing [Alexandru]

v0.5.70

(2024-06-11)

• README: Clarify USB provisioning method on Jetson TX2 [Alexandru]

v0.5.69

(2024-06-08)

• build.sh: Update AGX Orin Devkit BSP URL [Alexandru Costache]

v0.5.68

(2024-06-06)

• README: Update L4T version to 35.5.0 in documentation [Alexandru Costache]
• AGX Orin: Use updated QSPI portion of XML [Alexandru Costache]
• lib/resin-jetson-flash: Update AGX Orin 32GB to L4T 35.5.0 [Alexandru Costache]
• Orin Nano/NX: Update BSP to L4T 35.5.0 for flashing [Alexandru Costache]

v0.5.67

(2024-06-03)

• Add Seeed reComputer J3010 provisioning support and instruction [Alex Suykov]

v0.5.66

(2024-05-20)

• README.md: Fix typo and add VMWare notes [Alexandru]

v0.5.65

(2024-04-12)

• AGX Orin: Disable network boot in uefi_jetson.bin [Alexandru Costache]

v0.5.64

(2024-04-02)

• Dockerfile: Install lz4 [Alexandru Costache]

v0.5.63

(2024-02-02)

• add cache flag to node app [rcooke-warwick]

v0.5.62

(2024-01-10)

• README: Clarify provisioning command line for Orin Devices [Alexandru Costache]

v0.5.61

(2024-01-10)

• Add Seeed reComputer J4012 provisioning support and instruction [Alexandru Costache]

v0.5.60

(2023-12-12)

• remove run command from build script [rcooke-warwick]
• jetson-flash: Pre-fetch BSP archive based on device-type [Alexandru Costache]

v0.5.59

(2023-11-24)

• Update README.md [Alexandru Costache]

v0.5.58

(2023-11-22)

• Orin NX/Nano: Update to L4T 35.4.1 [Alexandru Costache]

v0.5.57

(2023-11-16)

• AGX Orin Devkit: Update to L4T 35.4.1 [Alexandru Costache]

v0.5.56

(2023-10-09)

• Orin_Nx_Nano_NVME: Use yocto built uefi firmware for Orin Nano [Alexandru Costache]

v0.5.55

(2023-10-06)

• scripts: Copy dispatcher.d scripts for flasher types [Alexandru Costache]

v0.5.54

(2023-09-20)

• lib/resin-jetson-flash: Update Xavier NX eMMC to L4T 32.7.3 [Alexandru Costache]

v0.5.53

(2023-09-20)

• jetson-nano: Update SD-CARD module to L4T 32.7.3 [Alexandru Costache]

v0.5.52

(2023-09-19)

• assets: enable pre expansion of resin-data partition on Nano DTs [Alexandru Costache]

v0.5.51

(2023-08-14)

• agx-orin-devkit: Set boot,esp flags for resin-boot partition [Alexandru Costache]

v0.5.50

(2023-08-07)

• Orin: Update Orin NX in Xavier NX Devkit to L4T 35.3.1 [Alexandru Costache]

v0.5.49

(2023-07-31)

• README: Update Xavier AGX to L4T 32.7.3 [Alexandru Costache]

v0.5.48

(2023-07-12)

• README: Update and add Jetson Orin Nano Devkit NVME instructions [Alexandru Costache]

v0.5.47

(2023-06-02)

• Update Dockerfile [Eugeny Shcheglov]

v0.5.46

(2023-06-02)

• flowzone: Update flowzone.yml [Alexandru Costache]

v0.5.45

(2023-05-30)

• Orin NX NVME: Print Tegra BSP License Agreement before entering rcm-boot mode [Alexandru Costache]
• bin/cmd: Include Software License Agreement [Alexandru Costache]

v0.5.44

(2023-05-05)

• jetson-agx-orin-devkit: Update to L4T 35.2.1 [Alexandru Costache]

v0.5.43

(2023-04-07)

• Orin NX: Add Dockerfile and scripts for provisioning the Orin NX in Xavier NX Devkit NVME [Alexandru Costache]

v0.5.42

(2023-03-27)

• README: Remove node 12 references [Alexandru Costache]

v0.5.41

(2023-03-27)

• post-test cleanup of artifacts [rcooke-warwick]
• add simple test for artifact generation [rcooke-warwick]

v0.5.40

(2023-03-24)

• use local repo content in dockerfile [rcooke-warwick]
• add node 16+ as supported engines in package.json [rcooke-warwick]
• make compatible with node 18 [rcooke-warwick]

v0.5.39

(2023-03-18)

• lib: Update TX2 NX Devkit to L4T 32.7.3 [Alexandru Costache]

v0.5.38

(2023-03-17)

• lib: Update Jetson Nano eMMC to L4T 32.7.3 [Alexandru Costache]

v0.5.37

(2023-01-30)

• Updated README, added Docker folder [alanb128]

v0.5.36

(2023-01-13)

• lib: Update Jetson Xavier NX Devkit SD-CARD to L4T 32.7.3 [Alexandru Costache]

v0.5.35

(2023-01-03)

• jetson-tx2: Update to L4T 32.7.3 [Alexandru Costache]

v0.5.34

(2022-12-22)

• Switch from balenaCI to flowzone [Alexandru Costache]
• lib: Update Jetson Xavier NX Devkit and NX Devkit eMMC to L4T 32.7.2 [Alexandru Costache]

v0.5.33

(2022-11-17)

• lib: Update Jetson TX2 to L4T 32.7.2 [Alexandru Costache]

v0.5.32

(2022-11-09)

• assets: Set AGX Orin device specific size and partition sizes [Alexandru Costache]

v0.5.31

(2022-10-25)

• agx-orin: Add support for flashing Jetson AGX Orin Devkit [Alexandru Costache]

v0.5.30

(2022-10-20)

• Document that Tegra flash requires python2 [Felipe Lalanne]

v0.5.29

(2022-09-29)

• lib: Update TX2 NX Devkit to 32.7.2 [Alexandru Costache]
• lib: Update Jetson Nano eMMC to L4T 32.7.2 [Alexandru Costache]

v0.5.28

(2022-07-25)

• README: Improve provisioning instructions and details [Alexandru Costache]

v0.5.27

(2022-07-06)

• lib: Update TX2 to L4T 32.7.1 [Alexandru Costache]

v0.5.26

(2022-06-13)

• lib/resin-jetson-flash: Always boot from balenaOS supported mediums [Alexandru Costache]

v0.5.25

(2022-06-08)

• lib: Fix typo in Xavier AGX BSP link [Alexandru Costache]

v0.5.24

(2022-06-05)

• lib: Update Xavier NX SD-CARD and Xavier NX eMMC to L4T 32.7.1 [Alexandru Costache]

v0.5.23

(2022-05-21)

• Update Xavier AGX to L4T 32.7.1 [Alexandru Costache]

v0.5.22

(2022-05-10)

• lib/resin-jetson-flash: Update BSP to 32.7.1 for current released boards [Alexandru Costache]

v0.5.21

(2022-03-22)

• Update list of devices using L4T 32.6.1 [rmorillo24]

v0.5.20

(2022-02-16)

• lib: Update BSP for TX2 32.6.1 [Alexandru Costache]

v0.5.19

(2022-02-11)

• lib: Update Xavier AGX BSP to 32.6.1 [Alexandru Costache]

v0.5.18

(2022-02-07)

• lib: Update Xavier NX SD and eMMC to L4T 32.6.1 [Alexandru Costache]

v0.5.17

(2022-01-25)

• jetson-tx2: Allow specifying odmdata value [Alexandru Costache]

v0.5.16

(2022-01-19)

• Xavier AGX: Use bpmp-fw-dtb from the image instead of the default one [Alexandru Costache]

v0.5.15

(2021-12-17)

• Update Nano 2GB Devkit to L4T 32.6.1 [Alexandru Costache]

v0.5.14

(2021-12-16)

• Update Nano SD, Nano eMMC and TX2 NX to L4T 32.6.1 [Alexandru Costache]

v0.5.13

(2021-10-08)

• Nano 2GB Devkit: Add support for writing cloud image to this device type [Alexandru Costache]
• jetson-nano-qspi-sd: Fix flashing Nano SD-CARD [Alexandru Costache]

v0.5.12

(2021-08-12)

• Update README [Alexandru Costache]

v0.5.11

(2021-08-05)

• Add support for flashing L4T 32.5.1 [Alexandru Costache]

v0.5.10

(2021-06-01)

• Add support for TX2 4GB device. [Andrew C. Smith]

v0.5.9

(2021-04-26)

• package: Update versions for dependencies [Alexandru Costache]

v0.5.8

(2021-03-30)

• scripts: Adapt to renamed flasher images [Alexandru Costache]

v0.5.7

(2021-03-16)

• Allow flashing preloaded images [Alexandru Costache]

v0.5.6

(2021-03-05)

• Update TX2 based devices to L4T 32.4.4 [Alexandru Costache]

v0.5.5

(2021-02-22)

• assets: don't extend last partition [Alexandru Costache]

v0.5.4

(2021-02-08)

• Update Xavier based devices to L4T 32.4.4 [Alexandru Costache]

v0.5.3

(2021-01-28)

• lib: Update BSP archive fo nano sd and emmc variants to 32.4.4 [Alexandru Costache]

v0.5.2

(2020-10-28)

• README: Update devices list [Alexandru Costache]

v0.5.1

(2020-08-28)

• balena: Remove resin to balena in README, copyright and console logs [Alexandru Costache]

v0.5.0

(2020-06-10)

• jetson: Add flashing support for L4T 32.4.2 [Alexandru Costache]

0.4.1 - 2020-03-03

• README: Update with TX2 L4T version notice [Alexandru Costache]

0.4.0 - 2020-02-03

• README: Specify supported device types [Alexandru Costache]
• Jetson-tx2: Remove GPTs from assets [Alexandru Costache]
• Jetson-tx2: Add flashing support for L4T 32.2 [Alexandru Costache]

0.3.0 - 2019-11-14

• Jetson-nano: Use image RP1 dtb and BMP [Alexandru Costache]

0.2.0 - 2019-10-03

• Jetson-xavier: Use image BMP partitions [Alexandru Costache]
• Support Jetson Xavier [Alexandru Costache]

0.1.0 - 2019-09-25

• Replicate jetson-nano sd-card layout offsets [Alexandru Costache]
• Support the Nano machine [Theodor Gherzan]
• Only adjust runtime flag's value if it is actually passed to script [Gergely Imreh]