Image Generator (Image Builder)

→ 返回到获得固件

如果你想要下载一个预编译好的镜像文件,或者想要尝试整个编译过程,一个替代方案是使用镜像生成器(Image Generator)(以前被叫做Image Builder)。这是一个预编译好的OpenWrt编译环境,适用于在无需编译的条件下创建自定义镜像。

使用镜像生成器的原因可以是:

  • 将包文件直接嵌入SquashFS中,以减少目标设备上的磁盘空间要求。
  • 通过嵌入包文件和直接在SquashFS中配置文件的方式预编译镜像,可以在需要给许多设备刷固件的时候节约人力。
  • 编译最小化固件,例如不包含Web界面的。
  • 热爱学习

镜像生成器适用于生成OpenWrt固件镜像文件的程序。在编译OpenWrt的过程中镜像生成器是被强制创建(编译)出的,因为最后在创建镜像文件的时候它是必不可少的。它的位置在/openwrt/trunk/xxx,你可以用它配合你编译时候获得的包文件来创建更多的镜像文件。

不过你也可以简单地下载一个包括镜像生成器和一整个OpenWrt的包文件在内的压缩包。


下载

针对OpenWrt 10.03 'Backfire',镜像生成器随着目标镜像一起被编译好,并且可以在服务器上下载。注意镜像生成器必须对稳定版测试版都有效,如果不是的话,你就需要自己动手编译它。

cd ~
wget http://downloads.openwrt.org/backfire/10.03/ar71xx/OpenWrt-ImageBuilder-ar71xx-for-Linux-i686.tar.bz2
tar -xvjf OpenWrt-ImageBuilder-ar71xx-for-Linux-i686.tar.bz2
cd OpenWrt-ImageBuilder-ar71xx-for-Linux-i686/

使用说明

make image命令会创建一个只包含必不可少包文件的最小化镜像,这个命令可以通过三个传递过去的参数控制:

  • PROFILE - 指定要编译的目标镜像的配置
  • PACKAGES - 要嵌入镜像的包文件的列表
  • FILES - 要包含进去的自定义文件的目录

查看下面的说明部分,在make命令结束后,生成的镜像会被放到bin目录中。

ls bin/
md5sums                          openwrt-wrt350n_v1-squashfs.bin
openwrt-brcm-2.4-squashfs.trx    openwrt-wrt54g-squashfs.bin
openwrt-usr5461-squashfs.bin     openwrt-wrt54g3g-em-squashfs.bin
openwrt-wa840g-squashfs.bin      openwrt-wrt54g3g-squashfs.bin
openwrt-we800g-squashfs.bin      openwrt-wrt54gs-squashfs.bin
openwrt-wr850g-squashfs.bin      openwrt-wrt54gs_v4-squashfs.bin
openwrt-wrt150n-squashfs.bin     openwrt-wrtsl54gs-squashfs.bin
openwrt-wrt300n_v1-squashfs.bin

(配置)Profiles

(预定义的配置)Pre-defined Profiles

运行make info来获得一个预定义配置的列表

make info
Current Target: "brcm-2.4"
Default Packages: base-files libgcc ... kmod-switch kmod-diag nvram 
Available Profiles:

Broadcom:
	Generic, Broadcom WiFi (default)
	Packages: kmod-brcm-wl wlc nas kmod-wlcompat
BroadcomMimo:
	Generic, Broadcom WiFi (MIMO)
	Packages: kmod-brcm-wl-mimo wlc nas kmod-wlcompat
None:
	Generic, No WiFi
	Packages: 
USBGeneric:
	Generic USB
	Packages: kmod-brcm-wl kmod-usb-core kmod-usb-ohci kmod-usb2 ...
WL500G:
	ASUS WL-500g
	Packages: kmod-brcm-wl kmod-usb-core kmod-usb-ohci kmod-lp ...
WL500GD:
	ASUS WL-500g Deluxe
	Packages: kmod-brcm-wl kmod-usb-core kmod-usb-uhci kmod-usb2 ...
WL500GP:
	ASUS WL-500g Premium
	Packages: kmod-brcm-wl kmod-usb-core kmod-usb-uhci-iv ...
WL700GE:
	WL-700gE
	Packages: ppp ppp-mod-pppoe kmod-ipt-nathelper iptables ...
WLHDD:
	WL-HDD
	Packages: kmod-brcm-wl kmod-usb-core kmod-usb-ohci ...
WRT54G3G:
	Linksys WRT54G3G
	Packages: kmod-brcm-wl kmod-usb-core kmod-usb-ohci kmod-usb2 ...

…将适合的配置传给make命令

make image PROFILE=WL500GP

增加/修改配置

针对预编译包文件brcm47xx-for-Linux-i686的配置被放在target/linux/brcm47xx/profiles中。

记住,要添加一个新的配置,你只需要将一个新的配置文件放入profiles目录中。

这里描述了profiles/100-Broadcom-b43.mk配置文件看起来什么样

define Profile/Broadcom-b43
  NAME:=Broadcom BCM43xx WiFi (default)
  PACKAGES:=kmod-b43 kmod-b43legacy
endef

define Profile/Broadcom-b43/Description
	Package set compatible with hardware using Broadcom BCM43xx cards
endef
$(eval $(call Profile,Broadcom-b43))

(包文件)Packages

当编译一个镜像的时候PACKAGES变量指定了一个要被包含进去的包文件的列表。如果一个包文件的名字前面有一个前缀-,那么这个文件会被从镜像中排除出去。

make image PROFILE=WL500GP PACKAGES="nano openvpn -ppp -ppp-mod-pppoe"

Backfire 10.03.1-rc5及之后的版本: 镜像生成器现在在主机上面使用opkg命令来检测要被安装的包文件和解决他们的依赖关系(当你在使用External Repositories时特别有用),所以下面的警告并不会生效!

Backfire 10.03到10.03.1-rc4:使用PACKAGES=将不会在你的配置中安装任何默认包。确保你包含进了libuci,没有uciOpenWrt不会工作。你的路由可以启动但是没有界面会被配置这真是个有效地让你的路由变砖的方法(一开始设这了boot_wait可以让你通过tftp恢复路由)。

小提示:现在在你路由器上面已经安装的包文件可以通过下面的命令来获得:

echo `opkg list_installed | awk '{ print $1 }'`

小提示:官方镜像中包含的包文件列表可以通过下面的命令获得(在一台Linux主机上面)

echo `wget -qO - http://backfire.openwrt.org/10.03/brcm-2.4/OpenWrt.config | sed -ne 's/^CONFIG_PACKAGE_\([a-z0-9-]*\)=y/\1/ip'`

小提示:如果你想要移除一些默认包文件(例如你不需要pppoe相关的包),修改inclide/target.mk文件中的DEFAULT_PACKAGES and DEFAULT_PACKAGES.router区块。

文件

一个包含自定义文件的想要加入的目录可以通过使用FILES变量来指定,如果有必要的话自定义文件会替换掉默认已经存在的文件。

mkdir -p files/etc/config scp root@192.168.1.1:/etc/config/network files/etc/config/ scp root@192.168.1.1:/etc/config/wireless files/etc/config/ scp root@192.168.1.1:/etc/config/firewall files/etc/config/ make image PROFILE=WL500GP PACKAGES="nano openvpn -ppp -ppp-mod-pppoe" FILES=files/

清理

想要清理临时编译文件和生成的镜像,使用make clean命令。

(附加仓库)External Repositories

Trunk修订版从r22978之后在镜像生成器中开始支持附加仓库,这个选项会成为最后的10.03.1 release的一部分。 味儿了增加附加包文件仓库,编译最上级目录中的repositories.conf文件,软件园可以以opkg原生配置格式指定。

针对早期版本的镜像生成器,附件的包文件可以下载到packages/目录中,镜像生成器会在索引创建期间将它们收入。

Back to top

zh-cn/doc/howto/obtain.firmware.generate.txt · Last modified: 2012/01/05 07:49 by turygo