Firmware files for NVIDIA Tegra devices
=======================================

This package contains proprietary firmware extracted from the
nvidia-l4t-firmware package from NVIDIA's Jetson Linux distribution and needed
for all hardware components to work on NVIDIA Tegra devices.

The rest of this README is for the benefit of package maintainers.

Maintainer notes
----------------

The package maintainer would typically update this package when NVIDIA
publishes a new version of the nvidia-l4t-firmware package for the same Jetson
series tracked in the corresponding Ubuntu tracks (e.g. r36.x series for Ubuntu
22.04).

The commands below document different workflows, and all assume that:
- you're in an unpacked package directory
- the NVIDIA nvidia-l4t-firmware deb is/will be placed in the parent directory
  (e.g. ../nvidia-l4t-firmware_*.deb)


Workflow 1: Create .orig.tar.xz from latest public nvidia-l4t-firmware
----------------------------------------------------------------------

To get the latest public version of the nvidia-l4t-firmware deb package from
NVIDIA's 36.4 release series and create the related orig tarball, run:

    debian/rules get-orig-source JETSON_REL=36.4

Alternatively, if you only want to download the nvidia-l4t-firmware deb
package without creating the upstream tarball:

    debian/rules get-jetson-deb JETSON_REL=36.4


Workflow 2. Create .orig.tar.xz for a private version of nvidia-l4t-firmware
----------------------------------------------------------------------------

To create an orig tarball from a local deb (for instance a private release from
NVIDIA), copy nvidia-l4t-firmware in the parent direcoty, for instance as
../nvidia-l4t-firmware_36.2.0-20231218214829_arm64.deb and run:
    debian/rules get-orig-source JETSON_REL=36.2.0-20231218214829

Workflow 3. Updating to a new version
-------------------------------------

Once you've generated a new orig tarball, you can update the packaging to the
new upstream version with uupdate. This is how you'd download, package, and
build a new upstream version:

    debian/rules get-orig-source JETSON_REL=36.4

    # Run uupdate against the linux-firmware-nvidia-tegra orig tarball just
    # created, tag the version with the complete revision of that tarball
    uupdate -v 36.4.0-20240912212859 \
     ../linux-firmware-nvidia-tegra_36.4.0-20240912212859.orig.tar.xz

    # Build the package
    cd ../linux-firmware-nvidia-tegra-36.4.0-20240912212859
    dpkg-buildpackage -S

