View source for ChronoFly User's manual dev

You do not have permission to edit this page, for the following reason:
The action you have requested is limited to users in the group: Users.
You can view and copy the source of this page:
ChronoFly station program has been implemented in the Java language. It does not require an associate separate database. The only requirement for the use of the program is a Java Runtime Environment and for this reason the program works with nearly all operating systems. For more information, see article [[ChronoFly English|ChronoFly]].

The purpose of this document is to clarify the basic characteristics of the program, thus enabling you to arrange a successful competition.

==Cold start==
When the program starts the first time, it asks the license file and station identifier. You can choose any name as a station identifier and you can edit it later if needed. Necessary license files are supplied by Enymind.

==Before first competition==
Before the program are being examined it is important to familiarize with other necessary accessories and equippments of the competition site. More of these equippments in own articles.

It is possible to create competition settings required by the regulations beforehand, or alternatively, at a competition site. The either way is used, it is important to indicate the staff before the start of the competition. The program also remembers the old settings from the previous competition. In the case of the program's first start-up, the settings must be set before the actual operation of the program.

For more information, see [[#Configurations|Configurations]].

===Setting the time===
The time of the computer can be adjusted through ''Settings->Set time''. The more accurate the time, the more accurate results will be produced.

==Using the software==
===First start===
For launching the program has been created for necessary shortcuts on the desktop or alternatively on start menu, or both. The program is starting by double-clicking its icon. Start-up takes some time.

===Creating new competition===
If you want to create a new competition, or if a single race has not yet been created, a new competition can be created from the menu ''File->New competition''.

Competition are created with assistance of a easy wizard. For more information, see [[#Competition settings|Competition settings]].

====Import/Export files====
* Creating files, see: [[ChronoFly_Siirtotiedosto|Chronofly Siirtotiedosto]]
* Same file can be used in two ways:
:* Import preset times, ''File->Import files''
:* Import preset competitor related data during creating a new competition (AT-distance and time, class, etc..), ''Load rules from file''

* Import files '''only in <u>csv-format</u>'''. See more: [[ChronoFly_Siirtotiedosto#Esimerkki_CSV-tiedosto|Chronofly Siirtotiedosto, Esimerkki CSV-tiedosto]]

===Configurations===
If everything is configured beforehand, you can skip this step and go directly to: [[#Kilpailun aloittaminen|Kilpailun aloittaminen]].

====Station settings====
Use station settings to edit the settings of the program itself. In station settings there is not any competition related settings. Settings can be accessed from the menu ''Settings->Station settings''

'''General'''
* ''Station identifier'': Aseman yksilöivä tunniste, jokaisella asemalla tämä on oltava eri, jotta asemat voidaan tunnistaa.
* ''Language'': Ohjelman kieli.
: ''Default'': en_EN
* ''Table columns'': Näyät/piilota halutut sarakkeet
* ''License'': License information or file

'''Reader'''
* ''Device'': Lukijalaitteen ajuri. Valitaan sen mukaan, mitä lukijaa käytetään.

* ''Serial port'': Jos lukija on sarjaportin kautta liitettävä, asetetaan tähän käytettävä sarjaportti.

* ''Serial speed'': Käytettävän sarjaportin nopeus.
: ''Default'': 9600

* ''IP-address'': Jos lukija on ethernet-portin kautta liitettävä, asetetaan tähän lukijan osoite.

* ''TCP-port'': Ethernetissä käytettävä TCP-portti.

* ''Read gap'': Aika sekunteina, kuinka usein sama tagi luetaan lukukentästä.
: ''Default'': 60

* ''Antennas'': Käytettävät antennit (järjestelmissä, joissa useita antenneja)

* ''Transponder codec'': Muoto, jolla luettavat tunnisteet on kirjoitettu.
: ''Default'': DESIMAL

'''SMS messages'''
: Enabled / Disabled

* ''Number'': GSM-numero, johon tulokset lähetetään tekstiviestien avulla. Asetetaan kansainvälisessä muodossa +358XXYYYYYYY

* ''Rows per. message'': Määrittää kuinka monta aikaa yhden viestin mukana lähetetään. Jos käytetään tavallisia tekstiviestijä, maksimi on 10.

* ''Driver'': Ajuri viestien lähetykseen. Riippuu käyttöjärjestelmästä. Linuxissa <tt>smstools</tt>

* ''Message format'': Muoto, jossa viesti lähetetään. Riippuu vastaanottavasta päästä.

* ''Max wait time'': Viive sekunteina joka odotetaan, jonka jälkeen lähetetään silti, vaikka tarvittavaa rivimäärää aikoja ei ole kertynyt.
: ''Default'': 400

<div id="mista_ajat_tulevat">&nbsp;</div>
'''TCP/IP'''
: Enabled / Disabled
* ''IP-address'': Osoite, johon aikoja lähetetään ethernetin yli, esimerkiksi tulospalveluohjelmisto [[J2Chrono]].
* ''Protocol'': Muoto, jota käytetään aikojen lähettämiseen.
* ''Target'': Kohde, jodon data lähetetään ko. osoitteeseen. (Esim. http protokollissa: index -> 1.2.3.4/index.php)

'''Printer'''
: Enabled / Disabled

* ''Serial port'': Jos kirjoitin on sarjaportin kautta liitettävä, asetetaan tähän käytettävä sarjaportti.

* ''Protocol'': Käytettävä protokolla, eri tulostimelle omansa.

* ''Header'': Teksti, joka kirjoitetaan tulosteen yläreunaan.

* ''Footer'': Teksti, joka kirjoitetaan tulosteen alareunaan. (esim. keskeytysnumero 040 123 4321)

'''IR'''
: Enabled / Disabled

* ''Serial port'': Varmistuslaitteen sarjaportti (esimerkiksi infrapunavalokennot).

* ''Protocol'': Käytettävä varmistuslaitteen protokolla.

'''Backup'''

: Enabled / Disabled
* ''Path'': Paikka, jokon varmuuskopiotiedosto kirjoitetaan. Täytyy sisältää tiedoston. Tallennetaan zip-muodossa. (Esim: /tmp/backup.zip)
* ''Method'': Kertoo, misstä tapauksissa varmuuskopio tallennetaan. Read = Transponderilukeman tullessa, Time = Minuutin vaihtuessa
* ''Interval'': Kertoo, kuinka mones kerta varmuuskopion tallennus tehdään. (Esim: 5 = Joka 5 kerta)

====Competition settings====
Kilpailun asetuksista pääset muokkaamaan valittuna olevan kilpailun asetuksia. Asetuksiin pääsee käsiksi valikosta ''Asetukset->Kilpailun asetukset''


'''General'''
* ''Competition name'': Kilpailulle annettu nimi. (esim. Numibia 2009)

* ''Clock type'': Kilpailussa käytettävä aikamuoto; Real time (oikea kellonaika) / Timer (juokseva aika)

* ''Transponder reader in use'': Määrittää, käytetäänkö kilpailupaikalla transponderilukijaa vai vaihtoehtoisesti käsinsyöttöä.

* ''Start light in use'': Määrittää, käytetäänkö kilpailupaikalla lähetysvaloa. Lähetysvalo korvaa lähettäjän (henkilön).

* ''Gap limiter in use'': Määrittää, varoitetaanko käyttäjää, jos lukemia tulee liian usein. Käytetään vain lähdössä.

* ''Wait for passing'': Määrittää, odotetaanko lukemaa, ennen kuin ruvetaan lähettämään uutta kilpailijaa.
: ''Default'': Ei ruksia

* ''Accept lacking times automatically'': Määrittää, hyväksytäänkö puuttuvat ajat automaattisesti. Siirtää käsiajoista virallisiin aikoihin puuttuvat ajat.
: ''Default'': Ruksi

* ''Starting gap'': Määrittää, kuinka tiheästi järjestelmä lähettää kilpailijoita (kuinka monen sekunnin välein).
* ''Minimum service time'': Kilpailijan pienin taukoaika
* ''Load rules from file'': Ladattava lähtöaikatiedosto. Käytetään, kun halutaan laskea uusi lähtöaika automaattisesti (tauko-at).

'''Start light delays'''
* ''Flash before start'': Määrittää lähtövalon vilkkumisajat (vilkkuu X sekuntia ennen lähetystä / palaa X sekuntia ennen lähetystä, jonka jälkeen sammuu).
* ''Static before start'': Määrittää lähtövalon vilkkumisajat (vilkkuu X sekuntia ennen lähetystä / palaa X sekuntia ennen lähetystä, jonka jälkeen sammuu).

'''Rounds'''
* ''Name'': Uuden luotavan erän nimi.
: ''Oltava muotoa (MK)'': <tt><nimi> <numero> <vaihtoehtoinen tarkenne></tt>
:: ''Esimerkki'': MK 1 Laakso
: ''Oltava muotoa (MK+AT)'': <tt><nimi> <numero> <nimi> <numero> <vaihtoehtoinen tarkenne></tt>
:: ''Esimerkki'': MK 2 AT 4 Lappi
* ''Round type'': Uuden luotavan erän tyyppi.
: Kahden edellisen kentän täytön jälkeen erä lisätään <tt>Lisää</tt> painikkeella. Taulukosta valittu erä poistetaan <tt>Poista</tt> painikkeella. Erän nimeä voi muokata myös suoraan taulukosta.
* ''Additional text'': Kirjoitetaan tulosteeseen.

===Kilpailun aloittaminen===
Ennen kilpailun aloittamista on hyvä varmistaa, että kaikki oheislaitteet on kytketty oikein. Kytkennöistä lisää omissa artikkeleissaan.

Ohjelman käynnistämisen jälkeen varmistetaan, että oikea kilpailu ja erä on valittuna. Jos valittu kilpailu ei ole oikea, voidaan se vaihtaa joko kilpailun pikavalinnasta tai valikosta ''Tiedosto->Kilpailujenhallinta''. Erän vaihtaminen tapahtuu pikavalinnan avulla. Pikavalinta löytyy ohjelman yläosasta isojen toimintopainikkeiden yläpuolelta.

Kun oikea kilpailu ja erä on valittu, jäädään odottamaan kilpailun alkua. Jos käytössä on kellotyyppi <tt>Real time</tt>, voidaan kilpailu aloittaa heti painamalla toimintopainiketta ''Aloita'' tai näppäimistön funktiopainiketta ''F5''. Jos käytössä on kellotyyppi <tt>Timer</tt>, kilpailu aloitetaan vasta, kun erä on alkanut (sekunnilleen samalla hetkellä). ''Aloita'' -painike muuttuu turkoosin väriseksi, kun kilpailu on aloitettu.

===Kilpailun aikana===
Transpondereilta luetut ajat ilmestyvät automaattisesti vasempaan taulukkoon. Käsin otetut vara-ajat ilmestyvät oikeaan taulukkoon. Käsiaika otetaan samalla hetkellä, kun kilpailija ohittaa transponderlukulaitteen. Jos transponderlukija ei ole käytössä, otetaan kaikki ajat käsin. Käsiaika rekisteröidään painamalla toimintopainiketta ''Ohitus'' tai näppäimistön funktiopainiketta ''F1'' tai näppäimistön painiketta ''Ctrl''.

Transponderlukijaa käytettäessä käsi-ajanotto ei ole pakollinen, mutta suotavaa aikojen kirjautumisvarmuuden parantamiseksi.

Tilanteessa, jossa transponderlukija ei rekisteröi ohi menevää kilpailijaa, voidaan käsin otettu aika siirtää vasempaan "virallisten aikojen" taulukkoon painamalla toimintopainiketta ''Hyväksy'' tai näppäimistön funktiopainiketta ''F7''. Ajan siirtäminen edellyttää, että käsi-ajalle on syötetty sekä aika, että kilpailijan tunniste (kilpailijanumero). Ennen käsi-ajan hyväksymistä voi sekä aikaa että kilpailijanumeroa voi vapaasti muokata oikeanpuoleisessa taulukossa. Tämä tapahtuu kaksoisklikkaamalla haluttua arvoa.

Kilpailijatunnisteen voi syöttää käsi-ajalle joko ennen tai jälkeen ajan rekisteröimistä. Ennen ajan rekisteröimistä kilpailijatunniste voidaan syöttää numeronäppäimillä, jonka jälkeen se siirtyy automaattisesti rekisteröityyn aikaan, kunnes sille on annettu aika. Jos tunniste halutaan syöttää rekisteöinnin jälkeen, voidaan se lisätä jälkeenpäin rekisteröityyn aikaan kaksoisnapauttamalla haluttua taulukon solua.

Aikaisemmin otettu transponder/käsiaika voidaan jälkikäteen hylätä valitsemalla haluttu aika taulukosta ja sen jälkeen painamalla toimintopainiketta ''Hylkää'' tai näppäimistön funktiopainiketta ''F3''. Tällä tavalla voidaan myös muokata transponderaikoja; ensin transponderaika hylätään, jolloin se siirtyy käsi-aikojen puolelle, jonka jälkeen sitä voidaan muokata ja muokkaamisen jälkeen palauttaa takaisin transponderaikoihin hyväksymällä aika.

Jokaista taulukon aikaa (riviä) merkitään kuvakkeella:

'''Vasen taulukko'''
* ''<font color="green">Vihreä</font>'': Aika on lähetetty tuloslaskentaan.
* ''<font color="olive">Keltainen</font>'': Aika odottaa lähetystä tuloslaskentaan.
'''Oikea taulukko'''
* ''<font color="green">Vihreä</font>'': Aika on hyväksytty mukaan tuloksiin.
* ''<font color="olive">Keltainen</font>'': Aika vaatii huomiota; aika tai kilpailijatunnus puuttuu.
* ''<font color="blue">Sininen</font>'': Aika on informatiivinen, joka on jätetty varalle.
* ''<font color="red">Punainen</font>'': Aika on hylätty. Hylättyä aikaa ei voi enää hyväksyä eikä muokata.

===Kilpailun/erän loputtua===
Ennen kilpailun loppua on syytä terästäytyä jo valmiiksi, jotta viimeisetkin ajat saadaan talteen. Vasta, kun viimeinenkin kilpailija on varmasti saanut itselleen ajan, voidaan aloittaa seuraavat toimenpiteet:

* Tarkista ensimmäiseksi, että kaikki vasemmanpuoleisessa taulukossa olevat ajat ovat merkattu lähetetyiksi (vihreä kuvake).
:: Huom: '''Jos näin ei ole, loput ajat täytyy lähettää käsin. Tämä onnistuu valitsemalla valikosta ''Tiedosto->Lähetä tekstiviestit''. Viestien lähettäminen kestää hetken. '''

* Kun kaikki ajat on merkitty lähetetyiksi, voidaan kilpailu lopettaa painamalla toimintopainiketta ''Pysäytä'' tai näppäimistön funktiopainiketta ''F5''.
* Tämän jälkeen, tilanteesta riippuen joko, valitaan seuraava ajettava erä tai ruvetaan purku-toimenpiteisiin.
:: Huom: '''Jos valitsit uuden erän, muista käynnistää kilpailu ennen kilpailun alkua (''Aloita'' / ''F5'')!'''

==Virhetilanteet==
===Kilpailun aikana===
'''Transponderilukija ei antanut kilpailijalle aikaa'''
: Syy: Kilpailija ohitti lukijan (antennin) liian etäältä tai liian nopeasti tai kilpailijan transponderi on irronnut.
: Ratkaisut: Siirrä käsin ottamasi aika vasempaan taulukkoon (''Hyväksy'' / ''F7''). Jos epäilet irronnutta transponderia, ilmoita järjestäjälle tapahtuneesta.

'''Transponderilukija ei toistuvasti anna kilpailijoille aikoja'''
: Syy: Kilpailija ohitti lukijan (antennin) liian etäältä tai liian nopeasti tai lukija on rikkoontunut.
: Ratkaisut: Siirrä lukijan (antennin) paikkaa | Tarkista kaikki lukijan kaapelit

'''Tekstiviestit eivät kulje / Ajat eivät siirry tuloslaskentaan'''
: Syy: GSM-kortti on irronnut tietokoneen kyljestä tai aseman asetuksissa oleva GSM-numero on virheellinen tai GSM-verkossa on ruuhkaa tai GSM-liittymä on suljettu/saldo loppunut.
: Ratkaisut: Tarkista GSM-kortin paikallaan olo | Tarkista GSM-numero aseman asetuksista | Käynnistä tietokone uudelleen | Irroita ja laita takaisin GSM-kortin SIM-kortti
:: Huom: '''Jos GSM-kortti ei ollut paikoillaan ja laitoit sen paikoilleen, käynnistä tietokone uudelleen tämän jälkeen!'''

'''Ohjelma ei toimi kuten pitäisi'''
: Syy: Ohjelmassa on tapahtunut jokin virhe.
: Ratkaisut: Käynnistä ohjelma uudelleen | Käynnistä tietokone uudelleen

'''Tietokone ei toimi kuten pitäisi'''
: Syy: Tietokoneessa on tapahtunut jokin virhe.
: Ratkaisut: Käynnistä tietokone uudelleen

===Ohjelman virheilmoitukset===
'''Lukijaa ei löydy'''
: Syy: Lukijan kaapeli on irronnut tietokoneesta/lukijasta tai lukijasta on katkennut virta tai lukija on rikkoontunt.
: Ratkaisut: Paina ''Asetukset > Alusta laitteet'' | Tarkista kaikki lukijan kaapelit | Tarkista lukijan päällinen kunto | Käynnistä ohjelma uudelleen | Käynnistä tietokone uudelleen
'''SMSTools ei ole asennettu'''
: Syy: Linuxissa tekstiviestien lähettämiseen tarvittavaa ohjelmaa ei löydy.
: Ratkaisut: Käynnistä tietokone uudelleen | Asenna SMSTools
'''Jokin muu virheilmoitus'''
: Syy: Ohjelmassa on tapahtunut jokin virhe.
: Ratkaisut: Käynnistä ohjelma uudelleen | Käynnistä tietokone uudelleen
Return to ChronoFly User's manual dev.
Retrieved from "http://wiki.enymind.fi/page/ChronoFly_User%27s_manual_dev"