外观
webnet 示例
2025-10-29
本文将介绍如何基于 webnet 组件搭建嵌入式网站,帮助读者熟悉开发环境,并掌握网站构建的基本流程与关键技术。
webnet 功能
本文旨在教会读者使用 webnet 的以下功能:
AUTH 功能:通过用户名和密码对特定目录访问进行权限控制。
CGI 功能:通过网页调用已注册的 C 函数,实现动态响应处理。
ASP 功能:自动替换 HTML 页面中的注册占位符,显示动态内容。
SSI 功能:支持 HTML 页面中嵌入其他文件内容,实现页面复用。
INDEX 功能:在无默认首页时自动列出目录下的文件。
ALIAS 功能:将虚拟路径映射到实际目录,实现灵活路径管理。
UPLOAD FILE 功能:支持通过网页上传文件到指定目录。
硬件连接
将开发板网口连接到路由器。

创建工程点击展开
依次点击 “文件” -> “新建” -> "RT-Thread RuiChing App 项目"。

在弹出新建向导中选择 开发版 、BSP: 、示例 、 调试器/下载器。选择好之后点击 “完成”。

点击 “完成” 后,等待工程创建完成。

创建完成。

构建工程点击展开
单击工程使工程进入 Active-Debug 模式。

点击工具栏上的构建按钮进行工程编译。

构建成功后,会显示构建成功的信息。

固件下载点击展开
固化设备树

固化 APP

核心示例代码
设置 CGI 函数,注册占位符,映射目录,设置权限,启动 webnet。
applications/webnet_test.c
void webnet_test(void)
{
#ifdef WEBNET_USING_CGI
webnet_cgi_register("hello", cgi_hello_handler);
webnet_cgi_register("calc", cgi_calc_handler);
#endif
#ifdef WEBNET_USING_ASP
webnet_asp_add_var("version", asp_var_version);
#endif
#ifdef WEBNET_USING_ALIAS
webnet_alias_set("/test", "/admin");
#endif
#ifdef WEBNET_USING_AUTH
webnet_auth_set("/admin", "admin:admin");
#endif
#ifdef WEBNET_USING_UPLOAD
extern const struct webnet_module_upload_entry upload_entry_upload;
webnet_upload_add(&upload_entry_upload);
#endif
webnet_init();
}运行示例
操作步骤
启动 webnet
webnet 的根目录默认设置为 sdmmc/webnet, 默认解析根目录下的 index.html 文件。
将 applications 目录下的 webnet 文件夹拷贝到 SD 卡中,插入 SD 卡到开发板中。
在控制台中输入 webnet_test 命令,启动 webnet。
测试 webnet 功能
在浏览器输入开发板的 ip 地址,访问 webnet。

