40 lines
1.8 KiB
Markdown
40 lines
1.8 KiB
Markdown
# STM32F103C8T6 Project
|
||
|
||
## Project Type
|
||
STM32CubeMX-generated project using **Keil MDK-ARM V5.32** toolchain.
|
||
|
||
## Key Files
|
||
- `STM32F103C8T6/STM32F103C8T6.ioc` — CubeMX configuration (pinout, clock, peripherals)
|
||
- `STM32F103C8T6/Core/Src/main.c` — Application entry point
|
||
- `STM32F103C8T6/MDK-ARM/STM32F103C8T6.uvprojx` — Keil project file
|
||
|
||
## Hardware Configuration
|
||
- **MCU**: STM32F103C8T6 (LQFP48, 72MHz, 64KB Flash, 20KB RAM)
|
||
- **Clock**: HSE 8MHz → PLL ×9 = 72MHz SYSCLK
|
||
- **Peripherals**:
|
||
- USART1: PA9 (TX), PA10 (RX) — Async mode
|
||
- LED: PC13 (active low, pull-up)
|
||
- Keys: PB3 (KEY1), PB4 (KEY2), PB5 (KEY3), PC14 (KEY4), PC15 (KEY5) — Pull-down
|
||
- LCD: PB12 (RST), PB13 (SCL), PB15 (SDA) — GPIO output, pull-up
|
||
|
||
## Code Conventions
|
||
- Custom code must be placed within `/* USER CODE BEGIN */` and `/* USER CODE END */` markers
|
||
- Code outside these markers will be overwritten by CubeMX code generation
|
||
- HAL library is used (defined `USE_HAL_DRIVER` and `STM32F103xB`)
|
||
|
||
## 代码规范
|
||
- **遵循**: `嵌入式C语言代码规范（V1.0）.md`
|
||
- **缩进**: 4个空格，禁止Tab
|
||
- **命名**:
|
||
- 变量/函数: 小写+下划线，全局变量`g_`前缀，静态变量`s_`前缀，指针`p_`前缀
|
||
- 宏/常量: 大写+下划线，模块名前缀
|
||
- 类型: 小写+下划线+`_t`后缀
|
||
- **注释**: 关键逻辑每行注释，函数必须完整注释（功能/参数/返回值/说明）
|
||
- **大括号**: 所有if/for/while必须加大括号，左大括号同行，右大括号单独行
|
||
- **禁止**: goto、递归、可变参数函数、注释掉的代码提交
|
||
|
||
## Important Notes
|
||
- `Drivers/` directory contains HAL driver source — do not edit directly
|
||
- Regenerate code via CubeMX `.ioc` file, not manually editing HAL files
|
||
- Keil build output goes to `MDK-ARM/STM32F103C8T6/` (already gitignored)
|