📡 MT5700M-CN

紹介

• MT5700M-CN は 3GPP Release 16 技術を基盤とし、5G NR NSA および SA のデュアルモードネットワーキングをサポートしています。5G および業界特化機能として、スーパーアップリンク、SULSUL、uRLLCuRLLC、5G LAN5G 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> で設定可能です。コマンド送信後、自動的に再起動します。

重要なポート形態の説明:

• 🖥️ 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 プラットフォームでのアップグレード/ダウングレードをおすすめします。

1. 鼎橋プラットフォームドライバ をダウンロードしてインストール
2. 対応プラットフォームのアップグレードガイド をダウンロードし、ガイドに従ってアップグレード/ダウングレードを実行

マニュアルダウンロード

リンク には以下のガイドマニュアルが含まれています：

• 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 を使用します。

1. パブリック nginx サーバー
2. バイナリモジュールファームウェアパッケージ
3. モジュールがネットワークに接続されている状態

ファームウェアパッケージを /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 アップグレードガイドを参照

1. AT^FOTASTATE? を入力。現在 10 が返ればダウンロード待機状態です
2. AT^FOTAOEMDL="url" を入力（url には上記の http://localhost/download/b16 を指定）
3. ダウンロード完了を待つ。AT^FOTADQL でダウンロード進捗を確認可能
4. ダウンロード完了時、状態が 40 になります。AT^FWUP を入力して更新を実行
5. 更新準備完了時、状態が 50 になり、デバイスは自動再起動して DLOAD モードで更新を実行します

再起動後に更新が実行されない場合、ファームウェアパッケージの検証に失敗しています（鼎橋は各ファームウェアにデジタル署名を付与）。exe から自分で抽出した場合は再度確認してください。

FOTA ダウンロード/更新中にエラーが発生した場合、FOTA サーバー設定に問題があります。設定部分と nginx の access log を確認してください。

ファームウェアパッケージの Magic code は 55 AA 5A A5 です。exe ファイル内で直接検索して抽出してください。末尾の位置を厳密に揃えてください。

📡 アンテナ定義

📋 技術仕様