3-1 簡介
本章對使用基本ST語言編寫程式的方法進行說明。
3-1-1 字元編碼
ST 編輯器支持Unicode(encode in UTF-8)多國語言。支援程式編輯中出現的日語、英語、中文等多種語言的基本字元及大部分符號,除了可以用于註解外,還可以用于標籤或程式、表格名中。
3-1-2 構成單位
ST語言使用以下記號的組合敘述程式。後面的章節會在細部解說
|
類型 |
範例 |
參考 |
|
|
運算符號 |
+、-、*、/、AND、&、OR、|、XOR、MOD、 <=、 >=、<>、++、–、<<、>>、NOT、:=、(、) |
3-4運算元(Operand)與運算子(Operator) |
|
|
控制語法的關鍵字 (定義的標準識別符號) |
IF、ELSEIF、END_IF CASE、OF、END_CASE WHILE、FOR、END_WHILE END_FOR LBL GOTO、CALL、 LBL_F、GOTO_F IF_RISINGTRIGGER IF_FALLINGTRIGGER |
3-6流程控制與迴圈 |
|
|
識別符號 |
變數, 硬體暫存器,IO點位,間接定址….etc (標籤、元件等) |
X0、Y0、M100、R0、DR0、D0、DD0、IM0…etc Tag(註冊任意的名稱) |
|
|
函式呼叫(FCM) |
1.系統內建Function 2.FCM函式庫 |
3-14呼叫FCM函數 |
|
|
常數 |
整數: 預設為signed int Ex: R0:=1; R0:=-2; Unsigned int Ex: Tag0:=0xFF; 字串: 只能使用在 Label 上 Goto, LBL…etc Bit (Bool) Type: TRUE、FALSE Float: 32位元浮點常數 ex: TagFloat1:=1.1; |
3-7-4常數 |
|
|
分隔符號 |
分號『:』 出現在CASE OF 中 分隔『,』 多個函式參數傳遞使用 |
3-6-3 Case Of |
|
|
左右小括弧 |
『(』 ,『 )』
ex: Fun0 ( S:=R0, D:=R1 );
R0:= (1+R0)*R2; |
3-4-1 ( ) |
|
|
RETURN |
可以立即離開該程式區段 |
3-6-6 Label & Jump/Call |
|
|
『;』 描述句結尾 |
用於標明一段程式敘述句的結束 |
– |
|
各記號之間可以自由插入空白、換行及注釋。
|
類型 |
範例 |
參考 |
|
空白 |
空格(全形/半形)、TAB |
- |
|
換行 |
換行代碼 |
- |
|
註解 |
//、(* …. *) |
3-2 敘述句
敘述句是 ST 語言中最基本的執行單位,它代表的是一個可被完整執行的工作。一個完整敘述句的呈現可能並不侷限在同一行文字當中,但它必定是以分號『;』來做為該敘述句的結尾。另外,一個敘述句中也允許再包含多個或多層的子敘述句,且不論其敘述句所處的位置為何,只要是一個敘述句的結尾,最後必定會跟隨著『;』符號。

一個完整的敘述句相當於一個具備完整功能的階梯圖區段(NETWORK),它必須能夠明確的表達一件工作。以上述程式中的敘述句為例,它所執行的工作便是將各裝置的內容值依照數學式表達的順序 R0*(R1+R2) 來進行運算,並將運算的結果指定給裝置 R10;但如下圖紅色框線中的內容雖然合法,但不是一個完整的敘述句,它只是一個表達式(Expression),代表的只是一個數學運算的數值,卻不是一件具體的工作。

以下將提供幾個Uperlogic結構化語言的敘述句:

|
類型 |
內容 |
範例 |
|
|
分配敘述句 |
將右邊的結果代入左邊的變數 |
:= |
|
|
流程控制語法 |
選擇敘述句(IF、CASE) |
根據條件選擇執行的語法 |
3-6-1 |
|
循環處理敘述句(FOR、WHILE) |
根據結束條件,多次執行 |
3-6-2 3-6-4 |
|
|
子程式語句 |
FCM調用語句 |
調用FB(FCM) |
3-14 |
|
標籤語句 |
調用LBL |
3-6-6 |
|
|
工具箱語句 |
將工具箱指令調用的方便語句 |
||
流程控制語法可分層。(可以搭配選擇語句、循環處理語句混合多層使用)

3-3 表達式(Expression)
表達式在敘述句結構當中是一個相當重要的組成元素,它代表的是一個「值」,例如 TRUE 或 FALSE 的布林值,亦或是20或 -5 的整數值;而表達式視使用的場合,可以是一個運算式或是一個常數, 當然也可以是一個變數符號或裝置。下列便是一些表達式的例子。
■ M0 & M1(布林值的表達式) 此表達式所代表的是 M0 與 M1 進行 & 運算後的布林值。
■ M0 = FALSE(布林值的表達式) 此表達式所代表的是「M0 = FALSE」這個條件是否成立。
■ M0 (布林值的表達式) 此表達式則直接以 M0 的值當作其代表的布林值。
■ D1 + D2(數值的表達式) 此表達式代表的數值為 D1 與 D2 相加後的運算結果。
■ D0(數值的表達式) 此表達式則直接以 D0 的現在值做為其代表的數值。
■ D2 = D0 + D1(布林值的表達式) 它代表的是「D2=D0+D1」這個條件是否成立。也就是說當 D0 與 D1 相加的結果等於 D2 的現在值時,表達式代表的便是布林值 TRUE;相反的,如果 D0 與 D1 相加的結果不等於 D2 的現在值時,表達式所代表的即是布林值 FALSE。
■ D2 := D0 + D1;(敘述句,非表達式。) 此為一個完整的敘述句而非表達式,其代表的意義是「將 D0 與 D1 的相加結果指定給 D2」的工作;不過這個敘述句也是由「D2」「D0+D1」這兩個表達式所組成的。
表達式的使用位置

下表所示為表達式的類型
|
類型 |
表達式(運算結果)的資料類型 |
範例 |
|
|
運算表達式 |
算術表達式 |
整數、實數等(依據運算物件) |
R0+R2 |
|
邏輯表達式 |
布林值(TRUE/FALSE) |
R0 AND R2 |
|
|
比較表達式 |
布林值(TRUE/FALSE) |
R0 > R2 |
|
|
基本表達式 |
變數、常數 |
定義的資料類型 |
M0.R0.123.TRUE |
|
函數調用表達式 |
返回值的資料類型 |
Fcm0( PA0:= ,OUT0=> ); |
|
3-3-1 運算表達式
本節以範例說明,運算表達式在ST環境和LD環境的呈現方式
3-3-2 四則運算(+、-、*、/)
四則運算使用與一般的算術符號相同的運算符號(+、-、*、/)敘述。
對于使用LD圖無法一次性敘述完整的運算,可以通過單行表達式簡潔地敘述出来。
程式範例
在 R3 中代入 R0~R2 的和。
R3=R0+R1+R2
ST
R3:=R0+R1+R2;
LD

■用一個敘述句加入多個運算表達式時,將從優先級最高的運算符號開始處理。
四則運算符號的優先級請參考運算元章節,有多個優先級相同的運算符號時,從最左邊的運算符號開始運算。
高級運算(指數)
指數運算或三角函數運算使用通用函數。
|
類型 |
函數名 |
範例 |
||
|
一般算式表述 |
ST |
|||
|
絕對值 |
ABS |
|X| |
ABS( D:= ); |
|
|
平方根 |
SQRT |
FSQR(S:= ,D:= ); |
||
|
三角函數 |
正弦、反正弦 |
SIN、ASIN |
B=SIN A |
FSIN( S:= , D:= ); |
|
餘弦、反餘弦 |
COS、ACOS |
B=COS A |
FCOS( S:= , D:= ); |
|
|
正切、反正切 |
TAN、ATAN |
B=TAN A |
FTAN( S:= , D:= ); |
|
程式範例
求直角三角形的斜邊長

ST
(使用浮點數需先註冊Tag改變資料型別
ex: A= Float DR0、B= Float DR2、C= Float DR4)
FSQR( S:= A*A+B*B, D:= C);

LD

3-4 運算元(Operand)與運算子(Operator)
運算元與運算子為組成一個表達式的基本元素。運算元指的是參與運算的對象,而運算子則代表所執行的運算動作,例如表達式 D0 + D1 中,D0 與 D1 都是運算元,而 + 號則是運算子。 由上一節的各個例子可知,表達式可為一群運算元與運算子的組合,但也可單獨的以一個運算元來呈現一個表達式,而其中做為運算元的可為裝置、變數符號或是常數。

如同數學式一般,運算子本身也有執行運算的優先順序,而當優先的等級相同時,進行運算的順序便會是由左至右。下表即為 Uperlogic中 ST 語法的運算子一覽表。
|
符號 |
功能 |
資料格式 |
表達式範例 |
優先等級 |
||
|
運算元 |
運算結果 (表達式的值) |
表達式 |
值 |
最高 |
||
|
() |
區塊優先 |
不限 |
不限 |
(D0 + 6)* 3 |
||
|
++,– |
快速加,減1 |
任何數值 |
任何數值 |
++D0 D0++ |
||
|
– |
數值負號 |
任何數值 |
任何數值 |
-D0 |
||
|
NOT |
邏輯反向 |
布林 |
布林 |
NOT M0 |
TRUE |
|
|
* |
乘法 |
任何數值 |
任何數值 |
D0*3 |
||
|
/ |
除法 |
任何數值 |
任何數值 |
15/D0 |
||
|
+,- |
加法,減法 |
任何數值 |
任何數值 |
D0+3 |
||
|
< , >,<=, >= |
數值比較 |
任何數值 |
布林 |
D0>2 |
||
|
=,<> |
等於,不等於 |
任何數值 |
布林 |
D0<>2 |
||
|
布林 |
M0=TRUE |
|||||
|
AND,& |
“及”運算 |
布林 or 數值 |
布林 or 數值 |
M0&M1 |
||
|
OR, | |
“或”運算 |
布林 or 數值 |
布林 or 數值 |
M0 OR M1 |
||
|
XOR XNOR |
“互斥或”運算 除法取整數 |
布林 or 數值 |
布林 or 數值 整數 |
M0 XOR M1 |
||
|
MOD |
數值 |
數值 |
D0 MOD 3 |
|||
|
>>,<< |
右移1,左移1 |
任何數值 |
任何數值 |
D0>>1 |
2 |
|
|
R_TRIG, F_TRIG |
上沿 下沿 |
最低 |
||||
■有底色的部分同區段底色的會是同樣的優先度
■AND OR XOR XNOR 基本上會做BitWise的作用(ex R0 AND R1) 結果就會是數值
除非左右兩邊都是Bool(bit) (ex. M0 AND M1) 的型別就會做邏輯的運算,結果就會是 Bool(bit) 值
■沒有支援&&、||、==語法
各小節針對個別運算子做介紹
3-4-1 ( )
作用跟數學式子一樣,針對括弧內的表達式來優先進行運算
EX:
R0:= (R0+2)*3-(R2+3)*56 ; // R0=1;R2=2
// R0= – 271
3-4-2 四則運算 +, -,* , /
針對兩邊的運算元進行加減乘除的計算
EX:
R0:= 5+4-3*2/1 ;
// R0=3
3-4-3 遞增/遞減 ++, —
單獨對運算元 + 1 或是 -1
前綴語法:
++(Register)
–(Register)
效果等同於 (Register):=(Register)+1;
但是比較簡短整潔
後綴語法:
(Register)++
(Register)–
會先取出(Register)數值,並且return ,之後再運行(Register):=(Register)+1 的行為
ex:
R0:=10;
R2:=10;
R100:=++R0; // R100 為11, R0為11
R102:=R2++; // R102 為10, R2為11
3-4-4 數值比較 >=,<=,>,<
會比較運算子左右兩側的運算元大小
運算子左右兩側需要相同型別才可以比較大小
否則得到的比較結果可能會有誤 (float <->int)
EX:
M0:=R1 >= R2; //如果R1大於等於R2的話則M0為TRUE ( 1 )
3-4-5 相等或不等 = ,<>
比較左右兩個運算元是否相等
得到的結果則為TRUE/ FALSE ( 1/ 0)
EX:
M0 := R0=100; //假如R0的值為100的話 M0為TRUE ( 1 )
3-4-6 位元左右平移 <<, >>
『>>』,『<<』
針對左側運算元 左/右偏移右側的運算元
EX: R10:=R0<<4; //R0=1(0b0_0001)
// R0 的數值會被往左偏移4 個bit, 並且分配到R10
// R10=16(0b1_0000)
P.S. R0並不會改變
3-4-7 反相運算元 NOT
針對右邊的運算元依位元反相
EX:
R0:=NOT R2; // 對R2的數值做反相存到R0
// R2=1(0b0_0001) => NOT R2= -2(0b1111_1110)
M0:= NOT ( M0 OR M2 ); // M0 跟M2 做完或閘之後 再反相 存到M0
3-4-8 負號運算元 ‘-’
『-』
針對右邊的運算元變為負數
EX:
IF R_TRIG( S:=M1 ) THEN
R0:=-R2; //R2=1 (0b0_0000_0000_0001)=> R0=-1(0b1111_1111_1111_1111)
END_IF
3-4-9 賦予數值 :=
將運算子的右邊運算元(變數),指派到左邊的變數
EX:
R1:=R0; // R1=R0
R1:=1; // R1=1
3-4-10 邏輯運算元 AND ( & )、OR ( | )、XOR、XNOR
對運算子左右兩邊的運算元進行邏輯運算
運算結果型別會跟運算元的左邊第一位型別是一樣的
EX:
R0:= R1 AND R2; // 對R1, R2的數值進行位元 及 運算存到R0
// 假如R1=1(0b0_0001) R2=15(0b0_1111) 則R0 =1(0b0_0001)
DR0:= R10 & DR12; // 對R10, DR12的數值進行位元 及 運算存到DR0
// 假如R10=1118481(0x11_1111H) DR12=69905(0x1_1111H)
// 則DR0 =4369(0x1111H)
R0:= R1 | R2; // 對R1, R2的數值進行位元 或 運算存到R0
// 假如R1=1(0b0_0001) R2=15(0b0_1111) 則R0 =15(0b0_1111)
DR0:= DR10 OR R12; // 對R10, DR12的數值進行位元 或 運算存到DR0
// 假如DR10=4369(0x1111H) R12=69905(0x1_1111H)
// 則DR0 =4369(0x1111H)
R0:= R1 XOR R2; // 對R1, R2的數值進行位元 反或 運算存到R0
// 假如R1=1(0b0_0001) R2=15(0b0_1111) 則R0 =14(0b0_1110)
R0:= R1 XNOR R2; // 對R1, R2的數值進行位元 反互斥或 運算存到R0
// 假如R1=1(0b0_0001) R2=15(0b0_1111) 則R0 =-15(0b1111_0001)
3-4-11 MOD 餘數
計算左右運算元的餘數 (等同於C語言的 %符號)
EX:
R0:= R1 MOD R2 ; // R0為R1除以R2之後的餘數
// R1=10,R2=3 10/3商數等於3餘數等於1,R0=1
3-5 註解(Comment)
註解是用來讓程式開發者日後容易維護的註解
有分為單行或是連續註解
會呈現淺灰色字樣,這些部分會被編譯器忽略不會產生運行資料
3-5-1 單行註解 //
這個符號之後會呈現淺灰,並且不會產生運行的程式碼

3-5-2 多行註解 (* *)
可以跨多行(單行也行) 的連續註解
在這兩個符號中間的文字會被當成註解

P.S. 在操作上也可以透過快捷鍵 (Ctrl+ / ) 來針對所選取的行列
批次 ( 加 / 移除 ) 註解
3-6 流程控制與迴圈
撰寫ST的時候通常都會需要一些條件或是迴圈控制便於設計,參考以下介紹。
3-6-1 IF ELSE

當 IF 後面的表達式最後結果為 TRUE 或是 1的時候
會緊接著運行 IF 後的描述
否則會運行 ELSE 後的描述
EX:

假如 M5 上沿訊號觸發, 並且 M88 也為 TRUE (1) 的時候
R100為10,R10為12
如果有多個條件則可以用 ELSEIF
EX:

3-6-2 For Loop
參數:
(*Reg*):計數暫存器
重複運行FOR 到 END_FOR裏頭的指令,直到計數暫存器達到達到目標值
每重複一次運行就會對計數暫存器值加上遞增值或遞減值
(*Start*):計數初始值
(*End*):計數目標值
(*< inc >*):遞增值或遞減值
(*Statements*):欲迴圈執行之程式
P.S. BY 遞增值這個欄位可以省略 (預設為1) 如下圖 
|
計數暫存器 |
計數初始值 |
計數目標值 |
遞增值或遞減值 |
|
|
16位元暫存器 |
○ |
○ |
○ |
|
|
32位元暫存器 |
○ |
|||
|
常數 |
○ |
○ |
○ |
P.S. 若迴圈計數為遞增,則 計數初始值 < 計數目標值;
若迴圈計數為遞減,則 計數初始值 > 計數目標值。
EX:
FOR DR0 := R2 TO R4 BY 2 DO //DR0 會從R2, R2+2, R2+4,….etc直到R4
R10++; // DR0 = R4, R10 = R10 + (R4-R2) / 2
END_FOR
3-6-3 Case Of
整數條件選擇

會讀取對目標暫存器的數值,滿足指定的條件後運行 : 後面的敘述句
假如都不滿足,則會運行 ELSE 後面的敘述句
條件只支援整數常數 或是 範圍 .. 符號內的常數
EX:

R0 等於 1 // R100 等於10
//3, 4, 5, 6, 7, 8, 9 ,R100等於11
3-6-4 While Loop & Repeat
重複運行描述 直到條件(不)滿足
While Loop:

EX:

Repeat:

EX:

Notice:
因為硬體運行邏輯的關係,While如果持續太久時間沒有跳開迴圈,會使PLC設備無法處理其他IO狀態,造成系統錯誤,在使用的時候要注意
3-6-5 Break / Exit 跳開迴圈
在 FOR , WHILE , REPEAT 的迴圈狀況下,可以在適當時間搭配 break 或是 exit 提前離開迴圈。
EX:

當R0大於等於100的時候 會運行break 跳開while loop
Notice:
迴圈系列如 For While Repeat,有可能會因為迴圈運行次數過久,會導致PLC在運行的時候產生Error,使用上請特別注意,可以搭配中斷訊號處理迴圈處理過久的問題。
3-6-6 Label & Jump/Call
LBL指令能達到LD FUN_65相同效果(詳細說明可以參考FUN 66),最多可輸入6個ASCII 字元當作標籤名稱。
EX:
能夠在ST環境呼叫Label的關鍵字有以下幾種
JMP_66/GOTO (詳細說明可以參考FUN 66)
EX:
JMP_66/GOTO只能在當前單元執行跳轉
CALL/CALL_67 (詳細說明可以參考FUN 67)
EX:

在副程式使用Label功能時,LBL指令搭配RETURN會有不同的結果
EX:

R0=2,因為同時呼叫A.B的Label,並將結果RETURN

R0=1,因為只呼叫了A的Label,並將結果RETURN

R0=2,因為呼叫了A的Label,但RETURN在B的Label後

R0=3, 因為呼叫了”副單元0”A的Label,但RETURN在”副單元1”C的Label後(需特別注意)
如需在FCM環境
使用標籤則需要利用LBL_F、FLBL_165指令
只能在FCM 呼叫Label的關鍵字
GOTO_F(只能在FB 使用的Label)
FJMP_166
EX:

3-7 暫存器和資料型別
在程式語言中,變數使用跟資料型別是不可或缺的一部分為了要賦予暫存器型別的特性,便於程式撰寫者觀看除錯,ST都使用標籤(全域、區域) 來賦予暫存器具有特定的型別,以下一一介紹ST 中所支援的資料型態跟用法。
|
注意事項 運算結果超出了資料類型所能處理的值的範圍時,在以後的處理中將無法反映正確的結果 (數值)。 應事先將運算物件變數的資料類型轉換成可對運算結果進行處理的範圍的資料類型。 |
標籤建立範例
標籤分為全域標籤及區域標籤,全域標籤所建立的標籤名稱無法與區域標籤共用,為整個專案可共用的標籤名稱。區域標籤所建立的標籤名稱可在不同主程式、副程式、Fcm程式間使用相同的名字,且不相互影響使用(但使用位址須不相同)。

為配合不同資料型別的程式運算使用,以下將示範如何建立不同型別的標籤
Rx.Dx暫存器預設為INT16, DRx.DDx暫存器預設INT32整數型變數
EX:
雙擊點選全域標籤->新增標籤



如果選取的位址與資料型別不支援,則會跳出提醒阻擋
3-7-1 Bool / Bit
只要是代表的資料為bit 或是數值比較運算 ex. <, >, <> …等, 這些結果都為Bool (Bit) 型別,在這裡可以使用0或是 1 , TRUE, FALSE 都可以接受為表現Bool 型別的常數。
其中繼電器的開關也都是用Bool / Bit來表示 ( ex. M0, X0, Y0…etc)
EX:
3-7-2 Integer 整數型別
ST 有四種整數類型 分別為 INT16, UINT16, INT32, UINT32,
|
型別名稱 |
說明 |
|
INT16 |
16位元的整數 |
|
UINT16 |
16位元的正整數 |
|
INT32 |
32位元的整數 |
|
UINT32 |
32位元的正整數 |
如果使用到16 bit 的暫存器位置 (ex. R0, R1..etc) 系統會預設為INT16的資料型別處理,如果是32 bit 的暫存器 (ex. DR0, DR2…etc)則會以INT32 的方式對待
3-7-3 Float浮點數
IEEE-754 定義的浮點數
ST 針對浮點數的操作, 都需要先產生對應的Tag 才可以讓系統知道哪個變數指的暫存器位置代表著浮點數.
其中當使用者在做浮點數的操作的時候會有一些預設隱含的行為出現,以下圖的範例來說明。

Line 1: 表示將標籤0的浮點數數值賦值為69905.14159
Line 3: 表示把標籤0的浮點數數值轉換成int32 的整數數值
並且存在DR10的位置,小數點的部分則會被移除
(ex. 標籤0 為69905.141 則 DR10內容則為69905 )
Line 5: 表示會把標籤0的浮點數數值轉換成int16 的整數數值
並且存在R12的位置,超過int16的整數數值以及小數點的部分則會被 移除
(ex. 標籤0 為69905.141 則 R12內容則為4369 )

Line 2: DR14( INT32 )轉換成浮點數的資料型別,並且存進標籤0這個標籤中
(可觀察浮點數的數位表示跟整數不同,可當作 Fun 200 I -> F運用)
EX:

3-7-4 常數
以下為ST所支援輸入的常數類型
|
Type |
格式及樣本 |
|
Bool (Bit) |
0, 1, TRUE, FALSE ——————————————- M0:=1; M0:=TRUE; |
|
整數 |
整數: R0:=1; R0:=-10; 二進位: 2# 後面接上0,1 的數值, 可以使用底線分割群組 R0:=2#1111_0000; 八進位: 8# 後面接上數值, 可以使用底線分割群組 R0:=8#243; 十六進位: 16# 後面接上數值, 可以使用底線分割群組 0x 後面接上數值, 可以使用底線分割群組 |
|
科學記號 |
Tag_FlR100:=1E3; //1000 Tag_FlR100:=1.2E+3; //1200 Tag_FlR100:=1E-3; //0.001 |
|
單位符號 |
G : 1e+9 M : 1e+6 K,k : 1e+3 m : 1e-3 u : 1e-6 n : 1e-9 —————————————– DR0:=1G; R0:=1K; R0:=1k; DR0:=1M; Tag_FlR100:=1m; Tag_FlR100:=1n; Tag_FlR100:=1u; |
|
字串 (目前只有Label 指令可以使用) |
用 “ quote 符號 包起來的ASCII 字串 —————————————– LBL ( "my_lab" ) |
3-8 使用PLC 的暫存器跟記憶體
除了使用建立Tag來調用對應的暫存器之外,也可以使用間接暫存器名來進行運算或是流程控制。
只要是該暫存器的資料型態為single word 16bit —> INT16
double word 32bit —> INT32
EX:
R29:=100;
V:=19; //間接定址
R200:= R10V+100; R200=200
比較特別的T, C 這兩個位元只會根據程式的邏輯會有bit 或是 int的特性
EX:
/// T1 表示為 bit 型別
/// 代表是否timeout
IF T1 THEN
R10:=20;
/// T1表示當前timer 的數值
/// 為int16的整數
ELSEIF T1>100 THEN
R10:=30;
END_IF
///這時候會把T1當成Bit 類型來做反向
M0:=NOT T1;
3-9 呼叫系統內建的函式
內建函式表達結構會如下所示
<函式名稱> ( <參數名稱1> := <輸入參數1> , ….);
和階梯圖一樣,ST就帶有一些內建的函式供使用者呼叫,
會出現在右側的工具箱欄位中。
可以從工具箱拖曳 或是雙擊該欄位,便會新增至文本中。
在呼叫的時候,參數的順序可以隨意變更,但是不能缺少,
除非一些特殊數允許省略

其中某些函式會有分32 bit 模式 ( 預設都是16 bit 模式)
會需要再該函式後面加上_D 明確指示該函示為32 bit模式
EX:二進制碼轉換格雷碼
錯誤轉換 正確轉換


大部分的函式都是呼叫即執行,如使用時希望條件達成後只執行一次動作,參考寫法
EX:
IF R_TRIG( S:=”條件” ) then
“函式”
END_IF
!注意!
工具箱中的”Motion Basic”.”Motion Mode1”. ”Motion Mode2”. ”Motion Mode3”函式除非條件狀態有變化,否則都是只執行一次。
有關於每個呼叫函數的細部參數內容,則請參考FUN 的文件,下面就針對幾個不同的FUN 來介紹
3-9-1 Timer
Prototype:
Timer( Trigger:= (* Trigger Bit Rising Edge ->ON, Falling Edge ->OFF *),
T:= (* Timer 0~1023 *),
PV:= (* preset value (0~32767) *),
IsTimeout=> (* time out bit *);
參數:
Trigger (bool) : Rising Edge 則為Timer 啟動,
Falling Edge 停止運行
T (int) : 0~1023的整數,分別代表T0~T1023的Timer //0,T0…etc
PV (int) : Timer 的設定值
IsTimeout (bool) : Timer 達到設定值後輸出的線圈 //M0,T0…etc
詳細參數說明請對應 LD Timer 的說明文件
3-9-2 Counter / Counter_L
這裡分成兩組Counter函式,讓使用者能容易分別目前呼叫的是
single word ( Counter ) 的counter 還是 double words (Counter_L) 的版本
Prototype:
Counter( Pulse:= (* Pulse Signal *),
Clr:= (* CLR Signal *),
C:= (* counter number (0~1023) *),
PV:= (* Preset value (Single Word 0~65535) *),
IsUp=> (* Counter Is Up *);
Counter_L( Pulse:= (* Pulse Signal *),
Clr:= (* CLR Signal *),
C:= (* counter number (1024~1279 Long counter) *),
PV:= (* Preset value (Double Words) *),
IsUp=> (* Counter Is Up *);
參數:
Pulse (bool) : Off->On 則會計數一次 //M0,M9129…etc
Clr (bool) : 是否清除counter
C (int) : Counter id 0~1279
PV (int) : Counter 設定值
IsUp (bool) : Counter達到設定值後輸出的線圈 //M0,C0…etc
3-9-3 R_TRIG / F_TRIG
上沿訊號和下沿訊號的偵測function
Prototype:
Mode 1:
R_TRIG( S:= , D=> )
F_TRIG( S:= , D=> )
Mode 2:
R_TRIG( S:= )
F_TRIG( S:= )
隱含Return Value D
參數:
S (bool) : Rising / Falling Edge 偵測來源
D (bool) : 偵測結果
Example:
Mode 1: R_TRIG(S:=M0, D:=M5);
Mode 2:
IF R_TRIG(S:=M0) THEN
++R100;
END_IF
3-9-4 TARESUB and TAREZEOFFSET
這兩個函式是由原本的 FUN258 MODCONF 皮重偏移指令 模式拆出來的,詳細參數設定可以參考原本FUN258的文件。拆成兩個獨立的函式也是便於使用者在撰寫的時候能夠一目了然呼叫的功能。
Prototype:
TAREZEOFFSET( EN:= , MD:= , ID:= , CH:= , WR:= , ERR=> , DN=> )
TARESUB( EN:= , RST:= , ID:= , CH:= , SB:= , ERR=> )
3-10 具有多重呼叫模式的函式
如前面3-9-3 章節中的觸發偵測指令,這些指令都支援兩種型態,一種是直接完整呼叫,另一種是省略存放結果的暫存器位置(D),下表則為目前具有該特性的函式。
|
函式名稱 |
具有回傳特性 參數名稱 |
函數格式 |
|
FSQR |
D |
FSQR(S:= ,D:= ) |
|
FSIN |
D |
FSIN(S:= ,D:= ) |
|
FCOS |
D |
FCOS(S:= ,D:= ) |
|
FTAN |
D |
FTAN(S:= ,D:= ) |
|
FASIN |
D |
FASIN(S:= ,D:= ,MD:= ) |
|
FACOS |
D |
FACOS(S:= ,D:= ,MD:= ) |
|
R_TRIG |
D |
R_TRIG(S:= ,D:= ) |
|
F_TRIG |
D |
F_TRIG(S:= ,D:= ) |
|
ItoF |
D |
ItoF(S:= ,D:= ) |
|
FtoI |
D |
FtoI(S:= ,D:= ) |
也就是說上述這些函式具有回傳特性的參數在呼叫的時候可以省略
並且直接用另一個參數承接或是直接來運算
EX:
沒有省略:
FSIN(S:=Tag_Float_DR100, D:=Tag_Float_DR102);
省略回傳參數: (由於回傳數值及代表結果,則可以直接帶入一些四則運算或是條件是判斷)
Tag_Float_DR200 := FSIN(S:=Tag_Float_DR100) + FSIN(S:=Tag_Float_DR102);
3-11 複週期指令集(Multi-cycle instructions)
以下指令列表為持續在背景運作型指令, 使用方式為, 放在IF迴圈外, 每次掃描週期都執行, 會以EN訊號是否成立,決定該函式的運行狀態。
如下圖的範例:

這些指令的類別, 因為呼叫後, 執行時間通常都超過一個掃描週期。
下表為目前所有的複週期指令
|
函式名稱 |
函式ID |
|
LCNV |
33 |
|
MLC |
34 |
|
TPCTL2 |
99 |
|
RAMP2 |
98 |
|
HSPWM |
139 |
|
HSPSO |
140 |
|
MPARA |
141 |
|
PSOFF |
142 |
|
PSCNV |
143 |
|
MPG |
148 |
|
ModBUS |
150 |
|
CLINK |
151 |
|
ReadWriteFileReg |
160 |
|
WriteSDMem |
161 |
|
ReadSDMem |
162 |
|
PID2 |
38 |
|
DBUF |
115 |
|
ICA |
137 |
|
ICF |
138 |
|
NCR |
152 |
|
CMCTL |
156 |
|
HSPWM2 |
144 |
|
Timer |
T |
|
T.01s |
87 |
|
T.1s |
88 |
|
T1s |
89 |
|
MFSysInit |
187 |
|
MFSysStop |
177 |
|
MFSysRstAlm |
185 |
|
MFSysRCPR |
188 |
|
MFSysRCPW |
189 |
|
MFSysCAMR |
191 |
|
MFSysCAMW |
192 |
|
MFSysCAMGen |
196 |
|
MFSysSetVirt |
235 |
|
MFSDOR |
236 |
|
MFSDOW |
237 |
|
MFFlowStart |
176 |
|
MFFlowStop |
186 |
|
MFFlowHalt |
184 |
|
MFFlowResume |
183 |
|
MFChgTbPrm |
181 |
|
MFMapTbPrm |
198 |
|
MFPointMov |
179 |
|
MFHome |
178 |
|
MFJog |
180 |
|
MFGearMPG |
193 |
|
MFVelCtl |
194 |
|
MFTorqCtl |
195 |
|
MFAxMov |
197 |
|
MFAxLMov |
238 |
|
MFAxCirMov |
239 |
|
MFPathMov |
240 |
3-12 中斷,特殊指令啟動/關閉指令
請參照FUN 145, 146

LB參數可輸入1~49的整數,分別對應中斷的類型
也可藉由智能彈跳提示視窗選取對應中斷的類型

|
No. |
中斷源 |
優先度 |
中斷標記 |
條件 |
備註 |
|
1 |
內建數位輸入 |
X0+I (INT0+) |
X0上沿觸發 |
軟體高速計數器HSC4~HSC7可以指定為任意中斷X0~X15的觸發源。 因此,軟體高速計數器的中斷優先權取決於X0~X15的優先權。 |
|
|
2 |
X0−I (INT0-) |
X0下沿觸發 |
|||
|
3 |
X1+I (INT1+) |
X1上沿觸發 |
|||
|
4 |
X1−I (INT1-) |
X1下沿觸發 |
|||
|
5 |
X2+I (INT2+) |
X2上沿觸發 |
|||
|
6 |
X2−I (INT2-) |
X2下沿觸發 |
|||
|
7 |
X3+I (INT3+) |
X3上沿觸發 |
|||
|
8 |
X3−I (INT3-) |
X3下沿觸發 |
|||
|
9 |
X4+I (INT4+) |
X4上沿觸發 |
|||
|
10 |
X4−I (INT4-) |
X4下沿觸發 |
|||
|
11 |
X5+I (INT5+) |
X5上沿觸發 |
|||
|
12 |
X5−I (INT5-) |
X5下沿觸發 |
|||
|
13 |
X6+I (INT6+) |
X6上沿觸發 |
|||
|
14 |
X6−I (INT6-) |
X6下沿觸發 |
|||
|
15 |
X7+I (INT7+) |
X7上沿觸發 |
|||
|
16 |
X7−I (INT7-) |
X7下沿觸發 |
|||
|
17 |
內部定時時基 |
3 |
STM0I |
間隔1ms~60000ms |
時基單位1ms,值=1~60000 |
|
18 |
3 |
STM1I |
間隔1ms~60000ms |
||
|
19 |
3 |
STM2I |
間隔1ms~60000ms |
||
|
20 |
3 |
STM3I |
間隔1ms~60000ms |
||
|
21 |
3 |
LTM0I |
間隔10ms~60000ms |
時基單位10ms,Value=1~6000 |
|
|
22 |
3 |
LTM1I |
間隔10ms~60000ms |
||
|
23 |
3 |
LTM2I |
間隔10ms~60000ms |
||
|
24 |
3 |
LTM3I |
間隔10ms~60000ms |
||
|
25 |
HST |
1 |
HST0I |
間隔0.1ms to 6000ms |
時基單位100us,Value=1~60000 |
|
26 |
1 |
HST1I |
間隔0.1ms to 6000ms |
||
|
27 |
1 |
HST2I |
間隔0.1ms to 6000ms |
||
|
28 |
1 |
HST3I |
間隔0.1ms to 6000ms |
||
|
33 |
HSC |
2 |
HSC0I |
間隔HSC0 to (CV=PV) |
|
|
34 |
2 |
HSC1I |
間隔HSC1 to (CV=PV) |
||
|
35 |
2 |
HSC2I |
間隔HSC2 to (CV=PV) |
||
|
36 |
2 |
HSC3I |
間隔HSC3 to (CV=PV) |
||
|
37 |
2 |
HSC4I |
間隔HSC4 to (CV=PV) |
||
|
38 |
2 |
HSC5I |
間隔HSC5 to (CV=PV) |
||
|
39 |
2 |
HSC6I |
間隔HSC6 to (CV=PV) |
||
|
40 |
2 |
HSC7I |
間隔HSC7 to (CV=PV) |
||
|
66 |
內建數位輸入(MA 系列) |
X8+I (INT8+) |
X8 上沿觸發 |
軟體高速計數器HSC4~HSC7可以指定為任意中斷X0~X15的觸發源。 因此,軟體高速計數器的中斷優先權取決於X0~X15的優先權。 |
|
|
67 |
X8−I (INT8-) |
X8下沿觸發 |
|||
|
68 |
X9+I (INT9+) |
X9上沿觸發 |
|||
|
69 |
X9−I (INT9-) |
X9下沿觸發 |
|||
|
70 |
X10+I (INT10+) |
X10上沿觸發 |
|||
|
71 |
X10−I (INT10-) |
X10下沿觸發 |
|||
|
72 |
X11+I (INT11+) |
X11上沿觸發 |
|||
|
73 |
X11−I (INT11-) |
X11下沿觸發 |
|||
|
74 |
X12+I (INT12+) |
X12上沿觸發 |
|||
|
75 |
X12−I (INT12-) |
X12下沿觸發 |
|||
|
76 |
X13+I (INT13+) |
X13上沿觸發 |
|||
|
77 |
X13−I (INT13-) |
X13下沿觸發 |
|||
|
78 |
X14+I (INT14+) |
X14上沿觸發 |
|||
|
79 |
X14−I (INT14-) |
X14下沿觸發 |
|||
|
80 |
X15+I (INT15+) |
X15上沿觸發 |
|||
|
81 |
X15−I (INT15-) |
X15 下沿觸發 |
|||
|
82 |
MQ model DI Plug-in |
X16+I (INT15+) |
X16上沿觸發 |
||
|
83 |
X16−I (INT15-) |
X16 下沿觸發 |
|||
|
84 |
X17+I (INT15+) |
X17上沿觸發 |
|||
|
85 |
X17−I (INT15-) |
X17 下沿觸發 |
|||
|
86 |
X18+I (INT15+) |
X18上沿觸發 |
|||
|
87 |
X18−I (INT15-) |
X18 下沿觸發 |
|||
|
88 |
X19+I (INT15+) |
X19上沿觸發 |
|||
|
89 |
X19−I (INT15-) |
X19 下沿觸發 |
|||
|
90 |
X20+I (INT15+) |
X20上沿觸發 |
|||
|
91 |
X20−I (INT15-) |
X20下沿觸發 |
|||
|
92 |
X21+I (INT15+) |
X21上沿觸發 |
|||
|
93 |
X21−I (INT15-) |
X21下沿觸發 |
|||
|
94 |
X22+I (INT15+) |
X22上沿觸發 |
|||
|
95 |
X22−I (INT15-) |
X22 下沿觸發 |
|||
|
96 |
X23+I (INT15+) |
X23上沿觸發 |
|||
|
97 |
X23−I (INT15-) |
X23 下沿觸發 |
3-13 具有特殊意義的變數名稱
- Timer, Counter
T0~TN, C0~CN
在ST環境中賦予這兩個變數同時具有Bool 的特性跟Integer整數的特性
例如:
R0:=T1; //會把Timer1 目前計算到的數值存到R0(Integer)
M0:=T1; // 會把Timer1 目前是否在運行的狀態存到M0 (Bool)
M3:=C1>10; // 則會判斷Counter 1是否計數超過10
IF R_TRIG( T1 ) THEN
/// 當Timer1 從0變1的時候 (開始運行的瞬間),則會執行
END_IF
- 中斷Enum
原本Enable / Disable 中斷只能輸入常數,為了讓程式看起來可讀性提高,修改為可以輸入系統預設的Enum 參數,可以打 INT_ 的字樣就會顯示對應的一系列可用的Enum。

例如:
IF M2 THEN
INTEnable( LB:= INT_STM1I);
ELSE
INTDisable( LB:= INT_STM1I);
END_IF
- 高速計數 Enum “HSC_” Prefix
呼叫相關高速指令如
HSCTR( CN:= (* 0~7 *));
HSCTW( S:= , CN:= , D:= );
其中CN , 跟D 的參數式支援常數整數,為了閱讀方便 也導入HSC_ 開頭的Enum

讓程式更具可讀性
例如:
HSCTR( CN:= HSC_HSC0(* 0~7 *));
HSCTW( S:=R0 , CN:=HSC_HSC0 , D:=HSC_PV );
- File Register Enum F0~F32767
針對FUN 160 的Sb 參數,除了使用0~32767之外,可以使用F0~F32767的Enum 來代表對應的位置.
例如:

3-14 呼叫FCM函數
呼叫FCM的方式與呼叫系統函式類似,不過這些FCM函式都是使用者自行創建的
創建的FCM會放在左側的命令欄位中的FCM list

可以直接雙擊 該欄位,插入所選取的函數到文本
其中 FCM可以指定一個Return Value, 用來使用在程式撰寫的時候可以直接調用
EX:
FCM:

呼叫端:

這樣可以適時地減少一些暫時不需要的變數宣告
3-15 函數注意事項
無論是呼叫系統內建的或是 FCM 均有以下共同特點
- 呼叫方式 :
1. 完整帶入參數名稱
2. 省略參數名稱
3. 輸出參數(=>)可以直接忽略不傳遞
範例:
以R_TRIG 這個函式為例
完整表現 : R_TRIG( S:= M0, D=>M1 );
用參數帶入的話允許不按照預設的順序
上述的函式可以改成
R_TRIG( D=>M1, S:= M0 );
R_TRIG( D=>M1);
都是合法輸入
省略參數名稱 : R_TRIG( M0, M1 );
帶有Return 效果或是輸出的可以不傳遞 :
R_TRIG( S:= M0 );
R_TRIG( M0 );
有 Return 特性的可以與其他變數或是描述句混合運用
IF R_TRIG(M0) THEN
//// some statements
END_IF
M10:= R_TRIG(M0) AND R_TRIG(M1);
! 注意 ! 帶入參數跟不帶入參數的呼叫方式不能混用如:
R_TRIG(S:=M0, M1);
R_TRIG(M1,D:=M2);
以上兩個都是不合法的輸入
3-16 VAR 宣告語法
使用者可以在文本裡頭直接宣告Tag 變數.
語法:
VAR [RETAIN]
<變數> : <型別> ;
END_VAR
解釋:
<變數> 用來命名標籤變數名稱的字串
並且可以用逗號 批次宣告同樣型別的變數
也可以使用AT 字樣 明確關聯位置
Ex.
VAR1 : BOOL;
VAR2, VAR3, VAR4 : INT;
VAR5 AT R100 : INT;
AT 支援
- 關聯一般暫存器的位置
輸入 X, Y, M, V, Z, P0~P9, R, D, DR, DD, WX, WY, WM - 使用 % 定址 DeviceView 上的資源
使用者輸入%後會根據目前DeviceView 顯示所有可以綁定的位置
%I ==> 模組 X 的位置
%Q ==> 模組 Y 的位置
%SM ==> 模組的狀態M暫存器
%SR ==> 模組的狀態R暫存器
%IR ==> 模組邏輯輸入暫存器
%OR==> 模組邏輯輸出暫存器
後面的形式可以是
- <數字N> : 只針對PLC主機上第N個資源
- <擴充模組ID> . <數字N> : 針對某個ID擴充模組的第N個資源
Example:
VAR
zLocation AT Z : INT;
rlocation AT R0 : INT;
x_loca AT X10 : BOOL;
y_loc AT Y11 : BOOL;
d_loc AT D10 : INT;
m_loc AT M100 : BOOL;
dd_loc AT DD10: INT32;
dr_loc AT DR20 : INT32;
wx_loc AT WX0 : INT16;
wy_loc AT WY16 : INT16;
dwx_loc AT DWX16: INT32;
dwy_loc AT DWY32 : INT32;
p_loc AT P0 : INT16;
///ID : 2, 第二個OR
AIO_Output_Ch1 AT %OR2.1 : int16;
END_VAR
<型別> 支援關鍵字
BOOL, INT/INT16, UINT/UINT16, DINT/INT32, UDINT/UINT32, FLOAT
並且可以給予初始數值
Ex.
BOOL:=FALSE
INT:=10
補充:
- 如果使用者沒有明確關聯標籤的位置 (AT) 則會根據下圖(Memory Allocation)介面中的
STX VAR 的分頁 來自動分配變數配置的M, R 資源 (M是分配給BOOL, 其餘的是用 R來分配的)
- 宣告出來的變數 跟原本的標籤的功能一樣,所以也都是全域變數,必須要注意不能跟所
有的標籤名稱重複.
- 如果使用單純 VAR 來宣告,預設自動分配的位置為非保持的區間,如果需要自動匹配保持的位置, 則使用 VAR RETAIN 來自動匹配標籤對應的區段 如下圖:

- 如果在VAR RETAIN 內手動指定了非保持的區段 ,則會有警告出來如下圖:

提示:按 ← → 切換章節,Ctrl+K 搜尋