lwip211 BSP Settings 完整中文版总表

lwip211 BSP Settings 完整中文版总表lwip211 BSP Settings 完整中文版总表1顶层参数未分组2arp_options3debug_options4dhcp_options5icmp_options6igmp_options7lwip_ip_options8IPv6 相关9lwip_memory_options10mbox_options11pbuf_options12stats_options13tcp_options14temac_adapter_options15udp_optionslwip211 BSP Settings 完整中文版总表1顶层参数未分组分类参数名类型默认值中文含义说明/建议顶层api_modeenumRAW_APIlwIP 工作模式可选RAW API / Sockets API。裸机一般用RAW_APIRTOS/多任务常用SOCKET_API。顶层lwip_tcp_keepalivebooleanfalse是否启用 TCP Keepalive用于检测 TCP 对端是否失联。需要长连接保活时可开启。顶层no_sys_no_timersbooleantrue在NO_SYS1时关闭sys_timeout支持裸机常见配置。开启后表示在无 OS 模式下不使用系统超时机制。顶层socket_mode_thread_priointeger2Socket 模式线程优先级仅在SOCKET_API模式下有意义。需与系统中其他任务优先级协调。顶层use_axieth_on_zynqinteger1在 Zynq 上使用 AXI Ethernet 适配器设为1表示允许/选择使用 axi ethernet adapter。仅对 Zynq 有效。顶层use_emaclite_on_zynqinteger1在 Zynq 上使用 EmacLite 适配器设为1表示允许/选择使用 emaclite adapter。仅对 Zynq 有效。2arp_options分类参数名类型默认值中文含义说明/建议arp_optionsarp_optionsbooleantrue是否启用 ARP 选项ARP 是 IPv4 以太网通信基础通常保持开启。arp_optionsarp_queueinginteger1ARP 解析期间是否缓存待发送报文为1时在硬件地址解析完成前待发包先排队。一般建议开启。arp_optionsarp_table_sizeinteger10ARP 表项数量缓存 IP-MAC 映射对数量。网络节点较多时可适当增大。3debug_options分类参数名类型默认值中文含义说明/建议debug_optionsdebug_optionsbooleantrue是否启用调试选项分类这是调试配置总开关分类项不等于真正打开所有调试输出。debug_optionsicmp_debugbooleanfalseICMP 协议调试调试 ping、ICMP 报文时可开启。debug_optionsigmp_debugbooleanfalseIGMP 协议调试组播相关问题排查时使用。debug_optionsip_debugbooleanfalseIP 层调试适合排查 IP 收发、分片、路由等问题。debug_optionslwip_debugbooleanfalselwIP 总调试开关一般要先开这个其它分项调试才真正有意义。debug_optionsnetif_debugbooleanfalse网络接口层调试调试网卡驱动、netif 收发流程时很有用。debug_optionspbuf_debugbooleanfalsepbuf 层调试排查缓冲区分配、释放、链式 pbuf 问题。debug_optionssys_debugbooleanfalsesys_arch 层调试RTOS、消息队列、同步抽象层排查时可开。debug_optionstcp_debugbooleanfalseTCP 层调试排查连接、重传、窗口、收发异常时常开。debug_optionsudp_debugbooleanfalseUDP 层调试排查 UDP 发送接收异常时可开。4dhcp_options分类参数名类型默认值中文含义说明/建议dhcp_optionsdhcp_optionsbooleantrue是否显示/启用 DHCP 选项分类分类项。dhcp_optionsdhcp_does_arp_checkbooleanfalseDHCP 获得地址后是否做 ARP 冲突检测开启后会检查 DHCP 分配的地址是否已被占用更安全但过程稍多一步。dhcp_optionslwip_dhcpbooleanfalse是否启用 DHCP自动获取 IP 时必须开启静态 IP 可关闭。5icmp_options分类参数名类型默认值中文含义说明/建议icmp_optionsicmp_optionsbooleantrue是否启用 ICMP 选项一般保持开启ping 等功能依赖它。icmp_optionsicmp_ttlinteger255ICMP 报文 TTL 值一般保持默认即可。6igmp_options分类参数名类型默认值中文含义说明/建议igmp_optionsigmp_optionsbooleanfalse是否启用 IGMP 选项仅在组播/多播应用中需要。普通 TCP/UDP 单播通常关闭。7lwip_ip_options分类参数名类型默认值中文含义说明/建议lwip_ip_optionslwip_ip_optionsbooleantrue是否启用 IP 选项分类分类项。lwip_ip_optionsip_default_ttlinteger255全局默认 TTL供传输层使用的默认 TTL通常保持默认。lwip_ip_optionsip_forwardinteger0是否允许 IP 转发设备作为路由器/网关时才需要置1。普通终端设备保持0。lwip_ip_optionsip_fraginteger1是否对超出 MTU 的发包进行分片发送大于 MTU 的 IP 包时才会用到。普通应用通常默认即可。lwip_ip_optionsip_frag_max_mtuinteger1500IP 分片时假定的最大 MTU常规以太网默认1500。lwip_ip_optionsip_optionsinteger0是否允许带 IP Options 的报文1表示允许但不解析0表示直接丢弃带 IP options 的包。一般保持0。lwip_ip_optionsip_reass_max_pbufsinteger128IP 分片重组可使用的最大 PBUF 数太小可能导致分片重组失败太大则更占内存。lwip_ip_optionsip_reassemblyinteger1是否重组接收的 IP 分片包接收分片 IP 报文时需要。一般保持开启。8IPv6 相关分类参数名类型默认值中文含义说明/建议顶层ipv6_enablebooleanfalse是否启用 IPv6只做 IPv4 项目一般保持关闭可减少资源占用。ipv6_optionsipv6_optionsbooleantrueIPv6 选项分类分类项只有启用 IPv6 时这类配置才真正有意义。9lwip_memory_options分类参数名类型默认值中文含义说明/建议lwip_memory_optionslwip_memory_optionsboolean—lwIP 内存使用控制选项这是内存相关分类下面的参数非常重要。lwip_memory_optionsmem_sizeinteger131072lwIP 堆内存大小字节很关键。连接数多、吞吐大、包缓存多时通常需要增大。lwip_memory_optionsmemp_n_pbufinteger16memp 结构中 pbuf 的个数若应用中大量使用 ROM 数据发送或 pbuf 占用多可增大。lwip_memory_optionsmemp_n_sys_timeoutinteger8同时激活的 timeout 数量DHCP、ARP、TCP 定时器较多时可增大。lwip_memory_optionsmemp_n_tcp_pcbinteger32活动 TCP PCB 数量每个活动 TCP 连接通常占一个 PCB。连接多时要增大。lwip_memory_optionsmemp_n_tcp_pcb_listeninteger8TCP 监听 PCB 数量每个监听服务通常占一个。服务器监听端口较多时增大。lwip_memory_optionsmemp_n_tcp_seginteger256同时排队的 TCP 段数量对吞吐很重要。高带宽、大发送场景建议增大。lwip_memory_optionsmemp_n_udp_pcbinteger4活动 UDP PCB 数量每个活跃 UDP 端点/连接通常占一个。lwip_memory_optionsmemp_num_api_msginteger16API message 结构数量主要用于 socket mode。socket 多时可适当增加。lwip_memory_optionsmemp_num_netbufinteger8netbuf 结构数量主要用于 socket mode。lwip_memory_optionsmemp_num_netconninteger16netconn 结构数量主要用于 socket mode。socket/连接数较多时需调整。lwip_memory_optionsmemp_num_tcpip_msginteger64tcpip message 结构数量主要用于 socket mode多线程消息传递不足时可增大。注lwip_memory_options这一组是最容易影响“跑起来但不稳定/吞吐不够/连接数不够”的核心区域。10mbox_options分类参数名类型默认值中文含义说明/建议mbox_optionsmbox_optionsbooleantrueMbox 选项分类主要对 socket/netconn/RTOS 模式有意义。mbox_optionsdefault_tcp_recvmbox_sizeinteger200TCP 接收邮箱队列大小TCP 接收队列深度。socket 模式下较重要。mbox_optionsdefault_udp_recvmbox_sizeinteger100UDP 接收邮箱队列大小UDP 接收队列深度。mbox_optionslwip_tcpip_core_locking_inputbooleanfalse是否启用 TCPIP 输入核心锁多线程同步优化选项特定 RTOS 场景才会调整。mbox_optionstcpip_mbox_sizeinteger200TCPIP 核心邮箱队列大小socket/netconn 模式很重要。队列太小可能造成消息堆积或丢失。11pbuf_options分类参数名类型默认值中文含义说明/建议pbuf_optionspbuf_optionsbooleantruePbuf 选项分类pbuf 是 lwIP 的基础包缓存机制。pbuf_optionspbuf_link_hleninteger16链路层头部预留长度一般保持默认。pbuf_optionspbuf_pool_bufsizeinteger1700pbuf pool 中每个 buffer 的大小需要能容纳典型以太网帧。pbuf_optionspbuf_pool_sizeinteger256pbuf pool 中 buffer 数量流量大、突发收包多时可适当增大。12stats_options分类参数名类型默认值中文含义说明/建议stats_optionsstats_optionsbooleantrue统计信息选项分类分类项。stats_optionslwip_statsbooleanfalse是否启用 lwIP 统计功能调试阶段有用量产可关闭以减少开销。13tcp_options分类参数名类型默认值中文含义说明/建议tcp_optionstcp_optionsbooleantrueTCP 选项分类分类项。tcp_optionslwip_tcpbooleantrue是否启用 TCP只要有 TCP 通信就必须开启。tcp_optionstcp_maxrtxinteger12TCP 最大重传次数数据段最大重传次数。网络环境差时相关。tcp_optionstcp_mssinteger1460TCP 最大报文段长度对应标准 1500 MTU 的常见值。一般不要随意改小/改大。tcp_optionstcp_queue_ooseqinteger1是否缓存乱序到达的 TCP 段设为0可省内存但抗乱序能力下降。内存紧张时可考虑关闭。tcp_optionstcp_snd_bufinteger8192TCP 发送缓冲区大小字节影响持续发送能力和吞吐。高吞吐应用常增大。tcp_optionstcp_synmaxrtxinteger4TCP SYN 最大重传次数建立连接阶段重传上限。tcp_optionstcp_ttlinteger255TCP TTL 值一般保持默认。tcp_optionstcp_wndinteger2048TCP 接收窗口大小字节影响接收吞吐能力。高吞吐应用通常增大。14temac_adapter_options分类参数名类型默认值中文含义说明/建议temac_adapter_optionstemac_adapter_optionsbooleantruexps-ll-temac / Axi-Ethernet / GEM 适配器设置网卡驱动适配层配置。temac_adapter_optionsemac_numberinteger0Zynq 以太网接口号通常对应 GEM0/GEM1 之类的接口编号。temac_adapter_optionsn_rx_coalesceinteger1RX 中断合并参数仅对 Axi-Ethernet/xps-ll-temac 适用。可降低中断频率。temac_adapter_optionsn_rx_descriptorsinteger64RX Buffer Descriptor 数量SDMA 模式下接收描述符数量。temac_adapter_optionsn_tx_coalesceinteger1TX 中断合并参数仅对 Axi-Ethernet/xps-ll-temac 适用。temac_adapter_optionsn_tx_descriptorsinteger64TX Buffer Descriptor 数量SDMA 模式下发送描述符数量。temac_adapter_optionsphy_link_speedenumCONFIG_LINKSPEED_AUTODETECTPHY 协商链路速率一般建议自动检测。特殊固定速率场景才手动指定。temac_adapter_optionstcp_ip_rx_checksum_offloadbooleanfalseTCP/IP 接收校验和硬件卸载需要硬件支持。启用后可降低 CPU 负担。temac_adapter_optionstcp_ip_tx_checksum_offloadbooleanfalseTCP/IP 发送校验和硬件卸载需要硬件支持。temac_adapter_optionstcp_rx_checksum_offloadbooleanfalseTCP 接收校验和硬件卸载需要 MAC/硬件支持。temac_adapter_optionstcp_tx_checksum_offloadbooleanfalseTCP 发送校验和硬件卸载需要 MAC/硬件支持。temac_adapter_optionstemac_use_jumbo_framesbooleanfalse是否启用 Jumbo Frame大帧场景才开启同时 MTU、驱动、交换机都要匹配。15udp_options分类参数名类型默认值中文含义说明/建议udp_optionsudp_optionsbooleantrueUDP 选项分类分类项。udp_optionslwip_udpbooleantrue是否启用 UDP如果项目完全不用 UDP 可关闭但 DHCP 依赖 UDP。udp_optionsudp_ttlinteger255UDP TTL 值一般保持默认即可。udp_optionsudp_tx_blockingbooleanfalse应用发送 UDP 时是否阻塞直到真正发出一般保持false。特殊同步发送场景才考虑开启。