基于EDK2的UEFI应用非UDP网络通信实现方案咨询

测试环境适配结论 #

UEFI 2.5版本虚拟机完全满足开发测试要求，属于该场景下的标准测试方案。

• 优先选择QEMU搭配对应版本OVMF固件，该固件默认编译集成SNP、MNP、TCP4完整网络协议栈，不需要额外移植驱动；VMware Workstation自带的UEFI固件也可使用，注意避开部分裁剪了网络协议的精简定制版固件即可。
• 环境校验方式：进入UEFI Shell后执行ifconfig -l，能看到网卡实例、且网卡能正常获取IP地址即代表网络栈初始化正常，可直接用于测试。
• 初期开发不建议直接用物理机测试，虚拟机可开启UEFI debug日志输出，网络栈报错可直接从串口抓取，排查效率远高于物理机。

技术选型结论 #

该极简场景直接选用EDK2原生EFI TCP4 Protocol即可，是代码量最少、兼容性最高的方案，完全满足禁用UDP、仅收发固定IP报文的需求：

• 不需要引入HTTP、TLS等上层协议，省去协议封装、解析的冗余逻辑
• 不需要手动处理以太网帧、IP头、ARP、重传等底层逻辑，原生TCP栈会自动完成上述处理
• 不建议选用TCP6 Protocol，UEFI 2.5版本对TCP6的支持存在多处已知兼容性bug，固定IPv4场景下TCP4稳定性最高。

最小实现流程 #

1. 协议获取
   应用入口处先通过LocateHandleBuffer枚举所有带SNP（Simple Network Protocol）的网卡句柄，在对应网卡句柄上通过LocateProtocol获取EFI_TCP4_PROTOCOL实例。如果固件已经通过DHCP给网卡分配了IP可直接使用，未分配IP则调用EFI_TCP4_PROTOCOL->Configure()手动配置静态IP、子网掩码即可，同网段通信不需要配置网关。
2. 连接建立
   填充EFI_TCP4_CONFIG_DATA结构体：本地端口选1024以上未占用端口（比如50000），远端地址填入已知的服务器IPv4（注意转网络字节序），远端端口填入服务器TCP监听端口。调用EFI_TCP4_PROTOCOL->Connect()发起TCP连接，接口阻塞返回EFI_SUCCESS即代表三次握手完成。
3. 报文发送
   申请长度为5字节的发送缓冲区，写入"Hello"字符串，调用EFI_TCP4_PROTOCOL->Transmit()传入缓冲区和长度即可，不需要添加任何额外协议头。
4. 报文接收
   申请5字节的接收缓冲区，调用EFI_TCP4_PROTOCOL->Receive()阻塞等待响应，接口返回成功后直接通过Print()将缓冲区内容打印到控制台即可。
5. 资源释放
   通信完成后调用EFI_TCP4_PROTOCOL->Close()关闭连接，释放之前申请的缓冲区内存即可。

常见踩坑说明 #

• 所有IP地址、端口字段传入TCP4接口前必须转成大端（网络序），直接填主机序会导致连接失败，是该场景下最高发的问题。
• 不要使用EDK2高层封装的TcpIo类接口，该封装在UEFI 2.5环境下存在内存泄漏、事件回调异常的bug，直接调用原生TCP4 Protocol接口稳定性最高。
• 如果LocateProtocol找不到TCP4实例，在启动应用前先在UEFI Shell执行load tcp4.efi手动加载TCP驱动即可，绝大多数OVMF固件内置了该驱动文件，不需要额外获取。
• 服务器端测试可直接用nc工具开TCP监听，提前确认虚拟机和服务器网络二层连通，UEFI环境默认无防火墙策略，不需要额外放通端口。

内容的提问来源于stack exchange，提问作者xiu-wolong8