5G Cards on Jetson Orin™ Enablement

Application Note

80455NT11986A Rev. 2 – 2023-02-06

 5G Cards on Jetson Orin Enablement Application Note

APPLICABILITY TABLE
PRODUCTS
FN980

FN980m

FN990

80455NT11986A Rev. 2 Page 2 of 31 2023-02-06

 5G Cards on Jetson Orin Enablement Application Note

CONTENTS
APPLICABILITY TABLE 2
CONTENTS 3
1. INTRODUCTION 5
Scope 5
Audience 5
Contact Information, Support 5
Symbol Conventions 6
2. 5G CARDS AND JETSON ORIN PLATFORMS 7
Overview 7
Initial Prerequisites 7
Writing Conventions 7
3. CUSTOMIZING JETSON LINUX KERNEL 8
Customizing Jetson Linux 34.1.1 Kernel 8
3.1.1. Understanding the Need for Customizing the Kernel 8
3.1.2. Building the Kernel Modules 8
3.1.3. Copying the Kernel Modules to the Developer Kit 10
Customizing Jetson Linux 35.2.0 and later Kernel 11
4. USING 5G CARDS WITH MODEMMANAGER 12
What is ModemManager 12
Setting the MBIM Composition 12
Checking Modem Detection 13
Setting-up the Data Connection 16
5. UPGRADING MODEMMANAGER 19
Understanding the Need for Upgrading ModemManager 19
Upgrading from packages in Focal Developer Repositories 19
Building from freedesktop.org git Repositories 20
5.3.1. Uninstalling the Default Packages 20
5.3.2. Build Preconditions 20
5.3.3. Building libqrtr 20
5.3.4. Building libmbim 21
5.3.5. Building libqmi 21
5.3.6. Building ModemManager 22

80455NT11986A Rev. 2 Page 3 of 31 2023-02-06

 5G Cards on Jetson Orin Enablement Application Note

6. TROUBLESHOOTING 23
Debug Information Retrieval 23

7. PRODUCT AND SAFETY INFORMATION 24

Copyrights and Other Notices 24
7.1.1. Copyrights 24
7.1.2. Computer Software Copyrights 24
Usage and Disclosure Restrictions 25
7.2.1. License Agreements 25
7.2.2. Copyrighted Materials 25
7.2.3. High-Risk Materials 25
7.2.4. Trademarks 25
7.2.5. Third-Party Rights 26
7.2.6. Waiver of Liability 26
Safety Recommendations 26
8. GLOSSARY 28
9. RELATED DOCUMENTS 29
10. DOCUMENT HISTORY 30

80455NT11986A Rev. 2 Page 4 of 31 2023-02-06

 5G Cards on Jetson Orin Enablement Application Note

1. INTRODUCTION

Scope
This document describes the standard operating procedure to enable Telit 5G cards
belonging to the FN980 and FN990 series in the NVIDIA® Jetson Orin™ Developer Kit. The
features and solutions described in this document are applicable to all variants listed in
the applicability table.

Audience
This document is intended for developers using Telit 5G cards in the NVIDIA® Jetson
Orin™ Developer Kit.

Contact Information, Support

For technical support and general questions please e-mail:
• [email protected]
• [email protected]
• [email protected]
• [email protected]
• [email protected]
Alternatively, use:
https://www.telit.com/contact-us/
Product information and technical documents are accessible 24/7 on our web site:
https://www.telit.com

80455NT11986A Rev. 2 Page 5 of 31 2023-02-06

 5G Cards on Jetson Orin Enablement Application Note

Symbol Conventions

Danger: This information MUST be followed or catastrophic

equipment failure or personal injury may occur.

Warning: Alerts the user on important steps about the module

integration.

Note/Tip: Provides advice and suggestions that may be useful when

integrating the module.

Electro-static Discharge: Notifies the user to take proper grounding

precautions before handling the product.

All dates are in ISO 8601 format, that is YYYY-MM-DD.

80455NT11986A Rev. 2 Page 6 of 31 2023-02-06

 5G Cards on Jetson Orin Enablement Application Note

2. 5G CARDS AND JETSON ORIN PLATFORMS

Overview
Telit modems belonging to the FN980 and FN990 series enable a new generation of 5G
state-of-the-art data cards featuring both sub-6 and mmWave technologies with LTE,
WCDMA and GNSS support. These data cards lay the foundation for businesses
worldwide to future-proof IoT, enterprise applications and video while leveraging all 5G’s
and Gigabit LTE’s benefits immediately.

NVIDIA® Jetson is the world's leading platform for AI at the edge. It combines high-
performance, low-power compute modules with the NVIDIA AI software stack. It’s the
ideal platform for advanced robotics and other autonomous products.

This Application Note explains the steps needed to enable Telit 5G cards on the NVIDIA®
Jetson Orin™ Developer Kit.

Initial Prerequisites
The following mandatory prerequisites must be fulfilled for successfully implementing
the contents of this Application Note:

• The Orin™ Developer Kit in use must be running at least Jetson Linux
34.1.1. If this prerequisite is not verified, please update the Developer Kit to
at least Jetson Linux 34.1.1 following the Jetson Linux Developer Guide.
• The USB composition for the modems should be the following:
o Telit FN980: 0x1051 (MBIM)
o Telit FN990: 0x1071 (MBIM)
In paragraph 4.2 it is explained how to set the correct USB composition in
case this prerequisite is not verified.
• The initial Orin™ Developer Kit setup requires Internet connection (e.g.
through WiFi or Ethernet).

Writing Conventions
In this Application Note the commands to be typed in a Linux terminal are written in
Courier New, with the following prefix meaning:

• telit@JetsonOrin: commands to be typed in the Orin™ Developer Kit.

• telit@buildMachine: commands to be typed in a x64 Intel Linux build
machine.

80455NT11986A Rev. 2 Page 7 of 31 2023-02-06

 5G Cards on Jetson Orin Enablement Application Note

3. CUSTOMIZING JETSON LINUX KERNEL

Customizing Jetson Linux 34.1.1 Kernel

3.1.1. Understanding the Need for Customizing the Kernel

Jetson Linux 34.1.1 comes with Linux kernel v5.10.65, as can be seen sending the
following command through a terminal in the Developer Kit:

telit@JetsonOrin:~$ uname -r
5.10.65-tegra

The kernel modules needed to drive Telit 5G mobile broadband devices are not available
in the default Jetson Linux 34.1.1 kernel build: in the following paragraphs it is explained
how to build these kernel modules and how to copy them to the Developer Kit.

Kernel version 5.10.65 does not have support for FN990 in kernel
modules option and cdc_mbim.

To use the FN990, before building the kernel, the following commits
available in v5.10.104 should be back-ported:
• cd98cb5216a01f13296f759f790a1310c648d4c9, USB:
serial: option: add Telit FN990 compositions
• 00d5ac05af3a126e1fbd11a3309478b2b3b0296e, net:
usb: cdc_mbim: avoid altsetting toggling for
Telit FN990

3.1.2. Building the Kernel Modules

There are various methods to build the kernel modules: in this Application Note it is
explained how to cross-compile the kernel in a Linux Intel x64 host to get the needed
modules.

80455NT11986A Rev. 2 Page 8 of 31 2023-02-06

 5G Cards on Jetson Orin Enablement Application Note

Performing a kernel build requires the presence of specific packages

in the build machine: please refer to the instructions for the Linux
distribution used in the build machine for further instructions.

As an example, when using Ubuntu 21.04 the following command

should be enough to collect all the needed packages to perform a
kernel build:
$ sudo apt install build-essential binutils-doc debian-
keyring g++-multilib g++-10-multilib gcc-10-doc gcc-multilib
autoconf automake libtool flex bison gcc-doc gcc-10-multilib
gcc-10-locales glibc-doc git bzr libstdc++-10-doc make-doc
diffutils-doc autoconf-archive gnu-standards autoconf-doc
gettext libncurses-dev pkg-config libssl-dev libelf-dev
libdwarf-dev dwarves zstd

Download Bootlin Toolchain gcc 9.3 and extract the package as explained in Jetson Linux
Toolchain page.

Download L4T Driver Package (BSP) having the kernel sources and extract them as
explained in the Kernel Customization page.

In the build machine, go to the directory Linux_for_Tegra/source/public and type in a

terminal:

telit@buildMachine:~$ export ARCH=arm64

telit@buildMachine:~$ export CROSS_COMPILE_AARCH64_PATH=$HOME/l4t-gcc

Modify the script nvbuild.sh, adding the highlighted line:

"${MAKE_BIN}" -C "${source_dir}" ARCH=arm64 \

LOCALVERSION="-tegra" \
CROSS_COMPILE="${CROSS_COMPILE_AARCH64}" \
"${O_OPT[@]}" "${config_file}"

"${MAKE_BIN}" -C "${source_dir}" ARCH=arm64 \

LOCALVERSION="-tegra" \
CROSS_COMPILE="${CROSS_COMPILE_AARCH64} \
"${O_OPT[@]}" menuconfig

"${MAKE_BIN}" -C "${source_dir}" ARCH=arm64 \

LOCALVERSION="-tegra" \
CROSS_COMPILE="${CROSS_COMPILE_AARCH64}" \
"${O_OPT[@]}" -j"${NPROC}" \
--output-sync=target Image

The modified script is available in Telit github repository dedicated

to 5G cards enablement on NVIDIA® Jetson Orin™

80455NT11986A Rev. 2 Page 9 of 31 2023-02-06

 5G Cards on Jetson Orin Enablement Application Note

Create the kernel output directory:

telit@buildMachine:~$ mkdir kernel_out

And start the build:

telit@buildMachine:~$ ./nvbuild.sh -o $PWD/kernel_out

Once the kernel configuration menu shows, add the following module (<M>):

Device Drivers ---> Network device support ---> USB Network Adapters
<M> CDC MBIM support

Save the configuration, exit and the build will start.

Once the build is finished, checkout the following files availability:

kernel_out/drivers/net/usb/cdc_mbim.ko
kernel_out/drivers/usb/class/cdc-wdm.ko

The prebuilt kernel modules are available in Telit github repository

dedicated to FN980 enablement on NVIDIA® Jetson Orin™

3.1.3. Copying the Kernel Modules to the Developer Kit

The built kernel modules need to be copied to the Developer Kit: choose the most
convenient way for your setup (e.g. using an USB Flash drive).

80455NT11986A Rev. 2 Page 10 of 31 2023-02-06

 5G Cards on Jetson Orin Enablement Application Note

In this Application Note it is supposed the kernel modules to be available in path <kernel
modules origin> accessible from the Developer Kit.
In the Developer Kit open a terminal and type:

telit@JetsonOrin:~$ sudo cp <kernel modules origin>/cdc_mbim.ko

/lib/modules/5.10.65-tegra/kernel/drivers/net/usb
telit@JetsonOrin:~$ sudo cp <kernel modules origin>/cdc-wdm.ko
/lib/modules/5.10.65-tegra/kernel/drivers/usb/class
telit@JetsonOrin:~$ sudo depmod -a
telit@JetsonOrin:~$ sudo modprobe cdc_mbim

Check the result of the operation by typing:

telit@JetsonOrin:~$ dmesg | grep -i cdc_mbim

The output of this command should be something like:

[ 397.313608] usbcore: registered new interface driver cdc_mbim

On the kernel side everything is now ready for using the modem.

Customizing Jetson Linux 35.2.0 and later Kernel

Since Jetson Linux 35.2.0 the default kernel build does not require any customization,
having it already the needed kernel modules for driving Telit 5G mobile broadband
devices. Commits back-port is not needed also, since the kernel version is 5.10.104.

80455NT11986A Rev. 2 Page 11 of 31 2023-02-06

 5G Cards on Jetson Orin Enablement Application Note

4. USING 5G CARDS WITH MODEMMANAGER

What is ModemManager
Freedesktop.org ModemManager is a DBus-activated daemon which controls mobile
broadband (2G/3G/4G) devices and connections.
ModemManager provides a unified high level API for communicating with mobile
broadband modems, regardless of the protocol used to communicate with the actual
device (AT commands, MBIM, QMI).

For managing non AT-based modems, ModemManager uses external libraries:

freedesktop.org libqmi for QMI-based modems, libmbim for MBIM-based modems.
ModemManager can be used with freedesktop.org NetworkManager for easier network
connections management.
ModemManager version can be checked with the following command:

telit@JetsonOrin:~$ mmcli -V
mmcli 1.16.6
Copyright (2011 - 2021) Aleksander Morgado
License GPLv2+: GNU GPL version 2 or later http://gnu.org/licenses/gpl-
2.0.html
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.

Though this version is no more actively developed, it can be used for managing Telit 5G
cards, noting that it has some limitations. Chapter 5 explains how to move to a more
recent ModemManager version: this step is warmly recommended since new features
and bugfixing are constantly added to the tool.

The following paragraphs just focus on the FN980, but the same steps can be used for
verifying the FN990 functioning.

If ModemManager is not installed in the used setup, type:

telit@JetsonOrin:~$ sudo apt install modemmanager

Setting the MBIM Composition

The first step is to set the correct MBIM composition (0x1051 for FN980, 0x1071 for
FN990). The following explanation just focuses on FN980: for FN990 it is enough to
consider 0x1071 instead of 0x1051.
Stop ModemManager service by typing:

80455NT11986A Rev. 2 Page 12 of 31 2023-02-06

 5G Cards on Jetson Orin Enablement Application Note

telit@JetsonOrin:~$ sudo service ModemManager stop

Plug the modem to the Developer Kit through the USB-C cable and turn it on. Verify the
modem presence in the kernel log:

telit@JetsonOrin:~$ dmesg | grep -I =1050

This command should return an output like the following:

[ 3644.097734] usb 1-1: New USB device found, idVendor=1bc7, idProduct=1050,

bcdDevice= 4.14

If the number highlighted in the line above is 1051, skip the following steps and move to
the next paragraph, otherwise install the serial terminal emulator minicom by typing:

telit@JetsonOrin:~$ sudo apt install minicom

Start the terminal emulator:

telit@JetsonOrin:~$ sudo minicom -D /dev/ttyUSB2

and type the following AT command:

AT#USBCFG=2

There should be an output like the following:

Welcome to minicom 2.7.1

OPTIONS: I18n
Compiled on Dec 23 2019, 02:06:26.
Port /dev/ttyUSB2, 10:33:17

Press CTRL-A Z for help on special keys

AT#USBCFG=2
OK

This command makes the modem to reboot. Wait until the new composition shows-up:

telit@JetsonOrin:~$ dmesg -w | grep -I =1051

[ 3644.097734] usb 1-1: New USB device found, idVendor=1bc7, idProduct=1051,
bcdDevice= 4.14

The modem is now ready for use.

Checking Modem Detection

Verify that ModemManager is properly running by typing:

80455NT11986A Rev. 2 Page 13 of 31 2023-02-06

 5G Cards on Jetson Orin Enablement Application Note

telit@JetsonOrin:~$ systemctl status ModemManager.service

The returned output should be like:

● ModemManager.service - Modem Manager

Loaded: loaded (/lib/systemd/system/ModemManager.service; enabled;
vendor preset: enabled)
Active: active (running) since Thu 2022-06-09 12:06:25 CEST; 4s ago

If ModemManager is not running, start the service:

telit@JetsonOrin:~$ sudo service ModemManager start

After a while (up to 120 seconds) the modem should be detected by ModemManager.
Verify its presence by typing:

telit@JetsonOrin:~$ mmcli -L
/org/freedesktop/ModemManager1/Modem/0 [Telit Wireless Solutions] FN980m

and for additional details on the modem:

telit@JetsonOrin:~$ mmcli -m 0
----------------------------------
General | path: /org/freedesktop/ModemManager1/Modem/0
| device id: c7244bee3c978377afcf894ac0ddd30d1a0d3f71
----------------------------------
Hardware | manufacturer: Telit Wireless Solutions
| model: FN980m
| firmware revision: SDX55.LE.1.4.r1-00046-NBOOT.CP
| carrier config: default
| h/w revision: FN980m
| supported: cdma-evdo, gsm-umts, lte, 5gnr
| current: gsm-umts, lte
| equipment id: 350313450033520
----------------------------------
System | device:
/sys/devices/platform/3610000.xhci/usb1/1-1
| drivers: cdc_mbim, option
| plugin: telit
| primary port: cdc-wdm0
| ports: cdc-wdm0 (mbim), ttyUSB0 (ignored),
ttyUSB1 (ignored),
| ttyUSB2 (at), ttyUSB3 (at), ttyUSB4
(ignored), wwan0 (net)
----------------------------------
Status | unlock retries: sim-pin2 (3)
| state: registered
| power state: on
| access tech: lte
| signal quality: 19% (recent)
----------------------------------
Modes | supported: allowed: 3g; preferred: none

80455NT11986A Rev. 2 Page 14 of 31 2023-02-06

 5G Cards on Jetson Orin Enablement Application Note

| allowed: 4g; preferred: none

| allowed: 3g, 4g; preferred: none
| allowed: 3g, 4g, 5g; preferred: none
| current: allowed: 3g, 4g; preferred: none
----------------------------------
IP | supported: ipv4, ipv6, ipv4v6
----------------------------------
3GPP | imei: 350313450033520
| enabled locks: fixed-dialing
| operator id: 22210
| operator name: vodafone IT
| registration: home
----------------------------------
3GPP EPS | ue mode of operation: csps-2
| initial bearer path: /org/freedesktop/ModemManager1/Bearer/0
| initial bearer ip type: ipv4v6
----------------------------------
SIM | primary sim path: /org/freedesktop/ModemManager1/SIM/0

where the argument of the flag -m is the index of the modem found with the previous
command.

Modem availability should also be indicated in the Network menu of the GUI:

Figure 1: FN980 mobile broadband device in Network menu

80455NT11986A Rev. 2 Page 15 of 31 2023-02-06

 5G Cards on Jetson Orin Enablement Application Note

When using a ModemManager version > 1.16, the Gnome Mobile

Broadband applet version is not able to show the mobile broadband
device in the menu bar.

For configuring the mobile broadband data connection the Network

panel in Gnome Settings can be used.

Setting-up the Data Connection

To setup the data connection through the GUI, left-click on the Mobile Broadband Off
entry in the Network GUI and then click on Connect:

Figure 2: Connect menu entry

The Mobile Broadband Connection Wizard shows-up:

80455NT11986A Rev. 2 Page 16 of 31 2023-02-06

 5G Cards on Jetson Orin Enablement Application Note

Figure 3: Mobile broadband connection wizard

Follow the instructions according to the network operator in use. If everything is fine the
created data connection will be set as active:

Figure 4: Mobile broadband connected

80455NT11986A Rev. 2 Page 17 of 31 2023-02-06

 5G Cards on Jetson Orin Enablement Application Note

If the data connection is not able to start please verify the modem
setup and the information provided (e.g. antenna, signal level, APN…)

80455NT11986A Rev. 2 Page 18 of 31 2023-02-06

 5G Cards on Jetson Orin Enablement Application Note

5. UPGRADING MODEMMANAGER

Understanding the Need for Upgrading ModemManager

ModemManager is a fast-paced project, constantly evolving. Developers and power-
users could decide to upgrade to a more recent ModemManager version than the default
one, for taking advantages of bugfixes and new features.

In the following paragraphs two alternative ways of upgrading ModemManager are

described.

When using a ModemManager versopm > 1.16, the Gnome Mobile

Broadband applet version is not able to show anymore the mobile
broadband device in the menu bar.

For configuring the mobile broadband data connection the Network

panel in Gnome Settings can be used.

Upgrading from packages in Focal Developer Repositories

Enable focal-proposed updates in Software & Updates -> Developer Options settings:

Figure 5: Software & Updates Developer Options settings

Install the updated ModemManager by typing:

telit@JetsonOrin:~$ sudo apt install modemmanager

Follow the instructions in paragraph 4.3.

80455NT11986A Rev. 2 Page 19 of 31 2023-02-06

 5G Cards on Jetson Orin Enablement Application Note

Building from freedesktop.org git Repositories

Building tools from source code gathered from freedesktop.org git repositories (branch
main) is warmly recommended to have the most up-to-date tools with new features and
bugfixes.

5.3.1. Uninstalling the Default Packages

Building from sources requires first to completely uninstall the previous ModemManager
related software versions by typing:

telit@JetsonOrin:~$ sudo apt purge modemmanager libmbim-glib4 libmbim-proxy

libqmi-glib5 libqmi-proxy

5.3.2. Build Preconditions

To build ModemManager and the related libraries, some additional packages are
required. They can be installed by typing:

telit@JetsonOrin:~/git$ sudo apt install meson libgudev-1.0-dev help2man

libdbus-1-dev libsystemd-dev libpolkit-gobject-1-dev gettext xsltproc

Create the directory for the build:

telit@JetsonOrin:~$ mkdir $HOME/git

telit@JetsonOrin:~$ cd $HOME/git/

5.3.3. Building libqrtr

Clone the libqrtr git repository by typing:

telit@JetsonOrin:~/git$ git clone https://gitlab.freedesktop.org/mobile-

broadband/libqrtr-glib.git
telit@JetsonOrin:~/git$ cd libqrtr-glib

Configure the build:

telit@JetsonOrin:~/git/libqrtr-glib$ meson setup build --prefix=/usr --

libdir=/usr/lib/aarch64-linux-gnu --buildtype=release -Dgtk_doc=false -
Dintrospection=false

Start the build:

telit@JetsonOrin:~/git/libqrtr-glib$ cd build/
telit@JetsonOrin:~/git/libqrtr-glib/build$ ninja

Install the binaries:

telit@JetsonOrin:~/git/libqrtr-glib/build$ sudo ninja install

80455NT11986A Rev. 2 Page 20 of 31 2023-02-06

 5G Cards on Jetson Orin Enablement Application Note

Go back to the git parent directory:

telit@JetsonOrin:~$ cd $HOME/git/

5.3.4. Building libmbim

Clone the libmbim git repository by typing:

telit@JetsonOrin:~/git$ git clone https://gitlab.freedesktop.org/mobile-

broadband/libmbim.git
telit@JetsonOrin:~/git$ cd libmbim

Configure the build:

telit@JetsonOrin:~/git/libmbim$ meson setup build --prefix=/usr --

libdir=/usr/lib/aarch64-linux-gnu --buildtype=release -Dgtk_doc=false -
Dintrospection=false -Dbash_completion=false

Start the build:

telit@JetsonOrin:~/git/libmbim$ cd build/
telit@JetsonOrin:~/git/libmbim/build$ ninja

Install the binaries:

telit@JetsonOrin:~/git/libmbim/build$ sudo ninja install

Go back to the git parent directory:

telit@JetsonOrin:~$ cd $HOME/git/

5.3.5. Building libqmi

Clone the libqmi git repository by typing:

telit@JetsonOrin:~/git$ git clone https://gitlab.freedesktop.org/mobile-

broadband/libqmi.git
telit@JetsonOrin:~/git$ cd libqmi

Configure the build:

telit@JetsonOrin:~/git/libqmi$ meson setup build --prefix=/usr --

libdir=/usr/lib/aarch64-linux-gnu --buildtype=release -Dcollection=full -
Dmbim_qmux=true -Dqrtr=true -Dgtk_doc=false -Dintrospection=false -
Dbash_completion=false

Start the build:

telit@JetsonOrin:~/git/libqmi$ cd build/
telit@JetsonOrin:~/git/libqmi/build$ ninja

80455NT11986A Rev. 2 Page 21 of 31 2023-02-06

 5G Cards on Jetson Orin Enablement Application Note

Install the binaries:

telit@JetsonOrin:~/git/libqmi/build$ sudo ninja install

Go back to the git parent directory:

telit@JetsonOrin:~$ cd $HOME/git/

5.3.6. Building ModemManager

Clone the ModemManager git repository by typing:

telit@JetsonOrin:~/git$ git clone https://gitlab.freedesktop.org/mobile-

broadband/ModemManager.git
telit@JetsonOrin:~/git$ cd ModemManager

Configure the build:

telit@JetsonOrin:~/git/ModemManager$ meson setup build --prefix=/usr --

sysconfdir=/etc --libdir=/usr/lib/aarch64-linux-gnu --buildtype=release -
Dqmi=true -Dmbim=true -Dqrtr=true -Dsystemd_suspend_resume=false -
Dgtk_doc=false -Dintrospection=false -Dbash_completion=false

Start the build:

telit@JetsonOrin:~/git/ModemManager$ cd build/
telit@JetsonOrin:~/git/ModemManager/build$ ninja

Install the binaries:

telit@JetsonOrin:~/git/ModemManager/build$ sudo ninja install

ModemManager is now installed: follow the instructions in paragraph 4.3.

80455NT11986A Rev. 2 Page 22 of 31 2023-02-06

 5G Cards on Jetson Orin Enablement Application Note

6. TROUBLESHOOTING

Debug Information Retrieval

When contacting customer support for help on troubleshooting issues, please make sure
to carefully describe the scenario and provide the following logs:
• Kernel log

• ModemManager and NetworkManager debug log (following the instructions

available at mobile-broadband.pages.freedesktop.org)

To have better support and solve the issue quickly, please follow
these guidelines when collecting logs:
• Do not mix different issues in a single log
• Do not mix different runs of the same issue
• If the log is huge, provide an indication on the timing of the
issue
• Provide a brief description of scenario captured in the logs

80455NT11986A Rev. 2 Page 23 of 31 2023-02-06

 5G Cards on Jetson Orin Enablement Application Note

7. PRODUCT AND SAFETY INFORMATION

Copyrights and Other Notices

SPECIFICATIONS ARE SUBJECT TO CHANGE WITHOUT NOTICE

Although reasonable efforts have been made to ensure the accuracy of this document,
Telit assumes no liability resulting from any inaccuracies or omissions in this document,
or from the use of the information contained herein. The information contained in this
document has been carefully checked and is believed to be reliable. Telit reserves the
right to make changes to any of the products described herein, to revise it and to make
changes from time to time without any obligation to notify anyone of such revisions or
changes. Telit does not assume any liability arising from the application or use of any
product, software, or circuit described herein; neither does it convey license under its
patent rights or the rights of others.

This document may contain references or information about Telit’s products (machines
and programs), or services that are not announced in your country. Such references or
information do not necessarily mean that Telit intends to announce such Telit products,
programming, or services in your country.

7.1.1. Copyrights
This instruction manual and the Telit products described herein may include or describe
Telit copyrighted material, such as computer programs stored in semiconductor
memories or other media. The laws in Italy and in other countries reserve to Telit and its
licensors certain exclusive rights for copyrighted material, including the exclusive right
to copy, reproduce in any form, distribute and make derivative works of the copyrighted
material. Accordingly, any of Telit’s or its licensors’ copyrighted material contained
herein or described in this instruction manual, shall not be copied, reproduced,
distributed, merged or modified in any way without the express written permission of the
owner. Furthermore, the purchase of Telit products shall not be deemed to grant in any
way, neither directly nor by implication, or estoppel, any license.

7.1.2. Computer Software Copyrights

Telit and the Third-Party supplied Software (SW) products, described in this instruction
manual may include Telit’s and other Third-Party’s copyrighted computer programs
stored in semiconductor memories or other media. The laws in Italy and in other
countries reserve to Telit and other Third-Party, SW exclusive rights for copyrighted
computer programs, including – but not limited to - the exclusive right to copy or

80455NT11986A Rev. 2 Page 24 of 31 2023-02-06

 5G Cards on Jetson Orin Enablement Application Note

reproduce in any form the copyrighted products. Accordingly, any copyrighted computer
programs contained in Telit’s products described in this instruction manual shall not be
copied (reverse engineered) or reproduced in any manner without the express written
permission of the copyright owner, being Telit or the Third-Party software supplier.
Furthermore, the purchase of Telit products shall not be deemed to grant either directly
or by implication, estoppel, or in any other way, any license under the copyrights, patents
or patent applications of Telit or other Third-Party supplied SW, except for the normal
non-exclusive, royalty free license to use arising by operation of law in the sale of a
product.

Usage and Disclosure Restrictions

7.2.1. License Agreements

The software described in this document is owned by Telit and its licensors. It is furnished
by express license agreement only and shall be used exclusively in accordance with the
terms of such agreement.

7.2.2. Copyrighted Materials

The Software and the documentation are copyrighted materials. Making unauthorized
copies is prohibited by the law. The software or the documentation shall not be
reproduced, transmitted, transcribed, even partially, nor stored in a retrieval system, nor
translated into any language or computer language, in any form or by any means, without
prior written permission of Telit.

7.2.3. High-Risk Materials

Components, units, or third-party goods used in the making of the product described
herein are NOT fault-tolerant and are NOT designed, manufactured, or intended for use
as on-line control equipment in the following hazardous environments requiring fail-safe
controls: operations of Nuclear Facilities, Aircraft Navigation or Aircraft Communication
Systems, Air Traffic Control, Life Support, or Weapons Systems (“High-Risk Activities").
Telit and its supplier(s) specifically disclaim any expressed or implied warranty of fitness
eligibility for such High-Risk Activities.

7.2.4. Trademarks
TELIT and the Stylized T-Logo are registered in the Trademark Office. All other product
or service names are property of their respective owners.

80455NT11986A Rev. 2 Page 25 of 31 2023-02-06

 5G Cards on Jetson Orin Enablement Application Note

7.2.5. Third-Party Rights

The software may include Third-Party’s software Rights. In this case the user agrees to
comply with all terms and conditions imposed in respect of such separate software
rights. In addition to Third-Party Terms, the disclaimer of warranty and limitation of
liability provisions in this License, shall apply to the Third-Party Rights software as well.

TELIT HEREBY DISCLAIMS ANY AND ALL WARRANTIES EXPRESSED OR IMPLIED FROM
ANY THIRD-PARTY REGARDING ANY SEPARATE FILES, ANY THIRD-PARTY MATERIALS
INCLUDED IN THE SOFTWARE, ANY THIRD-PARTY MATERIALS FROM WHICH THE
SOFTWARE IS DERIVED (COLLECTIVELY “OTHER CODES”), AND THE USE OF ANY OR ALL
OTHER CODES IN CONNECTION WITH THE SOFTWARE, INCLUDING (WITHOUT
LIMITATION) ANY WARRANTIES OF SATISFACTORY QUALITY OR FITNESS FOR A
PARTICULAR PURPOSE.
NO THIRD-PARTY LICENSORS OF OTHER CODES MUST BE LIABLE FOR ANY DIRECT,
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING WITHOUT LIMITATION LOST OF PROFITS), HOWEVER CAUSED AND
WHETHER MADE UNDER CONTRACT, TORT OR OTHER LEGAL THEORY, ARISING IN ANY
WAY OUT OF THE USE OR DISTRIBUTION OF THE OTHER CODES OR THE EXERCISE OF
ANY RIGHTS GRANTED UNDER EITHER OR BOTH THIS LICENSE AND THE LEGAL TERMS
APPLICABLE TO ANY SEPARATE FILES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
DAMAGES.

7.2.6. Waiver of Liability

IN NO EVENT WILL TELIT AND ITS AFFILIATES BE LIABLE FOR AY DIRECT, INDIRECT,
SPECIAL, GENERAL, INCIDENTAL, CONSEQUENTIAL, PUNITIVE OR EXEMPLARY
INDIRECT DAMAGE OF ANY KIND WHATSOEVER, INCLUDING BUT NOT LIMITED TO
REIMBURSEMENT OF COSTS, COMPENSATION OF ANY DAMAGE, LOSS OF
PRODUCTION, LOSS OF PROFIT, LOSS OF USE, LOSS OF BUSINESS, LOSS OF DATA OR
REVENUE, WHETHER OR NOT THE POSSIBILITY OF SUCH DAMAGES COULD HAVE BEEN
REASONABLY FORESEEN, CONNECTD IN ANY WAY TO THE USE OF THE PRODUCT/S OR
TO THE INFORMATION CONTAINED IN THE PRESENT DOCUMENTATION, EVEN IF TELIT
AND/OR ITS AFFILIATES HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES
OR THEY ARE FORESEEABLE OR FOR CLAIMS BY ANY THIRD PARTY.

Safety Recommendations
Make sure the use of this product is allowed in your country and in the environment
required. The use of this product may be dangerous and has to be avoided in areas where:

80455NT11986A Rev. 2 Page 26 of 31 2023-02-06

 5G Cards on Jetson Orin Enablement Application Note

• it can interfere with other electronic devices, particularly in environments such

as hospitals, airports, aircrafts, etc.
• there is a risk of explosion such as gasoline stations, oil refineries, etc. It is the
responsibility of the user to enforce the country regulation and the specific
environment regulation.

Do not disassemble the product; any mark of tampering will compromise the warranty
validity. We recommend following the instructions of the hardware user guides for
correct wiring of the product. The product has to be supplied with a stabilized voltage
source and the wiring has to be conformed to the security and fire prevention regulations.
The product has to be handled with care, avoiding any contact with the pins because
electrostatic discharges may damage the product itself. Same cautions have to be taken
for the SIM, checking carefully the instruction for its use. Do not insert or remove the SIM
when the product is in power saving mode.

The system integrator is responsible for the functioning of the final product. Therefore,
the external components of the module, as well as any project or installation issue, have
to be handled with care. Any interference may cause the risk of disturbing the GSM
network or external devices or having an impact on the security system. Should there be
any doubt, please refer to the technical documentation and the regulations in force. Every
module has to be equipped with a proper antenna with specific characteristics. The
antenna has to be installed carefully in order to avoid any interference with other
electronic devices and has to guarantee a minimum distance from the body (20 cm). In
case this requirement cannot be satisfied, the system integrator has to assess the final
product against the SAR regulation.

The equipment is intended to be installed in a restricted area location.

The equipment must be supplied by an external specific limited power source in
compliance with the standard EN 62368-1.

The European Community provides some Directives for the electronic equipment
introduced on the market. All of the relevant information is available on the European
Community website:
https://ec.europa.eu/growth/sectors/electrical-engineering_en

80455NT11986A Rev. 2 Page 27 of 31 2023-02-06

 5G Cards on Jetson Orin Enablement Application Note

8. GLOSSARY

MBIM Mobile Broadband Interface Model

SDK Software Development Kit
USB Universal Serial Bus

80455NT11986A Rev. 2 Page 28 of 31 2023-02-06

 5G Cards on Jetson Orin Enablement Application Note

9. RELATED DOCUMENTS

[1] 1VV0301371 Telit Modules Linux USB Drivers User Guide

80455NT11986A Rev. 2 Page 29 of 31 2023-02-06

 5G Cards on Jetson Orin Enablement Application Note

10. DOCUMENT HISTORY

Revision Date Changes

2 2023-02-06 Changed document name

Added FN990 in the Applicability Table and related information

1 2022-11-22 Fixed the modified line in paragraph 3.1.2

Removed references to Orin AGX
Added paragraph 3.2 related to Jestson Linux 35.2.0

0 2022-06-08 First issue

From Mod.0809 rev.6

80455NT11986A Rev. 2 Page 30 of 31 2023-02-06