保姆级教程：Ubuntu 20.04下STM32MP157 A7核开发环境全流程配置
在嵌入式开发领域，STM32MP157凭借其独特的双核架构（Cortex-A7 + Cortex-M4）和丰富的接口资源，正成为工业控制、智能家居等场景的热门选择。但许多开发者在初次接触这款芯片时，往往会被其复杂的开发环境搭建过程劝退——尤其是当官方文档默认使用Ubuntu 18.04而你的工作机已升级到20.04时。本文将彻底解决这个痛点，带你一步步在Ubuntu 20.04上完成A7核Linux SDK的完整配置，包括那些官方文档没明说的版本适配技巧和环境验证方法。
1. 环境准备：系统配置与依赖安装
1.1 硬件与系统要求
在开始之前，请确保你的开发机满足以下条件：
- 物理机/虚拟机：建议使用物理机或基于KVM的虚拟机（VirtualBox可能存在USB兼容性问题）
- 磁盘空间：至少150GB可用空间（SDK及其编译产物会占用大量空间）
- Ubuntu版本：20.04 LTS（本文方案已针对该版本优化）
实测数据：完整安装后的空间占用情况：
SDK工具链： 12.3GB 编译中间文件： 约45GB 系统依赖包： 1.2GB1.2 关键依赖包安装
Ubuntu 20.04的软件源与18.04存在部分差异，以下是经过验证的依赖列表：
# 基础编译工具链 sudo apt-get install -y gcc-multilib build-essential chrpath socat cpio \ python3 python3-pip python3-pexpect xz-utils debianutils iputils-ping # 文档生成工具 sudo apt-get install -y xsltproc docbook-utils fop dblatex xmlto # 交叉编译相关 sudo apt-get install -y libmpc-dev libgmp-dev libssl-dev libyaml-dev \ bison flex g++ libncurses5-dev libncursesw5-dev # 嵌入式开发专用 sudo apt-get install -y u-boot-tools device-tree-compiler \ libsdl1.2-dev libegl1-mesa注意：若遇到
libssl1.1依赖问题，需手动添加18.04的源临时安装：echo "deb http://security.ubuntu.com/ubuntu bionic-security main" | sudo tee /etc/apt/sources.list.d/bionic-security.list sudo apt-get update sudo apt-get install libssl1.1
2. SDK获取与安装
2.1 获取最新开发套件
ST官方提供了三种软件包，我们选择Developer Package：
- 访问 ST官方下载页面
- 下载文件名类似
en.SDK-x86_64-stm32mp1-openstlinux-5.10-dunfell-mp1-21-11-17.tar.xz的SDK包 - 建议下载速度慢时使用axel多线程下载：
sudo apt install axel axel -n 8 https://www.st.com/.../SDK-x86_64-stm32mp1-openstlinux-5.10-dunfell-mp1-21-11-17.tar.xz
2.2 解压与安装
创建专用工作目录并解压：
mkdir -p ~/stm32_workspace/sdk cd ~/stm32_workspace/sdk tar xvf /path/to/SDK-x86_64-stm32mp1-openstlinux-*.tar.xz执行安装脚本时需添加-d参数指定安装路径（避免权限问题）：
chmod +x *.sh ./st-image-*.sh -d ~/stm32_workspace/sdk_install安装完成后关键目录结构：
sdk_install/ ├── environment-setup-cortexa7t2hf-neon-vfpv4-ostl-linux-gnueabi ├── sysroots │ ├── cortexa7t2hf-neon-vfpv4-ostl-linux-gnueabi # 目标系统根目录 │ └── x86_64-ostl_sdk-linux # 主机工具链3. 环境变量配置与永久生效
3.1 临时生效测试
首次使用前需加载环境变量：
source ~/stm32_workspace/sdk_install/environment-setup-cortexa7t2hf-neon-vfpv4-ostl-linux-gnueabi验证关键变量：
echo $ARCH # 应输出arm echo $CROSS_COMPILE # 应输出arm-ostl-linux-gnueabi-3.2 永久配置方案
为避免每次打开终端都需要手动source，推荐以下两种方案：
方案一：修改.bashrc（推荐）
echo "source $HOME/stm32_workspace/sdk_install/environment-setup-cortexa7t2hf-neon-vfpv4-ostl-linux-gnueabi" >> ~/.bashrc方案二：创建alias命令
echo "alias stm32env='source ~/stm32_workspace/sdk_install/environment-setup-*'" >> ~/.bashrc警告：不要直接在/etc/profile中配置，可能影响系统其他交叉编译环境
4. 工具链验证与实战测试
4.1 基础验证步骤
执行以下检查命令应获得类似输出：
$CC --version # arm-ostl-linux-gnueabi-gcc (GCC) 9.3.0 arm-ostl-linux-gnueabi-readelf -A /bin/bash # 应显示符合ARMv7架构的特征标记4.2 实际编译测试
创建一个简单的Hello World程序验证：
// hello.c #include <stdio.h> int main() { printf("STM32MP157 Cross-Compile Test\n"); return 0; }编译与检查：
arm-ostl-linux-gnueabi-gcc hello.c -o hello file hello # 应显示：ELF 32-bit LSB executable, ARM, EABI5 version 1 (SYSV), dynamically linked...4.3 常见问题排查表
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 编译时报GLIBC版本错误 | SDK与系统glibc不兼容 | 使用-static静态编译或升级SDK |
| 找不到交叉编译器 | 环境变量未生效 | 检查.bashrc配置路径是否正确 |
| 执行file显示x86架构 | 未使用交叉编译器 | 检查$CROSS_COMPILE变量是否设置 |
5. 高级配置与优化技巧
5.1 多版本SDK管理
当需要同时维护多个项目时，建议使用环境管理工具：
# 创建虚拟环境目录 mkdir -p ~/stm32_sdks/{v3.1,v2.0} # 使用direnv自动加载环境 echo "layout stm32 ~/stm32_sdks/v3.1" > .envrc direnv allow5.2 编译加速配置
通过ccache显著提升重复编译速度：
sudo apt install ccache echo 'export PATH="/usr/lib/ccache:$PATH"' >> ~/.bashrc echo 'export CCACHE_PREFIX="distcc"' >> ~/.bashrc5.3 内核编译专项配置
针对Linux内核编译需要额外设置：
export ARCH=arm export CROSS_COMPILE=arm-ostl-linux-gnueabi- make menuconfig # 进入配置界面前确保终端窗口足够大在项目实践中发现，Ubuntu 20.04默认的make版本（4.2.1）可能存在并行编译问题，建议通过以下方式降级：
sudo apt install make=4.1-9.1ubuntu1 sudo apt-mark hold make
的点击冲突)
