This is an old revision of HomePageEn/Doc/FLibComplex1 from 2009-09-22 11:22:17..

The module <FLibComplex1> of the subsystem “Specials”

Module:	FLibComplex1
Name:	Library of functions compatible with SCADA Complex1.
Òèï:	Specials
Source:	spec_FLibComplex1.so
Version:	1.0.4
Author:	Roman Savochenko
Translated:	Maxim Lysenko
Description:	Provides the library of functions compatible with SCADA Complex1 of the firm SIC "DIYA".
License:	GPL

Contents

Introduction

1. Alarm (alarm) <111>

2. Condition '<' (cond_lt) <239>

3. Condition '>' (cond_gt) <240>

4. Full condition (cond_full) <513>

5. Digital block (digitBlock) <252>

6. Division (div) <526>

7. Exponent (exp) <476>

8. Flow (flow) <235>

9. Iterator (increment) <181>

10. Lag (lag) <121>

11. Simple multiplication(mult) <259>

12. Multiplication + Division(multDiv) <468>

13. PID regulator (pid) <745>

14. Power (pow) <564>

15. Selection (select) <156>

16. Simple integrator (sum) <404>

17. Sum with the division (sum_div) <518>

18. Sum with the multiplication. (sum_mult) <483>

19. User programming API

Links

Introduction

Special module FLibComplex1 provides the OpenSCADA system with the static library of functions compatible with SCADA Complex1 of firm SIC 'DIYA'. These functions are used in the SCADA system Complex1 in the form of algoblocks to create inner-computings on the virtual controller. Provision of the library of these functions lets to do the transfer of computational algorithms from the system Complex1.

To address the functions of this library must it is necessary to use the path: <Special.FLibComplex1.*>, where '*' - function identifier in the library.

Below is the description of each function of the librariy. For each function it was evaluated the execution time. Measurements were made on the system with the following parameters: Athlon 64 3000 + (ALTLinux 4.0 (32bit)) by measuring the total execution time of the function when you call it 1000 times. Sampling was carried out of the five calculations, rounded to integer. Time is in angle brackets and is measured in microseconds.

1. Alarm (alarm) <111>

Description: Set alarm sign in the case of going out of the variable for the specified boundary.
Formula:


out = if(val>max || val<min) true; else false;

2. Condition '<' (cond_lt) <239>

Description: Operation of branching in accordance with the condition "<".
Formula:


out=if(in1<(in2_1*in2_2*in2_3*in2_4)) in3_1*in3_2*in3_3*in3_4;
else in4_1*in4_2*in4_3*in4_4;

3. Condition '>' (cond_gt) <240>

Description: Operation of branching in accordance with the condition ">".
Formula:


out=if(in1>(in2_1*in2_2*in2_3*in2_4)) in3_1*in3_2*in3_3*in3_4;
else in4_1*in4_2*in4_3*in4_4;

4. Full condition (cond_full) <513>

Description: Full check of the conditions, including more, less and equal.
Formula:


out = if(in1<(in2_1*in2_2*in2_3*in2_4)) in3_1*in3_2*in3_3*in3_4;
else if( in1>(in4_1*in4_2*in4_3*in4_4) in5_1*in5_2*in5_3*in5_4;
else in6_1*in6_2*in6_3*in6_4;

5. digital block (digitBlock) <252>

Description: Function contains the control algorithm of digital signals acquisition for valves and pumps that contain: signs of "Open", "Close" and the command "Open", "Close", "Stop". Supports work with pulse commands, i.e. can read the signal through the specified period of time.
Parameters:

ID	Parameter	Type	Mode
cmdOpen	Command "Open"	Bool	Out
cmdClose	Command "Close"	Bool	Out
cmdStop	Command "Stop"	Bool	Out
stOpen	Position "Opened"	Bool	In
stClose	Position "Closed"	Bool	In
tCmd	Command hold time (s)	Integer	In
frq	Frequency of calculation (milliseconds)	Integer	In

6. Division (div) <526>

Description: Makes division of the set of variables.
Formula:


out = (in1_1*in1_2*in1_3*in1_4*in1_5 + in2_1*in2_2*in2_3*in2_4*in2_5 + in3) /
(in4_1*in4_2*in4_3*in4_4*in4_5 + in5_1*in5_2*in5_3*in5_4*in5_5 + in6);

7. Exponent (exp) <476>

Description: Calculating the exponent under the group of variables.
Formula:


out=exp (in1_1*in1_2*in1_3*in1_4*in1_5 + (in2_1*in2_2*in2_3*in2_4*in2_5+in3) /
(in4_1*in4_2*in4_3*in4_4*in4_5+in5) )

8. Flow (flow) <235>

Description: Calculation of the gas flow.
Formula:


f = K1*((K3+K4*x)^K2);

9. Iterator (increment) <181>

Description: Iterative calculation with the increment specifying. Gain ratio for different directions is different.
Formula:


out = if( in1 > in2 ) in2 + in3*(in1-in2); 
else in2 - in4*(in2-in1);

10. Lag (lag) <121>

Îïèñàíèå: Çàäåðæêà èçìåíåíèÿ ïåðåìåííîé. Ïðàêòè÷åñêè ýòî ôèëüòð áåç ïðèâÿçêè êî âðåìåíè.
Ôîðìóëà:


y = y - Klag*( y - x );

11. Ïðîñòîå óìíîæåíèå(mult) <259>

Îïèñàíèå: Ïðîñòîå óìíîæåíèå ñ äåëåíèåì.
Ôîðìóëà:


out=(in1_1*in1_2*in1_3*in1_4*in1_5*in1_6)/
(in2_1*in2_2*in2_3*in2_4);

12. Óìíîæåíèå+äåëåíèå(multDiv) <468>

Îïèñàíèå: Ðàçâåòâëåííîå óìíîæåíèå+äåëåíèå.
Ôîðìóëà:


out=in1_1*in1_2*in1_3*in1_4*in1_5*
(in2_1*in2_2*in2_3*in2_4*in2_5+(in3_1*in3_2*in3_3*in3_4*in3_5)/
(in4_1*in4_2*in4_3*in4_4*in4_5));

13. ÏÈÄ ðåãóëÿòîð (pid) <745>

Îïèñàíèå: Ïðîïîðöèîíàëüíî-èíòåãðàëüíî-äèôôåðåíöèàëüíûé ðåãóëÿòîð.
Ïàðàìåòðû:

ID	Ïàðàìåòð	Òèï	Ðåæèì	Ïî óìîë÷àíèþ
var	Ïåðåìåííàÿ	Âåùåñòâåí.	Âõîä	0
sp	Çàäàíèå	Âåùåñòâåí.	Âõîä	0
max	Ìàêñ. øêàëû	Âåùåñòâåí.	Âõîä	100
min	Ìèí. øêàëû	Âåùåñòâåí.	Âõîä	0
manIn	Ðó÷íîé ââîä (%)	Âåùåñòâåí.	Âõîä	0
out	Âûõîä (%)	Âåùåñòâåí.	Âîçâðàò	0
auto	Àâòîìàò	Bool	Âõîä	0
casc	Êàñêàä	Bool	Âõîä	0
Kp	Kp	Âåùåñòâåí.	Âõîä	1
Ti	Òè (ìñ)	Öåëûé	Âõîä	1000
Td	Òä (ìñ)	Öåëûé	Âõîä	0
Tf	Òôèëüòð (ìñ)	Öåëûé	Âõîä	0
Hup	Âåðõíÿÿ ãðàíèöà âûõîäà (%)	Âåùåñòâåí.	Âõîä	100
Hdwn	Íèæíÿÿ ãðàíèöà âûõîäà (%)	Âåùåñòâåí.	Âõîä	0
Zi	Íå÷óâñòâèòåëüíîñòü (%)	Âåùåñòâåí.	Âõîä	1
K1	Êîýô. âõîäà 1	Âåùåñòâåí.	Âõîä	0
in1	Âõîä 1	Âåùåñòâåí.	Âõîä	0
K2	Êîýô. âõîäà 2	Âåùåñòâåí.	Âõîä	0
in2	Âõîä 2	Âåùåñòâåí.	Âõîä	0
K3	Êîýô. âõîäà 3	Âåùåñòâåí.	Âõîä	0
in3	Âõîä 3	Âåùåñòâåí.	Âõîä	0
K4	Êîýô. âõîäà 4	Âåùåñòâåí.	Âõîä	0
in4	Âõîä 4	Âåùåñòâåí.	Âõîä	0
f_frq	×àñòîòà âû÷èñëåíèÿ (%)	Âåùåñòâåííûé	Âõîä	1

Ñòðóêòóðà:
file:pid.png

14. Ñòåïåíü (pow) <564>

Îïèñàíèå: Âîçâåäåíèå â ñòåïåíü.
Ôîðìóëà:


out=(in1_1*in1_2*in1_3*in1_4*in1_5)^
(in2_1*in2_2*in2_3*in2_4*in2_5 + (in3_1*in3_2*in3_3*in3_4*in3_5)/
(in4_1*in4_2*in4_3*in4_4*in4_5));

15. Âûáîð (select) <156>

Îïèñàíèå: Âûáîð îäíîãî èç ÷åòûð¸õ âàðèàíòîâ.
Ôîðìóëà:


out = if( sel = 1 ) in1_1*in1_2*in1_3*in1_4;
if( sel = 2 ) in2_1*in2_2*in2_3*in2_4;
if( sel = 3 ) in3_1*in3_2*in3_3*in3_4;
if( sel = 4 ) in4_1*in4_2*in4_3*in4_4;

16. Ïðîñòîé ñóììàòîð (sum) <404>

Îïèñàíèå: Ïðîñòîå ñóììèðîâàíèå ñ óìíîæåíèåì.
Ôîðìóëà:


out=in1_1*in1_2+in2_1*in2_2+in3_1*in3_2+in4_1*in4_2
+ in5_1*in5_2+in6_1*in6_2+in7_1*in7_2+in8_1*in8_2;

17. Ñóììà ñ äåëåíèåì (sum_div) <518>

Îïèñàíèå: Ñóììèðîâàíèå ñ äåëåíèåì ãðóïïû çíà÷åíèé.
Ôîðìóëà:


out = in1_1*in1_2*(in1_3+in1_4/in1_5) + 
in2_1*in2_2*(in2_3+in2_4/in2_5) +
in3_1*in3_2*(in3_3+in3_4/in3_5) + 
in4_1*in4_2*(in4_3+in4_4/in4_5);

18. Ñóììà ñ óìíîæåíèåì (sum_mult) <483>

Îïèñàíèå: Ñóììèðîâàíèå ñ óìíîæåíèåì ãðóïïû çíà÷åíèé.
Ôîðìóëà:


out = in1_1*in1_2*(in1_3*in1_4+in1_5) + 
in2_1*in2_2*(in2_3*in2_4+in2_5) +
in3_1*in3_2*(in3_3*in3_4+in3_5) + 
in4_1*in4_2*(in4_3*in4_4+in4_5);

Ññûëêè

Referring pages: HomePageEn/Doc
HomePageEn/Doc/DAQ
HomePageEn/Doc/FLibComplex1
HomePageEn/Doc/ProgrammManual
HomePageEn/Doc/ProgrammManual/part5

OpenSCADAWiki: Home Page En/Doc/F Lib Complex1 ...

The module <FLibComplex1> of the subsystem “Specials”

Introduction

1. Alarm (alarm) <111>

2. Condition '<' (cond_lt) <239>

3. Condition '>' (cond_gt) <240>

4. Full condition (cond_full) <513>

5. digital block (digitBlock) <252>

6. Division (div) <526>

7. Exponent (exp) <476>

8. Flow (flow) <235>

9. Iterator (increment) <181>

10. Lag (lag) <121>

11. Ïðîñòîå óìíîæåíèå(mult) <259>

12. Óìíîæåíèå+äåëåíèå(multDiv) <468>

13. ÏÈÄ ðåãóëÿòîð (pid) <745>

14. Ñòåïåíü (pow) <564>

15. Âûáîð (select) <156>

16. Ïðîñòîé ñóììàòîð (sum) <404>

17. Ñóììà ñ äåëåíèåì (sum_div) <518>

18. Ñóììà ñ óìíîæåíèåì (sum_mult) <483>

Ññûëêè