Telit Modules Linux USB Drivers Software User Guide

Telit Modules Linux USB Drivers Software - Featured Image

Telit - logotypTelit Modules Linux USB-drivrutiner
Användarhandbok för programvara

Telit teknisk dokumentation

TILLÄMPNINGSTABELL

PRODUKTER TILLGÄNGLIG SEDAN KERNEL VERSION
DE910-SERIEN 3.4
FD980-SERIEN 5.14
FN980 SERIEN 5.5
FN990 SERIEN 5.16
GE910 SERIEN 4.4
HE910 SERIEN 4.4
LE866-SERIEN 2.6.39
LE910-SERIEN 3.18
LE910Cx SERIEN 4.11
LE910C1-EUX-SERIEN 5.8
LE910D1 SERIEN 2.6.39
LE910R1 SERIEN 5.17
LE910S1 SERIEN 5.13
LE910 V2-SERIEN 3.12
LM940-SERIEN 4.1
LM960-SERIEN 4.1
LN920-SERIEN 5.15
LN940-SERIEN 4.2
ME910C1 SERIEN 4.15
MEx10G1-SERIEN 5.5
ML865C1 SERIEN 4.15
ML865G1-SERIEN 5.5
UE866-SERIEN 4.4
UE910-SERIEN 4.4
UL865-SERIEN 4.4

INTRODUKTION

1.1.Omfattning
Det här dokumentet beskriver vilka Linux-kärndrivrutiner som ska användas för Telit-modulerna som anges i tillämplighetstabellen och hur Linux-enheter kan användas för typiska användningsfall.

1.2.Publik

Detta dokument är avsett för Telit-kunder, särskilt systemintegratörer, som är på väg att implementera Telit-modulerna som listas i tillämplighetstabellen i en Linux-miljö.

1.3.Kontaktinformation, support

För allmän kontakt, teknisk support, tekniska frågor och rapporter om dokumentationsfel, kontakta Telits tekniska support på:

Alternativt kan du använda:
https://www.telit.com/contact-us/

För detaljerad information om var du kan köpa Telit-modulerna eller för rekommendationer om tillbehör och komponenter, besök: https://www.telit.com  Vårt mål är att göra hans guide så hjälpsam som möjligt. Håll oss informerade om dina kommentarer och förslag på förbättringar. Telit uppskattar användarnas feedback på vår information.
1.4. Symbolkonventioner

Telit Modules Linux USB-drivrutinsprogram - Ikon Fara: Denna information MÅSTE följas annars kan katastrofala utrustningsfel eller personskada inträffa.
Telit Modules Linux USB-drivrutinsprogram - Ikon 1 Varning: Varnar användaren om viktiga steg om modulintegreringen.
Telit Modules Linux USB-drivrutinsprogram - Ikon 2 Obs/tips: Ger råd och förslag som kan vara användbara när
integrera modulen.
Telit Modules Linux USB-drivrutinsprogram - Icon3 Elektrostatisk urladdning: Meddelar användaren att ta ordentlig jordning
försiktighetsåtgärder innan du hanterar produkten.

Tabell 1: Symbolkonventioner

Alla datum är i ISO 8601-format, det vill säga ÅÅÅÅ-MM-DD.

1.5. Relaterade dokument

  • Telit QMI SDK och TQCM Användarhandbok, 1VV0301643
  • uxfp programvara användarhandbok, 1VV0301613
  • Referensguide för AT-kommandon för Telit-moduler som listas i tillämplighetstabellen

2. INSTÄLLNING AV OPERATIVSYSTEMET

2.1. Sammanfattning
Telit-modulerna som listas i tillämplighetstabellen exponerar olika typer av enheter enligt det produkt-ID (PID) som används. Tabellen nedan visar sambandet mellan enhetstypen och kärndrivrutinen som används:

Enhetstyp  Kärnmodul 
Seriell port enligt CDC-ACM-standarden cdc_acm
Seriell port (reducerad ACM) alternativ
Nätverksadapter enligt CDC-ECM-standarden cdc_ether
Nätverksadapter enligt CDC-NCM-standarden cdc_ncm
Nätverksadapter enligt Microsofts RNDIS-specifikation rndis_host
Mobil bredbandsadapter enligt CDC-MBIM-standard cdc_mbim
Rmnet mobilt bredbandsadapter qmi_wwan
Android Debug Bridge (ADB) N/A (hanteras på användarutrymmesnivå)
Ljud enhet snd-usb-ljud

För att kunna använda en specifik enhetstyp bör den relaterade modulen inkluderas i kärnbygget.

Telit Modules Linux USB-drivrutinsprogram - Ikon 1 Vissa kärnmoduler kan hittas med början med en specifik kärnversion (t.ex. cdc_mbim är tillgänglig från 3.8). Om drivrutinen inte stöds av kärnversionen som används, överväg att uppgradera kärnan eller backportera de nödvändiga korrigeringarna.

2.2 USB-kompositioner

2.2.1. PID och relaterade sammansättningar
Följande tabell listar de USB-kompositioner som för närvarande stöds i Linux enligt
PID:

PID  Sammansättning 
0x1071 5 reducerade ACM-enheter + 1 MBIM-adapter + 1 ADB
0x1072 5 reducerade ACM-enheter + 1 RNDIS-nätverksadapter + 1 ADB
0x1073 5 reducerade ACM-enheter + 1 ECM-nätverksadapter + 1 ADB
0x1100 2 reducerade ACM-enheter + 1 hyradapter + 1 QDSS-enhet (stöds ej)
0x1101 3 reducerade ACM-enheter + 1 nätadapter
0x1102 3 reducerade ACM-enheter + 1 ECM-nätverksadapter
0x110a 3 reducerade ACM-enheter. Kompositionen presenterar också 1 hyradapter, men den kan inte användas för datasamtal, bara för att styra enheten
0x110b 3 reducerade ACM-enheter + 1 ECM-nätverksadapter
0x1200 5 reducerade ACM-enheter + 1 hyradapter + 1 ADB
0x1201 5 reducerade ACM-enheter + 1 hyradapter + 1 ADB
0x1203 5 reducerade ACM-enheter + 1 RNDIS-nätverksadapter + 1 ADB
0x1204 5 reducerade ACM-enheter + 1 MBIM-adapter + 1 ADB
0x1206 5 reducerade ACM-enheter + 1 ECM-nätverksadapter + 1 ADB
0x1207 2 reducerade ACM-enheter
0x1208 3 reducerade ACM-enheter + 1 ADB
0x1211 1 reducerad ACM-enhet + 1 ECM-nätverksadapter + 1 ADB
0x1212 1 reducerad ACM-enhet + 1 ADB
0x1213 1 reducerad ACM-enhet + 1 ECM-nätverksadapter
0x1214 2 reducerade ACM-enheter + 1 ECM-nätverksadapter + 1 ADB
0x1230 5 reducerade ACM-enheter + 1 hyradapter + 1 ADB + 1 ljudenhet
0x1231 5 reducerade ACM-enheter + 1 RNDIS-nätverksadapter + 1 ADB + 1 ljudenhet
0x1260 5 reducerade ACM-enheter + 1 hyradapter + 1 ADB
0x1261 5 reducerade ACM-enheter + 1 hyradapter + 1 ADB
0x1900 4 reducerade ACM-enheter + 1 hyradapter
0x1901 4 reducerade ACM-enheter + 1 MBIM-adapter
0x2300 Konfig. 1: 3 CDC-ACM-enheter + 1 RNDIS nätverksadapter
Konfig. 2: 3 CDC-ACM-enheter + 1 ECM-nätverksadapter
0x7010 3 reducerade ACM-enheter + 1 RNDIS nätverksadapter
0x7011 3 reducerade ACM-enheter + 1 ECM-nätverksadapter
0x701a 3 reducerade ACM-enheter + 1 RNDIS nätverksadapter
0x701b 3 reducerade ACM-enheter + 1 ECM-nätverksadapter

Tabell 3: PID och relaterade sammansättningar

För ytterligare information om sammansättningen, se användarhandboken för programvaran för modulen som används.
Kommandot:
$ lsusb
kan användas för att lista de USB-enheter som är anslutna till värden.

Telit Modules Linux USB-drivrutinsprogram - Ikon 1 Se modemets användarhandbok för att förstå hur du ändrar USB-kompositionen och för att identifiera omfattningen av de exponerade enheterna.

2.2.2. Flerkonfigurationskompositioner
Vissa kompositioner visar flera konfigurationer (t.ex. 0x1056): som standard den första
konfigurationen används av systemet.
För att ändra konfigurationen ska det önskade värdet skrivas till file:
/sys/bus/USB/devices/ /konfigurationsvärde t.ex
# eko > /sys/bus/USB/devices/ /konfigurationsvärde
Verktyget usb_modeswitch kan också användas för att ändra konfigurationen, t.ex.
# usb_modeswitch -v 0x1bc7 -p -u

2.2.3. Kärnmodulalternativ
När du använder en komposition som stöds som kräver tillvalskärnmodulen och serieportarna inte är tillgängliga i /dev, är det möjligt att stöd för den kompositionen har varit
läggs till i en nyare kärnversion än den som används.
Lösningen är att uppgradera kärnversionen eller backportera de nödvändiga korrigeringarna bland de som listas i kapitel 5.
Det är möjligt att lägga till runtime-stöd för kompositionen som används. Med root-privilegier, skriv följande kommandon:

Telit Modules Linux USB Drivers Software User Guide
# modprobe-alternativ
# eko 1bc7 > /sys/bus/USB-serial/drivers/option1/new_id
var är PID för kompositionen som ska stödjas.

Telit Modules Linux USB-drivrutinsprogram - Ikon 1 Om ett nätverkskort också finns tillgängligt i kompositionen, se till att det känns igen ordentligt av kärnan innan du lägger till runtime-stöd för serieportar.
Om ADB-enheten är tillgänglig i kompositionen förhindrar ADB-enheten att fungera korrekt genom att lägga till runtime-stöd för serieportar, eftersom den är bunden till en seriell port.

För den mest uppdaterade listan över Telit PID som stöds som ett alternativ, se källkoden på huvudlinjen, leta efter alla enhetsposter med TELIT_VENDOR_ID leverantörs-ID (VID).
Telit Modules Linux USB-drivrutinsprogram - Ikon 2 Om support för en sammansättning som saknas i punkt 2.2.1 behövs, kontakta kundsupport med begäran.

2.2.4. Kärnmodul qmi_wwan
När du använder en komposition som stöds som kräver qmi_wwan-kärnmodulen och inget modemrelaterat nätverksgränssnitt är tillgängligt i listan som tillhandahålls av kommandot:
$ IP-länk visa
det är möjligt att stöd för den kompositionen har lagts till i en nyare kärnversion än den som används.
Lösningen är att uppgradera kärnversionen eller backportera de nödvändiga korrigeringarna bland de som listas i kapitel 5.
Om kärnan som används måste commit CDC-WDM: fixa "out-of-sync" på grund av saknade meddelanden, bör den återställas som gjort i commit USB:
Återställ "CDC-WDM: fixa "osynkroniserad" på grund av saknade aviseringar"
För den mest uppdaterade listan över Telit PID som stöds som ett alternativ, se källkoden i mainline, leta efter alla poster för enheten med leverantörs-ID (VID) 0x1bc7.

Telit Modules Linux USB-drivrutinsprogram - Ikon 2 Om support för en sammansättning som saknas i punkt 2.2.1 behövs, kontakta kundsupport med begäran.

2.2.4.1. qmi_wwan och QMAP
Sedan kärnversion 4.12 stöder qmi_wwan Qualcomm Multiplexing and Aggregation Protocol (QMAP).
QMAP behövs för flera samtidiga PDN-hantering och för att få ut det mesta av high-cat modem när det gäller genomströmning.
QMAP-hantering på kärnan görs genom qmi_wwan sys files: kontrollera kärnan dokumentation för mer information.
QMAP-aktivering kräver också en speciell modemkonfiguration som körs på användarutrymmesnivå: proceduren som ska följas beror på vilka verktyg som används.
Kontrollera relevanta qmi_wwan QMAP-relaterade korrigeringar i avsnitt 6.2 för att få en stabil version.

Telit Modules Linux USB-drivrutinsprogram - Ikon 1 När QMAP inte är inställt, bör RX URB-storleken i qmi_wwan vara större än 2048 byte.
Denna inställning kan konfigureras under körning, genom att ändra MTU för nätverksgränssnittet till ett tillåtet värde > 2048 (bör inte vara en multipel av ändpunktens maximala paketstorlek) innan dataanslutningen ställs in, t.ex. MTU 2500
För en permanent inställning, följande rad: dev->rx_urb_size = 2048; bör läggas till i qmi_wwan.c-funktionen qmi_wwan_bind innan du returnerar i det framgångsrika fallet.

ANVÄNDA MODEMET

3.1 Använda seriella portar
Enligt drivrutinen som används skapas följande enheter för seriella portar:

Enhetstyp  Kärnmodul 
/dev/ttyACMx cdc_acm
/dev/ttyUSBx alternativ

Tabell 4: enhetsnamn och relaterade kärnmoduler
Dessa är Linux-karaktärsenheter och stöder de flesta funktioner som implementeras av tty-lagret: till exempelample, en terminalemulator som minicom kan användas för att skicka AT-kommandon.
När du skriver kod för att använda dessa enheter, se programmeringsspråkets API för teckenenheter. Som example, C-applikationer kan använda de exporterade funktionerna i systemhuvudet files fcntl. h och unistd. h. Se den relaterade man-sidan för mer information.

Telit Modules Linux USB-drivrutinsprogram - Ikon 1 När du skickar AT-kommandon är det obligatoriskt att ha DTR bekräftad för att få svaret.

3.1.1. Dataanslutning via seriella portar
För att skapa uppringda anslutningar via seriella portar kan programvaran pppd användas. Se pppd officiella webwebbplats för ytterligare information och uppdaterad källkod.

3.2 Använda nätverksadaptern
Om en nätverksadapter eller mobil bredbandsenhet är tillgänglig och den relaterade kärnmodulen är laddad, skapas ett nätverksgränssnitt av operativsystemet.
Standard Linux-kommandon (t.ex. IP, ifconfig) kan användas för att hantera nätverksgränssnittet: vänligen se kommandots man-sida för ytterligare information.

3.2.1. Dataanslutning via nätverksgränssnittet
För att upprätta en dataanslutning via nätverksgränssnittet, se instruktionerna i tabellen nedan enligt kärnmodulen som används:

Telit Modules Linux USB Drivers Software User Guide

Kärnmodul  Förfarande 
qmi_wwan Projektet libqmi kan användas: se projektdokumentationen för ytterligare detaljer.
Telit tillhandahåller också en proprietär QMI SDK, se dokument 1VV0301643,
cdc_mbim Libmbim-projektet kan användas: se projektdokumentationen för ytterligare detaljer.
cdc_ether AT-kommandon bör användas: se modemets dokumentation för ytterligare detaljer.
cdc_ncm AT-kommandon bör användas: se modemets dokumentation för ytterligare detaljer.
rndis_host AT-kommandon bör användas: se modemets dokumentation för ytterligare detaljer.

Tabell 5: kärnmodul som används för nätverksenheten och relaterad dataanslutningsprocedur

3.3 Använda modemet med ModemManager och NetworkManager

ModemManager är en DBus-aktiverad demon som styr mobilt bredband (2G/3G/4G) enheter och anslutningar.
ModemManager tillhandahåller ett enhetligt högnivå-API för kommunikation med mobilt bredbandsmodem, oavsett vilket protokoll som används för att kommunicera med den faktiska enheten (AT-kommandon, MBIM, QMI).
För att hantera icke-AT-baserade modem använder ModemManager externa bibliotek: freedesktop.org libqmi för QMI-baserade modem, libmbim för MBIM-baserade modem.
ModemManager kan användas med freedesktop.org NetworkManager för enklare hantering av nätverksanslutningar.
NetworkManager är standardpaketet för Linux-nätverkskonfigurationsverktyg. Den stöder ett brett utbud av nätverksinställningar, från skrivbord till server och mobil, och integreras väl med populära skrivbordsmiljöer och verktyg för hantering av serverkonfigurationer.
NetworkManager tillhandahåller ett komplett D-Bus API som används för att komma åt NetworkManager-demonen. Det här gränssnittet kan användas för att fråga nätverksstatus och information om nätverksgränssnitt som aktuella IP-adresser eller DHCP-alternativ. API:et kan också användas för att hantera anslutningarna (skapande, aktivering, avaktivering...).
NetworkManager använder freedesktop.org ModemManager för att stödja mobila bredbandsenheter.

BLINKANDE ENHETER

4.1 Överview
Modemen som listas i följande tabell stöder firmwareuppdateringar genom speciella blinkande enheter som kan kräva bindning till en kärnmodul:

Produkt VID:PID Kärnmodul Enhetens namn
FD980, FN980, FN990,
LE910C1-EUX, LN920
0x1bc7:0x9010 alternativ /dev/ttyUSBx
GE/HE/UE910, UE866, UL865 0x058b:0x0041 usb-seriell-enkel /dev/ttyUSBx
LE910Cx, LM940, LM960 0x18d1:0xd00d Hanteras på användarutrymmesnivå n/a
LE910 V2 0x8087:0x0716 usb-seriell-enkel /dev/ttyUSBx
LE866, LE910D1 0x216F:0x0051 cdc_acm /dev/ttyACMx
LE910S1 0x1bc7:0x9200 alternativ /dev/ttyUSBx
LE910R1 0x1bc7:0x9201 alternativ /dev/ttyUSBx

Tabell 6: blinkande enheter
De blinkande enheterna som finns tillgängliga i GE/HE/UE910, UE866, UL865, LE910 V2, LE940B6 och LE866 visas i några sekunder när modemet slås på: om den blinkande applikationen inte körs kopplas den blinkande enheten från och modemet fortsätter i normalt driftläge.

Telit Modules Linux USB-drivrutinsprogram - Ikon 1 Kontrollera kapitel 5 för flashande enhetsstöd i kärnversioner.

4.2 Blinkande enhet 0x18d1:0xd00d
Den blinkande enheten 0x18d1:0xd00d hanteras på användarutrymmesnivå av Telits firmwareuppdateringsapplikation. Se dokument 1VV0301613 för ytterligare detaljer.

Telit Modules Linux USB-drivrutinsprogram - Ikon 1 Äldre Telit firmware uppdateringsprogram livslängd kräver att enheten binds till tillvalsdrivrutinen.
Detta kan göras permanent genom att lägga till följande rad: { USB_DEVICE(0x18d1, 0xd00d) } till struct usb_device_id option_ids i kärnans källdrivrutiner/USB/serial/option.c
För teständamål kan proceduren som beskrivs i punkt 2.2.2 användas:
$ modprobe alternativ
$ echo 18d1 d00d > /sys/bus/usb-serial/drivers/option1/new_id

4.3 Blinkande enhet 0x058b:0x0041
Även om den blinkande enheten 0x058b:0x0041 presenterar sig som en ACM-enhet, bör den drivas av kärndrivrutinen usb-serial-simple. Stöd för den här enheten är tillgängligt sedan kärnversion 4.4.
Tidigare kärnversioner kräver commits kernel/git/torvalds/linux.git – Linux-kärnan källträd och kernel/git/torvalds/linux.git – Linux-kärnan källträd.

4.4 Blinkande enhet 0x8087:0x0716
Stöd för blinkande enhet 0x8087:0x0716 är tillgängligt sedan kärnversion 3.12 med drivrutin USB-seriell-enkel.
Tidigare kärnversioner kräver commit kernel/git/torvalds/linux.git – Linux-kärnan källträd

TELIT KERNEL ÅTGÄRDER

Nedan finns en lista över kärnkommitter relaterade till de kompositioner som är tillgängliga för modemen listade i tillämplighetstabellen: överväg att backportera om den nödvändiga PID:n inte är tillgänglig
i den använda kärnversionen.

Sammanfattning  VID:PID Begå  Tillgänglighet
USB: alternativ drivrutin: lägger till stöd för
Telit CC864-SINGLE, CC864-DUAL och DE910-DUAL modem
0x1bc7:0x1005
0x1bc7:0x1006
0x1bc7:0x1010
7204cf584836c24b4b06e4ad4a8e6bb8ea84908e  v3.4-rc1
USB: alternativ drivrutin, lägg till stöd för Telit
UE910v2
0x1bc7:0x1012 d6de486bc22255779bd54b0fceb4c240962bf146  v3.15-rc2
USB: alternativ: lägg till stöd för Telit
LE920
0x1bc7:0x1200 03eb466f276ceef9dcf023dc5474db02af68aad9  v3.8-rc7
NET: qmi_wwan: lägg till Telit LE920-stöd 0x1bc7:0x1200 3d6d7ab5881b1d4431529410b949ba2e946f3b0f  v3.8-rc7
net: qmi_wwan: lägg till Telit LE920 nyare
firmware-stöd
0x1bc7:0x1201 905468fa4d54c3e572ed3045cd47cce37780716e  v3.13-rc1
usb: option: lägg till stöd för Telit
LE910
0x1bc7:0x1201 2d0eb862dd477c3c4f32b201254ca0b40e6f465c  v3.18-rc3
USB: cdc_acm: Ignorera Infineon Flash
Lastarverktyg
0x058b:0x0041 f33a7f72e5fc033daccbb8d4753d7c5c41a4d67b  v4.4-rc5
USB: seriell: Ytterligare ett USB-ID för Infineon flash loader 0x058b:0x0041 a0e80fbd56b4573de997c9a088a33abbc1121400  v4.4-rc5
USB: seriell: alternativ: Lägger till stöd för
Telit LE922
0x1bc7:0x1042
0x1bc7:0x1043
ff4e2494dc17b173468e1713fdf6237fd8578bc7  v4.5-rc2
USB: seriell: alternativ: lägg till stöd för Telit
LE922 PID 0x1045
0x1bc7:0x1045 5deef5551c77e488922cc4bf4bc76df63be650d0  v4.5-rc7
nät: USB: cdc_ncm: lägger till Telit LE910 V2 mobilt bredbandskort 0x1bc7:0x0036 79f4223257bfef52b0a26d0d7ad4019e764be6ce  v4.6-rc2
USB: seriell: alternativ: lägg till stöd för Telit
LE910 PID 0x1206
0x1bc7:0x1206 3c0415fa08548e3bc63ef741762664497ab187ed  v4.8-rc1
USB: seriell: alternativ: lägg till stöd för Telit
LE920A4
0x1bc7:0x1207
0x1bc7:0x1208
0x1bc7:0x1211
0x1bc7:0x1212
0x1bc7:0x1213
0x1bc7:0x1214
01d7956b58e644ea0d2e8d9340c5727a8fc39d70  v4.8-rc3
NET: USB: qmi_wwan: lägg till stöd för Telit LE922A PID 0x1040 0x1bc7:0x1040 9bd813da24cd49d749911d7fdc0e9ae9a673d746  v4.9-rc8
NET: USB: cdc_mbim: lägg till quirk för
stöder Telit LE922A
0x1bc7:0x1041 7b8076ce8a00d553ae9d3b7eb5f0cc3e63cb16f1  v4.9
USB: seriell: alternativ: lägg till stöd för Telit
LE922A PID:er 0x1040, 0x1041
0x1bc7:0x1040
0x1bc7:0x1041
5b09eff0c379002527ad72ea5ea38f25da8a8650  v4.10-rc1
drivrutiner: net: USB: qmi_wwan: add
QMI_QUIRK_SET_DT R för Telit PID 0x1201
0x1bc7:0x1201 14cf4a771b3098e431d2677e3533bdd962e478d8  v4.11-rc7
net: USB: qmi_wwan: lägg till Telit ME910
stöd
0x1bc7:0x1100 4c54dc0277d0d55a9248c43aebd31858f926a056  v4.12-rc1
USB: seriell: alternativ: lägg till Telit ME910
stöd
0x1bc7:0x1100 40dd46048c155b8f0683f468c950a1c107f77a7c  v4.12-rc1
nät: USB: qmi_wwan: lägg till Telit ME910 PID0x1101-stöd 0x1bc7:0x1101 c647c0d62c82eb3ddf78a0d8b3d58819d9f552aa  v4.15-rc4
USB: seriell: alternativ: lägg till stöd för Telit
ME910 PID 0x1101
0x1bc7:0x1101 08933099e6404f588f81c2050bfec7313e06eeaf  v4.15-rc6
net: USB: cdc_mbim: lägg till flagga
FLAG_SEND_ZLP
0x1bc7:0x1041 9f7c728332e8966084242fcd951aa46583bc308c  v4.17
USB: seriell: alternativ: lägg till Telit LN940
serie
0x1bc7:0x1900
0x1bc7:0x1901
28a86092b1753b802ef7e3de8a4c4a69a9c1bb03  v4.20
qmi_wwan: Lade till stöd för Telit
LN940-serien
0x1bc7:0x1900 1986af16e8ed355822600c24b3d2f0be46b573df  v4.20
USB: CDC-ACM: skicka ZLP för Telit 3G Intel-baserade modem 0x1bc7:0x0021
0x1bc7:0x0023
34aabf918717dd14e05051896aaecd3b16b53d95  v5.0-rc2
USB: seriell: alternativ: lägg till Telit ME910 ECM-komposition 0x1bc7:0x1102 6431866b6707d27151be381252d6eef13025cfce  v5.1-rc1
net: USB: qmi_wwan: lägg till Telit 0x1260 och 0x1261 kompositioner 0x1bc7:0x12600x1bc7:0x1261 b4e467c82f8c12af78b6f6fa5730cb7dea7af1b4  v5.2-rc2
USB: seriell: alternativ: lägg till Telit 0x1260 och
0x1261 kompositioner
0x1bc7:0x12600x1bc7:0x1261 f3dfd4072c3ee6e287f501a18b5718b185d6a940  v5.2-rc5
USB: seriell: alternativ: lägg till Telit FN980
kompositioner
0x1bc7:0x1050
0x1bc7:0x1051
0x1bc7:0x1052
0x1bc7:0x1053
5eb3f4b87a0e7e949c976f32f296176a06d1a93b  v5.4-rc3
net: USB: qmi_wwan: lägg till Telit 0x1050
sammansättning
0x1bc7:0x1050 e0ae2c578d3909e60e9448207f5d83f785f1129f  v5.4-rc4
USB: seriell: alternativ: lägg till Telit ME910G1
0x110a komposition
0x1bc7:0x110a 0d3010fa442429f8780976758719af05592ff19f  v5.5-rc6
USB: seriell: alternativ: lägg till ZLP-stöd för
0x1bc7/0x9010
0x1bc7:0x9010 2438c3a19dec5e98905fd3ffcc2f24716aceda6b  v5.5-rc6
USB: seriell: alternativ: lägg till ME910G1 ECM
sammansättning 0x110b
0x1bc7:0x110b 8e852a7953be2a6ee371449f7257fe15ace6a1fc  v5.6-rc7
nät: usb: qmi_wwan: lägg till Telit LE910C1EUX sammansättning 0x1bc7:0x1031 591612aa578cd7148b7b9d74869ef40118978389  v5.7
USB: seriell: alternativ: lägg till Telit LE910C1EUX-kompositioner 0x1bc7:0x1031
0x1bc7:0x1033
399ad9477c523f721f8e51d4f824bdf7267f120c  v5.8-rc1
USB: seriell: alternativ: lägg till LE910Cx-kompositioner 0x1203, 0x1230, 0x1231 0x1bc7:0x1203
0x1bc7:0x1230
0x1bc7:0x1231
489979b4aab490b6b917c11dc02d81b4b742784a v5.10-rc3
nät: USB: qmi_wwan: lägg till Telit LE910Cx
0x1230 komposition
0x1bc7:0x1230 5fd8477ed8ca77e64b93d44a6dae4aa70c191396  v5.10-rc3
USB: seriell: alternativ: lägg till Telit FN980
sammansättning 0x1055
0x1bc7:0x1055 db0362eeb22992502764e825c79b922d7467e0eb v5.10-rc3
USB: seriell: alternativ: lägg till Telit LE910-S1
kompositioner 0x7010, 0x7011
0x1bc7:0x7010
0x1bc7:0x7011
e467714f822b5d167a7fb03d34af91b5b6af1827  v5.13-rc4
USB: seriell: alternativ: lägg till Telit FD980
sammansättning 0x1056
0x1bc7:0x1056 5648c073c33d33a0a19d0cb1194a4eb88efe2b71  v5.14-rc5
net: USB: cdc_mbim: undvik alt-inställning
växlar för Telit LN920
0x1bc7:0x1061 aabbdc67f3485b5db27ab4eba01e5fbf1ffea62c  v5.15-rc1
net: USB: qmi_wwan: lägg till Telit 0x1060
sammansättning
0x1bc7:0x1060 8d17a33b076d24aa4861f336a125c888fb918605  v5.15-rc1
USB: seriell: alternativ: lägg till Telit LN920
kompositioner
0x1bc7:0x1060
0x1bc7:0x1061
0x1bc7:0x1062
0x1bc7:0x1063
7bb057134d609b9c038a00b6876cf0d37d0118ce  v5.15-rc3
USB: seriell: alternativ: lägg till Telit LE910Cx
sammansättning 0x1204
0x1bc7:0x1204 f5a8a07edafed8bede17a95ef8940fe3a57a77d5  v5.15-rc6
USB: seriell: alternativ: lägg till Telit LE910S1
0x9200 komposition
0x1bc7:0x9200 e353f3e88720300c3d72f49a4bea54f42db1fa5e  v5.16-rc3
USB: seriell: alternativ: lägg till Telit FN990
kompositioner
0x1bc7:0x1070
0x1bc7:0x1071
0x1bc7:0x1072
0x1bc7:0x1073
2b503c8598d1b232e7fc7526bce9326d92331541  v5.16-rc6
net: USB: qmi_wwan: lägg till Telit 0x1070
sammansättning
0x1bc7:0x1070 94f2a444f28a649926c410eb9a38afb13a83ebe0  v5.16-rc6
net: USB: cdc_mbim: undvik alt-inställning
växlar för Telit FN990
0x1bc7:0x1071 21e8a96377e6b6debae42164605bf9dcbe5720c5  v5.17-rc5
USB: seriell: alternativ: lägg till Telit LE910R1
kompositioner
0x1bc7:0x701a
0x1bc7:0x701b
0x1bc7:0x9201
cfc4442c642d568014474b6718ccf65dc7ca6099  v5.17-rc6

Tabell 7: kärnbekräftelser relaterade till Telit-moduler

YTTERLIGARE KERNEL ÅTAGANDEN

6.1 Raw-IP-stöd och viktiga korrigeringar för qmi_wwan
Nedan finns en lista över åtaganden för att lägga till Raw-Ip-stöd till qmi_wwan och ta itu med viktiga frågor.

Sammanfattning  Begå  Tillgänglighet 
net: qmi_wwan: MDM9x30 specifik energihantering 93725149794d3d418cf1eddcae60c7b536c5faa1  v4.5-rc1
usbnet: tillåt minidrivrutiner att konsumera L2
rubriker
81e0ce79f2919dbd5f025894d29aa806af8695c7  v4.5-rc1
net: qmi_wwan: stöder "rå IP"-läge 32f7adf633b9f99ad5089901bc7ebff57704aaa9  v4.5-rc1
net: qmi_wwan: bör hålla RTNL medan du ändrar netdev-typ 6c730080e663b1d629f8aa89348291fbcdc46cd9  v4.5-rc1
net: qmi_wwan: ignorera falska CDC-unionsdeskriptorer 34a55d5e858e81a20d33fd9490149d6a1058be0c  v4.5-rc1
qmi_wwan: Lägg till saknat skb_reset_mac_header-call 0de0add10e587effa880c741c9413c874f16be91  v4.14
usbnet: fixa justering för ramar utan Ethernet-huvud a4abd7a80addb4a9547f7dfc7812566b60ec505c  v4.15-rc3
qmi_wwan: ställ in FLAG_SEND_ZLP för att undvika nätverksinitierad frånkoppling 245d21190aec547c0de64f70c0e6de871c185a24  v4.16-rc1
qmi_wwan: Fixa läsning utanför gränserna 904d88d743b0c94092c5117955eab695df8109e8  v5.2-rc7

Tabell 8: qmi_wwan relevant kärnbekräftelse

6.2 QMAP-stöd i qmi_wwan
Nedan finns en lista över åtaganden för att lägga till QMAP-stöd till qmi_wwan.

Sammanfattning  Begå  Tillgänglighet 
net: usb: qmi_wwan: lägg till stöd för map mux-protokoll c6adf77953bcec0ad63d7782479452464e50f7a3  v4.12-rc1
qmi_wwan: fixa NULL deref vid frånkoppling bbae08e592706dc32e5c7c97827b13c1c178668b  v4.13-rc5
qmi_wwan: Fixa hämtning av karthuvud i qmimux_rx_fixup d667044f49513d55fcfefe4fa8f8d96091782901  v4.20
qmi_wwan: lägg till MTU-standard till kartnätverket
gränssnitt
f87118d5760f00af7228033fbe783c7f380d2866  v5.0-rc3
qmi_wwan: lägg till stöd för QMAP-utfyllnad i RX-sökvägen 61356088ace1866a847a727d4d40da7bf00b67fc  v5.2-rc6
qmi_wwan: lägg till statistik över nätverksenhetsanvändning för qmimux-enheter 44f82312fe9113bab6642f4d0eab6b1b7902b6e1  v5.2-rc6
qmi_wwan: undvik RCU-stopp vid frånkoppling av enheten i QMAP-läge a8fdde1cb830e560208af42b6c10750137f53eb3  v5.2-rc6
qmi_wwan: utöka det tillåtna QMAP mux_id värdeintervallet 36815b416fa48766ac5a98e4b2dc3ebc5887222e  v5.2-rc6
qmi_wwan: Öka utrymmet för QMAP SKB:er 2e4233870557ac12387f885756b70fc181cb3806  v5.12
net: USB: qmi_wwan: lägg till kart-id sys file för
qmimux-gränssnitt
e594ad980ec26fb7351d02c84abaa77ecdb4e522 v5.12-rc1dontuse
net: usb: qmi_wwan: tillåt qmimux add/del med master up 6c59cff38e66584ae3ac6c2f0cbd8d039c710ba7  v5.12-rc3

Tabell 9: qmi_wwan QMAP relevant kärnbekräftelse

PRODUKT- OCH SÄKERHETSINFORMATION

7.1 Upphovsrätt och andra meddelanden

SPECIFIKATIONER ÄNDRAS UTAN MEDDELANDE
Även om rimliga ansträngningar har gjorts för att säkerställa att detta dokument är korrekt, tar Telit inget ansvar till följd av eventuella felaktigheter eller utelämnanden i detta dokument, eller från användningen av informationen häri. Informationen i detta dokument har kontrollerats noggrant och anses vara tillförlitlig. Telit förbehåller sig rätten att göra ändringar i någon av de produkter som beskrivs häri, att revidera dem och att göra ändringar från tid till annan utan någon skyldighet att meddela någon om sådana ändringar eller ändringar. Telit tar inte på sig något ansvar som uppstår från tillämpningen eller användningen av någon produkt, programvara eller krets som beskrivs häri; inte heller förmedlar den en licens under sina patenträttigheter eller andras rättigheter.
Detta dokument kan innehålla referenser eller information om Telits produkter (maskiner och program), eller tjänster som inte är annonserade i ditt land. Sådana referenser eller informationen betyder inte nödvändigtvis att Telit har för avsikt att tillkännage sådana Telit-produkter, program eller tjänster i ditt land.

7.1.1. Upphovsrätt
Denna bruksanvisning och Telit-produkterna som beskrivs häri kan innehålla eller beskriva Telit upphovsrättsskyddat material, såsom datorprogram lagrade i halvledarminnen eller andra media. Lagarna i Italien och i andra länder förbehåller Telit och dess licensgivare vissa exklusiva rättigheter för upphovsrättsskyddat material, inklusive ensamrätten att kopiera, reproducera i någon form, distribuera och göra härledda verk av det upphovsrättsskyddade materialet. Följaktligen får något av Telits eller dess licensgivares upphovsrättsskyddade material som finns här eller beskrivs i denna bruksanvisning inte kopieras, reproduceras, distribueras, slås samman eller modifieras på något sätt utan uttryckligt skriftligt tillstånd från ägaren. Vidare ska köp av Telit-produkter inte anses ge på något sätt, varken direkt eller underförstått, eller avbrytande, någon licens.
7.1.2. Upphovsrätt för datorprogramvara
Telit och tredjepartslevererade mjukvaruprodukter (SW) som beskrivs i denna bruksanvisning kan inkludera Telits och andra tredje parts upphovsrättsskyddade datorprogram lagrade i halvledarminnen eller andra media. Lagar i Italien och i andra länder förbehåller Telit och andra tredje parter SW exklusiva rättigheter för upphovsrättsskyddade datorprogram, inklusive – men inte begränsat till – den exklusiva rätten att kopiera eller reproducera i någon form av upphovsrättsskyddade produkter. Följaktligen får alla upphovsrättsskyddade datorprogram som finns i Telits produkter som beskrivs i denna bruksanvisning inte kopieras (reverse engineering) eller reproduceras på något sätt utan uttryckligt skriftligt tillstånd från upphovsrättsinnehavaren, som är Telit eller tredje parts mjukvaruleverantör.
Vidare ska köp av Telit-produkter inte anses ge, vare sig direkt eller underförstått, estoppel, eller på något annat sätt, någon licens under upphovsrätt, patent eller patentansökningar från Telit eller annan tredje part tillhandahållen SW, med undantag för normal icke-exklusiv, royaltyfri licens att använda som uppstår enligt lag vid försäljning av en produkt.

7.2 Användnings- och avslöjandebegränsningar
7.2.1. Licensavtal
Programvaran som beskrivs i detta dokument ägs av Telit och dess licensgivare. Det tillhandahålls endast genom ett uttryckligt licensavtal och ska endast användas i enlighet med villkoren i sådant avtal.
7.2.2. Upphovsrättsskyddat material
Programvaran och dokumentationen är upphovsrättsskyddat material. Att göra otillåtna kopior är förbjudet enligt lag. Programvaran eller dokumentationen ska inte vara det
reproduceras, överförs, transkriberas, även delvis, eller lagras i ett hämtningssystem, eller översatts till något språk eller datorspråk, i någon form eller på något sätt, utan föregående skriftligt tillstånd från Telit.
7.2.3. Högriskmaterial
Komponenter, enheter eller tredjepartsvaror som används vid tillverkningen av produkten som beskrivs häri är INTE feltoleranta och är INTE konstruerade, tillverkade eller avsedda att användas som onlinekontrollutrustning i följande farliga miljöer som kräver felsäkra kontroller: operationer av kärntekniska anläggningar, flygplansnavigering eller flygkommunikationssystem, flygledning, livräddning eller vapensystem (”Högriskaktiviteter”). Telit och dess leverantör(er) frånsäger sig uttryckligen alla uttryckliga eller underförstådda garantier för lämplighet för sådana högriskaktiviteter.

7.2.4. Varumärken
TELIT och den stiliserade T-logotypen är registrerade hos varumärkeskontoret. Alla andra produkt- eller tjänstnamn tillhör sina respektive ägare.
7.2.5. Tredje parts rättigheter
Programvaran kan innehålla tredje parts mjukvarurättigheter. I det här fallet samtycker användaren till att följa alla villkor som gäller för sådana separata mjukvarurättigheter. Utöver villkoren för tredje part, gäller friskrivningen av garanti och begränsning av ansvar i denna licens även för programvaran för tredjepartsrättigheter.
TELIT AVSÄKER HÄRMED ALLA GARANTIER UTTRYCKTA ELLER UNDERFÖRSTÅDDA FRÅN NÅGON TREDJE PART ANGÅENDE NÅGON SEPARAT FILES, ALLT TREDJE PARTS MATERIAL SOM INGÅR I PROGRAMVARAN, ALLT TREDJE PARTS MATERIAL FRÅN SOM PROGRAMVARAN ER ERHÅLLS FRÅN (SAMT "ANDRA KODER"), OCH ANVÄNDNING AV NÅGON ELLER ALLA ANDRA KODER I SAMBAND MED EN PROGRAMVARA, INKLUDERAT MED PROGRAMVARAN. GARANTIER FÖR TILLFÄLLIG KVALITET ELLER LÄMPLIGHET FÖR ETT SÄRSKILT SYFTE.
INGA TREDJE PARTS LICENSGIVARE AV ANDRA KODER FÅR VARA ANSVARIGA FÖR NÅGON DIREKTA, INDIREKTA, OAVSIKTLIGA, SPECIELLA, EXEMPELSKADOR ELLER FÖLJDSKADOR (INKLUSIVE UTAN BEGRÄNSNING FÖRLÖST AV VINST), DOCK OM OM DEN GÅR I MAN ELLER ELLER ELLER ANNAN ORSAKADE ELLER. , SOM UPPSTÅR PÅ NÅGOT SÄTT UR ANVÄNDNING ELLER DISTRIBUTION AV ANDRA KODER ELLER UTÖVANDE AV NÅGON RÄTTIGHETER SOM GÖR UNDER ANTERING ELLER BÅDE DENNA LICENS OCH DE JURIDISKA VILLKOR SOM GÄLLER NÅGON SEPARAT FILES, ENDA OM RÅDET FÖR MÖJLIGHETEN AV SÅNA SKADOR.
7.2.6. Ansvarsfrihet
Under inga omständigheter kommer Telit och dess dotterbolag ansvariga för alla direkta, indirekta, speciella, allmänna, tillfälliga, följd-, bestraffande eller exemplifierande indirekta skador av något slag, inklusive men inte begränsat till återbetalning av kostnader, ersättning för skador, förlust AV PRODUKTION, FÖRLUST AV VINST, FÖRLUST AV ANVÄNDNING, FÖRLUST AV VERKSAMHET, FÖRLUST AV DATA ELLER INTÄKTER, OM MÖJLIGHETEN TILL SÅDANA SKADA KUNNE HAR FÖRUTSÄTTAS PÅ NÅGOT SÄTT TILL ANVÄNDNINGEN/PRODUKTEN INFORMATION SOM FINNS I DEN NUVARANDE DOKUMENTATIONEN, ÄVEN OM TELIT OCH/ELLER DESS AFFILIATES HAR INFORMERATS OM MÖJLIGHETEN FÖR SÅDANA SKADA ELLER ÄR DE FÖRUTSÄGBARA ELLER FÖR ANSVAR FRÅN NÅGON TREDJE PART.

7.3 Säkerhetsrekommendationer
Se till att användningen av denna produkt är tillåten i ditt land och i den miljö som krävs. Användningen av denna produkt kan vara farlig och måste undvikas i områden där:

  • det kan störa andra elektroniska enheter, särskilt i miljöer som sjukhus, flygplatser, flygplan etc.
  • det finns risk för explosion i t.ex. bensinstationer, oljeraffinaderier etc. Det är användarens ansvar att upprätthålla landets bestämmelser och de specifika miljöbestämmelserna.

Ta inte isär produkten; något märke av tampering kommer att äventyra garantins giltighet. Vi rekommenderar att du följer instruktionerna i maskinvaruanvändarhandböckerna för korrekt kabeldragning av produkten. Produkten måste levereras med en stabiliserad voltagKällan och ledningarna måste överensstämma med säkerhets- och brandförebyggande föreskrifter.
Produkten måste hanteras med försiktighet och undvika all kontakt med stiften eftersom elektrostatiska urladdningar kan skada själva produkten. Samma försiktighetsåtgärder måste vidtas för SIM-kortet, och kontrollera noggrant bruksanvisningen för dess användning. Sätt inte i eller ta bort SIM-kortet när produkten är i energisparläge.
Systemintegratören ansvarar för att slutprodukten fungerar. Därför har de externa komponenterna i modulen, såväl som alla projekt- eller installationsproblem
att hanteras med försiktighet. Eventuella störningar kan orsaka risk att störa GSM-nätverket eller externa enheter eller påverka säkerhetssystemet. Om det råder några tvivel, se den tekniska dokumentationen och gällande föreskrifter. Varje modul måste vara utrustad med en ordentlig antenn med specifika egenskaper. Antennen måste installeras noggrant för att undvika störningar med andra elektroniska enheter och måste garantera ett minsta avstånd från kroppen (20 cm). Om detta krav inte kan uppfyllas måste systemintegratören bedöma slutprodukten mot SAR-förordningen.
Utrustningen är avsedd att installeras i ett begränsat område.
Utrustningen måste försörjas med en extern specifik begränsad strömkälla i enlighet med standarden EN 62368-1:2014.
Europeiska gemenskapen tillhandahåller vissa direktiv för elektronisk utrustning som introduceras på marknaden. All relevant information finns tillgänglig i Europeiska gemenskapen webplats:
https://ec.europa.eu/growth/sectors/electrical-engineering_en

ORDLISTA

ACM Abstrakt kontrollmodell
TILLÄGGA Android Debug Bridge
CDC Kommunikationsklassenhet
ECM Ethernet kontrollmodell
MB Gränssnittsmodell för mobilt bredband
NCM Nätverkskontrollmodell
PPP Punkt till punkt-protokoll
KARTA Qualcomm Multiplexing and Aggregation Protocol
USB Universal Serial Bus

DOKUMENTHISTORIK

Revision Datum Ändringar 
14 2022-03-02 Lade till LE910R1 i tillämplighetstabellen
Lade till LE910R1-kompositioner 0x701A, 0x701B
Lade till LE910R1-komposition 0x9201 och relaterad post i tabell 6
13 2021-12-13 Lade till LE910C1 komposition 0x1204
Lade till LE910S1-komposition 0x9200 och relaterad post i tabell 6
Lade till FN990-kompositioner 0x1070, 0x1071, 0x1072, 0x1073
12 2021-09-24 Lade till LN920 i tillämplighetstabellen och relaterade kärncommits
11 2021-08-09 Lade till FD980-komposition 0x1056
Lade till FD980 i tillämplighetstabellen
Lade till stycket "Kompositioner med flera konfigurationer"
10 2021-06-14 Ändrade dokumentmall och omformulerade några stycken
Fast FN980-kärnversionstillgänglighet i tillämplighetstabell
Lade till LE910S1 i tillämplighetstabellen
Lade till LE910S1 0x7010 och 0x7011 kompositionsbeskrivning och relaterade kärnbekräftelser
Lade till QMAP-stycke och relaterade kärnkommits
Ändrad blinkande enhetsinformation för 0x18d1:0xd00d och 0x8087:0x0801 (borttagen)
Ändrade kernel commit-referenser från GitHub till git.kernel.org
9 2020-11-09 Lade till LE910Cx kompositioner 0x1203, 0x1230, 0x1231 och FN980 komposition 0x1055
Tog bort referenser till föråldrade ModemManager och
NetworkManager-dokument
Referenser till föråldrat liv har tagits bort
8 2020-09-01 Lade till LE910C1-EUX-stöd och uppdaterad listan över kärnpatchar
Lade till LM960 0x1040 qmi_wwan RX urb storlek notering
7 2020-03-27 Ändrade ME910G1 till MEx10G1 i tillämplighetstabellen
Lade till ML865C1 och ML865G1 i tillämplighetstabellen
Uppdaterad lista med uppdateringar av kärnan för komposition 0x110b
6 2020-01-13 Lade till ME910G1 0x110a komposition
Lade till FN980 0x9010 blinkande enhetskomposition
Uppdaterad lista med korrigeringar för kärnan
Uppdaterad tillämplighetstabell
5 2019-10-21 Lade till FN980 i tillämplighetstabellen och relaterade kärncommits
4 2019-05-24 Tog bort fordonsmoduler från tillämplighetstabellen
Lade till LN940 och UE866 i tillämplighetstabellen
Lade till LM940 kernel commit för att fixa problem med stora datapaket
Lade till ME910 komposition 0x1102, LECx910 komposition 0x1260 och 0x1261
Uppdaterad lista med korrigeringar för kärnan
3 2018-05-07 Lade till LE866 blinkande enhetsdetaljer
Lade till kernel commit för PID 0x0036
Lade till LE910D1 i tillämplighetstabellen
2 2018-02-13 Lade till LM960 i tillämplighetstabellen
Lade till ME910 komposition 0x1101
Lade till kapitlet "Ytterligare Kernel Commits".
Lade till "Minimum Kernel Version" i tillämplighetstabellen
1 2017-11-24 Lade till LE920A4 och LE910C1 komposition 0x1201
Lade till LM940 i tillämplighetstabellen
Lade till referens till att begå CDC-WDM: fixa "osynkroniserad" på grund av saknade aviseringar
0 2017-04-28 Första numret

Anslut till vår webbplats och kontakta vårt tekniska supportteam för eventuella frågor www.telit.com

Telit förbehåller sig alla rättigheter till detta dokument och informationen häri. Produkter, namn, logotyper och design som beskrivs häri kan helt eller delvis vara föremål för immateriella rättigheter. Informationen häri tillhandahålls "i befintligt skick". Ingen garanti av något slag, varken uttrycklig eller underförstådd, lämnas i relation till noggrannheten, tillförlitligheten, lämpligheten för ett visst syfte eller innehållet i detta dokument. Detta dokument kan när som helst revideras av Telit. För de senaste dokumenten, besök www.telit.com
Copyright © 2021, Telit
1VV0301371 Rev. 14 – 2022-03-02

Dokument/resurser

PDF thumbnailModuler Linux USB-drivrutiner programvara
User Guide · Modules Linux USB Drivers Software, Linux USB Drivers Software, Drivers Software

Referenser

Ställa en fråga

Use this section to ask about setup, compatibility, troubleshooting, or anything missing from this manual.

Ställa en fråga

Ask a question about setup, compatibility, troubleshooting, or anything missing from this manual.