基于openwrt创建应用程序教程

#
# Copyright (C) 2010-2014 Davied Huang Wich
#
# This is free software, licensed under the GNU General Public License v2.
# See /LICENSE for more information.
#
include $(TOPDIR)/rules.mk
PKG_NAME:=luci-app-szloogson
PKG_VERSION=1.0
PKG_RELEASE:=1
PKG_BUILD_DIR:=$(BUILD_DIR)/$(PKG_NAME)
include $(INCLUDE_DIR)/package.mk
define Package/luci-app-szloogson
    SECTION:=luci
    CATEGORY:=LuCI
    SUBMENU:=3. Applications
    TITLE:=shenzhou loogson for LuCI
    PKGARCH:=all
endef
define Package/luci-app-njitclient/description
    This package contains LuCI configuration pages for shenzhou loogson.
endef
define Build/Prepare
    mkdir -p $(PKG_BUILD_DIR)
    $(CP) ./src/* $(PKG_BUILD_DIR)/
endef
define Build/Configure
endef
define Build/Compile
    $(MAKE) -C $(PKG_BUILD_DIR) \
        CC="$(TARGET_CC)" \
        CROSS_COMPILE="$(TARGET_CROSS)" \
        ARCH="$(ARCH)"
endef
define Package/luci-app-szloogson/install
    #install shell
    $(INSTALL_DIR) $(1)/etc/init.d
    $(INSTALL_BIN) ./files/loogson.init $(1)/etc/init.d/loogson
    #install config
    $(INSTALL_DIR) $(1)/etc/config
    $(INSTALL_CONF) ./files/loogson.config $(1)/etc/config/loogson
    #install execute bin
    $(INSTALL_DIR) $(1)/usr/sbin
    $(INSTALL_BIN) $(PKG_BUILD_DIR)/gsc3280_led $(1)/usr/sbin/gsc3280_led   
    #install luci
    mkdir -p $(1)/usr/lib/lua/luci/controller/admin
    $(INSTALL_DIR) $(1)/usr/lib/lua/luci/controller
    $(INSTALL_DATA) ./src/luci/controller/admin/loogson.lua $(1)/usr/lib/lua/luci/controller/admin/loogson.lua
   
    mkdir -p $(1)/usr/lib/lua/luci/model/cbi/admin_loogson
    $(INSTALL_DIR) $(1)/usr/lib/lua/luci/model/cbi
    $(INSTALL_DATA) ./src/luci/model/cbi/admin_loogson/* $(1)/usr/lib/lua/luci/model/cbi/admin_loogson/
endef
$(eval $(call BuildPackage,luci-app-szloogson)

软件包的信息均以“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 2.2.2、第17行“include $(INCLUDE_DIR)/package.mk”
“include $(INCLUDE_DIR)/package.mk”一般在软件包的基本信息完成后再引入，他定义了用户态软件包的规则。
编译包分为用户态和内核模块，用户态软件包使用Package，内核模块使用KernelPackage。“$(INCLUDE_DIR)/kernel.mk”文件对于软件包为内核时不可缺少，“$(INCLUDE_DIR)/package.mk”应用在用户态。接下来讲述用户态软件包。用户程序的编译包以“Package/”开头，然后接着软件名，在Package定义中的软件名可以与软件包名不一样，而且可以多个定义。

      接下来定义的包括：
        SECTION：包的类型，预留。
        CATEGORY：分类，在menuconfig的菜单下将可以找到。
     SUBMENU：包在make menuconfig的位置，此处即在”LuCi/3. Applications“下。
        TITLE：用于软件包的简短描述，将显示在”make menuconfig“中。
        DESCRIPTION：用于软件包的详细描述，已放弃使用。如果使用DESCRIPTION将会提示“error DESCRIPTION:= is obsolete, use Package/PKG_NAME/description”。
        URL：软件包的下载位置。
        MAINTAINER：维护者选项。
        DEPENDS：与其他软件的依赖。即如编译或安装需要其他软件时需要说明。如果存在多个依赖，则每个依赖需用空格分开。依赖前使用+号表示默认显示，即对象没有选中时也会显示，使用@则默认为不显示，即当依赖对象选中后才显示。

        软件包的详细描述，取代前面提到的DESCRIPTION详细描述。此处定义的信息将显示在”make menuconfig“中。

编译准备方法，对于网上下载的软件包不需要再描述。对于非网上下载或自行开发的软件包必须说明编译准备方法。本文所用的准备方法就是首先创建软件包目录，然后将源码拷贝到刚刚创建的目录中。按OpenWrt的习惯，一般把自己设计的程序全部放在src目录下。

        Build/Configure：在Automake中需要进行“./configure”，所以本配置方法主要针对需要配置的软件包而设计，一般自行开发的软件包可以不在这里说明。本文设计的package由自己写makefile，所以此处没有定义。

        编译方法，没有特别说明的可以不予以定义。如果不定义将使用默认的编译方法Build/Compile/Default。
        自行开发的软件包可以考虑使用下面的定义：
点击(此处)折叠或打开

define Build/Compile
   $(MAKE) -C $(PKG_BUILD_DIR) \
     $(TARGET_CONFIGURE_OPTS) CFLAGS="$(TARGET_CFLAGS) -I$(LINUX_DIR)/include"
endef
        本文此处指定了交叉编译器和体系结构。

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

define Package/luci-app-szloogson/install
$(INSTALL_DIR) $(1)/usr/bin
$(INSTALL_BIN) $(PKG_BUILD_DIR)/gsc3280_led $(1)/usr/sbin/
endef
INSTALL_DIR、INSTALL_BIN在”$(TOPDIR)/rules.mk“文件中定义，所以本Makefile必须引入$(TOPDIR)/rules.mk文件。
INSTALL_DIR :=install -d -m0755：创建所属用户可读写、执行，其他用户可读可执行的目录。
INSTALL_BIN:=install -m0755：编译好的文件到镜像文件目录。
安装文件放在files子目录下，不要与源代码文件目录“src”混在一起，以提高可读性。
如果用户态软件在boot时要自动运行，则需要在安装方法说明中增加自动运行的脚本文件安装和配置文件安装方法。
例如：
点击(此处)折叠或打开

define Package/luci-app-szloogson/install
#install shell
$(INSTALL_DIR) $(1)/etc/init.d
$(INSTALL_BIN) ./files/loogson.init $(1)/etc/init.d/loogson
#install config
$(INSTALL_DIR) $(1)/etc/config
$(INSTALL_CONF) ./files/loogson.config $(1)/etc/config/loogson
endef
使用清晰的文件扩展名，更方便安装识别文件。
Package/$(PKG_NAME)/preinst
软件包安装前处理方法，使用脚本语言，因此定义的第一行需要下面的格式
#!/bin/sh：调用时带入的参数为嵌入式系统的镜像目录。
Package/$(PKG_NAME)/postinst：软件包安装后处理方法，使用脚本语言。
Package/$(PKG_NAME)/prerm：软件包删除前处理方法，使用脚本语言
Package/$(PKG_NAME)/postrm：软件包删除后处理方法，使用脚本语言
程序接下来安装luci文件。

完成前面定义后，必须使用eval函数实现各种定义。其格式为：
对于一般软件包：$(eval $(call Package,$(PKG_NAME)))
或对于内核模块：$(eval $(call KernelPackage,$(PKG_NAME)))
如果一个软件包有多个程序，例如：一个应用程序有自己的内核模块，上面使用的“PKG_NAME”需要灵活变通。eval函数可能设计多个。也可以当成多个软件包处理。

#!/bin/sh /etc/rc.common
# (C) 2014 openwrt.org
# add by Davied Huang
START=50
LED_BIN="/usr/sbin/gsc3280_led"
control_board()
{
    local ledstatus, lednum;
   
    config_get_bool ledstatus $1 ledstatus
   
    config_get lednum $1 lednum
   
    echo "${lednum} ${ledstatus}"
    ${LED_BIN} ${lednum} ${ledstatus}
}
start() {
    config_load loogson
    config_foreach control_board controlboard
}
stop() {
    config_load loogson
    #config_foreach stop_instance controlboard
}

#include
#include
#include
#include
int main(int argc,char *argv[])
{
    int fd;
    if (argc != 3) {
        printf("wrong cmd!\n");
    }
    fd = open("/dev/led", O_RDWR);
    if(fd == -1){
        printf("open led failed!\n");
    }
    ioctl(fd, argv[1], argv[2]);   
       
    close(fd);
    return 0;
}