本教程的编译环境：win7 专业版+VMwareWorkstation6.5虚拟机+Ylmf OS 3.0
编译的过程中要保持电脑联网
搭建编译环境
应用程序--附件--终端
sudo apt-get update (更新）
安装编译需要的组件：
sudo apt-get install gcc
sudo apt-get install g++
sudo apt-get install binutils
sudo apt-get install patch
sudo apt-get install bzip2
sudo apt-get install flex
sudo apt-get install bison
sudo apt-get install make
sudo apt-get install autoconf
sudo apt-get install gettext
sudo apt-get install texinfo
sudo apt-get install unzip
sudo apt-get install sharutils
sudo apt-get install subversion
sudo apt-get install libncurses5-dev
sudo apt-get install ncurses-term
sudo apt-get install zlib1g-dev
sudo apt-get install gawk
sudo apt-get install asciidoc
sudo apt-get install libz-dev
编译环境搭建完成
mkdir openwrt 创建一个openwrt文件夹
cd openwrt 进入openwrt文件夹
svn co svn://svn.openwrt.org/openwrt/branches/backfire 下载官网的源码
./scripts/feeds update -a 更新软件包
./scripts/feeds install -a 安装软件包
make menuconfig 进入定制界面（里面可以选择芯片的型号，集成的组件等等，根据实际情况选择）
defconfig
make V=99 （开始编译）
剩下的就是等待了，第一次编译需要的时间相对比较长，这个跟你的电脑配置和网速有关。

下面以编译TP-LINK 741N的openwrt固件为例，只编译基本的功能：

make menuconfig
Target System---AR71xx/AR7240/AR913x/AR934x CPU型号
Target Profile---TP-LINK 741
LuCI—>Collections—– <> luci 添加Luci
LuCI—>Translations—- <> luci-i18n-chinese 添加中文
EXT----YES
make V=99 开始编译
成功后在bin文件夹里有编译好的固件。

本文章由 http://www.wifidog.pro/2014/12/31/openwrt%E7%BC%96%E8%AF%91wifidog.html 整理编辑，转载请注明出处

这里内核模块分两中，一种是模块代码本身就在kernel.org官方内核中的，另一种是外加模块如额外驱动的需求。（在这里吐槽一下openwrt把内核本身的模块也搞的这么麻烦，还需要在另外的文件中加配置，不然就算内核本身选上并编译成了.ko但就是不给你install到根文件系统，对于习惯直接以内核config文件为准的来说着实别扭）。

内核自身模块

以最近添加nfs client nfsv3功能为例，需要在package/kernel/linux/moudles目录下找到相应类别的文件，nfsv3属于fs.mk，在此文件中的nfs配置段下仿照nfs添加配置，如下：

define KernelPackage/fs-nfsv3
SUBMENU:=$(FS_MENU)
TITLE:=NFS client v3 filesystem support
DEPENDS:=+kmod-fs-nfs
KCONFIG:= \
CONFIG_NFS_V3
FILES:= \
$(LINUX_DIR)/fs/nfs/nfsv3.ko
AUTOLOAD:=$(call AutoLoad,50,nfsv3)
endef

define KernelPackage/fs-nfsv3/description
Kernel module for NFS client v3 support
endef

$(eval $(call KernelPackage,fs-nfsv3))

AutoLoad、KernelPackage函数可以看include目录下kernel.mk定义，都是负责install还有生成etc/moules.d的配置文件

额外内核模块

这部分需要添加在较上层的目录，和package/kernel/linux同级目录package/kernel/下。在此每个模块都有单独的目录，根据需要在其中添加src目录，Makefile、.c源文件、Kconfig等。具体内容请参考已有模块目录，以此为模版修改就行了。

本文章由 http://www.wifidog.pro/2014/12/31/wifidog-openwrt%E5%86%85%E6%A0%B8%E6%A8%A1%E5%9D%97.html 整理编辑，转载请注明出处

【一、LuCI配置界面开发的框架】

LuCI是OpenWrt上的Web管理界面，LuCI采用了MVC三层架构，同时其使用Lua脚本开发，所以开发LuCI的配置界面不需要编辑任何的Html代码，除非想自己单独去创建网页（View层），否则我们基本上只需要修改Model层就可以了。官方也有一个如何去创建模块的说明文档，虽然写的比较晦涩：
http://luci.subsignal.org/trac/wiki/Documentation/ModulesHowTo
要为LuCI增加一个新模块，首先需要创建两个文件，一个位于Controller（/usr/lib/lua/luci/controller/）下，定义模块的入口；另一个位于Model（/usr/lib/lua/luci/model/cbi/）下，为配置模块实际的代码。
首先我们定义模块的入口，在/usr/lib/lua/luci/controller/下创建一个lua文件，类似如下：

module("luci.controller.控制器名", package.seeall)

function index()
        entry(路径, 调用目标, _("显示名称"), 显示顺序)
        end

第一行说明了程序和模块的名称，比如在controller/目录创建一个mymodule.lua，那么就可以写成“luci.controller.mymodule”，如果你的程序比较多，可能分为好几个模块，那么可以在controller下再常见一个子目录，比如controller/myapp/，那么就可以写成“luci.controller.myapp.mymodule”。

接下来的entry表示添加一个新的模块入口，官方给出了entry的定义，其中后两项都是可以为空的：

entry(path, target, title=nil, order=nil)

第一项是访问的路径，不过路径是按字符串数组给定的，比如路径按如下方式写“{"click", "here", "now"}”，那么就可以在浏览器里访问“http://192.168.1.1/cgi-bin/luci/click/here/now”来访问这个脚本。而通常我们希望为管理员菜单添加脚本，那么我们需要按如下方式编写“{"admin", "一级菜单名", "菜单项名"}”，系统会自动在对应的菜单中生成菜单项。比如想在“网络”菜单下创建一个菜单项，那么一级菜单名可以写为“network”。

第二项为调用目标，调用目标分为三种，分别是执行指定方法（Action）、访问指定页面（Views）以及调用CBI Module。

• 第一种可以直接调用指定的函数，比如点击菜单项就直接重启路由器等等，比如写为“call("function_name")”，然后在lua文件下编写名为function_name的函数就可以调用了。
• 第二种可以访问指定的页面，比如写为“template("myapp/mymodule")”就可以调用/usr/lib/lua/luci/view/myapp/mymodule.htm文件了。
• 而如果要编写配置页面，那么使用第三种方法无非是最方便的，比如写为“cbi("myapp/mymodule")”就可以调用/usr/lib/lua/luci/model/cbi/myapp/mymodule.lua文件了。

而title和order无非是针对管理员菜单来的，可以参考其他的lua文件来决定编写的内容。

这里我们创建/usr/lib/lua/luci/controller/njitclient.lua文件，定义我们的入口，代码如下：

module("luci.controller.njitclient", package.seeall)

function index()
        entry({"admin", "network", "njitclient"}, cbi("njitclient"), _("NJIT Client"), 100)
        end

【二、 用Lua和UCI接口开发LuCI配置模块 】

njit-client:
为njit-client做好的Web配置界面也已经开源，地址： https://github.com/mayswind/luci-app-njitclient.
我们要做的实际上就是希望能将用户名、密码等信息存储在路由器文件中，同时路由器开机时能根据设定的配置自动运行njit-client，同时我们还希望能动态的禁用和启用njit-client等等。所以最方便的方式就是使用CBI Module，上一节我们也添加了这个调用，那么接下来我们就要根据上边写的路径来创建 /usr/lib/lua/luci/model/cbi/njitclient.lua文件。

开发LuCI的配置模块有很多种方式，比较基本的可以用SimpleForm，就跟开发普通的Web应用类似，当然最方便的还是使用UCI（Unified Configuration Interface，统一配置接口）的方式，因为使用UCI接口可以使得在LuCI中可以无需考虑配置文件如何存储和读取（这种方式也会自动创建“保存&应用”、“保存”以及“复位”三个按钮），同时在Bash文件中也可以非常方便的存储和读取。

对于使用UCI的方式，我们首先需要创建对应的配置文件（如果配置文件不存在的话，访问配置页面将会报错），格式即为linux配置文件的格式，文件需要存储在/etc/config，比如文件路径为“/etc/config/njitclient”，内容如下：

config login
    option username ''
    option password ''
    option ifname 'eth0'
    option domain ''

然后我们要在CBI Module的lua文件中首先需要映射与存储文件的关系，比如：

m = Map("配置文件文件名", "配置页面标题", "配置页面说明")

第一个参数即为配置文件存储的文件名，不包含路径，比如按上述创建的话，应该写为“njitclient”，而第二与第三个参数则是用在来页面上显示的，比如如下所示的图：

接下来需要创建与配置文件中对应的Section，Section分为两种，NamedSection和TypedSection，前者根据配置文件中的Section名，而后者根据配置文件中的Section类型，这里我们使用后者，代码如下。同时我们设定不允许增加或删除Section（“.addremove = false”），以及不显示Section的名称（“.anonymous = true”）。

s = m:section(TypedSection, "login", "")
s.addremove = false
s.anonymous = true

接下来我们需要创建Section中不同内容的交互（创建Option），常见的比如有Value（文本框）、ListValue（下拉框）、Flag（选择框）等等，详细的可以参考官方的文档： http://luci.subsignal.org/trac/wiki/Documentation/CBI

创建Option的过程非常简单，而且创建后系统会无需考虑读取以及写入配置文件的问题，系统都会自动处理。但是根据上述的要求，我们在应用配置以后可能希望启用、禁用或重新启动njit-client，所以我们还需要在页面最后判断用户是否点击了“应用”按钮，这里与编写asp网页等都是相同的，我们可以通过如下的代码判断是否点击了“应用”按钮：

local apply = luci.http.formvalue("cbi.apply")
if apply then
    --[[
        需要处理的代码
    ]]--
end

由于剩余的代码都非常简单，所以所以这部分的全部代码见下：

require("luci.sys")

m = Map("njitclient", translate("NJIT Client"), translate("Configure NJIT 802.11x client."))

s = m:section(TypedSection, "login", "")
s.addremove = false
s.anonymous = true

enable = s:option(Flag, "enable", translate("Enable"))
name = s:option(Value, "username", translate("Username"))
pass = s:option(Value, "password", translate("Password"))
pass.password = true
domain = s:option(Value, "domain", translate("Domain"))

ifname = s:option(ListValue, "ifname", translate("Interfaces"))
for k, v in ipairs(luci.sys.net.devices()) do
    if v ~= "lo" then
        ifname:value(v)
    end
end

local apply = luci.http.formvalue("cbi.apply")
if apply then
    io.popen("/etc/init.d/njitclient restart")
end

return m

其中Luci全部类库的函数定义和使用说明可以参考如下地址： http://luci.subsignal.org/api/luci/index.html

【三、在Bash文件中调用UCI接口】

上边我们已经完成了LuCI配置界面的开发，在配置界面中我们已经能读取并保存配置文件了。接下来我们要编写/etc/init.d/njitclient脚本，使程序最终能运行起来。关于UCI接口在脚本文件中的官方说明可以参考： http://wiki.openwrt.org/doc/devel/config-scripting
要使用UCI调用脚本，首先第一步需要读取配置文件，命令为“config_load 配置文件名”，比如我们可以这样读入刚才的配置文件：

config_load njitclient

接下来要遍历配置文件中的Section，可以使用“config_foreach 遍历函数名 Section类型”，例如我们可以这样：

config_foreach run_njit login

然后我们去编写名为“run_njit”的函数，在这个函数中，我们可以使用“config_get 变量名 Section名 Section参数名”获取变量的值，或者使用“config_get_bool 变量名 Section名 Section参数名”获取布尔型的值。所以全部的代码见下：

#!/bin/sh /etc/rc.common
START=50

run_njit()
{
    local enable
    config_get_bool enable $1 enable

    if [ $enable ]; then
        local username
        local password
        local domain
        local ifname

        config_get username $1 username
        config_get password $1 password
        config_get domain $1 domain
        config_get ifname $1 ifname

        if [ "$domain" != "" ]; then
            njit-client $username@$domain $password $ifname &
        else
            njit-client $username $password $ifname &
        fi

        echo "NJIT Client has started."
    fi
}

start()
{
    config_load njitclient
    config_foreach run_njit login
}

stop()
{
     killall njit-client
     killall udhcpc

    echo "NJIT Client has stoped."
}

【四、 编译开发的程序 】

如果按上述内容创建好上述4个文件，那么配置页面和程序就能在OpenWrt上运行起来了。但是如果要想把自己写的程序打包，还需要创建OpenWrt的Makefile来使用OpenWrt的SDK进行编译。

关于LuCI上配置Makefile的官方说明可以见这个地址： http://luci.subsignal.org/trac/wiki/Documentation/Modules

无非就是定义包的名称（PKG_NAME）、版本和生成次数（PKG_VERSION、PKG_RELEASE）、在menuconfig中的分类说明等（define Package/luci-app-njitclient）以及安装时进行的操作（define Package/luci-app-njitclient/install）等等。其中安装的文件分为三种，分别是配置文件、可执行文件以及其他数据文件，其中配置可执行文件时，会自动加入执行权限的，所以不需要额外进行处理。Makefile全部的代码见下：
include $(TOPDIR)/rules.mk

PKG_NAME:=luci-app-njitclient
PKG_VERSION=1.0
PKG_RELEASE:=1

PKG_BUILD_DIR:=$(BUILD_DIR)/$(PKG_NAME)

include $(INCLUDE_DIR)/package.mk

define Package/luci-app-njitclient
SECTION:=luci
CATEGORY:=LuCI
SUBMENU:=3. Applications
TITLE:=NJIT 802.1X Client for LuCI
PKGARCH:=all
endef

define Package/luci-app-njitclient/description
This package contains LuCI configuration pages for njit8021xclient.
endef

define Build/Prepare
endef

define Build/Configure
endef

define Build/Compile
endef

define Package/luci-app-njitclient/install
$(INSTALL_DIR) $(1)/etc/config
$(INSTALL_DIR) $(1)/etc/init.d
$(INSTALL_DIR) $(1)/usr/lib/lua/luci/model/cbi
$(INSTALL_DIR) $(1)/usr/lib/lua/luci/controller

$(INSTALL_CONF) ./files/root/etc/config/njitclient $(1)/etc/config/njitclient
$(INSTALL_BIN) ./files/root/etc/init.d/njitclient $(1)/etc/init.d/njitclient
$(INSTALL_DATA) ./files/root/usr/lib/lua/luci/model/cbi/njitclient.lua $(1)/usr/lib/lua/luci/model/cbi/njitclient.lua
$(INSTALL_DATA) ./files/root/usr/lib/lua/luci/controller/njitclient.lua $(1)/usr/lib/lua/luci/controller/njitclient.lua
endef

$(eval $(call BuildPackage,luci-app-njitclient))

接下来在编译目录下的package目录下创建一个文件夹，如njitclient，然后将所有的文件按目录复制到该目录下即可。之后配置好OpenWrt的交叉编译环境后就可以使用OpenWrt SDK进行编译了，由于这类文章较多，故不再赘述，可以参考相关链接3及之后的文章。

本文章由 http://www.wifidog.pro/2014/12/30/wifidog-openwrt-luci.html 整理编辑，转载请注明出处

1.引言

OpenWRT中采用LuCI作为它的Web interface界面框架，采用Lua语言。在本文中将以一个简单的示例详细描述如何自定义开发一个界面，对一个配置文件进行操作。

2.Model与Controler

MVC的设计理念是进行LuCI开发的一个关键，什么是MVC请参看如下Blog：

http://www.cnblogs.com/gnuhpc/archive/2012/12/21/2827597.html

在LuCI中Controller的文件定义在固件中的/usr/lib/lua/luci/controller目录中，模版目录在/usr/lib/lua/luci/view目录下，而model则是在/usr/lib/lua/luci/model中。而model中有一个特殊的模块叫做CBI，被称为LuCI中最酷的功能，该模块的功能是方便的对一个配置文件进行修改。

3.示例

本文中的页面建立在LuCI界面的network下，不单独创建页面，因此无需写view，只用些controller和model就可以了。

1）首先创建一个controller

ccontroller/mycbi.lua

module("LUCI.controller.mycbi", package.seeall)

function index()
    entry({"admin", "network", "mycbi_change"}, cbi("mycbi-model/mycbimodule"), "Change My Conf", 30).dependent=false
end

解释一下关键代码：

在index()函数中，使用entry函数来完成每个模块函数的注册，官方说明文档如下：

entry(path, target, title=nil, order=nil)

path is a table that describes the position in the dispatching tree: For example a path of {"foo", "bar", "baz"} would insert your node in foo.bar.baz.
target describes the action that will be taken when a user requests the node. There are several predefined ones of which the 3 most important (call, template, cbi) are described later on on this page
title defines the title that will be visible to the user in the menu (optional)
order is a number with which nodes on the same level will be sorted in the menu (optional)
其中target主要分为三类：call，template和cbi。call用来调用函数，template用来调用已有的htm模版，而CBI模块则是使用非常频繁也非常方便的模块，包含的一系列lua文件构成界面元素的组合，所有cbi模块中的控件都需要写在luci.cbi.Map中，在cbi模块中定义各种控件，Luci系统会自动执行大部分处理工作。在cbi.lua文件中封装了所有的控件元素，例如复选框，下拉列表等。

2）创建model

#mkdir /usr/lib/lua/luci/model/cbi/mycbi-model

#vim /usr/lib/lua/luci/model/cbi/mycbi-model/mycbimodule.lua

m = Map("mycbi", "mycbi conf change interface")
s = m:section(TypedSection, "MySection")
s.addremove = true
s:option(Value, "username", "Name:")
key=s:option(Value, "password", "Password")
key.password=true;
return m

解释一下关键代码：

3)创建配置文件

#vim /etc/config/mycbi

config  'MySection'  'mycbi'

option 'username' 'youruser'
option 'password' 'yourpass'

1. 测试

进入OpenWRT界面，登陆后就可以点击“网络”，如果是英文就点击network，可以看到我们添加的子页面入口：

点击后进入页面如下：

输入用户名密码：root/test，点击保存，后台查看配置文件已经被更改：

5.问题记录

1）首先，配置文件不能有任何后缀，否则页面加载后是空页面

2）如果出现500 错误，说明lua文件写的有问题，要么是路径错误，要么是语法错误，暂时没找到写日志的方法，可以用wireshark抓包看错误，如下：

6.参考文献

http://www.cnblogs.com/dwayne/archive/2012/04/18/2455145.html
http://www.cnblogs.com/dwayne/archive/2012/04/21/2460830.html

转自：http://www.cnblogs.com/gnuhpc/archive/2013/08/31/3293204.html

本文章由 http://www.wifidog.pro/2014/12/30/wifidog-openwrt%E9%85%8D%E7%BD%AE%E8%AE%BE%E7%BD%AE%E9%A1%B5%E9%9D%A2.html 整理编辑，转载请注明出处