scada-tgz

open-source .NET SCADA framework

SourceForge.net Logo

Technical docs - dokumentacja API serwerów oraz kontrolek

Serwery

Modbus

bool RSConfig(int baud, byte port, byte parity, byte data, byte stop)
Konfiguruje port szeregowy

Wartości:
baud: 9600 lub 19200 (kbps)
port: 1=COM1(/dev/ttyS0) lub 2=COM2(/dev/ttyS1)
parity: 1=even lub 2=odd lub 3=none
data: 8 lub 7 (bitów)
stop: 1=1 lub 2=2 lub 3=1.5 lub 4=none (bitów)

Zwraca:
zawsze true

bool[] RdDigitalOuts(ushort addr, ushort num, byte slave)
To jest funkcja "Read Coils" protokołu Modbus, odczytuje wewnętrzne bity lub fizyczne cewki

ushort[] RdRegs(ushort addr, ushort num, byte slave)
To jest funkcja "Read Holding Registers" protokołu Modbus, odczytuje wewnętrzne rejestry lub fizyczne rejestry wyjściowe

ushort[] RdAnalogIns(ushort addr, ushort num, byte slave)
To jest funkcja "Read Input Registers" protokołu Modbus, odczytuje fizyczne rejestry wejściowe

Wartości:
addr: adres danych (adresowanie od zera)
num: liczba jednostek danych do odczytu (cewki: 1 do 2000, rejestry: 1 do 125)
slave: adres urządzenia slave (1 do 247)

Zwraca:
tablicę odczytanych danych rozmiaru num

bool WrDigitalOut(ushort addr, bool val, byte slave)
To jest funkcja "Write Single Coil" protokołu Modbus, zapisuje wewnętrzne bity lub fizyczne cewki

bool WrReg(ushort addr, ushort val, byte slave)
To jest funkcja "Write Single Register" protokołu Modbus, zapisuje wewnętrzne rejestry lub fizyczne rejestry wyjściowe

bool WrDigitalOuts(ushort addr, bool[] val, ushort num, byte slave)
To jest funkcja "Write Multiple Coils" protokołu Modbus, zapisuje wewnętrzne bity lub fizyczne cewki

bool WrRegs(ushort addr, ushort[] val, ushort num, byte slave)
To jest funkcja "Write Multiple Registers" protokołu Modbus, zapisuje wewnętrzne rejestry lub fizyczne rejestry wyjściowe

bool MaskReg(ushort addr, ushort andmask, ushort ormask, byte slave)
To jest funkcja "Mask Write Register" protokołu Modbus, it modifies wewnętrzne rejestry lub fizyczne rejestry wyjściowe

Wartości:
addr: adres danych (adresowanie od zera)
val: wartość danych do zapisu (lub tablica wartości rozmiaru num)
num: liczba jednostek danych do zapisu (cewki: 1 do 1968, rejestry: 1 do 123)
andmask, ormask: maski dla operacji logiczne AND oraz logiczne OR
slave: adres urządzenia slave (1 do 247)

Zwraca:
true jeśli operacja się powiodła, jeśli nie false

ushort[] WrRdRegs(ushort readaddr, ushort readnum, ushort writeaddr, ushort[] writeval, ushort writenum, byte slave)
To jest funkcja "Read/Write Multiple Registers" protokołu Modbus, najpierw zapisuje potem odczytuje wewnętrzne rejestry lub fizyczne rejestry wyjściowe

Wartości:
readaddr: adres danych do odczytu (adresowanie od zera)
readnum: liczba rejestrów do odczytu (1 do 125)
writeaddr: adres danych do zapisu (adresowanie od zera)
writeval: tablica wartości do zapisu rozmiaru writenum
writenum: liczba rejestrów do zapisu (1 do 121)
slave: adres urządzenia slave (1 do 247)

Zwraca:
tablicę odczytanych danych rozmiaru readnum

GeSNP

bool RSConfig(int baud, byte port, byte parity, byte data, byte stop)
Konfiguruje port szeregowy

Wartości:
baud: 9600 lub 19200 (kbps)
port: 1=COM1(/dev/ttyS0) lub 2=COM2(/dev/ttyS1)
parity: 1=even lub 2=odd lub 3=none
data: 8 lub 7 (bitów)
stop: 1=1 lub 2=2 lub 3=1.5 lub 4=none (bitów)

Zwraca:
zawsze true

bool[] RdDigitalOuts(ushort addr, ushort num) - odczytuje zmienne %Q
bool[] RdDigitalIns(ushort addr, ushort num) - odczytuje zmienne %I
bool[] RdDigitalMem(ushort addr, ushort num) - odczytuje zmienne %M
bool[] RdDigitalTemp(ushort addr, ushort num) - odczytuje zmienne %T
ushort[] RdAnalogOuts(ushort addr, ushort num) - odczytuje zmienne %AQ
ushort[] RdAnalogIns(ushort addr, ushort num) - odczytuje zmienne %AI
ushort[] RdRegs(ushort addr, ushort num) - odczytuje zmienne %R

Wartości:
addr: adres danych (adresowanie od zera)
num: liczba jednostek danych do odczytu (digital: 1 do 7992, analog: 1 do 500)

Zwraca:
tablicę odczytanych danych rozmiaru num

bool WrDigitalOuts(ushort addr, bool[] val, ushort num) - zapisuje zmienne %Q
bool WrDigitalIns(ushort addr, bool[] val, ushort num) - zapisuje zmienne %I
bool WrDigitalMem(ushort addr, bool[] val, ushort num) - zapisuje zmienne %M
bool WrDigitalTemp(ushort addr, bool[] val, ushort num) - zapisuje zmienne %T
bool WrAnalogOuts(ushort addr, ushort[] val, ushort num) - zapisuje zmienne %AQ
bool WrAnalogIns(ushort addr, ushort[] val, ushort num) - zapisuje zmienne %AI
bool WrRegs(ushort addr, ushort[] val, ushort num) - zapisuje zmienne %R

Wartości:
addr: adres danych (adresowanie od zera)
val: tablica wartości do zapisu rozmiaru num
num: liczba jednostek danych do zapisu (digital: 1 do 7992, analog: 1 do 500)

Zwraca:
true jeśli operacja się powiodła, jeśli nie false

bool RunPLC(bool val) - Start / Stop PLC

Wartości:
true = Run mode with I/O enabled
false = Stop mode with I/O enabled

Zwraca:
true jeśli operacja się powiodła, jeśli nie false

Kontrolki

Switch

Właściwości:
bool Val - stan przełącznika, false=wyłączony, true=włączony

Metody:
void Set(bool val) - ustawia stan przełącznika, false=wyłączony, true=włączony

Domyślna wartość: false

Tristat

Właściwości:
int Val - stan przełącznika trójstanowego, wartości to: 0, 1 oraz 2

Metody:
void Set(int val) - ustawia stan przełącznika trójstanowego, dopuszczalne wartości to: 0, 1 oraz 2

Domyślna wartość: 0

Slider

Właściwości:
float Val - stan suwaka, wartości z zakresu od Min do Max
float Max - maksymalna wartość skali suwaka
float Min - minimalna wartość skali suwaka
float Step - wartość skoku suwaka

Metody:
void Set(float val) - ustawia stan suwaka, dopuszczalne wartości z zakresu od Min do Max, nie musi wynosić (Min + wielokrotność Step)
void Reset(float max, float min) - resetuje suwak. Max=max, Min=min, Val=min. Jeżeli max<min Max jest ustawiane na Min+100. Step jest wyliczane jako (Max-Min)/100
void Reset(float max, float min, float step) - resetuje suwak. Tak jak powyżej, ale Step=step. Jeżeli step jest zbyt duże Step jest wyliczane jako (Max-Min)/10
void Reset(float val, float max, float min, float step) - resetuje suwak. Tak jak powyżej, ale Val=val, dopuszczalne wartości z zakresu od Min do Max

Domyślne wartości: Val=0, Max=100, Min=0, Step=1

Knob

Właściwości:
float Val - stan pokrętła, wartości z zakresu od Min do Max
float Max - maksymalna wartość skali pokrętła
float Min - minimalna wartość skali pokrętła
float Step - wartość skoku pokrętła

Metody:
void Set(float val) - ustawia stan pokrętła, dopuszczalne wartości z zakresu od Min do Max, nie musi wynosić (Min + wielokrotność Step)
void Reset(float max, float min) - resetuje pokrętło. Max=max, Min=min, Val=min. Jeżeli max<min Max jest ustawiane na Min+100. Step jest zawsze równe (Max-Min)/270
void Reset(float val, float max, float min) - resetuje pokrętło. Tak jak powyżej, ale Val=val, dopuszczalne wartości z zakresu od Min do Max

Domyślne wartości: Val=0, Max=270, Min=0, Step=1

Lamp

Właściwości:
bool Val - stan lampki, false=wyłączona, true=włączona
int Sizze (w ScadaWeb int Size) - średnica lampki w pikselach

Metody:
void Set(bool val) - ustawia stan lampki, false=wyłączona, true=włączona
void Reset(bool val, int size) - resetuje lampkę. Val=val, Sizze=size (minimum 20)

Domyślne wartości: Val=false, Sizze=80

Term, Tanktak samo jak w Slider

Wszystkie kontrolki posiadają to samo zdarzenie: ValueChanged, które oznacza zmianę stanu kontrolki. Zdarzenie nie przekazuje żadnych argumentów ponieważ wszystkie parametry kontrolki są dostępne do odczytu.