OpenWrt路由器上的LuCI模块开发

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

LuCI是OpenWrt上的Web管理界面，LuCI采用了MVC三层架构，同时其使用Lua脚本开发，所以开发LuCI的配置界面不需要编辑任何的Html代码，除非想自己单独去创建网页（View层），否则我们基本上只需要修改Model层就可以了。

要为LuCI增加一个新模块，首先需要创建两个文件，一个位于Controller（/usr/lib/lua/luci/controller/）下，定义模块的入口；另一个位于Model（/usr/lib/lua/luci/model/cbi/）下，为配置模块实际的代码。

如果我们是用openwrt单独编译LuCi中的某一个功能，再安装到路由器上的话，将这几个文件放在一个文件夹即可，比如我们在openwrt/package/创建一个test文件夹，这个文件夹就是我这个luci功能的文件夹，此文件夹下面创建一个Makefile文件，再创建一个files文件夹，所有的lua文件以及其他用到的文件统一放到这个files文件夹下即可，他们安装到路由器上的路径是由与files文件夹同级的Makefile文件决定的。文件夹的具体结构，参考以下文章

http://blog.csdn.net/qq_35718410/article/details/52787882

首先我们定义模块的入口，在/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等等。所以最方便的方式就是使用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”，内容如下：