背景

AWTK全稱 Toolkit AnyWhere，是 ZLG 開發(fā)的開源 GUI 引擎，旨在為嵌入式系統(tǒng)、WEB、各種小程序、手機(jī)和 PC 打造的通用 GUI 引擎，為用戶提供一個(gè)功能強(qiáng)大、高效可靠、簡(jiǎn)單易用、可輕松做出炫酷效果的 GUI 引擎。

簡(jiǎn)介

在前一篇文章中，我們介紹了自定義 AWPLC 功能塊的基本方法，但是有些部分的內(nèi)容并沒有提到，比如：

staticret_taw_plc_fb_ztimer_get_prop(aw_plc_fb_t*fb,constchar*name,value_t*v){
aw_plc_fb_ztimer_t*ztimer=AW_PLC_FB_ZTIMER(fb);

if(tk_str_eq(name,AW_PLC_FB_ZTIMER_PROP_IN)){
value_set_bool(v,ztimer->in);
returnRET_OK;
}

if(tk_str_eq(name,AW_PLC_FB_ZTIMER_PROP_PT)){
value_set_uint64(v,ztimer->pt);
returnRET_OK;
}

if(tk_str_eq(name,AW_PLC_FB_ZTIMER_PROP_Q)){
value_set_bool(v,ztimer->q);
returnRET_OK;
}

if(tk_str_eq(name,AW_PLC_FB_ZTIMER_PROP_ET)){
value_set_uint64(v,ztimer->et);
returnRET_OK;
}

if(tk_str_eq(name,AW_PLC_FB_ZTIMER_PROP_COUNT)){
value_set_uint32(v,ztimer->count);
returnRET_OK;
}

returnRET_NOT_FOUND;

}

*這樣的代碼看起來很簡(jiǎn)單，但是恰恰容易出錯(cuò)，更容易讓人厭倦，沒有什么樂趣。

/**
*@classaw_plc_fb_ztimer_t
*@parentaw_plc_fb_t
*@annotation["fb"]
*循環(huán)定時(shí)器。
*
*>當(dāng)輸入 IN 為 TRUE 時(shí)，開始計(jì)時(shí)，輸出 Q 為 FALSE，ET 開始記錄過去的時(shí)間。
*>定時(shí)時(shí)間到時(shí)，COUNT 增加 1，輸出 Q 在本次循環(huán)為 TRUE，ET 重置為0。
*>輸入 IN 為 FALSE 時(shí)重置定時(shí)器。
*/
typedefstruct_aw_plc_fb_ztimer_t{
aw_plc_fb_tfb;

/**
*@property{bool_t}in
*@annotation["in"]
*為 TRUE 開始計(jì)時(shí)，為 FALSE 時(shí)重置定時(shí)器。
*/
bool_tin:1;

/**
*@property{iec_time_t}pt
*@annotation["in"]
*預(yù)設(shè)時(shí)間(ms)。
*/
iec_time_tpt;

/**
*@property{bool_t}q
*@annotation["default","out"]
*定時(shí)時(shí)間是否到（僅在時(shí)間到的當(dāng)次循環(huán)為 TRUE)。
*/
bool_tq:1;

/**
*@property{iec_time_t}et
*@annotation["out"]
*過去時(shí)間(ms)。
*/
iec_time_tet;

/**
*@property{uint32_t}count
*@annotation["out"]
*定時(shí)器時(shí)間到的次數(shù)。
*/
uint32_tcount;

/**
*@property{bool_t}prev_in
*@annotation["private"]
*前一次的輸入。
*/
bool_tprev_in:1;

/**
*@property{uint8_t}state
*@annotation["private"]
*狀態(tài)。
*/
uint8_tstate;

/**
*@property{iec_time_t}current_time
*@annotation["private"]
*當(dāng)前時(shí)間(ms)。
*/
iec_time_tcurrent_time;

/**
*@property{iec_time_t}start_time
*@annotation["private"]
*開始時(shí)間(ms)。
*/
iec_time_tstart_time;

}aw_plc_fb_ztimer_t;

{
"type":"fb_zlg_misc.ztimer",
"real_type":"ZTIMER",
"helpUrl":"https://developer.zlg.cn",
"style":"fb",
"desc":"循環(huán)定時(shí)器。 >當(dāng)輸入 IN 為 TRUE 時(shí)，開始計(jì)時(shí)，輸出 Q 為 FALSE，ET 開始記錄過去的時(shí)間。
>定時(shí)時(shí)間到時(shí)，COUNT 增加 1，輸出 Q 在本次循環(huán)為 TRUE，ET 重置為0。 >輸入 IN 為 FALSE 時(shí)重置定時(shí)器。",
"ins":[
{
"name":"IN",
"desc":"為 TRUE 開始計(jì)時(shí)，為 FALSE 時(shí)重置定時(shí)器。",
"min_connections":1,
"max_connections":1,
"data_type":"BOOL"
},
{
"name":"PT",
"desc":"預(yù)設(shè)時(shí)間(ms)。",
"min_connections":1,
"max_connections":1,
"data_type":"TIME"
}
],
"outs":[
{
"name":"Q",
"desc":"定時(shí)時(shí)間是否到（僅在時(shí)間到的當(dāng)次循環(huán)為 TRUE)。",
"data_type":"BOOL"
},
{
"name":"ET",
"desc":"過去時(shí)間(ms)。",
"data_type":"TIME"
},
{
"name":"COUNT",
"desc":"定時(shí)器時(shí)間到的次數(shù)。",
"data_type":"DWORD"
}
]

}

#ZTIMER

##功能

循環(huán)定時(shí)器。

>當(dāng)輸入 IN 為 TRUE 時(shí)，開始計(jì)時(shí)，輸出 Q 為 FALSE，ET 開始記錄過去的時(shí)間。
>定時(shí)時(shí)間到時(shí)，COUNT 增加 1，輸出 Q 在本次循環(huán)為 TRUE，ET 重置為0。
>輸入 IN 為 FALSE 時(shí)重置定時(shí)器。

##輸入

* IN **BOOL**為 TRUE 開始計(jì)時(shí)，為 FALSE 時(shí)重置定時(shí)器。
* PT **TIME**預(yù)設(shè)時(shí)間(ms)。

##輸出

* Q **BOOL**定時(shí)時(shí)間是否到（僅在時(shí)間到的當(dāng)次循環(huán)為 TRUE)。
* ET **TIME**過去時(shí)間(ms)。

在進(jìn)入正題前，我們先聊一下代碼生成器的基本知識(shí)。

代碼生成器基本知識(shí)

* 編寫能編寫代碼的代碼。-- 《程序員修煉之道》

代碼生成器是一個(gè)普通程序，它能夠生成另外的目標(biāo)代碼?？梢圆灰a生成器，直接編寫目標(biāo)代碼嗎？通常情況下是可以的，但是這違背了優(yōu)秀程序員的第一美德-懶惰。因?yàn)閼卸?，所以能讓?jì)算機(jī)做的事，優(yōu)秀程序員是不會(huì)自己去做的。

• 被動(dòng)代碼生成器目標(biāo)代碼生成之后，需要進(jìn)行修改和完善，然后獨(dú)立發(fā)展和維護(hù)，與代碼生成器再與關(guān)系。比如 IDE 的 Wizard 就是此例。前面提到的自定義控件生成器，代碼生成之后，你需要在上面添加需要的功能。如果過了一段時(shí)間，你想為控件添加一個(gè)新的屬性，可能會(huì)遇到一點(diǎn)麻煩，要么手工添加；要么重新生成代碼，然后把之前修改的代碼重新加上，無論哪種方式都不是愉快的方式。被動(dòng)代碼生成器雖然有它的缺陷，但是仍然可以給我們帶來很大幫助。

• 主動(dòng)代碼生成器目標(biāo)代碼生成之后，不需要進(jìn)行修改和完善，每次都重新生成，如果需要修改，修改元數(shù)據(jù)和代碼生成器。比如編譯器就是此例。前面提到的 MVVM 的 ViewModel 和 AWFlow 應(yīng)用代碼生成也屬于此類。如果可以，優(yōu)先使用主動(dòng)代碼生成器。

這是代碼生成器的基本形式：代碼生成器讀取元數(shù)據(jù)，生成目標(biāo)代碼。元數(shù)據(jù)是描述數(shù)據(jù)的數(shù)據(jù)，這里是描述目標(biāo)代碼的數(shù)據(jù)，也就是控制目標(biāo)代碼的參數(shù)。一般情況下，目標(biāo)代碼整體結(jié)構(gòu)由代碼生成器決定，而變化的部分由元數(shù)據(jù)決定。

AWPLC中的代碼生成器

1.基本架構(gòu)

2.功能塊描述文件格式

描述文件用標(biāo)準(zhǔn)的 JSON 格式，其內(nèi)容包括兩個(gè)部分：

基本信息包括：

• name 功能塊的名稱。英文小寫，必須是合格的 C 語言變量名；
• category 功能塊所屬的分類。各層級(jí)之間用/分隔，它決定了生成文件的位置；
• is_function_block true 表示功能塊，false 表示函數(shù)；
• impl 具體實(shí)現(xiàn)的源文件；
• author 作者聯(lián)系方式；
• version 版本號(hào)；；
• date 更新時(shí)間；
• desc 功能描述；
• properties 屬性列表。具體定義如下。

示例：

"name":"ztimer",
"category":"zlg/misc",
"is_function_block":true,
"impl":"input/zlg/misc/ztimer.c",
"author":"LiXianJing",
"desc":"循環(huán)定時(shí)器。 >當(dāng)輸入 IN 為 TRUE 時(shí)，開始計(jì)時(shí)，輸出 Q 為 FALSE，ET 開始記錄過去的時(shí)間>。 >定時(shí)時(shí)間到時(shí)，COUNT 增加 1，輸出 Q 在本次循環(huán)為 TRUE，ET 重置為0。 >輸入 IN 為 FALSE 時(shí)重
置定時(shí)器。",

• name 屬性名；
• desc 屬性描述；
• type 實(shí)際的數(shù)據(jù)類型；
• data_type（可選）用于在 IDE 中時(shí)類型檢查，缺省為 type 對(duì)應(yīng)的 IEC 的數(shù)據(jù)類型，但是有時(shí)可用 ANY_INT 和 ANY_NUM 等來放寬類型檢查；
• annotation 用于額外的標(biāo)識(shí)。目前主要用于指定輸入輸出等特性。

{
"name":"count",
"desc":"定時(shí)器時(shí)間到的次數(shù)。",
"type":"uint32_t",
"annotation":{
"out":true
}

},

2.3使用方法

代碼生成器用 nodejs 編寫，需要安裝 nodejs。具體用法如下：

node gen.js 描述文件名。

如：

nodegen.jsinput/zlg/misc/ztimer.json