花生壳PHTunnel嵌入Openwrt实例

概述

本文详细介绍如何将PHTunnel封装成一个openwrt标准组件，并编译到自己的openwrt固件中。在阅读本文档前，请先熟悉PHTunnel的基本原理文档( 花生壳PHTunnel嵌入文档 )

PHTunnel组件制作

下载

下载自己的编译平台的二进制PHTunnel文件是第一步要做的，我们可以到贝锐科技开放平台网站（https://developer.oray.com/sdk）进行下载，根据自己的型号进行下载，比如我的路由器是基于mipsel，c库使用的是uclibc，那么我可以进入xxxxx，进入xxxxxxxx，并下载mipsel-uclibc-PHTunnel文件。

规划目录结构

接下来的任务是规划自己的PHTunnel组件安装后，在openwrt系统上是怎样的目录结构。

首先核心的应用程序PHTunnel我们可以放在/usr/bin目录下，因为它是一个非管理员应用，所以一般比放在/usr/sbin目录下要更科学一些。

uci配置文件：由于openwrt的uci是常用的配置解决方案(不理解uci可参阅其他文档)，所以需要一个uci配置文件，该文件通常放在/etc/config目录下，同时我们取名同样为PHTunnel，这样就可以使用uci set PHTunnel.xx.xx等操作PHTunnel的配置了。

根据PHTunnel列出的参数，uci的配置如下：

启动脚本：通常应用都是作为守护脚本运行，所以PHTunnel也会制作成守护程序，自动运行，所以需要在/etc/init.d中建立PHTunnel的启动脚本，名称也叫PHTunnel。

hotplug.d机制：为了及时响应网络状态，快速重启PHTunnel，可使用hotplug机制。这样在wan口断开重新连上网的时候，能马上重启PHTunnel。在/etc/hotplug.d/iface下需要创建一个xx-PHTunnel的脚本，其中xx代表脚本执行顺序，可以随便填。

这样，安装后的目录结构是如下图

编写PHTunnel组件Makefile

根据目录结构规划，现在来编写组件，由于openwrt的组件是用makefile文件编写。

将makefile及规划的files目录统一放在PHTunnel目录内，然后放在openwrt的package/utils目录中即可(可放在package下的任何位置)，再来看一下目录结构

这时执行make menuconfig后，就能看到PHTunnel组件了

选中该组件后保存，执行make，就可以编译出带PHTunnel的固件了和对应的PHTunnel的ipk组件包了。

启动脚本

启动脚本用于启动与停止PHTunnel，启动后读取uci配置，变成PHTunnel的启动参数，然后启动PHTunnel程序，代码如下：

这里用到了openwrt的PROCD机制，这样可以在PHTunnel意外崩溃的情况下，自动重启。

hotplug脚本

用于在wan接口连接有效时，重新开启PHTunnel，加速重连速度。

PHTunnel-luci-app组件制作

功能

PHTunnel运行后，需要进行扫码登录，管理，解绑等操作，这些都是需要与客户的交互操作，openwrt提供的luci是实现交互的最佳选择，也是最正式的方式，下面来制作基于luci的PHTunnel组件。

核心模块

luci的代码区域在/usr/lib/lua/luci中，所以所有交互的web代码都放在这个下面，首先是核心的基础库PHTunnel.lua，它将提供所有核心函数，如获取二维码，登录信息和解绑操等核心功能。

所有函数的核心都是调用wget来访问rpc服务和官方提供的web服务。

LUCI页面

完成核心函数库后，接下来就是根据luci的架构进行开发。首先是规划菜单与菜单项，如图：

完成这样的菜单，需要在controller目录下实现，如图：

其中setup页面用于设置基本参数，Status页面用于扫码与解绑，Log用于显示日志。

Setup页面

设置页面是一个纯UCI页面，我们可以使用luci提供的cbi模块开发。

显现的页面如图

Status页面

该页面用于显示二维码，管理界面链接及解绑。相关代码在view/oray/PHTunnel_status.htm, view/oray/PHTunnel_inner_status.htm, view/oray/PHTunnel_log_off.htm，

PHTunnel_status.htm : 用于显示当前状态。

PHTunnel_inner_status.html : 用于后台实时检测绑定状态，当用户使用手机刷二维码绑定后，PHTunnel_status.htm页面动态显示绑定账号。

PHTunnel_log_off : 用于解绑账号

Log页面

用于显示日志，该页面相对简单(view/oray/PHTunnel_log.htm)，

通过uci获取日志路径，并使用cat命令将文件内容输出即可。

制作组件的makefile

与制作PHTunnel组件一样，将所有文件组织成目录树，并加入Makefile

Makefile

最后同样将组件复制到openwrt/package/utils/下，这样我们可以在配置界面中看到PHTunnel-luci-app组件

选择以上两个组件，充分编译后，即可在本地的luci界面上使用PHTunnel了。