- 合宙模组支持RNDIS吗?
- 怎么使用USB RNDIS联网?
- 我这里需要RNDIS…
社群工程师朋友常问的RNDIS是什么呢?
RNDIS是指Remote NDIS,也就是在USB设备上跑TCP/IP,让USB设备看上去像一块网卡,从而使Windows/Linux可以通过USB设备连接网络。
当前合宙主推的低功耗4G-Cat.1系列模组/工业引擎产品,均已支持RNDIS功能。
需要注意的是:
RNDIS网卡应用默认关闭(不然太容易跑流量),使用LuatOS开发时需要先通过mobile.config接口开启RNDIS。
本文以Air780EPM系列核心板/开发板为例,分享在Windows及Linux系统下,通过RNDIS方式实现USB上网的要点。



Air780EPM系列应用示例持续更新中,RNDIS示例最新资料详见下方链接。
最新示例源码:
https://gitee.com/openLuat/LuatOS/tree/master/module/Air780EHM_Air780EHV_Air780EGH/demo/rndis_ecm实操教程详见:
https://docs.openluat.com/air780epm/luatos/app/common/rndis/API文档详见:
https://docs.openluat.com/osapi/core/mobile/
一
Windows下使用RNDIS功能
Windows系统默认支持RNDIS,直接用USB连接板子和电脑就可以使用。
1.1 核心示例代码
open_rndis.lua核心代码如下图示,完整demo详见源码仓库最新文件。

1.2 确认RNDIS状态
先用Luatools将相关代码烧录到模组中,通过日志来确认是否已经成功开启RNDIS功能:
1.3 在Widows中启用RNDIS
当开启RNDIS功能后,Air780EPM会虚拟一个网卡,此网卡可在“设备管理器”或“高级网络设置”中看到。


启用完毕后,即可看到我们电脑的图标已经变为以太网连接,此时可以正常使用RNDIS上网了。

1.4 相关注意事项
由于Air780EPM驱动使用的是CDC驱动,所以请使用Win10及其以上系统(Win10以下系统,Air780EPM不做支持)。
如果启动后日志中打印RNDIS启动成功,但是Windows上没有连上网络,需要确认下系统是否将RNDIS的虚拟网卡禁用了。
二
Linux下使用RNDIS功能
2.1 在Linux中启用RNDIS
因为Air780EPM的RNDIS使用CDC-ACM驱动,大部分Linux系统默认就支持,所以无需设置代码,插入USB就可以在Linux中使用。
使用 ls /dev/ttyACM* 即可看到三个端口:
在控制台查看USB设备可以看到一个ID为19d1:0001的USB设备,这个就是Air780EPM虚拟出的USB网卡:
查看网卡信息可以看到如下信息:
尝试使用ping命令访问百度,联网成功:
2.2 相关注意事项
有些Llinux设备存在Air780EPM重启后,操作文件会发生移位。
比如:
本来是/dev/ttyACM0/1/2,重启后变成了ttyUSB1/3/4。
最靠谱的方法是,通过驱动节点来找到操作文件usb_find.c;
寻找真正的需要的端口:
FindUsbDevice(AIRM2M_USB_DEVICE_AT_INTERFACE_ID)
每个设备的ethx可能不一样,插入Air780EPM后增加的网卡即为RNDIS网卡。
如果遇到没有RNDIS驱动的情况,可在编译内核时参考下图配置:

今天的内容就分享到这里了~如果您在物联网开发选型中有任何疑问,欢迎加技术交流群或联络产品负责人共同探讨。
更多最新开发资料,详见合宙资料中心:
—— docs.openluat.com



