# Konfiguracja i podłaczanie sygnałów

W systemie **OmniMES** konfiguracja sygnałów produkcyjnych została zaprojektowana z myślą o maksymalnej elastyczności oraz kompatybilności z różnorodną infrastrukturą zakładów przemysłowych. System umożliwia integrację zarówno z pojedynczymi sterownikami PLC, panelami HMI, jak i złożonymi układami wielu urządzeń połączonych przez bramki komunikacyjne - pod warunkiem, że dane przesyłane są po protokole **MQTT**. Natywnym formatem jest **Sparkplug B**, ale system potrafi także odbierać **zwykłe wiadomości MQTT** i automatycznie konwertować je na Sparkplug B (patrz sekcja *Odbiór zwykłego MQTT i konwersja na Sparkplug B*).


---

## Wymagania wstępne

Aby rozpocząć proces konfiguracji sygnałów, niezbędne jest posiadanie listy opisanych sygnałów pochodzących z urządzeń automatyki.

Dane te mogą pochodzić od integratora, automatyka, zespołu utrzymania ruchu lub mogą być znane bezpośrednio przez użytkownika systemu. Kluczowe elementy to: identyfikatory maszyn w postaci topików i tagów MQTT.

Dla poprawnej komunikacji urządzenia muszą zostać uprzednio skonfigurowane w celu połączenia z brokerem danych systemu OmniMES - należy ustawić adres brokera, port, nazwę użytkownika oraz hasło.

 ![](https://docs.omnimes.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzL2RmMTUxNTFiLThmMzItNDVkNi1iZjE4LTZmZmZhNjg4ZGIwNy8yZjYxMjE3OC00MDA1LTQ4YTUtOGFkOS00ODExYTdmNzc2NzAvaW1hZ2UucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTQ3ODgxMDAsImV4cCI6MTc5NDg3NDUwMH0.QfC413fa1uMugYdDkvfOLnDW_GNzs_LpKH26trBy2oo " =1126x746")

*Przykład ustawień adresu, nazwy użytkownika i hasła do brokera Omnimes na bazie bramki Weintek CMT G01 i oprogramowania EasyBuilder Pro*

## Przykład na podstawie bramki komunikacyjnej Weintek CMT G01

Przykładowa konfiguracja bramki odbywa się przy użyciu narzędzia **EasyBuilder Pro**, gdzie w zakładce ustawień sieciowych definiujemy dane dostępowe do brokera systemu OmniMES. Po prawidłowym połączeniu bramki z brokerem, można zweryfikować np. przy użyciu narzędzia **MQTT.fx (v1.7.1)** dostępnego w zakładce FAQ.

 ![](https://docs.omnimes.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzL2RmMTUxNTFiLThmMzItNDVkNi1iZjE4LTZmZmZhNjg4ZGIwNy81ZTA2YjcxZC01NWNlLTRkOWUtYTU1OC03YTVkMDc3NDdkYjEvaW1hZ2UucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTQ3ODgxMDAsImV4cCI6MTc5NDg3NDUwMH0.-_JQCzD0SBPrzaxikwEc_7fMWmKyF4_ttwMsPgfdfdI " =797x631")

*Przykład ustawień rejestrów podłączonych do bramki z sterownika PLC na bazie bramki Weintek CMT G01 i oprogramowania do niej EasyBuilder Pro*

 ![](https://docs.omnimes.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzL2RmMTUxNTFiLThmMzItNDVkNi1iZjE4LTZmZmZhNjg4ZGIwNy9iNGM3OGViOS1mMGMwLTQzNGUtOGJkNC1mODllNDlkMGJjY2YvaW1hZ2UucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTQ3ODgxMDAsImV4cCI6MTc5NDg3NDUwMH0.j3vFIpbgD1Cg9XCOuyZCJDhnaE_p1WlpJOjaZmv95Cc " =1909x602")

*Przykład prawidłowo skonfigurowanej bramki CMT G01 która rozpoczęła nadawanie sygnałów pochodzacych z sterownika/ów PLC do systemu Omnimes*

## Odbiór zwykłego MQTT i konwersja na Sparkplug B

OmniMES natywnie pracuje na **Sparkplug B**, ale potrafi również odbierać **zwykłe wiadomości MQTT** (surowy temat + wartość) i **automatycznie konwertować** je na Sparkplug B. Dzięki temu można podłączyć urządzenia i bramki, które publikują prosty MQTT, bez implementowania po ich stronie pełnej specyfikacji Sparkplug.

Funkcję włącza się przełącznikiem **Konwersja plain MQTT → Sparkplug** w **Konfiguracja ogólna → Broker → Zachowanie streamu** (zmiana działa na żywo, bez restartu).

### Jak to działa

Urządzenie publikuje zwykłą wiadomość MQTT na **wydzielony prefiks tematu** (domyślnie `omni/raw/...`). Usługa zapisu (stream) odbiera taką wiadomość, konwertuje ją na **Sparkplug B** i **republikuje** na temat `spBv1.0/...`. Od tego momentu zarówno **podgląd na żywo** (Monitoring, Planogram), jak i **archiwizacja** widzą jednolity Sparkplug - bez żadnych zmian po ich stronie.

```
Urządzenie  ──(zwykłe MQTT: omni/raw/...)──▶  Broker
                                               │
                                               ▼
                                            Stream  (konwersja plain → Sparkplug B)
                                               │
                                               ▼
                              Broker  ──(spBv1.0/...)──▶  Monitoring / Planogram + archiwizacja
```

### Reguła konwersji tematu i wartości

* **Temat:** wynikowy temat Sparkplug = `spBv1.0/` + temat wejściowy (po prefiksie `omni/raw/`) **bez ostatniego segmentu**. Ostatni segment tematu staje się **nazwą metryki** (`name`), która musi odpowiadać **tagowi** statusu zdefiniowanego w Konfiguratorze statusów. Publikujący sam podaje w temacie pełną strukturę Sparkplug (grupa / DDATA / węzeł / urządzenie).
* **Wartość:** payload to sama wartość (liczba lub tekst) albo obiekt JSON `{"value": X, "ts": <ms>}`. Typ danych ustalany jest automatycznie i zgodnie ze Sparkplug B: liczba → `Double`, wartość logiczna → `Boolean`, tekst → `String`.

**Przykład:**

| Wejście (zwykłe MQTT) | Wynik (Sparkplug B) |
|-----------------------|---------------------|
| temat `omni/raw/companyID/DDATA/Frezarka CNC/Local_HMI/temperature_motor_C`, wartość `15.6` | temat `spBv1.0/companyID/DDATA/Frezarka CNC/Local_HMI`, metryka `name: temperature_motor_C`, `value: 15.6`, `dataType: Double` |

Jak widać, po konwersji temat i metryka wyglądają **identycznie jak przy natywnym Sparkplug B** - dalszą konfigurację (utworzenie statusu z odpowiednim **tagiem**, równym nazwie metryki) przeprowadza się tak samo, jak dla urządzeń Sparkplug.


:::info
Prefiks wejściowy (`omni/raw/`) musi być rozłączny od `spBv1.0/#`, aby uniknąć zapętlenia. Konwersję można w każdej chwili włączyć/wyłączyć z poziomu Konfiguracji ogólnej.

:::

## Struktura systemu i tworzenie parku maszynowego

Proces konfiguracji rozpoczynamy od zdefiniowania struktury parku maszynowego:

`Park Maszynowy  `

`├── Linia 1    `

`├──── Maszyna A   `

`└──── Maszyna B  `

`└── Linia 2      `

`├──── Maszyna A      `

`└──── Maszyna B `

*Tak prezentuje się przykładowa struktura w formie drzewka infrastruktury parku maszynowego*


:::tip
Menu → Ustawienia systemowe → Struktura

:::

Strukturę parku konfigurujesz w **klasycznym widoku drzewa** w zakładce „Struktura":

 ![](https://docs.omnimes.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzL2RmMTUxNTFiLThmMzItNDVkNi1iZjE4LTZmZmZhNjg4ZGIwNy9jMTY1M2Q1YS1mZTk2LTQ4M2QtYTNmZS0zNGQzMWQ4ZjkyZDEvaW1hZ2UucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTQ3ODgxMDAsImV4cCI6MTc5NDg3NDUwMH0.YA10p8IVera9N7lx6Lt2FjgXabk6_V8SxbD9PETHVfw " =1054x856")

Po utworzeniu linii i maszyn możliwe jest duplikowanie ich konfiguracji, co znacząco przyspiesza proces wdrażania wielu stanowisk.

## Konfigurator statusów


:::tip
Menu → Ustawienia systemowe → Konfigurator statusów

:::

**Konfigurator statusów** to miejsce, w którym przypisujesz sygnały (statusy) z urządzeń do maszyn w strukturze zakładu. Cały moduł mieści się na jednym ekranie z zakładkami w dwóch grupach:

* **Statusy** - *Statusy* (lista i dodawanie), *Profile statusów*, *Automatyczne wykrywanie*, *Import statusów przez CSV*,
* **Inne** - *Parametry*, *Aliasy*, *Jednostki*.

 ![](https://docs.omnimes.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzRlMDdmZmNhLThmZjAtNDYxYy1iYjEyLTA2OTEyZGRiOGQzNi9kY2UzMDdkNi00NWI1LTQ2OWUtYTliMi0zNjFkNDc0N2MyODIvMDFfZ2xvd25hX3N0YXR1c3kucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTQ3ODgxMDAsImV4cCI6MTc5NDg3NDUwMH0.YPcDE-VOcQutl1bVAyPG25FF2K9nKqsfEtD0IAE-MmI " =1680x950")


:::info
Każda zmiana w statusach jest **zapisywana automatycznie** - nie ma potrzeby ręcznego zatwierdzania listy.

:::

### Słowniki pomocnicze (grupa „Inne")

Przed przypisaniem sygnałów warto zdefiniować elementy słownikowe:

* **Jednostki** - np. sztuki (szt), kilowatogodziny (kWh), metry sześcienne (m³) - wg potrzeb,

 ![](https://docs.omnimes.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzRlMDdmZmNhLThmZjAtNDYxYy1iYjEyLTA2OTEyZGRiOGQzNi83ZDcyZDZhNy1kOTY4LTRjODMtOWI0YS1mM2VlZDhkYjFiM2YvMDhfamVkbm9zdGtpLnBuZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzk0Nzg4MTAwLCJleHAiOjE3OTQ4NzQ1MDB9.4dMP_n-1vZ27mXzBZYtyPlFxjec6vWmK5_wWBwoQ8ig " =1680x950")

* **Aliasy** - przyjazne nazwy znaczników, używane w dalszej konfiguracji,

 ![](https://docs.omnimes.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzRlMDdmZmNhLThmZjAtNDYxYy1iYjEyLTA2OTEyZGRiOGQzNi9kNThhYzQyMi0xZDA5LTRkYjAtYTMzMi0wMjVkN2RiN2M1NDcvMDdfYWxpYXN5LnBuZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzk0Nzg4MTAwLCJleHAiOjE3OTQ4NzQ1MDB9.2ufA8JC8SR1cgndrpWGTFvqcNaClFsMUtCeYR3PSvps " =1680x950")

* **Parametry** - definicje typu **Zdarzenie** (np. awarie, postoje, produkcja - przypisane do konkretnych wartości) lub **Pomiar** (np. temperatura, prędkość, zużycie prądu - wartości zmienne).

 ![](https://docs.omnimes.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzRlMDdmZmNhLThmZjAtNDYxYy1iYjEyLTA2OTEyZGRiOGQzNi8yZmJlYWIwZS01MDdiLTQ4OTItYjhiNC05ZGIwYmUyNDZhNjAvMDZfcGFyYW1ldHJ5LnBuZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzk0Nzg4MTAwLCJleHAiOjE3OTQ4NzQ1MDB9.Mb1ifR2LK8g-qVsprTge8oPkupwG6GfkgNdg0SKXz2c " =1680x950")

### Profile statusów

Dla parametrów tworzysz **profile**, które określają sposób prezentacji i zachowania statusu w systemie:

* typ profilu: zdarzenie / pomiar,
* forma wizualna: tekst, prędkościomierz, kolory, ikony, rozmiar czcionki,
* hierarchia: status główny i statusy podrzędne (np. „Produkcja" > „Ilość sztuk").

 ![](https://docs.omnimes.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzRlMDdmZmNhLThmZjAtNDYxYy1iYjEyLTA2OTEyZGRiOGQzNi9hNGJjMjFmYi0xN2FjLTQ3ZjQtOWE0Yi01MzFkNjRjZWM2NjkvMDNfcHJvZmlsZS5wbmciLCJ0eXBlIjoiYXR0YWNobWVudCIsImlhdCI6MTc5NDc4ODEwMCwiZXhwIjoxNzk0ODc0NTAwfQ.7HsyGncqRyQyXHSqUpUKpi6yZN6E7zKpE1uCky_9QLM " =1680x950")

### Dodawanie statusów (sygnałów)

W zakładce **Statusy** dostępne są trzy metody wprowadzania sygnałów:

**1. Ręczne dodawanie** - przycisk **Dodaj** otwiera formularz z polami:

* **Topic** - pełna ścieżka MQTT identyfikująca źródło sygnału,
* **Tag** oraz **Wartość tagu** - etykieta i wartość znacznika,
* **Wyświetlana nazwa na monitoringu** (opcjonalna),
* **Typ danych** - pomiar lub zdarzenie,
* **Profil** - wcześniej zdefiniowany profil statusu,
* **Park maszynowy / Linia / Maszyna** - przypisanie do miejsca w strukturze.

Statusy można też **duplikować** oraz edytować wiele naraz (przełącznik **Podgląd / Edytuj Wiele**).

 ![](https://docs.omnimes.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzRlMDdmZmNhLThmZjAtNDYxYy1iYjEyLTA2OTEyZGRiOGQzNi9jNjNlMGI4NS05YmM3LTRhOTgtYTZjMC1lMzc5NGQxODFiODcvMDJfZG9kYWpfc3RhdHVzLnBuZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzk0Nzg4MTAwLCJleHAiOjE3OTQ4NzQ1MDB9.4t_hNGEmzIAa009IKz2Fd0ChlhhQZTJI77QUBO5oc98 " =1680x950")

**2. Automatyczne wykrywanie** - skanuje sygnały nadawane przez urządzenia i pozwala przypisać je hurtowo do struktury.

 ![](https://docs.omnimes.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzRlMDdmZmNhLThmZjAtNDYxYy1iYjEyLTA2OTEyZGRiOGQzNi81NzM3MWViYy00MmM5LTRmN2EtYjA1OS1lYjg4NTQxYTBmMmIvMDRfYXV0by5wbmciLCJ0eXBlIjoiYXR0YWNobWVudCIsImlhdCI6MTc5NDc4ODEwMCwiZXhwIjoxNzk0ODc0NTAwfQ.kRwULuB_-tcT62Jc2xZvhWVIqjyJ2AU3CajSpNFqTZ0 " =1680x950")

**3. Import zbiorczy z pliku CSV** - idealny przy dużych wdrożeniach. Po imporcie przypisujesz profil do każdego statusu.

 ![](https://docs.omnimes.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzRlMDdmZmNhLThmZjAtNDYxYy1iYjEyLTA2OTEyZGRiOGQzNi8yN2E4NTVhZS01NzcwLTQ0NmQtYTllNC0xNWM0ZjhhZTNjZjkvMDVfY3N2LnBuZyIsInR5cGUiOiJhdHRhY2htZW50IiwiaWF0IjoxNzk0Nzg4MTAwLCJleHAiOjE3OTQ4NzQ1MDB9.gFrIfQix83WcTeum-tOsZq8cmOZ2xUibZ3O6THNj2ss " =1680x950")

Przykładowa struktura pliku .csv:

`spBv1.0/companyID/DDATA/machineID/Local HMI;MES/Machine6/HMI1/M_STATE;1;;Automat spawalniczy spBv1.0/companyID/DDATA/machineID/Local HMI;MES/Machine6/HMI1/CurrentPower[W];;;Automat spawalniczy`

### Podgląd, edycja i wynik na monitoringu

Listę statusów można filtrować (park maszynowy, profil, nazwa tagu, data), eksportować (**Export**) oraz edytować, duplikować i usuwać. Każdy poprawnie skonfigurowany status (np. awaria przypisana do maszyny z profilem „Awaria") jest od razu prezentowany w czasie rzeczywistym na **Monitoringu**:

 ![](https://docs.omnimes.com/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzRlMDdmZmNhLThmZjAtNDYxYy1iYjEyLTA2OTEyZGRiOGQzNi8xYTk0MTg4Yi0wMTdkLTRlY2UtOGM1MC04Y2ZiNmNkOTFhMWQvaW1hZ2UucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTQ3ODgxMDAsImV4cCI6MTc5NDg3NDUwMH0.dShWkAHbGykmQ-BDqY8JRU6328sPDqw1EfShRppVyqE " =633x740")

*Gotowy sygnał wyświetlany na monitoringu*

## Podsumowanie

Wszystkie skonfigurowane statusy można przeglądać i filtrować według parku maszynowego, linii i maszyny; możliwa jest ich edycja i duplikacja. Po zakończeniu konfiguracji dane są:

* zapisywane w bazie danych systemu OmniMES,
* prezentowane w czasie rzeczywistym na monitoringu,
* wykorzystywane do budowy dashboardów, planogramów oraz raportów analitycznych.

---

**Documents**

- [Omnimes](https://docs.omnimes.com/s/1c357062-fcc1-4fbe-a88e-09285cda6e02/doc/omnimes-k1PbFf5XE7)
- [Omnienergy](https://docs.omnimes.com/s/1c357062-fcc1-4fbe-a88e-09285cda6e02/doc/omnienergy-BWrsbBiH1j)
- [Omniplatform](https://docs.omnimes.com/s/1c357062-fcc1-4fbe-a88e-09285cda6e02/doc/omniplatform-jARFxkuLdt)
- [FAQ](https://docs.omnimes.com/s/1c357062-fcc1-4fbe-a88e-09285cda6e02/doc/faq-XN4QKuFPZL)
- [Cyberbezpieczeństwo i zgodność (CRA)](https://docs.omnimes.com/s/1c357062-fcc1-4fbe-a88e-09285cda6e02/doc/cyberbezpieczenstwo-i-zgodnosc-cra-6dbPWZS59e)