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,
        IPAddr,
        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(IPAddr);
    ZLIP_Release();
    return TRUE;
}

编写ZLWeb的网页

ZLWeb的网页遵从HTML标准。在设计网页前首先需要有一个网页目录“例如为“\工具\ZLFsCreate\web”，称之为网页根目录。在网页根目录下必须有一个index.html文件，该文件是网页首页，网页根目录下可存在图片和子目录。由于51单片机存储空间的限制，所有网页文件总大小是有限制的，默认为32KB。主要注意ZLWeb的CGI远程控制网页和Dynamic标签网页的写法。

产生ZLFs文件系统

使用卓岚的“\工具\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。此时就可以下载运行了。