📡 MT5700M-CN

Introduction

• MT5700M-CN is based on 3GPP Release 16 technology, supporting 5G NR NSA and SA dual-mode networking, and supports 5G and industry-specific features: super uplink, SUL, uRLLC, 5G LAN, high-precision timing, network slicing, and industry customization, etc.
• MT5700M-CN supports 5G Sub-6 GHz, with frequency band coverage for mainland China, and is backward compatible with 4G/3G. The peak uplink and downlink rates of 5G NR can reach 4Gbps and 1.5Gbps respectively, meeting the high-bandwidth requirements of industrial applications.
• MT5700M-CN adopts M.2 package, uses high-reliability devices and unique industrial design, adapts to the diversity of industrial environments, with an operating temperature range of -30℃~70℃. MT5700M-CN integrates rich hardware interfaces, including USB/XGE/PCIe/UART/SPI/I2C/USIM/GPIO, etc., fully meeting the interface needs of industrial equipment.

MT5700M-CN is loved by 5G CPE DIY enthusiasts due to its ease of use, simple operation, support for 3CC carrier aggregation, and its price advantage over other similar modules, but due to the incomplete private AT manual, some functions are unavailable, making its playability slightly inferior to Quectel modules.

Purchase Methods

Available for sale by individuals and IoT device manufacturers on platforms such as Taobao and Xianyu, with market prices ranging from ￥650 to ￥750.

🔌 Connection Methods

MT5700M-CN adopts M.2 Key-B interface package, supporting USB 3.0, PCIe, PHY data transmission.

🔗 USB 3.0

Connected to the host as a USB device, it reports the USB port configuration and then communicates and works with the host. Currently supports Windows and Linux

There are the following 9 port configurations, which can be set via the AT command AT^SETMODE=<port configuration ID>. The module automatically restarts after the command is sent.

Explanation of several important port configurations:

• 🖥️ PCUI: Used for AT communication
• 📊 Serial_B/C: Used in combination with DIAG to collect log information
• 🔍 DIAG: Used for debugging and logging, see Log Acquisition for details
• 🛠️ ADB: ADB port, only available in debug firmware, regardless of whether it is in Debug port configuration

In practice, it is recommended to use the NCM port configuration, as this port provides two endpoints, improving bandwidth utilization.

💻 PCIe Mode

Operates in PCIe RC mode, other modes are not supported yet.

Application Guide

Preparation

• Install Windows/Linux drivers
• Install any serial port software (such as XCOM, SSCOM, ...), serial port parameters usually do not need adjustment.
• Ensure it is in the corresponding port configuration, so that the corresponding ports can be enumerated. (On Windows, check in Device Manager; on Linux, enter lsusb to view)

AT communication port:

• If on Windows system, the port is Application Interface
• If on Linux system, the device is often enumerated as /dev/ttyUSB1

Dial-up Internet Guide

Defaults to dual-stack network (IPv4 + IPv6). To modify, please refer to the manual.

Manual Dial-up

Enter AT^NDISDUP=1,1 and observe the response to determine if the dial-up is successful.

To cancel dial-up, enter AT^NDISDUP=1,0.

Auto Dial-up

Auto dial-up executes automatically every time the module starts, no manual intervention required.

If auto dial-up configuration has been performed before, cancel the setting first, otherwise the new setting will not take effect. Enter AT^SETAUTODIAL=0.

• If using USB 3.0 connection, enter AT^SETAUTODIAL=1,1 and observe the response.
• If using PHY network port connection, enter AT^SETAUTODIAL=1,2 and observe the response.

For PCIe connection method, I currently have no host device, please refer to the manual for your own research.

LED Network Status

The module has LED display disabled by default. Enable it with AT^LEDSWITCH=1, effective after restart.

❓ Module Upgrade and Downgrade

Due to missing firmware packages for some Linux platforms, it is recommended to use a Windows platform host for upgrading/downgrading.

1. Download and install the Dingqiao platform driver.
2. Download the upgrade guide for the corresponding platform, and perform upgrade/downgrade according to the upgrade guide requirements.

Manual Download

The link contains the following guide manuals:

• MT5700M-CN 5G Module Hardware Design Guide
• 5G LAN Function Verification Guide
• 5G Slicing Function Test Guide
• AT Command Manual
• DIAG TOOL User Guide
• FOTA Upgrade Guide
• Linux Kernel Driver Integration Guide
• USB Interface Application Guide
• Windows USB Driver Installation Guide
• Sleep Wake-up Guide
• Function Application Guide
• Temperature Protection Solution Usage Guide
• Local Upgrade Guide_Linux
• Local Upgrade Guide_Windows
• Local Log Acquisition and Tool Integration Guide_Linux
• Local Log Acquisition Guide_Windows
• High-Precision Timing Function Verification Guide

Copyright belongs to Dingqiao Communication Technology Co., Ltd.. If there is any infringement, please email i@racel.dev, and I will delete it immediately.

Software Compatible with MT5700M-CN

• QModem: Module management plugin, compatible with QWRT/LEDE/Immortalwrt/Openwrt
• MT5700M PHY AT ETH Control: Python script for controlling network port connection method
• Web UI: Control panel for MT5700M-CN developed by an individual developer, not open source yet, please find and download it yourself

Linux Compatibility

See Linux Kernel Driver Integration Guide for details, or you can directly use the kernel patch I prepared.

If the usbserial driver is loaded and lsusb shows the module's corresponding device, you can manually execute sudo /bin/sh -c 'echo 3466 3301 > /sys/bus/usb-serial/drivers/generic/new_id';

After execution, you should see the enumeration of /dev/ttyUSB*.

FOTA Upgrade Tutorial

Server Setup

Preparation

Using HTTP instead of HTTPS here, as certificate configuration is too cumbersome.

1. Public network nginx server
2. Binary module firmware package
3. Module in online state

Assume the firmware package is placed in the /tmp/fota/full folder (up to now, you must place it in the full folder)

Assume your nginx is running at http://localhost/

nginx Configuration

Assume the final FOTA download link is http://localhost/download/b16

Then your site configuration should be:

Configure FOTA Update Package

FOTA update package is provided by Dingqiao, but individuals often cannot obtain it. Here is a configuration method I researched; strictly follow this method to configure without issues.

The aforementioned full folder should contain three files, and the naming must be strictly consistent:

• FIRMWARE1.BIN - Binary firmware package, same as the update package used on Linux platform; for Windows platform update guide, it needs to be extracted.
• changelog.xml - Update log file, required
• filelist.xml - Records MD5 and size of the above two files, required

changelog.xml

Here you only need to modify the version number.

filelist.xml

For different versions of firmware packages, pay attention to updating md5 and size.

Execute FOTA Update

See FOTA Upgrade Guide for details

1. Enter AT^FOTASTATE?, should currently return 10, indicating waiting for download state
2. Enter AT^FOTAOEMDL="url", where url is filled with the above http://localhost/download/b16
3. Wait for download to complete, you can use AT^FOTADQL to observe download progress
4. After download completes, status response is 40, enter AT^FWUP to execute update
5. After update preparation is complete, status response is 50, the device will automatically restart and enter DLOAD mode to perform the update

If the device does not perform the update after restart, it means your firmware package verification failed (Dingqiao adds a digital signature to each firmware package), which often occurs when extracting the firmware package from exe yourself, please check again.

If an error occurs during the FOTA download and update process, it means there is a problem with your FOTA server configuration, please check the configuration section and check the nginx access log.

The Magic code of the firmware package is 55 AA 5A A5, which can be searched and extracted directly in the .exe file, pay attention to strict alignment at the end.

📡 Antenna Definition

📋 Technical Specifications