7.2.6 Kconfig 配置指南

📚 本节导读

学习时长：约 10 分钟
难度级别：⭐⭐☆☆☆
前置知识：menuconfig 基本操作、第 2 章项目结构与构建系统

🎯 学习目标

• 掌握网络协议栈各组件的 Kconfig 配置宏
• 了解不同应用场景的典型配置组合
• 能够根据项目需求正确配置网络组件

---

一、网络基础配置

在 OneOS 项目根目录执行 menuconfig，进入 Components -> Net 菜单：

配置宏	说明
OS_USING_NET	启用网络组件（总开关）
NET_USING_BSD	启用 BSD Socket API
NET_USING_LWIP	启用 LWIP 协议栈
NET_USING_IPV4	启用 IPv4 支持
NET_USING_TCP	启用 TCP 协议
NET_USING_UDP	启用 UDP 协议
NET_USING_DHCP	启用 DHCP 客户端
NET_USING_DNS	启用 DNS 域名解析

二、应用协议配置

配置宏	说明
NET_USING_HTTP_CLIENT	启用 HTTP 客户端
NET_USING_MQTT	启用 MQTT 客户端
NET_USING_PAHO_MQTT	选择 Paho MQTT 实现
NET_USING_MINI_MQTT	选择 Mini MQTT 实现
NET_USING_COAP	启用 CoAP 协议
NET_USING_LIBCOAP	选择 libcoap 实现
NET_USING_FREECOAP	选择 freecoap 实现
NET_USING_LWM2M	启用 LwM2M 协议
NET_USING_WEBSOCKET	启用 WebSocket

三、Molink 配置

配置宏	说明
MOLINK_USING_GENERAL_OPS	启用通用模组操作
MOLINK_USING_ONENET_NB_OPS	启用 OneNET NB-IoT 专用操作

四、典型配置场景

场景一：以太网 + MQTT 通信设备

[*] Enable network component
    [*] Enable BSD Socket
    [*] Enable LWIP
        [*] Enable IPv4
        [*] Enable TCP
        [*] Enable DHCP client
        [*] Enable DNS
    [*] Enable MQTT
        [*] Enable Paho MQTT

场景二：NB-IoT 模组 + CoAP 通信设备

[*] Enable network component
    [*] Enable BSD Socket
    [*] Enable LWIP
        [*] Enable IPv4
        [*] Enable UDP
    [*] Enable CoAP
        [*] Enable libcoap
    [*] Molink
        [*] Enable general operations

场景三：WiFi 模组 + HTTP 通信设备

[*] Enable network component
    [*] Enable BSD Socket
    [*] Enable LWIP
        [*] Enable IPv4
        [*] Enable TCP
        [*] Enable DNS
    [*] Enable HTTP Client
    [*] Molink
        [*] Enable general operations

---

📝 本节小结

本节介绍了 OneOS 网络协议栈的 Kconfig 配置方法。通过 menuconfig 可以灵活配置网络组件，包括 LWIP 协议栈、Socket 接口、各类应用协议以及 Molink 模组支持。

核心要点回顾：

1. OS_USING_NET 是网络组件的总开关
2. 根据通信协议选择对应的应用协议配置宏（MQTT / CoAP / HTTP）
3. 使用蜂窝模组时需要启用 Molink 相关配置
4. 三种典型场景覆盖了大多数物联网设备的网络需求

🔗 相关链接

• 7.2.5 Molink 蜂窝模组抽象层
• 7.2.7 协议选择指南
• 7.2 网络协议栈（总览）
• 第7章 README