08 RNDIS/ECM

作者：拓毅恒　|　最后修改：2026-09-02

一、rndis_ecm概述

RNDIS（Remote NDIS）：基于USB实现的TCP/IP over USB，让USB设备在Windows系统上呈现为一块网卡，从而使Windows/Linux可以通过USB设备连接网络。
ECM（Ethernet Control Model）：一种基于USB的通信设备类（CDC）子类协议，将"TCP/IP over USB"抽象成一条虚拟以太网链路，在主机侧呈现为一块标准的以太网卡。Linux、macOS等操作系统无需额外专用驱动即可使用。

二、演示功能概述

2.1 本教程实现的功能定义

本章节将演示如何使用 780EGH 来开启RNDIS功能。

注意：ECM功能由于缺少测试环境，无法进行完整测试，本文档教程主要演示RNDIS功能。

三、准备硬件环境

因为rndis_ecm功能不受硬件限制，所以本篇教程选用 780EGH 核心板来开发调试。也可以参考：780EGH硬件环境清单，准备好硬件环境。

3.1 780EGH 核心板

四、准备软件环境

4.1 文章内容应用

在开始实践本示例之前，先筹备一下软件环境：

1. 烧录工具：Luatools工具；

2. 内核固件：https://docs.openluat.com/air780egh/luatos/firmware/version/

3. 脚本文件：https://gitee.com/openLuat/LuatOS/tree/master/module/Air780EGH/demo/rndis_ecm

4. LuatOS运行所需要的lib文件：使用Luatools烧录时，勾选添加默认lib 选项，使用默认lib脚本文件。

准备好软件环境之后，接下来查看如何烧录项目文件到780EGH中，将本篇文章中演示使用的项目文件烧录到780EGH核心板中。

4.2 API 介绍

这里仅介绍本篇文档所使用的API，详情请查看：API - mobile

mobile.config(item, value)

网络特殊配置

mobile.flymode(index, enable)

进出飞行模式

五、代码演示

5.1 RNDIS 应用

-- 运行 RNDIS 模式任务
local function rndis_task()
    -- 蜂窝网络模块的usb以太网卡控制，bit0开关：1开0关，bit1模式：1-NAT 0-独立IP(在usb以太网卡开启前可以修改，开启过就不行)，bit2协议：1 ECM,0 RNDIS(设置完毕后需要进出一次飞行模式)
    log.info("我看看 RNDIS 是否启动成功：", mobile.config(mobile.CONF_USB_ETHERNET, 3))
    -- 设置完毕后，需要进出一次飞行模式，才能生效
    log.info("进入飞行模式")
    mobile.flymode(0, true)
    log.info("退出飞行模式")
    mobile.flymode(0, false)
    -- 设置网卡需要开关USB电源将USB协议重置为RNDIS配置
    pm.power(pm.USB ,false)
    pm.power(pm.USB ,true)
end

5.2 ECM 应用

-- 运行 ECM 模式任务
-- 注：由于Windows系统没有测试环境无法测试 ECM 功能，所以本demo没有完整测试。
local function ecm_task()
    -- 调用 mobile.config 函数启用 ECM 功能
    -- 传入的第二个参数 7 ，实际为二进制的 0111
    -- 蜂窝网络模块的usb以太网卡控制，bit0开关：1开0关，bit1模式：1-NAT 0-独立IP(在usb以太网卡开启前可以修改，开启过就不行)，bit2协议：1 ECM,0 ECM(需在飞行模式下设置)
    log.info("我看看 ECM 是否启动成功：", mobile.config(mobile.CONF_USB_ETHERNET, 3))
    -- 设置完毕后，需要进出一次飞行模式，才能生效
    log.info("进入飞行模式")
    mobile.flymode(0, true)
    log.info("退出飞行模式")
    mobile.flymode(0, false)
    -- 设置网卡需要开关USB电源将USB协议重置为ECM配置
    pm.power(pm.USB ,false)
    pm.power(pm.USB ,true)
end