深入解析OpenWrt中的LuciAPI文档及szloogson模块构建

OpenWrt 是一款强大的嵌入式 Linux 平台，特别适用于无线路由器等设备，支持多种硬件架构，并提供了一个丰富的软件库。开发人员可以通过添加新的软件包来扩展其功能，从而满足特定的应用需求。

### 准备工作
在 OpenWrt 中添加新软件包非常简便，只需遵循其约定即可轻松完成。新增的软件包既可以是来自互联网的开源软件，也可以是自定义开发的软件。具体步骤包括在 `package` 目录下创建一个新的子目录，并在此目录中编写 Makefile 文件以与 OpenWrt 集成。此外，还可以创建一个 `patches` 目录用于存放对源代码的修改补丁。

本文介绍的模块是基于 Luci 的，因此我们在 `package/feeds/luci` 目录下创建了一个名为 `szloogson` 的新目录。

### 模块 Makefile 编写
在 `szloogson` 目录中创建一个 `Makefile` 文件，该文件的内容如下所示：

```makefile
# 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-szloogson/description
This package provides 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
# 安装 Shell 脚本
$(INSTALL_DIR) $(1)/etc/init.d
$(INSTALL_BIN) ./files/loogson.init $(1)/etc/init.d/loogson

# 安装配置文件
$(INSTALL_DIR) $(1)/etc/config
$(INSTALL_CONF) ./files/loogson.config $(1)/etc/config/loogson

# 安装可执行文件
$(INSTALL_DIR) $(1)/usr/sbin
$(INSTALL_BIN) $(PKG_BUILD_DIR)/gsc3280_led $(1)/usr/sbin/gsc3280_led

# 安装 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))
```

#### 关键点解释
- **第8行**：`$(TOPDIR)/rules.mk` 文件通常位于 Makefile 的开头，用于定义一些基本的包信息。
- **第17行**：`include $(INCLUDE_DIR)/package.mk` 文件在定义完包的基本信息后引入，用于定义用户态软件包的编译规则。
- **第19行**：`define Package/luci-app-szloogson` 定义了包的基本信息，如包名、分类、子菜单位置、标题等。
- **第27行**：`define Package/luci-app-szloogson/description` 提供了包的详细描述。
- **第31行**：`define Build/Prepare` 定义了编译前的准备工作，如创建必要的目录并复制源代码。
- **第36行**：`define Build/Configure` 用于配置编译环境，对于自定义开发的包通常不需要此步骤。
- **第39行**：`define Build/Compile` 定义了编译过程，指定了交叉编译器和目标架构。
- **第46行**：`define Package/luci-app-szloogson/install` 定义了安装过程，包括将编译后的文件复制到指定位置。

### 内核模块包定义
除了用户态软件包外，OpenWrt 还支持内核模块的开发。内核模块可以动态加载到内核中，从而提供额外的功能。内核模块的定义与用户态软件包类似，但使用 `KernelPackage` 开头，并且需要指定 `SUBMENU` 和 `DEFAULT` 等参数。

#### 关键参数
- **SUBMENU**：定义内核模块在 `make menuconfig` 中的子菜单位置。
- **DEFAULT**：指定内核模块是否直接编入内核 (`y`) 或生成为模块 (`m`)。
- **AUTOLOAD**：定义内核模块在系统启动时自动加载的优先级和模块名。

### 自动运行脚本
如果需要在系统启动时自动运行某些程序，可以在 `/etc/init.d` 目录下添加相应的脚本文件，并设置 `START` 和 `STOP` 参数以控制启动和停止的优先级。

通过以上步骤，您可以成功地在 OpenWrt 上构建和部署自定义的 Luci 模块，进一步扩展其功能。