1. 编译环境搭建¶
本章介绍 Linux SDK 的编译环境搭建。
注意：
（1）推荐在 X86_64 Ubuntu 16.04 系统环境下进行开发，若使用其它系统版本，可能需要对编译环境做相应调整。
（2）使用普通用户进行编译，不要使用 root 用户权限进行编译。
1.1. 获取 SDK¶
首先准备一个空文件夹用于存放 SDK，建议在 home 目录下，本文以~/proj为例
不要在虚拟机共享文件夹以及非英文目录存放、解压SDK，避免产生不必要的错误
获取 SDK 需要先安装：
sudo apt update
sudo apt install -y repo git python
方法一（推荐）
Firefly_Linux_SDK 源码包比较大，可以通过如下方式获取 Firefly_Linux_SDK 源码包：下载链接
下载完成后先验证一下 MD5 码：
$ md5sum px30_linux_release_20210304.tgz
da43e8b1531819b6afae0d8de2aba8cc px30_linux_release_20210304.tgz
确认无误后，就可以解压：
# 解压
mkdir ~/proj/
cd ~/proj/
tar -zxvf path/to/px30_linux_release_20210304.tgz
# 导出数据
.repo/repo/repo sync -l
方法二
通过 repo 拉取代码，此方法对网络要求较高，有条件可以使用
可选择获取完整 SDK 或者 BSP：
mkdir ~/proj/px30_linux_release_20210304/
cd ~/proj/px30_linux_release_20210304/
## 完整 SDK
repo init --no-clone-bundle --repo-url https://gitlab.com/firefly-linux/git-repo.git -u https://gitlab.com/firefly-linux/manifests.git -b master -m px30_linux_release.xml
## BSP （ 只包含基础仓库和编译工具 ）
## BSP 包括 device/rockchip 、docs 、 kernel 、 u-boot 、 rkbin 、 tools 和交叉编译链
repo init --no-clone-bundle --repo-url https://gitlab.com/firefly-linux/git-repo.git -u https://gitlab.com/firefly-linux/manifests.git -b master -m px30_linux_bsp_release.xml
1.2. 同步代码¶
执行如下命令同步代码：
# 进入 SDK 根目录
cd ~/proj/px30_linux_release_20210304/
# 同步
.repo/repo/repo sync -c --no-tags
.repo/repo/repo start firefly --all
后续可以使用如下命令更新 SDK：
.repo/repo/repo sync -c --no-tags
因为网络环境等原因，.repo/repo/repo sync -c --no-tags 命令更新代码可能会失败，可多次反复执行。
1.3. 目录结构¶
$ tree -L 1
.
├── app
├── buildroot # Buildroot 根文件系统编译目录
├── build.sh -> device/rockchip/common/build.sh # 编译脚本
├── debian # Debian 根文件系统编译目录
├── device # 编译相关配置文件
├── distro
├── docs # 文档
├── envsetup.sh -> buildroot/build/envsetup.sh
├── external
├── kernel
├── Makefile -> buildroot/build/Makefile
├── mkfirmware.sh -> device/rockchip/common/mkfirmware.sh # 链接脚本
├── prebuilts # 交叉编译工具链
├── rkbin
├── rkflash.sh -> device/rockchip/common/rkflash.sh # 烧写脚本
├── tools # 工具目录
├── u-boot
└── yocto
1.4. 安装依赖¶
方法一：
在 PC 中自行安装环境：
sudo apt-get install repo git-core gitk git-gui gcc-arm-linux-gnueabihf u-boot-tools device-tree-compiler \
gcc-aarch64-linux-gnu mtools parted libudev-dev libusb-1.0-0-dev python-linaro-image-tools \
linaro-image-tools gcc-4.8-multilib-arm-linux-gnueabihf gcc-arm-linux-gnueabihf libssl-dev \
gcc-aarch64-linux-gnu g+conf autotools-dev libsigsegv2 m4 intltool libdrm-dev curl sed make \
binutils build-essential gcc g++ bash patch gzip bzip2 perl tar cpio python unzip rsync file bc wget \
libncurses5 libqt4-dev libglib2.0-dev libgtk2.0-dev libglade2-dev cvs git mercurial rsync openssh-client \
subversion asciidoc w3m dblatex graphviz python-matplotlib libc6:i386 libssl-dev texinfo \
liblz4-tool genext2fs lib32stdc++6 expect
方法二：使用 Docker
使用 dockerfile 创建容器，在容器中进行编译，完美解决编译环境问题，并且与主机环境隔离，互不影响。
首先在主机中安装 docker，请参考：安装教程
创建一个目录作为 docker 工作目录，例如~/docker/，在其中创建文件dockerfile，内容如下：
FROM ubuntu:18.04
MAINTAINER firefly "service@t-firefly.com"
ENV DEBIAN_FRONTEND=noninteractive
RUN cp -a /etc/apt/sources.list /etc/apt/sources.list.bak
RUN sed -i 's@http://.*ubuntu.com@http://repo.huaweicloud.com@g' /etc/apt/sources.list
RUN apt update
RUN apt install -y build-essential crossbuild-essential-arm64 \
bash-completion vim sudo locales time rsync bc python
RUN apt install -y repo git ssh libssl-dev liblz4-tool lib32stdc++6 \
expect patchelf chrpath gawk texinfo diffstat binfmt-support \
qemu-user-static live-build bison flex fakeroot cmake \
unzip device-tree-compiler python-pip ncurses-dev python-pyelftools \
subversion asciidoc w3m dblatex graphviz python-matplotlib cpio \
libparse-yapp-perl default-jre patchutils swig expect-dev u-boot-tools
RUN apt update && apt install -y -f
# language support
RUN locale-gen en_US.UTF-8
ENV LANG en_US.UTF-8
# switch to a no-root user
RUN useradd -c 'firefly user' -m -d /home/firefly -s /bin/bash firefly
RUN sed -i -e '/\%sudo/ c \%sudo ALL=(ALL) NOPASSWD: ALL' /etc/sudoers
RUN usermod -a -G sudo firefly
USER firefly
WORKDIR /home/firefly
创建镜像
cd ~/docker
docker build -t sdkcompiler .
# sdkcompiler 是镜像名称，可随意更改，注意命令最后有一个‘.’
# 此过程需要一段时间，请耐心等待
镜像创建完毕后，创建容器并启动
# 此处将主机内 SDK 所在文件夹挂载到容器内，这样容器内就能访问主机中的 SDK 了
# source= 填 SDK 所在目录；target= 填容器内的一个目录，必须是空目录
# ubuntu18 是容器名，firefly 是容器 hostname，均可随意更改
# sdkcompiler 是上一步的镜像名
docker run --privileged --mount type=bind,source=/home/fierfly/proj,target=/home/firefly/proj --name="ubuntu18" -h firefly -it sdkcompiler
现在就可以在容器中进行 SDK 的编译了。
退出容器、重启容器的方法：
# 在容器内输入 exit 即可退出
# 查看所有容器（包括已退出的）
docker ps -a
# 重启一个退出的容器并连接
docker start ubuntu18 # 容器名
docker attach ubuntu18