关于添加openwrt软件包的概述

2019-07-13 05:51发布

主要讲讲自己在学习openwrt软件包添加的记录过程 目标: 掌握如何添加自己驱动会让应用的方法 了解Makefile在openwrt中的定义 openwrt是一个比较完善的嵌入式linux开发平台,拥有众多的软件包 首先按照openwrt的约定,为加入软件包需要在package目录下创建一个目录,包含该软件的各种信息和与openwrt建立联系的文件,然后创建一个Makefile与openwrt建立联系(这个makefile与PC环境下的makefile不同),Makefile需要遵循openwrt的约定,另外可以创建一个patch目录保存patch文件,对下载的源代码进行修改。 下面是一些收集到的语法知识点,且在这里做一个简单的记录:

1.首先是引入文件 include $(TOPDIR)/rules.mk include $(INCLUDE_DIR)/kernel.mk include $(INCLUDE_DIR)/package.mk这些文件确立软件包加入openwrt的方式和方法,$(TOPDIR)/rules.mk一般在文件的开头$(INCLUDE_DIR)/kernel.mk文件对于
软件包为内核时是不可缺少,$(INCLUDE_DIR)/package.mk 一般在软件包的基本信息完
成后再引入。

2.编写软件包的基本信息: # #编写软件包的基本信息 # # PKG_NAME 代表软件包的名称 # PKG_VERSION 表示软件包的版本号 # PKG_RELEASE 表示单片机的版本号 # PKG_SOURCE 表示元代码的文件名 # PKG_SOURCE_URL 表示源代码的下载网站位置 @sf表示在soueceforge网站 # @GNU表示在GNU网站 还有@GNOME @KERNEL # PKG_MD5SUM 表示源代码文件的效验码。用于核对软件包是否正确下载 # PKG_CAT 表示源代码文件的解压方法。包括 zcat, bzcat, unzip 等 # PKG_BUILD_DIR 表示软件包编译目录。它的父目录为$(BUILD_DIR)。如果不指定, # 默认为$(BUILD_DIR)/$( PKG_NAME)/$( PKG_VERSION)。 3.编译包的定义: 应用程序和内核驱动程序模块的定义不一样。应用程序软件包使用Package,内核驱动模块使用KernelPackage 1).应用程序编译包定义 应用程序编译包一Package开头,然后接着软件名,在Package定义中定义的软件名可以与软件包名不一样,而且可以多个定义 CESTION表示包的类型,预留 GATEGORY表示分类,在马克menuconfig的菜单下将可以找到 TITLE用于软件包的简短描述。 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/init.d/S40network知道,使用网络通信的程序其START的值必须大于40. 1.Package/$(PKG_NAME)/conffiles 这个是本安装包的一个配置文件,一行一个。如果文件结尾使用/,则表示为目录。用于备份配置文件说明,在sysupgrade 这个命令执行时将会用到。
2.Package/$(PKG_NAME)/description 软件包的详细描述,取代前面的DESCRIPTION详细描述 3.Build/Prepare
编译准备方法,对于网上下载的软件包不需要再描述。对于非网上下载或自行开发的软件包必须说明编译准备方法。一般的准备方法为: define Build/Prepare mkdir -p $(PKG_BUILD_DIR) $(CP) ./src/* $(PKG_BUILD_DIR)/ endef按照oipenwrt的习惯,一般把自己设计的程序全部放在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/ endefINSTALL_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/ $(INSTALL_DATA) ./files/mountd.config $(1)/etc/config/mountd $(INSTALL_BIN) ./files/mountd.init $(1)/etc/init.d/mountd endef
安装文件放在 files 子目录下,不要与源代码文件目录 src 混在一起,以提高可读性。

使用清晰的文件扩展名,更方便安装识別文件。
Package/$(PKG_NAME)/preinst 软件包安装前处理方法,使用脚本语言,因此定义的第一行需要下面的格式
#
!/bin/sh
调用时带入的参数为嵌入式系統的镜像目录。 Package/$(PKG_NAME)/postinst软件包安装后处理方法,使用脚本语言。

Package/$(PKG_NAME)/prerm软件包删除前处理方法,使用脚本语言。

Package/$(PKG_NAME)/postrm软件包删除后处理方法,使用脚本语言。

2).内核驱动模块包的定义: linux分为内核空间和用户空间。开发者开发的内核部分可以直接加入Linux的Kernel程序,也可以生成内核模块以便需要时装入内核。openwrt一般希望开发者生成内核模块,在Linux启动后自动装载或手工使用insmod命令装载。内核模块使用KernelPackage开头,其他与一般应用软件包基本相同。 在内核驱动模块定义中增加了: SUBMENU:表示子菜单位置,在$(INCLUDE)/kernel.mk 对内核模块定义了GATEGORY为kernel modules,所以内核模块在menuconfig中的主菜单为kernelmodules 
所以内核模块在 menuconfig 中的主菜单为 kernelmodules , 然 后 有 下 一 级 子 菜 单 $(SUBMENU) 。 在 子 菜 单 下 可 以 看 到 以kmod-$(PKG_NAME)项目。DEFAULT 表示直接编入内核或产生内核模块, y 表示直接编入内核, m 表示产生内核模块。AUTOLOAD 表示自动装入内核,一般表示方法为:AUTOLOAD:=$(call AutoLoad, $(PRIORITY),$(AUTOLOAD_MODS))
AutoLoad 的第一个参数$(PRIORITY)为优先级,01 为最优先,99 为最后装载。有关自动装载可以在/etc/modules.d 目录下看到,第二个参数$(AUTOLOAD_MODS)模块名,每个模块名以空格符分隔。即可同时装载多个内核模块。在开发过程最好不要使用自动装载,经过严格调试后再使用,可以减轻调试的工作量。
   


在没有你的世界里,爱你,叶铮