# DataHub

## Konwersja wartości IEC-61850/Modbus
### 1. Zapis (sterowanie) za pomocą protokołu IEC

Przedstawione poniżej tabele przedstawiają informacje o konwersji wartości
z protokołu IEC-61850 na protokół Modbus RTU.
Konwersja ta zachodzi podczas sterowania zmienną protokołu IEC-61850.
W kolumnie **typ wewnętrzny** znajdują się typy zmiennych jakie przechowuje i operuje hub danych (tzw. zmienne pośrednie).

| TYP IEC | TYP MODBUS |STEROWANIE |TYP WEWNĘTRZNY|
|----------|-------------|-------------|--------------|
| BOOLEAN | HR (rw) |DOZWOLONE | BOOL |
| | IR (ro) |ZABRONIONE | --- |
| | COIL (rw) |DOZWOLONE | BOOL |
| | DI (ro) |ZABRONIONE | --- |

Przykład konwersji:
**ProtectSi/demoXCBR1.Pos.Oper.ctlVal** -> Modbus HR(offset=0, bit=2)
Po protokole IEC zapisywana jest wartość (BOOL) na bicie nr 2 rejestru HR o offsecie 0.

| TYP IEC |TYP MODBUS |STEROWANIE |TYP WEWNĘTRZNY|
|-------------|-------------|-------------|--------------|
| INT8U/INT16 | HR (rw) |DOZWOLONE | U8/U16 |
| | IR (ro) |ZABRONIONE | --- |
| | COIL (rw) |DOZWOLONE | BOOL |
| | DI (ro) |ZABRONIONE | --- |

Przykład konwersji:
**ProtectSi/demoXCBR1.Pos.Oper.ctlNum** -> Modbus HR(offset=0)
Po protokole IEC zapisywana jest wartość (U16) w rejestrze HR o offsecie 0.

### 2. Oczyt wartości za pomocą protokołu IEC

Przedstawione poniżej tabele przedstawiają informacje o konwersji wartości
z protokołu Modbus RTU na protokół IEC-61850.

Przykładowa konfiguracja dla zmiennej Modbus:

{
    "slave_id": 1,
    "reg_type": 3,
    "reg_offset": 0,
    "reg_count": 1,
    "reg_endian": 1,
    "reg_format": "dec",
}

| Parametr | Opis |
|-----------|------------------------------------- |
| slave_id | Adres stacji podrzędnej |
| reg_type | Typ rejestru Modbus |
| reg_offset| Przesunięcie - numer rejestru Modbus |
| reg_count | Liczba bajtów |
| reg_endian| Kolejność bajtów |
| reg_format| Formatowanie (dec/hex/bin) |

| TYP IEC | TYP MODBUS |TYP WEWNĘTRZNY|
|----------|-------------|--------------|
| BOOLEAN | HR (rw) | BOOL |
| | IR (ro) | BOOL |
| | COIL (rw) | BOOL |
| | IR (ro) | BOOL |

| TYP IEC | TYP MODBUS |TYP WEWNĘTRZNY|
|----------|-------------|--------------|
| INT8U | HR (rw) | U8 |
| | IR (ro) | U8 |
| | COIL (rw) | BOOL |
| | DI (ro) | BOOL |

| TYP IEC | TYP MODBUS |TYP WEWNĘTRZNY|
|----------|-------------|--------------|
| INT16U | HR (rw) | U16 |
| | IR (ro) | U16 |
| | COIL (rw) | BOOL |
| | DI (ro) | BOOL |

# Dokumentacja konfiguracji
<http://gitlab.energotest.com.pl:8080/EKM3/doc/modbus_config/index.html>