OpenWrt 编译教程

在Arch Linux 下编译 OpenWrt 过程记录。

首次编译

配置环境

sudo pacman -S --needed base-devel autoconf automake bash binutils bison bzip2 fakeroot file findutils flex gawk gcc gettext git grep groff gzip libelf libtool libxslt m4 make ncurses openssl patch pkgconf python rsync sed texinfo time unzip util-linux wget which zlib asciidoc help2man intltool perl-extutils-makemaker swig

克隆 Open­Wrt 源码

此处以 Lean’s OpenWrt 为例。

git clone https://github.com/coolsnowwolf/lede openwrt

添加一些自定义软件包

进入源码目录

cd openwrt
echo 'src-git chuest https://github.com/chuest/Packages' >> feeds.conf.default

下载 feeds 源中的软件包源码

./scripts/feeds update -a

feeds 是扩展的软件包,独立于 OpenWrt 源码之外,所以需要单独进行拉取和更新。

安装 feeds 中的软件包

./scripts/feeds install -a

调整一些设置

Modify default IP

sed -i 's/192.168.1.1/192.168.0.1/g' package/base-files/files/bin/config_generate

取消bootstrap默认主题

sed -i '/set luci.main.mediaurlbase=\/luci-static\/bootstrap/d' feeds/luci/themes/luci-theme-bootstrap/root/etc/uci-defaults/30_luci-theme-bootstrap

修改机器名称

sed -i 's/OpenWrt/OpenWrt-x64/g' package/base-files/files/bin/config_generate

修改磁盘大小为32128K

# sed -i 's/15744k/32128k/g' target/linux/ramips/image/mt7621.mk
sed -i 's/15744k/32448k/g' target/linux/ramips/image/mt7621.mk

修改名字为32M

sed -i 's/"Phicomm K2P";/"Phicomm K2P (32M)";/g' target/linux/ramips/dts/mt7621_phicomm_k2p.dts

超频至1000HZ

sed -i 's/<80000000>/<10000000>/g' target/linux/ramips/dts/mt7621_phicomm_k2p.dts

防止软重启失败

# sed -i 's/m25p,fast-read;/broken-flash-reset;/g' target/linux/ramips/dts/mt7621_phicomm_k2p.dts
sed -i '/spi-max-frequency/a\\t\tbroken-flash-reset;' target/linux/ramips/dts/mt7621_phicomm_k2p.dts

修改为32M

# sed -i 's/<0xa0000 0xf60000>/<0xa0000 0x1f60000>/g' target/linux/ramips/dts/mt7621_phicomm_k2p.dts
sed -i 's/<0xa0000 0xf60000>/<0xa0000 0x1fb0000>/g' target/linux/ramips/dts/mt7621_phicomm_k2p.dts

调整 OpenWrt 系统组件

make menuconfig

首次编译建议只选择架构,其它都不要动,这样编译成功率会更高。如果不打算调整组件则输入 make defconfig,它会检测编译环境并生成默认的编译配置文件。

预下载编译所需的软件包

make download -j8 V=s

-j8是指使用8个线程下载,理论上是数字越大下载越快,但似乎有个上限,实测5线程以上其实速度相差不了多少,在网络好的情况下,基本在5分钟以内能下载完。

检查文件完整性

find dl -size -1024c -exec ls -l {} \;

此命令可以列出下载不完整的文件(根据多次编译的经验得出小于1k的文件属于下载不完整),如果存在这样的文件可以使用find dl -size -1024c -exec rm -f {} \;命令将它们删除,然后重新执行make download下载并反复检查,确认所有文件完整可大大提高编译成功率,避免浪费时间。

开始编译

make -j1 V=s

-j1:使用单线程编译。 V=s:输出详细日志,用于编译失败时找出错误。

再次编译

更新

拉取 Open­Wrt 源码更新

git pull

更新 feeds 源中的软件包源码

./scripts/feeds update -a

安装 feeds 中的软件包

./scripts/feeds install -a

文件清理

清除旧的编译产物(可选)

make clean

在源码有大规模更新或者内核更新后执行,以保证编译质量。此操作会删除/bin和/build_dir目录中的文件。

清除旧的编译产物、交叉编译工具及工具链等目录(可选)

make dirclean

更换架构编译前必须执行。此操作会删除/bin和/build_dir目录的中的文件(make clean)以及/staging_dir、/toolchain、/tmp和/logs中的文件。

清除 Open­Wrt 源码以外的文件(可选)

make distclean

除非是做开发,并打算 push 到 GitHub 这样的远程仓库,否则几乎用不到。此操作相当于make dirclean外加删除/dl、/feeds目录和.config文件。

还原 Open­Wrt 源码到初始状态(可选)

git clean -xdf

如果把源码改坏了,或者长时间没有进行编译时使用。

清除临时文件

rm -rf tmp

删除执行make menuconfig后产生的一些临时文件,包括一些软件包的检索信息,删除后会重新加载package目录下的软件包。若不删除会导致一些新加入的软件包不显示。

删除编译配置文件

rm -f .config

在不删除的情况下如果取消选择某些组件它的依赖组件不会自动取消,所以对于需要调整组件的情况下建议删除。

编译

调整 Open­Wrt 系统组件

make menuconfig

如果不打算调整组件则输入make defconfig,它会检测编译环境并根据更新自动调整编译配置文件。

预下载编译所需的软件包

make download -j8 V=s

检查文件完整性

find dl -size -1024c -exec ls -l {} \;

开始编译

make -j$(nproc) || make -j1 || make -j1 V=s

多线程编译失败后自动进入单线程编译,失败则输出详细日志。