Difference between revisions of "How to build FriendlyWrt/zh"

From FriendlyELEC WiKi
Jump to: navigation, search
(updated by API)
Line 1: Line 1:
−
[[Buildroot for RK3399|English]]
+
[[How to build FriendlyWrt|English]]
−
 
+
−
==Buildroot简介==
+
−
{{RK3399 Buildroot Intro/zh}}
+
  
 +
==FriendlyWrt简介==
 +
FriendlyWrt是友善电子基于OpenWrt定制的系统，完全开源，用于企业物联网二次开发，个人定制NAS，家庭物联网网关等。
 +
TODO <br />
 
==下载体验版固件==
 
==下载体验版固件==
−
访问[http://download.friendlyarm.com/nanopct4 此处的下载地址]下载:<br />
+
TODO <br />
−
{| class="wikitable"
+
−
|-
+
−
  | colspan=2 | Image Files
+
−
|-
+
−
  | rk3399-sd-buildroot-linux-4.4-arm64-YYYYMMDD.img.zip
+
−
  | 从SD卡启动的固件
+
−
|-
+
−
  | rk3399-eflasher-buildroot-YYYYMMDD.img.zip
+
−
  | 用于烧写到eMMC运行
+
−
|}
+
 
解压后用 dd 或者 win32image 烧写到 SD 卡。
 
解压后用 dd 或者 win32image 烧写到 SD 卡。
 
==帐户与密码==
 
==帐户与密码==
 
用户名: root<br />
 
用户名: root<br />
−
密码: rockchip<br />
+
密码: fa<br />
 
<br />
 
<br />
 
==获取项目源代码==
 
==获取项目源代码==
Line 31: Line 21:
 
有以下两种途径获取项目源代码，中国大陆用户建议使用方法1的途径下载:
 
有以下两种途径获取项目源代码，中国大陆用户建议使用方法1的途径下载:
 
====方法一：使用网盘里的repo压缩包====
 
====方法一：使用网盘里的repo压缩包====
−
网盘下载地址: [http://download.friendlyarm.com/{{#replace:{{#replace:{{BASEPAGENAME}}| |}}|/zh|}} 点击进入]<br />
+
网盘下载地址: [http://download.friendlyarm.com/nanopineo 点击进入]<br />
−
文件位于网盘的以下路径：sources/linuxsdk-friendlyelec-YYYYMMDD.tar (YYYYMMDD表示打包的日期)<br />
+
文件位于网盘的以下路径：sources/friendlywrt-YYYYMMDD.tar (YYYYMMDD表示打包的日期)<br />
 
从网盘中获取的 repo 压缩包在解压之后，需要执行一下以下命令做一次解包动作：
 
从网盘中获取的 repo 压缩包在解压之后，需要执行一下以下命令做一次解包动作：
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
−
tar xvf /path/to/netdisk/sources/linuxsdk-friendlyelec-YYYYMMDD.tar
+
tar xvf /path/to/netdisk/sources/friendlywrt-YYYYMMDD.tar
−
cd linuxsdk-friendlyelec
+
cd friendlywrt
−
repo sync -l
+
repo sync -l --no-clone-bundle
 
</syntaxhighlight>
 
</syntaxhighlight>
 
用此方法得到的源代码版本是repo打包时的版本，如果想拉取到官方最新的版本，可以去掉 -l 参数，执行一次 repo sync, 例如：
 
用此方法得到的源代码版本是repo打包时的版本，如果想拉取到官方最新的版本，可以去掉 -l 参数，执行一次 repo sync, 例如：
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
−
cd linuxsdk-friendlyelec
+
cd friendlywrt
−
repo sync
+
repo sync --no-clone-bundle
 
</syntaxhighlight>
 
</syntaxhighlight>
 
====方法二：从github下载====
 
====方法二：从github下载====
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
−
mkdir linuxsdk-friendlyelec
+
mkdir friendlywrt
−
cd linuxsdk-friendlyelec
+
cd friendlywrt
−
repo init -u https://github.com/friendlyarm/buildroot_manifests -b master -m rk3399_linux_release.xml --repo-url=https://github.com/rockchip-linux/repo
+
repo init -u https://github.com/friendlyarm/friendlywrt_manifests -b master -m h3.xml --repo-url=https://github.com/friendlyarm/repo --no-clone-bundle
−
repo sync -c
+
repo sync -c --no-clone-bundle
 
</syntaxhighlight>
 
</syntaxhighlight>
 
====同步项目到最新版本====
 
====同步项目到最新版本====
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
−
cd linuxsdk-friendlyelec
+
cd friendlywrt
−
repo sync -c
+
repo sync -c --no-clone-bundle
 
</syntaxhighlight>
 
</syntaxhighlight>
 
同步过程中,由于网络原因出现中断,可以使用下面脚本同步代码:
 
同步过程中,由于网络原因出现中断,可以使用下面脚本同步代码:
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
 
#! /bin/bash
 
#! /bin/bash
−
repo sync -c
+
repo sync -c --no-clone-bundle
 
while [ $? -ne 0 ];  
 
while [ $? -ne 0 ];  
 
do   
 
do   
−
     repo sync -c
+
     repo sync -c --no-clone-bundle
 
done
 
done
 
</syntaxhighlight>
 
</syntaxhighlight>
Line 68: Line 58:
 
==如何编译==
 
==如何编译==
 
===搭建编译环境===
 
===搭建编译环境===
−
在PC的Ubuntu系统下，执下以下命令安装所需的软件：
+
在PC的Ubuntu系统下 (建议使用版本18.04-64bit)，执下以下命令安装所需的软件：
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
−
sudo apt-get install repo git-core gitk git-gui gcc-arm-linux-gnueabihf u-boot-tools device-tree-
+
wget -O - https://raw.githubusercontent.com/friendlyarm/build-env-on-ubuntu-bionic/master/install.sh | bash
−
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 lib32stdc++6
+
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 +
===查看帮助===
 +
不带参数执行 build.sh，默认是打印帮助信息:
 +
<syntaxhighlight lang="bash">
 +
./build.sh
 +
</syntaxhighlight>
 +
显示的帮助信息如下：
 +
<syntaxhighlight lang="bash">
 +
USAGE: ./build.sh <parameter>
 +
 +
# 选择目标的硬件平台:
 +
  ./build.sh nanopi_r1.mk
 +
  ./build.sh nanopi_duo.mk
 +
  ./build.sh nanopi_neo_core.mk
 +
  ./build.sh nanopi_neo.mk
 +
  ./build.sh nanopi_neo_s.mk
 +
  ./build.sh nanopi_m1_plus.mk
 +
  ./build.sh nanopi_m1.mk
 +
  ./build.sh nanopi_neo_air.mk
 +
 +
# 编译各个模块:
 +
  ./build.sh all                -编译所有组件
 +
  ./build.sh uboot              -单独编译uboot
 +
  ./build.sh kernel            -单独编译kernel
 +
  ./build.sh friendlywrt        -单独编译friendlywrt
 +
  ./build.sh sd-img            -生成sd启动的镜像文件
 +
  ./build.sh emmc-img          -生成用于安装到emmc的镜像文件 (镜像文件需要dd到sd卡，通过sd卡启动安装程序)
 +
# 清理：
 +
  ./build.sh cleanall
 +
</syntaxhighlight>
 
===全自动方式编译===
 
===全自动方式编译===
 +
初次编译，需要选择目标的硬件平台，当前只有H3可用，后续会加入更多的硬件支持：
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
−
./build.sh
+
./build.sh nanopi_r1.mk
 
</syntaxhighlight>
 
</syntaxhighlight>
−
===部分编译===
+
执行上述命令，会自动编译所有组件，其中包括u-boot, kernel 和 friendlywrt，并生成sd启动的烧写镜像文件。
 +
===编译单独的模块===
 
====kernel====
 
====kernel====
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
Line 92: Line 107:
 
./build.sh uboot
 
./build.sh uboot
 
</syntaxhighlight>
 
</syntaxhighlight>
−
====rootfs====
+
====friendlywrt====
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
−
./build.sh rootfs
+
./build.sh friendlywrt
 
</syntaxhighlight>
 
</syntaxhighlight>
 
===生成sdcard固件===
 
===生成sdcard固件===
Line 100: Line 115:
 
sudo ./build.sh sd-img
 
sudo ./build.sh sd-img
 
</syntaxhighlight>
 
</syntaxhighlight>
−
或者直接将固件烧写到sd卡:
+
打包img成功后，终端会显示如下信息，可以参考下面的dd命令将img写入sd卡，注意/dev/sdX需要替换成真实的sd卡设备：<br />
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
−
./friendlyelec/rk3399/sd-fuse_rk3399/fusing.sh /dev/sdX buildroot
+
Run the following for sdcard install:
 +
    sudo dd if=out/FriendlyWrt_20190828_NanoPi-R1_armhf_sd.img bs=1M of=/dev/sdX
 
</syntaxhighlight>
 
</syntaxhighlight>
−
其中，/dev/sdX请替换为真实的SD卡设备文件名。
 
 
===生成emmc (eflasher) 固件===
 
===生成emmc (eflasher) 固件===
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
 
sudo ./build.sh emmc-img
 
sudo ./build.sh emmc-img
 
</syntaxhighlight>
 
</syntaxhighlight>
−
 
+
打包img成功后，终端会显示如下信息，可以参考下面的dd命令将img写入sd卡，注意/dev/sdX需要替换成真实的sd卡设备：<br />
−
===查看帮助===
+
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
−
# ./build.sh help
+
Run the following for sdcard install:
−
====USAGE: build.sh modules====
+
    sudo dd if=out/FriendlyWrt_20190828_NanoPi-R1_armhf_eflasher.img bs=1M of=/dev/sdX
−
uboot              -build uboot
+
−
kernel            -build kernel
+
−
rootfs            -build default rootfs, currently build buildroot as default
+
−
buildroot          -build buildroot rootfs
+
−
ramboot            -build ramboot image
+
−
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
+
−
sd-img            -pack sd-card image, used to create bootable SD card
+
−
emmc-img          -pack sd-card image, used to install buildroot to emmc
+
−
save              -save images, patches, commands used to debug
+
−
default            -build all module
+
 
</syntaxhighlight>
 
</syntaxhighlight>
−
重点参数说明：<br />
+
用此sd卡启动eflasher系统，执行eflasher命令，将系统写入emmc，之后就可以拨掉sd卡，从emmc启动friendlywrt了。
−
uboot              -单独编译uboot<br />
+
==friendlywrt定制与开发==
−
kernel            -单独编译kernel<br />
+
===源代码目录结构===
−
rootfs            -单独编译buildroot<br />
+
−
buildroot          -同上<br />
+
−
sdimg              -生成用于dd到sd卡的image文件，以及用于eFlasher工具使用的eMMC烧写文件<br />
+
−
<br />
+
−
 
+
−
==Buildroot定制与开发==
+
−
===目录结构===
+
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
−
├── linuxsdk-friendlyelec
+
├── friendlywrt
−
│  ├── app
+
│  ├── friendlywrt -> friendlywrt源代码
−
│  ├── buildroot buildroot根文件系统的编译目录
+
|   └── configs -> 保存预设好的friendlywrt defconfig文件
−
│  ├── build.sh -> device/rockchip/common/build.sh 全自动编译脚本
+
|   └── toolchain -> 交叉编译器，仅用于编译u-boot与kernel
−
│   ├── device 编译相关配置文件
+
│  ├── build.sh -> 全自动编译脚本
−
│  ├── distro debian根文件系统生成目录
+
│  ├── device/friendlyelec -> 用于适配友善电子开发板的相关文件
−
│  ├── docs 文档
+
│  ├── kernel -> 内核
−
│  ├── envsetup.sh -> buildroot/build/envsetup.sh
+
│  └── u-boot -> u-boot
−
│   ├── external
+
│  └── scripts -> 打包img的相关脚本
−
│  ├── friendlyelec 用于适配友善电子RK3399开发板的文件
+
−
│  ├── kernel 内核
+
−
│  ├── Makefile -> buildroot/build/Makefile
+
−
│  ├── mkfirmware.sh -> device/rockchip/common/mkfirmware.sh rockdev链接更新脚本
+
−
│  ├── prebuilts
+
−
│  ├── rkbin
+
−
│  ├── rkflash.sh -> device/rockchip/common/rkflash.sh 烧写脚本
+
−
│  ├── rootfs debian根文件系统编译目录
+
−
│  ├── tools 烧写、打包工具
+
−
│  └── u-boot u-boot
+
 
</syntaxhighlight>
 
</syntaxhighlight>
−
====更改Buildroot配置====
+
===配置friendlywrt的软件包===
−
* 列出当前可用的配置
+
* 使用make menuconfig更改配置
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
−
cd buildroot
+
cd friendlywrt
−
make list-defconfigs
+
make menuconfig
 
</syntaxhighlight>
 
</syntaxhighlight>
−
显示所下：<br />
+
* 另存你个人的软件包配置
−
rockchip_rk3399_defconfig          - Build for rockchip_rk3399<br />
+
−
* 使用menuconfig更改配置
+
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
−
make rockchip_rk3399_defconfig
 
 
make menuconfig
 
make menuconfig
−
make savedefconfig
+
./scripts/diffconfig.sh > ../configs/my_config
−
diff .defconfig configs/rockchip_rk3399_defconfig
+
−
cp .defconfig configs/rockchip_rk3399_defconfig
+
 
</syntaxhighlight>
 
</syntaxhighlight>
−
* 重新编译
+
* 让以后的编译使用你的friendlywrt配置
 +
以NanoPi-R1为例，编辑以下文件：
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
−
cd ../
+
device/friendlyelec/h3/nanopi_r1.mk
−
./build.sh rootfs
+
 
</syntaxhighlight>
 
</syntaxhighlight>
−
===预装文件到文件系统===
+
将TARGET_FRIENDLYWRT_CONFIG的值改为你的配置。
−
将文件放在 friendlyelec/rk3399/fs-overlay-64，然后重新编译 rootfs。
+
* 重新编译friendlywrt并制成sd启动镜像
−
===修改u-boot和kernel===
+
−
直接修改u-boot和kernel目录下的文件即可。
+
−
===使用sdk里的交叉编译器===
+
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
−
export PATH=$PWD/buildroot/output/rockchip_rk3399/host/bin/:$PATH
+
./build.sh friendlywrt
−
aarch64-buildroot-linux-gnu-g++ -v
+
./build.sh sd-img
 
</syntaxhighlight>
 
</syntaxhighlight>
−
显示版本如下：<br />
+
===固化个人文件到friendlywrt===
−
gcc 版本 6.4.0 (Buildroot 2018.02-rc3-g4f000a0797)
+
将文件或目录放入以下目录即可，打包img时会把它们都打包进去：
−
===交叉编译Qt程序===
+
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
−
git clone https://github.com/friendlyarm/QtE-Demo.git
+
device/friendlyelec/h3/common-files
−
cd QtE-Demo
+
−
../buildroot/output/rockchip_rk3399/host/bin/qmake QtE-Demo.pro
+
−
make
+
 
</syntaxhighlight>
 
</syntaxhighlight>
−
要实现开机自动运行你的Qt程序，可将QtE-Demo拷贝到开发板上，然后修改 /etc/init.d/下的S50launcher，将/usr/local/QLauncher/QLauncher &这一行改为QtE-Demo的文件路径即可。
+
也可以放在新建的目录里，以NanoPi-R1为例，然后编辑以下文件：
−
==常见问题==
+
<syntaxhighlight lang="bash">
−
===如何获取用于USB Type-C烧写的文件?===
+
device/friendlyelec/h3/nanopi_r1.mk
−
执行 build.sh emmc-img 之后，在 friendlyelec/rk3399/sd-fuse_rk3399 下面会有一个 buildroot 目录，使用android_tools工具加载这个目录下的文件即可。
+
</syntaxhighlight>
 +
在文件中新增一行 (XXX替换为你的目录名）：
 +
<syntaxhighlight lang="bash">
 +
FRIENDLYWRT_FILES+=(device/friendlyelec/h3/XXX)
 +
</syntaxhighlight>
 +
===修改friendlywrt系统的默认配置(如网络、防火墙等)===
 +
进入如下目录：
 +
<syntaxhighlight lang="bash">
 +
device/friendlyelec/h3/default-settings/files/root/board
 +
</syntaxhighlight>
 +
编辑你所用的开发板目录所在的配置文件即可，比如下面是NanoPi-R1的配置文件：
 +
<syntaxhighlight lang="bash">
 +
NanoPi-R1
 +
└── etc
 +
    └── config
 +
        ├── network
 +
        └── system
 +
</syntaxhighlight>
 +
===更改u-boot和kernel配置===
 +
同样是编辑如下文件：
 +
<syntaxhighlight lang="bash">
 +
device/friendlyelec/h3/nanopi_r1.mk
 +
</syntaxhighlight>
 +
可通过以下设置，将uboot的配置改为你自已的：
 +
<syntaxhighlight lang="bash">
 +
TARGET_UBOOT_CONFIG=nanopi_h3_defconfig
 +
</syntaxhighlight>
 +
可通过以下设置，将kernel的配置改为你自已的：
 +
<syntaxhighlight lang="bash">
 +
TARGET_KERNEL_CONFIG=sunxi_defconfig
 +
</syntaxhighlight>
 +
===更换其他源代码===
 +
编辑如下 xml 文件，即可替换 kernel 、uboot以及friendlywrt的源代码：
 +
<syntaxhighlight lang="bash">
 +
.repo/manifests/h3.xml
 +
</syntaxhighlight>
 +
想了解 xml 文件各个节点的含义和用法，请参考：[https://gerrit.googlesource.com/git-repo/+/refs/heads/master/docs/manifest-format.md repo Manifest Format]<br />
 +
编辑完成后，需要用 repo 命令同步一下，比如更换了 kernel 的源代码，用以下命令同步一次：
 +
<syntaxhighlight lang="bash">
 +
repo sync --force-sync kernel
 +
</syntaxhighlight>
 +
同步后单独重新内核即可：
 +
<syntaxhighlight lang="bash">
 +
./build.sh kernel
 +
</syntaxhighlight>
 +
 
 +
==常见问题及注意事项==
 +
* Ubuntu下不能使用 root 用户来编译，需要使用普通用户
 +
* 在 vnc 环境下编译可能会编译失败
 +
 
 +
==参考资料==
 +
[https://source.android.com/setup/develop/repo repo使用指南]<br />

Revision as of 03:15, 28 August 2019

English

1 FriendlyWrt简介

FriendlyWrt是友善电子基于OpenWrt定制的系统，完全开源，用于企业物联网二次开发，个人定制NAS，家庭物联网网关等。 TODO

2 下载体验版固件

TODO
解压后用 dd 或者 win32image 烧写到 SD 卡。

3 帐户与密码

用户名: root
密码: fa

4 获取项目源代码

4.1 安装 repo 工具

首先需要安装 repo 工具： 

git clone https://github.com/friendlyarm/repo
cp repo/repo /usr/bin/

4.2 下载项目源代码

有以下两种途径获取项目源代码，中国大陆用户建议使用方法1的途径下载:

4.2.1 方法一：使用网盘里的repo压缩包

网盘下载地址: 点击进入
文件位于网盘的以下路径：sources/friendlywrt-YYYYMMDD.tar (YYYYMMDD表示打包的日期)
从网盘中获取的 repo 压缩包在解压之后，需要执行一下以下命令做一次解包动作： 

tar xvf /path/to/netdisk/sources/friendlywrt-YYYYMMDD.tar
cd friendlywrt
repo sync -l --no-clone-bundle

用此方法得到的源代码版本是repo打包时的版本，如果想拉取到官方最新的版本，可以去掉 -l 参数，执行一次 repo sync, 例如： 

cd friendlywrt
repo sync --no-clone-bundle

4.2.2 方法二：从github下载

mkdir friendlywrt
cd friendlywrt
repo init -u https://github.com/friendlyarm/friendlywrt_manifests -b master -m h3.xml --repo-url=https://github.com/friendlyarm/repo  --no-clone-bundle
repo sync -c  --no-clone-bundle

4.2.3 同步项目到最新版本

cd friendlywrt
repo sync -c --no-clone-bundle

同步过程中,由于网络原因出现中断,可以使用下面脚本同步代码: 

#! /bin/bash
repo sync -c --no-clone-bundle
while [ $? -ne 0 ]; 
do  
    repo sync -c --no-clone-bundle
done

5 如何编译

5.1 搭建编译环境

在PC的Ubuntu系统下 (建议使用版本18.04-64bit)，执下以下命令安装所需的软件： 

wget -O - https://raw.githubusercontent.com/friendlyarm/build-env-on-ubuntu-bionic/master/install.sh | bash

5.2 查看帮助

不带参数执行 build.sh，默认是打印帮助信息: 

./build.sh

显示的帮助信息如下： 

USAGE: ./build.sh <parameter>
 
# 选择目标的硬件平台:
  ./build.sh nanopi_r1.mk
  ./build.sh nanopi_duo.mk
  ./build.sh nanopi_neo_core.mk
  ./build.sh nanopi_neo.mk
  ./build.sh nanopi_neo_s.mk
  ./build.sh nanopi_m1_plus.mk
  ./build.sh nanopi_m1.mk
  ./build.sh nanopi_neo_air.mk
 
# 编译各个模块:
  ./build.sh all                -编译所有组件
  ./build.sh uboot              -单独编译uboot
  ./build.sh kernel             -单独编译kernel
  ./build.sh friendlywrt        -单独编译friendlywrt
  ./build.sh sd-img             -生成sd启动的镜像文件
  ./build.sh emmc-img           -生成用于安装到emmc的镜像文件 (镜像文件需要dd到sd卡，通过sd卡启动安装程序)
# 清理：
  ./build.sh cleanall

5.3 全自动方式编译

初次编译，需要选择目标的硬件平台，当前只有H3可用，后续会加入更多的硬件支持： 

./build.sh nanopi_r1.mk

执行上述命令，会自动编译所有组件，其中包括u-boot, kernel 和 friendlywrt，并生成sd启动的烧写镜像文件。

5.4 编译单独的模块

5.4.1 kernel

./build.sh kernel

5.4.2 u-boot

./build.sh uboot

5.4.3 friendlywrt

./build.sh friendlywrt

5.5 生成sdcard固件

sudo ./build.sh sd-img

打包img成功后，终端会显示如下信息，可以参考下面的dd命令将img写入sd卡，注意/dev/sdX需要替换成真实的sd卡设备：

Run the following for sdcard install:
    sudo dd if=out/FriendlyWrt_20190828_NanoPi-R1_armhf_sd.img bs=1M of=/dev/sdX

5.6 生成emmc (eflasher) 固件

sudo ./build.sh emmc-img

打包img成功后，终端会显示如下信息，可以参考下面的dd命令将img写入sd卡，注意/dev/sdX需要替换成真实的sd卡设备：

Run the following for sdcard install:
    sudo dd if=out/FriendlyWrt_20190828_NanoPi-R1_armhf_eflasher.img bs=1M of=/dev/sdX

用此sd卡启动eflasher系统，执行eflasher命令，将系统写入emmc，之后就可以拨掉sd卡，从emmc启动friendlywrt了。

6 friendlywrt定制与开发

6.1 源代码目录结构

├── friendlywrt
│   ├── friendlywrt -> friendlywrt源代码
|   └── configs -> 保存预设好的friendlywrt defconfig文件
|   └── toolchain -> 交叉编译器，仅用于编译u-boot与kernel
│   ├── build.sh -> 全自动编译脚本
│   ├── device/friendlyelec -> 用于适配友善电子开发板的相关文件
│   ├── kernel -> 内核
│   └── u-boot -> u-boot
│   └── scripts -> 打包img的相关脚本

6.2 配置friendlywrt的软件包

  • 使用make menuconfig更改配置
cd friendlywrt
make menuconfig
  • 另存你个人的软件包配置
make menuconfig
./scripts/diffconfig.sh > ../configs/my_config
  • 让以后的编译使用你的friendlywrt配置

以NanoPi-R1为例，编辑以下文件： 

device/friendlyelec/h3/nanopi_r1.mk

将TARGET_FRIENDLYWRT_CONFIG的值改为你的配置。

  • 重新编译friendlywrt并制成sd启动镜像
./build.sh friendlywrt
./build.sh sd-img

6.3 固化个人文件到friendlywrt

将文件或目录放入以下目录即可，打包img时会把它们都打包进去： 

device/friendlyelec/h3/common-files

也可以放在新建的目录里，以NanoPi-R1为例，然后编辑以下文件： 

device/friendlyelec/h3/nanopi_r1.mk

在文件中新增一行 (XXX替换为你的目录名）： 

FRIENDLYWRT_FILES+=(device/friendlyelec/h3/XXX)

6.4 修改friendlywrt系统的默认配置(如网络、防火墙等)

进入如下目录： 

device/friendlyelec/h3/default-settings/files/root/board

编辑你所用的开发板目录所在的配置文件即可，比如下面是NanoPi-R1的配置文件： 

NanoPi-R1
└── etc
    └── config
        ├── network
        └── system

6.5 更改u-boot和kernel配置

同样是编辑如下文件： 

device/friendlyelec/h3/nanopi_r1.mk

可通过以下设置，将uboot的配置改为你自已的： 

TARGET_UBOOT_CONFIG=nanopi_h3_defconfig

可通过以下设置，将kernel的配置改为你自已的： 

TARGET_KERNEL_CONFIG=sunxi_defconfig

6.6 更换其他源代码

编辑如下 xml 文件，即可替换 kernel 、uboot以及friendlywrt的源代码： 

.repo/manifests/h3.xml

想了解 xml 文件各个节点的含义和用法，请参考：repo Manifest Format
编辑完成后，需要用 repo 命令同步一下，比如更换了 kernel 的源代码，用以下命令同步一次： 

repo sync --force-sync kernel

同步后单独重新内核即可： 

./build.sh kernel

7 常见问题及注意事项

  • Ubuntu下不能使用 root 用户来编译，需要使用普通用户
  • 在 vnc 环境下编译可能会编译失败

8 参考资料

repo使用指南

Retrieved from "https://wiki.friendlyelec.com/wiki/index.php?title=How_to_build_FriendlyWrt/zh&oldid=19880"