Air8000多网通信- RNDIS/ECM

一、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 等操作系统无需额外专用驱动即可使用。

注意：合宙模组全系不支持Android

二、演示功能概述

2.1 本教程实现的功能定义

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

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

三、准备硬件环境

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

3.1 Air8000 核心板

四、准备软件环境

4.1 文章内容应用

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

烧录工具：Luatools 工具；
本demo开发测试时使用的固件为LuatOS-SoC_V2012_Air8000_1.soc，本demo对固件版本没有什么特殊要求，所以你如果要测试本demo时，可以直接使用最新版本的内核固件；如果发现最新版本的内核固件测试有问题，可以使用我们开发本demo时使用的内核固件版本来对比测试；
脚本文件：https://gitee.com/openLuat/LuatOS/tree/master/module/Air8000/demo/rndis_ecm
LuatOS 运行所需要的 lib 文件：使用 Luatools 烧录时，勾选添加默认 lib 选项，使用默认 lib 脚本文件。

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

4.2 API 介绍

这里仅介绍本篇文档所使用的 API，详情请查看：API 索引 - luatos@air8000 - 合宙模组资料中心

mobile.config(item, value)

网络特殊配置

mobile.flymode(index, enable)

进出飞行模式

五、代码演示

5.1 RNDIS 应用

lua 复制代码

-- 运行 RNDIS 模式任务
local function rndis_task()
    -- 初始化重试计数器，用于记录进入飞行模式失败的重试次数
    local count = 0
    -- 尝试进入飞行模式，获取操作结果标志
    local fly_sign = mobile.flymode(0, true)
    -- 判断是否成功进入飞行模式
    if fly_sign then
        log.info("进入飞行模式成功,打开RNDIS模式")
        -- 调用 mobile.config 函数启用 RNDIS 功能
        -- 传入的第二个参数 3 ，实际为二进制的 0011
        -- 蜂窝网络模块的usb以太网卡控制，bit0开关，1开0关，bit1模式，1NAT0独立IP(在usb以太网卡开启前可以修改，开启过就不行)，bit2协议1 ECM,0 RNDIS，飞行模式里设置。
        log.info("我看看 RNDIS 是否启动成功：", mobile.config(mobile.CONF_USB_ETHERNET, 3))
        log.info("退出飞行模式")
        mobile.flymode(0, false)
    else
        log.info("进入飞行模式失败")
    end
end

5.2 ECM 应用

lua 复制代码

-- 运行 ECM 模式任务
-- 注：由于Windows系统没有测试环境无法测试 ECM 功能，所以本demo没有完整测试。
local function ecm_task()
    -- 初始化重试计数器，用于记录进入飞行模式失败的重试次数
    local count = 0
    -- 尝试进入飞行模式，获取操作结果标志
    local fly_sign = mobile.flymode(0, true)
    -- 判断是否成功进入飞行模式
    if fly_sign then
        log.info("进入飞行模式成功,打开ECM模式")
        -- 调用 mobile.config 函数启用 ECM 功能
        -- 传入的第二个参数 7 ，实际为二进制的 0111
        -- 蜂窝网络模块的usb以太网卡控制，bit0开关，1开0关，bit1模式，1NAT0独立IP(在usb以太网卡开启前可以修改，开启过就不行)，bit2协议1 ECM,0 RNDIS，飞行模式里设置。
        log.info("我看看 ECM 是否启动成功：", mobile.config(mobile.CONF_USB_ETHERNET, 7))
        log.info("退出飞行模式")
        mobile.flymode(0, false)
    else
        log.info("进入飞行模式失败")
    end
end