初始化项目

AGENTS.md

@@ -0,0 +1,39 @@
+# 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)