4G(LTE)

FAQ1 Solution 是否支持 Cat1 模块?NT26K 如何接入?

支持。Solution 中 4G 能力按第三方 Cat1/4G modem 模块进行集成,NT26K 可作为 Cat1 模块接入。当前仓库中已经预留 4G modem 总开关,并提供了 onchip LTE modem 示例实现,客户接入 NT26K 时需要根据项目硬件连接和模组资料完成接口、供电、复位、唤醒、AT 初始化和网络接口适配。

建议按以下顺序检查:

  1. 打开 4G modem 总开关:在目标工程的 menuconfig 中打开 USING_MODEM_SUPPORT。该开关位于 solution/components/Kconfig,会自动选择 BSP_USING_MODEM

  2. 选择或适配 modem 外设实现:仓库中现有 onchip modem 示例由 PERI_USING_ONCHIP 控制,代码位于 sdk/customer/peripherals/modem/onchip。如果 NT26K 与现有示例的硬件接口、AT 命令或网络数据通道不同,需要在该目录下新增或修改对应适配层。

  3. 确认硬件接口参数:现有示例使用 uart2,默认波特率为 3000000,并配置了 TX/RX、MRDY、SRDY 引脚。NT26K 接入时需按原理图和模组手册确认 UART、流控、PWRKEY、RESET、WAKEUP 等引脚,不要直接沿用示例引脚。

  4. 适配 AT 初始化流程:现有示例在 lte_phone_api.c 中通过 ATE0AT+CEREG?AT+ECNETDEVCTL 等命令完成回显关闭、注网查询和网络设备绑定。NT26K 如使用不同 AT 命令,应替换初始化命令表、预期返回值和 URC 解析。

  5. 确认网络数据通道:现有示例将 LTE 网络注册为 lwIP 以太网类网络接口,并通过 lte_lwip_event_handle(event_id) 启停,例如初始化时传入 RT_LTE_PROT_EVT_INIT,反初始化时传入 RT_LTE_PROT_EVT_DEINIT。若 NT26K 使用 PPP/PPPoS over UART,则需要同时打开 lwIP 的 RT_LWIP_PPPRT_LWIP_PPPOS,并实现 PPPoS 串口收发回调;若 NT26K 提供类以太网/NAT 数据通道,则按对应通道适配 netdev/lwIP 接口。

  6. 验证注网和默认网络:固件启动后先确认 AT 通讯正常,再确认 SIM 卡、天线、运营商注册和 IP 获取。现有示例可通过 lte finsh 命令触发 init/deinit/status,并将 lt 网络设备设置为默认网络。

FAQ2 接入 NT26K 时,哪些配置项最容易漏?

常见漏项如下:

  • USING_MODEM_SUPPORT:Solution 侧 4G modem 总开关。

  • BSP_USING_MODEM:由 USING_MODEM_SUPPORT 自动选择,用于打开板级 modem 支持。

  • PERI_USING_ONCHIP:当前 onchip modem 示例的编译开关;如果 NT26K 使用独立目录或独立 Kconfig,应改为对应的模块开关。

  • RT_USING_LWIP:使用 TCP/IP 网络能力时必须打开。

  • RT_LWIP_PPP / RT_LWIP_PPPOS:仅当 NT26K 采用 PPP/PPPoS 方式入网时需要打开。

  • UART 与 GPIO:需要在板级 pinmux 中确认 UART TX/RX、流控、复位、开关机、唤醒等引脚配置。

FAQ3 现有 4G 示例代码在哪里?能直接用于 NT26K 吗?

现有示例主要在 sdk/customer/peripherals/modem/onchip 下:

  • sfdt_master.c:UART/SFDT 收发任务、AT/ETH 队列和 finsh 调试命令。

  • sfdt.h:示例 UART、引脚、帧格式和波特率定义。

  • lte_phone_api.c:AT 初始化、注网状态、VoLTE 电话相关命令和 URC 处理。

  • lwip/lte_lwip.clwip/lte_ethernetif.c:LTE 网络接入 lwIP/netdev 的示例。

这些代码可作为 4G modem 接入参考,但不能假定可直接驱动 NT26K。NT26K 接入前应先对照模组手册确认:

  1. AT 命令是否兼容;

  2. 数据通道是 PPP/PPPoS、类以太网/NAT,还是厂商私有协议;

  3. UART 波特率、硬件流控和唤醒时序是否一致;

  4. 注网、拨号、IP 获取和断线重连的 URC 格式是否一致。

如果上述任一项不一致,应新增 NT26K 专用适配文件,避免直接修改通用示例导致其他 4G 模块行为变化。