68 lines
2.6 KiB
Markdown
68 lines
2.6 KiB
Markdown
# 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 硬件），物理层正常。
|