STM32F4-Base/AGENTS.md

STM32F4-Base

项目概述

STM32F407ZGTx (Cortex-M4 FPU) 基础固件项目，集成 CH395F 以太网控制器 SPI 驱动（CH395F 自带 MAC+PHY 及 TCP/IP 协议栈固件）。

关键文件

路径	说明
Src/main.c	程序入口，初始化序列及主循环
Src/ch395f.c / Inc/ch395f.h	CH395F 以太网芯片 SPI 驱动（核心自定义代码）
MDK-ARM/STM32F407-Demo.uvprojx	Keil MDK 项目文件
STM32F407-Demo.ioc	STM32CubeMX 项目源文件

构建

仅支持 Keil MDK-ARM v5 (ARMCC)。打开 MDK-ARM/STM32F407-Demo.uvprojx 编译。

• 编译器：ARMCC V5.06 update 7
• 优化等级：-O4 (项目级)，spi.c/usart.c / HAL 源文件使用 -O0
• C 标准：C99
• 全局宏定义：USE_HAL_DRIVER, STM32F407xx

硬件配置

• 主频： HSE 25MHz → PLL 168MHz (4/168/2)
• 6 个 LED： PC4, PC5, PB1, PB2, PF11, PF12（低电平点亮）
• CH395F： SPI2 (PB12 CS, PB13 SCK, PB14 SDO, PB15 SDI)
• USART1： PA9 TX, PA10 RX (115200bps)

启动顺序

HAL_Init() → SystemClock_Config() → MX_GPIO_Init() → MX_USART1_UART_Init() → MX_SPI2_Init() → ch395f_reset() → ch395f_init()

代码规范

参考 嵌入式C语言代码规范（V1.0）.md，关键要点：

• 缩进：4 空格，禁止 Tab
• 命名：小写字母+下划线；全局变量 g_ 前缀，静态 s_，指针 p_，数组 a_
• 函数注释块需包含：函数功能、入口参数、返回值、限定条件、函数说明
• 大括号：K&R 风格（左大括号不换行）

注意

• Inc/ 和 Src/ 中 CubeMX 生成的文件（gpio, spi, usart, stm32f4xx_it, main 的骨架）带有 USER CODE BEGIN/END 标记，自定义代码应写在这些区域之间以免被 CubeMX 重新生成时覆盖
• ch395f.c/ch395f.h 为纯手工代码，不受 CubeMX 保护
• 每次 SPI 事务需调用 ch395f_spi_begin() / ch395f_spi_end() 包裹
• CH395F 命令执行时序参考 ch395f.h 中命令码注释及 CH395F.md

已知问题

CH395F 与 RTL8305NBI 自动协商不兼容

CH395F 与 RTL8305NBI-CG 直连（经网络变压器）时，自动协商始终失败（返回 PHY_DISCONN），但强制 100M 全双工工作正常。强制 10M 全双工同样失败。

诊断结果：

• Auto-Neg: 0x01 (DISCONNECTED)
• Force 100M-FULL: 0x08 (LINK OK)
• Force 10M-FULL: 0x01 (DISCONNECTED)

解决方案： 初始化协议栈后调用 ch395f_set_phy(CH395F_PHY_100M_FULL) 跳过自动协商。

推测根因： 不同厂家 PHY 直连时的自动协商实现差异（CH395F WCH 固件 vs RTL8305NBI Realtek 硬件），物理层正常。