Budowa projektu MyWayy

Plik configuration.xml

W pliku ustala się strukturę projektu oraz definiuje się urządzenia wchodzące w skład projektu.

<?xml version="1.0" encoding="utf-8" ?>
<mywayy name="FILL_ME" prefix="FILL_ME-">
    <views File="main.mwxml" UseScript="False">
        <view Name="Centrala" File="n1.mwxml" UseScript="True"/>
        <view Name="Węzeł Cieplny" File="wezel.mwxml" UseScript="False"/>
    </views> 
    <plcs>
        <plc id="n1" name="Centrala nawiewna" kproj="przyklad.kproj" ip="10.200.1.100" tag="Centrala"  DefaultDeviceId="1" type="wplc"/>    
        <plc id="wezel" name="Węzeł Cieplny" kproj="wezel.kproj" ip="10.200.1.101" tag="Węzeł"  DefaultDeviceId="1" type="wplc"/>   
    </plcs>

</mywayy>

Struktura projektu

Projekt składa się z widoków z rozszerzeniem mwxml. Strukturę widoków tworzy się odpowiednio korzystając z argumentów <view>: aby stworzyć pojedynczy widok, na końcu linijki wystarczy zakończyć wyrażenie znakiem />. W przykładzie poniżej, oba widoki są równoległe w jednym widoku.

<views File="main.mwxml" UseScript="False">
    <view Name="Centrala" File="n1.mwxml" UseScript="True"/>
    <view Name="Węzeł Cieplny" File="wezel.mwxml" UseScript="False"/>
</views> 

Aby umieścić widok “Węzeł Cieplny” w widoku “Centrala” wystarczy przesunąć miejsce zamknięcia widoku “Centrala” zmieniając znak /> na > i w miejscu końca widoku wstawić linikję zawierającą komendę </view>:

<views File="main.mwxml" UseScript="False">
    <view Name="Centrala" File="n1.mwxml" UseScript="True">
    <view Name="Węzeł Cieplny" File="wezel.mwxml" UseScript="False"/>
    </view>
</views> 

W projekcie jeden widok z rozszerzeniem .mwxml powinien być użyty tylko raz w menu nawigacyjnym.

Name

Name to nazwa widoku, nazwa ta będzie wyświetlana w liście nawigacyjnej. Nazwa może być dowolna, program będzie skalował szerokość paska nawigacyjnego do najdłuższej nazwy. Akceptowalne są zarówno znaki typu !?-_, duże i małe litery a także polskie znaki.

File

File zawiera ścieżkę do pliku, który ma zostać przypisany do danego miejsca na liście.

Usescript

Przyjmuje argumenty “False” oraz “True”. Definiuje, czy do widoku przypisany jest skrytp z rozszerzeniem .lua. Jeśli wybrany zostanie argument “False”, nawet jeśli do pliku powiązany jest skrypt .lua, skrypt nie będzie realizowany. Jeśli wybrany zostanie argument “True”, funkcje ze skryptu będą realizowane, brak powiązanego pliku .lua będzie wywoływało błąd podczas kompilacji.

PLCS

Lista urządzeń odczytywanych przez serwer. W tym miejscu definiuje się nazwy, kontrolki, przypisane projekty kproj, adresy IP i typy urządzeń.

<plcs>
    <plc id="n1" name="Centrala nawiewna" kproj="przyklad.kproj" ip="10.200.1.100" tag="Centrala"  DefaultDeviceId="1" type="wplc"/>    
    <plc id="wezel" name="Węzeł Cieplny" kproj="wezel.kproj" ip="10.200.1.101" tag="Węzeł"  DefaultDeviceId="1" type="wplc"/>   
</plcs>

ID

ID definiuje przydomek danego sterownika. Jeśli na sterowniku znajdzuje się parametr z nazwą Temperatura a ID sterownika będzie ustawione na n1, odwołanie do tego parametru w MyWayy będzie odbywało się za pomocą kodu n1/Temperatura. Przed wszystkimi parametrami zawsze należy podać id danego sterownika.

Name

Nazwa sterownika. Nazwa jest wykorzystywana przy wyświetlaniu alarmów ze sterowników. W przykładzie poniżej nazwa projektu “klimat”, nazwa Name “akuszarka”.

Kproj

Nazwa powiązanego projektu kproj. MyWayy ściąga z pliku .kproj informacje o typach i adresach modbus parametrów, ściąga też z prezentacji parametrów informacje o sposobie przedstawienia parametrów, ilości miejsc po przecinku, sufiksu albo zakresów. Powiązany projekt .kproj musi się kompilować bez błędów, nazwa nie powinna zawierać polskich znaków i spacji.

IP

Adres IP sterownika. Sterownik z którego odczytywane są parametry powinien znajdować się w tej samej podsieci co serwer.

Tag

Urządzenia podpięta do MyWayy można grupować za pomocą tagów. Tagi używane później są w MyWayy przy grupowaniu wykresów - np. posiadając trzy sterowniki z tagiem “centrala”, po stworzeniu dla każdego z nich wykresu, wykresy będą automatycznie umieszczone w folderze “centrala”.

DefaultDeviceID

Określenie domyślnego device ID sterownika. Domyślana wartość == 1. Wykorzystywane głównie z łączeniem się ze sterownikami za pomocą bramek ethernetowych lub licznikach elektrycznych. W bramkach i licznikach stosuje się często jeden nadrzędny moduł, który zbiera sygnały z podrzędnych urządzeń, automatyk chcąc odczytać dane z konkretnego urządzenia, podaje adres IP bramki lub modułu nadrzędnego oraz adres device ID konkretnego urządzenia podrzędnego.

Type

Urzycie argumenty type=“wplc” daje informacje programowi, że sterownik, z którym MyWayy się komunikuje jest sterownikiem marki Wayy. Sterowniki Wayy przekazują aplikacji więcej informacji, niż te zawarte w kproj, np. aplikacja MyWayy może odczytać ze sterowników w.plc.101 statystyki Modbus RTU ze wszystkimi podłączonymi do sterownika PLC urządzeniami.

Port

Port tcp odczytywanego urządzenia. Domyślnie port ustawiony jest na wartość 502, chcąc ustawić port urządzenia na 123 wystarczy wpisać komendę: port="123".


MyWayy


Spis treści