Files
STM32F4-Base/Drivers/BSP/NET/net_select.c
T
wandering1 925058a5ae fix(NET)+docs: lftpd 对端地址修复、E6 裁决收口、陷阱编号迁移重排 TRAP-NET-01~21
- lftpd:net_inet_ntoa 段序改 MSB 首 + 新增 net_getpeername,FTP 日志打印
  真实对端地址(真机实证 192.168.1.2:55524,登记 TRAP-NET-21)
- E6:NET_U15_PROBE 命中=0(含压测)→ 阶段 3 项 4 不立项,U15 登记观察项;
  插桩留仓(宏=0 零成本),soak 驱动 test/host/e6_soak.py 入库
- 编号:全库 Trap NN → TRAP-NET-<nn> 迁移并重排连续 01~21(单调映射,
  沿革见 CH395F_Trap_Records.md 头注);死号 12/13/19/21 引用全部清除;
  GD5F 域引用补正为 TRAP-GD5F-NN
- 陷阱文档全新化:索引 21 行行行真陷阱;删误判存档/发现时间/git 考古/
  FTP 附录;台架纪律教训沉淀第六章方法论
- RAM:Code 211348→211456(+108 lftpd 修复),RW+ZI 净增 +4B;
  优化方案/台账受管区/tsv 同笔同步
- ftp_abort_probe.py 挪 test/host/;引用关系图重生成
- 回归:@build 0/0;@test PASS;ftp_abort 10/10;relisten :7003 20/20;
  ci_local L0+L0.5 全绿;E6 窗口零复位,7 条 WD stall 登记压测假象备查
2026-10-13 20:54:31 +08:00

326 lines
11 KiB
C
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/*
* 模块名称:Network Select Implementation
* 模块功能:I/O 多路复用实现,包括 select 和 poll 两种模式,用于同时监控多个 Socket 的读写事件
* 适用平台:STM32F407ZGTx + CH395F 以太网芯片
* 作者:王建锋
* 创建日期:2026-07-18
* 修改记录:
* 2026-07-18 王建锋 创建初始版本
*/
#include <string.h>
#include <stdio.h>
#include "cmsis_os.h" /* CMSIS-RTOS2 API: osDelay() */
#include "FreeRTOS.h"
#include "task.h"
#include "net_select.h"
#include "net_socket.h"
#include "ch395f.h"
#include "main.h"
/*
* 私有函数声明区
*/
static int check_socket_readable(int sockfd);
static int check_socket_writable(int sockfd);
static int check_socket_error(int sockfd);
/*
* 公共函数实现区
*/
/*
* 函数功能:I/O 多路复用(select 模式),等待多个 Socket 的读写事件就绪
* 入口参数:nfds - 最大文件描述符数 +1 int > 0
* readfds - 读事件集合指针 net_fd_set_t *(可为 NULL)
* writefds - 写事件集合指针 net_fd_set_t *(可为 NULL)
* exceptfds- 异常事件集合指针 net_fd_set_t *(可为 NULL)
* timeout - 超时时间结构体指针 net_timeval_t *(NULL=无限等待)
* 出口参数:readfds/writefds/exceptfds - 仅保留就绪的 Socket 位 net_fd_set_t *
* 返回值:就绪的 Socket 数量(>= 0);-1 表示参数无效 int
* 限定条件:net_init() + MX_FREERTOS_Init() 已执行;可在任意任务上下文调用
* 函数说明:1. 轮询 Socket 控制块(RAM)中的读/写/异常状态,判断事件是否就绪
* 2. 不在此直接访问 CH395F SPI——所有 ch395f 事务统一由 netTask 的 net_poll()
* 每 10ms 串行执行并刷新控制块状态(send_ready / readable),本函数仅做
* RAM 读取,避免与应用任务发起的 SPI 访问竞争(见 TRAP-NET-14)
* 3. 阻塞等待直到有事件就绪或超时
* 4. 通过 osDelay(1) 让出 CPU,平衡实时性与 CPU 利用率(状态刷新延迟 <=10ms)
*/
int net_select(int nfds, net_fd_set_t *readfds, net_fd_set_t *writefds,
net_fd_set_t *exceptfds, net_timeval_t *timeout) {
uint32_t start_tick;
uint32_t timeout_ms = 0;
net_fd_set_t result_read = {0};
net_fd_set_t result_write = {0};
net_fd_set_t result_except = {0};
int ready_count = 0;
int i;
/* 检查输入参数合法性 */
if ((nfds <= 0) || (nfds > NET_MAX_SOCKETS)) {
return -1;
}
/* 计算超时时间(毫秒) */
if (timeout != NULL) {
timeout_ms = (uint32_t)(timeout->tv_sec * 1000) +
(uint32_t)(timeout->tv_usec / 1000);
}
start_tick = HAL_GetTick();
while (1) {
/* 仅读取 netTask 的 net_poll() 已刷新的控制块状态(无 CH395F SPI 访问) */
ready_count = 0;
/* 检查哪个 Socket 有事件 */
for (i = 0; i < nfds && i < NET_MAX_SOCKETS; i++) {
const net_sock_t *p_sock = net_get_sock(i);
if (p_sock == NULL) {
continue;
}
/* 检查可读事件 */
if ((readfds != NULL) && NET_FD_ISSET(i, readfds)) {
if (check_socket_readable(i)) {
NET_FD_SET(i, &result_read);
ready_count++;
}
}
/* 检查可写事件 */
if ((writefds != NULL) && NET_FD_ISSET(i, writefds)) {
if (check_socket_writable(i)) {
NET_FD_SET(i, &result_write);
ready_count++;
}
}
/* 检查异常事件 */
if ((exceptfds != NULL) && NET_FD_ISSET(i, exceptfds)) {
if (check_socket_error(i)) {
NET_FD_SET(i, &result_except);
ready_count++;
}
}
}
/* 有事件就绪,返回 */
if (ready_count > 0) {
break;
}
/* 超时检测 */
if (timeout != NULL) {
if ((timeout_ms > 0) &&
((HAL_GetTick() - start_tick) >= timeout_ms)) {
break; /* 超时返回 0 */
}
}
/* 让出 CPU:FreeRTOS osDelay() 会正确进入休眠,允许其他任务运行 */
osDelay(1); /* 1ms 周期轮询,平衡实时性和 CPU 利用率 */
}
/* 复制结果集合 */
if (readfds != NULL) {
readfds->fd_bits = result_read.fd_bits;
}
if (writefds != NULL) {
writefds->fd_bits = result_write.fd_bits;
}
if (exceptfds != NULL) {
exceptfds->fd_bits = result_except.fd_bits;
}
return ready_count;
}
/*
* 函数功能:I/O 多路复用(poll 模式),等待多个 Socket 的读写事件就绪
* 入口参数:fds - pollfd 数组指针 net_pollfd_t *
* nfds - 数组元素数量 int > 0
* timeout - 超时时间(毫秒) int >= 0(-1=无限等待,但本实现按 >=0 处理)
* 出口参数:fds[i].revents - 填充实际发生的事件掩码 short
* 返回值:就绪的 fd 数量(>= 0);-1 表示参数无效 int
* 限定条件:net_init() + MX_FREERTOS_Init() 已执行;可在任意任务上下文调用
* 函数说明:1. 轮询 Socket 控制块(RAM)中的读/写/错误/挂起状态,判断事件是否就绪
* 2. 不在此直接访问 CH395F SPI——状态由 netTask 的 net_poll() 每 10ms 刷新
* 3. 阻塞等待直到有事件就绪或超时
* 4. 通过 osDelay(1) 让出 CPU,平衡实时性与 CPU 利用率(状态刷新延迟 <=10ms)
*/
int net_poll_events(net_pollfd_t *fds, int nfds, int timeout) {
uint32_t start_tick;
int ready = 0;
int i;
if ((fds == NULL) || (nfds <= 0)) {
return -1;
}
start_tick = HAL_GetTick();
while (1) {
/* 仅读取 netTask 的 net_poll() 已刷新的控制块状态(无 CH395F SPI 访问) */
ready = 0;
for (i = 0; i < nfds; i++) {
fds[i].revents = 0;
/* 检查 fd 有效性 */
if ((fds[i].fd < 0) || (fds[i].fd >= NET_MAX_SOCKETS)) {
fds[i].revents |= NET_POLLNVAL;
ready++;
continue;
}
const net_sock_t *p_sock = net_get_sock(fds[i].fd);
if (p_sock == NULL) {
fds[i].revents |= NET_POLLNVAL;
ready++;
continue;
}
/* 检查可读 */
if (fds[i].events & NET_POLLIN) {
if (check_socket_readable(fds[i].fd)) {
fds[i].revents |= NET_POLLIN;
ready++;
}
}
/* 检查可写 */
if (fds[i].events & NET_POLLOUT) {
if (check_socket_writable(fds[i].fd)) {
fds[i].revents |= NET_POLLOUT;
ready++;
}
}
/* 检查错误 */
if (check_socket_error(fds[i].fd)) {
fds[i].revents |= NET_POLLERR;
ready++;
}
/* 检查挂起(连接断开) */
if (NET_SOCK_STATE_CLOSED == p_sock->state) {
fds[i].revents |= NET_POLLHUP;
ready++;
}
}
if (ready > 0) {
break;
}
/* 超时检测 */
if (timeout >= 0) {
if ((HAL_GetTick() - start_tick) >= (uint32_t)timeout) {
break;
}
}
/* 让出 CPU:FreeRTOS osDelay() 会正确进入休眠,允许其他任务运行 */
osDelay(1); /* 1ms 周期轮询,平衡实时性和 CPU 利用率 */
}
return ready;
}
/*
* 私有函数实现区
*/
/*
* 函数功能:检查指定 Socket 当前是否可读
* 入口参数:sockfd - 待检查的 Socket 描述符 int 0 - NET_MAX_SOCKETS-1
* 出口参数:无
* 返回值:1 - 可读(接收缓冲非空);0 - 不可读或描述符无效 int
* 限定条件:net_init() 已调用
* 函数说明:1. P2-7(2026-10-04):LISTENING 态**不再**恒判可读。本网络层无
* "待 accept 的挂起连接队列"——新连接到达时 CONNECT 事件把该 socket
* 自身直接转为 ESTABLISHED(handle_connect_event:"监听自身转数据通道"),
* 故监听态恒无数据可读。原实现对 LISTENING 恒返回 1,会使
* select()/poll() 在监听 socket 上永久立即就绪(忙轮询地雷;当前无
* 调用方,属潜在地雷)。连接到达经 NET_EVENT_CONNECTED 回调通知。
* 2. 其余态:readable 由 net_poll 在 RECV_OK 时置位、net_recv_locked
* 读空后清零。避免应用任务直接访问 CH395F SPI(见 TRAP-NET-14)
*/
static int check_socket_readable(int sockfd) {
const net_sock_t *p_sock;
p_sock = net_get_sock(sockfd);
if (p_sock == NULL) {
return 0;
}
/* 监听态恒不可读(见上方 P2-7 说明) */
if (NET_SOCK_STATE_LISTENING == p_sock->state) {
return 0;
}
/* 有数据可读 */
if (p_sock->readable) {
return 1;
}
return 0;
}
/*
* 函数功能:检查指定 Socket 当前是否可写
* 入口参数:sockfd - 待检查的 Socket 描述符 int 0 - NET_MAX_SOCKETS-1
* 出口参数:无
* 返回值:1 - 可写(已连接且发送缓冲空闲);0 - 不可写或描述符无效 int
* 限定条件:net_init() 已调用
* 函数说明:1. 仅已建立连接且 send_ready 标志置位的 Socket 视为可写
*/
static int check_socket_writable(int sockfd) {
const net_sock_t *p_sock;
p_sock = net_get_sock(sockfd);
if (p_sock == NULL) {
return 0;
}
/* 已建立连接的 Socket 发送缓冲区空闲时可写 */
if (NET_SOCK_STATE_ESTABLISHED == p_sock->state) {
if (p_sock->send_ready) {
return 1;
}
}
return 0;
}
/*
* 函数功能:检查指定 Socket 是否存在错误状态
* 入口参数:sockfd - 待检查的 Socket 描述符 int 0 - NET_MAX_SOCKETS-1
* 出口参数:无
* 返回值:1 - 有错误(含描述符越界或 Socket 未分配);0 - 无错误 int
* 限定条件:无
* 函数说明:1. 描述符越界视为错误
* 2. 未分配(net_get_sock 返回 NULL)的 Socket 视为错误
*/
static int check_socket_error(int sockfd) {
const net_sock_t *p_sock;
/* 无效 fd 视为错误 */
if ((sockfd < 0) || (sockfd >= NET_MAX_SOCKETS)) {
return 1;
}
p_sock = net_get_sock(sockfd);
if (p_sock == NULL) {
return 1; /* 未使用的 Socket 视为错误 */
}
return 0;
}