# zephry_project **Repository Path**: End-ING/zephry_project ## Basic Information - **Project Name**: zephry_project - **Description**: zephry_project - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-10-27 - **Last Updated**: 2026-10-29 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Zephyr 编译环境说明 > 构建入口已统一为根目录 `build.ps1`,产物按板卡和应用输出到 `build///`。通用使用及迁移说明见 [docs/BUILD_GUIDE.md](docs/BUILD_GUIDE.md)。不需要修改官方 Zephyr 或外部模块。 本项目基于 Zephyr RTOS 4.4.99 开发快照。重建版本由根目录 `west.yml` 锁定;现有工作区实际版本由活动清单和检出提交决定。支持三块开发板: - **NXP FRDM-MCXA156**(Cortex-M33) - **NXP FRDM-MCXN947**(Cortex-M33 双核,TrustZone) - **正点原子 ATK-MiniH562**(STM32H562,自定义板卡) > 上游依赖(zephyr / modules / bootloader / tools)指向**官方仓库**,不作为自有源码上传; > 根清单锁定重建版本,现有工作区升级前应单独检查提交与工作树状态。布局和重建注意事项详见 > [docs/WORKSPACE_AND_GITEE.md](docs/WORKSPACE_AND_GITEE.md)。 ## 环境概览 | 组件 | 版本 | 路径 | |------|------|------| | Zephyr | 4.4.99 | `zephyr/` | | Zephyr SDK | 1.0.1 | `-SdkPath` 或 `ZEPHYR_SDK_INSTALL_DIR` 指定 | | Python (虚拟环境) | 3.12+ | `.venv/` | | West | 1.5.0 | `.venv/Scripts/west.exe` | | CMake | 4.3.2 | 系统安装 | ## 前置要求 - Windows 操作系统 - Python 3.12+(项目虚拟环境已提供) - Zephyr SDK 1.0.1 - west 工具(项目虚拟环境已提供) ## 快速开始 ### 1. 激活虚拟环境 **PowerShell:** ```powershell .\.venv\Scripts\Activate.ps1 ``` **CMD:** ```cmd .\.venv\Scripts\activate.bat ``` ### 2. 编译示例 根目录唯一 PowerShell 构建入口是 `build.ps1`;Makefile 也委托它执行。默认目标是 `fs_demo @ mcxn947/mcxn947/cpu0`,默认输出按板卡和应用隔离到 `build//`。 ```powershell # 默认应用 .\build.ps1 # MCXA156 的 hello_world 示例 .\build.ps1 -Board mcxa156/mcxa156 -App zephyr/samples/hello_world # 重新配置并构建(rebuild) .\build.ps1 -Board mcxa156/mcxa156 -App zephyr/samples/hello_world -Pristine always # 只显示选中目标的输出路径;不构建 .\build.ps1 -Board mcxa156/mcxa156 -App zephyr/samples/hello_world -PrintBuildDir # 只清理选中应用目录,不删除整个 build/ .\build.ps1 -Board mcxa156/mcxa156 -App zephyr/samples/hello_world -Clean ``` > 其他教程保留了历史命令,不能照搬无 `-d` 的 `west build`:直接调用 west 时必须显式传入工作区 `build/` 内、按板卡/变体/应用隔离的 `-d`,后续 `west flash` 和构建目标也使用同一目录。不要创建根目录 `build_nxp`、`build_shell_qspi`,也不要执行已退役的 `build-nxp.ps1`。完整映射、覆盖和保护规则见 [构建说明](docs/BUILD_GUIDE.md)。 ### 3. 编译产物 编译成功后,产物位于所选应用目录的 `zephyr/` 下,例如 `build/mcxa156/hello_world/zephyr/`: | 文件 | 说明 | |------|------| | `zephyr.elf` | ELF 可执行文件(用于调试) | | `zephyr.bin` | 二进制固件(可直接烧录) | | `zephyr.hex` | Intel HEX 格式固件 | | `devicetree_generated.h` | 设备树生成的 C 头文件 | | `autoconf.h` | Kconfig 配置头文件 | ## 支持的开发板 ### NXP FRDM-MCXA156 - **板载芯片**: MCXA156 (Cortex-M33) - **Flash**: 1 MB - **RAM**: 120 KB - **设备树文件**: `zephyr/boards/nxp/frdm_mcxa156/frdm_mcxa156.dts` - **默认配置**: `zephyr/boards/nxp/frdm_mcxa156/frdm_mcxa156_defconfig` ### NXP MCXA156 / MCXN947(本地自管板卡) 位于 `boards/nxp/`,由 Zephyr 树内 `frdm_mcxa156` / `frdm_mcxn947` 复制改名而来,**独立于 Zephyr 源码维护**,改配置不用动 zephyr 目录。硬件即 FRDM-MCXA156 / FRDM-MCXN947 官方评估板,烧录配置(JLink/LinkServer/pyocd)保持不变。 > 📘 MCXN947 的烧录方式、shell 组件使用和配置块(FCB)事故复盘见 **[docs/MCXN947_FLASH_AND_SHELL_GUIDE.md](docs/MCXN947_FLASH_AND_SHELL_GUIDE.md)** ```powershell # MCXA156:NXP 使用不依赖 sw2 的 mcx_blink_key_demo .\build.ps1 -Board mcxa156/mcxa156 -App apps/mcx_blink_key_demo # MCXN947:基线与 QSPI 变体分别隔离输出 .\build.ps1 -Board mcxn947/mcxn947/cpu0 -App apps/mcx_blink_key_demo .\build.ps1 -Board mcxn947/mcxn947/cpu0/qspi -App apps/mcx_blink_key_demo ``` > 注意:树内同名前缀的 `frdm_mcxa156` / `frdm_mcxn947` 仍然存在且可用;这两份副本随当前 Zephyr 版本冻结,升级 Zephyr 后如需上游修复要手动同步。 ### 正点原子 ATK-MiniH562 - **板载芯片**: STM32H562VIT6 (Cortex-M33, TrustZone) - **Flash**: 2 MB - **RAM**: 256 KB(zephyr,sram = SRAM1;芯片总 RAM 640 KB,其余需在 DTS 中另行启用) - **板卡文件**: `boards/alientek/atk_minih562/` - **示例应用**: `apps/blink_key_demo/`(LED 闪烁 + 按键 + 串口) - **调试/烧录**: SWD(PA13/PA14),JLink 烧录(`--device=STM32H562VI`) - **串口**: 板载 CH340C,USART1 PA9/PA10 @115200(zephyr console) #### 编译与烧录 ```powershell # 方式一:Makefile(Git Bash) make build BOARD=atk_minih562 APP=apps/blink_key_demo # build/atk_minih562/blink_key_demo make all BOARD=atk_minih562 APP=apps/blink_key_demo # 编译 + JLink 烧录 # 方式二:build.ps1(PowerShell) .\build.ps1 -Board atk_minih562 -App apps/blink_key_demo .\build.ps1 -Board atk_minih562 -App apps/blink_key_demo -Flash # 直接用 west 时需激活 venv;显式指定模块和 -d west build -p always -b atk_minih562 -d build/atk_minih562/blink_key_demo apps/blink_key_demo -- -DZEPHYR_EXTRA_MODULES="$PWD/boards" west flash -d build/atk_minih562/blink_key_demo -r jlink --commander "C:\Program Files\SEGGER\JLink_V936\JLink.exe" ``` #### 板载资源(原理图 V1.0 + IO 引脚分配表) | 资源 | 引脚 | 说明 | |------|------|------| | LED0 / LED1 | PB4 / PB5 | 低电平点亮 | | KEY0 / KEY1 / WK_UP | PA1 / PA15 / PA0 | WK_UP 可做低功耗唤醒 | | 调试串口 | PA9/PA10 (USART1) | 板载 CH340C,USB Type-C | | I2C2 总线 | SCL=PB10, SDA=PB3 | 板载 24C02 EEPROM + AP3216C 光感/距离 | | QSPI Flash | W25Q128 (16MB) | XSPI1: PB2/PB6/PD11/PD12/PE2/PD13 | | TF 卡 | SDIO (PC8~PC12, PD2) | 与摄像头 DCMI 部分引脚复用 | | TFT LCD | FMC 8080 并口 | NE1=PD7, RS=A22(PE6), D0~D15, BL=PE5 | | 音频 | ES8388 + SAI1 + NS4150 功放 | 耳机口 + 喇叭 + 板载麦克风 | | USB FS | PA11/PA12 | 两个 Type-C(SLAVE/HOST 各一) | | ATK 模块接口 | PA2/PA3 (USART2) + PC2/PC3 | 蓝牙/WiFi/语音模块 | | 无线接口 | SPI2 (PB13~PB15) + CE=PC4 + IRQ=PC13 | NRF24L01 | | 1-Wire | PC13 | DHT11 / DS18B20(与 NRF IRQ 复用) | | 红外接收 | PA8 | 与摄像头 XCLK 复用 | | 蜂鸣器 | PE0 | LPTIM2_CH2 可输出 PWM | | DAC / ADC | PA4 / PA5 | P5 跳线帽引出 | | RTC | LSE 32.768kHz + VBAT 纽扣电池 | 掉电走时 | | RNG | 硬件真随机数 | — | | OLED/摄像头接口 | DCMI + I2C | 与 SD 卡、SAI 部分引脚复用 | > 注意:PC0/PC1/PC6/PC8/PC9/PC11 等引脚在摄像头、SD 卡、音频之间复用,不能同时使用。 ## 常用命令 ```powershell # 查看支持的开发板列表 west boards # 查看 west 工作区项目 west list # 只清理默认选中的 fs_demo 目录;其他应用需同时指定 -Board / -App .\build.ps1 -Clean # 配置菜单及内存报告:显式指定已经生成的应用目录 west build -d build/mcxn947/fs_demo -t menuconfig west build -d build/mcxn947/fs_demo -t rom_report west build -d build/mcxn947/fs_demo -t ram_report ``` ## 常见问题 ### Q: 编译报错 "Could NOT find Python3: Found unsuitable version" **原因**: 使用了系统 Python 3.11,但 Zephyr 4.4 要求 Python ≥ 3.12。 **解决**: 使用项目虚拟环境中的 Python 和 west: ```powershell .\.venv\Scripts\Activate.ps1 ``` ### Q: 如何切换其他开发板? ```powershell # 查看所有支持的开发板 west boards # 使用其他开发板编译 .\build.ps1 -Board -App zephyr/samples/hello_world -Pristine always ``` ### Q: 如何添加自定义应用? 在项目根目录创建应用文件夹,结构如下: ``` my_app/ ├── CMakeLists.txt ├── prj.conf ├── src/ │ └── main.c └── app.overlay # 可选:设备树覆盖 ``` 然后编译: ```powershell .\build.ps1 -Board mcxa156/mcxa156 -App my_app ``` ## 目录结构 ``` zephyrproject/ ├── west.yml # west 清单:锁定 zephyr + 全部模块版本(Gitee 重建入口) ├── apps/ # 自研应用(fs_demo / shell_demo / blink_key_demo) ├── boards/ # 自管板卡(nxp/mcxn947、nxp/mcxa156、alientek/atk_minih562) ├── tests/hil/ # 串口 HIL 测试框架与用例 ├── docs/ # 文档 ├── Makefile build.ps1 # Make 委托根目录唯一 PowerShell 构建入口 ├── .venv/ # Python 虚拟环境(不入库) ├── .west/ # west 工作区元数据(不入库) ├── zephyr/ modules/ # west 管理的上游源码(官方零修改,不入库) ├── bootloader/ tools/ # 同上(mcuboot、edtt、net-tools) └── build/ # 唯一构建目录,不入库 ├── mcxn947/fs_demo/ # CPU0 基线:build// ├── mcxa156/mcx_blink_key_demo/ ├── atk_minih562/blink_key_demo/ ├── mcxn947/_variants/mcxn947/cpu0/qspi/shell_demo/ ├── .cache/ # 工具缓存,不是应用输出目录 └── _legacy/ # 可选旧产物归档,不能复用 CMake 缓存 ``` ## 环境变量 | 变量 | 说明 | |------|------| | `ZEPHYR_SDK_INSTALL_DIR` | Zephyr SDK 安装路径 | | `ZEPHYR_BASE` | Zephyr 源码根目录(west 自动检测) | ## 相关资源 - [Zephyr 官方文档](https://docs.zephyrproject.org/) - [FRDM-MCXA156 开发板](https://www.nxp.com/design/design-center/development-boards-and-designs/general-purpose-mcus/frdm-development-board-for-mcx-a14x-a15x-mcus:FRDM-MCXA156) - [FRDM-MCXN947 开发板](https://www.nxp.com/design/design-center/development-boards-and-designs/general-purpose-mcus/frdm-development-board-for-mcx-n94x-n54x-mcus:FRDM-MCXN947) - [正点原子 ATK-MiniH562 资料](https://www.openedv.com/docs/index.html)