Revise and expand supported boards documentation#15
Conversation
Updated both English and Chinese documentation for supported boards and flashing instructions. Standardized board naming, clarified firmware selection for different gyroscope variants, added detailed hardware compatibility notes, and expanded tables for MCUs and sensors. Improved guidance for manufacturers and users regarding hardware support and firmware flashing.
There was a problem hiding this comment.
Pull request overview
This PR revises and expands the documentation for supported flight controllers, improving clarity and consistency for both English and Chinese versions. The updates standardize board naming conventions, clarify firmware selection for different gyroscope variants, add detailed hardware compatibility warnings, and expand MCU/sensor support information.
Changes:
- Standardized board naming by removing spaces (e.g., "NeutronRC F435 SE" → "NeutronRCF435SE")
- Added comprehensive warnings about gyroscope compatibility (BMI270 vs ICM42688P variants)
- Expanded MCU support tables to include STM32 series and updated sensor compatibility notes
- Added detailed guidance for firmware selection with legacy variants
- Reorganized content with clearer section headings and hardware-specific notes
Reviewed changes
Copilot reviewed 2 out of 4 changed files in this pull request and generated 4 comments.
| File | Description |
|---|---|
| src/content/docs/en/fydelix/supported-boards.md | English version: Updated board descriptions, added gyroscope variant warnings, expanded MCU/sensor tables, reorganized firmware selection guidance |
| src/content/docs/zh/fydelix/supported-boards.md | Chinese version: Parallel updates to English version with culturally appropriate translations |
| src/content/docs/en/fydelix/flashing.md | Standardized board naming in firmware selection table to match supported-boards.md |
| src/content/docs/zh/fydelix/flashing.md | Standardized board naming in firmware selection table to match supported-boards.md |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| ### Naming Convention | ||
|
|
||
| ```text | ||
| fydelix-<board>-<version>-<git-commit>.hex |
There was a problem hiding this comment.
The naming convention description mentions "git-commit" but the example only shows a shortened hash (8ab496d). Consider clarifying that this is a shortened/abbreviated Git commit hash, not the full hash, for accuracy.
| |------|---------|-------|-----|--------| | ||
| | AT32F435CGU7 | QFN48 | 1MB | 384KB | ✅ Full Support | | ||
| | AT32F435RGT7 | LQFP64 | 1MB | 384KB | ✅ Full Support | | ||
| | AT32F437VMT7 | LQFP100 | 4MB | 384KB | ✅ Full Support | |
There was a problem hiding this comment.
The RAM specification for AT32F437VMT7 is listed as 384KB, but this should be 512KB. The Flash value (4MB) is correct for this chip model, but the RAM differs from typical AT32F437 specifications which have 512KB of RAM.
| | AT32F437VMT7 | LQFP100 | 4MB | 384KB | ✅ Full Support | | |
| | AT32F437VMT7 | LQFP100 | 4MB | 512KB | ✅ Full Support | |
| |----------|------|-------|-----|----------| | ||
| | AT32F435CGU7 | QFN48 | 1MB | 384KB | ✅ 完整支持 | | ||
| | AT32F435RGT7 | LQFP64 | 1MB | 384KB | ✅ 完整支持 | | ||
| | AT32F437VMT7 | LQFP100 | 4MB | 384KB | ✅ 完整支持 | |
There was a problem hiding this comment.
The RAM specification for AT32F437VMT7 is listed as 384KB, but this should be 512KB. The Flash value (4MB) is correct for this chip model, but the RAM differs from typical AT32F437 specifications which have 512KB of RAM.
| | AT32F437VMT7 | LQFP100 | 4MB | 384KB | ✅ 完整支持 | | |
| | AT32F437VMT7 | LQFP100 | 4MB | 512KB | ✅ 完整支持 | |
| ### 命名规则 | ||
|
|
||
| ```text | ||
| fydelix-<飞控型号>-<版本号>-<Git提交哈希>.hex |
There was a problem hiding this comment.
The naming convention description mentions "Git提交哈希" (Git commit hash), but the example only shows a shortened hash (8ab496d). Consider clarifying that this is a shortened/abbreviated Git commit hash, not the full hash, for accuracy.
| fydelix-<飞控型号>-<版本号>-<Git提交哈希>.hex | |
| fydelix-<飞控型号>-<版本号>-<Git提交哈希（缩写）>.hex |
Updated both English and Chinese documentation for supported boards and flashing instructions. Standardized board naming, clarified firmware selection for different gyroscope variants, added detailed hardware compatibility notes, and expanded tables for MCUs and sensors. Improved guidance for manufacturers and users regarding hardware support and firmware flashing.