如何擴展自定義功能塊，以及代碼生成器的用法

背景

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

簡介

在前一篇文章中，我們介紹了自定義 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;

}

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

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

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

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

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

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

/**
*@property{uint32_t}count
*@annotation["out"]
*定時器時間到的次數(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"]
*當前時間(ms)。
*/
iec_time_tcurrent_time;

/**
*@property{iec_time_t}start_time
*@annotation["private"]
*開始時間(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)定時器。 >當輸入 IN 為 TRUE 時，開始計時，輸出 Q 為 FALSE，ET 開始記錄過去的時間。
>定時時間到時，COUNT 增加 1，輸出 Q 在本次循環(huán)為 TRUE，ET 重置為0。 >輸入 IN 為 FALSE 時重置定時器。",
"ins":[
{
"name":"IN",
"desc":"為 TRUE 開始計時，為 FALSE 時重置定時器。",
"min_connections":1,
"max_connections":1,
"data_type":"BOOL"
},
{
"name":"PT",
"desc":"預(yù)設(shè)時間(ms)。",
"min_connections":1,
"max_connections":1,
"data_type":"TIME"
}
],
"outs":[
{
"name":"Q",
"desc":"定時時間是否到（僅在時間到的當次循環(huán)為 TRUE)。",
"data_type":"BOOL"
},
{
"name":"ET",
"desc":"過去時間(ms)。",
"data_type":"TIME"
},
{
"name":"COUNT",
"desc":"定時器時間到的次數(shù)。",
"data_type":"DWORD"
}
]

}

#ZTIMER

##功能

循環(huán)定時器。

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

##輸入

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

##輸出

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

在進入正題前，我們先聊一下代碼生成器的基本知識。

代碼生成器基本知識

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

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

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

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

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

AWPLC中的代碼生成器

1.基本架構(gòu)

2.功能塊描述文件格式

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

基本信息包括：

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

示例：

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

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

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

},

2.3使用方法

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

node gen.js 描述文件名。

如：

nodegen.jsinput/zlg/misc/ztimer.json