2024年3月6日发(作者：桑惜蕊)
华为MH5000-31 5G模组使用手册
目录
华为MH5000-31 5G模组使用手册 ......................................................................................... 1
模组介绍 ..................................................................................................................................2
Windows平台使用指南 .......................................................................................................3
Ubuntu/CentOS使用指南 ...................................................................................................8
树莓派4B使用指南 ............................................................................................................ 13
Raspberry Pi OS ............................................................................................................ 13
树莓派4B+OpenWrt ................................................................................................... 15
SA网络使用 .......................................................................................................................... 21
模组介绍
⚫ Usb接口为TypeC的USB 3.0接口，请使用TypeC接口的数据线，建议使用USB 3.0数据线，USB 2.0也同样兼容，但速率会收到USB 2.0的影响，USB 2.0最高下行速率为480Mbps，实际使用中真实速率根据当地的实际网络情况决定。
USB插入时请水平插入，不要向上用力掰。
⚫ 电源接头为12V/5V接头，模组会配套带一根电源线，默认使用12V电源。
红色的线为12V电源，黄色为5V（默认未接），请使用12V/1A以上电源。如果需要使用5V电源，请保证5V/1.6A以上的供电。
通常情况下，USB也可以直接给模块供电，但有些主机的USB接口供电能力不足，会影响模块使用，建议连接12V电源。
⚫ 天线一共4根，接头为IPEX1，主天线必须接，否则可能无法正常注册网络和拨号，其它三根天线为分集天线和MIMO天线，普通测试可不接，如果需要进行网络测速，建议四根天线全部连接上。
⚫ SIM卡槽在模组板背面，为Micro SIM卡，支持热插拔。
Windows平台使用指南
1. 硬件连接
插入SIM卡，数据线连接到模组TypeC USB接口和主机的USB 3.0接口，连接模块电源。
2. 安装5G模块驱动
MH5000-31_Windows_debug_driver(20200331)
双击驱动安装程序，确认后，驱动自动安装，没有安装界面，安装完成后，请重启电脑。
电脑重启后，插上5G模组，
查看我的电脑->设备管理器，驱动安装成功后，会出现四个串口设备，其中PC UI Interface为模组的AT控制串口。
3. 切换模式(如果已经切换过了不用再切换)
模组分为Linux模式和Windows模式，两种模式不通用，可以通过AT命令进行切换，也可以通过拨号客户端进行切换。
打开串口工具打开AT串口PC UI Interface(对应上图的COM20 )，COM口的数字序列是会随机改变的，打开对应名称的COM口即可。
设置波特率115200
发送ATE1 开启AT指令回显功能
发送AT^SETMODE=1 切换模组模式，这样windows才能出网卡
发送设置模式命令后模块会重新启动。
4. 拨号上网
通过打开PC UI口
发送ATE1 开启AT指令回显功能
发送AT^NDISDUP=1,1 拨号上网
发送ATE0 关闭AT指令回显功能
这时可以查看网络连接会出现华为的网卡
关掉PC自己的有线网卡或者WIFI，华为5G网卡会自动获取IP。
5. 拨号程序
Windows下提供了拨号程序，可以使用该程序进行拨号上网，AT调试。程序打开后，会自动检测5G模组并自动拨号。
拨号成功后，会显示网络信号强度，模块信息以及网络信息，右侧会显示模块上报的AT信息，在命令调试窗口，可以手动输入AT命令进行调试，如果需要切换到Linux模式，也可以点击上方的切换模式进行切换。
Ubuntu/CentOS使用指南
Ubuntu 16.04以上，CentOS 7.0以上版本均直接支持华为5G模组，直接连接5G模块，系统自动识别设备。
默认会在/dev下出现4个串口设备，ttyUSB0~3，AT控制串口为ttyUSB1，同时，会出现网卡设备，可以通过ifconfig -a进行查看
网卡名称可能会有不同，但MAC地址都是统一的，00:1e:10:1f:00:00
进入ubuntu的网络设置，选择添加一个新的连接
然后按照提示步骤进行操作
国家区域的地方要选择China
选择运营商
确认完成后提交。
在右上角网络连接状态中会出现移动网络，选择一个你建立的连接
网络连接成功后，可以查看获取的IP地址信息
树莓派4B使用指南
Raspberry Pi OS
树莓派系统也是基于Debian的Linux系统，所以默认就已经支持5g模组了，但是，树莓派没有像ubuntu那样通过图形界面创建连接，需要进行手动拨号。
树莓派启动后，连接模组到树莓派4B的USB 3.0接口
在/dev目录下，会看到模组的串口设备
ttyUSB1为AT控制口，可以对模块进行控制。
如果需要拨号，只需要在终端里发送一条AT指令
echo -e “at^ndisdup=1,1rn” > /dev/ttyUSB1
树莓派也有专门的串口调试工具，可以直接调试AT指令
busybox microcom -s 115200 /dev/ttyUSB1
拨号成功后，网卡会自动获取IP地址，树莓派4B下的网卡名称是eth开头，获取到IP后，就可以直接上网了。
树莓派4B+OpenWrt
OpenWrt是一个开源的路由器系统，同样也是基于Linux，代码可以通过github获取
Git clone /openwrt/
OpenWrt已支持树莓派4B，通过make menuconfig可以选择。
./script/feeds update -a
./script/feeds install -a
make menuconfig
前三项按照图中进行设置
配置kernel
确保以上红框的开关全部打开，其它OpenWrt的配置可以根据需求配置，如LUCI，network,
Application等，配置完成后，保存退出。
华为5G模组需要对内核USB的源码修改零包处理的部分，具体源码路径为：
build_dir/target-aarch64_cortex-a72_musl/linux-bcm27xx_bcm2711/linux-5.4.67/drivers/usb/serial/
如果编译的是其它平台的OpenWrt，对应的目录结构可能会有差别，请根据相应的硬件平台目录查找。
修改的文件为usb_wwan.c和option.c
具体修改的内容请参阅华为官方Linux移植文档，里面有详细修改代码，直接复制到相应位置就可以，修改完后，编译OpenWrt。
编译完成后，可以看到生成的image
将解压，并通过工具写入到T卡中，插入树莓派4B中启动即可。
启动树莓派，电脑与树莓派的网口连接，自动获取IP地址，树莓派地址默认为192.168.1.1
浏览器打开192.168.1.1
在网络->接口中添加5G模块的接口
添加新接口wwan，接口为5G模块的对应网卡名称，树莓派里是eth1。
确定后保存。
拨号可以通过命令行手动拨号，参考树莓派OS里面的拨号方式，通过ssh命令登录到树莓派上，通过命令进行拨号
echo -e “at^ndisdup=1,1rn” > /dev/ttyUSB1
拨号成功后，系统会自动获取5G网卡 eth1的IP地址
也可以通过shell脚本或者拨号程序让树莓派启动后自动拨号联网，拨号脚本和拨号程序可通过网盘获取。
至此，树莓派4B就成为了一个5G网关，WIFI部分这里没有进行配置，如需使用，可在menuconfig中打开相应开关即可。
其它平台的OpenWrt与此大同小异，只是编译环境的不通，需要修改的内核源码和编译过程都是一样的。
SA网络使用
模组默认情况下是关闭SA的，需要通过AT指令的方式开启
1、切换NR-5GC模式 ：at^c5goption=1,1,1
2、重启模组： at^reset
3、打开SA模式：AT^SYSCFGEX="08",3FFFFFFF,1,2,7FFFFFFFFFFFFFFF,,
4、 查询当前注册状态：AT^SYSINFOEX
看到NR-5GC的时候，说明SA网络已经打开。
2024年3月6日发(作者：桑惜蕊)
华为MH5000-31 5G模组使用手册
目录
华为MH5000-31 5G模组使用手册 ......................................................................................... 1
模组介绍 ..................................................................................................................................2
Windows平台使用指南 .......................................................................................................3
Ubuntu/CentOS使用指南 ...................................................................................................8
树莓派4B使用指南 ............................................................................................................ 13
Raspberry Pi OS ............................................................................................................ 13
树莓派4B+OpenWrt ................................................................................................... 15
SA网络使用 .......................................................................................................................... 21
模组介绍
⚫ Usb接口为TypeC的USB 3.0接口，请使用TypeC接口的数据线，建议使用USB 3.0数据线，USB 2.0也同样兼容，但速率会收到USB 2.0的影响，USB 2.0最高下行速率为480Mbps，实际使用中真实速率根据当地的实际网络情况决定。
USB插入时请水平插入，不要向上用力掰。
⚫ 电源接头为12V/5V接头，模组会配套带一根电源线，默认使用12V电源。
红色的线为12V电源，黄色为5V（默认未接），请使用12V/1A以上电源。如果需要使用5V电源，请保证5V/1.6A以上的供电。
通常情况下，USB也可以直接给模块供电，但有些主机的USB接口供电能力不足，会影响模块使用，建议连接12V电源。
⚫ 天线一共4根，接头为IPEX1，主天线必须接，否则可能无法正常注册网络和拨号，其它三根天线为分集天线和MIMO天线，普通测试可不接，如果需要进行网络测速，建议四根天线全部连接上。
⚫ SIM卡槽在模组板背面，为Micro SIM卡，支持热插拔。
Windows平台使用指南
1. 硬件连接
插入SIM卡，数据线连接到模组TypeC USB接口和主机的USB 3.0接口，连接模块电源。
2. 安装5G模块驱动
MH5000-31_Windows_debug_driver(20200331)
双击驱动安装程序，确认后，驱动自动安装，没有安装界面，安装完成后，请重启电脑。
电脑重启后，插上5G模组，
查看我的电脑->设备管理器，驱动安装成功后，会出现四个串口设备，其中PC UI Interface为模组的AT控制串口。
3. 切换模式(如果已经切换过了不用再切换)
模组分为Linux模式和Windows模式，两种模式不通用，可以通过AT命令进行切换，也可以通过拨号客户端进行切换。
打开串口工具打开AT串口PC UI Interface(对应上图的COM20 )，COM口的数字序列是会随机改变的，打开对应名称的COM口即可。
设置波特率115200
发送ATE1 开启AT指令回显功能
发送AT^SETMODE=1 切换模组模式，这样windows才能出网卡
发送设置模式命令后模块会重新启动。
4. 拨号上网
通过打开PC UI口
发送ATE1 开启AT指令回显功能
发送AT^NDISDUP=1,1 拨号上网
发送ATE0 关闭AT指令回显功能
这时可以查看网络连接会出现华为的网卡
关掉PC自己的有线网卡或者WIFI，华为5G网卡会自动获取IP。
5. 拨号程序
Windows下提供了拨号程序，可以使用该程序进行拨号上网，AT调试。程序打开后，会自动检测5G模组并自动拨号。
拨号成功后，会显示网络信号强度，模块信息以及网络信息，右侧会显示模块上报的AT信息，在命令调试窗口，可以手动输入AT命令进行调试，如果需要切换到Linux模式，也可以点击上方的切换模式进行切换。
Ubuntu/CentOS使用指南
Ubuntu 16.04以上，CentOS 7.0以上版本均直接支持华为5G模组，直接连接5G模块，系统自动识别设备。
默认会在/dev下出现4个串口设备，ttyUSB0~3，AT控制串口为ttyUSB1，同时，会出现网卡设备，可以通过ifconfig -a进行查看
网卡名称可能会有不同，但MAC地址都是统一的，00:1e:10:1f:00:00
进入ubuntu的网络设置，选择添加一个新的连接
然后按照提示步骤进行操作
国家区域的地方要选择China
选择运营商
确认完成后提交。
在右上角网络连接状态中会出现移动网络，选择一个你建立的连接
网络连接成功后，可以查看获取的IP地址信息
树莓派4B使用指南
Raspberry Pi OS
树莓派系统也是基于Debian的Linux系统，所以默认就已经支持5g模组了，但是，树莓派没有像ubuntu那样通过图形界面创建连接，需要进行手动拨号。
树莓派启动后，连接模组到树莓派4B的USB 3.0接口
在/dev目录下，会看到模组的串口设备
ttyUSB1为AT控制口，可以对模块进行控制。
如果需要拨号，只需要在终端里发送一条AT指令
echo -e “at^ndisdup=1,1rn” > /dev/ttyUSB1
树莓派也有专门的串口调试工具，可以直接调试AT指令
busybox microcom -s 115200 /dev/ttyUSB1
拨号成功后，网卡会自动获取IP地址，树莓派4B下的网卡名称是eth开头，获取到IP后，就可以直接上网了。
树莓派4B+OpenWrt
OpenWrt是一个开源的路由器系统，同样也是基于Linux，代码可以通过github获取
Git clone /openwrt/
OpenWrt已支持树莓派4B，通过make menuconfig可以选择。
./script/feeds update -a
./script/feeds install -a
make menuconfig
前三项按照图中进行设置
配置kernel
确保以上红框的开关全部打开，其它OpenWrt的配置可以根据需求配置，如LUCI，network,
Application等，配置完成后，保存退出。
华为5G模组需要对内核USB的源码修改零包处理的部分，具体源码路径为：
build_dir/target-aarch64_cortex-a72_musl/linux-bcm27xx_bcm2711/linux-5.4.67/drivers/usb/serial/
如果编译的是其它平台的OpenWrt，对应的目录结构可能会有差别，请根据相应的硬件平台目录查找。
修改的文件为usb_wwan.c和option.c
具体修改的内容请参阅华为官方Linux移植文档，里面有详细修改代码，直接复制到相应位置就可以，修改完后，编译OpenWrt。
编译完成后，可以看到生成的image
将解压，并通过工具写入到T卡中，插入树莓派4B中启动即可。
启动树莓派，电脑与树莓派的网口连接，自动获取IP地址，树莓派地址默认为192.168.1.1
浏览器打开192.168.1.1
在网络->接口中添加5G模块的接口
添加新接口wwan，接口为5G模块的对应网卡名称，树莓派里是eth1。
确定后保存。
拨号可以通过命令行手动拨号，参考树莓派OS里面的拨号方式，通过ssh命令登录到树莓派上，通过命令进行拨号
echo -e “at^ndisdup=1,1rn” > /dev/ttyUSB1
拨号成功后，系统会自动获取5G网卡 eth1的IP地址
也可以通过shell脚本或者拨号程序让树莓派启动后自动拨号联网，拨号脚本和拨号程序可通过网盘获取。
至此，树莓派4B就成为了一个5G网关，WIFI部分这里没有进行配置，如需使用，可在menuconfig中打开相应开关即可。
其它平台的OpenWrt与此大同小异，只是编译环境的不通，需要修改的内核源码和编译过程都是一样的。
SA网络使用
模组默认情况下是关闭SA的，需要通过AT指令的方式开启
1、切换NR-5GC模式 ：at^c5goption=1,1,1
2、重启模组： at^reset
3、打开SA模式：AT^SYSCFGEX="08",3FFFFFFF,1,2,7FFFFFFFFFFFFFFF,,
4、 查询当前注册状态：AT^SYSINFOEX
看到NR-5GC的时候，说明SA网络已经打开。