ZLWeb API
ZLWeb提供ZLWeb_Init、ZLWeb_AddPostHandler、ZLWeb_AddTagHandler、ZLWeb_Process
4个API函数。
ZLWeb_Init
用于初始化ZLWeb模块。
void ZLWeb_Init(
zl_u8 DT_XDATA * buf,
zl_u16 buf_size
);
ZLWeb_AddPostHandler
为用于远程控制的CGI功能设置句柄函数。
zl_u8 ZLWeb_AddPostHandler(
zl_u8 * FileName,
zl_u8 * variable,
PostHandler function
);
ZLWeb_AddTagHandler
为用于远程数据采集的Dynamic标签设置句柄。
zl_u8 ZLWeb_AddTagHandler(
zl_u8 * TagName,
TagHandler function
);
ZLWeb_Process
ZLWeb运行主进程。
void ZLWeb_Process(
IP_ADDR ServerIP
);
编写代码
使用ZLWeb时编写main函数为如下形式。另外需根据ZLWeb_AddPostHandler、ZLWeb_AddTagHandler的使用方法,编写必要的句柄函数。
int main(void)
{
/* this devRTL will be used in tcp/ip, pointed
by NetIf->Info */
struct zlip_addr_info xdata addr_info=
{
ETHER_ADDR,
ipadsdr,
NetMask,
GateWay
};
/*
* init
*/
ZLIP_Init(&addr_info);
ZLWeb_Init(data_buf_ex, DATA_SIZE);
ZLWeb_AddPostHandler("/control.html",
"LED_GREEN", &LedGreenHandler);
ZLWeb_AddPostHandler("/control.html",
"LED_RED", &LedRedHandler);
ZLWeb_AddTagHandler("key1_status",
&Key1Handler);
ZLWeb_AddTagHandler("key2_status",
&Key2Handler);
ZLWeb_Process(ipadsdr);
ZLIP_Release();
return TRUE;
}
编写ZLWeb的网页
ZLWeb的网页遵从HTML标准。在设计网页前首先需要有一个网页目录“例如为“\工具\ZLFsCreate\web”,称之为网页根目录。在网页根目录下必须有一个index.html文件,该文件是网页首页,网页根目录下可存在图片和子目录。由于51单片机存储空间的限制,所有网页文件总大小是有限制的,默认为32KB。主要注意ZLWeb的CGI远程控制网页和Dynamic标签网页的写法。
产生ZLFs文件系统
使用利来囯际W66的“\工具\ZLFsCreate\ZLFsCreate.exe”程序可以将设计好的网页目录打包为ZLFs格式的代码。
1. 运行ZLFsCreate.exe,选择Root Directory,将其选择为设计好的网页的根目录。
2. 选择Out put file为myoutput.txt,这可以是一个不存在的文件,系统会自动新建这个文件。
3. 设置“Max size of the Fs”,这可以设置整个文件系统大小的上限,可以采用默认值——32K。
4. 点击Create,界面显示如下:
点击确定。
5. 打开myoutput.txt,将其中的数据全部拷贝到myweb.c文件的末尾。
之后编译连接产生myweb.hex。此时就可以下载运行了。