/**
*@classaw_plc_fb_ztimer_t
*@parentaw_plc_fb_t
*@annotation["fb"]
*循環(huán)定時(shí)器。
*
*>當(dāng)輸入 IN 為 TRUE 時(shí)，開(kāi)始計(jì)時(shí)，輸出 Q 為 FALSE，ET 開(kāi)始記錄過(guò)去的時(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 開(kāi)始計(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"]
*過(guò)去時(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"]
*開(kāi)始時(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í)，開(kāi)始計(jì)時(shí)，輸出 Q 為 FALSE，ET 開(kāi)始記錄過(guò)去的時(shí)間。
>定時(shí)時(shí)間到時(shí)，COUNT 增加 1，輸出 Q 在本次循環(huán)為 TRUE，ET 重置為0。 >輸入 IN 為 FALSE 時(shí)重置定時(shí)器。",
"ins":[
{
"name":"IN",
"desc":"為 TRUE 開(kāi)始計(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":"過(guò)去時(shí)間(ms)。",
"data_type":"TIME"
},
{
"name":"COUNT",
"desc":"定時(shí)器時(shí)間到的次數(shù)。",
"data_type":"DWORD"
}
]

}

#ZTIMER

##功能

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

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

##輸入

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

##輸出

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

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

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

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

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

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

• 主動(dòng)代碼生成器目標(biāo)代碼生成之后，不需要進(jìn)行修改和完善，每次都重新生成，如果需要修改，修改元數(shù)據(jù)和代碼生成器。比如編譯器就是此例。前面提到的 MVVM 的 ViewModel 和 AWFlow 應(yīng)用代碼生成也屬于此類(lèi)。如果可以，優(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 功能塊的名稱。英文小寫(xiě)，必須是合格的 C 語(yǔ)言變量名；
• category 功能塊所屬的分類(lèi)。各層級(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í)，開(kāi)始計(jì)時(shí)，輸出 Q 為 FALSE，ET 開(kāi)始記錄過(guò)去的時(shí)間>。 >定時(shí)時(shí)間到時(shí)，COUNT 增加 1，輸出 Q 在本次循環(huán)為 TRUE，ET 重置為0。 >輸入 IN 為 FALSE 時(shí)重
置定時(shí)器。",

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

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

},

2.3使用方法

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

node gen.js 描述文件名。

如：

nodegen.jsinput/zlg/misc/ztimer.json