修复Yoda条件(常量右置)与函数定义括号同行

- net_select.c/net_socket.c 共 62 处 Yoda 条件改为常量在右(规范 6.3.1)

- 11 个文件 58 处函数定义左大括号由换行改为与右括号同行(规范 4.4.2)
This commit is contained in:
2026-09-01 16:57:34 +08:00
parent bb76cfd779
commit 02c10fa5ef
13 changed files with 111 additions and 169 deletions
+2 -4
View File
@@ -40,8 +40,7 @@
* 5) SD2506 诊断信息
* 6) 触发首次 ADC 转换
*/
int app_main_init(void)
{
int app_main_init(void) {
/*
* 1) 时间子系统初始化(尽早完成,后续所有日志带时间戳)
* sd2506_init() 从 RTC 读取初始时间
@@ -113,8 +112,7 @@ int app_main_init(void)
* 限定条件:FreeRTOS 调度器启动后不再返回
* 函数说明:空闲任务可调用的应用层处理入口
*/
void app_main_run(void)
{
void app_main_run(void) {
for (;;) {
/* 应用层空闲处理 */
}
+7 -14
View File
@@ -54,8 +54,7 @@ static volatile uint32_t s_base_unix_secs = UINT32_MAX;
* 函数说明:1. 采用 Zeller 公式(变种),结果 0 表示周日
* 2. 与 unix_to_sd2506() 内星期算法保持一致
*/
static uint8_t rtc_calc_week(uint16_t y, uint8_t m, uint8_t d)
{
static uint8_t rtc_calc_week(uint16_t y, uint8_t m, uint8_t d) {
uint32_t wy = y;
uint32_t wm = m;
@@ -79,8 +78,7 @@ static uint8_t rtc_calc_week(uint16_t y, uint8_t m, uint8_t d)
* 2. 星期由 Zeller 公式(与 rtc_calc_week 同算法)得出
* 3. SD2506 年份字段为相对值(0~99,+2000),故回写时减 2000
*/
static void unix_to_sd2506(uint32_t unix_secs, sd2506_time_t *p_sd_time)
{
static void unix_to_sd2506(uint32_t unix_secs, sd2506_time_t *p_sd_time) {
uint8_t h, mi, s;
/* 时分秒 */
@@ -163,8 +161,7 @@ static void unix_to_sd2506(uint32_t unix_secs, sd2506_time_t *p_sd_time)
* 4. 注意:sd2506_get_time() 返回的 year 已是完整年份(驱动内 +2000),
* 换算时不得再加 2000,否则年份虚增导致 Unix 秒数超 uint32 回绕
*/
int sys_clock_init(void)
{
int sys_clock_init(void) {
sd2506_time_t sd_time;
uint32_t year, month, day, hour, minute, second;
int64_t unix_secs = 0;
@@ -288,8 +285,7 @@ int sys_clock_init(void)
* 的整除差推算流逝秒数(避免每毫秒累加,减少漂移与溢出风险)
* 2. 若推算结果为负(基准未建立),返回 UINT32_MAX 表示无效
*/
uint32_t sys_clock_get(void)
{
uint32_t sys_clock_get(void) {
uint32_t now_tick = HAL_GetTick();
int64_t unix_secs = (int64_t)s_base_unix_secs + (int64_t)((uint32_t)(now_tick - s_base_tick) / 1000uL);
@@ -311,8 +307,7 @@ uint32_t sys_clock_get(void)
* 2. 通过 unix_to_sd2506() 转换为 SD2506 结构后格式化
* 3. 使用 snprintf 防止缓冲区溢出
*/
char *sys_clock_get_str(char *buf, size_t buf_size)
{
char *sys_clock_get_str(char *buf, size_t buf_size) {
uint32_t unix_secs = sys_clock_get();
if (unix_secs == UINT32_MAX) {
snprintf(buf, buf_size, "----/--/-- --:--:--");
@@ -338,8 +333,7 @@ char *sys_clock_get_str(char *buf, size_t buf_size)
* 函数说明:1. 重置基准 Tick 与基准 Unix 秒数,使后续 sys_clock_get() 以此为准
* 2. 若 sd_time 非 NULL,将其写回 SD2506 RTC,实现断电保持
*/
int sys_clock_set(uint32_t unix_secs, const sd2506_time_t *sd_time)
{
int sys_clock_set(uint32_t unix_secs, const sd2506_time_t *sd_time) {
/* Step 1: 更新墙钟基准 */
s_base_tick = HAL_GetTick();
s_base_unix_secs = unix_secs;
@@ -366,8 +360,7 @@ int sys_clock_set(uint32_t unix_secs, const sd2506_time_t *sd_time)
* 函数说明:将 Unix 秒数转换为 SD2506 时间结构,再调用 sys_clock_set()
* 更新运行期基准并写回 RTC,实现掉电保持
*/
int sys_clock_set_unix(uint32_t unix_secs)
{
int sys_clock_set_unix(uint32_t unix_secs) {
sd2506_time_t sd;
/* 内部静态函数:将 Unix 秒数拆分为 SD2506 时间结构 */
+2 -4
View File
@@ -22,8 +22,7 @@
* 限定条件:TPAFE5160 硬件已上电
* 函数说明:配置采样参数,准备数据缓冲区
*/
int adc_task_init(void)
{
int adc_task_init(void) {
DBG_INFO("adc_task_init");
return 0;
}
@@ -35,8 +34,7 @@ int adc_task_init(void)
* 限定条件:adc_task_init() 已成功调用
* 函数说明:定时触发 TPAFE5160 同步采样并处理数据
*/
void adc_task_func(void const *arg)
{
void adc_task_func(void const *arg) {
(void)arg;
for (;;) {
+3 -6
View File
@@ -31,8 +31,7 @@
* NET 层模式由 netTask 调用;硬件层模式(阶段 1~5)netTask 不创建,
* 由 testTask 调用后独占 CH395F。
*/
int net_stack_bring_up(void)
{
int net_stack_bring_up(void) {
DBG_INFO("=== Network Init ===");
if (net_init("192.168.1.100", "255.255.255.0", "192.168.1.1") != 0) {
@@ -87,8 +86,7 @@ int net_stack_bring_up(void)
* 限定条件:CH395F 协议栈已初始化
* 函数说明:创建 TCP Server 监听 Socket,注册回调等
*/
int net_task_init(void)
{
int net_task_init(void) {
DBG_INFO("net_task_init");
return 0;
}
@@ -102,8 +100,7 @@ int net_task_init(void)
* 仅 NET 层测试模式(阶段 6~10)会创建本任务;
* 硬件层模式下 netTask 不创建,CH395F 由 testTask 独占。
*/
void net_task_func(void const *arg)
{
void net_task_func(void const *arg) {
(void)arg;
osDelay(2000);
+2 -4
View File
@@ -22,8 +22,7 @@
* 限定条件:UART 和 GPIO 已由 CubeMX 初始化
* 函数说明:配置 RS-485 通信参数,注册接收回调
*/
int rs485_task_init(void)
{
int rs485_task_init(void) {
DBG_INFO("rs485_task_init");
return 0;
}
@@ -35,8 +34,7 @@ int rs485_task_init(void)
* 限定条件:rs485_task_init() 已成功调用
* 函数说明:轮询接收缓冲区并解析协议帧
*/
void rs485_task_func(void const *arg)
{
void rs485_task_func(void const *arg) {
(void)arg;
for (;;) {
+2 -4
View File
@@ -25,8 +25,7 @@
* 限定条件:sys_evtHandle 为 NULL 时直接返回
* 函数说明:无限期等待 SYS_EVT_NET_READY 标志
*/
static void ui_task_wait_net_ready(void)
{
static void ui_task_wait_net_ready(void) {
if (sys_evtHandle != NULL) {
osEventFlagsWait(sys_evtHandle, SYS_EVT_NET_READY,
osFlagsWaitAny, osWaitForever);
@@ -41,8 +40,7 @@ static void ui_task_wait_net_ready(void)
* 函数说明:1. 等待 SYS_EVT_NET_READY 后依次初始化 ui_port/ui_menu/ui_net_sink
* 2. 主循环周期调用 ui_port_step 与 ui_net_sink_poll 刷新界面
*/
void ui_task_func(void *argument)
{
void ui_task_func(void *argument) {
(void)argument;
DBG_INFO("UI task: started, wait net ready");
+3 -6
View File
@@ -33,8 +33,7 @@
* 单连接模式下监听 Socket 在收到连接后会转为数据通道,连接关闭后即被释放,
* 因此每次调用都会新建监听 Socket(与 lftpd 同模式),失败自动重试。
*/
static int time_sync_open_listener(void)
{
static int time_sync_open_listener(void) {
int retry;
for (retry = 0; retry < 5; retry++) {
@@ -78,8 +77,7 @@ static int time_sync_open_listener(void)
* 返回值:无
* 函数说明:阻塞读取 PC 发来的时间包("TIME"+uint32 大端 本地时间),解析后写回 RTC,然后关闭连接
*/
static void time_sync_handle_conn(int conn_sock)
{
static void time_sync_handle_conn(int conn_sock) {
uint8_t buf[16];
int len;
@@ -106,8 +104,7 @@ static void time_sync_handle_conn(int conn_sock)
* 函数说明:等待网络栈就绪后,循环:建监听 -> 等连接 -> 处理 -> 关闭 -> 重建监听。
* 全部 socket 操作经消息队列由 netTask 串行执行,与本任务/其它网络任务并发安全。
*/
void timeSyncTask(void *argument)
{
void timeSyncTask(void *argument) {
(void)argument;
/* 等网络栈真正就绪(取代拍脑袋的 8s 魔法延时),确保 netTask 已开始处理消息 */
+2 -4
View File
@@ -89,8 +89,7 @@ static const uint8_t s_crc8_table[256] = {
* 限定条件:data 为非空指针
* 函数说明:多项式 0x8005,初始值 0xFFFF,结果异或 0x0000
*/
uint16_t crc16_modbus(const uint8_t *data, size_t len)
{
uint16_t crc16_modbus(const uint8_t *data, size_t len) {
uint16_t crc = 0xFFFF;
size_t i;
@@ -109,8 +108,7 @@ uint16_t crc16_modbus(const uint8_t *data, size_t len)
* 限定条件:data 为非空指针
* 函数说明:多项式 0x07,初始值 0x00
*/
uint8_t crc8(const uint8_t *data, size_t len)
{
uint8_t crc8(const uint8_t *data, size_t len) {
uint8_t crc = 0;
size_t i;
+9 -18
View File
@@ -19,8 +19,7 @@
* 限定条件:rb 和 pool 均为非空指针
* 函数说明:size 保留一个空位用于区分空/满状态
*/
void ringbuf_init(ringbuf_t *rb, uint8_t *pool, size_t size)
{
void ringbuf_init(ringbuf_t *rb, uint8_t *pool, size_t size) {
rb->buf = pool;
rb->size = size;
rb->head = 0;
@@ -36,8 +35,7 @@ void ringbuf_init(ringbuf_t *rb, uint8_t *pool, size_t size)
* 限定条件:rb 和 data 均为非空指针
* 函数说明:空间不足时写入能容纳的最大字节数
*/
size_t ringbuf_put(ringbuf_t *rb, const uint8_t *data, size_t len)
{
size_t ringbuf_put(ringbuf_t *rb, const uint8_t *data, size_t len) {
size_t cap = 0;
size_t n = 0;
size_t i = 0;
@@ -62,8 +60,7 @@ size_t ringbuf_put(ringbuf_t *rb, const uint8_t *data, size_t len)
* 限定条件:rb 和 data 均为非空指针
* 函数说明:读取后数据从缓冲区移除
*/
size_t ringbuf_get(ringbuf_t *rb, uint8_t *data, size_t len)
{
size_t ringbuf_get(ringbuf_t *rb, uint8_t *data, size_t len) {
size_t n = 0;
size_t i = 0;
@@ -87,8 +84,7 @@ size_t ringbuf_get(ringbuf_t *rb, uint8_t *data, size_t len)
* 限定条件:rb 和 data 均为非空指针
* 函数说明:与 ringbuf_get 的区别是不移动 tail 指针
*/
size_t ringbuf_peek(const ringbuf_t *rb, uint8_t *data, size_t len)
{
size_t ringbuf_peek(const ringbuf_t *rb, uint8_t *data, size_t len) {
size_t n = 0;
size_t i = 0;
@@ -109,8 +105,7 @@ size_t ringbuf_peek(const ringbuf_t *rb, uint8_t *data, size_t len)
* 返 回 值:有效数据字节数
* 限定条件:rb 为非空指针
*/
size_t ringbuf_avail(const ringbuf_t *rb)
{
size_t ringbuf_avail(const ringbuf_t *rb) {
if (rb->head >= rb->tail) {
return rb->head - rb->tail;
}
@@ -123,8 +118,7 @@ size_t ringbuf_avail(const ringbuf_t *rb)
* 返 回 值:剩余空间字节数(保留一个空位)
* 限定条件:rb 为非空指针
*/
size_t ringbuf_space(const ringbuf_t *rb)
{
size_t ringbuf_space(const ringbuf_t *rb) {
return rb->size - 1 - ringbuf_avail(rb);
}
@@ -134,8 +128,7 @@ size_t ringbuf_space(const ringbuf_t *rb)
* 返 回 值:1 - 空,0 - 非空
* 限定条件:rb 为非空指针
*/
int ringbuf_is_empty(const ringbuf_t *rb)
{
int ringbuf_is_empty(const ringbuf_t *rb) {
return (rb->head == rb->tail) ? 1 : 0;
}
@@ -145,8 +138,7 @@ int ringbuf_is_empty(const ringbuf_t *rb)
* 返 回 值:1 - 满,0 - 非满
* 限定条件:rb 为非空指针
*/
int ringbuf_is_full(const ringbuf_t *rb)
{
int ringbuf_is_full(const ringbuf_t *rb) {
return (ringbuf_avail(rb) == rb->size - 1) ? 1 : 0;
}
@@ -156,8 +148,7 @@ int ringbuf_is_full(const ringbuf_t *rb)
* 返 回 值:无
* 限定条件:rb 为非空指针
*/
void ringbuf_reset(ringbuf_t *rb)
{
void ringbuf_reset(ringbuf_t *rb) {
rb->head = 0;
rb->tail = 0;
}