关于添加openwrt软件包的概述

maclinuxye

墨衍会员 · AI 创作全网分发码龄11年

关注

原创最新推荐文章于 2026-03-22 00:40:21 发布 1.1k 阅读 AI 写同款· GEO 优化 ›

OpenWrt自动编译加载ko 今天在调试ko的时候，发现没有在开机的时候进行自动加载，之前只知道在Makefile文件中增加一个配置就可以实现。我这边做一下分析。阅读详情

主要讲讲自己在学习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

编译准备方法，对于网上下载的软件包不需要再描述。对于非网上下载或自行开发的软件包必须说明编译准备方法。一般的准备方法为：

<span style="white-space:pre">	</span>define Build/Prepare
<span style="white-space:pre">	</span>mkdir -p $(PKG_BUILD_DIR)
<span style="white-space:pre">	</span>$(CP) ./src/* $(PKG_BUILD_DIR)/
<span style="white-space:pre">	</span>endef

按照oipenwrt的习惯，一般把自己设计的程序全部放在src目录下：

Build/Configure

在 Automake 中需要进行./configure，所以本配置方法主要针对需要配置的软件包而设计，一般自行开发的软件包可以不在这里说明。需要使用本定义的情况，可参考dropbear。 Build/Compile 编译方法，没有特别说明的可以不予以定义。如果不定义将使用默认的编译方法 Build/Compile/Default。

自行开发的软件包可以使用下面的定义：

<span style="white-space:pre">	define Build/Compile
	$(MAKE) -C $(PKG_BUILD_DIR) \
	$(TARGET_CONFIGURE_OPTS) CFLAGS="$(TARGET_CFLAGS)
	-I$(LINUX_DIR)/include"
	Endef
	</span><span style="white-space:pre">Package/$(PKG_NAME)/install</span>

软件包的安装方法，包括一系列拷贝编译好的文件到指定位置。调用时会带一个参数，就是嵌入系統的镜像文件系统目录，因此$(1)表示嵌入系统的镜像目录。一般可以采用下面
的方法：

<span style="white-space:pre">	</span>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 文件。

<span style="white-space:pre">	</span>INSTALL_DIR :=install -d -m0755 意思是创建所属用戶可读写和执行，其他用戶可读可执行的目录。

<span style="white-space:pre">	</span>INSTALL_BIN:=install -m0755 意思编译好的文件存放到镜像文件目录。

如果用户空间的应用软件在boot是要自动运行，则需要在安装方法中增加自动运行的脚本方法。下如下：

<span style="white-space:pre">	</span>define Package/mountd/install
<span style="white-space:pre">	</span>$(INSTALL_DIR) $(1)/sbin/ $(1)/etc/config/ $(1)/etc/init.d/
<span style="white-space:pre">	</span>$(INSTALL_BIN) $(PKG_BUILD_DIR)/mountd $(1)/sbin/
<span style="white-space:pre">	</span>$(INSTALL_DATA) ./files/mountd.config $(1)/etc/config/mountd
<span style="white-space:pre">	</span>$(INSTALL_BIN) ./files/mountd.init $(1)/etc/init.d/mountd
<span style="white-space:pre">	</span>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)模块名，每个模块名以空格符分隔。即可同时装载多个内核模块。在开发过程最好不要使用自动装载，经过严格调试后再使用，可以减轻调试的工作量。

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