针对当前 E-Port V2 / GD32F527 Payload SDK 工程我要对官方开发环境说明中与实际工程不一致的部分进行修正并从“工程打不开/编译器缺失”一路排查到最终 0 Error、0 Warning。先说结论这次实测采用 Keil MDK 5.29 ARM Compiler 6.13.1Armclang配合 Payload SDK 中的 armclang_cortex-m33 库成功完成 mdk_app 工程的编译、链接和 FromELF 转换。重要说明文中 “官方文档有误” 为简略说法完整严谨描述DJI 大疆 E-Port V2 官方技术文档指定使用 ARM Compiler 5.06ARMCC V5.06工具链该要求不符合 ARM Cortex-M33 内核官方适配规范ARM 厂商已取消 ARM Compiler 5.06 对 Cortex-M33 内核的适配支持当前标准工具链为 ARM Clang 6 编译器。一、先看官方文档问题到底出在哪里DJI 官方 E-Port V2 快速开始页面仍将开发工具链写成 Armcc.exe V5.06 update 6、Armasm.exe V5.06 update 6、ArmLink.exe V5.06 update 6、FromElf.exe V5.06 update 6。但 E-Port V2 的 MCU 是 GD32F527ZMT7内核为 Cortex-M33。本文实际拿到的 Payload SDK 工程已经提供 armclang_cortex-m33 目录因此继续照搬旧的 armcc_cortex-m33 / ARMCC 配置会在现代 MDK 环境下遇到一系列连锁问题。官方文档地址https://developer.dji.com/doc/payload-sdk-tutorial/cn/payload-quick-start/quick-demo/E-Port-V2.htmldji配的开发环境配置文档https://developer.dji.com/doc/payload-sdk-tutorial/cn/payload-quick-start/config-develop-environment.html二、本文最终验证通过的环境·Keil MDK 5.29·ARM Compiler 6.13.1Armclang·GD32F527ZMT7 / Cortex-M33也就是eport-v2实际的使用的mcu·DJI Payload SDK·工程目标mdk_appBootloader 同样需要按对应内存分区配置·SDK 库目录psdk_lib\lib\armclang_cortex-m33图 2Keil/ARM Compiler 版本环境三、第一关工程要求 V6.10.1但本机显示 Missing打开 Options for Target 后最初工程要求的 Compiler 版本并不能直接使用。关键不是反复安装旧版本而是把已经安装的 ARM Compiler 6.13.1 正确注册给 MDK。图 3工程原本要求的 ARM Compiler 版本显示 Missing进入 Manage Project Items → Folders/Extensions找到 ARM Compiler Versions 管理入口。图 4Manage Project Items / Folders Extensions图 5设置默认 ARM Compiler 版本图 6ARM Compiler Versions 管理列表浏览到 MDK 的 ARMCLANG 安装目录完成注册后工程就能识别 V6.13.1。图 7浏览 ARM Compiler 目录图 8ARM Compiler 6.13.1 注册成功随后在 Target → Code Generation 中选择 Use default compiler version 6。图 9使用默认 Compiler 6四、第二关Scatter Error 与 Flash/RAM 分区编译器注册完成后下一关通常会进入链接阶段。典型报错是*** Scatter Error: no default Read/Write range selectedL6031U: Could not open scatter description file .\Objects\mdk_app.sct这个错误不是源码问题而是链接器没有得到正确的内存布局 / Scatter 文件。本文实际使用的 APP 区域从 0x08020000 开始前面的 128KB0x20000留给 Bootloader。APP 的关键内存布局为APP Flash0x08020000 ~ 0x0849FFFFAPP IROM0x08020000Size 0x00480000RAM0x20000000Size 0x00110000因此不要把 APP 的 Scatter 直接拿给 Bootloader 使用。Bootloader 与 APP 是两个不同的内存区域。图 10项目中的 APP Scatter / 内存布局图 11工程中找到 mdk_app.sct如果项目已经提供 mdk_app.sct优先使用项目文件如果使用 Target Dialog 自动生成布局则必须确保 IROM1 / IRAM1 与上述分区一致。五、第三关libpayload.lib 找不到Scatter 处理完成后工程开始真正链接又出现L6002U: Could not open file ...\psdk_lib\lib\armcc_cortex-m33\libpayload.lib这时要注意源码已经能编译问题已经从“编译器”转移到了“SDK 库路径”。实际 SDK 中对应 Cortex-M33 的库目录是D:\项目\PSDK\Payload-SDK-master\psdk_lib\lib\armclang_cortex-m33图 12SDK 中实际存在 armclang_cortex-m33 库目录(这个库可以问官方拿)工程原来引用 armcc_cortex-m33就需要改为当前 SDK 实际存在并匹配 ARM Compiler 6 的 armclang_cortex-m33并确认其中存在 libpayload.lib。这一点也是本文认为官方配置需要修正的核心证据之一工程实际库目录与官方旧工具链写法并不一致。六、第四关代码编译和链接都成功了为什么 Build 还是失败前面的源码编译和链接其实全部正常完成工程已经成功生成.\Objects\mdk_app.axf因此如果 Build 最后仍然报错不要误以为是代码、链接器或者 Scatter 文件又出了问题。本次问题的根本原因是Keil 工程本身编译和链接都没有问题.axf 文件已经正常生成真正出问题的是 After Build/Rebuild 中的 fromelf 后处理命令配置不完整。原来的配置只有D:\DevTools\KeilMdk\ARM\ARMCLANG\bin\fromelf.exe虽然 fromelf.exe 的路径已经正确但命令没有指定输入文件、输出格式和输出文件。因此执行后fromelf 不知道应该转换哪个文件只能显示帮助信息。ARM image conversion utilityfromelf [options] input_fileOptions:--output file--bin...这里要特别注意看到 fromelf 输出帮助信息并不代表 fromelf.exe 损坏也不代表前面的编译或链接失败。它只是说明 After Build 调用工具时没有提供完整参数。正确的 After Build 配置进入Keil → Options for Target → User → After Build/Rebuild → Run #1。将 Run #1 完整配置为D:\DevTools\KeilMdk\ARM\ARMCLANG\bin\fromelf.exe --bin --output.\Objects\mdk_app.bin .\Objects\mdk_app.axf这条命令可以拆开理解fromelf.exe↓ 调用 ARM Compiler 6 自带的 FromELF 工具.\Objects\mdk_app.axf↓ 输入文件即 Keil 编译、链接后生成的 AXF 镜像--bin↓ 要求 FromELF 转换为 BIN 格式--output.\Objects\mdk_app.bin↓ 指定 BIN 文件的输出位置和文件名重新 Rebuild 后fromelf 就会读取 mdk_app.axf并将其转换为 mdk_app.bin。最终 Build Output 应出现类似linking...Program Size: Code679760 RO-data272404 RW-data5468 ZI-data153780FromELF: creating hex file....\Objects\mdk_app.axf - 0 Error(s), 0 Warning(s).最终在 Objects 目录下可以看到mdk_app.axfmdk_app.bin至此编译、链接和 BIN 镜像生成三个环节才算全部完成。这次问题为什么容易误判因为 Keil 的 Build 流程是连续执行的源码编译↓链接↓生成 mdk_app.axf ← 已经成功↓After Build / fromelf ← 这里失败↓生成 mdk_app.bin所以看到最后 Build 报错时第一反应不应该是继续修改源码而应该根据 Build Output 判断到底失败在哪一个阶段。如果已经出现 linking...、Program Size、mdk_app.axf那么编译和链接实际上已经成功应该重点检查 After Build 命令。本次问题最终可以概括为mdk_app.axf 已经成功生成工程本身编译和链接均正常Build 失败的根本原因是 After Build/Rebuild 中的 fromelf 命令只有可执行文件路径没有指定 AXF 输入文件、BIN 输出格式及输出文件路径。补全 fromelf 命令后即可正常生成 mdk_app.bin并最终实现 0 Error(s), 0 Warning(s)。七、最终的 After Build 命令D:\DevTools\KeilMdk\ARM\ARMCLANG\bin\fromelf.exe .\Objects\mdk_app.axf --bin --output .\PSDK_APPALIAS_V01.00.00.99.bin执行这条命令后fromelf 会读取 mdk_app.axf并输出 PSDK_APPALIAS_V01.00.00.99.bin。如果只写 fromelf.exe 而没有输入文件和参数程序会打印帮助信息但这并不代表转换成功。八、最终 Build真正跑通最终 Rebuild 输出中最关键的几行是linking...Program Size: Code679760 RO-data272404 RW-data5468 ZI-data153780FromELF: creating hex file....\Objects\mdk_app.axf - 0 Error(s), 0 Warning(s).图 14最终 Rebuild 成功0 Error(s), 0 Warning(s)这意味着整个链路已经打通·ARM Compiler 6.13.1 已被 MDK 正确识别·源码编译通过·Scatter / 内存布局正确·Payload SDK 的 armclang_cortex-m33 库正确参与链接·mdk_app.axf 成功生成·FromELF 已经使用 ARM Compiler 6.13.1 版本·最终 Build 达到 0 Error(s), 0 Warning(s)九、把整个问题压缩成一张“排错路线图”官方 E-Port V2 文档↓旧 ARMCC V5.06 配置与当前工程不匹配↓MDK 识别不到工程需要的 Compiler↓注册 ARM Compiler 6.13.1↓Scatter / IROM / IRAM 配置问题↓修正 APP / Bootloader 内存分区↓libpayload.lib 路径仍指向 armcc_cortex-m33↓改为 armclang_cortex-m33↓工程成功编译、链接↓After Build 仍调用旧 ARMCC fromelf↓改为 ARMCLANG\bin\fromelf.exe↓最终 0 Error / 0 Warning以后遇到同类 PSDK 工程建议严格按照这个顺序排查而不要一上来就修改源码。十、最终配置表项目本文实测配置MCUGD32F527ZMT7 / Cortex-M33Keil MDK5.29CompilerARM Compiler 6.13.1 / ArmclangAPP Flash 起始0x08020000APP Flash 大小0x00480000RAM 起始0x20000000RAM 大小0x00110000PSDK 库psdk_lib\lib\armclang_cortex-m33APP Scattermdk_app.sctBIN 转换工具ARMCLANG\bin\fromelf.exe最终结果0 Error(s), 0 Warning(s)十一、写在最后官方文档不是终点工程能跑才是对于 MCU / SDK 这类工程文档、工程文件、编译器版本和预编译库必须互相匹配。只看文档而不看工程本身很容易掉进“文档写了就一定能编译”的坑。很多开发者就是掉进这个坑里了。如果你也遇到类似问题最有价值的排错信息不是一句“编译失败”而是完整的 Build Output。也就是日志和反馈是相当重要的只要从第一条 error 往上看通常都能定位到是工具链、内存布局、库文件还是后处理脚本出了问题。
针对当前 E-Port V2 / GD32F527 Payload SDK 工程我要对官方开发环境说明中与实际工程不一致的部分进行修正并从“工程打不开/编译器缺失”一路排查到最终 0 Error、0 Warning。先说结论这次实测采用 Keil MDK 5.29 ARM Compiler 6.13.1Armclang配合 Payload SDK 中的 armclang_cortex-m33 库成功完成 mdk_app 工程的编译、链接和 FromELF 转换。重要说明文中 “官方文档有误” 为简略说法完整严谨描述DJI 大疆 E-Port V2 官方技术文档指定使用 ARM Compiler 5.06ARMCC V5.06工具链该要求不符合 ARM Cortex-M33 内核官方适配规范ARM 厂商已取消 ARM Compiler 5.06 对 Cortex-M33 内核的适配支持当前标准工具链为 ARM Clang 6 编译器。一、先看官方文档问题到底出在哪里DJI 官方 E-Port V2 快速开始页面仍将开发工具链写成 Armcc.exe V5.06 update 6、Armasm.exe V5.06 update 6、ArmLink.exe V5.06 update 6、FromElf.exe V5.06 update 6。但 E-Port V2 的 MCU 是 GD32F527ZMT7内核为 Cortex-M33。本文实际拿到的 Payload SDK 工程已经提供 armclang_cortex-m33 目录因此继续照搬旧的 armcc_cortex-m33 / ARMCC 配置会在现代 MDK 环境下遇到一系列连锁问题。官方文档地址https://developer.dji.com/doc/payload-sdk-tutorial/cn/payload-quick-start/quick-demo/E-Port-V2.htmldji配的开发环境配置文档https://developer.dji.com/doc/payload-sdk-tutorial/cn/payload-quick-start/config-develop-environment.html二、本文最终验证通过的环境·Keil MDK 5.29·ARM Compiler 6.13.1Armclang·GD32F527ZMT7 / Cortex-M33也就是eport-v2实际的使用的mcu·DJI Payload SDK·工程目标mdk_appBootloader 同样需要按对应内存分区配置·SDK 库目录psdk_lib\lib\armclang_cortex-m33图 2Keil/ARM Compiler 版本环境三、第一关工程要求 V6.10.1但本机显示 Missing打开 Options for Target 后最初工程要求的 Compiler 版本并不能直接使用。关键不是反复安装旧版本而是把已经安装的 ARM Compiler 6.13.1 正确注册给 MDK。图 3工程原本要求的 ARM Compiler 版本显示 Missing进入 Manage Project Items → Folders/Extensions找到 ARM Compiler Versions 管理入口。图 4Manage Project Items / Folders Extensions图 5设置默认 ARM Compiler 版本图 6ARM Compiler Versions 管理列表浏览到 MDK 的 ARMCLANG 安装目录完成注册后工程就能识别 V6.13.1。图 7浏览 ARM Compiler 目录图 8ARM Compiler 6.13.1 注册成功随后在 Target → Code Generation 中选择 Use default compiler version 6。图 9使用默认 Compiler 6四、第二关Scatter Error 与 Flash/RAM 分区编译器注册完成后下一关通常会进入链接阶段。典型报错是*** Scatter Error: no default Read/Write range selectedL6031U: Could not open scatter description file .\Objects\mdk_app.sct这个错误不是源码问题而是链接器没有得到正确的内存布局 / Scatter 文件。本文实际使用的 APP 区域从 0x08020000 开始前面的 128KB0x20000留给 Bootloader。APP 的关键内存布局为APP Flash0x08020000 ~ 0x0849FFFFAPP IROM0x08020000Size 0x00480000RAM0x20000000Size 0x00110000因此不要把 APP 的 Scatter 直接拿给 Bootloader 使用。Bootloader 与 APP 是两个不同的内存区域。图 10项目中的 APP Scatter / 内存布局图 11工程中找到 mdk_app.sct如果项目已经提供 mdk_app.sct优先使用项目文件如果使用 Target Dialog 自动生成布局则必须确保 IROM1 / IRAM1 与上述分区一致。五、第三关libpayload.lib 找不到Scatter 处理完成后工程开始真正链接又出现L6002U: Could not open file ...\psdk_lib\lib\armcc_cortex-m33\libpayload.lib这时要注意源码已经能编译问题已经从“编译器”转移到了“SDK 库路径”。实际 SDK 中对应 Cortex-M33 的库目录是D:\项目\PSDK\Payload-SDK-master\psdk_lib\lib\armclang_cortex-m33图 12SDK 中实际存在 armclang_cortex-m33 库目录(这个库可以问官方拿)工程原来引用 armcc_cortex-m33就需要改为当前 SDK 实际存在并匹配 ARM Compiler 6 的 armclang_cortex-m33并确认其中存在 libpayload.lib。这一点也是本文认为官方配置需要修正的核心证据之一工程实际库目录与官方旧工具链写法并不一致。六、第四关代码编译和链接都成功了为什么 Build 还是失败前面的源码编译和链接其实全部正常完成工程已经成功生成.\Objects\mdk_app.axf因此如果 Build 最后仍然报错不要误以为是代码、链接器或者 Scatter 文件又出了问题。本次问题的根本原因是Keil 工程本身编译和链接都没有问题.axf 文件已经正常生成真正出问题的是 After Build/Rebuild 中的 fromelf 后处理命令配置不完整。原来的配置只有D:\DevTools\KeilMdk\ARM\ARMCLANG\bin\fromelf.exe虽然 fromelf.exe 的路径已经正确但命令没有指定输入文件、输出格式和输出文件。因此执行后fromelf 不知道应该转换哪个文件只能显示帮助信息。ARM image conversion utilityfromelf [options] input_fileOptions:--output file--bin...这里要特别注意看到 fromelf 输出帮助信息并不代表 fromelf.exe 损坏也不代表前面的编译或链接失败。它只是说明 After Build 调用工具时没有提供完整参数。正确的 After Build 配置进入Keil → Options for Target → User → After Build/Rebuild → Run #1。将 Run #1 完整配置为D:\DevTools\KeilMdk\ARM\ARMCLANG\bin\fromelf.exe --bin --output.\Objects\mdk_app.bin .\Objects\mdk_app.axf这条命令可以拆开理解fromelf.exe↓ 调用 ARM Compiler 6 自带的 FromELF 工具.\Objects\mdk_app.axf↓ 输入文件即 Keil 编译、链接后生成的 AXF 镜像--bin↓ 要求 FromELF 转换为 BIN 格式--output.\Objects\mdk_app.bin↓ 指定 BIN 文件的输出位置和文件名重新 Rebuild 后fromelf 就会读取 mdk_app.axf并将其转换为 mdk_app.bin。最终 Build Output 应出现类似linking...Program Size: Code679760 RO-data272404 RW-data5468 ZI-data153780FromELF: creating hex file....\Objects\mdk_app.axf - 0 Error(s), 0 Warning(s).最终在 Objects 目录下可以看到mdk_app.axfmdk_app.bin至此编译、链接和 BIN 镜像生成三个环节才算全部完成。这次问题为什么容易误判因为 Keil 的 Build 流程是连续执行的源码编译↓链接↓生成 mdk_app.axf ← 已经成功↓After Build / fromelf ← 这里失败↓生成 mdk_app.bin所以看到最后 Build 报错时第一反应不应该是继续修改源码而应该根据 Build Output 判断到底失败在哪一个阶段。如果已经出现 linking...、Program Size、mdk_app.axf那么编译和链接实际上已经成功应该重点检查 After Build 命令。本次问题最终可以概括为mdk_app.axf 已经成功生成工程本身编译和链接均正常Build 失败的根本原因是 After Build/Rebuild 中的 fromelf 命令只有可执行文件路径没有指定 AXF 输入文件、BIN 输出格式及输出文件路径。补全 fromelf 命令后即可正常生成 mdk_app.bin并最终实现 0 Error(s), 0 Warning(s)。七、最终的 After Build 命令D:\DevTools\KeilMdk\ARM\ARMCLANG\bin\fromelf.exe .\Objects\mdk_app.axf --bin --output .\PSDK_APPALIAS_V01.00.00.99.bin执行这条命令后fromelf 会读取 mdk_app.axf并输出 PSDK_APPALIAS_V01.00.00.99.bin。如果只写 fromelf.exe 而没有输入文件和参数程序会打印帮助信息但这并不代表转换成功。八、最终 Build真正跑通最终 Rebuild 输出中最关键的几行是linking...Program Size: Code679760 RO-data272404 RW-data5468 ZI-data153780FromELF: creating hex file....\Objects\mdk_app.axf - 0 Error(s), 0 Warning(s).图 14最终 Rebuild 成功0 Error(s), 0 Warning(s)这意味着整个链路已经打通·ARM Compiler 6.13.1 已被 MDK 正确识别·源码编译通过·Scatter / 内存布局正确·Payload SDK 的 armclang_cortex-m33 库正确参与链接·mdk_app.axf 成功生成·FromELF 已经使用 ARM Compiler 6.13.1 版本·最终 Build 达到 0 Error(s), 0 Warning(s)九、把整个问题压缩成一张“排错路线图”官方 E-Port V2 文档↓旧 ARMCC V5.06 配置与当前工程不匹配↓MDK 识别不到工程需要的 Compiler↓注册 ARM Compiler 6.13.1↓Scatter / IROM / IRAM 配置问题↓修正 APP / Bootloader 内存分区↓libpayload.lib 路径仍指向 armcc_cortex-m33↓改为 armclang_cortex-m33↓工程成功编译、链接↓After Build 仍调用旧 ARMCC fromelf↓改为 ARMCLANG\bin\fromelf.exe↓最终 0 Error / 0 Warning以后遇到同类 PSDK 工程建议严格按照这个顺序排查而不要一上来就修改源码。十、最终配置表项目本文实测配置MCUGD32F527ZMT7 / Cortex-M33Keil MDK5.29CompilerARM Compiler 6.13.1 / ArmclangAPP Flash 起始0x08020000APP Flash 大小0x00480000RAM 起始0x20000000RAM 大小0x00110000PSDK 库psdk_lib\lib\armclang_cortex-m33APP Scattermdk_app.sctBIN 转换工具ARMCLANG\bin\fromelf.exe最终结果0 Error(s), 0 Warning(s)十一、写在最后官方文档不是终点工程能跑才是对于 MCU / SDK 这类工程文档、工程文件、编译器版本和预编译库必须互相匹配。只看文档而不看工程本身很容易掉进“文档写了就一定能编译”的坑。很多开发者就是掉进这个坑里了。如果你也遇到类似问题最有价值的排错信息不是一句“编译失败”而是完整的 Build Output。也就是日志和反馈是相当重要的只要从第一条 error 往上看通常都能定位到是工具链、内存布局、库文件还是后处理脚本出了问题。
)
