TelitモジュールLinuxUSBドライバーソフトウェアユーザーガイド

Telit モジュール Linux USB ドライバー
ソフトウェアユーザーガイド

Telit技術文書

適用性表

導入

1.1.範囲
このドキュメントでは、適用性の表に記載されている Telit モジュールに使用する必要がある Linux カーネル ドライバーと、一般的なユース ケースでの Linux デバイスの使用方法について説明します。

1.2.対象者

このドキュメントは、Telit のお客様、特にシステム インテグレーターを対象としており、Linux 環境で適用表に記載されている Telit モジュールを実装しようとしています。

1.3.連絡先情報、サポート

一般的な連絡先、テクニカル サポート サービス、技術的な質問、およびドキュメント エラーのレポートについては、次の Telit テクニカル サポートにお問い合わせください。

• TS-EMEA@telit.com
• TS-AMERICAS@telit.com
• TS-APAC@telit.com
• TS-SRD@telit.com
• TS-ONEEDGE@telit.com

または、次を使用します。
https://www.telit.com/contact-us/

Telitモジュールを購入できる場所の詳細、またはアクセサリとコンポーネントの推奨事項については、次のWebサイトをご覧ください。 https://www.telit.com  私たちの目標は、彼のガイドをできる限り役立つものにすることです。 改善のためのご意見やご提案をお知らせください。 Telit は、私たちの情報に関するユーザーからのフィードバックを歓迎します。
1.4。 記号の規則

	危険： この情報に従わなければ、壊滅的な機器の故障や人身事故が発生する可能性があります。
	警告： モジュールの統合に関する重要な手順についてユーザーに警告します。
	注/ヒント: 次の場合に役立つアドバイスや提案を提供します。 モジュールを統合します。
	静電放電： ユーザーに適切な接地を取るように通知します 製品を取り扱う前の注意事項。

表 1: 記号の規則

すべての日付は ISO 8601 形式、つまり YYYY-MM-DD です。

1.5.関連文書

• Telit QMI SDK および TQCM ユーザー ガイド、1VV0301643
• uxfp ソフトウェア ユーザー ガイド、1VV0301613
• 適用表に記載されている Telit モジュールの AT コマンド リファレンス ガイド

2.オペレーティングシステムのセットアップ

2.1. 要約
適用表にリストされている Telit モジュールは、使用中の製品 ID (PID) に従ってさまざまな種類のデバイスを公開します。 次の表に、デバイス タイプと使用されるカーネル ドライバーの関連付けを示します。

特定のデバイス タイプを使用するには、関連するモジュールをカーネル ビルドに含める必要があります。

一部のカーネル モジュールは、特定のカーネル バージョン以降で見つけることができます (たとえば、cdc_mbim は 3.8 以降で利用可能です)。 ドライバーが使用中のカーネル バージョンでサポートされていない場合は、カーネルをアップグレードするか、必要なパッチをバックポートすることを検討してください。

2.2 USB 構成

2.2.1. PID と関連組成
次の表は、Linux で現在サポートされている USB 構成を一覧にしたものです。
PID:

表 3: PID と関連する構成

構成の詳細については、使用中のモジュールのソフトウェア ユーザー ガイドを参照してください。
コマンド：
$ lsusb 関数
ホストに接続されている USB デバイスを一覧表示するために使用できます。

USB 構成を変更する方法を理解し、露出したデバイスの範囲を特定するには、モデムのユーザー ガイドを参照してください。

2.2.2. マルチ構成構成
いくつかのコンポジションは複数の設定を示します (例: 0x1056): デフォルトでは最初の
構成はシステムによって使用されます。
構成を変更するには、目的の値を file:
/sys/バス/USB/デバイス/ /設定値 例
＃ エコー> /sys/バス/USB/デバイス/ /構成値
ツール usb_modeswitch を使用して構成を変更することもできます。
# usb_modeswitch -v 0x1bc7 -p -u

2.2.3. カーネルモジュールオプション
オプションのカーネル モジュールを必要とするサポート対象のコンポジションを使用し、シリアル ポートが /dev で使用できない場合、そのコンポジションのサポートがすでに終了している可能性があります。
使用中のものよりも新しいカーネル バージョンに追加されました。
解決策は、カーネルのバージョンをアップグレードするか、第 5 章にリストされているパッチの中から必要なパッチをバックポートすることです。
使用中のコンポジションにランタイム サポートを追加することができます。 root 権限で、次のコマンドを入力します。

TelitモジュールLinuxUSBドライバーソフトウェアユーザーガイド
# modprobe オプション
# エコー 1bc7 > /sys/bus/USB-serial/drivers/option1/new_id
どこサポートされるコンポジションの PID です。

コンポジションでネットワーク アダプタも使用できる場合は、シリアル ポートのランタイム サポートを追加する前に、カーネルによって正しく認識されることを確認してください。
コンポジションで ADB デバイスが使用可能な場合、シリアル ポートのランタイム サポートを追加すると、ADB デバイスはシリアル ポートにバインドされているため、正常に動作しなくなります。

オプションとしてサポートされている Telit PID の最新リストについては、メインラインのソース コードを参照し、TELIT_VENDOR_ID ベンダー ID (VID) を持つすべてのデバイス エントリを探します。
パラグラフ 2.2.1 に記載されていない構成のサポートが必要な場合は、カスタマー サポートにその旨をご連絡ください。

2.2.4. カーネルモジュール qmi_wwan
qmi_wwan カーネル モジュールを必要とするサポートされているコンポジションを使用し、コマンドによって提供されるリストにモデム関連のネットワーク インターフェイスが表示されない場合:
$ IP リンク ショー
その構成のサポートが、使用中のものよりも新しいカーネル バージョンに追加されている可能性があります。
解決策は、カーネルのバージョンをアップグレードするか、第 5 章にリストされているパッチの中から必要なパッチをバックポートすることです。
使用中のカーネルが CDC-WDM をコミットする必要がある場合: 通知の欠落による「非同期」を修正し、コミット USB で行われたように元に戻す必要があります。
「CDC-WDM: 通知の欠落による「非同期」の修正」を元に戻す
オプションとしてサポートされている Telit PID の最新リストについては、メインラインのソース コードを参照して、ベンダー ID (VID) 0x1bc7 を持つデバイスのすべてのエントリを探してください。

パラグラフ 2.2.1 に記載されていない構成のサポートが必要な場合は、カスタマー サポートにその旨をご連絡ください。

2.2.4.1. qmi_wwan と QMAP
カーネル バージョン 4.12 以降、qmi_wwan は Qualcomm Multiplexing and Aggregation Protocol (QMAP) をサポートしています。
QMAP は、複数の同時 PDN 管理に必要であり、スループットに関してハイキャット モデムを最大限に活用するために必要です。
カーネル側の QMAP 管理は qmi_wwan sys を通じて行われます files: 詳細については、カーネルのドキュメントを確認してください。
QMAP を有効にするには、ユーザー空間レベルで実行される特別なモデム構成も必要です。従うべき手順は、使用するツールによって異なります。
安定したバージョンを入手するには、段落 6.2 の関連する qmi_wwan QMAP 関連の修正を確認してください。

QMAP が設定されていない場合、qmi_wwan の RX URB サイズは 2048 バイトより大きくなければなりません。
この設定は実行時に構成でき、IP リンク セットなどのデータ接続を設定する前に、ネットワーク インターフェイスの MTU を 2048 を超える許容値 (エンドポイントの最大パケット サイズの倍数であってはなりません) に変更します。 MTU 2500
永続的な設定の場合、次の行: dev->rx_urb_size = 2048; 成功した場合に戻る前に、qmi_wwan.c 関数 qmi_wwan_bind に追加する必要があります。

モデムの使用

3.1 シリアルポートの使用
使用中のドライバーに応じて、次のデバイスがシリアル ポート用に作成されます。

表 4: デバイス名と関連するカーネル モジュール
これらは Linux キャラクター デバイスであり、tty レイヤーによって実装されるほとんどの機能をサポートします。ampminicom のような端末エミュレータを使用して、AT コマンドを送信できます。
これらのデバイスを使用するためのコードを記述する場合は、キャラクター デバイスに関連するプログラミング言語 API を参照してください。 元としてampファイル、C アプリケーションは、システム ヘッダーでエクスポートされた関数を使用できます。 file■fcntl. h と unistd。 h. 詳細については、関連する man ページを参照してください。

AT コマンドを送信する場合、応答を得るために DTR をアサートする必要があります。

3.1.1. シリアルポートによるデータ接続
シリアル ポート経由のダイヤルアップ接続を作成するには、ソフトウェア pppd を使用できます。 pppd公式を参照してください web詳細と更新されたソース コードについては、サイトを参照してください。

3.2 ネットワークアダプタの使用
ネットワーク アダプターまたはモバイル ブロードバンド デバイスが利用可能で、関連するカーネル モジュールが読み込まれている場合、オペレーティング システムによってネットワーク インターフェイスが作成されます。
標準の Linux コマンド (IP、ifconfig など) を使用して、ネットワーク インターフェイスを管理できます。詳細については、コマンドのマニュアル ページを参照してください。

3.2.1. ネットワーク インターフェイスを介したデータ接続
ネットワーク インターフェイスを介したデータ接続の確立については、使用中のカーネル モジュールに応じて、次の表の手順を参照してください。

TelitモジュールLinuxUSBドライバーソフトウェアユーザーガイド

表 5: ネットワーク デバイスに使用されるカーネル モジュールと関連するデータ接続手順

3.3 ModemManager および NetworkManager でモデムを使用する

ModemManager は、モバイル ブロードバンド (2G/3G/4G) デバイスと接続を制御する DBus 起動デーモンです。
ModemManager は、実際のデバイスとの通信に使用されるプロトコル (AT コマンド、MBIM、QMI) に関係なく、モバイル ブロードバンド モデムと通信するための統一された高レベル API を提供します。
非 AT ベースのモデムを管理するために、ModemManager は外部ライブラリを使用します: QMI ベースのモデムには freedesktop.org libqmi、MBIM ベースのモデムには libmbim です。
ModemManager を freedesktop.org NetworkManager と併用すると、ネットワーク接続の管理が容易になります。
NetworkManager は、標準の Linux ネットワーク構成ツール スイートです。 デスクトップからサーバー、モバイルまで、幅広いネットワーク設定をサポートし、一般的なデスクトップ環境やサーバー構成管理ツールとうまく統合します。
NetworkManager は、NetworkManager デーモンへのアクセスに使用される完全な D-Bus API を提供します。 このインターフェイスを使用して、ネットワーク ステータスと、現在の IP アドレスや DHCP オプションなどのネットワーク インターフェイスの詳細を照会できます。 API は、接続の管理にも使用できます (作成、アクティブ化、非アクティブ化など)。
NetworkManager は、freedesktop.org ModemManager を使用してモバイル ブロードバンド デバイスをサポートします。

点滅装置

4.1オーバーview
次の表にリストされているモデムは、カーネル モジュールへのバインドが必要な場合がある特別な点滅デバイスを介したファームウェア アップデートをサポートしています。

表 6: 点滅するデバイス
GE/HE/UE910、UE866、UL865、LE910 V2、LE940B6、および LE866 で使用可能な点滅デバイスは、モデムの電源を入れると数秒間表示されます。点滅アプリケーションが実行されていない場合、点滅デバイスは切断され、モデムは続行します。通常の操作モードで。

カーネル バージョンでのフラッシュ デバイスのサポートについては、第 5 章を確認してください。

4.2 デバイス 0x18d1:0xd00d の点滅
Flashing デバイス 0x18d1:0xd00d は、Telit ファームウェア更新アプリケーションによってユーザー空間レベルで管理されます。 詳細については、文書 1VV0301613 を参照してください。

レガシー Telit ファームウェア アップデート アプリケーションの寿命には、デバイスをオプション ドライバにバインドする必要があります。
これは、カーネル ソース drivers/USB/serial/option.c の構造体 usb_device_id option_ids に { USB_DEVICE(0x18d1, 0xd00d) } という行を追加することで永続的に行うことができます。
テスト目的で、パラグラフ 2.2.2 で説明されている手順を使用できます。
$ modprobe オプション
$ echo 18d1 d00d > /sys/bus/usb-serial/drivers/option1/new_id

4.3 デバイスの点滅 0x058b:0x0041
点滅しているデバイス 0x058b:0x0041 は ACM デバイスとして表示されますが、カーネル ドライバー usb-serial-simple によって駆動される必要があります。 このデバイスのサポートは、カーネル バージョン 4.4 以降で利用できます。
以前のカーネル バージョンにはコミットが必要です kernel/git/torvalds/linux.git – Linux カーネル ソース ツリー そして kernel/git/torvalds/linux.git – Linux カーネル ソース ツリー.

4.4 デバイスの点滅 0x8087:0x0716
フラッシュ デバイス 0x8087:0x0716 のサポートは、ドライバー USB-serial-simple を使用するカーネル バージョン 3.12 以降で利用できます。
以前のカーネル バージョンではコミットが必要 kernel/git/torvalds/linux.git – Linux カーネル ソース ツリー

TELITカーネルコミット

以下は、適用表に記載されているモデムで利用可能な構成に関連するカーネル コミットのリストです。必要な PID が利用できない場合は、バックポートを検討してください。
使用されているカーネル バージョンで。

表 7: Telit モジュールに関連するカーネルのコミット

追加のカーネルコミット

6.1 qmi_wwan の raw-ip サポートと重要な修正
以下は、qmi_wwan に Raw-Ip サポートを追加し、重要な問題に対処するためのコミットのリストです。

表 8: qmi_wwan 関連のカーネルコミット

6.2 qmi_wwan での QMAP サポート
以下は、qmi_wwan に QMAP サポートを追加するためのコミットのリストです。

表 9: qmi_wwan QMAP 関連のカーネルコミット

製品と安全に関する情報

7.1 著作権およびその他の通知

仕様は予告なく変更される場合があります
このドキュメントの正確性を確保するために合理的な努力が払われていますが、Telit は、このドキュメントの不正確さや省略、またはここに含まれる情報の使用に起因する責任を負いません。 この文書に含まれる情報は慎重に確認されており、信頼できるものであると信じられています。 Telit は、ここに記載されている製品を変更し、それらを改訂し、そのような改訂または変更を誰にも通知する義務を負うことなく、随時変更する権利を留保します。 Telit は、ここに記載されている製品、ソフトウェア、または回路のアプリケーションまたは使用から生じるいかなる責任も負いません。 また、その特許権または他者の権利に基づくライセンスを譲渡するものでもありません。
このドキュメントには、Telit の製品 (マシンとプログラム)、またはお客様の国で発表されていないサービスに関する参照または情報が含まれている場合があります。 そのような参照または情報は、Telit がそのような Telit 製品、プログラミング、またはサービスをあなたの国で発表する意図があることを必ずしも意味するものではありません。

7.1.1.著作権
この取扱説明書およびここに記載されている Telit 製品には、半導体メモリまたはその他のメディアに格納されたコンピュータ プログラムなど、Telit の著作権で保護された資料が含まれているか、説明されている場合があります。 イタリアおよびその他の国の法律は、Telit およびそのライセンサーに、著作権で保護された素材のコピー、あらゆる形式での複製、配布、および派生物の作成を行う独占的権利を含む、著作権で保護された素材の特定の独占的権利を留保します。 したがって、ここに含まれる、またはこの取扱説明書に記載されているテリットまたはそのライセンサーの著作権で保護された資料は、所有者の書面による明示的な許可なしに、いかなる方法でもコピー、複製、配布、結合、または変更してはなりません。 さらに、テリット製品の購入は、直接的または暗示的または禁反言を問わず、いかなる方法においてもライセンスを付与するものとはみなされないものとします。
7.1.2. コンピュータ ソフトウェアの著作権
この取扱説明書に記載されている Telit およびサード パーティが提供するソフトウェア (SW) 製品には、半導体メモリまたはその他のメディアに保存された Telit およびその他のサード パーティの著作権で保護されたコンピュータ プログラムが含まれている場合があります。 イタリアおよびその他の国の法律は、Telit およびその他のサード パーティに、著作権で保護されたコンピューター プログラムの SW 排他的権利を留保します。 したがって、この取扱説明書に記載されているテリットの製品に含まれる著作権で保護されたコンピュータ プログラムは、テリットまたはサード パーティのソフトウェア サプライヤである著作権所有者の書面による明示的な許可なしに、いかなる方法でもコピー (リバース エンジニアリング) または複製することはできません。
さらに、Telit 製品の購入は、Telit またはその他のサードパーティが提供する SW の著作権、特許、または特許出願に基づくライセンスを、直接または黙示、禁反言、またはその他の方法で付与したものとはみなされません。製品の販売における法律の運用によって生じる通常の非独占的で使用料無料のライセンス。

7.2 使用および開示の制限
7.2.1. ライセンス契約
このドキュメントで説明されているソフトウェアは、Telit とそのライセンサーが所有しています。 これは、明示的な使用許諾契約によってのみ提供され、かかる契約の条件に従ってのみ使用されるものとします。
7.2.2. 著作物
ソフトウェアとドキュメントは著作権で保護された資料です。 無断で複製することは法律で禁止されています。 ソフトウェアまたはドキュメンテーションは、
Telit の事前の書面による許可なしに、いかなる形式または手段によっても、複製、送信、転写、部分的であっても、検索システムに保存、または言語またはコンピューター言語に翻訳することはできません。
7.2.3. ハイリスク素材
ここに記載されている製品の製造に使用されるコンポーネント、ユニット、またはサードパーティ製品は、フォールト トレラントではなく、フェイルセーフ制御を必要とする次の危険な環境でオンライン制御機器として使用するように設計、製造、または意図されていません。核施設、航空機航法または航空機通信システム、航空交通管制、生命維持装置、または兵器システム (「危険度の高い活動」)。 Telit およびそのサプライヤーは、そのようなリスクの高い活動に対するフィットネス資格の明示的または黙示的な保証を明確に否認します。

7.2.4. 商標
TELIT と Stylized T-Logo は商標局に登録されています。 他のすべての製品またはサービス名は、それぞれの所有者の所有物です。
7.2.5. 第三者の権利
ソフトウェアには、第三者のソフトウェア権利が含まれる場合があります。 この場合、ユーザーは、そのような別個のソフトウェアの権利に関して課されるすべての条件に従うことに同意します。 サード パーティ条件に加えて、このライセンスの保証の免責事項および責任の制限条項は、サード パーティの権利ソフトウェアにも適用されるものとします。
TELIT はここに、いかなる別物に関して、第三者から明示または黙示されているすべての保証を否認します。 FILES、ソフトウェアに含まれるサード パーティのマテリアル、ソフトウェアの派生元であるサード パーティのマテリアル (総称して「その他のコード」)、およびソフトウェアに関連するその他のコードの一部またはすべての使用。満足のいく品質または特定の目的への適合性の保証。
他のコードの第三者ライセンサーは、いかなる直接的、間接的、偶発的、特別、懲罰的、または結果的損害 (利益の損失を含むがこれに限定されない) に対しても責任を負わないものとします。 、他のコードの使用または配布、またはこのライセンスおよび別のライセンスに適用される法的条件のいずれかまたは両方に基づいて付与された権利の行使から何らかの形で生じる FILES、そのような損傷の可能性について知らされていたとしても。
7.2.6. 免責事項
いかなる場合においても、テリットおよびその関連会社は、いかなる種類の直接的、間接的、特別、一般的、付随的、結果的、懲罰的、または模範的な間接的損害に対しても責任を負わないものとします。生産の損失、利益の損失、使用の損失、ビジネスの損失、データまたは収益の損失、そのような損害の可能性が合理的に予見できたかどうかにかかわらず、製品/S の使用または現在の文書に含まれる情報は、たとえ TELIT および/またはその関連会社がそのような損害の可能性について知らされていたとしても、またはそれらが予見可能であるか、または第三者による請求のためのものであっても.

7.3安全に関する推奨事項
お住まいの国および必要な環境で、この製品の使用が許可されていることを確認してください。 この製品の使用は危険な場合があり、次のような場所での使用は避ける必要があります。

• 特に病院、空港、航空機などの環境では、他の電子機器に干渉する可能性があります。
• ガソリンスタンド、石油精製所などでは爆発の危険があります。国の規制および特定の環境規制を実施することは、ユーザーの責任です。

製品を分解しないでください。 tの任意のマークamp使用すると、保証の有効性が損なわれます。 製品の正しい配線については、ハードウェア ユーザー ガイドの指示に従うことをお勧めします。 製品には、安定した容量を供給する必要がありますtag電源および配線は、セキュリティおよび防火規則に準拠する必要があります。
静電気放電により製品自体が損傷する可能性があるため、ピンに触れないように注意して製品を取り扱う必要があります。 SIM についても同様の注意が必要であり、使用説明書をよく確認してください。 製品が省電力モードのときは、SIM の挿入または取り外しを行わないでください。
システム インテグレータは、最終製品の機能を担当します。 したがって、モジュールの外部コンポーネント、およびプロジェクトまたはインストールの問題には、
注意して取り扱うこと。 干渉は、GSM ネットワークまたは外部デバイスを妨害したり、セキュリティ システムに影響を与えたりするリスクを引き起こす可能性があります。 不明な点がある場合は、技術文書および有効な規制を参照してください。 すべてのモジュールには、特定の特性を持つ適切なアンテナが装備されている必要があります。 アンテナは、他の電子機器との干渉を避けるために慎重に設置する必要があり、身体からの最小距離 (20 cm) を保証する必要があります。 この要件を満たすことができない場合、システム インテグレータは最終製品を SAR 規制に照らして評価する必要があります。
この装置は、制限区域の場所に設置することを意図しています。
機器は、EN 62368-1:2014 規格に準拠した外部の特定の制限された電源によって供給される必要があります。
欧州共同体は、市場に導入された電子機器に対していくつかの指令を提供しています。 関連するすべての情報は、欧州共同体で入手できます webサイト：
https://ec.europa.eu/growth/sectors/electrical-engineering_en

用語集

ドキュメントの履歴

ご不明な点がございましたら、当社のサイトに接続し、テクニカル サポート チームにお問い合わせください www.telit.com

Telit は、このドキュメントおよびここに含まれる情報に対するすべての権利を留保します。 ここに記載されている製品、名称、ロゴ、およびデザインは、全体的または部分的に知的財産権の対象となる場合があります。 ここに含まれる情報は「現状のまま」提供されます。 このドキュメントの正確性、信頼性、特定の目的への適合性、または内容に関して、明示または黙示を問わず、いかなる種類の保証も行われません。 この文書は Telit によっていつでも改訂される可能性があります。 最新のドキュメントについては、次の Web サイトをご覧ください。 www.telit.com
著作権 © 2021, Telit
1VV0301371 改訂 14 – 2022 年 03 月 02 日