Popis zakladnych konfiguracnych suborov

PrjConfig.xml

Konfiguracny subor ma strukturu:

<?xml version="1.0" encoding="iso-8859-1"?>
<PrjConf>
        <VERSION>1</VERSION>
        <Settings1>123</Settings1>
        <Settings2>456</Settings2>
                  ...
        <SettingsX>789</SettingsX>
        <SettingsY>abc</SettingsY>
</PrjConf>

Posledna znama dokumentacia: smb://mamut/projekty_iso/02_PlatobnySystem-Intel/VseobecneDokumentacie/_XML/_prjconfigHP

Zoznam nastaveni:

Nastavenia IFC do PrjConfigu

  • AcceptExpiredDriverCard - povoli prihlasenie neplatnou kartou vodica
  • AutoShutdownTime
  • AutoShutdownSignalizeTime
  • DelayVersion
0 - stary sposob zobrazovania meskania cez EBlMeskanie, na DP sa nic neposiela
1 - novy sposob vypoctu meskania - posiela sa na DP a podla nastavenia v DelayConfig-u sa zobrazuje bud podla casu nastaveneho v TS alebo podla vypocitaneho v = s/t
  • WinTimeout
  • ZakazatVydajEnter
  • VerifikaciaHKey
0 - pred vydajom listka sa nepyta ci sa ma vytlacit listok - dorobene pre potreby pardubic
1 - pred vytlacenim listka sa spyta ci sa ma listok vytlacit
  • AutoGoIssueVer1 - nastavenie 137 v TS <> od 0, je v SEKUNDACH
0 default - automaticky vojde do vydaja hned ako nastane cas zaciatku spoja
1         - umoznuje pipanie pred vstupom do vydaja
2         - vstupi do vydaja a vo vydaji odpocitava cas do zaciatku
3         - ako 2, len odpocitavanie sa da zrusit klavesou ESC
4         - to iste ako nastavenie c.1, ale c.1 nedovoluje pipanie pred vstupom do vydaja < ako 1 minutu - JSI
  • TimeToGo - aký čas pred začiatkom spoja má aplikácia automaticky vojsť do výdaja
Nastavenie reaguje len ak je v TS nastavenie 137 na 0s. Ak sa v xml-ku TimeToGo nenachadza, default hodnota je 3min

Ak je hodnota > 1000, hodnota je v milisekundach
Ak je hodnota < 1000, hodnota je v minutach
Ak je nastavenie 137 v TS <> od 0, je v SEKUNDACH
  • BeepTimeToGo
Ako dlho pred vstupom do vydaja ma zacat pipat. AK je hodnota nad 1000 tak je udaj v milisekundach (max jedna minuta) , inak v minutach.
  • DataInfo
Uvodna obrazovka s informaciami o cisle a datumu buidlu PP a CIT, verzii a datume nahratych dat
0 - vypnute zobrazovanie uvodnej informacnej obrazovky
1 - zapnute zobrazovanie uvodnej informacnej obrazovky
  • AutoIssue

Dokumentacia k systemu “PopisSpravania.pdf” autovydajovych modulov sa nachadza na mamute na ceste: smb://hades/DokumentaciaTD/VyvojovyUsek/VyvojSW/TransFare/OnboardComputer/

Ak je nastavenie nastavene na hodnotu:

  • 0 ignoruju sa kartove eventy - neposiela sa request na citanie karty(ignoruje sa praca s kartou)
  • 1 vzdy sa posiela request na citanie karty - vytvara sa trieda EAutoVydPrim
  • 2 posiela sa request na citanie karty len na PAD linkach - vytvara sa ECardSharingPMHD

Podnastavenia, ktore blizsie specifikuju ako sa budu vyhodnocovat vycitane data z karty v systeme autovydaja. Definuju sa ako atributy nodu AutoIssue a mozu nadobudat hodnoty 0 alebo 1 (vypnute alebo zapnute):

  • AutoIssue
    • Auditor - default 0 - autovydaj vyhodnocuje ci ide o revizora a specialne spracovava revizorsku kartu( Ak je prilozena karta revizor, zablokuje sa zariadenie )
    • AutoTicketIssue - default 0 - samotny autovydaj - automaticky vydaj cestovnych listkov na kartu( ak mam fokus na spravnom labely pozri 'EnableAutoIssueIDS1OnFocus' a su splnene podmienky, vyda sa listok )
    • AutoInfo - default 0 - zobrazenie vodicovi infa typ karty, typ zlavy
   <AutoIssue Auditor="1" AutoTicketIssue="1" AutoInfo="0">1</AutoIssue>
  • EnableAutoIssueIDS1OnFocus
Moznosti nastavenia autovydaja v primestskej linke na konkretny focus :
 - "Tariff"    - autovydaj ak je focus na tarife 
 - "Count"     - autovydaj ak je focus na pocte
 - "OutputBS"  - autovydaj ak je focus na vystupnej zastavke
 - "InputBS"   - autovydaj ak je focus na nastupnej zastavke
 - "Virtual"   - autovydaj nebude fungovat, pretoze v rezime vydaja sa neda focus nastavit na neexistujuce pole "Virtual"

Priklad:

    <EnableAutoIssueIDS1OnFocus>
        <Focus>Tariff</Focus>
    </EnableAutoIssueIDS1OnFocus>
  • PrinterConnectionType
Moznosti nastavenia autovydaja  na konkretny focus :
 - "0"    - USB
 - "1"     - RS232
  • DisableInstalationMSG
zapnutie, vypnutie msg o instalacii aplikacie
 - "0"    - zapnuta
 - "1"     - vypnuta
 - default zapnuta
  • TimeoutVisibilityCommunicationWithSlave

cas, pre zobrazenie stavu komunikacie medzi PP a slave

- "0" - okno je zobrazene stale
- hodnota v ms kolko bude zobrazene okno
-default 3000ms
  • AutomaticCommunicationReqOnDeductionClose (iba pre palubny pocitac a predpredaj 1703 a novsi)

Urcuje ci sa ma po uzavreti odpoctu palubak spojit so serverom a pokusit sa o vycitanie. Pre urcenie IP adresy servera pozri AutomaticCommunicationReqIPs.

0 - (default) neziada server o vycitanie
1 - ziada server o vycitanie
  • AutomaticCommunicationReqOnTurnon

Urcuje ci sa ma po zapnuti palubakspojit so serverom a pokusit sa o vycitanie. Pre urcenie IP adresy servera pozri AutomaticCommunicationReqIPs.

0 - (default) neziada server o vycitanie
1 - ziada server o vycitanie
  • AutomaticCommunicationReqIPs

Urcuje na ake IP adresy posiela palubak poziadavku o vycitanie. Polozky su vo formate IP/maska (192.168.10.1/24). Ak nie je zadana ziadna IPcka, tak sa pouzije IPcka servera z ktoreho bola v dany den vykonana posledna komunikacia. Ak nebola ziadna komunikacia v dany den, pouzije sa posledna zapamatana IPcka servera s ktorym sa komunikovalo v minulosti. (Ak sa nikdy v minulosti nekomunikovalo, pouzije sa defaultna IPcka nastavena v HwConfig.xml pri zariadeni alarmsender). (v riadku moze byt uvedena iba IP adresa bez poznamky za IP adresou, lebo to nebude fungovat)

<AutomaticCommunicationReqIPs>
	<IP>192.168.114.96/24</IP> <!-- Jilemnice --> 
	<IP>192.168.112.96/24</IP> <!-- Turnov --> 
	<IP>192.168.109.96/24</IP> <!-- Semily AN --> 
	<IP>192.168.122.96/24</IP> <!-- Ceska Lipa --> 
	<IP>192.168.15.66/24</IP> <!-- Jicin --> 
	<IP>192.168.16.65/24</IP> <!-- Horice --> 
</AutomaticCommunicationReqIPs>
  • DefaultIssueWindowFocus

Urcuje ktory prvok ma mat focus v okne vydaja vo vychodzom stave (po vstupe do vydaja, po vydani listka, …). Mozne hodnoty:

Tariff     - tarifa
Count      - pocet listkov
InputBS    - nastupna zastavka
OutputBS   - vystupna zastavka (v MHD sa ignoruje a focus bude na tarife)
DontChange - pri prechode do vychodzieho stavu sa focus nezmeni (ostane na aktualnom prvku), dostupne od eappcore.so.155.1500.1

Priklad pouzitia:

<DefaultIssueWindowFocus>DontChange</DefaultIssueWindowFocus> 
  • TabOption
  • BuseTarget
  • UnlockPeripheralsOnArrival
0 - (defaultna hodnota)zariadenia zostanu zablkovane aj pri prichode na nasledujucu zastavku
1 - umoznuje odomknutie pri prichode na nasledujucu zastavku
2 - umoznuje odomknutie pri prichode na nasledujucu zastavku ak boli zariadenia zamknute od vodica
  • DeductionAutomatic - (default vypnute) po ukonceni posledneho useku prikazu sa po uplynuti DeductionTimeout automaticky bez otazky uzavrie odpocet a odhlasi vodic.
  • DeductionPrint - (default zapnute) urcuje si sa pri uzatvarani odpoctu ma tlacit koncovy listok (zcasti duplicitne s tym, ci je tlaciaren v systeme vobec zapnuta)
  • DeductionTimeout - (default 5s) timeout urcujuci za kolko sekund sa automaticky uzatvori odpocet po skonceni prikazu.
  • LastBusStopIgnoreEsc
  • VERSION
  • UnfinishedOperationTimeout
  • PrintLastBusstopMHD
  • Advertisements
  • GetAutomaticDeductionOpen - (default vypnute) iba pre touch - po prihlaseni sa automaticky otvori odpocet ak nebol otvoreny
  • GetAutomaticDeductionClose - (default vypnute) iba pre touch - ihned po ukonceni prikazu sa automaticky odhlasi vodic a na pozadi uzatvori odpocet
  • DeductionBackupOff
  • EventsDownloadingPeriod
  • HideDeductionQAtEndTrip
  • DisableComunicationMSG - vypne hlasky ohladom komunikacie s centrom (Intel komunikacia)
    • Popis notifikacii je v dokumente: Dokumentacia/Projekty_ISO/02_PlatobnySystem-Intel/VseobecneAnalyzy/01_OnboardComputer/PopisSpravania*.pdf
0 - (defaultne) zobrazuju sa hlasky o komunikacii
1 - nezobrazuju sa hlasky o komunikacii
  • OutputDataTransferIndication - umoznuje zapnut / vypnut zobrazovanie komunikacie o odchadzajucich datach / statistiky.
    • Popis notifikacii je v dokumente: Dokumentacia/Projekty_ISO/02_PlatobnySystem-Intel/VseobecneAnalyzy/01_OnboardComputer/PopisSpravania*.pdf
0 - nezobrazovat
1 - (default) zobrazovat
  • AllowLoginOtherDriver
  • MonthDeductionReopen
  • TimeoutOnEndTrip - timeout na ukoncenie spoja v sekundach, default 120s.
  • AllowInvalidCommand
0 - nepovoleny neplatny prikaz po vystrahe
1 - povoleny neplatny prikaz po vystrahe

Zapnutie logovania na palubnom pocitaci
Zapnutie logovania na citacke

  • Company - nastavenie hovori za vsetko, nastavi sa spolocnost a potom je cely kod poifovany na specialitky
  • CheckDriverLicense - Urcuje ci sa pri prihlasovani skontroluje vo vsuptnych datach (vozidlo vs. vodic) ci vodic ma opravnenie soferovat dany druh vozidla (napr. maly autobus vs. Medzinarodny autobus).
0 - (defaultne) vypnuta kontrola
1 - zapnuta kontrola
  • SoundParserMode - Nastavovanie modu SoundParsera - kvoli roznym verziam winada nieje mozne mat jeden spolocny
0 - SoundParser mode - nieje potrebne mat v konfigu - defaultna hodnota
1 - SoundParserLegacy mode - pre stare verzie winada < 21
2 - SoundParserLegacyLitva - tu sa nachadzaju specialitky pre projekt Litva
  • CheckDriverCardCompany - nastavenia tykajuce sa porovnavania zavodu na strojceku a providera na karte vodica
  mode 0 - su povolene vsetky zavody na karte vodica
  mode 1 - zistuje sa povoleny zavod
  default 1
  • TurnOnAutomaticBrightnessControl - zapne automaticke stmavovanie a zosvetlovanie podla senzoru
0 - staticky jas podla konfiguracie - defaultna hodnota
1 - dynamicky jas podla senzoru
  • BlockCardMode - nastavenia tykajuce sa blokovania kariet
  mode 0 - neblokuju sa (idol)
  mode 1 - blokuju sa (maribor)
  default 0
  • MaxInterchangeCount

Maximalny pocet prestupov, ktory bude poslany na ethernetove tabule. Default hodnota je 6.

  • InterchangeInterval

Upravuje posielanie prestupov na ethernetove tabule. Prestupy, ktore zacinaju po uplynuti nastavenej doby od casu prichodu na prestupnu zastavku, nebudu poslane tabuliam. Hodnota je v minutach. Defaultna hodnota je 1440 (jeden den).

  • WebServiceURL

URL adresa webservisu na ziskavanie meskani spojov (ethTable).

  • HotkeyIssueRestrictionMode

Nastavenie obmedzenia vydaja listkov cez hotkeye v primeste. Nastavenie je dostupne v libeappcore.so od verzie 159.0.0 a 155.1500.3.

Mozne hodnoty su:

0 - vydaj listka cez hotkey je povoleny iba v pripade, ze je focus na vystupnej zastavke (default)
1 - vydaj listka je povoleny aj v pripade ze focus nie je na vystupnej zastavke

(ostatne hodnoty su povazovane za 0)
  • Layout - nastavenia tykajuce sa zobrazovanej vrstvy
<Layout>
    <DateTime>  -nastavenie zobrazovaneho datetime formatu 
        <Format text="datum: %1" format="dd.MM.yyyy" time="5"/> - vola 
        <Format text="week: %2" time="4"/> - vola funkciu 2
        <Format text="day: %1 week: %2" format="dd" time="4"/> - vola funkciu 2
    </DateTime>
    <StatusBar>
	    <Format pattern="%01 %02 %03 %04 %05 %06 %07" />
    </StatusBar>
</Layout>

DateTime - nastavenie zobrazovaneho datetime formatu 
Format -   nastavenie formatu
text   -   zobrazovany text
format -   v danom formate
time   -   dany cas

Status bar:
pattern : urcuje informacie ktore bude status bar zobrazovat , zapisuje sa ako postupnost znaciek %xx, kde jednotlive znacky maju vyznam:
%01 - zobrazi linku
%02 - zobrazi spoj
%03 - zobrazi protect number
%04 - zobrazi kratke meno zastavky
%05 - zobrazi cas konecnej zastavky
%06 - zobrazi cislo commandu
%07 - zobrazi linku ale cislo text (napr N81 alebo R3)

argumenty mozno akokolvek kombinovat (nezalezi na poradi) a do retazca pridavat vlastne znaky napr:
pattern="%01 / %02 aktualny cas : %05 " 

  • ProjectCountry - uz sa nepouziva, nahradene metodou EGlobData::GetNastavenia()→GetSetFirma()→GetStatID()
  • HomeCityNumber - definuje cislo domacej MHDcky, pre pripady kedy sa pre ine MHDcky ktore su akceptovane nemaju zobrazovat nazvy tarif z dat, ale typ (podtyp) karty
  • ShowZonesBetweenBS - 15.12.2011 - zrusene z prjconfigu, pouziva sa EData/IDSLogic - action : showZonesBetweenBS
  • PrintListsOnAuditor - nastavenie ci sa ma tlacit zoznam listko a zastaviek na kartu revizora
 mode 0 - netlaci zoznam listkov
 mode 1 - tlaci zoznam zastaviek a vydanych listkov po prilozeni karty revizora
  • TimeToPlayNextStopAfterArrival - cas po ktorom sa ma prehrat udalost statie na zastavke po prichode na zastavku (v ms)
  • ShowMessageOnPortableWallet - nastavenie ktore urcuje ci sa ma zobrazit hlaska( “vydat listok na prenosnu penazenku ?” ) pri vydaji na prenosnu penazenku. Prenosna penazenka je ak je mozne vydat listok pre majitela karty s navolenou tarifou( typ zlavy ) inou ako typ zlavy na karte.
 mode 1 - zobrazovat potvrdzovaciu hlasku pri vydaji na prenosnu penazenku
 mode 0 - nezobrazovat potvrzdovaciu hlasku a vydat listok na prenosnu penazenku automaticky
  • ReceiveBeepMessage - v spravach dispecerskeho ci pipat po prijati txt. spravy
 mode 0 - nepipam
 mode 1 - povolim pipanie
  • RepeatBeepMessage - v spravach ked je zapnute pipanie, zadava kolko krat pipat
  • Barcode - sluzi na nastavenie typu a obsahu ciarovych alebo QR kodov. Ma nasledovne atributy:

type - urcuje typ ciaroveho kodu. Mozne hodnoty su:

 i2of5 - Interleaved 2 of 5 - Pozor musi obsahovat parny pocet cislic!
 Qr - QR kod

context - urcuje umiestnenie ciaroveho kodu:

  finalTicket - ciarovy kod na koncovom listku
  coinerClosureTicket - ciarovy kod na uzavierke mincovnika

pattern - definuje informacie, ktore ma ciarovy kod obsahovat. Zapisuje sa ako postupnost znaciek %xx, kde jednotlive znacky maju vyznam:

  %01 - posledne 4 znaky cisla pokladne (strojceka)
  %02 - posledych 5 znakov cisla pokladne (strojceka) 
  %03 - posledne 4 znaky cisla odpoctu
  %04 - posledne 4 znaky cisla vodica
  %05 - poslednych 5 znakov cisla vodica
  %06 - 5 znakov trzba bez desatinnej casti (z odvodu v mene statu sa vezme suma_cena)
  %07 - 3 znaky, logicke cislo trezoru ( nie dalas, napr 097 )
  %08 - 6 znakov, pricom prve styri su trzba (v jednotkach meny (cele eura)) a posledne dva znaky su centy
  %09 - posledych 6 znakov cisla pokladne (strojceka) s prefixom 'z'
  %10 - poslednych 6 znakov cisla vodica s prefixom 'r'
  %11 - poslednych 5 znakov cisla odpoctu s prefixom 'o'
  %12 - 8 znakov, pricom prvych sest su trzba (v jednotkach meny (cele eura)) a posledne dva znaky su centy bez prefixu
  %13 - zaciatok odpoctu - 14 znakov vo formate yyyyMMddhhmmss s prefixom 'S'
  %14 - koniec odpoctu - 14 znakov vo formate yyyyMMddhhmmss s prefixom 'U'

Ak napriklad chceme, aby ciarovy kod na koncovom listku obsahoval poslednych 5 znakov z cisla pokladne, za tym posledne 4 znaky cisla odpoctu, a za tym poslednych 5 znakov cisla vodica, tak napiseme:

	<Barcode type="i2of5" context="finalTicket" pattern="%02%03%05"/>

Ak chceme do ciaroveho kodu na tvrdo vlozit nejaku cislicu, jednoducho ju napiseme na prislusne miesto medzi znacky. Napriklad ak chceme na prvom mieste vzdy mat jednotku, napiseme:

	<Barcode type="i2of5" context="finalTicket" pattern="1%06%01%03"/>

Ak chceme pattern rozdelit na viac riadkov, vlozime do textu znacku “nl” a pridame novy riadok aj do sablony listka (bar_code1 - vid popis Ticket.xml). Napriklad ak chceme mat na novom riadku trzbu (ala albacon) tak dame:

    <Barcode type="i2of5" context="coinerClosureTicket" pattern="666%07%01%03nl0%0600"/>
    <Barcode type="i2of5" context="finalTicket" pattern="00%04%01%03nl0%0600"/>

Tlac QR kodu na koncovom listku:

    <Barcode type="Qr" context="finalTicket" pattern="%09%10%11%12%13%14"/>

Poznamky:

- vo vstupnych datach musi byt povolena tlac detailov na konecnom listku, t.j. v Tarifnom systeme na zalozke “F” musi byt zaskrtnute nastavenie id 104 - Detaily na konecnom listku

- pre kazdy ciarovy kod, ktory chceme tlacit (na pociatocnom listku, konecnom listku atd.), musi byt v PrjConfig.xml osobitny node <Barcode/> s prislusnou hodnotou atributu context

- ak sa v configu nenachadza node <Barcode> pre urcity kontext, dany ciarovy kod sa nevytlaci

- je potrebne definovat vsetky atributy, inak sa cely node ignoruje (do logov sa vypise warning)

  • FellowTravelersOnlyOnFirstReader - urcuje ci je mozne dokupovat listky pre spolucestujucich len na prvej citacke.
0 - vypnute (listky sa daju dokupovat na hociktorej citacke)
1 - zapnute (listky sa daju dokupovat iba na prvej citacke)
  • RequiredSAMUnlock - zapina vyzadovanie odomykacieho SAM modulu.
  • FocusOnTariffBusStopChange - toto nastavenie hovori o posuvani zastavok a tarif v SMHD
 mode 0 - focus je mozne dat na zastavku aj tarifu, a pri stlaceni sipok sa posuva bud zastavka, alebo tarifa, podla focusu
 mode 1 - focus je mozne dat na tarifu a nemozme ho dat na zastavku. Ked som na tarife a stlacim sipku posuva zastavku. 
          Tarifu posuvam bud stlacenim numerickych klaves, alebo cez hotkey TariffSelector
  • ArrowSense - urcuje co znamena sipka hore/dole, resp. smer prepinania zastavok a tarif v rezime vydaja ( default = 1 )
0 - Normal ( sipka hore je hore a sipka dole je dole )
1 - Reverse ( sipka hore je dole a sipka dole je hore )
  • SoundParserMode - urcuje implementaciu SoundParseru
3 - VoIP ( sound parser VoIP )
ostatne su zatial ( default SoundParser-HlasicParser )
  • WakeUp - urcuje pri akej udalosti sa ma vypnut screensaver. Ma nasledovne atributy:

OnBusStopArrival - zrusenie setrica ked pride autobus na dalsiu zastavku.

0 - setric obrazovky sa nezrusi
1 - setric obrazovky sa zrusi

OnNewMessage - zrusenie setrica ked aplikacia prijme spravu z dispecerskeho centra.

0 - setric obrazovky sa nezrusi
1 - setric obrazovky sa zrusi

Priklad:

<WakeUp OnBusStopArrival="1" OnNewMessage="1" />
  • ForceEnteringDailyIdentificationRecord

Nastavenie definuje chovanie zadavania stazky (DZVV) a vztah medzi odpoctom a stazkou.

0 - vypnute vynutenie zadavania DZVV pri kazdom otvarani odpoctu alebo pri prihlaseni vodica.
    Aj ked sa DZVV (stazka) zadava pri otvoreni odpoctu, tak nie pri kazdom, ale iba ak bola uzatvorena pomocou menu (CMDCloseDailyIdentificationVehicleRecord).
    Aplikacia interne do kazdeho medzicasom otvoreneho odpoctu doda odpamatane cislo DZVV.

1 - zapnute vynutenie zadavania DZVV, vzdy pri otvarani odpoctu sa zobrazi moznost zadat DZVV pre vodica.
    Toto DZVV sa uklada do statistiky a na kazdom odpocte moze byt zadane ine.

2 - zapnute vynutenie zadavania DZVV pri kazdom prihlaseni vodica. Tento rezim dovoluje mat viac staziek na jednom odpocte.
    Kedze sa ale tento udaj nedokaze zapisat do statistiky (tam sa da ulozit iba jedna a teda prva), posiela sa po zadani iba na portal dispecingu.
  • UseIssueWindowBusstopList - hovori ci sa ma pouzit specialny form vydaja. Iba pre TOUCH, kde nie su labely pre tarifu a cenu a je menej hotkeyov.
0 - (default) pouziva sa standarny form
1 - pouzit spominany specialny form

Priklad:

<UseIssueWindowBusstopList>1</UseIssueWindowBusstopList>
  • VerifyIssueCash - potvrdenie vydavaneho listka u vodica v hotovosti (na “enter”)
0 - (default) vypnute 
1 - zapnute

Priklad:

<VerifyIssueCash>1</VerifyIssueCash>
  • DontReadPurseLogs - vynutenie necitania logov penazenky (iba pre karty mifare standard).
0 - (default) - vypnute. Logy sa citaju a zapisuju do statistiky
1 - zapnute necitanie logov penazenky a vypnute zapisovanie do statistiky
  • ShowMessageOnArrival - automaticke zobrazenie okna zo spravami pri prichode spravy.
0 - (default) - vypnute. na info liste za meni iab ikona o prijati spravy
1 - zapnute - pri prichode sa zobrazi okno zo spravami
  • LogKeyboard - zapnutie logovania klaves do suboru /opt/emtest/var/log/keys.log
0 - (default) - vypnute.
1 - zapnute.
  • IssueMessageTimeout - Cas v [s] zobrazenia informacie o vydanom listku
hodnota == pocet sekund zobrazenia notifikacneho okna
default hodnota = 2 sekundy
  • PassangerOutHighlightColor - Farba pozadia okienka pre zobrazenie Vystupujucich cestujucich ( zvyraznuje sa iba ak niekto vystupuje )
nezadane - ( default ) - vypnute
#xxxxxx - farba pozadia v hex formate napr #ff0000 pre cervenu farbu ( format zadavania ako v html )
  • DelayWebServiceUrl - Nastavenie url na websluzbu pre stahovanie meskana spojov, default nastavene na ””
<DelayWebServiceUrl>http://192.168.99.12:5544/AVL_Delay/AVLDelay.asmx</DelayWebServiceUrl> 
  • SlaveBrightnessOnScreenSaver - Nastavenie sluzi na zmenu jasu na citackach v pripade ze sa na palubnom pocitaci zapne screen saver ( index -1 znamena ze sa jas zmeni na vsetkych citackach ), v pripade ze sa ma zmenit jas iba na jednej citacke popripade viac ale nie vsetky je mozne vypisat indexy citaciek ( podla HWconfigu ) → index=“0,1” zmena jasu na prvej a druhej citacke. Hodnota jasu, ktore sa posle na citacku v momente ked palubak prejde do setrica obrazovky
<SlaveBrightnessOnScreenSaver index="-1">20</SlaveBrightnessOnScreenSaver>
  • RepeatPrintFinalTicketMessageTimeout - Nastavenie casu v [sec] na zrusenie otazky o opakovanej tlaci listka. Po zruseni sa vyvola copy_to_flash
<RepeatPrintFinalTicketMessageTimeout>10</RepeatPrintFinalTicketMessageTimeout>
  • MaxGpsOutageTime - maximálna časova hodnota výpadku GPS ak vypadok presiahne tuto hodnotu tak sa vzdy pusti synchronizacia ( v sekundach, a len pre vesna zariadenie )
<MaxGpsOutageTime>300</MaxGpsOutageTime>
  • MinGpsOutageTime - minimalna časova hodnota výpadku GPS synchronizacia sa spusti iba ak vypadok prekroci tuto hodnotu ( v sekundach, a len pre vesna zariadenie )
<MinGpsOutageTime>5</MinGpsOutageTime>
  • MinGpsOutageDistance - minimalna vzdialenost na zapnutie synchronizacie v pripade ak je splnena minimalna casova podmienka ( v metroch a len pre vesna zariadenie )
<MinGpsOutageDistance>100</MinGpsOutageDistance>
  • MaxToastMessageCount - len pre Vesna

Maximalny pocet toast sprav (ciastocne priehladne info spravy v dolnej casti obrazovky), ktore sa mozu naraz nad sebou zobrazit. Default hodnota je 3. Ak sa tento pocet presiahne, najstarsia sprava sa zahodi.

  • DetectInvalidCardWriteOperation - Docasne nastavenie pre release 1703 pomocou ktoreho je mozne zapnut detekciu nespravnych zapisov na kartu. Pozor zapnuty priznak sposobuje spomalenie vydaja na cipovu kartu maximalne do 500ms.
0 - (default) - vypnute.
1 - zapnute.
  • RunSAMUpdateCheckOnIssueOut - príznak 0/1, či sa má pri odchode z výdaja volať SAMUpdateCheck - metóda, ktorá zakomunikuje so serverom a zisi, či pre vložený SAM existuje update. Má to význam minimálne v tom, že sa tým odosielajú na server informácie o SAMoch a ich verziách. Default hodnota je 1 = volať SAMUpdateCheck.
  • SamUpdateAutomation - príznak 0/1, či sa má pri vypnuti zariadenia volať SamUpdateProces - metóda, ktorá vykona update nad vlozenymi SAM modulmi, ak takyto existuje. Default hodnota je 0 = nevykonavat SamUpdate.
    • SamUpdateAutomationInterval - atribut SamUpdateAutomation, ktory hovori o tom, ako casto sa ma volat SAM update pri vypinani, default = 7 (kazdych 7 dni)
  • PrintInterchangeTicket - príznak, či sa má tlačiť lístok pri prestupe, default 1 (má sa tlačiť)
  • SLToArrivaCardCompanyChange - povolenie extraoperacie na preklopenie kariet Slovak Lines na karty Arriva Mobility Solutions (default je extraoperaciu nevykonavat = 0, nastavenim na 1 extraoperaciu povolime)

ProjectConfig.xml (konfiguracny subor pre Vesnu)

Tento subor je novy, ma nahradit povodny PrjConfig.xml pouzivany v Mijole. Zatial su v nom ulozene cesty k mapovym podkladom a nastavenia pre screensaver a tlac kopii konecneho listka. Subor je sucastou balicka.

  • ForceEnteringDailyIdentificationRecord - Pozri Popis v PrjConfig

od release 1806 nastavenie nie je podporovane, logika zadavania DZVV je podla specifikacie na g-drive

  • StartTicketCounter - Nastavenie ci cislovat alebo necislovat pociatocny alebo koncovy listok
0 - default - necislovat odpocty
1 - cislovat odpocty
  • Advertisements - Priznak ci sa maju alebo nemaju tlacit reklamy na listkoch
  • DeductionPrint - Priznak ci sa ma tlacit koncovy listok (napriklad DPMK)
  • ScreenSaverTimeout - Určuje, po koľkých sekundách sa má aktivovať screensaver, ak je povolený
  • DontReadPurseLogs - Pozri Popis v PrjConfig
  • AcceptExpiredDriverCard - Pozri Popis v PrjConfig
  • TimeoutOnEndTrip - Pozri Popis v PrjConfig
  • TimeToGo - Pozri Popis v PrjConfig
  • AutomaticCardHandling - Premenovane nastavenie “AutoIssue” v PrjConfig
    • Auditor
    • AutoTicketIssue
    • AutoInfo
  • MapDatabaseDirectory - Databaza binarnych suborov pre mapove podklady “openStreetMap”
  • MapIconsDirectory - Ikony zobrazujuce sa na mape
  • MapStyleSheetFilePath - Konfiguracne subory stylovania mapovych podkladov
  • DelayWebServiceUrl - Pozri Popis v PrjConfig; v release nasledujucom po release 2406 bude tato sluzba nahradena sluzbou TripsDelaysWebServiceURL
  • PrintListsOnAuditor - Nastavenie ci sa ma tlacit zoznam listkov a zastavok po prilozeni karty revizora
0 - ziadny zoznam sa netlaci
1 - tlaci sa zoznam zastavok a zoznam vydanych listkov s informaciou o tarifnych zonach
  • UnlockPeripheralsOnArrival - Nastavenie odblokovania zariadeni pri prichode na nasledujucu zastavku
0 - (defaultna hodnota) zariadenia zostanu zablokovane aj pri prichode na nasledujucu zastavku
1 - pri prichode na nasledujucu zastavku sa zariadenia odomknu
2 - pri prichode na nasledujucu zastavku sa zariadenia odomknu len ak boli zamknute od vodica
  • AutomaticCommunicationReqOnDeductionClose - Pozri Popis v PrjConfig
  • AutomaticCommunicationReqOnTurnon - Pozri Popis v PrjConfig
  • AutomaticCommunicationReqIPs - Pozri Popis v PrjConfig
  • DefaultIssueWindowFocus - Pozri Popis v PrjConfig
    • Default hodnota 'DontChange'
  • DeductionAutomatic - (default vypnute) po ukonceni posledneho useku prikazu sa zobrazi odpocitavanie do automatickeho uzavretia odpoctu, odpocitava sa pocet sekund definovany v DeductionTimeout. Po ukonceni odpocitavania sa uzavrie odpocet a odhlasi vodic.
  • DeductionTimeout - Pozri Popis v PrjConfig
  • VideoRecordingSvc - konfiguracia chovania nahravania kamery.
    • segmenttime - definuje dlzku konkretneho zaznamu (po akych castiach sa uklada video do suboru) v sekundach (defaultne 600, teda 10 minut).
    • maxdays - definuje pocet dni maximalneho ukladania zaznamu v dnoch (z dovodu legislativy).
    • storagedev - definuje absolutnu cestu k zariadeniu (disk) a particii, kam sa bude kamerovy zaznam ukladat (z dovodu pripojenia adresarovej struktury). (napr. /dev/sda1)
    • recroot - definuje bod pripojenia (mountpoint pre prikaz mount) / absolutnu cestu k adresaru v operacnom systeme, kam sa pripoji storagedev . (napr. /mnt/camera)
  • Camera - root element obalujuci vsetky konfiguracie kamier
    • Configuration - v hw configu je definovane ID konfiguracie, kazda konfiguracia obsahuje viac konfiguracii kamier - nodov CameraURL (atribut ID obsahuje ID konfiguracie)
      V HwConfig.xml (zariadenie VideoStream) je definovane ConfigID=“X”, podla ConfigID sa pouzije konkretna sekcia Configuration s ID=“X” z ProjectConfig-u (ak nie je ConfigID zadane, pouzije sa default - 0).
      HwConfig.xml obsahuje len jedno povolene zariadenie VideoStream a uz viac neobsahuje atributy IP a Type.
      • CameraURL - konfiguracia zobrazenia kameroveho streamu na obrazovku aplikacie. bude odstranena po zapracovani ONVIF standardu
        • StreamPosition - definuje poziciu zobrazovanej kamery (0 = vlavo hore, 2 = vpravo hore, 3 = vpravo dole). bude odstranene
        • Audio - definuje ci SingleStreamModeAndRecCamURL stream obsahuje aj audio stopu, t.j. ci sa jedna o kameru s mikrofonom (0 - stream bez audia, 1 - stream s audiom)
        • SingleStreamModeAndRecCamURL - povodne SingleStreamModeURL (tento stary tvar uz nepouzivat), definuje rtsp stream pri zobrazeni kamery na celu obrazovku a pre zaznam videa. bude odstranene
        • MultiStreamModeURL - definuje rtsp stream pri zobrazeni viacerych kamier na obrazovku. bude odstranene
        • HwConfigRowID - RowID z hw configu pre sparovanie s konkretnym riadkom z Project configu. Ak HwConfigRowID nie je definovane, z hw configu sa zoberie len pocet povolenych kamier, tento pocet nodov CameraURL sa potom pouzije pri zobrazovani videa.

Vzor sekcie pre kamery:

<Camera>
   <Configuration ID="0">
     <CameraURL StreamPosition="0" SingleStreamModeAndRecCamURL="rtsp://192.168.12.200:554/Streaming/Channels/101" MultiStreamModeURL="rtsp://192.168.12.200:554/Streaming/Channels/102" Audio="1" ></CameraURL>
     <CameraURL StreamPosition="1" SingleStreamModeAndRecCamURL="rtsp://192.168.12.201:554/Streaming/Channels/101" MultiStreamModeURL="rtsp://192.168.12.201:554/Streaming/Channels/102" Audio="0" ></CameraURL>
     <CameraURL StreamPosition="2" SingleStreamModeAndRecCamURL="rtsp://192.168.12.202:554/Streaming/Channels/101" MultiStreamModeURL="rtsp://192.168.12.202:554/Streaming/Channels/102" Audio="0" ></CameraURL>
     <CameraURL StreamPosition="3" SingleStreamModeAndRecCamURL="rtsp://192.168.12.203:554/Streaming/Channels/101" MultiStreamModeURL="rtsp://192.168.12.203:554/Streaming/Channels/102" Audio="0" ></CameraURL>
  </Configuration>
  <Configuration ID="1">
     <CameraURL StreamPosition="0" SingleStreamModeAndRecCamURL="rtsp://192.168.12.200:554/1" MultiStreamModeURL="rtsp://192.168.12.200:554/2" Audio="0" ></CameraURL>
     <CameraURL StreamPosition="1" SingleStreamModeAndRecCamURL="rtsp://192.168.12.201:554/1" MultiStreamModeURL="rtsp://192.168.12.201:554/2" Audio="0" ></CameraURL>
     <CameraURL StreamPosition="2" SingleStreamModeAndRecCamURL="rtsp://192.168.12.202:554/1" MultiStreamModeURL="rtsp://192.168.12.202:554/2" Audio="0" ></CameraURL>
     <CameraURL StreamPosition="3" SingleStreamModeAndRecCamURL="rtsp://192.168.12.203:554/1" MultiStreamModeURL="rtsp://192.168.12.203:554/2" Audio="1" ></CameraURL>
  </Configuration>
</Camera>
  • DigitalInputPins - root element obalujuci vsetky konfiguracie vstupnych digitalnych pinov
    • Configuration - konfiguracia obsahuje priradenia konkretnych akcii ku konkretnym pinom (atribut ID obsahuje ID konfiguracie)
      V HwConfig.xml (zariadenie ConnBoard) je definovane ConfigID=“X”, podla ConfigID sa pouzije konkretna sekcia Configuration s ID=“X” z ProjectConfig-u (ak nie je ConfigID zadane, pouzije sa default - 0).
      • Pin - element, kt. definuje jeden vstupny pin
        Atributy elementu Pin:
        • Number - atribut definuje cislo pinu, cislovane od 0 (na rozvodnej doske su piny cislovane od 1, preto fyzicky pin 1 na rozvodnej doske je Number=“0”)
        • Trigger - atribut definuje pri akej zmene logickej urovne pinu sa vyvola priradena akcia (Low/High/Both)
        • Action - atribut definujuci konkretnu akciu, kt. sa vyvola po zmene pinu na logicku uroven definovanou atributom Trigger
          Akcie (podporovane hodnoty atributu Action), kt. je mozne priradit pinu:
          • PanicButtonPushed - stlacenie nudzoveho tlacidla
          • DoorStateChanged - zmena stavu dveri (otvorene/zatvorene), dverny kontakt
          • PlayLineInfoSoundForVisuallyImpairedPerson - prehratie informacie o aktualnej linke pre zrakovo postihnutu osobu
          • PlayVisuallyImpairedPersonEntranceSound - prehratie informacie o nastupe zrakovo postihnutej osoby do vozidla
          • RequestToStopVehicleButtonPushed - STOP tlacidlo - ziadost o zastavenie vozidla od cestujuceho
          • IndependentHeating - Nezavisle kurenie - akcia vykonana v pripade zmeny stavu bufika
          • Conditioning - Klimatizacia - akcia vykonana v pripade zmeny stavu klimatizacie
          • DoorButtonPushed - odoslanie udalosti stlacenia tlacidla Dvere na ethernetovu tabulu
          • DisabledPersonButtonPushed - odoslanie udalosti stlacenia tlacidla invalidna osoba na ethernetovu tabulu
          • ReversingCamera - odoslanie zmeny udalosti zaradenia spiatocky na vozidle, na základe zmeny zapnúť/vypnúť stream z vybranej kamery definovanej v atribute “AdditionalData”
        • Logic - nepovinny atribut (defaultne sa pouzije neinvertujuca logika) umoznuje metode, kt. spracuva konkretnu akciu poslat invertovanu logicku uroven (pouzite napr. pri dvernom kontakte, reagujeme na obe urovne, ale pri zmene na '1' posielame '0' a naopak)
        • AdditionalData - nepovinny atribut definuje dodatocne data pre dane cislo pinu

Vzor sekcie pre digitalne vstupne piny:

<DigitalInputPins>
  <Configuration ID="0">
    <Pin Number="0" Trigger="Low" Action="PlayLineInfoSoundForVisuallyImpairedPerson" />
    <Pin Number="1" Trigger="Low" Action="PlayVisuallyImpairedPersonEntranceSound" />
    <Pin Number="2" Trigger="Both" Action="DoorStateChanged" Logic="Inverted" />
    <Pin Number="3" Trigger="High" Action="PanicButtonPushed" />
    <Pin Number="4" Trigger="Both" Action="ReversingCamera" AdditionalData="rtsp://192.168.12.200:554/Streaming/Channels/101"/>
    </Configuration>
  </DigitalInputPins>
  • SynchronizeSystemTime - umoznuje vypnut sychronizaciu systemoveho casu s GPS (zavedene kvoli chybnemu posielaniu casu z GPS simulatora), 0 - Synchronizacia casu je vypnuta, 1 - (defaultna hodnota) Synchronizacia casu je zapnuta
    • NtpIpAddress - atribut - IP adresa NTP servera
    • MinTimeDiffSecondsToTimeSync - atribut - minimalna casova odchylka v sekundach (GPS↔systemovy cas), kedy sa vykona synchronizacia casu, default 3 sekundy - ak je rozdiel 3 a viac sekund, vykona sa synchronizacia
  <SynchronizeSystemTime NtpIpAddress="192.168.99.1" MinTimeDiffSecondsToTimeSync="1">1</SynchronizeSystemTime>
  • Voip - konfiguracia Voip funkcionality, podporuje atributy:
    • Registrar - ip adresa asterisk servera, kam ma byt odosielany register account request
    • Realm - voip realm (*)
    • StandardCallURI - kontakt na dispecing (v tvare sip:user@registrar), ktory je volany v pripade standardneho hovoru
    • EmergencyCallURI - kontakt na dispecing (v tvare sip:user@registrar), ktory je volany v pripade nudzoveho hovoru
    • CaptureDeviceTxLevel - uprava urovne hlasitosti mikrofonu pocas hovoru
    • PlaybackDeviceRxLevel - uprava urovne hlasitosti reproduktorov pocas hovoru
hodnota hlasitosti < 1.0 znizenie hlasitosti
hodnota hlasitosti = 1.0 defaultna hlasitost
hodnota hlasitosti = 0.0 uplne stlmenie zvuku
hodnota hlasitosti > 1.0 zvysenie hlasitosti
  • OBCAPIModelRouteURL - URL služby pre poskytovanie vzorových trás (nepoužíva sa)
  • OBCAPIModelRouteGZippedURL - URL služby pre poskytovanie GZipped vzorových trás (používa sa)
Testovacia sluzba:
<OBCAPIModelRouteGZippedURL>http://192.168.241.9/ObcAPI/api/v1/GetModelRouteStopsGzipped</OBCAPIModelRouteGZippedURL>
  • DeleteStatisticOnStartup - vymazavanie statistiky pri nabehu aplikacie
0 - (defaultna hodnota) statistika sa nevymazava
1 - pri starte aplikacie sa vymazu vsetky existujuce statisticke subory (aj tempstatistika)
  • UseTripVisualisationIssue - pouzitie mapoveho vydaja (TripVisualisationIssue) - okresanej verzie vydaja, ktory iba zobrazuje mapu a prepina zastavky. Nevydava ziadne listky (ani hotovost ani karty).
0 - (defaultna hodnota) pouzi klasicky vydaj
1 - pouzi mapovy vydaj
  • ShutdownTimeAfterEngineTurnOff - cas, po ktorom sa ma palubak vypnut, pokial je motor vypnuty
0 - (defaultna hodnota) vypinanie palubaku na zaklade motora je zakazane
1-n - cas v sekundach, po ktorom sa palubak vypne, ak je motor vypnuty
  • AutomaticPassengerCountingResultMeaning - aka hodnota sa zobrazi v okne mapoveho vydaja na mieste poctu cestujucich
0 - (defaultna hodnota) pocet cestujucich
1 - percento naplnenia vozidla
  • WakeUp - urcuje pri akej udalosti sa ma vypnut screensaver. Ma nasledovne atributy:
    • OnBusStopArrival - zrusenie setrica ked pride autobus na dalsiu zastavku.
      0 - setric obrazovky sa nezrusi
      1 - setric obrazovky sa zrusi
      
    • OnNewMessage - zrusenie setrica ked aplikacia prijme spravu z dispecerskeho centra.
      0 - setric obrazovky sa nezrusi
      1 - setric obrazovky sa zrusi
      

Priklad:

<WakeUp OnBusStopArrival="1" OnNewMessage="1" />
  • AutomaticLoginService - specifikuje sluzbu pre automaticke prihlasovanie vodica
    • URL - adresa websluzby, na ktoru palubak posiela JSON requesty pre prihlasenie vodica
    • WebSocketPort - WebSocket port, na ktorom palubak pocuva a prijima WebSocket spravy. Ak nie je zadany, pouzije sa port 22331.
  • MaxToastMessageCount - pocet toast sprav, ktore mozu byt sucasne zobrazene. V pripade vytvorenia dalsej spravy sa najstarsia sprava skryje. Defaultna hodnota je 3.
  • HideOldCommandSegmentsLimit - casovy limit v minutach. Useky prikazu, ktore maju cas konca starsi nez tento limit sa skryju. Default je 0 = ziadne filtrovanie.
  • HideOldTripsLimit - casovy limit v minutach. Spoje, ktore maju cas konca starsi ako tento limit, sa nebudu zobrazovat pri vybere odchylkovej linky/spoja. Default je 0 = ziadne filtrovanie.
  • DistanceFromFirstBusstopWarning - Ak je v momente vstupu do spoja vzdusna vzdialenost medzi aktualnou polohou a prvou zastavkou spoja vacsia ako zadana hodnota, zobrazi sa vodicovi varovanie. Udava sa v metroch. Prednastavena hodnota je 0m t.j. nekontrolovat. Kontroluje sa iba v mapovom vydaji (Izmir).
  • DistanceFromFirstBusstopWarningTimeout - cas zobrazenia varovania a vstupe do spoja prilis daleko od prvej zastavky (vid DistanceFromFirstBusstopWarning). Udava sa v sekundach. Prednastavena hodnota je 30s.
  • FilterDeviationTripsByStartTime - príznak, že sa pri voľbe odchylkového spoja majú spoje filtrovať podľa času odchodu z prvej zastávky namiesto čísla spoja. Prednastavená hodnota je 0 = filtruje sa podľa čisla spoja.
  • DedicatePanelActionLabelToDriverNumber - príznak, že “PanelActionLabel” (text hned vedľa ikony v ľavom hornom rohu obrazovky) je vyhradený pre zobrazovanie čísla vodiča. Prednastavená hodnota je 0 = nie je vyhradený a číslo vodiča sa tam teda nezobrazuje.
  • ConvertDeviationTripToCommand - príznak, že po výbere odchýlkovej linky/spoja sa má vyhľadať príkaz, ktorý daný spoj obsahuje a má sa pokračovať do výdaja, akoby bol navolený daný príkaz. Prednastavená hodnota je 0 = nekonvertovať.
  • CheckDeviationTripValidity - príznak, či sa má vo výbere odchýlkovej linky a spoja kontrolovať platnosť spoja na daný deň. Prednastavená hodnota je 0 = nekontrolovať.
  • DisplayDelayOnSynchroPoint - priznak, ci sa ma v mode medzi zastavkami zobrazovat meskanie, ako sa odosiela na dispecing. Prednastavena hodnota je 0
0 - v rezime mapy (medzi zastavkami) sa meskanie zobrazuje ako cas do odchodu z nasledujucej zastavky
1 - v rezime mapy (medzi zastavkami) sa zobrazuje rovnake meskanie, ako sa odosiela na dispecing (vypocitane zo synchronizacnych bodov)
  • PlaySoundOnPrematureDeparture - priznak, ci sa ma pri predcasnom odchode zo zastavky prehrat zvuk ( zatial pipnutie ). Prednastavena hodnota je 0 = neprehrava sa
  • TripStartSignalization - priznak 0/1, ci ma byt zapnuta zvukova signalizacia avizujuca zaciatok spoja (jedno pipnutie 2 minuty pred zaciatkom spoja, dve pipnutia minutu pred zaciatkom a tri pipnutia v case zaciatku spoja). Prednastavena hodnota je 0 = vypnute.
  • IssueTicketByLongTariffPress - funkcionalita, kt. umoznuje v kompaktnom vydaji dlhsim podrzanim konktretnej tarify vydat hotovostny listok, hodnota 1 - funcionalita zapnuta, 0 - funkcionalita vypnuta (default)
  • ShowRepeatMessageOnFailedPrinting - nastavenie, ktore umoznuje pri zlyhani tlace cez tlacidlo “Retry” znova opakovat tlac posledneho listka. hodnota 1 - zapnute, 0 - vypnute ( default )
  • RunSAMUpdateCheckOnIssueOut - príznak 0/1, či sa má pri odchode z výdaja volať SAMUpdateCheck - metóda, ktorá zakomunikuje so serverom a zisi, či pre vložený SAM existuje update. Má to význam minimálne v tom, že sa tým odosielajú na server informácie o SAMoch a ich verziách. Default hodnota je 1 = volať SAMUpdateCheck.
  • InputDataCheckService - funkcionalita umoznujuca zapnutie noveho aplikacneho stavu, spustaneho len pri “nastartovani” aplikacie, kt. sluzi na kontrolu aktualnosti vstupnych dat a nasledne odoslanie poziadavky na vycitanie novych dat, atributy:
    • URL - url web sluzby, kde sa ma PP dopytovat na aktualnost vstupnych dat
    • StateTimeout - cas v milisekundach, kt. definuje maximalny casovy interval, pocas ktoreho sa mozeme pokusat o zistenie aktualnosti vstupnych dat a potencialne nasledne odoslanie poziadavky na vycitanie novych dat (default 300000 = 5 minut)
    • SingleRequestTimeout - cas v milisekundach, kt. definuje maximalny casovy interval, pocas ktoreho cakame na 1 odpoved od web sluzby, pomocou kt. zistujeme aktualnost vstupnych dat ( default 5000 - 5 sekund )

Pre zapnutie s default timeoutami stačí:

<InputDataCheckService URL="http://192.168.99.63/ObcAPI/api/v1/ExistNewDataForToDay"/>
  • ShowMessageOnPortableWallet - Nastavenie, ktore urcuje, ci sa ma zobrazit hlaska (“vydat listok na prenosnu penazenku?”) pri vydaji na prenosnu penazenku. Prenosna penazenka sluzi na to, aby bolo mozne vydat listok pre majitela karty s navolenou tarifou (typ zlavy) inou ako typ zlavy na karte.
 mode 1 - zobrazovat potvrdzovaciu hlasku pri vydaji na prenosnu penazenku
 mode 0 - nezobrazovat potvrzdovaciu hlasku a vydat listok na prenosnu penazenku automaticky
  • DontCloseCameraStreamOnBusStopDeparture - nastavenie, ktore umoznuje nezatvarat nahlady kamier pri odchode zo zastavky. hodnota 1 - zapnute, nezatvarat nahlady kamier; 0 - vypnute ( default ), nahlady kamier sa uzavru pri odchode zo zastavky
  • UpdateEMVTerminalOnlyOnClosedDeduction - Pomocou tohto nastavenia vieme zamedzit volanie parametrov EMV terminalu pri vypinani zariadenia v pripade, ze je otvoreny odpocet. Defaulne je toto spravanie ZAPNUTE (hodnota 1), teda pri vypinani sa budu volat parametre terminalu iba ak je odpocet zatvoreny.
  • AutomaticallyEnterMatchingOnlineCommand - nastavenie umoznuje automaticke potvrdenie cisla prikazu v stave vyberu prikazu v pripade, ze cislo prikazu vyhovuje podla cisla vodica alebo cisla vozidla (podla operativnych dat). Prednastavena hodnota je 0 = vypnute, funkcionalitu mozno povolit nastavenim na hodnotu 1.
    • MinWaitTimeBeforeGoIssue - atribut, kt umoznuje nastavit cas (v sekundach, defaultna hodnota je 5 sekund), pocas ktoreho ostaneme po automatickom potvrdeni prikazu v stave odpocitavania do zaciatky spoja (pri prejazdoch to neplati), aby sa mal vodic moznost sipkou vratit spat a pripadne zvolit prikaz manualne (inak by nemal moc kontrolu nad tym, aky prikaz bude jazdit, pretoze by to vzdy predvolila aplikacia automaticky)
  • CheckTimetableForFutureValidity - Nastavenie umoznuje vo faze startovania aplikacie zobrazit upozornenie v pripade, ak su rozbalene vstupne data s platnostou v buducnosti. Prednastavena hodnota je 1 = zapnute (zobrazuj upozornenie), funkcionalitu mozno vypnut nastavenim na hodnotu 0.
  • SamUpdateAutomation - príznak 0/1, či sa má pri vypnuti zariadenia volať SamUpdateProces - metóda, ktorá vykona update nad vlozenymi SAM modulmi, ak takyto existuje. Default hodnota je 0 = nevykonavat SamUpdate.
    • SamUpdateAutomationInterval - atribut SamUpdateAutomation, ktory hovori o tom, ako casto sa ma volat SAM update pri vypinani, default = 7 (kazdych 7 dni)
  • UnlockDevicesTimeout - pocet sekund, kedy zostanu citacky odomknute, po vykonani prikazu “Odomknutie zariadeni” z menu palubaku. Po vyprsani daneho casu, sa uzamknu. Prednastavena hodnota je 30.
  • CrossroadPreferences - node pre nastavenie preferencii krizovatiek
    • URL - atribut pre nastavenie adresy web sluzby, kam sa posielaju prejazdy bodmi krizovatiek
    • RequestTimeout - timeout pre request, kt. sa posiela na web sluzbu, default 5000 (5s)
    • RequestAttempts - maximalny pocet pokusov o odoslanie requestu na web sluzbu, default 3
  • EmvCardDetection - Nastavenie umoznuje platbu aj EMV kartou po stlaceni tlacidla “karta”. Defaultna hodnota je 0 = vypnuta platba EMV kartou po stlaceni tlacidla “karta.
  • PrintInterchangeTicket - príznak, či sa má tlačiť lístok pri prestupe, default 1 (má sa tlačiť)
  • BusTableInterchangesWebServiceURL - url web sluzby, kde sa ma PP dopytovat na prestupy pre LCD tabule
  • SLToArrivaCardCompanyChange - povolenie extraoperacie na preklopenie kariet Slovak Lines na karty Arriva Mobility Solutions (default je extraoperaciu nevykonavat = 0, nastavenim na 1 extraoperaciu povolime)
  • IsTransfareInfoProviderEnabled - príznak 0/1, či sa majú posielať prostredníctvom UDP informácie vo formáte JSON o aktuálnej linke/spoji/zastávke vždy pri zmene. Default hodnota je 0 = neposielať informácie.
    • TransfareInfoProviderSpeedInterval - atribút TransfareInfoProviderSpeedInterval, ktorý hovorí o tom, ako často sa majú posielať informácie o rýchlosti vozidla. Default = 0 (0 sekúnd - informácia sa neposiela)
    • TransfareInfoProviderIp - povinný atribút TransfareInfoProviderIp, definuje ip NVR zariadenia, kam sa budú informácie odosielať. Ak sa nezadá číslo portu, použije sa default hodnota 22234.
<IsTransfareInfoProviderEnabled TransfareInfoProviderIp="192.168.12.100:22234" TransfareInfoProviderSpeedInterval="10">1</IsTransfareInfoProviderEnabled>
  • Barcode - Pozri Popis v PrjConfig
  • ShowMessageAfterPaperTicketWasPrinted - Umoznuje zapnut zobrazovanie informacnej hlasky vodicovi o tom, ze papierovy jednorazovy listok bol uspesne vytlaceny. Pozadovane to bolo povodne DPMM kvoli tomu, ze listky sa tlacia na tlaciarni citacky, ktora je ale otocena smerom od vodica, takze na nu nevidi. Moze nadobudat hodnoty 0/1 (vypnute/zapnute). Default hodnota je 0 = vypnute .
  • BusTableMessagesFromDispatchingWebService - funkcionalita umoznujuca zapnutie stahovania informacnych sprav z dispecingu pre LCD tabule
    • URL - URL web sluzby, odkial sa maju info sprvy stahovat
    • Interval - interval v sekundach, v akom sa maju vo vydaji informacne spravy stahovat
<BusTableMessagesFromDispatchingWebService URL="http://test.dispecing.info/TransferDataWebServiceREST/api/MessagesForTableOnTrip" Interval="120"/>
  • ShowKilometersInTicketIssueWindow - nastavenie umoznuje zobrazit v okne vydaja pocet kilometrov od aktualnej zastavky. Moze nadobudat hodnoty 0/1 (vypnute/zapnute). Default hodnota je 0 = vypnute.
  • ShowTariffsFromSubstituteTariffGroups - nastavenie, ktoré umožňuje vypnúť ponúkanie taríf z nahradných tarifných skupín v okne výdaja. Zavedené bolo na žiadosť SAD TN. Može nadobúdať hodnoty 0/1:
    • 0 = tarify z náhradných tarifných skupín sa neponúkajú vo výdaji
    • 1 = tarify z náhradných tarifných skupín sa ponúkajú vo výdaji (default)
  • PrintRefuellingTicketWithFinalTicket - funkcionalita umožňujúca automaticky vytlačiť samostatný tankovací lístok pri uzatvorení odpočtu
    • 0 - tankovací lístok sa pri koncovom lístku odpočtu nevytlačí (default)
    • 1 - tankovací lístok sa tlačí automaticky po vytlačení koncového lístku odpočtu
  • RefuellingTicketCountryCode - GS1 country code pre tankovací lístok (prvé tri číslice EAN13). Predvolená hodnota je “000”.
  • DispatchingTelephoneNumber - telefonne cislo na dispecing. Pouzije sa napriklad pri potvrdzovani stavu vozidla pri preberani v pripade, ze vozidlo v poriadku nie je - zobrazi sa obsluhe
  • QadraMessagesWebServiceURL - URL služby pre posielanie sprav zo zariadenia Qadra
    • SendingInterval - atribut, ktory definuje ako casto ( v sekundach ) bude OBC posielat sluzbe neodoslane spravy zo zariadenia Qadra. Vychodzia hodnota je 20 sekund
    • SendingTimeout - atribut, ktory definuje timeout ( v sekundach ) posielania neodoslanych sprav zo zariadenia Qadra na definovanu sluzbu. Vychodzia hodnota je 20 sekund
    • MaxMessagesSending - atribut, ktory definuje maximalny pocet sprav poslanych sluzbe v jednej poziadavke. Vychodzia hodnota je 100
    • DeleteInterval - atribut, ktory definuje ako casto ( v minutach ) bude OBC mazat odoslane spravy z databazy obc.db. Vychodzia hodnota je 1 minuta.
    • MaxRecordCount - atribut, ktory definuje max. pocet zaznamov v tabulke qadra_messages databazy obc.db. Vychodzia hodnota je 200000 zaznamov.
<QadraMessagesWebServiceURL SendingInterval="5" SendingTimeout="20" MaxMessagesSending="10" DeleteInterval="1">http://test.dispecing.info/ObcAPI/api/qadra/Data</QadraMessagesWebServiceURL>
  • AutoQrCodeReadingEnabled - nastavenie umoznuje citat QR kody, ked je OBC v stave vydaja listkov. Defaultne je toto spravanie VYPNUTE (hodnota 0).
    • QrPopUpMessageTimeout - atribut, ktory definuje dlzku zobrazenia spravy pri vyhodnocovani QR kodu v sekundach. Vychodzia hodnota je 5 sekund.
    • QrCodeValidityStartTolerance - atribut, ktory umoznuje definovat kolko minut pred zaciatkom platnosti sa ma uznat QR listok. Vychodzia hodnota je 20 minut.
    • UseTestingKeys - atribut, ktory umozni pouzit testovacie kluce. Vychodzia hodnota je 0 - pouzit ostre kluce.
    • QrCodeType - atribut, ktory definuje aky typ QR kodu bude system akceptovat. Validne retazce su “Elmolis” a “Ubian”. Retazce su case insensitive. Default hodnota je “Elmolis”.
  • TripGuaranteedConnectionsWebServiceUrl - URL služby pre ziskanie informacie o garancii nadväznosti spojov pre vodičov
    • DownloadInterval - atribut, ktory definuje ako casto ( v sekundach ) si bude OBC stahovat informacie z definovanej sluzby. Vychodzia hodnota je 15 sekund
  • TripsDelaysWebServiceURL - URL web služby pre stahovanie meskania nadvaznych spojov, tato sluzba nahradza povodnu soap sluzbu avldelay (DelayWebServiceUrl), implementovana bude v release nasledujucom po release 2406
<TripsDelaysWebServiceURL>http://test.dispecing.info/OBC_API/api/v1/Trips/Delay</TripsDelaysWebServiceURL>
  • IgnoreByways - Nastavenie umoznujuce vypnut uznavanie zachadzok. Zavedene kvoli situacii pri spustani IDS Vychod. Moze nadobudat hodnoty 0 a 1. 1 znamena, ze sa zachadzky maju ignorovat = neuznavat. Predvolena hodnota je 0.
  • SlaveIssueSound - Funkcionalita umoznuje prehrat zvuk (pipnutie) na Vesne po vydani listka na citacke u vodica

Ak element neobsahuje hodnotu (nazov suboru so zvukom), prehra sa defaultny zvuk beep.mp3 (v priecinku /opt/app-5/usr/sound/)

<SlaveIssueSound></SlaveIssueSound>

Ak element obsahuje nazov suboru, ten sa hlada najprv v priecinku /opt/app-5/var/spool/incoming, nasledne v /opt/app-5/usr/sound

<SlaveIssueSound>TicketIssuedOnSlave.mp3</SlaveIssueSound>
  • SupportedLanguages - Sluzi na moznost povolit aplikacii pouzivat iny ako defaultny jazyk (povolenie dodatocnych jazykov).

Element obsahuje nody Language, ktore reprezentuju dvojznakovu skratku jazyka, do ktoreho ma uzivatel z menu moznost aplikaciu prepnut. Aplikacia totiz moze obsahovat v balicku defaultne viacero jazykov, no na prepinanie jazyka sa pouziju iba tie, ktore povolime. Podpora viacero jazykov je totiz platena funkcionalita.

<SupportedLanguages>
  <Language>ru</Language>
  <Language>en</Language>
</SupportedLanguages>
  • TripGetPlatformChange - Zapnutie moznosti zmenit nastupiste z dispecingu.

Element obsahuje atribut WebServiceUrl, ktory definuje URL web služby pre dopyt o zmene nastupista voci cestovnym poriadkom.
Element moze obsahovat nody BusStop s atributom Id - Id zastavky pre ktoru moze byt zmenene nastupiste.
Zastávky na ktorých sa má dopytovať na zmenu nástupišťa sú primárne nastavené príslušným flagom vo vstupných dátach.
Atribút CheckingInterval je interval v sekundách, v akom sa bude posielať request na web službu po príchode na zastávku - default je 5 sekúnd.

<TripGetPlatformChange WebServiceUrl="http://test.dispecing.info/OBC_API/api/v1/Trips/GetPlatformChange" CheckingInterval="30">
    <BusStop Id="9851"/>
    <BusStop Id="535"/>
</TripGetPlatformChange>
  • ManualConfirmationOfCrossingSegments - Nastavenie umožňujúce zapnúť manuálne potvrdzovanie prejazdov. T.z. že prejazd sa neukončí automaticky v čase jeho konca podľa cestovných poriadkov, ale vodič ho musí potvrdiť stlačením tlačidla s piktogramom autobusu (ako keby ho chcel ukončiť predčasne). Môže nadobúdať hodnoty:
    • 0 - manuálne potvrdzovanie nie je vyžadované (predvolená hodnota)
    • 1 - manuálne potvrdzovanie je vyžadované

PrjConfig.xml pre Predpredaj

má štruktúru:

<?xml version="1.0" encoding="iso-8859-1"?>
<PrjConf Setting1="setting1value" Setting2="setting2value"...  
   <EventsWS ...
       nastavenie pre IFC 
   </EventsWS>
</PrjConf>

Nastavenia IFC do PrjConfigu

  • AppealCasherNumber

Zoznam reklamačných zariadení (t.j. zariadení, ktoré majú v menu tlačidlo “reklamácia” a sú teda schopné vykonávať prenos PCL/peňaženky z neprítomnej/nefunkčnej karty na novú).

Možné hodnoty:
- nastavenie nie je špecifikované alebo ma hodnotu "" alebo "0" = reklamácia je povolená na všetkých zariadeniach
- zoznam reklamačných pokladní oddelených čiarkou, napr. "126001, 126002"

V balíčku je štandartne toto nastavenie nastavené na “0” (reklamácia je povolená na všetkých zariadeniach)

  • AutomaticCommunicationReqOnDeductionClose (iba pre predpredaj 1703 a novší)

Určuje, či sa má po uzavretí odpočtu palubák spojiť so serverom a pokúsiť sa o vyčítanie. </PrjConf>

Možné hodnoty:
0 - (default) nežiada server o vyčítanie
1 - žiada server o vyčítanie
  • AutomaticCommunicationReqOnTurnon (iba pre predpredaj 1703 a novší)

Určuje, či sa má po zapnutí predpredaj spojiť so serverom a pokúsiť sa o vyčítanie.

Možné hodnoty:
0 - (default) nežiada server o vyčítanie
1 - žiada server o vyčítanie
  • DataOutputReadRequest

Slúži na nastavenie odosielania požiadavkov na vyčítanie štatistiky. Jeho hodnota pozostáva z troch hodnôt 0/1, kde:

  1. hodnota: odosielanie požiadavky na vyčítanie štatistiky pri nábehu aplikácie
  2. hodnota: odosielanie požiadavky na vyčítanie štatistiky pri uzavretí odpočtu
  3. hodnota: tlačidlo v menu pre odoslanie požiadavky na vyčítanie štatistiky

Takže ak chceme iba zapnúť vyžiadanie vyčítania štatistiky pri uzavretí odpočtu, nastavenie bude vyzerať: DataOutputReadRequest=“010”.

Defaultné správanie je akoby boli všetky hodnoty na 0.

  • DisablePrintTariffZones

Nastavenie sa týka tlače tarifných pásiem (=riadkov cenníka) na zozname taríf.

Možné hodnoty:
0 - (default) Zapnutá tlač riadkov cenníka na zozname taríf
1 - Vypnutá tlač riadkov cenníka na zozname taríf

V balíčku je toto nastavenie štandartne nastavené na 1 (vypnutá tlač riadkov cenníka na zozname taríf)

  • EditPersonalData

Nastavenie pre povolenie/zakázanie editácie údajov na karte ako typ karty, platnosť karty, platnosť zľavy a pod. Pozostáva z troch hodnôt 0/1, kde:

  1. hodnota: povolenie (1) alebo zákaz (0) editácie typu karty
  2. hodnota: povolenie (1) alebo zákaz (0) editácie platnosti zľavy (prípadne aj bonusovej zľavy)
  3. hodnota: povolenie (1) alebo zákaz (0) editácie platnosti karty

V balíku je toto nastavenie nastavené na “111” (povolená editácia všetkých troch položiek)

  • MaxCountWrongLogin

Udáva najvyšší povolený počet neúspešných prihlásení. Po presiahnutí tohto počtu sa už do pokladne nedá prihlásiť, zobrází sa hláška “Chyba prihlásenia. Maximálny počet chybných prihlásení” a je potrebné v servisnom menu (po prihlásení servisnou kartou) znulovať neúspešné prihlásenia (alebo zmazať súbor /opt/emtest/etc/hlavny/Identification.xml). Ak nie je táto hodnota v PrjConfig-u špecifikovaná, počet neúspešných prihlásení sa nekontroluje.

V balíčku je nastavená štandartne na 5.

  • PrintItemCount

Umožňuje povoliť tlač počtu kusov na koncovom lístku (okrem počtu lístkov na za lomítkom vytlačí aj počet kusov). T.z. že ak sa predá povedzme 5 kusov obalu na kartu na jeden hromadný lístok, bude príslušný riadok na koncovom lístku vyzerať: “obal na kartu 1/5”

Možné hodnoty:
0 - (default) vypnutá tlač počtu kusov na koncovom lístku
1 - zapnutá tlač počtu kusov na koncovom lístku

V balíčku je štandartne toto nastavenie nastavené na 1 (zapnutá tlač počtu kusov na koncovom lístku).

  • ProjektName

Nastavenie skôr historického charakteru, zvyklo obsahovať texty ako “GDANSK”, “WEJHEROWO” a pod. a boli na to zavesené rôzne špecifiká týchto projektov. V súčasnosti sa používajú už asi iba dve hodnoty a to:

"BMK" - pre BID
"SK_DESFIRE" - zvyšok Slovenska

Riadi sa podľa neho funkcionalita šípok pri pohybe vo výdaji a v prípade “BMK” sa zobrazujú aj informácie o bonusovej zľave v infe o karte.

  • ShowInvalidTimeTicket

Nastavenie určuje, či sa majú v infe o karte (vyvolanom F4) zobrazovať aj časové predplatné lístky, ktoré sú už po platnosti.

Možné hodnoty:
0 - nezobrazovať lístky po platnosti
1 - (default) zobrazovať lístky po platnosti

V balíku je štandartne toto nastavenie nastavené na 1 (zobrazovať lístky po platnosti)

  • StornoCasherNumber

Zoznam zariadení oprávnených vykonávať storno z karty (majú v infe o karte tlačidlo “Storno”)

Možné hodnoty:
- nastavenie nie je špecifikované alebo ma hodnotu "" alebo "0" = storno je povolené na všetkých zariadeniach
- zoznam pokladní oprávnených vykonávať storno z karty oddelených čiarkou, napr. "126001, 126002"

V balíčku je štandartne toto nastavenie nenastavené (t.j. storno je povolené na všetkých zariadeniach)

  • TicketNumberIDSBKPrefix

Týka sa obsahu QR kódu tlačeného na papierových jednorazových lístkoch v BID. Podľa špecifikácie je v QR kóde zakódovaný aj identifikátor predajcu (podľa dokumentu Štandard cestovných dokladov). Momentálne sa týka iba SlovakLines (identifikátor 694 - ten je aj defaultnou hodnotou)

  • TransfersEnabled

Povolenie tlačidla v infe o karte pre prenos časového lístka/peňaženky z karty na kartu. Defaultne je tlačidlo vypnuté.

Možné hodnoty:
"true" alebo "1" - tlačidlo je povolené
"false" alebo "0" - tlačidlo nie je povolené
  • UseEuroCurrency

Nastavenie zavedené pri prechode na euro. Nemusí byť špecifikované vôbec alebo by malo byť nastavené na “0”.

  • TicketPartialCancellationFee

Pozor, je to samostatny nod, nie atribut. Umoznuje definovat sankcie pre ciastocne storno (zavedene kvoli IDS Vychod)

<PrjConf ... >
 ...
   <TicketPartialCancellationFee>
      <UsedValidityInterval feePercent="12">10000</UsedValidityInterval>
      <UsedValidityInterval feePercent="6">6</UsedValidityInterval>
   </TicketPartialCancellationFee>
</PrjConf>

Nastavenie vyssie definuje, ze ak je listok stornovany prvych 6 dni platnosti, zaplati sa pokuta 6% z alikvotnej ciastky. Ak je stornovany neskor, zaplati sa pokuta 12% z alikvotnej ciastky (V tomto pripade, ak je stornovany do 10000 dni :). Intervalov moze byt definovany lubovolny pocet.

  • SLToArrivaCardCompanyChange - povolenie extraoperacie na preklopenie kariet Slovak Lines na karty Arriva Mobility Solutions (default je extraoperaciu nevykonavat = 0, nastavenim na 1 extraoperaciu povolime)

Nastavenia, ktoré sa nepoužívajú od releasu 1703

  • UseFiskal

Nastavenie zapínalo používanie fiškánej kasy Innova v poľských projektoch. Od releasu 1703 nie je fiškálna tlačiareň podporovaná v aplikácii.

  • CardCodePage

Určovalo kódovú stránku v ktorej bolo uložené meno obsluhy na servisnej karte. Od releasu 1703 sa nepoužíva.

  • CodePageTicketTemplate

Kódová stránka CPL vzorov lístkov. Od 1703 sa nepoužíva.

Nastavenia, ktoré sa nebudú používať od releasu 1710

  • RemoveTicketCashierNumber

V infe o karte bývalo kedysi tlačidlo na zmazanie časového lístka bez záznamu v statistike. To tlačidlo bolo už dávno vyhodené, ostalo ešte nastavenie, čo ho vtedy zapínalo. Teraz by malo byt nastavené na “1”.

  • ChangePositionCountTicket

Určovalo pozíciu stĺpca s počtami lístkov pri tlači počítadiel na koncovom lístku. Vždy bolo nastavené na 15.

  • NetworkID

Bolo to networkID, ktoré sa posielalo platobnému v prípade, že neboli vyplnené príslušné položky v dátach (ESetFirma).

Nastavenia, ktoré sa nepoužívajú

  • MaxDaysOutOfDate
  • NewPrinterTemplate
  • RemakeToMad
  • PayUnitISOCode
  • PayUnitMultiplier
  • AllowEditPersonalData
  • MakeRequestImages

PrjConfig.xml pre Slave

Štruktúra rovnaká ako pri PrjConfig.xml pre OnboardComputer, vyčitava sa ale hodnota:

  • DontReadPurseLogs - vynutenie necitania logov penazenky (iba pre karty mifare standard).
0 - (default) - vypnute. Logy sa citaju a zapisuju do statistiky
1 - zapnute necitanie logov penazenky a vypnute zapisovanie do statistiky
  • SLToArrivaCardCompanyChange - povolenie extraoperacie na preklopenie kariet Slovak Lines na karty Arriva Mobility Solutions (default je extraoperaciu nevykonavat = 0, nastavenim na 1 extraoperaciu povolime)
  • AutoQrCodeReadingEnabled - nastavenie umoznuje citat QR kody, ked je Slave v stave vydaja listkov. Defaultne je toto spravanie VYPNUTE (hodnota 0).
    • QrPopUpMessageTimeout - atribut, ktory definuje dlzku zobrazenia spravy pri vyhodnocovani QR kodu v sekundach. Vychodzia hodnota je 5 sekund.
    • QrCodeValidityStartTolerance - atribut, ktory umoznuje definovat kolko minut pred zaciatkom platnosti sa ma uznat QR listok. Vychodzia hodnota je 20 minut.
    • UseTestingKeys - atribut, ktory umozni pouzit testovacie kluce (pre testovaciu elmolis aplikaciu). Vychodzia hodnota je 0 - pouzit ostre kluce.
    • QrCodeType - atribut, ktory definuje aky typ QR kodu bude system akceptovat. Validne retazce su “Elmolis” a “Ubian”. Retazce su case insensitive. Default hodnota je “Elmolis”.

ProjectConfiguration.xml pre PC Predpredaj

* TicketPartialCancellationFee

Umožňuje definovať sankcie pre čiastočné storno (zavedené kvôli IDS Východ)

<PrjConf ... >
 ...
   <TicketPartialCancellationFee>
      <UsedValidityInterval feePercent="12">10000</UsedValidityInterval>
      <UsedValidityInterval feePercent="6">6</UsedValidityInterval>
   </TicketPartialCancellationFee>
</PrjConf>

Nastavenie vyššie definuje, že ak je lístok stornovaný prvých 6 dní platnosti, zaplatí sa pokuta 6% z alikvotnej čiastky. Ak je stornovaný neskôr, zaplatí sa pokuta 12% z alikvotnej čiastky (V tomto prípade, ak je stornovaný do 10000 dní :). Intervalov môže byť definovaný ľubovoľný počet.

MarkerTicket.xml

Umiestnenie:

  • Standardne umiestnenie konfiguracnych suborov
  • externe data

Struktura:

<EMarkerTicket>
  <Parameters>
    <parameter name="width" value="150"/>
    <parameter name="height" value="9"/>
  </Parameters>
  <Cells>
    <cell name="TariffZone" divideText="0" isRomeNumber="true" fontSize="1" showChar="3" space="1"/>
    <cell ... />
    <cell ... />
    ...
  </Cells>
</EMarkerTicket>


Popis atributov polozky parameter

  • name
    • width - sirka potlace
    • height - vyska potlace
  • value - hodnota daneho parametra


Popis atributov polozky cell

  • name – meno značky. Buď interpretované (jedno z vymenovaných nižšie) alebo hociaké iné, ale v tom prípade musí mať značka aj parameter “text”
  • fontSize – typ fontu (pôvodne veľkosť)
    • 0 – malý font (5×6 px)
    • 1 – veľký font (7×9 px)
    • 2 – veľký font - bold (8×9 px, 7×9 pre MikroCVX)
    • iná hodnota – použije sa veľký font
  • space – veľkosť medzery za značkou (počet bodov)
  • showChar – počet zobrazovaných znakov (zvyšok bude odrezaný)
  • divideText – príznak, ktorý indikuje:
    • Rozdeľovanie textu do viacerých riadkov (či bude text vytlačený vo viacerých riadkoch ak sa nezmestí do jedného).
    • Ak je príznak nastavený na hodnotu 1, vždy sa tlačí vo vertikalnom režime.
    • Ak je príznak nastavený na hodnotu 1, nereaguje na hodnotu nastavenú vo fontSize.
  • isRomeNumber – či sa má číslica vytlačiť ako arabská číslica alebo ako rímske číslo. Vždy sa tlačí vo vertikalnom režime (vertikalny font 6×4 px).
  • text – ak má značka tento parameter, tak ide o neinterpretovanú značku a vytlačený bude obsah tohto parametra


Zoznam interpretovanych nazvov “buniek” (t.z. bude vytlacena hodnota ktora bola pre tu bunku nastavena z aplikacie):

  • StopNumber – identifikačné číslo zastávky (ID)
  • VehicleNumber – identifikačné číslo vozidla (INV)
  • TariffZone – tarifné pásmo
  • ProtectNumber – kontrolné/ochranné číslo
  • LineNumber – číslo linky
  • StopOrder – poradie zastávky na spoji (zaciatok cislovania od 1)
  • BusStopZone – zóna zastávky
  • BusStopTariffNumber - tarifné číslo zastávky
  • Hours – hodiny – čas kedy bol lístok označený/znehodnotený (aktuálny čas)
  • Minutes – minúty – čas kedy bol lístok označený/znehodnotený (aktuálny čas)
  • Day – deň – čas kedy bol lístok označený/znehodnotený (aktuálny čas)
  • Month – mesiac – čas kedy bol lístok označený/znehodnotený (aktuálny čas)
  • Year – rok – čas kedy bol lístok označený/znehodnotený (aktuálny čas)

Menu.xml

Popis poloziek Menu pre Vesnu je mozne najst na Google Drive - Documentation/Development/Transfare/Vesna/Polozky menu aplikacie

Popis prikazov:

  • CMDAccessories - zobrazi menu s doplnkami
  • CMDAnnouncementSound - zobrazi vsetky dostupne upozornenia a dovoli ich prehrat
  • CMDBlockPerifs- zablokuje alebo odblokuje periferne zariadenia
  • CMDBrightness - dovoli upravovat jas na palubnom pocitaci
  • CMDBusstopList - vytlaci zoznam zastavok na danom spoji
  • CMDBusstopPositionList - vytlaci zoznam zastavok na spoji s GPS suradnicami
  • CMDCalculator - kalkulacka
  • CMDCalendar - kalendar
  • CMDCarCalling - ak to system povoluje, tak ze povoli hlasenia vodica do vozu
  • CMDCardImage - spusti obrazovku pre ulozenie karty do image. Image a ulozi do priecinka /tmp/ pod nazvom CardImage_'ID'.dat (resp. priečinka /opt/emtest/var/log/ na predpredaji )
  • CMDCardInfo2 - zobrazi info o karte
  • CMDCashInventory - zadavanie zmenneho v roznych menach
  • CMDCloseDailyIdentificationVehicleRecord -
    • Mijola - zobrazi okno pre zadanie stavu najazdenych kilometrov z tachografu a po potvrdeni zatvori stazku pre dany den
      1. Redmine task #3637 - od release-u 1703 je funkcionalita uzatvarania stazky (denneho zaznamu vozidla vodica) a zadavania kilometraze oficialne podporovana len pre klavesnicove mijoly
    • Vesna
      • build skorsi ako 676 - uzavrie otvoreny odpocet
      • od buildu 676 (Redmine task #4932) sa zobrazi okno pre zadanie stavu najazdenych kilometrov z tachografu a po potvrdeni zatvori stazku pre dany den
      • od buildu 681 - uzatvori stazku, zobrazi otazku ci sa ma uzatvorit aj odpocet
  • CMDFinalTicket - uzavrie odpocet (implementovane od buildu 676, Redmine task #4932)
  • CMDRepeatFinalTicketPrint - vytlaci kopiu posledneho konecneho listka (funguje, pokial vodic nie je prihlaseny). Implementovane od buildu 681 - RedmineTask #6188.
  • CMDCommands - vytlaci zoznam prikazov
  • CMDCommunication - ukaze menu pre komunikaciu
  • CMDContrast - meni kontrast na palubnom pocitaci
  • CMDCurrentDeduction- vytlaci predbezny odpocet
  • CMDDeduction - zobrazi menu pre odpocty ( zaciatocny listok, konecny listok, stazka)
  • CMDDefault - resetne nastavenia na defaultne hodnoty (zvuk,jas,kontrast ..)
  • CMDDestinationNumber - zobrazy okno pre zadavanie commandu
  • CMDDevicesUnlock - odomkne citacky a ostatne zariadenia ak nejake existuju
  • CMDDriverChange - zavola striedanie vodicov
  • CMDDriverVolume - meni hlasitost pre jednotilve kanaly
  • CMDFinalTicket - vytlaci konecni listok
  • CMDGPRSInfo - ukaze info o GPRS
  • CMDInfo - ukaze ingo o HW,SW,Datach,
  • CMDInfoCan - zobrazi info o CAN
  • CMDInfoFlashBuse - zobrazi info o tabuliach
  • CMDInfoGps - zobrazi info o GPS a suradnice ak GPS funguje
  • CMDInitialTicket - vytlaci zaciatocny listok
  • CMDIntelKomComm - posle request na komunikaciu s intel
  • CMDIssue - vstup do vydaja
  • CMDIssueRegistry - zobrazy menu pre tlaci tarif,zastavok
  • CMDKeyboardLight - dovoli menit podsvietenie na klavesnici
  • CMDLineOfCommands - zobrazi okno pre zadavanie prikazov, nasledne linky pre dany prikaz
  • CMDLines - vytlaci zoznam liniek
  • CMDMainRegistry - zobrazi menu s tarifami,spojmi,linkami commandmi
  • CMDPaperFeed - not implemented, posunutie papiera
  • CMDPlaySoundOnSlaves - zobrazi ci su povolene hlasenia na citackach a dovoli ich zapnut vypnut
  • CMDPrinter - zobrazi menu pre tlaciaren
  • CMDPrinterCutPaper - zareze papier na tlaciarni
  • CMDPrinterTest - vytlaci test na tlaciarni
  • CMDPrinterTestAll - otestuje tlacenie na citacke
  • CMDPrinterUnlock - odomkne tlaciaren
  • CMDRadioBus - ukaze menu pre konektel
  • CMDRadioBusOverviews - zobrazi zoznam rezervovanych spojov na zavloanie
  • CMDRadioBusReservation - rezervacia tripu pre datum
  • CMDRadiostation - ukaze menu pre radio stanicu konektel
  • CMDReboot - po potvrdeni restartne strojec
  • CMDRestartDevices - restartne ostatne zariadenia
  • CMDSaver - dovoli editovat nastavenia sporica obrazovky
  • CMDSetHolderIP - v Litve vola program na detekciu citaciek (system /opt/emtest/bin/servicesetting -qws)
  • CMDSettings - ukaze menu pre nastavenia
  • CMDShutdown - po potvrdeni vypne palubny pocitac
  • CMDStorno - otvory okno pre storno listka
  • CMDSystem - ukaze info o zariadeniach (platobny terminal,GPS,printer ..)
  • CMDTarrifList - vytlaci zoznam traif na tarifnych skupinach
  • CMDTarrifs - vytlaci tariffy
  • CMDTicketList - vytlaci zoznam vydanych listkov
  • CMDTicketSummary - zobrazy info o predanych listkoch
  • CMDTrips - vytlaci zoznam spojov na zadanej linke
  • CMDUpdateBUSE - spusti update tabuli
  • CMDVolume - okno pre nastavovanie hlasitosti
  • CMDWiFi - zapne wifi komunikaciu
  • CMDAccident - vyvola udalost nehoda na palubnom pocitaci
  • ECMDCashPaid - zobrazenie okna vydavku pre poslednu platbu
  • CMDContrastUltraLight - dalsie okno na menenie kontrastu
  • CmdGateEnter - manualna udalost vstup do brany
  • CmdGateEntryExit - zobrazenie menu pre brany
  • CmdGateLeave - manualna udalost vystup z brany
  • ECMDHelp - zobrazi okno pre pomoc
  • CMDInfoSystem - zobrazi menu pre info systemu
  • ECMDPrintRouteAudit - tlaci zoznam listkov na spoji pre revizora
  • ECMDSetINV - nastavi ICV
  • ECMDTicketSum - zobrazi cenu hromadneho listka
  • ECMDUnblockSamModule - spusti operaciu pre odblokovanie sam modulu
  • ECMDVoIP - ovlada voip hovory - odstranene od release-u 1703
  • CMDDriverBugReport - Zaloha logov pri probleme a posielanie upozornenia s chybou 257 do dispecing-u
Po navoleni tlacidla sa vytvori zaloha logov v priecinku /opt/emtest/var/log/driverBugReport-CASOVA_IDENTIFIKACIA_NAHLASENIA_PROBLEMU.
V priecinku /opt/emtest/var/log/ sa generuju maximalne 4ks zalohy zdrojovych kodov. Ostavaju vzdy 4 najnovsie.

Po uspesnom dokonceni zalohy logov na disku sa zobrazi vodicovi informacna hlaska, v slovenskom preklade 'Problém bol úspešne nahlásený. Ďakujeme.'

V pripade nahlasenia problemu sa do dispecingu posle chyba 257, indikujuca manualne poslanie problemu vodicom

  • CMDBugReport - Zaloha logov pri probleme v PresaleSystem aplikacii
  • CMDShowBusStopList - Zobrazenie zoznamu zastavok v okne na poziadanie od vodica
Po navoleni tlacidla sa ponukne volba linky a spoja. Ak je palubny pocitac vo vydaji, ponukne sa mu predvolena aktualna linka/spoj, pricom si ju moze zmenit

Zobrazenie ma vizualne odlisene navazne spoje.
Okno sluzi LEN na zobrazenie zastavok, nedisponuje ziadnou funkcionalitou.
  • CMDSendEmergencyMessageToDispatching - Poslanie spravy 3-20 do dispecinku a naskene zobrazenie vodicovi notifikacie o uspesnom poslani hlasenia. Redmine task 1213
  • CMDReadQRTicket - Tlacidlo pre citanie udajov z QR listka
  • CMDEMVPaymentTransaction - Tlacidlo pre vydaj na EMV terminali. Redmine task 3553
  • CMDEMVHandshakeTransaction - Tlacidlo pre overenie komunikacie EMV terminalu s bankovym prostredim. Redmine task 3630
  • CMDEMVCallParamsTransaction - Tlacidlo pre vykonanie transakcie Volanie parametrov na EMV terminale. Redmine task 8763
  • CMDEMVCallTerminalManagement - Tlacidlo pre vykonanie transakcie Volanie na Terminal Management banky. Redmine task 8895
  • CMDSelectLineTripAndDeviationBusStops - Len pre Vesna - Tlacidlo pre zvolenie odchylkovych zastaviek
  • CMDCameraPreview - Len pre Vesna - command pre zobrazenie video streamov z vozidlovych kamier
  • CMDSelectFragmentFlowIssue - Len pre Vesna - command pre prepnutie vydaja do rezimu vydaja s klavesnicou
  • CmdVoipCallRequest - Len pre Vesna - command odosle ziadost o standardny voip hovor na dispecing
  • CmdVoipEmergencyCallRequest - Len pre Vesna - command odosle ziadost o nudzovy voip hovor na dispecing
  • CMDTimeTicketProlongation - command pre predlzovanie PCL
  • CMDDestinationZoneIssue - Len pre Vesna - command pre vydaj do cielovej zony v Slovaklines BA
  • CMDCurrentTripInfo - Len pre Vesna - command pre zobrazenie informacii o aktualnom spoji, t.j. cislo linky, spoja a protekcne cislo. Nutne pridat do skupiny komandov v menu vydaja!
  • CMDIssue60MinutesTicket - Len pre Vesna - command pre vydaj 60-minutoveho listka (MHD Poprad). Redmine task 11293
  • CMDDriverIssueLocking - command pre blokovanie/odblokovanie vydaja listkov vodicom
  • CMDSamUpdate - spustenie updatu SAM-u
  • CMDRefuel - Zobrazenie okna pre zadanie kilometrov, litrov paliva a adblue, ktore sa potom odosielaju na dispecing
  • CMDClearSlaves - Príkaz pre zmazanie čítačiek

hkey.xml

Popis HotKey:

  • EHotkeyListScroller:
	- parametre:
		list - ID list
		offsetDelta - velkost skrolovania
		cyclic - true
  • ECMDIHKeyChooseCityBs - vyber konecnej zastavky
  • ECMDIHKeyCardIssue - vydaj jednorazoveho listka na kartu
  • ECMDIHKeyCardIssueOneWayTicket - vydaj jednorazoveho listka na kartu, rovnake ako (ECMDIHKeyCardIssue)
  • ECMDIHKeyAutoFillCashPaid - zobrazenie sumarnej ceny vydanych listkov v hotovosti( zmazany pri prerabke nevrateneho vydavku r1508 a vyssie )
  • ECMDIHKeyBlockGPS - blokovanie GPS
  • ECMDIHKeyTarif - predaj tarify pomocou rychlych klaves
  • ECMDIHKeySum - sumarna cena zakupenych listkov zakaznikom
  • ECMDIHkeyTicketsum - sumarna cena vsetkych listkov
  • ECMDIHKeyCashPaid - pre zobrazenie okna vydavku pre poslednu platbu
  • ECMDIHKeyPayUp - Zobrazenie doplatku na citacke
  • ECMDIHKeyCancelCoinerPayment - zrusenie platby
  • ECMDHKeyAnnouncementSound - prehranie hlasenia z externych dat
  • ECMDIHKeyTransferTicket - vydaj dopravneho listka
  • ECMDIHKeyTariffSelector - vyber tarify pre vydaj
  • ECMDIHKeyCancelTicket - storno listka
  • EHotkeySeparator - hotkey oddelovac
  • ECMDHKeyInvoice - platba fakturou
  • ECMDIssueZoneTicketHKey - vydaj zonoveho listka
  • ECMDIHKeyJMK - ?
  • ECMDHKeyUp - udalost klavesa nahor
  • ECMDHKeyDown - udalost klavesa nadol
  • ECMDHKeyConfirmIssue - udalost klavesa enter
  • ECMDIHKeyIssueTimeTicket - vydaj casoveho listka
  • ECMDIHKeyCoinerIssue - platba mincovnikom
  • ECMDIHkeyListZone - Zobrazi zoznam vsetkych zon. Po vybere zony sa nastavi vystupna zonova zastavka pre vydaj
  • ECMDHkeyBrightness - nastavenie jasu
  • ECMDHKeyVoIP - voip volanie - Odstranene od release-u 1703
  • ECMDHKeyPrinter - menu tlaciarne
  • ECMDHKeyDriverChange - zmena vodicov
  • ECMDReadOrSendMessagesHKey - spravy dispecera
  • ECMDIHKeyKonektelCall - Konektel hovor
  • ECMDFHKeyEmergency - nudzovy hovor
  • CMDHKeyShowBusStopList - Zobrazenie zoznamu zastavok v okne na poziadanie od vodica pomocou hotkey klavesy
  • CMDHKeyDestinationZoneInput - Volba vystupnej zony v BID
Po navoleni hotkey-u sa zobrazi zoznam zastavok podla aktualnej linky/spoju. Ak vodic pozaduje zobrazenie inej linky/spoja, musi prejst cez volbu menu 'CMDBusstopList'

Zobrazenie ma vizualne odlisene navazne spoje.
Okno sluzi LEN na zobrazenie zastavok, nedisponuje ziadnou funkcionalitou.
  • CMDHKeyDestinationSubZoneInput - Presne to iste, co CMDHKeyDestinationZoneInput, len s textom “Prestup” namiesto “Do zony”
  • CMDHKeySendEmergencyMessageToDispatching - Poslanie nudzovej spravy na dispecing. Sprava 3-20
  • CMDHKeyEMVPaymentTransaction - Vydaj jednorazoveho listka prostrednictvom EMV platby Redmine task 3553
  • ECMDIHKeyIssue60MinutesTicket - Vydaj 60-minutoveho listka (MHD Poprad) Redmine task 11293

DelayConfig.xml

DelayConfig sluzi na zobrazovanie meskanie podla zvolencyh parametrov

Struktura konfiguracneho suboru je nasledovna :

<?xml version="1.0" encoding="iso-8859-1"?>
<DelayConfig>
        <!-- 
            TariffTime - calculate time from Tariff System - on bus stop calculate to departure from bus stop
            CalculatedTime - calculated time from real km and ...
        -->
        <DisplayDelay mode="CalculatedTime" gpsError="" betweenBusstopFormat="->%1" onBusstopFormat="--%1"/>
        <Advance advanceIndicator="+%1 ">
                <Level level="1" foreground="000000" background="FF0CFF"  time="180" text="OK"/>
                <Level level="2" foreground="000000" background="FF2589" time="240"/>
        </Advance>
        <Delay delayIndicator="-%1" >
                <Level level="1" foreground="000000" background="00D418" time="180"/>
                <Level level="2" foreground="000000" background="FFC000" time="240"/>
                <Level level="3" foreground="000000" background="FFC0FF" time="320"/>
                <Level level="4" foreground="000000" background="FF2548" time="380"/>

        </Delay>
</DelayConfig>

Node DisplayDelay
  • mode - nastavenie modu zobrazovania meskania - TariffTime alebo CalculatedTime
    1. TariffTime - meskanie sa zobrazuje pomocu dat nast avenych v tarifnom systeme
    2. CalculatedTime - zobrqazuje sa meskanie vypocitane pomocu realnych kilometrov, priemernej rychlosti a vsemoznych vesmirnych konstant
  • gpsError - nastavenie indikacie chyby GPS. Zadava sa string, ktory chceme zobrazit
  • betweenBusstopFormat - nastavenie indikatora meskania medzi zastavkami - format “text %1 text” alebo “text %1” → vysledok “text 00:00 text” a v druhom pripade obdobne
  • onBusstopFormat - nastavenie indikatora meskania na zastavke - obdobne ako u betweenBusstopFormat
Node Advance
  • advanceIndicator - nastavenie indikacie nabehu - format ”+ %1” → vysledok ”+ 00:00”
Node Delay
  • delayIndicator - nastavenie indikacie meskania - format ”- %1” → vysledok ”- 00:00”
Node Advance/Delay Level
  • level - nastavenie ID levelu
  • foreground - farba popredia - zadava sa v html notacii ( RGB == “FFFFFF” → R=FF G=FF B=FF )
  • background - farba pozadia - zadava sa v html notacii ( RGB == “FFFFFF” → R=FF G=FF B=FF )
  • time - cas do ktoreho sa ma dany level pozivat v sekundach
  • text - doplnkovy text pre dany level ktory sa zobrazi za meskanim

exceptions.xml

Súbor exceptions.xml slúži pre definovanie rôznych výnimiek ako sú:

  • Zobrazovanie typu/podtypu karty definovaného zákaznikom a nie vstupnými dátami
<CardTypes companyID="406">
	<CardText cardType="4" cardSubType="1">Celá</CardText>
	<CardText cardType="5">Polovičná</CardText>
</CardTypes>

Karta so závodom 'companyID', typom karty 'cardType' a podtypom 'cardSubType' sa bude zobrazovať ako zadaný text. Súbor moze obsahovať sekcie pre každý závod. Atribút cardType je povinný, cardSubType je nepovinný.

  • Zmena zobrazovaneho cisla zony. Robi sa pomocou nodov ZoneMapping. Tieto nody su spolocne pre vsetky zavody. Atribut Zone je cislo zony v datach, a atribut ZoneUi urcuje, ako sa ma dana zona zobrazit.
<ZoneMapping Zone="235" ZoneUi="350"/>
<ZoneMapping Zone="230" ZoneUi="300"/>
  • Mapovanie cisla tarifnych listkov na ine cisla tarifnych listkov.
UTN - urban transport number, cislo MHD predaneho casoveho listka, vycitane z karty z CL
tariffTicketNumberFrom - cislo tarifneho listka, ktore pozadujeme premapovat. Cislo je vycitane z karty
tariffTicketNumberTo - cislo tarifneho listka, ktore sa pouzije pri vydaji listka namiesto cisla tarifneho listka vycitaneho z karty
  • Neuznavanie customer profilov na karte. Ak sa zhoduju vsetky tri parametre ( networkID, customerProfileIndex, customerProfileValue ), tak povazujem takyto customer profile za neplatny
networkID - network ID na karte
customerProfileIndex - index CP na karte
customerProfileValue - hodnota CP na karte
  • Obmedzenie paymentType pre konkretneho vydavatela karty. Ak sa zhoduju vsetky tri parametre (cardPublisher, ticketType, paymentType), tak neumoznim vydaj na takuto kartu.
cardPublisher - cislo vydavatela karty
ticketType - typ listka podla enum-u ETarifa::ETypListkaID
paymentType - typ platby podla enum-u EIssueLogicDefines::PaymentType

Tato vynimka je pouzita na obmedzenie dobitia kreditu z hotovosti na BMK. Pouzity riadok:

<CardPublisherIssueRestriction cardPublisher="108" ticketType="5" paymentType="0"/>
  • Blokovanie niektorych medii karty
DateFrom - datum od kedy ma byt medium karty blokovane (pocita sa od 00:00 daneho dna)
DateTo - datum do kedy ma byt kartove medium blokovane (pocita sa do 00:00 daneho dna, teda napr. do konca roka treba dat namiesto 20143112 do 20150101)
Company - zavod pre ktory ma byt kartove medium zablokovane
CardMedium - medium, ktore ma byt zablokovane (0-Old emtest mifare, 1-emtest Desfire, 2-VDVKa, 3-DesfireXT, 4-MifareMikro1, 5-MifareMikro2, 6-MifareIDOL)
IgnoreCardType - VOLITELNY ATRIBUT - typ karty, ktory ma byt pri kontrolu ignorovany
IgnoreCardSubType - VOLITELNY ATRIBUT - v pripade ze prilozeny typ karty je zhodny z 'IgnoreCardType' kontroluje sa v pripade nenulovej polozky aj podtyp karty
                  - V pripade potreby definovania viacerych podtypov, je to mozne pomocou oddelovaca/delimitera '|'
  • Vynimka upravujuca pocet zon

Vynimka pre plnenie poctu zon do Vypoctu ceny e.g → zona 215 sa rata za 3 zony ( pripocita sa 2 ), kombinacia zon 100 a 101 + akakolvek ina zona/zony do poctu zon sa pripocita 1.

ZonesCombination - kombinacia zon pre ktore sa ma uplatnit vynimka
CountCorrection - inkrementacia alebo dekrementacia poctu zon pre danu kombinaciu
  • Vynimka, zabezpecujuca zapisanie inej tarify na kartu ako je navolena tarifa
originalTariffTicketNumber - navolene cislo tarifneho listka vo vydaji aplikacie
tariffTicketNumberToCard - cislo tarifneho listka po zrekodovani. Tato tarifa sa zapise na kartu.

Vynimka, ktora zabezpecuje ze sa na kartu zapisuje ina tarifa ako je skutocne vydavana tarifa. V projekte BID maju cca 10/15 tarif a len tri sloty pre spolucestujucich na karte( 1. slot zakladny, 2. slot zlavneny, 3. batozina ). Z tohot dovodu sa tarify rozdelili do troch skupin a na zaklade tejto skupiny sa poznacuju tarify na kartu.

Obmezenia:

  1. Substituovane cislo tarifneho listka(tarifa) musi byt nastavene na rovnakej tarifnej skupine ako je cislo tarifneho listka 'originalTariffTicketNumber'
  2. Substituovane cislo tarifneho listka(tarifa) sa musi nachadzat na rovnakom type cennika
  • Zoznam zón, ktoré sú v zahraničí a lístok má kvôli nim nulovú sadzbu DPH
<ForeignZonesWithZeroVATValue>
	<Zone>190</Zone>  
</ForeignZonesWithZeroVATValue>

Zón môže byť ľubovoľný počet.

  • Ignorované čísla aplikacií mestských kariet
<CityCardApplicationsToIgnore>
    <Application>8</Application>
</CityCardApplicationsToIgnore>

Výnimka umožňuje ignorovať aplikáciu/aplikácie mestskej karty (nie regionálnej karty) v manuálnom výdaji (v autovýdaji je aplikácia nastavená štandardne a táto výnimka sa neuplatňuje).
Aplikácií môže byť ľubovoľný počet a aplikácia je zadávaná vždy vo forme n-tého bitu (index od 1).

Ukážka

<Exceptions>
	<CardTypes companyID="406">
		<CardText cardType="4" cardSubType="1">Celá</CardText>
		<CardText cardType="5">Polovičná</CardText>
	</CardTypes>
	<CardTypes companyID="455">
		<CardText cardType="5" cardSubType="1">Celá</CardText>
		<CardText cardType="4">Polovičná</CardText>
	</CardTypes>

	<ZoneMapping Zone="235" ZoneUi="350"/>
	<ZoneMapping Zone="230" ZoneUi="300"/>

	<TariffNumberMapping UTN="22" tariffTicketNumberFrom="27" tariffTicketNumberTo="147" />
	<TariffNumberMapping UTN="22" tariffTicketNumberFrom="28" tariffTicketNumberTo="148" />
                
	<CustomerProfileValidityException networkID="2111505" customerProfileIndex="0" customerProfileValue="3" />
	<CustomerProfileValidityException networkID="2111505" customerProfileIndex="0" customerProfileValue="7" />

	<!-- CardMedium: 1-Old emtest mifare, 2-emtest Desfire, 3-VDVKa, 4-DesfireXT, 5-MifareMikro1, 6-MifareMikro2, 7-MifareIDOL -->
	<ForbiddenCard DateFrom="20140630" DateTo="20250101" Company="1031" CardMedium="1" IgnoreCardType="7" IgnoreCardSubType="9|1|8"/>

	<ZoneCombinationCountCorrection ZonesCombination="215" CountCorrection="2"/>
	<ZoneCombinationCountCorrection ZonesCombination="100,101,*" CountCorrection="1"/>

	<RecodeSelectedTariffToCard originalTariffTicketNumber="15" tariffTicketNumberToCard="56"/>

	<ForeignZonesWithZeroVATValue>
		<Zone>190</Zone>  
	</ForeignZonesWithZeroVATValue>

        <CityCardApplicationsToIgnore>
            <Application>8</Application>
            <Application>9</Application>
        </CityCardApplicationsToIgnore>
</Exceptions>

Súbor sa bude brať z externých dát, ak nebude existovať skúsi sa /opt/emtest/etc/hlavny/ ak ani tam nebude existovať považuje sa za nedefinovaný.

Príklad (DPMKE)

<Exceptions>
<ForbiddenCard DateFrom="20140801" DateTo="20150101" Company="1031" CardMedium="1" IgnoreCardType="3" IgnoreCardSubType="0|3|6"/>
<ForbiddenCard DateFrom="20150101" DateTo="20250101" Company="1031" CardMedium="1"/>
</Exceptions>

Od 1.8.2014 do 31.12.2014 sa blokujú všetky Mifare Classic karty vydavateľ 1031 okrem typu 3 podtypov 0, 3 a 6. Od 1.1.2015 sa blokujú všetky. (DateTo musí byť do 1.1.2015 inak by sa 31.12.2014 karty neblokovali)

CompaniesConfig.xml

Vzhladom ku tomu, ze si zavody medzi sebou uznavaju karty a potrebuju mat rozne ceny listkov pre svoj a pre cudzie karty, pouziva sa nasledovny mechanizmus. Subor CompaniesConfig.xml sluzi na definovanie cisel domacich a cudzich zavodov. Ak je spracovavana karta domaceho zavodu tak sa vyrata cena zo stlpca domace zavody a ak aplikacia vyhodnoti kartu ako cudziu, aplikacia vyrata cenu zo stlpca pre cudzie zavody. Ak ceny pre domace a cudzie zavody nie su nadefinovane vo vstupnych datach, prejavi sa to ako aplikacna chybova hlaska: CHYBA VYDAJA LISTKA.

Popis k systemu domacich a cudzich zavodov sa nachadza na ceste:

Dokumentacia/Projekty_ISO/02_PlatobnySystem-Intel/VseobecneAnalyzy/01_SpolocneVlastnostiCitackyAPalubnehoPocitaca/SpolocneVlastnostiCitackyAPalubnehoPocitaca*.pdf

Primarne sa subor na strojceku nachadza na ceste /opt/emtest/var/spool/incoming, sekundarne na ceste: /opt/emtest/etc/hlavny.

Ak ma zavod uznavat cudzie karty v automatickom vydaji, nie je dostatocne mat povoleny zavod v KeyData.dat, ale je potrebne aj nadefinovat pre tento cudzi zavod v CompaniesConfig-u sekciu:

<Corporate Number="identifikator_zavodu" Name="Skratka nazvu zavodu" >
     <Department Number="cislo_domaceho_zavodu" />
     <Department Number="cislo_cudzieho_zavodu" />
</Corporate>

Jednotlive polozky predstavuju:

  • Corporate number - predstavuje spolocny identifikator (lubovolne cislo - je zauzivane pravidlo ze sa pouzije cislo zavodu sidla spolocnosti).
  • Department number - predstavuje identifikator zavodu (cislo zavodu) vycitaneho z cipovej karty, resp. nastaveneho na zariadeni.
  • Name - predstavuje skratku nazvu spolocnosti zobrazovanu miesto cisla (napr. Zilina je “ZA”).

Postup vyhodnotenia domaceho / cudzieho zavodu karty

  1. Vycita sa 'corporate number (cislo sidla)' pre KARTU na zaklade cisla zavodu (department number) na karte.
  2. Vycita sa 'corporate number (cislo sidla)' pre ZARIADENIE na zaklade cisla zavodu ulozeneho vo vstupnych datach v ESetFirma v polozke cisloZavoduStrojcek.
  3. porovnaja corporate number pre kartu a zariadenie a ak sa:
    • zhoduju - karta je prehlasena za domacu kartu,
    • nezhoduju - karta je prehlasena za cudziu kartu.

Ukazka konfiguracneho suboru

<!-- Definovanie domacich zavodov -->
<CompaniesConfig>
     <Corporate Number="15" Name="ZA">          <!-- domace cislo zavodu. Je zauzivane previdlo ze prve cislo predstavuje domace cislo zavodu -->
          <Department Number="1"/>   <!-- uznavane domace cislo zavodu -->
          <Department Number="912"/> <!-- uznavane domace cislo zavodu -->
          <Department Number="902"/> <!-- uznavane domace cislo zavodu -->
          <Department Number="902"/> <!-- uznavane domace cislo zavodu -->
     </Corporate>
     <Corporate Number="16" Name="BA"> <!-- Name reprezentacia cisla zavodu zobrazuje sa v card infe>
          <Department Number="908"/> 
     </Corporate>
</CompaniesConfig>
<!-- Sposob znamy ako vsetinske groupy, neviem naco sa pouzivaju ale pri prerabke to bola podobna funkcionalita a bola presunuta do CompaniesConfig.xml -->
<Groups>
        <Group Name="1"> <!-- Zavod 1 -->
                <Company Number="403"/>
                <Company Number="404"/>
                <Company Number="405"/>
                <Company Number="409"/>
                <Company Number="423"/>
                <Company Number="465"/>
        </Group>
        <Group Name="2"> <!-- Zavod 2 -->
                <Company Number="419"/>
                <Company Number="438"/>
        </Group>
</Groups>

Starsi sposob bol (uz sa nepouziva):

<CompaniesConfig>
  <HomeCompany>
	 <HomeCompany Number="825"/>
   </HomeCompany>
</CompaniesConfig>

V tomto konfiguracnom subore je mozne nadefinovat aj grupy (vyuzivane vo vsetine)

Keyboard.xml

Konfiguracny subor pre virtualnu klavesnicu na Vesne. Definuje ktoré klavesy budu zobrazene a ako budu rozlozene.

Konfiguracny subor ma strukturu:

<Keyboard>
	<KeyboardLayout LayoutName="Default">
		<KeyboardRow>
			<KeyArray KeyPrimaryCharacter="0123456789" KeySecondaryCharacter="ľščťžýáíéú" KeySize="2"></KeyArray>
		</KeyboardRow>
		<KeyboardRow>
			<KeyArray KeyPrimaryCharacter="qwertyuiop" KeySecondaryCharacter="QWERTYUIOP" KeySize="2"></KeyArray>
		</KeyboardRow>
		<KeyboardRow>
			<Key KeyType="SPACER"></Key>
			<KeyArray KeyPrimaryCharacter="asdfghjkl" KeySecondaryCharacter="ASDFGHJKL" KeySize="2"></KeyArray>
		</KeyboardRow>
		<KeyboardRow>
			<Key KeyType="SPACER" KeySize="2"></Key>
			<KeyArray KeyPrimaryCharacter="zxcvbnm" KeySecondaryCharacter="ZXCVBNM" KeySize="2"></KeyArray>
			<Key KeyType="BACKSPACE" KeySize="4"></Key>
		</KeyboardRow>
		<KeyboardRow>
			<Key KeyType="SHIFT" KeySize="4"></Key>
			<Key KeyPrimaryCharacter="20" KeySize="12"></Key>
			<Key KeyType="SHIFT" KeySize="4"></Key>
		</KeyboardRow>
	</KeyboardLayout>
</Keyboard>

Popis jednotlivych elementov:

  • KeyboardLayout - vramci konfigu je mozne definovat rozlozenie viacerych klavesnic, ktore budu pouzite v aplikacii, pripadne vieme definovat klavesnice pre rozne jazykove mutacie
LayoutName - zatial sa v aplikacii pouziva len rozlozenie "Default"
  • KeyboardRow - element, ktory v sebe zgrupuje jednotlive klavesy v lednom riadku (nema ziadne atributy)
  • Key - element pre jednu klavesu
KeySize               - urcuje velkost klavesy
                      - pomocou vhodne zvolenej velkosti vieme docielit posun klaves medzi roznymi riadkami napr o pol klavesy (klavese v 1 riadku nastavime velkost 2, do druheho riadku vlozime spacer a zan klavesu znova s velkostou 2 - klavesy budu rovnako velke, ale posunute o polovicu sirky klavesy)
KeyType               - urcuje typ klavesy (CHARACTER - znak, SHIFT - klavesa na prepinanie primarneho/sekundarneho vyznamu klavesy, BACKSPACE - klavesa backspace, SPACER - klavesa, ktora nebude zobrazena v layoute, sluzi len na dodatocne zarovnanie klaves)
KeyPrimaryCharacter   - cislo v unicode tabulke v hexa tvare pre primarny znak priradeny ku klavese "znakoveho" typu
                      - aby bolo mozne vlozit aj znaky, ktore by mohli sposobovat problemy napr pri parsovani konfigu ("), je nutne v pripade, ze definujeme jednotlivu klavesu zadat znak vo forme cisla v hexadecimalnom tvare
KeySecondaryCharacter - cislo v unicode tabulke v hexa tvare pre sekundarny znak priradeny ku klavese "znakoveho" typu
  • KeyboardRow - element pre pole znakovych klaves
KeyPrimaryCharacter   - primarne znaky jednotivych klaves bez oddelovania
KeySecondaryCharacter - sekundarne znaky jednotivych klaves bez oddelovania (nie je mozne v tomto pripade zadat cislo znaku v unicode tabulke)
KeySize               - urcuje relativnu velkost klaves (nie je mozne nastavit roznu velkost pre jednotlive znaky)

restrictedzones.xml

Sluzi na definovanie obmedzeni pre zony.

RestrictedZoneColection - takuto kombinaciu zon nie je mozne predat - ide ale o presnu zhodu, cize:

RestrictedZoneColection [100, 99]:
zoneList [99,100] = restricted
zoneList [99,100,101] = ok

RestrictedZoneColectionAlsoAsSubset - takuto kombinaciu zon nie je mozne predat - nemusi ist o presnu zhodu, cize:

RestrictedZoneColection [100, 99]:
zoneList [99,100] = restricted
zoneList [99,100,101] = restricted

Pozn.: sekcia sa môže ľubovoľný počet krát opakovať v súbore

RequiredZoneColection - zony v kolekcii sa mozu predavat iba zadanou kombinaciou

RequiredZones - Umoznuje pre nejaku zonu definovat dalsiu/dalsie zony, v kombinacii s ktorymi musi byt predavana. Napriklad v BID zónu 190 mozne zakupit len so 100+101.

ZonesProhibitedToBeSoldAlone - zoznam zon, ktore nie je mozne predat samostatne

ZonesPermittedOnlyInContinuousSections - zoznam zon, ktore je mozne predat len ako sucast spojiteho useku (spojity usek = zony su susediace)

IDS ZSK (zony 99 a 101 su susedne, zony 99 a 200 nie su susedne)
ZonesPermittedOnlyInContinuousSections [99]:
zoneList [99,200] = restricted
zoneList [99,101] = ok
zoneList [99,101,200] = ok

RestrictedZonesForPresale - zoznam zon, ktore nie je mozne predavat v predpredaji

Vzorove xml

<?xml version="1.0" encoding="iso-8859-1"?>
<RestrictedZone>
     <!-- kombinaciu zon 71,45 nedovoli predat spolu -->
     <RestrictedZoneColection>
          <RestrictedZone>71</RestrictedZone>
          <RestrictedZone>45</RestrictedZone>
     </RestrictedZoneColection>

     <!-- zona 100,101 sa musia predavat spolu nedovoli predat zonu 100,101 osobitne -->
     <RequiredZoneColection>
         <RequiredZone>100</RequiredZone>
         <RequiredZone>101</RequiredZone>
     </RequiredZoneColection>

     <!-- zonu 190 je mozne predat jedine v kombinacii so zonami 100 a 101 -->
     <RequiredZones zone="190">
         <RequiredZone>100</RequiredZone>
         <RequiredZone>101</RequiredZone>
     </RequiredZones>

     <!-- zonu 99 nie je mozne predat samostatne - jedine v kombinacii s inou zonou -->
     <ZonesProhibitedToBeSoldAlone>
         <Zone>99</Zone>
     </ZonesProhibitedToBeSoldAlone>

     <!-- zonu 99 je mozne predat jedine v pripade, ze je sucastou spojiteho useku -->
     <ZonesPermittedOnlyInContinuousSections>
         <Zone>99</Zone>
     </ZonesPermittedOnlyInContinuousSections>

     <!-- ziadnu z vymenovanych zon nie je mozne predat v predpredaji -->
     <RestrictedZonesForPresale>
	 <RestrictedZone>199</RestrictedZone>
         <RestrictedZone>599</RestrictedZone>			
     </RestrictedZonesForPresale>
</RestrictedZone>

conf.xml

Sluzi na nastavenie parametrov pre hardver a aplikacie, ktore ostavaju po nahrati aplikacie nezmenene

Konfiguracny subor sa vytvori prvy krat pri nahrati aplikacie z konfiguracneho suboru conf_default.xml, ktory sa nachadza v baliku aplikacie s prednastavenymi hodnotami

<config>
        <ver>1</ver>

        <!-- Nastavenie parametrov hlasitosti pouzivanych zariadeni a vsetkych zvukovych kanalov-->
        <sound>
                <volume>
                        <!-- 
                         Nastavenie hlasitosti interneho, externeho a kanala vodica.
                         min - urcuje minimalnu nastavielnu hodnotu obsluhou
                         max - urcuje maximalnu nastavitelnu hodnotu obsluhou
                         Hodnota urcuje aktualne nastavenu uroven hlasitosti jednotliveho kanala
                        -->

                        <internal min="60" max="90">80</internal>
                        <external min="60" max="90">80</external>
                        <driver min="60" max="90">80</driver>

                        <!-- Nastavenie urovni hlasitosti pre zariadenie konektel -->
                        <konektel>5</konektel>
                </volume>

                <!-- 
                 1 - pri prehravani zvukovych suborov cez interny kanal sa prehraju zvukove stopy na citackach pomocou skriptu 'copy_and_play_mp3_on_slave.sh'
                 0 - (defaultna hodnota) - hlasenie zvukovych stop sa prehrava pomocou interneho kanalu na reproduktoroch vo vozidlach
                -->
                <playSoundOnSlaves>1</playSoundOnSlaves>
        </sound>

        <!-- Nastavenie parametrov displeja vsetkych zariadeni
        <display>
                <!-- Hodnota urcuje intenzitu kontrastu na displeji zariadenia-->
                <contrast>58</contrast>

                <!-- Hodnota urcuje intenzitu jasu na displeji zariadenia -->
                <jas>60</jas>

                <!-- Hodnota urcuje, za kolko sa ma zapnut setric obrazovky pri necinnosti zariadenia -->
                <screensaver>0</screensaver>

                <!-- Hodnota urcuje nastavenie kontrastu na LCD displeji na ultralight tlaciarni-->
                <ContrastUltraLight>80</ContrastUltraLight>

                <!-- 
                1 - automaticke nastavenie urovne jasu na zariadeni pomocou senzoru
                0 - (defaultna hodnota) - nastavenie urovne jasu je pomocou manulaneho nastavenia obsluhou
                -->
                <automaticBrightnessControl>1</automaticBrightnessControl>
        </display>

        <!-- Hardverove nastavenie klavesnice-->
        <kblight>
                <Mode>1</Mode>
                <Illumination>50</Illumination>
        </kblight>
</config>

einfobox.xml

Sluzi na nastavenie pozicie ikon v informacnom panele aplikacie (horna lista).

Ukazka konfiguracneho suboru:

<EInfoBox Note="info icons configuration file">
    <Head>
	<Info Version="1.00" Date="03.01.2008"/>
    </Head>
    <EInfoIcon position="6" name="IconReceiveMessage" />
    <EInfoIcon position="5" name="KeyboardLock" />
    <EInfoIcon position="4" name="GPRSIndication" />
    <EInfoIcon position="3" name="WifiStrength" />
    <EInfoIcon position="2" name="DataIndication" />
    <EInfoIcon position="1" name="SystemState" />
</EInfoBox>

position [int] - pozicia ikony smerom od praveho okraja do lava

name [string] - nazov ikony, tento nazov sa pouziva v zdrojovom kode pri inicializovani objektu triedy EInfoIcon - einfoicon.h

SystemState - indikacia stavu systemu
CommandSelectionMode - 
Euro - 
DataIndication - 
VoipIndication - 
GPRSIndication - indikacia gprs spojenia
WifiStrength - indikacia wifi signalu
IconReceiveMessage - indikacia prijatych sms sprav
KeyboardLock -  
InterConnectionstatement - 

ButtonMap.xml

Tento subor sluzi na citackach (pouzivajucich direct FB) na mapovanie tlacidiel vyberu tarify ku konkretnej kombinacii tarify a riadku cennika. Napr. ze prva tarifa s prvym riadkom cennika bude priradena k tlacidu 0, prva tarifa s druhym riadkom cennika k tlacidlu 1, atd.

Subor sa nacitava z rovnakeho umiestnenia, ako konfiguracne subory UI-ciek. Teda bud z ”/opt/emtest/etc/ui/”, alebo z externych dat na ceste ”/opt/emtest/var/spool/incoming/ui/”.

Ukazka suboru:

<ButtonMap>
	<Window Name="FellowTravellersSelection">
		<Layout>
			<Button ID="0" Tariff="1" PriceListRow="1"/>
			<Button ID="1" Tariff="2" PriceListRow="1"/>
			<Button ID="2" Tariff="1" PriceListRow="2"/>
			<Button ID="3" Tariff="2" PriceListRow="2"/>
		</Layout>
		<Layout IDS="1" TariffGroupID="1">
			<Button ID="0" Tariff="1" PriceListRow="1"/>
			<Button ID="1" Tariff="2" PriceListRow="1"/>
			<Button ID="2" Tariff="1" PriceListRow="2"/>
			<Button ID="3" Tariff="2" PriceListRow="2"/>
		</Layout>
		<Layout IDS="1" TariffGroupID="2">
			<Button ID="0" Tariff="1" PriceListRow="1"/>
			<Button ID="1" Tariff="2" PriceListRow="1"/>
			<Button ID="2" Tariff="1" PriceListRow="2"/>
			<Button ID="3" Tariff="2" PriceListRow="2"/>
		</Layout>
		<Layout IDS="2" TariffGroupID="3">
			<Button ID="0" Tariff="1" PriceListRow="1"/>
			<Button ID="1" Tariff="2" PriceListRow="1"/>
			<Button ID="2" Tariff="1" PriceListRow="2"/>
			<Button ID="3" Tariff="2" PriceListRow="2"/>
		</Layout>
	</Window>
	<Window Name="ManualIssue">
		<Layout>
			<Button ID="0" Tariff="1" PriceListRow="1"/>
			<Button ID="1" Tariff="2" PriceListRow="1"/>
			<Button ID="2" Tariff="1" PriceListRow="2"/>
			<Button ID="3" Tariff="2" PriceListRow="2"/>
		</Layout>
	</Window>
</ButtonMap>

Definicia rozlozeni tlacidiel

Rozlozenie tlacidiel sa definuje samostatne pre kazde okno s tlacidlami. Na tento ucel sluzi tag <Window> s parametrom Name, ktory urcuje nazov okna.

Pre kazde okno mozno definovat niekolko roznych rozlozeni v zavislosti od cisla IDS a pouzitej tarifnej skupiny. Na definiciu rozlozenia sa pouziva tag <Layout> s parametrami IDS (cislo IDS) a TariffGroupID (cislo pouzitej tarifnej skupiny). Ak niektory z parametrov nie je zadany, povazuje sa jeho hodnota za 0. Ak ma parameter IDS hodnotu 0, znamena to, ze dane rozlozenie bude pouzite ako vychodzie (pouzije sa v pripade, ze sa nenajde rozlozenie s aktualnym cislom IDS, a v projektoch bez nastavenej IDS). Rovnako funguje aj hodnota parametra TariffGroupID.

Kazde rozlozenie (Layout) obsahuje znoznam vsetkych tlacidiel s informaciou, ktora tarifa patri ku ktoremu tlacidlu. Na definiciu tlacidla je pouzity tag <Button> s parametrami:

  1. ID (identifikacne cislo tlacidla tak, ako je nadefinovane v xml subore prislusneho okna, rozsah je od 0 do 9),
  2. Tariff (poradove cislo tarify tak, ako sa nacita z cestovneho poriadku, zacina od 1). Pod pojmom poradove cislo tarify sa rozumie tarifa v zozname tarif na aktualnej tarifnej skupine vo stupnych datach( zoznam tarif je usporiadany vzostupne podla cisla tarifneho listka ), ktora ma nastaveny 'Predaj na citacke'.
  3. PriceListRow (cislo riadku cennika).

Postup aplikacie pri vybere pouziteho rozlozenia

Priklad postupu vyberu rozlozenie ak cislo IDS je 2 a cislo tarifnej skupiny je 3:

  • Najskor sa v pouzitom okne hlada rozlozenie s konkretnym cislom IDS a tarifnej skupiny, cize v tomto priklade by to bol tag:
<Layout IDS="2" TariffGroupID="3">
  • Ak sa take rozlozenie nenajde, hlada sa vychodzia tarifna skupina na pouzitej IDS:
<Layout IDS="2" TariffGroupID="0"> alebo <Layout IDS="2">
  • Ak sa take rozlozenie nenajde, hlada sa pouzite cislo tarifnej skupiny na vychodzej IDS:
<Layout IDS="0" TariffGroupID="3"> alebo <Layout TariffGroupID="3">
  • Ak sa nenajde ani take rozlozenie, hlada sa vychodzie rozlozenie nezavisle od IDS a cisla tarifnej skupiny:
<Layout IDS="0" TariffGroupID="0"> alebo len <Layout>

FWUpdateConfig.xml

Pre update/downgrade firmware-u na zariadeniach sluzi binarka UpdateFirmwares, ktora sa nachadza v repozitari 'VehicleSystemUtils'

<FWUpdateConfig Note="Update firmware config">
        
        <!-- sekcia ciest -->  
        <Paths>        
                <!-- cesta kde sa budu hladat binarky firmwarov. Ak nie je specifikovana, pouzije sa defaultna cesta
                     - defaultna ARM cesta je: /opt/emtest/var/spool/incoming
                     - defaultna 386 cesta je: /opt/devel/var/lib/updatefw -->
                <FirmwareFiles Path="/opt/emtest/var/spool/incoming"/>

                <!-- cesta kde je ulozeny HwConfig -->
                <HwConfig File="/opt/emtest/etc/hlavny/HwConfig.xml"/>
        </Paths>

        <!-- sekcia zariadeni -->
        <Devices>
                <!-- zariadenie ktore sa ma updatovat -->

                <Device Name="Printer" Type="Net" FwFile="firmware.pr">
                <!-- tieto nody sa budu hladat v kazdom node HwConfigu, ak sa budu zhodovat v nejakom node bude sa z tohto nodu brat adresa ktora ma "meno" IP_PIC-->
                        <HwConfigAttributes Name="Printer" Type="UL"/>
                        <Substitute Address="IP_PIC"/>
                </Device>

                <!-- Rozvodna doska emtest (stara) -->
                <Device Name="SwitchBoard" FwFile="^RozvodnaDoska.*\.BIN$" FwHeadFile="^head_RozvodnaDoska.*\.BIN$">
                        <Properties Address="96"/>
                </Device>

                <!-- Nove rozvodne dosky (TDCB) -->
                <Device Name="ConnBoardTransData" FwFile="TDCB_.*\_FW_v.*\.bin">
                    <Properties Address="96"/>
                </Device>

                <!-- Predne + Bocne tabule, popis adries: etabledriverheader.h -->
                <Device Name="TableMchip" FwFile="FW_TABLE.T1">
                        <Properties Address="64"/> <!-- FRONT1 -->
                        <Properties Address="71"/> <!-- FRONT2 -->
                        <Properties Address="65"/> <!-- SIDE1 -->
                        <Properties Address="67"/> <!-- SIDE2 -->
                        <Properties Address="72"/> <!-- SIDE3 -->
                        <Properties Address="73"/> <!-- SIDE4 -->
                </Device>

                <!-- Vnutorne tabule, popis adries: etabledriverheader.h  -->
                <Device Name="TableMchip" FwFile="FW_TABLE.T2">
                        <Properties Address="66"/> <!-- INNER1 -->
                        <Properties Address="69"/> <!-- INNER2 -->
                        <Properties Address="74"/> <!-- INNER3 -->
                </Device>

                <!-- Zadne tabule, popis adries: etabledriverheader.h  -->
                <Device Name="TableMchip" FwFile="FW_TABLE.T3">
                        <Properties Address="68"/> <!-- REAR1 -->
                        <Properties Address="70"/> <!-- REAR2 -->
                </Device>

                <Device Name="PrinterMikroelektronikaOcc">
                        <HwConfigAttributes Name="Printer" Type="MIKROELEKTRONIKAOCC"/>
                        <Substitute Address="IP"/>
                </Device>
        </Devices>
</FWUpdateConfig>

Table - Device pre tabule postavene na fujitsu procesore - nepodporovane zariadenie

TableMchip - Device pre tabule postavene na PIC procesore. Pre device je potrebne specifikovat adresu pomocou atributu Address v node Properties

SwitchBoard - emtest rozvodky (stare)

ConnBoardTransData - TransData rozvodky (nove), subor s firmware musi mat nazov v tvare “TDCB_<lubovolne znaky>_FW_v<lubovolne znaky>.bin”, napr. “TDCB_180101_FW_v2.bin”

PrinterMikroelektronikaOcc - Mikroelektronika tlačiareň OCC/OCP

TableSpecialTexts.xml

konfigurak na nastavenie specianych textov cez menu ( CMDShowSpecialTextOnTable ). Pre spravne zobrazovanie musi byt subor v kodovani utf-8 a musi to byt deklarovane v havicke suboru

Atributy positionY a font-size sa zadavaju podla rovnakych podmienok ako v rezime mimo vydaja v tabule.xml.

<?xml version="1.0" encoding="utf-8"?>
<texts>
    <text positionY="13" font-size="4">Prejazd</text>
    <text positionY="13" font-size="4">Svadba</text>
    <text positionY="13" font-size="4">Manipulačná jazda</text>
</texts>

LCDDisplay.xml

Konfiguračný súbor definujúci, čo má zobrazovať LCD display na tlačiarni (EMtest UL tlačiarni, alebo Mikroelektronika OCC)

<LCDDisplay>
  
    <!-- legacy section for EMTest UL LCD and old mijola driver -->
    <State name="StateApproachCard" id="0">
	<Text name="tariff" x="0" y="0" font-size="12" align="HCenter"/>
	<Text name="price" x="0" y="20" font-size="20" align="HCenter"/>
	<Text name="card_approach" x="0" y="48" font-size="12" align="HCenter"/>
    </State>
    <State name="StateInIssue" id="1">
	<Text name="date" x="0" y="0" font-size="12" align="Left"/>
	<Text name="time" x="0" y="0" font-size="12" align="Right"/>
	<Text name="station" x="0" y="12" font-size="10" align="Center" wrap-text="1"/>
    </State>
    <State name="StateOutIssue" id="2">
	<Text name="date" x="0" y="0" font-size="12" align="Left"/>
	<Text name="week_day" x="0" y="0" font-size="12" align="Right"/>
	<Text name="time" x="0" y="12" font-size="24" align="Center"/>
    </State>
	
    <DeviceType type="OCC" width="320" height="240" font-color="#33BBF0" background-color="#202020">
	<State name="StateApproachCard" id="0">
	    <Text name="tariff" x="0" y="0" font-size="40" align="HCenter"/>
	    <Text name="price" x="0" y="80" font-size="60" align="HCenter"/>
	    <Text name="card_approach" x="0" y="180" font-size="36" align="HCenter"/>
	</State>
	<State name="StateInIssue" id="1">
	    <Text name="date" x="5" y="5" font-size="24" align="Left"/>
	    <Text name="time" x="160" y="5" width="155" height="30" font-size="24" align="Right"/>
	    <Text name="station" x="0" y="35" font-size="42" align="Center" wrap-text="1"/>
	</State>
	<State name="StateOutIssue" id="2">
	    <Text name="date" x="5" y="5" font-size="24" align="Left"/>
	    <Text name="week_day" x="160" y="5" width="155" height="30" font-size="24" align="Right"/>
	    <Text name="time" x="0" y="12" font-size="48" align="Center"/>
	</State>
    </DeviceType>
  
</LCDDisplay>

Obsahuje sekciu DeviceType type=“XXX” pre každé podporované zariadenie, kde type korešponduje s typom v HwConfig.xml. Sekcia pre EMtest UL LCD nie je zapuzdrená v tejto sekcii z dôvodu spätnej kompatibility. (Keď prestane byť táto kompatibilita dôležitá, je možné aj túto sekciu zapúzdriť, aplikačný driver je na to pripravený.)

Očakáva sa, že každé zariadenie bude obsahovať zadefinované 3 stavy (id je potrebné dodržať):

  1. StateApproachCard id=“0” - výzva na priloženie karty (pri zakupovaní lístka z elektronickej peňaženky napr.)
  2. StateInIssue id=“1” - obrazovka, ktorá je zobrazená počas výdaja
  3. StateOutIssue id=“2” - obrazovka, ktorá je zobrazená mimo výdaja

Každý stav môže obsahovať ľubovoľný počet preddefinovaných textov

Zoznam preddefinovaných textov

  • tariff - názov vydávanej tarify
  • price - cena
  • card_approach - výzva na priloženie karty
  • date - aktuálny dátum
  • time - aktuálny čas
  • week_day - deň v týždni
  • station - názov aktuálnej zastávky
  • checkout_busstop - názov výstupnej zastávky (ak nie je známa, ako napríklad pri vklade na kartu, použije sa názov nástupnej zastávky)

Popis atribútov:

DeviceType:

  • type - typ LCD zariadenia - očakáva ten istý reťazec, ktorý je uvedený v HwConfig.xml
  • width - udáva šírku displaya v pixeloch. Kvôli spätnej kompatibilite je možné tento atribút vynechať (xml pre EMtest UL tlačiareň ho neobsahovalo) a v takomto prípade sa použije širka EMtest UL displaya 128 px
  • height - udáva výšku displaya v pixeloch. Kvôli spätnej kompatibilite je možné tento atribút vynechať (xml pre EMtest UL tlačiareň ho neobsahovalo) a v takomto prípade sa použije výška EMtest UL displaya 64 px
  • font-color - určuje prednastavenú farbu písma pre toto zariadenie. Obsahuje RGB kód farby vo formáte ”#RRGGBB”. Je nepovinny, predvolená farba je čierna.
  • background-color - určuje prednastavenú farbu pozadia pre toto zariadenie. Obsahuje RGB kód farby vo formáte ”#RRGGBB”. Je nepovinný - predvolená farba je biela.

State:

  • name - nepovinný atribút, slúži iba na lepšiu čitateľnosť konfiguračného súboru
  • id - identifikátor stavu (viď zoznam definovaných stavov)
  • backgroud-color - Určuje farbu pozadia obrazovky v danom stave. Obsahuje RGB kód farby vo formáte ”#RRGGBB”. Je nepovinný - ak nie je vyplnený, použije sa prednastavná farba pozadia pre toto zariadenie.

Text:

  • name - názov preddefinovaného textu - viď zoznam preddefinovaných textov
  • x - súradnica x ľavého horného rohu textového elementu
  • y - súradnica y ľavého horného rohu textového elementu
  • width - určuje šírku textového elementu. Má zmysel hlavne pri rôznych zarovnaniach textu - napr. zarovnanie napravo. Je nepovinný kvôli spätnej kompatibilite, prednastavená šírka elementu je šírka displaya mínus x.
  • height - určuje výšku textového elementu. Má zmysel hlavne pri rôznych zarovnaniach textu - napr. zarovnanie na stred. Je nepovinný kvôli spätnej kompatibilite, prednastavená výška elementu je výška displaya mínus y.
  • font-size - určuje veľkosť fontu
  • font-color - určuje farbu písma. Obsahuje RGB kód farby vo formáte ”#RRGGBB”. Je nepovinný - ak nie je vyplnený, použije sa prevolená farba písma tohto zariadenia.
  • wrap-text - obsahuje hodnotu 0 alebo 1. 0 znamená, že sa text nemá zalamovať, 1 znamená, že sa text má v prípade potreby zalomiť. Je nepovinný, predvolená hodnota je 0 - nezalamovať.
  • align - určuje zarovnanie textu v rámci textového elementu. Možné hodnoty sú prebraté z Qt a sú to tieto:
    • “Left” - horizontálne zarovnanie doľava
    • “Right” - horizontálne zarovnanie doprava
    • “HCenter” - horizontálne zarovnanie na stred
    • “Top” - vertikálne zarovnanie na vrch
    • “Bottom” - vertikálne zarovnanie na spodok
    • “VCenter” - vertikálne zarovnanie na stred
    • “Center” - horizontálne aj vertikálne zarovnanie na stred

cfgCANValue.xml

Konfiguračný súbor pre definíciu vyčítavaných hodnôt z CAN zbernice

<CfgCANValueCol>
    <CfgCANValue>
	<ID>1</ID>
	<Name>Motor otacky</Name>
	<Do>1</Do>
	<MaxAge>30</MaxAge>
    </CfgCANValue>

    <CfgCANValue>
	<ID>2</ID>
	<Name>Rychlost</Name>
	<Do>1</Do>
	<MaxAge>30</MaxAge>
    </CfgCANValue>

    ...

<CfgCANValueCol>

Kde:

  • ID - jednoznačná identifikácia hodnoty z CAN. Definované sú nasledovné hodnoty:
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
EM_TEPLOTA_1_LONG_VALUE         = 50 (exteriérová teplota)
EM_TEPLOTA_2_LONG_VALUE         = 51 (interiérová teplota)
EM_USER_01_LONG_VALUE           = 52 (klimatizácia )
EM_USER_02_LONG_VALUE           = 53 (nezávislé kúrenie)

  • Name - názov položky - slúži iba pre lepšiu čitateľnosť konfiguračného súboru
  • Do - 1 = spracováva sa, 0 = nespracováva sa.
  • MaxAge - ak nepríde hodnota dlhšie ako maxAge, tak sa vykoná zneplatnenie (0 - necháva sa posledná platná, nezneplatňuje sa)
  • X - korekcia, ktorou sa vyčítaná hodnota násobí (defaultná hodnota 1)
  • K - korekcia, ktorá sa k vyčítanej hodnota pripočítava (defaultná hodnota 0)
  • IPCWritePeriod - perióda zápisu do IPC v sekundách (defaultná hodnota 1s)
  • MaxSampleCount - maximálny počet vzoriek, ktoré sa zozbierajú pred zápisom (defaultná hodnota 64)

cfgEth2Can.xml

Konfiguračný súbor pre prevodník Ethernet/CAN zbernica (Eth2Can). Pri nábehu aplikácie CANDriver sa vyčíta aktuálna konfigurácia prevodníka a ak sa niektorá hodnota parametra z konfiguračného súboru líši od vyčítanej hodnoty, odošle sa prevodníku aktualizovaná konfigurácia.

<CfgEth2CanCol>
    <!-- Nakladni vozidla paterni CAN -->
    <CfgEth2Can>
        <ID>1</ID>
	<CanSpeed>8</CanSpeed>
	<ListenOnly>0</ListenOnly>
	<StExt>1</StExt>
    </CfgEth2Can>

    <!-- Nakladni vozidla FMS Brana. -->
    <CfgEth2Can>
        <ID>2</ID>
	<CanSpeed>8</CanSpeed>
	<ListenOnly>0</ListenOnly>
	<StExt>1</StExt>
	<Address>192.168.12.150</Address>
	<Port>3000</Port>
	<StartupTimeout>5</StartupTimeout>
	<ShutdownTimeout>5</ShutdownTimeout>
	<EthWatchdog>0</EthWatchdog>
	<AppStartTimeout>15</AppStartTimeout>
    </CfgEth2Can>
</CfgEth2CanCol>

Obsahuje n konfigurácií identifikovaných atribútom ID. Ktorá konfigurácia sa použije je určené parametrom cfgId pri spušťaní CANDriver:

CANDriver ... -cfgId 1 ...

Parametre, ktoré je možné nastaviť sú:

  • CanSpeed - rychlost CAN sběrnice, hodnoty:
Hodnota Rýchlosť
0 10k
1 20k
2 33.3k
3 50k
4 62.5k
5 83.3k
6 100k
7 125k
8 250k
9 500k
10 1M
  • ListenOnly -
    • 0 normální mód (připojení na FMS bránu)
    • 1 listen only mód (připojení na CAN bus vozidla, motorový CAN)
  • StExt
    • 0 standardní identifikátory
    • 1 rozšířené identifikátory
  • Address - IP adresa zařízení. Defaultně přednastavena na 192.168.12.150.
  • Port - TCP port na kterém probíhá komunikace. Defaultně 3000.
  • StartupTimeout - Opoždění aktivace zařízení po připojení signálu 15. Zpoždění eliminuje aktivaci zařízení při krátké aktivaci signálu 15. Čas nastavován v sekundách. ozsah 1..200s. Defaultně 5 s.
  • ShutdownTimeout - Opoždění deaktivace zařízení po odpojení signálu 15. Zpoždění eliminuje deaktivaci zařízení při krátkém vypnutí signálu 15. Čas nastavován v sekundách. Rozsah 1..200s. efaultně 5 s.
  • EthWatchdog - Timeout v sekundach. Pokud po uvedený čas není detekována aktivita klienta dojde k resetu zařízení. Je li nastavena hodnota 0, funkce není aktivní. Rozsah 20..300s.
  • AppStartTimeout - Čas po kterém je bootloader automaticky přepnut do aplikace pokud není přijat paket, který provádí změnu firmware .
  • Source - zdroj dát
    • “CAN” - defaultné nastavenie - vyčítava sa z CAN zbernice
    • “J1708” - vyčítava sa z J1708 zbernice (iný formát dát, hodnoty sú v anglosaských jednotkách)

cfgCANEventProcessor.xml

Konfiguračný súbor pre CANEventProcessor (súčasť aplikácie DataProcessor), ktorý slúži na sledovanie vybraných dát zo zbernice CAN. Procesor kontroluje, či sa sledovaná veličina zo zbernice CAN nachádza v povolenom intervale. Ak dojde k prekročeniu spodnej alebo vrchnej hranice, vytvorí sa o tom záznam.

<CfgCANEventProcessorCol>
    <CfgCANEventProcessor>
        <CfgCANEventProcessorID>101</CfgCANEventProcessorID>
	<Name>Otacky Motoru</Name>
	<Min>2000</Min>
	<Max>5500</Max>
	<Time>5</Time>
    </CfgCANEventProcessor>

    <CfgCANEventProcessor>
        <CfgCANEventProcessorID>102</CfgCANEventProcessorID>
	<Name>Teplota Motoru</Name>
	<Min>-10</Min>
	<Max>95</Max>		
	<Time>10</Time>
    </CfgCANEventProcessor>
</CfgCANEventProcessorCol>
  • CfgCANEventProcessorID - ID event processora, slúži na prepojenie so sledovanou hodnotou. Implementované sú iba dva event processory
CfgCANEventProcessorID Sledovaná hodnota
101 MOTOR_OTACKY_LONG_VALUE
102 MOTOR_TEPLOTA_LONG_VALUE
  • Name - Názov sledovanej veličiny. Iba pre lepšiu čitateľnosť konfiguračného súboru
  • Min - Najnižšia povolená hodnota
  • Max - Najvyššia povolená hodnota
  • Time - čas v sekundách, ktorý musí trvať prekročenie povoleného intervalu, aby sa o tom vytvoril záznam

PredpredajCfg.xml - Už neaktuálne, nastavenia boli presunuté do DB

Hlavný konfiguračný súbor pre PC Predpredaj.

Umiestnenie

Mal by byť umiestnený na lokálnej ceste:

c:\\WinAdo\\Predpredaj\\PredpredajCfg.xml

Ak sa na tejto ceste nenachádza, tak sa hľadá na alternatívnej ceste:

[adresár firmy nastavený v TransOffice]predpredaj\\PredpredajCfg_[používateľ na lokálnom počítači].xml

čiže napríklad: “\\ARES\WinADO_slovaklines\predpredaj\PredpredajCfg_benadik.xml”

Alternatívne umiestnenie bolo zapracované pre niektorého českého zákazníka, u ktorého viacerí klienti spúšťali PC Predpredpredaj na serveri.

Formát

<?xml version="1.0" encoding="utf-8"?>
<data data="c:\winado\predpredaj\data\" statistika="c:\winado\predpredaj\statistika\"   ... />

Atribúty

  • data - Cesta k vstupným dátam. Mala by obsahovať na konci lomítko. (Default hodnota “c:\\winado\\predpredaj\\data\\”)
  • statistika - Cesta k štatistike = odpočtom. Mala by obsahovať na konci lomítko. (Default hodnota “c:\\winado\\predpredaj\\statistika\\”)
  • IPAddress - IP adresa na ktorej beží SmartCardService (platobný). Ak sa používa ACR čítačka, treba nastaviť localhost (127.0.0.1).
  • IPPort - Port na ktorom beží SmartCardService (platobný). Zaužívaný port je 5687.
  • computerID - ID PC Predpredaja. Obdoba SNR strojčeka.
  • TlacUzavierka - Názov tlačiarne pre tlač počiatočného a koncového lístka. (Ide o názov tlačiarne zadaný pri jej inštalácii a pod ktorým figuruje v systéme. Preto je najlepšie ho nastavovať z PC Predpredaja, kde sú ponúknuté všetky dostupné tlačiarne.)
  • TlacListky - Názov tlačiarne pre tlač potvrdeniek. (Ide o názov tlačiarne zadaný pri jej inštalácii a pod ktorým figuruje v systéme. Preto je najlepšie ho nastavovať z PC Predpredaja, kde sú ponúknuté všetky dostupné tlačiarne.)
  • TlacPapierListky - Názov tlačiarne pre tlač lístkov = taríf, ktoré majú nastavenú vlastnosť 47 (papierový lístok). (Ide o názov tlačiarne zadaný pri jej inštalácii a pod ktorým figuruje v systéme. Preto je najlepšie ho nastavovať z PC Predpredaja, kde sú ponúknuté všetky dostupné tlačiarne.)
  • noveData - Príznak, či si má aplikácia pri štarte updatovať dáta zo servera. (0/1, 0 = neupdatovať, 1 = updatovať)
  • login - Osobné číslo obsluhy. Ukladá si ho sem aplikácia.
  • meno - Celé meno obsluhy. Ukladá si ho sem aplikácia.
  • EventFilePath - Cesta k udalostným súborom z eShopu. Mala by obsahovať na konci lomítko. (Default hodnota “c:\\winado\\predpredaj\\udalosti\\”)
  • EvFileWSURL - URL webslužby pre sťahovanie udalostných súborov z eShopu.
  • EvFileFirmNum - Číslo závodu, pre ktorý sa majú sťahovať udalostné súbory z eShopu.
  • WSTimeOut - Timeout pre komunikáciu s webslužbou na sťahovanie udalostných súborov z eShopu. V sekundách.
  • EventsInterval - Perióda pre update udalostných súborov z eShopu. V minutách.
  • EventFileResetPeriod - Perióda pre čistenie/reset udalostného súboru = po uplynutí tohto času sa celý súbor sťahuje od nuly. V dňoch. (Default hodnota 30)
  • TlacUzavierkaA4 - Príznak, či sa má koncový lístok tlačiť v A4 formáte. (0/1, 0 = klasický formát, 1 = formát A4). Ak je nastavená tlač v A4, používa sa šablóna KoncovyListokA4.xml.
  • ImportTicketWSURL - Nepoužíva sa, pôvodne pre českého zákazníka, ktorému sa lístky zapisovali do DB.

PanelMessages.xml

Konfiguračný súbor slúži na to, že definuje text správy, ktorý sa má zobraziť na vnútornej LCD tabuli spolu s prehratím mp3 súboru na pokyn vodiča

<PanelMessages>
    <PanelMessage SoundFile="Cakanie_podla_prikazu_dispecingu.mp3" Message="Čakanie podľa príkazu dispečingu"/>
    <PanelMessage SoundFile="Hlasenie_o_cistote_autobusu.mp3" Message="Hlásenie o čistote autobusu"/>
    <PanelMessage SoundFile="Nastup_nevidiaceho_cestujuceho.mp3" Message="Nástup nevidiaceho cestujúceho"/>
    ...
</PanelMessages>

Štruktúra je veľmi jednoduchá, atribút SoundFile obsahuje názov mp3 súboru, atribút Message text správy pre LCD tabuľu

 
dev_doc/configs.txt · Last modified: 2026/01/07 09:40 by 192.168.242.33
 
Recent changes RSS feed Creative Commons License Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki