本 SDK 開發(fā)環(huán)境是在 Ubuntu 上開發(fā)測試的。我們推薦使用 Ubuntu 16.04 的系統(tǒng)進(jìn)行編譯。其他的 Linux 版本可能需要對軟件包做相應(yīng)調(diào)整。 除了系統(tǒng)要求外,還有其他軟硬件方面的要求。
64 位系統(tǒng),硬盤空間大于 40G。如果您進(jìn)行多個(gè)構(gòu)建,將需要更大的硬盤空間。
- Ubuntu 14.04 軟件包安裝:
$ sudo apt-get install git gnupg flex bison gperf build-essential \ zip tar curl libc6-dev libncurses5-dev:i386 x11proto-core-dev \ libx11-dev:i386 libreadline6-dev:i386 libgl1-mesa-glx:i386 \ libgl1-mesa-dev g++-multilib mingw32 cmake tofrodos \ python-markdown libxml2-utils xsltproc zlib1g-dev:i386 lzop lib32stdc++6 $ sudo ln -s /usr/lib/i386-linux-gnu/mesa/libGL.so.1 /usr/lib/i386-linux-gnu/libGL.so
- Ubuntu 16.04 軟件包安裝
sudo apt-get install git gcc-arm-linux-gnueabihf u-boot-tools device-tree-compiler mtools \ parted libudev-dev libusb-1.0-0-dev python-linaro-image-tools linaro-image-tools libssl-dev \ autotools-dev libsigsegv2 m4 libdrm-dev curl sed make binutils build-essential gcc g++ bash \ patch gzip bzip2 perl tar cpio python unzip rsync file bc wget libncurses5 libglib2.0-dev openssh-client lib32stdc++6
- 安裝 ARM 交叉編譯工具鏈和編譯內(nèi)核相關(guān)軟件包
$ sudo apt-get install gcc-arm-linux-gnueabihf \ gcc-aarch64-linux-gnu device-tree-compiler lzop libncurses5-dev \ libssl1.0.0 libssl-dev
提供兩種方式給用戶下載:1:Github上同步SDK;2:下載源碼包(推薦國內(nèi)用戶使用)
Github上同步SDK
- 下載repo工具:
git clone https://github.com/FireflyTeam/repo.git
- 初始化倉庫:
repo init --repo-url https://github.com/FireflyTeam/repo.git -u https://github.com/FireflyTeam/manifests.git -b linux-sdk -m rk3288/rk3288_linux_release.xml
下載源碼包(推薦國內(nèi)用戶使用)
- 下載repo工具:
mkdir linux cd linux git clone https://github.com/FireflyTeam/repo.git
- 下載鏈接:Linux-SDK GPT源碼包
- 解壓文件:7z x linux-sdk-3288.7z
注意:解壓完之后,用戶可能會(huì)疑惑看不到文件。在linux/目錄運(yùn)行ls -a
命令,有.repo
/目錄,這是我們的倉庫。
repo sync -c
注意:從Github上同步SDK時(shí),部分國內(nèi)用戶會(huì)有不穩(wěn)定的現(xiàn)象,這就需要多次運(yùn)行同步命令repo sync -c
才可以
目錄
$ tree -L 1 . ├── app ├── buildroot buildroot根文件系統(tǒng)的編譯目錄 ├── build.sh -> device/rockchip/common/build.sh 全自動(dòng)編譯腳本 ├── device ├── distro ├── docs 開發(fā)文檔 ├── envsetup.sh -> buildroot/build/envsetup.sh ├── external ├── kernel 內(nèi)核 ├── Makefile -> buildroot/build/Makefile ├── mkfirmware.sh -> device/rockchip/common/mkfirmware.sh 打包腳本 ├── prebuilts ├── rkbin ├── rkflash.sh -> device/rockchip/common/rkflash.sh 燒寫腳本 ├── rootfs ├── tools └── u-boot
在device/rockchip/rk3288/目錄下,選擇對應(yīng)的板型的配置文件
本文例子:確定選用rk3288/firefly-rk3288.mk
firefly-rk3288.mk 相關(guān)配置介紹:
# Target arch export RK_ARCH=arm 32位ARM架構(gòu) # Uboot defconfig export RK_UBOOT_DEFCONFIG=firefly-rk3288 u-boot配置文件 # Kernel defconfig export RK_KERNEL_DEFCONFIG=firefly_linux_defconfig kernel配置文件 # Kernel dts export RK_KERNEL_DTS=rk3288-firefly dts文件 # parameter for GPT table export RK_PARAMETER=parameter-ubuntu.txt 分區(qū)表(關(guān)鍵) # rootfs image path export RK_ROOTFS_IMG=buildroot/output/$RK_CFG_BUILDROOT/images/rootfs.$RK_ROOTFS_TYPE 根文件系統(tǒng)路徑
重點(diǎn):
配置Rootfs
源碼中默認(rèn)的Linux rootfs是buildroot,如果rootfs使用buildroot,跳過此步,如果用戶需要使用Ubuntu,需要通過以下步驟來配置:
1、 下載根文件系統(tǒng):ubuntu16.04 根文件系統(tǒng)(32位),放到SDK路徑下;
2、 該文件為7z壓縮包,解壓該文件;
7z x ubuntu1604armhf-rootfs.7z
3、 完成上述后,得到ubuntu1604armhf-rootfs.img(2.6G),拷貝根文件系統(tǒng)到rootfs目錄下;
cp ubuntu1604armhf-rootfs.img rootfs/
4、 在device/rockchip/rk3288/firefly-rk3288.mk中, 將“# rootfs image path”修改為:
export RK_ROOTFS_IMG=rootfs/ubuntu1604armhf-rootfs.img
配置板型
根據(jù)各個(gè)板型和配件的差別,內(nèi)核中使用的DTS也有差別,如果是標(biāo)配板型,跳過此步,如果板型有VGA或者LCD等支持,需要在.BoardConfig.mk中做對應(yīng)的修改。
- Firefly-rk3288
# 標(biāo)配: export RK_KERNEL_DTS=rk3288-firefly # 帶VGA: export RK_KERNEL_DTS=rk3288-firefly-vga
- AIO-3288C
# 標(biāo)配: export RK_KERNEL_DTS=rk3288-firefly-aioc # 帶VGA: export RK_KERNEL_DTS=rk3288-firefly-aioc-vga # LVDS(HSX101H40C): export RK_KERNEL_DTS=rk3288-firefly-aioc-lvds
- AIO-3288J
# 標(biāo)配: export RK_KERNEL_DTS=rk3288-firefly-aio # LVDS(HSX101H40C): export RK_KERNEL_DTS=rk3288-firefly-aio-lvds
編譯配置文件:
./build.sh firefly-rk3288.mk
運(yùn)行完上述腳本后,在device/rockchip/目錄下,生成.BoardConfig.mk 軟鏈接 device/rockchip/rk3288/firefly-rk3288.mk
完全編譯運(yùn)行如下命令,包含 kernel 、uboot、buildroot、recovery。 如果用戶使用buildroot
,可以使用完全編譯。如果用戶使用Ubuntu
系統(tǒng),則不需要使用完全編譯。
./build.sh
注意:該腳本默認(rèn)編譯buildroot
根文件系統(tǒng),若用戶需要用的根文件系統(tǒng)是Debian
或者Ubuntu16.04
時(shí),請!先!將!對應(yīng)的根文件系統(tǒng)準(zhǔn)備好,不然在執(zhí)行該build.sh腳本時(shí),會(huì)在整理分區(qū)鏡像、打包固件時(shí)出錯(cuò),這部分操作在以下的“部分編譯”中“編譯rootfs”有詳細(xì)說明,按照操作執(zhí)行即可!
build.sh腳本運(yùn)行完成后,會(huì)將分區(qū)鏡像和統(tǒng)一固件update.img放在rockdev/目錄下,同時(shí)創(chuàng)建IMAGE/目錄備份。
編譯u-boot:
./build.sh uboot
編譯kernel:
./build.sh kernel
編譯rootfs:
本SDK支持三種根文件系統(tǒng),分別是buildroot、Debian、Ubuntu;
- Buildroot
編譯 Buildroot 環(huán)境搭建所依賴的軟件包安裝命令如下:
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 \ autoconf 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
搭建環(huán)境完成后,編譯buildroot,執(zhí)行如下命令:
./build.sh rootfs
- Debian
編譯 Debian 環(huán)境搭建所依賴的軟件包安裝命令如下:
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
搭建環(huán)境完成后,編譯Debian,按照自身需求,執(zhí)行如下命令:
cd rootfs/ ## Usage for 32bit Debian Building a base debian system by ubuntu-build-service from linaro. sudo apt-get install binfmt-support qemu-user-static sudo dpkg -i ubuntu-build-service/packages/* sudo apt-get install -f RELEASE=stretch TARGET=desktop ARCH=armhf ./mk-base-debian.sh Building the rk-debain rootfs with debug: VERSION=debug ARCH=armhf ./mk-rootfs-stretch.sh Creating the ext4 image(linaro-rootfs.img): ./mk-image.sh ----------------------------------------------------------------- ## Usage for 64bit Debian Building a base debian system by ubuntu-build-service from linaro. sudo apt-get install binfmt-support qemu-user-static sudo dpkg -i ubuntu-build-service/packages/* sudo apt-get install -f RELEASE=stretch TARGET=desktop ARCH=arm64 ./mk-base-debian.sh Building the rk-debain rootfs with debug: VERSION=debug ARCH=arm64 ./mk-rootfs-stretch-arm64.sh Creating the ext4 image(linaro-rootfs.img): ./mk-image.sh
完成上述后,會(huì)在rootfs目錄下,生成linaro-rootfs.img.修改device/rockchip/.BoardConfig.mk中的根文件系統(tǒng)路徑即可,參考配置前編譯中的“配置Rootfs”.
- Ubuntu16.04
1、 下載根文件系統(tǒng):ubuntu16.04 根文件系統(tǒng)(32位),放到SDK路徑下;
2、 該文件為7z壓縮包,解壓該文件;
7z x ubuntu1604armhf-rootfs.7z
3、 完成上述后,得到ubuntu1604armhf-rootfs.img(2.6G),拷貝根文件系統(tǒng)到rootfs目錄下;
cp ubuntu1604armhf-rootfs.img rootfs/
補(bǔ)充說明:
./build.sh --help ====USAGE: build.sh modules==== uboot -build uboot kernel -build kernel rootfs -build default rootfs, currently build buildroot as default buildroot -build buildroot rootfs yocto -build yocto rootfs, currently build ros as default ros -build ros rootfs debian -build debian rootfs pcba -build pcba recovery -build recovery all -build uboot, kernel, rootfs, recovery image cleanall -clean uboot, kernel, rootfs, recovery firmware -pack all the image we need to boot up system updateimg -pack update image sdbootimg -pack sdboot image save -save images, patches, commands used to debug default -build all modules BoardConfig -select the corresponding BoardConfig.mk file
recovery
分區(qū)在Ubuntu系統(tǒng)中不會(huì)用到,若有需要,可運(yùn)行如下命令:
./build.sh recovery
parameter.txt文件中包含了固件的重要信息,如以rk3288為例: 路徑:device/rockchip/rk3288/parameter-ubuntu.txt
FIRMWARE_VER: 8.1 固件版本 MACHINE_MODEL:rk3288 固件板型 MACHINE_ID:007 MANUFACTURER:RK3288 MAGIC: 0x5041524B ATAG: 0x00200800 MACHINE: 3288 CHECK_MASK: 0x80 PWR_HLD: 0,0,A,0,1 TYPE: GPT 分區(qū)類型 CMDLINE: mtdparts=rk29xxnand:0x00002000@0x00004000(uboot),0x00002000@0x00006000(trust),0x00010000@0x0000a000(boot),0x00010000@0x0002a000(backup),-@0x0005a000(rootfs:grow) uuid:rootfs=614e0000-0000-4b53-8000-1d28000054a9
CMDLINE屬性是我們關(guān)注的地方,以uboot為例 0x00002000@0x00004000(uboot)中0x00004000為uboot分區(qū)的起始位置0x00002000為分區(qū)的大小,后面相同,用戶可以根據(jù)自己需要增減或者修改分區(qū)信息,但是請最少保留uboot,trust,boot,rootfs分區(qū),這是機(jī)器能正常啟動(dòng)的前提條件。
- 分區(qū)介紹:
uboot 分區(qū): uboot編譯出來的 uboot.img. trust 分區(qū): uboot編譯出來的 trust.img misc 分區(qū): misc.img開機(jī)檢測進(jìn)入recovery模式.(可省略) boot 分區(qū): 編譯出來的 boot.img包含kernel和設(shè)備樹信息. recovery 分區(qū): 燒寫 recovery.img.(可省略) backup 分區(qū): 預(yù)留,暫時(shí)沒有用。后續(xù)跟 android 一樣作為 recovery 的 backup 使用. oem 分區(qū): 給廠家使用,存放廠家的 app 或數(shù)據(jù),只讀,代替原來音箱的 data 分區(qū),掛載在/oem 目錄.(可省略) rootfs 分區(qū): 存放 buildroot 或者 debian 編出來的rootfs.img只讀. userdata 分區(qū): 存放app臨時(shí)生成的文件或者是給最終用戶使用??勺x寫,掛載在/userdata目錄下.(可省略)
在parameter.txt文件中,僅僅保留了5個(gè)不可缺少的分區(qū)。
注意:若發(fā)現(xiàn)根文件分區(qū)大小異常時(shí),執(zhí)行如下命令:
resize2fs /dev/mmcblk2p5
package-file文件用于打包統(tǒng)一固件時(shí)確定需要的分區(qū)鏡像和鏡像路徑,同時(shí)它需要與parameter.txt文件保持一致。 路徑tools/linux/Linux_Pack_Firmware/rockdev/目錄下,以package-file為例:
# NAME Relative path # #HWDEF HWDEF package-file package-file bootloader Image/MiniLoaderAll.bin parameter Image/parameter.txt trust Image/trust.img uboot Image/uboot.img boot Image/boot.img rootfs:grow Image/rootfs.img backup RESERVED
- 整理分區(qū)鏡像到rockdev/目錄下
./mkfirmware.sh
提示:在運(yùn)行./mkfirmware時(shí),可能會(huì)遇到如下報(bào)錯(cuò):
error: /home/ljh/proj/linux-sdk/buildroot/output/rockchip_rk3288_recovery/images/recovery.img not found!
表示recovery分區(qū)沒有找到,類似的如oem.img、userdata.img,上文提到,這些屬于可省略分區(qū)鏡像,可以不用理會(huì)。
- 整合統(tǒng)一固件
./build.sh updateimg
注意:每次打包固件前,需要運(yùn)行mkfirmware.sh腳本更新rockdev/下的分區(qū)鏡像
- Windows:AndroidTool_v2.58
- Linux:Upgrade_tool1.34
下載 AndroidTool.rar后,解壓,運(yùn)行里面的 AndroidTool.exe(注意,如果是 Windows 7/8,需要按鼠標(biāo)右鍵,選擇以管 理員身份運(yùn)行),如下圖:
前提:設(shè)備燒寫固件或分區(qū)鏡像時(shí),需處于Loader模式或Maskrom模式,參考設(shè)備模式
燒寫統(tǒng)一固件 update.img
燒寫統(tǒng)一固件 update.img 的步驟如下:
- 切換至”升級固件”頁。
- 按”固件”按鈕,打開要升級的固件文件。升級工具會(huì)顯示詳細(xì)的固件信息
- 按”升級”按鈕開始升級。
- 如果升級失敗,可以嘗試先按”擦除Flash”按鈕來擦除 Flash,然后再升級。
注意:如果你燒寫的固件loader版本與原來的機(jī)器的不一致,請?jiān)谏壒碳跋葓?zhí)行”擦除Flash”。
燒寫分區(qū)映像
燒寫分區(qū)映像時(shí),請使用對應(yīng)SDK下的FFTools/AndroidTool.rar燒寫。步驟如下:
- 切換至”下載鏡像”頁。
- 勾選需要燒錄的分區(qū),可以多選。
- 確保映像文件的路徑正確,需要的話,點(diǎn)路徑右邊的空白表格單元格來重新選擇。
- 點(diǎn)擊”執(zhí)行”按鈕開始升級,升級結(jié)束后設(shè)備會(huì)自動(dòng)重啟。
下載Upgrade_tool1.34.zip后,解壓,將upgrade_tool拷貝到/usr/local/bin/目錄下,操作如下:
unzip Linux_Upgrade_Tool_v1.34.zip cd Linux_Upgrade_Tool sudo mv upgrade_tool /usr/local/bin sudo chown root:root /usr/local/bin/upgrade_tool
統(tǒng)一固件燒寫
- 使用upgrade_tool工具燒寫:
sudo upgrade_tool uf update.img
- 使用SDK腳本燒寫:
./rkflash.sh firmware
分區(qū)鏡像燒寫
- 使用upgrade_tool工具燒寫:
sudo upgrade_tool ul $LOADER sudo upgrade_tool di -p $PARAMETER sudo upgrade_tool di -uboot $UBOOT sudo upgrade_tool di -trust $TRUST sudo upgrade_tool di -b $BOOT sudo upgrade_tool di -rootfs $ROOTFS
- 使用SDK腳本燒寫:
#全自動(dòng)燒寫 ./rkflash.sh #分區(qū)鏡像燒寫 ./rkflash.sh loader ./rkflash.sh parameter ./rkflash.sh uboot ./rkflash.sh trust ./rkflash.sh boot ./rkflash.sh rootfs
說明:rkflash.sh該腳本文件的原理便是使用upgrade_tool工具燒寫
-
嵌入式主板
+關(guān)注
關(guān)注
7文章
6085瀏覽量
35214 -
安卓
+關(guān)注
關(guān)注
5文章
2120瀏覽量
57023 -
Firefly
+關(guān)注
關(guān)注
2文章
538瀏覽量
6986
發(fā)布評論請先 登錄
相關(guān)推薦
評論