本文适用于 am335x,i.MX6,i.MX6ul,RK3288这些soc的核心板。 |
本文基于核心板的BSP Manual来写成,请点击左边核心板名称来查看该文档。
搭建编译环境
我们推荐的编译系统为ubuntu 16.04 Desktop amd64位版本,对编译系统的最低机器要求如下:
ubuntu系统的安装没有特殊要求,在安装完后,需要额外为系统安装一些软件来满足BSP的编译需求。 我们的编译环境使用的是yocto,因此编译环境的要求也是按照yocto的要求:yocto文档(老版本), yocto文档,我们这里将需要安装的软件总结如下:
|
yocto的版本请在 BSP版本、设备树、config文件对照表 / BSP version, device tree, config file cross reference table 中查找
也可以在我们BSP的releasenotes中查找,如 http://ftp.phytec.cn/AM335x/BSP-Yocto-AM335x-PD17.2.2/ReleaseNotes。
下载/编译离线BSP我们有两种BSP的下载方法
因此一般推荐使用离线编译包。
我们的下载地址为http://download.phytec.cn,你可以在这里找到以cpu名称命名的文件夹,在文件夹中,你可以看到各个版本的BSP,我们BSP版本的命名规则为: BSP-Yocto-CPU名称-PD发布年份-大版本号-小版本号 |
除此之外,我们某些CPU还可以选不同的内核,请阅读这篇:Mainline与Vendor内核 / Mainline and Vendor Kernel 来选择,如果还是不清楚请联系销售或发邮件给support@phytec.cn。
而哪个版本对应的是哪个内核,还是在 BSP版本、设备树、config文件对照表 / BSP version, device tree, config file cross reference table 这里可以查到。
在选择了想要编译的BSP版本后,可以下载对应的BSP包,这个包一般在3GB左右,命名为: BSP-Yocto-CPU名称-PD版本号.src.mirror.tar.xz 推荐直接在ubuntu系统中用wget或其他下载工具如uget等下载。
下载完成后将解压到一个目录中,推荐放在当前用户的home(~)下的文件夹中 |
以下以am335x的BSP为例:
xxx@debian8:~/bsp/BSP-Yocto-AM335x-PD16.2.0$ tree -L 2 . ├── build <-- 编译目录 │ └── conf <-- BSP的个人配置文件在这里 ├── HOWTO ├── sources <-- 所有的yocto layer在这里 │ ├── meta-openembedded <-- openembedded目录,包含很多软件 │ ├── meta-phytec <-- 我司硬件适配layer │ ├── meta-qt5 │ ├── meta-yogurt <-- 我司的参考镜像配置 │ └── poky <-- yocto核心代码 ├── src_mirror <-- 所有要编译的源码压缩包位置 │ ├── acl-2.2.52.src.tar.gz │ ├── acl-2.2.52.src.tar.gz.done ..............................此处省略 └── tools ├── init └── templateconf 12 directories, 532 files |
然后初始化环境变量,请在BSP解压缩后的文件夹中执行该指令,执行后目录会自动切换到build文件夹下:
xxx@debian8:~/bsp/temp/BSP-Yocto-AM335x-PD16.2.0$ source sources/poky/oe-init-build-env ### Shell environment set up for builds. ### You can now run 'bitbake <target>' ██████╗ ██╗ ██╗██╗ ██╗████████╗███████╗ ██████╗ ██╔══██╗██║ ██║╚██╗ ██╔╝╚══██╔══╝██╔════╝██╔════╝ ██████╔╝███████║ ╚████╔╝ ██║ █████╗ ██║ ██╔═══╝ ██╔══██║ ╚██╔╝ ██║ ██╔══╝ ██║ ██║ ██║ ██║ ██║ ██║ ███████╗╚██████╗ ╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚══════╝ ╚═════╝ Welcome to the PHYTEC BSP-Yocto buildsystem. Before building for the first time, you should take a look in the main configuration file 'conf/local.conf'. There you can tweak the build system settings and license configuration. For example you may have to accept the Freescale/NXP GPU and VPU licence for an i.MX6 board. Tested build targets for the yocto bsp are: bitbake phytec-headless-image bitbake phytec-qt5demo-image xxx@debian8:~/bsp/temp/BSP-Yocto-AM335x-PD16.2.0/build$ |
然后编辑 conf/local.conf 文件的第一行的 MACHINE 变量,它的值可以通过查看下载网站中这个压缩包位置的machines.txt来查看,如AM335x是
http://download.phytec.cn/AM335x/BSP-Yocto-AM335x-PD17.2.2/machines.txt
Supported HW ============ 在local.conf中填写的机器名 产品的订货号 配置 machines article numbers description ======== =============== =========== phyboard-regor-am335x-1 PB-01802-001.A2 PHYTEC phyBOARD-REGOR AM335x 512MiB RAM, 512MiB NAND, 8MiB SPI flash phyboard-wega-am335x-1 PB-00802-0101C, PB-00802-0200C PHYTEC phyBOARD-WEGA AM335x 256MiB RAM, 128MiB NAND flash, PEB-AV-01 |
比如AM335x的RDK开发板配的核心板是:
MACHINE ?= "phycore-am335x-1" DISTRO ?= "yogurt" ...... |
对于i.MX6平台需要在conf/local.conf文件中要取消原来的license注释(因为这些bin文件是nxp的私有程序,因此如果使用它们意味着同意nxp的相关协议。)
# License Handling # - Uncomment for i.MX6 proprietary GPU libraries LICENSE_FLAGS_WHITELIST += "license-nxp_v14-june-2016_imx-gpu-viv" (前面的#号去掉) # - Uncomment for Freescale i.MX6 legacy VPU firmware blobs LICENSE_FLAGS_WHITELIST += "license-freescale_v6-february-2015_firmware-imx" (前面的#号去掉) |
接下来就可以开始编译了,一般我们有两种image可以选
下面就可以开始编译:
编译过程根据机器的不同而不同,一般是需要12小时左右,编译完成后可以在build/deploy/机器名/下看到编译的结果: |
|
注意以上文件很多是符号链接,你可以用ls指令来查看真正的文件是哪一个,当然一般不需要这样做。 编译有可能会报各种错误总结如下:
|
Yocto 参考文档在yocto中主要是使用bitbake,请参考以下文档 https://elinux.org/Bitbake_Cheat_Sheet https://www.yoctoproject.org/docs/1.6/bitbake-user-manual/bitbake-user-manual.html https://community.nxp.com/docs/DOC-94953 离线BSP包存在的问题BSP包中有些.git文件夹中的内容是损坏的,因此不能使用git来管理,这样造成了一些麻烦。 可以先记下git的版本号,然后重新从 git.phytec.de 上clone,然后再checkout到对应的版本。 具体的git版本号可以从 https://git.phytec.de/phy2octo/ 来查找对应的BSP版本来查看。 phyLinux编译方法使用phylinux这个脚本来安装BSP,这个方法需要从很多国外的服务器下载源代码。 但由于repo工具被限制的原因,需要对phylinux这个脚本做一些修改,请按照下面的教程来修改。 phylinux 使用指南 / phylinux guide 其中某些开发板可能会用到repo工具 复位BSP编译环境在编译环境的build目录中,有以下几个目录
如果编译出现奇怪的错误,请把上面备注可删除的文件夹删除,然后再重新编译,由于已经编译了一遍,第二次会块很多。 去掉联网限制如果你需要对BSP做修改,或者增加额外的软件包,你就需要让BSP联网。修改 conf/site.conf 去掉 BB_NO_NETWORK.。该选项的存在会导致在BSP需要联网下载软件包时失败。
但有可能由于网络的限制,导致从外网下载失败,此时请使用VPN等工具来解决。 |