[转载]OpenWrt增加软件包方法

标签：

http://blog.chinaunix.net/uid-10429687-id-3374873.html

OpenWrt是一个比较完善的嵌入式Linux开发平台，在无线路由器应用上已有100多个软件包。人们可以在其基础上增加软件包，以扩大其应用范围。OpenWrt在增加软件方面使用极其方便，按照OpenWrt的约定就可以很简单完成。

        加入的软件包可以是网上可下载的开源软件或自行开发的软件。為加入软件包需要在package目錄下创建一个目录，以包含软件包的各种信息和与OpenWrt建立联系的文件。然后创建一个Makefile与OpenWrt建立联系，Makefile需要遵循OpenWrt的约定。另外可以創建一個patchs目錄保存patch文件，對下載的源代碼進行適量修改。下面主要介紹Makefile的基本約定。
1、引入文件
OpenWrt使用三个makefile的子文件，分别为：
include $(TOPDIR)/rules.mk
include $(INCLUDE_DIR)/kernel.mk
include $(INCLUDE_DIR)/package.mk
        由這些makefile子文件確立軟件包加入OpenWrt的方式和方法。$(TOPDIR)/rules.mk一般在Makefile的開頭，$(INCLUDE_DIR)/kernel.mk文件對於軟件包為內核時不可缺少，$(INCLUDE_DIR)/package.mk一般在軟件包的基本信息完成後再引入。
2、编写软件包的基本信息，这些软件包的信息均以PKG_开头，其意思和作用如下：
PKG_NAME表示软件包名称，将在menuconfig和ipkg可以看到。
PKG_VERSION表示软件版本号。
PKG_RELEASE表示Makefile的版本号
PKG_SOURCE表示源代码的文件名。
PKG_SOURCE_URL表示源代码的下载网站位置。@SF表示在sourceforge网站，@GNU表示在GNU网站，還有@GNOME、@KERNEL。獲取方式可以為：git、svn、cvs、hg、bzr等。有關下載方法可參考$(INCLUDE_DIR)/download.mk和$(SCRIPT_DIR)/download.pl。
PKG_MD5SUM表示源代码文件的效验码。用于核对软件包是否正确下载。
PKG_CAT表示源代码文件的解压方法。包括zcat, bzcat, unzip等。
PKG_BUILD_DIR表示软件包编译目录。它的父目录为$(BUILD_DIR)。如果不指定，默认为$(BUILD_DIR)/$( PKG_NAME)$( PKG_VERSION)。
還有一些有關源代碼的定義。
PKG_SOURCE_SUBDIR
PKG_SOURCE_PROTO
PKG_SOURCE_MIRROR
PKG_MIRROR_MD5SUM
PKG_SOURCE_VERSION

3、编译包定义
用户程序和内核模块的定义不一样。用戶態軟件包使用Package，內核模塊使用KernelPackage。
3.1用户程序编译包定义
用户程序的编译包以Package/开头,然后接着软件名，在Package定义中的软件名可以与软件包名不一样，而且可以多个定义。下面使用$(PKG_NAME)只是做一个标示，并非真正使用$(PKG_NAME)。

Package/$(PKG_NAME)
SECTION表示包的类型，预留。
CATEGORY表示分类，在menuconfig的菜单下将可以找到。
TITLE用于软件包的简短描述
DESCRIPTION用于软件包的详细描述，已放弃使用。如果使用DESCRIPTION將會提示“error DESCRIPTION:= is obsolete, use Package/PKG_NAME/description”。
URL表示软件包的下载位置。
MAINTAINER表示维护者，选项。
DEPENDS表示与其他软件的依赖。即如编译或安装需要其他软件时需要说明。如果存在多個依賴，則每個依賴需用空格分開。依賴前使用+號表示默認顯示，即對象沒有選中時也會顯示，使用@則默認為不顯示，即當依賴對象選中後才顯示。
在用戶態的軟件包中沒有內核模塊的AUTOLOAD參數。如果軟件需要在boot時自動運行，則需要在/etc/init.d增加相應的腳本文件。腳本文件需要START參數，說明在boot時的優先級，如果在boot過程啟動後在關閉，則需要進一步設置STOP參數。如果STOP參數存在，其值必須大於START。腳本文件需要start()和stop()兩個函數，start()是執行程序，stop()是關閉程序。關閉程序一般需要執行killall命令。由/etc/rc.d/S10boot知道，裝載內核模塊的優先級為10，需要使用自己設計的內核模塊的程序其START的值必須大於10. 同樣由/etc/rc.d/S40network知道，使用網絡通信的程序其START的值必須大於40。

Package/$(PKG_NAME)/conffiles
本包安裝的配置文件，一行一個。如果文件結尾使用/，則表示為目錄。用於備份配置文件說明，在sysupgrade命令執行時將會用到。

Package/$(PKG_NAME)/description
软件包的详细描述，取代前面提到的DESCRIPTION详细描述。

Build/Prepare
编译准备方法，对于网上下载的软件包不需要再描述。对于非网上下载或自行开发的软件包必须说明编译准备方法。一般的准备方法为：
define Build/Prepare
        mkdir -p $(PKG_BUILD_DIR)
        $(CP) ./src/* $(PKG_BUILD_DIR)/
endef
按OpenWrt的习惯，一般把自己设计的程序全部放在src目录下。
Build/Configure
在Automake中需要进行./configure，所以本配置方法主要针对需要配置的软件包而设计，一般自行开发的软件包可以不在这里说明。需要使用本定义的情况，可参考dropbear。

Build/Compile
编译方法，没有特别说明的可以不予以定义。如果不定义将使用默认的编译方法Build/Compile/Default
自行开发的软件包可以考虑使用下面的定义。
define Build/Compile
        $(MAKE) -C $(PKG_BUILD_DIR) \
                $(TARGET_CONFIGURE_OPTS) CFLAGS="$(TARGET_CFLAGS) -I$(LINUX_DIR)/include"
Endef

Package/$(PKG_NAME)/install
软件包的安装方法，包括一系列拷贝编译好的文件到指定位置。調用時會帶一個參數，就是嵌入系統的鏡像文件系統目錄，因此$(1)表示嵌入系统的镜像目录。一般可以采用下面的方法：
define Package/$(PKG_NAME)/install
        $(INSTALL_DIR) $(1)/usr/bin
        $(INSTALL_BIN) $(PKG_BUILD_DIR)/ $(PKG_NAME) $(1)/usr/bin/
endef
INSTALL_DIR、INSTALL_BIN在$(TOPDIR)/rules.mk文件定义，所以本Makefile必须引入$(TOPDIR)/rules.mk文件。
INSTALL_DIR :=install -d -m0755 意思創建所屬用戶可讀寫即執行，其他用戶可讀可執行的目錄。
INSTALL_BIN:=install -m0755意思編譯好的文件到鏡像文件目錄。
如果用戶態軟件在boot時要自動運行，則需要在安裝方法說明中增加自動運行的腳本文件安裝和配置文件安裝方法。
例如：
define Package/mountd/install
        $(INSTALL_DIR) $(1)/sbin/ $(1)/etc/config/ $(1)/etc/init.d/
        $(INSTALL_BIN) $(PKG_BUILD_DIR)/mountd $(1)/sbin/

AUTOLOAD:=$(call AutoLoad, $(PRIORITY),$(AUTOLOAD_MODS))

[转载]OpenWrt增加软件包方法

标签：

原文地址：http://www.cnblogs.com/tkid/p/4490890.html