EdgeTX在Ubuntu 20.04上的编译问题分析与解决方案

问题背景

EdgeTX是一款开源的遥控器固件项目，支持多种硬件平台。在Ubuntu 20.04系统上编译EdgeTX时，开发者可能会遇到各种构建问题。本文将详细分析这些问题的成因，并提供完整的解决方案。

主要问题分析

在Ubuntu 20.04上编译EdgeTX时，主要会遇到以下几类问题：

1. 工具链版本不匹配：EdgeTX对GNU Arm Embedded Toolchain有特定版本要求（14.2.rel1），使用其他版本会导致编译失败。

2. CMake版本过低：Ubuntu 20.04默认安装的CMake 3.16版本不支持cmake_path命令，导致配置阶段失败。

3. Python依赖缺失：构建过程中需要多个Python模块（如Pillow、jinja2等），这些模块未安装会导致构建中断。

4. 构建命令使用不当：直接运行make命令而不指定目标会导致构建不完整。

详细解决方案

1. 系统环境准备

首先需要确保系统满足基本要求：

sudo apt update
sudo apt upgrade

2. 安装正确版本的GNU Arm工具链

EdgeTX要求使用特定版本的Arm工具链：

wget https://developer.arm.com/-/media/Files/downloads/gnu/14.2.rel1/binrel/arm-gnu-toolchain-14.2.rel1-x86_64-arm-none-eabi.tar.xz
sudo tar -xJf arm-gnu-toolchain-14.2.rel1-x86_64-arm-none-eabi.tar.xz -C /opt

3. 升级CMake版本

Ubuntu 20.04默认的CMake版本过低，需要手动升级：

wget https://github.com/Kitware/CMake/releases/download/v4.0.1/cmake-4.0.1-Linux-x86_64.tar.gz
tar -xzf cmake-4.0.1-Linux-x86_64.tar.gz
sudo mv cmake-4.0.1-Linux-x86_64 /opt/cmake-4.0.1
sudo ln -sf /opt/cmake-4.0.1/bin/* /usr/local/bin/

4. 安装Python依赖

构建过程需要以下Python模块：

pip3 install clang jinja2 lz4 pillow

5. 正确构建EdgeTX

完整的构建流程如下：

git clone --recursive -b main https://github.com/EdgeTX/edgetx.git
cd edgetx
mkdir build
cd build
cmake -DARM_TOOLCHAIN_DIR=/opt/gcc-arm-none-eabi/bin \
      -DPCB=X10 \
      -DPCBREV=TX16S \
      -DDEFAULT_MODE=2 \
      -DGVARS=YES \
      -DPPM_UNIT=US \
      -DLUA_MIXER=YES \
      -DCMAKE_BUILD_TYPE=Debug ../
make configure
make -j$(nproc) firmware

构建完成后，固件和bootloader文件将分别位于：

• build/arm-none-eabi/firmware.elf
• build/arm-none-eabi/radio/src/targets/common/arm/stm32/bootloader/bootloader.elf

注意事项

1. 硬件平台限制：EdgeTX项目已不再接受基于STM32F4系列MCU的新硬件设计，仅支持现有合作伙伴的已知设备。

2. Qt版本要求：如果需要构建Companion或模拟器，Qt版本需要升级到5.15.2。

3. 构建目标选择：直接运行make命令不会构建完整固件，必须明确指定目标（如firmware）。

通过以上步骤，开发者应该能够在Ubuntu 20.04系统上成功构建EdgeTX固件。如果在构建过程中遇到其他问题，建议检查构建日志中的具体错误信息，并确保所有依赖项都已正确安装。