保姆级教程：在Ubuntu 20.04上为STM32MP157搭建A7核Linux开发环境（含SDK避坑指南）-酒店常州论坛

保姆级教程：在Ubuntu 20.04上为STM32MP157搭建A7核Linux开发环境（含SDK避坑指南）

嵌入式开发领域正经历着从传统MCU向异构计算架构的转型，STM32MP157凭借其独特的双核设计（Cortex-A7 + Cortex-M4）成为工业控制、智能家居等场景的热门选择。本文将手把手指导您在Ubuntu 20.04 LTS系统上完成A7核开发环境的完整配置，特别针对SDK安装、依赖冲突等高频问题提供经过实战验证的解决方案。

1. 环境准备与系统配置

1.1 硬件与软件基础要求

开发主机建议满足以下配置：

处理器：x86_64架构四核及以上
内存：8GB及以上（编译Linux内核时16GB更佳）
存储空间：至少150GB可用空间（实测完整环境占用约120GB）
操作系统：Ubuntu 20.04.4 LTS（推荐使用官方镜像）

关键工具链版本要求：

# 验证基础工具版本 gcc --version # 应≥9.4.0 python3 --version # 需≥3.8.10 make --version # 需≥4.2.1

1.2 系统级依赖安装

执行以下命令更新软件源并安装基础依赖包：

sudo apt update && sudo apt upgrade -y sudo apt install -y gawk wget git-core diffstat unzip texinfo \ gcc-multilib build-essential chrpath socat cpio python3 \ python3-pip python3-pexpect xz-utils debianutils iputils-ping \ python3-git python3-jinja2 libegl1-mesa libsdl1.2-dev \ pylint3 xterm libncurses5-dev libssl-dev u-boot-tools \ device-tree-compiler bison flex g++ libyaml-dev

注意：Ubuntu 20.04默认python3为3.8版本，与SDK兼容性良好，无需额外配置Python虚拟环境

2. SDK安装与配置实战

2.1 获取官方开发套件

访问ST官网下载最新SDK：
- 开发者包：STM32MP1Dev系列（当前推荐版本v4.0.0）
- 文件命名示例：en.SDK-x86_64-stm32mp1-openstlinux-6.1-yocto-mickledore-mp1-v23.06.21.tar.xz
创建标准化工作目录：

mkdir -p ~/stm32_workspace/{sdk_source,deploy} tar xvf SDK-*.tar.xz -C ~/stm32_workspace/sdk_source

2.2 解决Ubuntu 20.04特有依赖问题

针对较新系统可能出现的依赖冲突，需手动处理以下包：

问题包	解决方案	必要性
libssl1.1	添加bionic源手动安装	关键
libpython2.7	使用dead snakes PPA	可选
libmpc3	源码编译安装	推荐

具体操作：

# 处理libssl1.1依赖 echo "deb http://security.ubuntu.com/ubuntu bionic-security main" | sudo tee /etc/apt/sources.list.d/bionic-security.list sudo apt update && sudo apt install libssl1.1

2.3 执行SDK安装脚本

进入解压目录运行安装脚本：

cd ~/stm32_workspace/sdk_source ./st-image-weston-openstlinux-weston-stm32mp1-x86_64-toolchain-*.sh

安装过程中需注意：

默认安装路径为/usr/local/oecore-x86_64
遇到/bin/sh: 0: Illegal option错误时，需修改脚本首行为#!/bin/bash

3. 环境验证与故障排除

3.1 基础环境检查

加载环境变量并验证：

source /usr/local/oecore-x86_64/environment-setup-cortexa7t2hf-neon-vfpv4-ostl-linux-gnueabi # 关键验证点 echo $ARCH # 应输出arm arm-ostl-linux-gnueabi-gcc --version # 检查交叉编译器 bitbake --version # 验证Yocto工具链

常见问题处理方案：

环境变量未生效：

# 永久生效配置 echo "source /usr/local/oecore-x86_64/environment-setup-*" >> ~/.bashrc

SDK版本冲突：

# 清理旧版本 sudo rm -rf /usr/local/oecore-x86_64 # 重新安装时指定--force选项

3.2 开发板连接测试

通过USB转串口工具验证通信：

sudo apt install minicom sudo minicom -D /dev/ttyUSB0 -b 115200

正常连接时应看到启动日志输出，若出现权限问题需执行：

sudo usermod -aG dialout $USER

4. 高级配置与优化

4.1 分区表调整

修改MMC分区限制（默认8分区→16分区）：

echo 'options mmc_block perdev_minors=16' | sudo tee /etc/modprobe.d/mmc_block.conf sudo update-initramfs -u

4.2 编译性能优化

调整make参数加速构建：

# 根据CPU核心数设置并行编译 export PARALLEL_MAKE="-j $(nproc)" # 启用ccache缓存 sudo apt install ccache export CCACHE_DIR="/home/$USER/.ccache"

4.3 开发工作流建议

高效开发实践组合：

VSCode远程开发：

code --install-extension ms-vscode-remote.remote-ssh

自动化构建脚本：

#!/bin/bash source /usr/local/oecore-x86_64/environment-setup-* bitbake st-image-weston

版本控制策略：
- 使用git管理设备树修改
- 对uboot配置使用分支管理

5. 典型问题解决方案

5.1 SDK安装失败处理

现象：安装脚本执行时报Unsupported distribution错误
原因：Ubuntu 20.04的LSB信息识别问题
解决：

sudo vim /etc/os-release # 修改为： ID=ubuntu ID_LIKE=debian VERSION_ID="18.04"

5.2 内存不足编译中断

临时方案：启用swap分区

sudo fallocate -l 8G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile

5.3 设备树编译错误

常见于自定义板级支持包时，建议检查：

语法验证：
```
dtc -I dtb -O dts -o test.dts test.dtb
```

引用路径问题：

export DEVICETREE_DIR="~/stm32_workspace/linux-stm32mp/arch/arm/boot/dts"

实际项目中遇到最棘手的问题是SDK环境变量污染导致编译异常，通过创建隔离的docker开发环境彻底解决。建议重要项目使用容器化方案，可通过以下命令快速建立：

docker run -it --privileged -v $PWD:/work ubuntu:20.04

企业官网建设流程全解析