From OpenSCADAWiki
Jump to: navigation, search
Constr.png Moving from the old Wiki
Name Version License Source Languages Author Description
Regulation elements library 1.0 GPLv2 OscadaLibs.db (SQL, GZip) > DAQ.JavaLikeCalc.regEl en Roman Savochenko Regulation elements library.

The library is created to provide functions of different control algorithms and can be used in programmable logic controllers (PLCs) based on OpenSCADA for construction control schemes. The library is not static, but based on the module JavaLikeCalc, allowing to create calculations on the Java-like language. The functions' names and its parameters are available in three languages: English, Ukrainian and Russian.

To addressing the library functions you can use the static call address DAQ.JavaLikeCalc.lib_regEl.{Func}() or dynamic SYS.DAQ.JavaLikeCalc["lib_regEl"]["{Func}"].call(), SYS.DAQ.JavaLikeCalc["lib_regEl"].{Func}()". Where {Func} — function identifier in the library.

For connection the library to a project of the OpenSCADA station you can obtain the database file as:

  • supplied with a ready and proper package of the Linux distribution like to "openscada-libdb-main", "openscada-LibDB.Main";
  • directly taken for most actual one from the subversion repository and converted to the DB SQLite file in way:
$ wget http://oscada.org/svn/trunk/OpenSCADA/data/LibsDB/OscadaLibs.sql
$ sqlite3 -init OscadaLibs.sql OscadaLibs.db .exit

This obtained file next you can place into the project's database directory of the station and create the database object for the DB module "SQLite", registering the database file in the configuration.

To connect the library to a project of the OpenSCADA station it is possible by downloading the attached file of the database, placing it in in the database directory of the station's project and creating the database object for the DB module "SQLite", indicating the database file in the configuration.


1 PID (unified) (pidUnif)

1.0 GPLv2 * en Roman Savochenko

Composite-unified analog and pulse PID. At the heart of the regulator is core a standard analog PID controller from the library FLibComplex1 and the implementation of the PWM for the pulse part.

Parameters

Identifier Parameter Type Mode Hide Default
var Variable Real Input false 0
sp Setpoint Real Input false 0
max Scale: maximum Real Input false 100
min Scale: minimum Real Input false 0
manIn Manual input Real Input false 0
out Output (%) Real Return false 0
impQup Impulse output up Boolean Output false 0
impQdwn Impulse output down Boolean Output false 0
analog Analog Boolean Input false 1
auto Automate Boolean Input false 0
casc Cascade Boolean Input false 0
Kp Gain Real Input false 1
Ti Ti (ms) Integer Input false 1000
Kd Gain differential Real Input false 1
Td Td (ms) Integer Input false 0
Tzd T differential lag (ms) Integer Input false 0
TImpPer T impulses period (ms) Integer Input false 5000
TImpMin T minimal impulse (ms) Integer Input false 500
KImpRfact Impulse rate factor Real Input false 1
Hup Upper output border (%) Real Input false 100
Hdwn Neither output border (%) Real Input false 0
Zi Insensitivity (%) Real Input false 0
followSp Follow to variable by setpoint into manual Boolean Input false 1
K1 Coefficient of input 1 Real Input false 0
in1 Input 1 Real Input false 0
K2 Coefficient of input 2 Real Input false 0
in2 Input 2 Real Input false 0
K3 Coefficient of input 3 Real Input false 0
in3 Input 3 Real Input false 0
K4 Coefficient of input 4 Real Input false 0
in4 Input 4 Real Input false 0
impAnOut Analog position of impulse regulator Real Input false 0
impAnImit Analog position imitation Boolean Input false 0
impQupTm Imp. output up lag for GUI Integer Output false 0
impQdwnTm Imp. output down lag for GUI Integer Output false 0
f_frq Calc frequency (Hz) Integer Input true 1
f_start First start Boolean Input true 0
f_stop Last start Boolean Input true 0
int Integral accumulation Real Output true 0
dif Differential accumulation Real Output true 0
lag Lag accumulation Real Output true 0
impLag Impulse lag time Real Output true 0
perLag New impulse generation time Real Output true 0

Structure
RegEls pid unif.png

2 PID dynamic (pidUnifD)

1.0 GPLv2 * en Roman Savochenko

Completely identical to the unified PID regulator is implemented dynamically on JavaLikeCalc. The dynamic implementation allows you to easily adapt the regulator to the desired requirements, simply editing it.

Parameters

Identifier Parameter Type Mode Hide Default
var Variable Real Input false 0
sp Setpoint Real Input false 0
max Scale: maximum Real Input false 100
min Scale: minimum Real Input false 0
manIn Manual input Real Input false 0
out Output (%) Real Return false 0
impQup Impulse output up Boolean Output false 0
impQdwn Impulse output down Boolean Output false 0
analog Analog Boolean Input false 1
auto Automate Boolean Input false 0
casc Cascade Boolean Input false 0
Kp Gain Real Input false 1
Ti Ti (ms) Integer Input false 1000
Kd Gain differential Real Input false 1
Td Td (ms) Integer Input false 0
Tzd T differential lag (ms) Integer Input false 0
TImpPer T impulses period (ms) Integer Input false 5000
TImpMin T minimal impulse (ms) Integer Input false 500
KImpRfact Impulse rate factor Real Input false 1
Hup Upper output border (%) Real Input false 100
Hdwn Neither output border (%) Real Input false 0
Zi Insensitivity (%) Real Input false 0
followSp Follow to variable by setpoint into manual Boolean Input false 1
K1 Coefficient of input 1 Real Input false 0
in1 Input 1 Real Input false 0
K2 Coefficient of input 2 Real Input false 0
in2 Input 2 Real Input false 0
K3 Coefficient of input 3 Real Input false 0
in3 Input 3 Real Input false 0
K4 Coefficient of input 4 Real Input false 0
in4 Input 4 Real Input false 0
QO Opened state of the control mechanism Boolean Input false 0
QZ Closed state of the control mechanism Boolean Input false 0
impAnOut Real analog position of impulse regulator, [0...100], -1 - disable Real Input false 0
impAnImit Full stroke time for analog position imitation, s Boolean Input false 0
impQupTm Imp. output up lag for GUI Integer Output false 0
impQdwnTm Imp. output down lag for GUI Integer Output false 0
f_frq Calc frequency (Hz) Integer Input true 1
f_start First start Boolean Input true 0
f_stop Last start Boolean Input true 0
impLag Impulse lag time Real Output true 0
perLag New impulse generation time Real Output true 0
integ Integral accumulation Real Output true 0
difer Differential accumulation Real Output true 0
dlag Differential lag accumulation Real Output true 0

Structure
RegEls pid unif.png

3 PID pulse (pidImp)

1.0 GPLv2 * en Roman Savochenko

Specialized pulse PID regulator is implemented on a special algorithm with compensation of double integration.

Parameters

Identifier Parameter Type Mode Hide Default
var Variable Real Input false 0
sp Setpoint Real Input false 0
max Scale: maximum Real Input false 100
min Scale: minimum Real Input false 0
manIn Manual input Real Input false 0
out Output (%) Real Return false 0
outPID PID output Real Output false 0
impQup Impulse output up Boolean Output false 0
impQdwn Impulse output down Boolean Output false 0
auto Automate Boolean Input false 0
casc Cascade Boolean Input false 0
Kp Gain Real Input false 1
Ki Gain integer Real Input false 1
Ti Ti (ms) Integer Input false 1000
Kd Gain differential Real Input false 1
Td Td (ms) Integer Input false 0
Tzd T differential lag (ms) Integer Input false 0
TImpPer T impulses period (ms) Integer Input false 5000
TImpMin T minimal impulse (ms) Integer Input false 500
KImpRfact Impulse rate factor Real Input false 1
Hup Upper output border (%) Real Input false 100
Hdwn Neither output border (%) Real Input false 0
Zi Insensitivity (%) Real Input false 0
followSp Follow to variable by setpoint into manual Boolean Input false 1
K1 Coefficient of input 1 Real Input false 0
in1 Input 1 Real Input false 0
K2 Coefficient of input 2 Real Input false 0
in2 Input 2 Real Input false 0
K3 Coefficient of input 3 Real Input false 0
in3 Input 3 Real Input false 0
K4 Coefficient of input 4 Real Input false 0
in4 Input 4 Real Input false 0
impAnOut Analog position of impulse regulator Real Input false 0
impAnImit Analog position imitation Boolean Input false 0
impQupTm Imp. output up lag for GUI Integer Output false 0
impQdwnTm Imp. output down lag for GUI Integer Output false 0
f_frq Calc frequency (Hz) Integer Input true 1
f_start First start Boolean Input true 0
f_stop Last start Boolean Input true 0
impLag Impulse lag time Real Output true 0
perLag New impulse generation time Real Output true 0
integ Integral accumulation Real Output true 0
difer Differential accumulation Real Output true 0
dlag Differential lag accumulation Real Output true 0
err1 Error step back Real Output true 0
err2 Error two step back Real Output true 0

Structure
RegEls pid imp.png