wandering1
07afb7b468
.pre-commit-config.yaml: 移除 --suppress=constVariablePointer net_select.c: 5 处 p_sock 改 const net_sock_t *（仅只读使用） net_socket.c: net_getsockname 的 p_sock 改 const（只读字段） docs/代码规范/cppcheck使用说明.md: 同步抑制表与处理记录
321 lines
11 KiB
C
321 lines
11 KiB
C
/*
|
||
* 模块名称：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 *（可为 NULL）
|
||
* writefds - 写事件集合指针 net_fd_set *（可为 NULL）
|
||
* exceptfds- 异常事件集合指针 net_fd_set *（可为 NULL）
|
||
* timeout - 超时时间结构体指针 net_timeval *（NULL=无限等待）
|
||
* 出口参数：readfds/writefds/exceptfds - 仅保留就绪的 Socket 位 net_fd_set *
|
||
* 返回值：就绪的 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 16）
|
||
* 3. 阻塞等待直到有事件就绪或超时
|
||
* 4. 通过 osDelay(1) 让出 CPU，平衡实时性与 CPU 利用率（状态刷新延迟 <=10ms）
|
||
*/
|
||
int net_select(int nfds, net_fd_set *readfds, net_fd_set *writefds,
|
||
net_fd_set *exceptfds, net_timeval *timeout) {
|
||
uint32_t start_tick;
|
||
uint32_t timeout_ms = 0;
|
||
net_fd_set result_read = {0};
|
||
net_fd_set result_write = {0};
|
||
net_fd_set result_except = {0};
|
||
int ready_count = 0;
|
||
int i;
|
||
|
||
/* 检查输入参数合法性 */
|
||
if ((0 >= nfds) || (NET_MAX_SOCKETS < nfds)) {
|
||
return -1;
|
||
}
|
||
|
||
/* 计算超时时间（毫秒） */
|
||
if (NULL != timeout) {
|
||
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 (NULL == p_sock) {
|
||
continue;
|
||
}
|
||
|
||
/* 检查可读事件 */
|
||
if ((NULL != readfds) && NET_FD_ISSET(i, readfds)) {
|
||
if (check_socket_readable(i)) {
|
||
NET_FD_SET(i, &result_read);
|
||
ready_count++;
|
||
}
|
||
}
|
||
|
||
/* 检查可写事件 */
|
||
if ((NULL != writefds) && NET_FD_ISSET(i, writefds)) {
|
||
if (check_socket_writable(i)) {
|
||
NET_FD_SET(i, &result_write);
|
||
ready_count++;
|
||
}
|
||
}
|
||
|
||
/* 检查异常事件 */
|
||
if ((NULL != exceptfds) && NET_FD_ISSET(i, exceptfds)) {
|
||
if (check_socket_error(i)) {
|
||
NET_FD_SET(i, &result_except);
|
||
ready_count++;
|
||
}
|
||
}
|
||
}
|
||
|
||
/* 有事件就绪，返回 */
|
||
if (0 < ready_count) {
|
||
break;
|
||
}
|
||
|
||
/* 超时检测 */
|
||
if (NULL != timeout) {
|
||
if ((0 < timeout_ms) &&
|
||
((HAL_GetTick() - start_tick) >= timeout_ms)) {
|
||
break; /* 超时返回 0 */
|
||
}
|
||
}
|
||
|
||
/* 让出 CPU：FreeRTOS osDelay() 会正确进入休眠，允许其他任务运行 */
|
||
osDelay(1); /* 1ms 周期轮询，平衡实时性和 CPU 利用率 */
|
||
}
|
||
|
||
/* 复制结果集合 */
|
||
if (NULL != readfds) {
|
||
readfds->fd_bits = result_read.fd_bits;
|
||
}
|
||
if (NULL != writefds) {
|
||
writefds->fd_bits = result_write.fd_bits;
|
||
}
|
||
if (NULL != exceptfds) {
|
||
exceptfds->fd_bits = result_except.fd_bits;
|
||
}
|
||
|
||
return ready_count;
|
||
}
|
||
|
||
/*
|
||
* 函数功能：I/O 多路复用（poll 模式），等待多个 Socket 的读写事件就绪
|
||
* 入口参数：fds - pollfd 数组指针 net_pollfd *
|
||
* 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 *fds, int nfds, int timeout) {
|
||
uint32_t start_tick;
|
||
int ready = 0;
|
||
int i;
|
||
|
||
if ((NULL == fds) || (0 >= nfds)) {
|
||
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 ((0 > fds[i].fd) || (NET_MAX_SOCKETS <= fds[i].fd)) {
|
||
fds[i].revents |= NET_POLLNVAL;
|
||
ready++;
|
||
continue;
|
||
}
|
||
|
||
const net_sock_t *p_sock = net_get_sock(fds[i].fd);
|
||
|
||
if (NULL == p_sock) {
|
||
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 (0 < ready) {
|
||
break;
|
||
}
|
||
|
||
/* 超时检测 */
|
||
if (0 <= timeout) {
|
||
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. 监听态 Socket 视为可读（存在可 accept 的新连接）
|
||
* 2. 已建立连接且接收缓冲区长度大于 0 时视为可读
|
||
*/
|
||
static int check_socket_readable(int sockfd) {
|
||
const net_sock_t *p_sock;
|
||
|
||
p_sock = net_get_sock(sockfd);
|
||
if (NULL == p_sock) {
|
||
return 0;
|
||
}
|
||
|
||
/* 监听 Socket 有新连接时可读 */
|
||
if (NET_SOCK_STATE_LISTENING == p_sock->state) {
|
||
return 1;
|
||
}
|
||
|
||
/* 已建立连接或 UDP 等有数据可读：readable 由 net_poll 在 RECV_OK 时置位、
|
||
* net_recv_locked 读空后清零。避免应用任务直接访问 CH395F SPI（见 Trap 16） */
|
||
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 (NULL == p_sock) {
|
||
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 ((0 > sockfd) || (NET_MAX_SOCKETS <= sockfd)) {
|
||
return 1;
|
||
}
|
||
|
||
p_sock = net_get_sock(sockfd);
|
||
if (NULL == p_sock) {
|
||
return 1; /* 未使用的 Socket 视为错误 */
|
||
}
|
||
|
||
return 0;
|
||
}
|