WIP: NVIDIA Jetson GPU etc. driver installation

DC-nvidia-jetson

@@ -0,0 +1,17 @@
+# This file originates from the project https://github.com/openSUSE/doc-kit
+# This file can be edited downstream.
+
+MAIN="nvidia-jetson.asm.xml"
+# Point to the ID of the <structure> of your assembly
+ROOTID="nvidia-jetson"
+SRC_DIR="articles"
+IMG_SRC_DIR="images"
+
+PROFCONDITION="suse-product"
+#PROFCONDITION="suse-product;beta"
+#PROFCONDITION="community-project"
+
+STYLEASSEMBLY="/usr/share/xml/docbook/stylesheet/nwalsh5/current/assembly/assemble.xsl"
+
+STYLEROOT="/usr/share/xml/docbook/stylesheet/suse2022-ns"
+FALLBACK_STYLEROOT="/usr/share/xml/docbook/stylesheet/suse-ns"

articles/nvidia-jetson.asm.xml

@@ -0,0 +1,294 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- This file originates from the project https://github.com/openSUSE/doc-kit -->
+<!-- This file can be edited downstream. -->
+<!DOCTYPE assembly
+[
+    <!ENTITY % entities SYSTEM "../common/generic-entities.ent">
+    %entities;
+]>
+<!-- refers to legacy doc: <add github link to legacy doc piece, if applicable> -->
+<!-- point back to this document with a similar comment added to your legacy doc piece -->
+<!-- refer to README.md for file and id naming conventions -->
+<assembly version="5.2" xml:lang="en"
+          xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:trans="http://docbook.org/ns/transclusion"
+          xmlns:its="http://www.w3.org/2005/11/its"
+          xmlns:xi="http://www.w3.org/2001/XInclude"
+          xmlns="http://docbook.org/ns/docbook">
+  <!-- resources section references all topic chunks used in the final article
+    -->
+  <!-- R E S O U R C E S -->
+  <!-- Glue files -->
+  <!--<resources>
+    <resource xml:id="_glue-example" href="../glues/glue.xml">
+      <description>Glue example</description>
+    </resource>
+    <resource xml:id="_glue-more-info" href="../glues/glue-more-info.xml">
+      <description>Glue for more information</description>
+    </resource>
+    <resource xml:id="_glue-whats-next" href="../glues/glue-whats-next.xml">
+      <description>Glue what's next</description>
+    </resource>
+  </resources>-->
+  <!-- Concept files -->
+  <!--<resources>
+    <resource xml:id="_concept-example" href="../concepts/gpio.xml">
+      <description>Concept example</description>
+    </resource>
+  </resources>-->
+  <!-- Tasks -->
+  <resources>
+    <resource xml:id="_nvidia-jetson-firmware" href="../tasks/nvidia-jetson-firmware.xml">
+      <description>Firmware</description>
+    </resource>
+    <resource xml:id="_nvidia-jetson-sidecar-kmp" href="../tasks/nvidia-jetson-kmp.xml">
+      <description>KMP</description>
+    </resource>
+    <resource xml:id="_nvidia-jetson-sidecar-libs" href="../tasks/nvidia-jetson-libs.xml">
+      <description>Libraries</description>
+    </resource>
+    <resource xml:id="_nvidia-jetson-sidecar-cuda" href="../tasks/nvidia-jetson-cuda.xml">
+      <description>CUDA</description>
+    </resource>
+  </resources>
+  <!-- References -->
+  <!--<resources>
+    <resource xml:id="_reference-example" href="../references/reference.xml">
+      <description>Reference example</description>
+    </resource>
+  </resources>-->
+  <!-- Legal -->
+  <resources>
+    <resource href="../common/legal.xml" xml:id="_legal">
+      <description>Legal Notice</description>
+    </resource>
+    <resource href="../common/license_gfdl1.2.xml" xml:id="_gfdl">
+      <description>GNU Free Documentation License</description>
+    </resource>
+  </resources>
+  <!-- S T R U C T U R E -->
+  <structure renderas="article" xml:id="nvidia-jetson" xml:lang="en">
+    <merge>
+      <title>&nvidia; &jetson; platform (TBD)</title>
+      <subtitle>Subtitle if necessary</subtitle>
+      <!-- Create revision history to enable versioning; add most recent entries at the top. -->
+      <!-- Check https://documentation.suse.com/style/current/single-html/docu_styleguide/#sec-revhistory for detailed instructions-->
+      <revhistory xml:id="rh-nvidia-jetson">
+        <revision><date>2024-05-28</date>
+          <revdescription>
+            <itemizedlist>
+              <!-- Group by type of change (added/removed/changed)-->
+              <listitem><para>Added sections:</para>
+                <itemizedlist>
+                  <listitem><para>Added section on flashing</para></listitem>
+                </itemizedlist>
+              </listitem>
+              <listitem><para>Changed sections:</para>
+                <itemizedlist>
+                  <listitem><para>Updated section on KMP with more detailed uname -r output</para></listitem>
+                  <listitem><para>Extended section on libs with warning for tarball extraction</para></listitem>
+                </itemizedlist>
+              </listitem>
+            </itemizedlist>
+          </revdescription>
+        </revision>
+        <revision><date>2024-05-31</date>
+          <revdescription>
+            <itemizedlist>
+              <listitem><para>Changed sections:</para>
+                <itemizedlist>
+                  <listitem><para>Updated all section with trademark entities</para></listitem>
+                </itemizedlist>
+              </listitem>
+            </itemizedlist>
+          </revdescription>
+        </revision>
+        <revision><date>2024-06-04</date>
+          <revdescription>
+            <itemizedlist>
+              <listitem><para>Changed sections:</para>
+                <itemizedlist>
+                  <listitem><para>Extended section on flashing with tip on board configs</para></listitem>
+                </itemizedlist>
+              </listitem>
+            </itemizedlist>
+          </revdescription>
+        </revision>
+        <revision><date>2024-06-05</date>
+          <revdescription>
+            <itemizedlist>
+              <listitem><para>Changed sections:</para>
+                <itemizedlist>
+                  <listitem><para>Updated section on KMP with diverging instructions for SL Micro 6.0</para></listitem>
+                </itemizedlist>
+              </listitem>
+            </itemizedlist>
+          </revdescription>
+        </revision>
+        <revision><date>2024-06-07</date>
+          <revdescription>
+            <itemizedlist>
+              <listitem><para>Added sections:</para>
+                <itemizedlist>
+                  <listitem><para>Prepared section on containers</para></listitem>
+                </itemizedlist>
+              </listitem>
+              <listitem><para>Changed sections:</para>
+                <itemizedlist>
+                  <listitem><para>Updated section on KMP with new simplified package name</para></listitem>
+                  <listitem><para>Updated section on libs to drop firmware tarball and to simplify for loop deduplicating version numbers</para></listitem>
+                </itemizedlist>
+              </listitem>
+            </itemizedlist>
+          </revdescription>
+        </revision>
+        <revision><date>2024-06-19</date>
+          <revdescription>
+            <itemizedlist>
+              <listitem><para>Changed sections:</para>
+                <itemizedlist>
+                  <listitem><para>Updated section on flashing with links to &nvidia; docs</para></listitem>
+                  <listitem><para>Extended section on flashing with DT fix-up for CX-7 PCIe bridge (<uri>bsc#1226310</uri>)</para></listitem>
+                </itemizedlist>
+              </listitem>
+            </itemizedlist>
+          </revdescription>
+        </revision>
+      </revhistory>
+      <!-- TODO: provide a listing of possible and validatable meta entry values. Maybe in our geekodoc repo? -->
+      <!-- add author's e-mail -->
+      <meta name="maintainer" content="[email protected]" its:translate="no"/>
+      <!-- ISO date of last update as YYYY-MM-DD -->
+      <meta name="updated" content="2024-06-19" its:translate="no"/>
+      <!-- this does not work yet. Use the dm tags listed below for now
+        <meta name="bugtracker" its:translate="no">
+          <phrase role="url">https://bugzilla.suse.com/enter_bug.cgi</phrase>
+          <phrase role="component">Non-product-specific documentation</phrase>
+          <phrase role="product">Smart Docs</phrase>
+          <phrase role="assignee">[email protected]</phrase>
+        </meta>
+        -->
+      <!-- not supported, yet. Use dm: tag for now
+        <meta name="translation" its:translate="no">
+        <phrase role="trans">yes</phrase>
+        <phrase role="language">de-de,cs-cz</phrase>
+        </meta>
+        -->
+      <!-- enter the platform identifier or a list of
+        identifiers, separated by ; -->
+      <!-- For a full list of meta tags and their values,
+	   see https://confluence.suse.com/x/aQDWNg
+      -->
+      <meta name="architecture">
+        <phrase>&aarch64;</phrase>
+      </meta>
+      <!-- enter one or more product names and version -->
+      <meta name="productname" its:translate="no">
+        <productname version="15.6">&sles;</productname>
+        <productname version="6.0">&slm;</productname>
+      </meta>
+      <meta name="title" its:translate="yes">&nvidia; &jetson; on &suse; how-to</meta>
+      <meta name="description" its:translate="yes">How to configure and complement &suse; Linux on &nvidia; &jetson; platforms</meta>
+      <meta name="social-descr" its:translate="yes">Installing &suse; Linux on your &nvidia; &jetson; device</meta>
+      <!-- suitable categories -->
+      <meta name="category">
+        <phrase>3rd Party</phrase>
+        <phrase>Systems Management</phrase>
+      </meta>
+      <!-- Determines "filter by task" filter value -->
+      <meta name="task">
+        <phrase>Configuration</phrase>
+        <phrase>Deployment</phrase>
+        <phrase>Installation</phrase>
+      </meta>
+      <meta name="series">Products &amp; Solutions</meta>
+
+      <dm:docmanager xmlns:dm="urn:x-suse:ns:docmanager">
+        <dm:bugtracker>
+          <dm:url>https://bugzilla.suse.com/enter_bug.cgi</dm:url>
+          <dm:component>Smart Docs</dm:component>
+          <dm:product>Documentation</dm:product>
+          <!-- provide your BUGZILLA e-mail address, otherwise this does not work correctly-->
+          <dm:assignee>[email protected]</dm:assignee>
+        </dm:bugtracker>
+        <dm:translation>yes</dm:translation>
+      </dm:docmanager>
+      <abstract>
+      <variablelist>
+        <varlistentry>
+          <term>WHAT?</term>
+          <listitem>
+            <para>
+              How to combine &suse; and third-party software for &nvidiareg; &jetsonreg; platforms
+            </para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>WHY?</term>
+          <listitem>
+            <para>
+              &suse; Linux software can install on &nvidia; &jetson; systems
+              but does not include drivers for all hardware functionality.
+            </para>
+          </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>EFFORT</term>
+            <listitem>
+              <para>
+                What's the effort one has to put in?
+              </para>
+            </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>GOAL</term>
+            <listitem>
+              <para>
+                Fully exploit &nvidia; &jetson; hardware capabilities
+                while enjoying &suse; software security and support services
+              </para>
+            </listitem>
+        </varlistentry>
+        <varlistentry>
+          <term>REQUIREMENTS</term>
+            <listitem>
+              <itemizedlist>
+                <listitem>
+                  <para>
+                    &nvidia; &jetson; based system with &nvidia; &orinreg; chipset
+                  </para>
+                </listitem>
+                <listitem>
+                  <para>
+                    &nvidia; &jetpackreg; SDK 6.0 software
+                  </para>
+                </listitem>
+              </itemizedlist>
+            </listitem>
+          </varlistentry>
+        </variablelist>
+      </abstract>
+    </merge>
+    <!-- pull in all the topic files you need -->
+    <!-- pick the appropriate type of include to match your needs -->
+    <!-- pull in a topic as is -->
+    <!--<module resourceref="_glue-example" renderas="section"/>-->
+    <!-- pull in a topic and switch the title -->
+    <!--<module resourceref="_concept-example" renderas="section">
+      <merge>
+        <title>You are a very special concept now!</title>
+      </merge>
+    </module>-->
+    <module resourceref="_nvidia-jetson-firmware" renderas="section"/>
+    <module resourceref="_nvidia-jetson-sidecar-kmp" renderas="section"/>
+    <module resourceref="_nvidia-jetson-sidecar-libs" renderas="section"/>
+    <module resourceref="_nvidia-jetson-sidecar-cuda" renderas="section"/>
+    <!--<module resourceref="_reference-example" renderas="section"/>
+    <module resourceref="_glue-more-info" renderas="section"/>
+    <module resourceref="_glue-whats-next" renderas="section"/>-->
+    <module resourceref="_legal"/>
+    <module resourceref="_gfdl">
+      <output renderas="appendix"/>
+    </module>
+  </structure>
+</assembly>

common/generic-entities.ent

@@ -179,6 +179,7 @@ use &deng;! -->
 <!ENTITY ms                     "Microsoft">
 <!ENTITY msreg                  "<trademark xmlns='http://docbook.org/ns/docbook' class='registered'>&ms;</trademark>">
 <!ENTITY nvidia                 "NVIDIA">
+<!ENTITY nvidiareg              "&nvidia;*">
 <!ENTITY rh                     "Red Hat">
 <!ENTITY redhat                 "&rh;">
 <!ENTITY sap                    "SAP">
@@ -200,6 +201,17 @@ use &deng;! -->
 <!ENTITY rhla                   "RHEL">
 <!ENTITY rpios                  "Raspberry&nbsp;Pi&nbsp;OS">
 <!ENTITY centos                 "CentOS">
+<!-- NVIDIA products -->
+<!ENTITY cuda                   "CUDA">
+<!ENTITY cudareg                "&cuda;*">
+<!ENTITY jetson                 "Jetson">
+<!ENTITY jetsonreg              "&jetson;*">
+<!ENTITY jetpack                "JetPack">
+<!ENTITY jetpackreg             "&jetpack;*">
+<!ENTITY xavier                 "Xavier">
+<!ENTITY xavierreg              "&xavier;*">
+<!ENTITY orin                   "Orin">
+<!ENTITY orinreg                "&orin;*">