====== Konfiguračné súbory ../dispatching/etc ======



===== HttpDriver Configuration =====
Driver sluzi na odosielanie dat na dispecing. Pre odosielanie dat musi byt spravne nastavena archivacia udajov v DataProcessore ( pozri nizsie )




=== HttpDriver/cfgCANArchiveAlways.xml ===
Subor definuje ktore udaje sa posielaju na dispecing ( web service ) hodnoty su v subore reprezentovane identifikatorom ( CANValueID ) 

== CANValueID Hodonty ==
<code>
MOTOR_OTACKY = 1
RYCHLOST = 2
PEDAL_PLYN = 3
PALIVO_CELKOVA_SPOTREBA = 4
PALIVO_STAV_NADRZE = 5
PALIVO_PRUMERNA_SPOTREBA = 6
PEDAL_BRZDA = 7
MOTOR_CAS_CELKOM = 8
VZDALENOST_CELKOM = 9
VZDALENOST_DEN = 10
VZDALENOST_SERVIS = 11
MOTOR_TEPLOTA = 12
TACHOGRAF_RYCHLOST = 13
DVERE = 14
PALIVO_OKAMZITA_SPOTREBA = 15
PALIVO_PRUTOK = 16
TEPLOTA_1 = 50
TEPLOTA_2 = 51
USER_01 = 52 (priradene na teplotu 3)
USER_02 = 53
USER_03 = 54
USER_04 = 55
USER_05 = 56
USER_06 = 57
USER_07 = 58 (aktulne sa pouziva na senzor)
USER_08 = 59 (aktulne sa pouziva na senzor)
USER_09 = 60 (aktulne sa pouziva na senzor, priradene na (BUFIK / KLIMA?) )
USER_10 = 61 (aktulne sa pouziva na senzor, priradene na (BUFIK / KLIMA?) )
</code>

pre posielanie TEPLOTY_1 a TEPLOTY_2 vyzera konfiguracny subor nasledovne

<code>
<?xml version="1.0" encoding="utf-8"?>
<CfgCANArchiveAlwaysCol>

    <CfgCANArchiveAlways>
            <CANValueID>50</CANValueID>
    </CfgCANArchiveAlways>

    <CfgCANArchiveAlways>
            <CANValueID>51</CANValueID>
    </CfgCANArchiveAlways>

</CfgCANArchiveAlwaysCol>
</code>








===== DataProcessor Configuration =====
Binarny subor (/opt/emtest/bin/DataProcessor) sluzi na archivaciu dat ziskanych z CAN popripade z inych zariadeni.

hodnoty sa ukladaju na ceste /opt/emtest/var/lib/NAD/CAN/archive/[nazov archivovanej hodnoty]
 
 == Nazvy archivovanych hodnot ==
<code>
dvere
emtest_user01
emtest_user04
emtest_user07
emtest_user10
motorTeplota
palivoPrumernaSpotreba
pedalBrzda
tachografRychlost
vzdalenostServis
emtest_teplota1
emtest_user02
emtest_user05
emtest_user08
motorCasCelkom
palivoCelkovaSpotreba
palivoPrutok
pedalPlyn
vzdalenostCelkom
emtest_teplota2
emtest_user03
emtest_user06
emtest_user09
motorOtacky
palivoOkamzitaSpotreba
palivoStavNadrze
rychlost
vzdalenostDen
</code>

== ID pre dataprocesor rovnake pre oba subory (cfgProcessor.xml a cfgCANArchiveProcessor.xml)  ==
<code>
OBLASTAB = 1
ROZVODNADOSKA = 2
TACHOGRAF = 3
SOUBORPRICHOZI = 4
JAZDASTATIE = 5
GPSSTATE  = 6
ALIVEMARK = 7
CAN_EVT_MOTOR_OTACKY = 101
CAN_EVT_MOTOR_TEPLOTA = 102
CAN_ARCH_MOTOR_OTACKY = 201
CAN_ARCH_RYCHLOST = 202
CAN_ARCH_PEDAL_PLYN = 203
CAN_ARCH_PALIVO_CELKOVA_SPOTREBA = 204
CAN_ARCH_PALIVO_STAV_NADRZE = 205
CAN_ARCH_PALIVO_PRUMERNA_SPOTREBA = 206
CAN_ARCH_PEDAL_BRZDA = 207
CAN_ARCH_MOTOR_CAS_CELKOM = 208
CAN_ARCH_VZDALENOST_CELKOM = 209
CAN_ARCH_VZDALENOST_DEN = 210
CAN_ARCH_VZDALENOST_SERVIS = 211
CAN_ARCH_MOTOR_TEPLOTA = 212
CAN_ARCH_TACHOGRAF_RYCHLOST = 213
CAN_ARCH_ID_CAN_ARCH_DVERE = 214
CAN_ARCH_PALIVO_OKAMZITA_SPOTREBA = 215
CAN_ARCH_PALIVO_PRUTOK = 216
CFG_PROCESSOR_ID_EM_TEPLOTA_1 = 401
CFG_PROCESSOR_ID_EM_TEPLOTA_2 = 402
CFG_PROCESSOR_ID_EM_ARCH_USER_1	= 403
CFG_PROCESSOR_ID_EM_ARCH_USER_2	= 404
CFG_PROCESSOR_ID_EM_ARCH_USER_3	= 405
CFG_PROCESSOR_ID_EM_ARCH_USER_4	= 406
CFG_PROCESSOR_ID_EM_ARCH_USER_5	= 407
CFG_PROCESSOR_ID_EM_ARCH_USER_6 = 408
CFG_PROCESSOR_ID_EM_ARCH_USER_7	= 409
CFG_PROCESSOR_ID_EM_ARCH_USER_8 = 410
CFG_PROCESSOR_ID_EM_ARCH_USER_9	= 411
CFG_PROCESSOR_ID_EM_ARCH_USER_10 = 412
</code>


==== DataProcessor/cfgProcessor.xml ====

Slúži na definovanie dátových processorov.

Napr. nastavenie archivácie pre TEPLOTY:

<code>
<CfgProcessorCol>
        <CfgProcessor>
                <CfgProcessorID>401</CfgProcessorID>
                <Name>Teplota 1</Name>
                <DoPeriod>1</DoPeriod>
                <Channel>3</Channel>
        </CfgProcessor>

        <CfgProcessor>
                <CfgProcessorID>402</CfgProcessorID>
                <Name>Teplota 2</Name>
                <DoPeriod>1</DoPeriod>
                <Channel>3</Channel>
        </CfgProcessor>
</CfgProcessorCol>
</code>

kde:

  * //CfgProcessorID// - ID data-processora. Slúži na prepojenie so spracovávanou veličinou (napr. ID CAN_ARCH_PALIVO_CELKOVA_SPOTREBA = 204 spracováva veličinu zo zbernice CAN PALIVO_CELKOVA_SPOTREBA = 4)
  * //Name// - iba popisný názov pre lepšiu čitateľnosť konfiguračného súboru
  * //DoPeriod// - perióda vykonávania činnosti processora (v sekundách)
  * //Channel// - číslo kanála. Umožňuje vytvorenie dvoch inštancii processora pracujúcich napr. v rôznych periódach






==== DataProcessor/cfgCANArchiveProcessor.xml ====

Nastavenie rozsahu hodnôt pre archiváciu.

<code>
<?xml version="1.0" encoding="utf-8"?>
<CfgCANArchiveProcessorCol>

        <CfgCANArchiveProcessor>
                <CfgCANArchiveProcessorID>401</CfgCANArchiveProcessorID>
                <Name>Teplota 1</Name>

                <Min1>-1000</Min1>
                <Max1>1000</Max1>
                <Step1>1</Step1>
        </CfgCANArchiveProcessor>

        <CfgCANArchiveProcessor>
                <CfgCANArchiveProcessorID>402</CfgCANArchiveProcessorID>
                <Name>Teplota 2</Name>
                <Min1>-1000</Min1>
                <Max1>1000</Max1>
                <Step1>1</Step1>
        </CfgCANArchiveProcessor>

        <CfgCANArchiveProcessor>
                <CfgCANArchiveProcessorID>201</CfgCANArchiveProcessorID>
                <Name>Otacky Motoru</Name>
                <ValueMaxAge>30</ValueMaxAge>

                <Min1>0</Min1>
                <Max1>2000</Max1>
                <Step1>300</Step1>

                <Min2>2000</Min2>
                <Max2>4000</Max2>
                <Step2>500</Step2>

                <Min3>4000</Min3>
                <Max3>50000</Max3>
                <Step3>300</Step3>
    </CfgCANArchiveProcessor>

</CfgCANArchiveProcessorCol>
</code>

kde:

  * //CfgCANArchiveProcessorID// - ID dátového processora
  * //Name// - popisný názov processora, slúži iba na lepšiu čitateľnosť konfiguračného súboru
  * //ValueMaxAge// - maximalna casova platnost archivovanej veliciny v sekundach, po uplynuti tejto platnosti sa zapise velicina do archivu aj ak prisla bez zmeny hodnoty (napr. otacky sa dlhu dobu nemenia, ak je aktivovany tempomat...)
Nasledujúce hodnoty sa môžu opakovať 1-3krát:
  * //Min1-3// - minimálna hodnota pre archiváciu
  * //Max1-3// - maximálna hodnota pre archiváciu
  * //Step1-3// - veľkosť vzorkovaciehoho kroku pre archiváciu

Zisťuje sa, či nameraná hodnota spadá do niektorého z intervalov <Min1, Max1>, <Min2, Max2>, <Min3, Max3> a či sa od poslednej zaznamenanej líši aspoň o "Step1-3". podľa intervalu, do ktorého spadá. Ak áno, hodnota sa archivuje.

====== Konfiguračné súbory ../dispatching ======



===== ModuleGlobal.xml =====

súbor pre nastavenie globálnych parametrov, /opt/emtest/etc/dispatching/ - cesta v PP
<code xml>
<?xml version="1.0" encoding="iso-8859-1"?>
<Dispatching>
	<Head>
		<Info Version="1.00" Date="2007.09.04"/>
	</Head>
// Hlavicka sa nevyhodnocuje
        <Global GPSFormat="Decimal" Altitude="0" Speed="0" SatelliteNumber="0"/>
//GPSFormat       "Decimal" - posielajú sa súradnice v tvare desattinom (47,12345 * 100 000)
                  "GradeMinDec" - (default) posielajú sa súradnice v tvare stupne, minúty, desatiny minút (napr. 48534714, kde 48 sú stupne, 53 minúty, 4714 desatiny minút)
//Altitude        "1" - (default) sledovanie nadmorskej výšky
                  "0" - nesledovanie nadmorskej vysky
//Speed           "1" - (default) sledovanie rýchlosti
                  "0" - nesledovanie rychlosti
//SatteliteNumber "1" - posielanie počtu satelitov
                  "0" - (default) neposielanie poctu satelitov
//Pozn. ak neexistuje ModuleGlobal.xml, tak sa berú default hodnoty, ktoré sú tu poznačné. (Je to pre doterajší stav.)
</Dispatching>        

</code>






===== ModuleSystem.xml =====

súbor pre nastavenie modulov, /opt/emtest/etc/dispatching/ - cesta v PP, závislosť na ModuleGlobal.xml

<code xml>
<?xml version="1.0" encoding="iso-8859-1"?>
<Dispatching>
	<Head>
		<Info Version="1.00" Date="2007.09.04"/>
	</Head>
// Hlavicka sa nevyhodnocuje
	<Module Name="System" Status="1" >
		<System StatusSend="1" StatusSIM="1" DynamicIP="0"/>
</Module>
//Status      "1" – pošlú sa nejaké informácie pre TypID=1 (udalosť 1-1, 1-4, 1-5)
              "0" – (default) nepošlú sa vôbec nejaké informácie pre TypID=1
//StatusSend  "1" – pošle sa informácia o verziách modulov do dispečerského centra (udalosť 1-3)
              "0" – (default) nepošle sa info
//StatusSIM   "1" – posielajú sa údaje o SIM karte (udalosť 1-2)
              "0" – (default) neposielajú sa
//DynamicIP   "X" – SIM karty majú pridelené dynamické IP GPRS, **X** je počet sekúnd, ako casto sa kontroluje zmena IP a ak sa zmení, pošle sa
              "0" – (default) SIM karty majú pridelené statické IP GPRS, preto OBC len raz po zapnutí OBC zistí túto IP a 1x pošle
</Dispatching>  

</code>





===== ModuleLocalization.xml =====
súbor pre nastavenie odosielania polohy vozidla, /opt/emtest/etc/dispatching/ - cesta v PP, závislosť na ModuleGlobal.xml

<code xml>
<?xml version="1.0" encoding="iso-8859-1"?>
<Dispatching>
	<Head>
		<Info Version="1.00" Date="2007.09.04"/>
	</Head>
// Hlavicka sa nevyhodnocuje
	<Module Name="LocatingVehicle" Status="1">
		<Localization		Mode="Dependency"
					Type="DistTime" 
					Meters="100" 
					Seconds="60"
					Speed="3"/>
//Name – meno modulu
//Status  "1" - zakúpený modul
          "0" - (default) nezakúpený modul
//Mode    "Alone" - (default) nezávislé na odosielaní informácií ostatných modulov na server
          "Dependency" - závislé na odosielaní informácií ostatných modulov na server (odoslanie polohy inym modulom prerusi napocitanu vzdialenost a cas)
//Type    "Distance" - typ lokalizácie - zmena vzdialenosti
          "Time" - (default ak je nezadany) typ lokalizácie v časových intervaloch
          "DistTime" - typ lokalizácie - zmena vzdialenosti alebo času (default ak je iny ako Distance alebo Time)
//Meters  "x" - počet metrov pre typy lokalizácie - Distance, DistTime (default 100m)
//Seconds "y" - počet sekúnd pre typy lokalizácie - Time, DistTime (default 120s)
//Speed   "z" - limitná rýchlosť v km/h pri ktorej prekročení (a to aj smerom nahor, aj smerom nadol) sa odosiela poloha na dispečing (default 3km/h)
//ArrivalDepartureDistance - nepouzivane nastavenie
	</Module>
</Dispatching>  
</code>


** To znamena, ze poloha sa odosiela ak: **

  * 'Type' je 'Time' alebo 'DistTime' a uplynul casovy interval na odoslanie 'Seconds'
alebo
  * 'Type' je 'Distance' alebo 'DistTime' a vzdialenost sa zmenila o viac ako 'Meters'
alebo
  * Rychlost presiahla 'Speed' a toto presiahnutie este nebolo odoslane
alebo
  * Rychlost klesla pod 'Speed' a toto poklesnutie este nebolo odoslane


===== ModulePassengers.xml =====
súbor pre posielanie počtu cestujúcich, /opt/emtest/etc/dispatching/ - cesta v PP, závislosť na ModuleGlobal.xml
<code xml>
<?xml version="1.0" encoding="iso-8859-1"?>
<Dispatching>
	<Head>
		<Info Version="1.00" Date="2007.07.09"/>
	</Head>
// Hlavicka sa nevyhodnocuje
	<Module Name="Passengers" Status="1"/>
//Status "1" - modul je zapnuty a posiela sa počet cestujúcich do dispečerského centra
         "0" - (default) modul vypnuty, neposiela sa
</Dispatching> 
</code>


===== ModuleReservation.xml =====
súbor pre posielanie rezervacii spojov, /opt/emtest/etc/dispatching/ - cesta v PP, závislosť na ModuleGlobal.xml
<code xml>
<?xml version="1.0" encoding="iso-8859-1"?>
<Dispatching>
	<Head>
		<Info Version="1.00" Date="2007.07.09"/>
	</Head>
// Hlavicka sa nevyhodnocuje
	<Module Name="Reservation" Status="1"/>
//Status "1" - modul je zapnuty a posielaju sa ziadosti o spoj na zavolanie do dispečerského centra
         "0" - (default) modul vypnuty, neposiela sa
</Dispatching> 
</code>


===== ModuleDelay.xml =====
súbor pre posielanie meskani, /opt/emtest/etc/dispatching/ - cesta v PP, závislosť na ModuleGlobal.xml
<code xml>
<?xml version="1.0" encoding="iso-8859-1"?>
<Dispatching>
	<Head>
		<Info Version="1.00" Date="2007.07.09"/>
	</Head>
// Hlavicka sa nevyhodnocuje
	<Module Name="Delays" Status="1">
//Status "1" - modul je zapnuty a posielaju sa meskania do dispečerského centra
         "0" - (default) modul vypnuty, neposiela sa

              <Delay Mode="Mix"
                     CountTime="2"                 // iba mijola
                     ScanTime="15"                 // iba mijola
                     ChangeDelayTime="15"          // iba mijola
                     LimitDelay="30"               // Meskanie sa musi poslat prinajmensom kazdych 'LimitDelay' sekund. Pouziva aj Vesna.
                     LimitAdvance="180"            // iba mijola
                     DelayIntSoundDriver="60"      // iba mijola
                     AdvanceIntSoundDriver="60"    // iba mijola
                     DriverLimitDelay="180"        // iba mijola
                     DriverLimitAdvance="180"      // iba mijola
                     NumberLineFormat="text">      // iba mijola
              </Delay>
        </Module>
</Dispatching> 
</code>

===== ModuleDistance.xml =====
súbor pre posielanie prejdenej vzdialenosti, /opt/emtest/etc/dispatching/ - cesta v PP, závislosť na ModuleGlobal.xml
<code xml>
<?xml version="1.0" encoding="iso-8859-1"?>
<Dispatching>
	<Head>
		<Info Version="1.00" Date="2007.07.09"/>
	</Head>
// Hlavicka sa nevyhodnocuje
        <Module Name="Distance" Status="1">
                <Distance Seconds="10"/>
	</Module>
//Status  "1" - modul je zapnuty a posielaju sa prejdene vzdialenosti do dispečerského centra
          "0" - (default) modul vypnuty, neposiela sa
//Seconds "X" - pocet sekund kedy sa znovuvyhodnocuje prejdena vzdialenost (default = 120s)
</Dispatching> 
</code>


===== ModuleEvents.xml =====
súbor pre nastavenie modulov, /opt/emtest/etc/dispatching/ - cesta v PP, závislosť na ModuleGlobal.xml
<code xml>
<?xml version="1.0" encoding="iso-8859-1"?>
<Dispatching>
	<Head>
		<Info Version="1.00" Date="2007.09.04"/>
	</Head>
// Hlavicka sa nevyhodnocuje
	<Module Name="Events" Status="1" >
                <Events SendingBusstopArrivalAndDeparture="1"/>
        </Module>
//Status                            "1" - zakúpený modul
                                    "0" - (default) nezakúpený modul – default hodnota, ak neuvedený modul
//SendingBusstopArrivalAndDeparture "1" - (default) posielaju sa udalosti prichod a odchod zo zastavky
                                    "0" - neposielaju sa udalosti prichodu a odchodu zo zastavky (Riga)
</Dispatching>    
</code>


===== ModuleMessages.xml =====
súbor pre nastavenie modulov, /opt/emtest/etc/dispatching/ - cesta v PP, závislosť na ModuleGlobal.xml
<code xml>
<?xml version="1.0" encoding="iso-8859-1"?>
<Dispatching>
  <Head>
    <Info Version="1.00" Date="2017.10.24" />
  </Head>
// Hlavicka sa nevyhodnocuje
  <Module Name="Messages" Status="1" />
//Status                            "1" - zakúpený modul
                                    "0" - (default) nezakúpený modul – default hodnota, ak neuvedený modul
</Dispatching> 
</code>


====== Preddefinované správy ======

Súbor sa nahráva do:
  * Ak Mijola - /opt/emtest/var/lib/hlavny/persistent
  * Ak Vesna - /opt/app-5/var/lib/hlavny/persistent






===== DispMessages.xml =====

súbor s preddejinovanými správami
<code xml>
<Group_DispMessage Note="Group_DispMessage xml">
  <Head Version="1.00" CreateDate="2018.01.23" FirmID="811" PrevadzkaID="1" GroupName="ggggggg" DateFrom="2018.01.23" DateTo="2070.01.01" />
// Hlavicka sa nevyhodnocuje
  <Messages>
    <Message IDMessageList="1" Text="Defekt" />
    <Message IDMessageList="2" Text="Porucha vozidla" />
    <Message IDMessageList="3" Text="Nehoda na ceste" />
    <Message IDMessageList="4" Text="Defekt test" />
  </Messages>
  <ShowActualMessageEnabled>1</ShowActualMessageEnabled>
//ShowActualMessageEnabled     "0" - zobrazí sa ikonka, ale samotná správa nie (ikonka sa zobrazí vždy)  
                               "1" - (default) Vesna: správa sa zobrazí vo výdajových stavoch (všetky, čo dedia od StateTicketIssue (CompactTicketIssue, FragmentFlowTicketIssue, TripVisualisationIssue, stavy dediace od StateTimeTicketActivity( TimeTicketProlongation a TimeTicketSell) ) ) a TripVisualisationAndInfo
                                               Mijola: správa sa zobrazí (Mijola nemá stavovú logiku ako Vesna a preto sa správa zobrazí vždy)
                               "2" - správa sa zobrazí vo všetkých stavoch, okrem stavov do kt. sme prešli cez ChangeStateForResult (podporované iba vo Vesne)
                               
                               Doplňujúce info pre Vesnu: Popup správa sa nezobrazuje v žiadnom stave, do ktorého sme prešli a očakávame od neho výsledok (changeStateForResult). V týchto stavoch je zobrazenie popup správy a následny potenciálny prechod do stavu s historiou sprav nežiadúce. Napr. stav výdaja -> stav čítania karty -> predaj jednorázového lístka na kartu.
                                                          Ak bude nutné zobraziť a následne umožniť prejst do stavu s históriou sprav aj z niektorých stavov, ktoré vracajú výsledok, bude treba pridať konkrétnu výnimku.
                                    
  <ServerMessages>
    <Message IDMessageList="51" Text="1" />
    <Message IDMessageList="52" Text="2" />
    <Message IDMessageList="53" Text="3" />
    <Message IDMessageList="54" Text="4" />
    <Message IDMessageList="55" Text="Volajte policiu" />
  </ServerMessages>
</Group_DispMessage>       

</code>