5.2.6. Element param

Najważniejszą częścią elementu unit są elementy param, opisujące parametry odczytywane ze sterownika. Identyfikatorem parametru jest nazwa, unikalna w obrębie całej konfiguracji. To, jakiemu fizycznemu parametrowi odpowiada dany opis, jest ustalane na podstawie kolejności parametrów w jednostce komunikacyjnej - kolejność opisów musi odzwierciedlać kolejność parametrów ze sterownika. Możliwe atrybuty to:

• name - unikalny identyfikator parametru, powinien mieć postać 3 pól tekstowych oddzielonych dwukropkami, np.: "Kocioł 1:Sterownik:temperatura zadana".

• short_name - wymagany, skrócona nazwa parametru, np. "Tza". Dobrze żeby była unikalna przynajmniej w ramach jednostki komunikacyjnej (choć samo IPK żadnych takich wymagań nie nakłada). Długość skróconej nazwy powinna wynosić od 1 do 4 znaków.

• draw_name - nazwa używana jako nazwa wykresu parametru w programie przeglądającym, np. "Temperatura zadana". Dobrze jeśli nie jest dłuższa niż 20 znaków. Jeśli nie jest podana, użyta będzie nazwa pełna.

• unit - nazwa jednostki w jakiej prezentowany jest parametr, np. "°C". Jeśli nie jest podana, oznacza to brak jednostki, czyli "-".

• base_ind - indeks parametru w bazie. Dla bazy w formacie SZARP 2.1 jest to liczba, równa numerowi linii w pliku PTT.act pomniejszonemu o 2 (a więc indeks pierwszego parametru to 0). Dla nowego formatu bazy SzarpBase może to być napis auto, oznaczający indeks automatyczny (nowa baza nie wymaga indeksów, posługuje się nazwami parametrów). Jeśli atrybut nie występuje, oznacza to że parametr nie jest zapisywany do bazy.

  Uwaga! Wartość atrybutu "auto" nie jest obsługiwana przez stary format konfiguracji. Możliwe jest wygenerowanie konfiguracji w formacie SZARP 2.1, ale nie wolno na podstawie tak wygenerowanej konfiguracji ponownie tworzyć pliku IPK, gdyż może spowodować to utratę informacji i wygenerowanie błędnej konfiguracji. Nie powinno się także mieszać w jednym pliku indeksów automatycznych i tradycyjnych, gdyż wygenerowana z takiego pliku konfiguracja w formacie SZARP 2.1 nie będzie poprawnie obsługiwana np. przez program przeglądający.

• prec - ilość miejsc po przecinku. Parametry liczbowe przechowywane są w bazie (i w pamięci dzielonej) w postaci liczby stałoprzecinkowej - ten atrybut określa ilość miejsc po przecinku w reprezentacji parametru. Jeżeli mamy wartość w bazie 118 i precyzję 0, oznacza to, że rzeczywista wartość jest równa 118, dla precyzji 1 - 11.8, a dla precyzji 3 - 0.118. Dla parametrów o wartościach dyskretnych (np. "Tak" / "Nie") opis odpowiednich wartości zawiera element value

Opis parametru uzupełniają elementy wchodzące w skład elementu param. Są to elementy value, define, raport i draw(występują właśnie w tej kolejności).

Dodatkowo parametr może zawierać element doc z przestrzeni nazw http://www.praterm.com.pl/SZARP/ipk-extra, którego tekstowa zawartość jest używana jako dokumentacja parametru na serwerze parametrów w sytuacji, kiedy nie zadziałają inne sposoby uzyskania dokumentacji (czyli dokumentacja generowana na podstawie dokumentacji programu technologicznego lub na podstawie formuły).