MT5700M-CN
📡 MT5700M-CN
MT5700M-CN
紹介
MT5700M-CNは3GPP Release 16技術を基盤とし、5G NR NSAおよびSAのデュアルモードネットワーキングをサポートしています。5G および業界特化機能として、スーパーアップリンク、SUL、uRLLC、5G LAN、高精度授時、ネットワークスライシング、業界カスタマイズなどをサポートします。MT5700M-CNは5G Sub-6 GHzをサポートし、中国大陸の周波数帯域をカバー、4G/3G への下位互換性があります。5G NRの上下行ピーク速度はそれぞれ最大4Gbpsおよび1.5Gbpsに達し、業界用途の高帯域要件を満たします。MT5700M-CNはM.2パッケージを採用し、高信頼性部品および産業向け独自設計を施しており、多様な産業環境に適応します。動作温度範囲は-30℃~70℃です。MT5700M-CNは豊富なハードウェアインターフェースを統合しており、USB/XGE/PCIe/UART/SPI/I2C/USIM/GPIOなどを備え、産業機器のインターフェースニーズを十分に満たします。
MT5700M-CN は使いやすさ、操作のシンプルさ、3CC キャリアアグリゲーション対応、そして同クラス他モジュールに比べて価格面で優位性があることから、5G CPE DIY 愛好者に大変人気があります。ただし、独自の AT マニュアルが不完全であるため、一部機能が利用できない点があり、移遠 Quectel モジュールに比べると遊び心の面でやや劣ります。
購入方法
淘宝、闲魚などのプラットフォームで個人や IoT 機器メーカーが販売しており、市場価格は ¥650 ~ ¥750 程度です。
🔌 接続方式
MT5700M-CN は M.2 Key-B インターフェースパッケージを採用し、USB 3.0、PCIe、PHY データ伝送をサポートします。
🔗 USB 3.0
USB デバイス としてホストに接続され、USB ポート形態 を報告した後、ホストと通信して動作します。現在 Windows、Linux に対応しています
以下の 9 種類のポート形態があり、AT コマンド AT^SETMODE=<ポート形態 ID> で設定可能です。コマンド送信後、自動的に再起動します。
| ID | 説明 |
|---|---|
| 0 | 🐧 Linux ECM Normal, ECM+DIAG+PCUI+Serial_B+Serial_C+GPS |
| 1 | 🪟 Windows NCM Normal, DIAG+PCUI+Serial_B+Serial_C+GPS+NCM |
| 2 | 🐧 Linux ECM Debug, ECM+DIAG+PCUI+ADB+Serial_B+Serial_C+GPS |
| 3 | 🪟 Windows NCM Debug, DIAG+PCUI+Serial_B+Serial_C+GPS+ADB+NCM |
| 4 | 🐧 Linux NCM Normal (デフォルト), NCM+DIAG+PCUI+Serial_B+Serial_+GPS |
| 5 | 🐧 Linux NCM Debug, NCM+DIAG+PCUI+ADB+Serial_B+Serial_C+GPS |
| 6 | 🪟 Windows RNDIS, RNDIS+DIAG+PCUI+Serial_B+Serial_C+GPS |
| 7 | 🪟 Windows MBIM (未対応), MBIM+DIAG+PCUI+Serial_B+Serial_C+GPS |
| 8 | 📞 PPP, Modem+DIAG+PCUI+Serial_B+Serial_C+GPS |
重要なポート形態の説明:
- 🖥️ PCUI: AT 通信用
- 📊 Serial_B/C:
DIAGと組み合わせてログ情報収集に使用 - 🔍 DIAG: デバッグおよびログ用、詳細は「ログ取得」を参照
- 🛠️ ADB: ADB ポート、
debugファームウェアでのみ利用可能。Debugポート形態かどうかに関わらず
実践的には NCM ポート形態の使用をおすすめします。このポートは 2 つのエンドポイントを提供し、帯域利用率を向上させます。
💻 PCIe モード
PCIe RC モードとして動作します。他のモードは現時点で未サポートです。
アプリケーションガイド
準備作業
- Windows/Linux ドライバのインストール
- 任意の シリアルポートソフトウェア(例:
XCOM,SSCOMなど)をインストール。シリアルパラメータは通常調整不要です。 - 対応するポート形態になっていることを確認し、対応ポートが列挙されることを確認してください。(Windows は「デバイスマネージャー」で確認、Linux は
lsusbで確認)
AT 通信ポート:
- Windows の場合、ポートは
Application Interface - Linux の場合、デバイスは通常
/dev/ttyUSB1として列挙されます
ダイヤルアップ接続ガイド
デフォルトではデュアルスタックネットワーク(IPv4 + IPv6)を使用します。変更が必要な場合はマニュアルを参照してください。
手動ダイヤル
AT^NDISDUP=1,1 を入力し、レスポンスを確認してダイヤル成功を判断します。
ダイヤルをキャンセルする場合は AT^NDISDUP=1,0 を入力します。
自動ダイヤル
自動ダイヤルはモジュール起動ごとに自動実行されるため、手動操作は不要です。
事前に自動ダイヤルの設定を行っていた場合、新しい設定を有効にする前にまず設定を解除してください。AT^SETAUTODIAL=0 を入力します。
USB 3.0接続方式の場合:AT^SETAUTODIAL=1,1を入力し、レスポンスを確認PHYネットワークポート接続方式の場合:AT^SETAUTODIAL=1,2を入力し、レスポンスを確認
PCIe 接続方式については、現在ホストデバイスがないため、マニュアルを参照してご自身で研究してください。
LED ネットワーク状態
モジュールはデフォルトで LED 表示をオフにしています。AT^LEDSWITCH=1 でオンに設定でき、再起動後に有効になります。
❓ モジュールアップグレードおよびダウングレード
Linux プラットフォーム向けファームウェアパッケージの一部が欠落しているため、Windows プラットフォームでのアップグレード/ダウングレードをおすすめします。
- 鼎橋プラットフォームドライバ をダウンロードしてインストール
- 対応プラットフォームのアップグレードガイド をダウンロードし、ガイドに従ってアップグレード/ダウングレードを実行
マニュアルダウンロード
リンク には以下のガイドマニュアルが含まれています:
- MT5700M-CN 5Gモジュールハードウェア設計ガイド
- 5G LAN機能検証ガイド
- 5Gスライシング機能テストガイド
- ATコマンドマニュアル
- DIAG TOOL ユーザーガイド
- FOTAアップグレードガイド
- Linuxカーネルドライバ統合ガイド
- USBインターフェースアプリケーショングガイド
- Windows USB ドライバインストールガイド
- スリープ/ウェイクアップガイド
- 機能アプリケーショングガイド
- 温度保護方案使用ガイド
- 近端アップグレードガイド_Linux
- 近端アップグレードガイド_windows
- 近端ログ取得とツール統合ガイド_Linux
- 近端ログ取得ガイド_Windows
- 高精度授時機能検証ガイド
著作権は 鼎橋通信技術有限公司 に帰属します。権利侵害がある場合は i@racel.dev までメールにてご連絡ください。速やかに削除いたします。
MT5700M-CN 対応ソフトウェア
- QModem: モジュール管理プラグイン、QWRT/LEDE/Immortalwrt/Openwrt に対応
- MT5700M PHY AT ETH Control: Python スクリプトによるネットワークポート接続制御スクリプト
- Web UI: 個人開発者による
MT5700M-CNコントロールパネル、現在非オープンソース。ダウンロードはご自身でお探しください
Linux 互換性
詳細は「Linuxカーネルドライバ統合ガイド」を参照するか、私が作成したカーネルパッチ を直接ご利用ください。
usbserial ドライバがロードされており、lsusb でモジュール対応デバイスが表示される場合、次のコマンドを手動で実行してください:
sudo /bin/sh -c 'echo 3466 3301 > /sys/bus/usb-serial/drivers/generic/new_id';
実行後、/dev/ttyUSB* が列挙されるはずです。
FOTA アップグレードチュートリアル
サーバー構築
準備作業
ここでは証明書の設定が煩雑なため HTTPS ではなく HTTP を使用します。
- パブリック nginx サーバー
- バイナリモジュールファームウェアパッケージ
- モジュールがネットワークに接続されている状態
ファームウェアパッケージを /tmp/fota/full フォルダに配置すると仮定(現時点では full フォルダに置く必要があります)
nginx が http://localhost/ で動作していると仮定
nginx 設定
最終的な FOTA ダウンロードリンクを http://localhost/download/b16 とすると、サイト設定は以下のようになります:
location /download/b16 {
alias /tmp/fota;
allow all;
autoindex on;
}
FOTA 更新パッケージの設定
FOTA 更新パッケージは鼎橋から提供されますが、個人では入手困難です。ここでは私が調査した設定方法を記載します。この通りに設定すれば問題ありません。
前述の full フォルダには以下の 3 ファイルが含まれ、命名を厳密に一致させてください:
- FIRMWARE1.BIN - バイナリファームウェアパッケージ(Linux プラットフォーム用更新パッケージと同一。Windows プラットフォームの更新ガイド用には抽出が必要です)
- changelog.xml - 更新ログファイル(必須)
- filelist.xml - 上記 2 ファイルの MD5 とサイズを記録(必須)
changelog.xml の例:
<?xml version="1.0" encoding="ISO-8859-1"?>
<root>
<component name="FIRMWARE1" version="1.1.6.0(SP1C02)"/>
<default-language name="de-de">1031</default-language>
<language name="en-us" code="1033">
<features>
<feature>1.product_name="MT5700M-CN"</feature>
<feature>2.update_mode="0"</feature>
<feature>3.source_version="1.1.6.0(SP1C02)"</feature>
<feature>en-us</feature>
</features>
</language>
</root>
ここではバージョン番号のみを変更します。
filelist.xml の例:
<?xml version="1.0" encoding="ISO-8859-1"?>
<root>
<component>
<name>FIRMWARE1</name>
<compress>0</compress>
</component>
<files>
<file>
<spath>changelog.xml</spath>
<dpath>changelog.xml</dpath>
<operation>c</operation>
<md5>86ed31415b5a0b978dfa677fa47bd1b1</md5>
<size>484</size>
</file>
<file>
<spath>FIRMWARE1.BIN</spath>
<dpath>FIRMWARE1.BIN</dpath>
<operation>c</operation>
<md5>06801c391284f4a12d92c5f0f6d8b830</md5>
<size>62770696</size>
</file>
</files>
</root>
異なるバージョンのファームウェアパッケージの場合、md5 と size を更新してください。
FOTA 更新の実行
詳細は FOTA アップグレードガイドを参照
AT^FOTASTATE?を入力。現在10が返ればダウンロード待機状態ですAT^FOTAOEMDL="url"を入力(urlには上記のhttp://localhost/download/b16を指定)- ダウンロード完了を待つ。
AT^FOTADQLでダウンロード進捗を確認可能 - ダウンロード完了時、状態が
40になります。AT^FWUPを入力して更新を実行 - 更新準備完了時、状態が
50になり、デバイスは自動再起動してDLOADモードで更新を実行します
再起動後に更新が実行されない場合、ファームウェアパッケージの検証に失敗しています(鼎橋は各ファームウェアにデジタル署名を付与)。exe から自分で抽出した場合は再度確認してください。
FOTA ダウンロード/更新中にエラーが発生した場合、FOTA サーバー設定に問題があります。設定部分と nginx の access log を確認してください。
ファームウェアパッケージの Magic code は 55 AA 5A A5 です。exe ファイル内で直接検索して抽出してください。末尾の位置を厳密に揃えてください。
📡 アンテナ定義
天線定義
📋 技術仕様
技術参数
技術参数