Kooli Kell programmi kasutusjuhend

- 2002.10
- Svjatoslav Agejenko


* Kasutajaliides
Programm Kooli Kell on mõldud kella laskmiseks koolis, tundi sisse ja
välja.  Samuti juhib programm arvuti küljes olevat liidest,
kahekohaliste numbrite näitamiseks (minutid / tunnid), 3 klahvilist
klaviatuuri ja releed.  Tundi sisse minev kell on 1 pikk ning 1 l”em
helin. Väljaminev kell on 1 tavaline pikk helin. Programm loeb aega
arvuti süsteemsest kellast.  Kella laskmis ajad on organiseeritud
failidesse *.PP .  Aasta või päevaplaani muutmiseks tuleb redakteerida
vastavaid faile. Programm valib sobiva päevaplaani lähtudes
aastaplaanist, mis asub failis "aasta.ap" . Programmi saab kasutada
arvutil millele on printeri pesasse (LPT1) ”endatud spetsiaalne
liides, liidese skeem on failis "skeem.bmp". Liides omab kolme
nummerdatud nuppu paigutusega:

#+BEGIN_VERSE
        <1>   <2>
           <3>
#+END_VERSE

Programm on ettenähtud iseseisvalt töötama, kuid on ka võimalus
erandkorras kгitsi kella lasta, aega muuta jne.. Programm eristab
tavalisi nupuvajutusi ja topeltklõpse. Eesmärgiga suurendada
funktsionaalsust väheste nuppudega.

** Nuppude funktsioonid peamenüüs:

+ <1> klõps :: laseb kella tundi sisse
+ <1> topeltklõps :: laseb kella tunnist välja

+ <2> klõps :: läheb aja muutmis menüüsse
+ <3> topeltklõps :: hakkab tööle uuendatud graafikuga, vajalik pвast
     sisendfailide redigeerimist.

+ <3> klõps :: ümardab süsteemse aja täistunnini, vajalik aja
               sünkroniseerimiseks.
+ <3> topeltklõps :: laeb süsteemse: aasta, kuu, päeva, tunnid,
     minutid failist "sync.txt"

** Nuppude funktsioonid aja muutmis menüüs:

+ <1> klõps :: vähendab süsteemsed tunnid/minutid 1. võrra

+ <2> klõps :: suurendab süsteemsed tunnid/minutid 1. võrra

+ <3> klõps :: valib näitamiseks ja redigeerimiseks tunnid või minutid.
+ <3> topeltklõps :: läheb tagasi peamenüüsse.

Aja muutmis menüüd tunneb ära selle järgi et indikaator tunnid või
minutid vilgub, mitte ei põle nagu peamenüüs.


* Faili AASTA.AP formaat: (aastaplaan)
: v       <kuu>-<päev>     <kuu>-<päev>     <päevaplaan>

Sõnast aja vahemik. Paneb paika päevaplaani antud
ajavahemikus. Esimene daatum peab kindlasti olema väiksem kui
teine. St. kui on tõesti vaja:

: v       10-4    2-1     eri

tuleb kirjutada:

: v       10-4    12-31   eri
: v       1-1     2-1     eri

Päevaplaan kehtib vahemiku esimesest päevast kuni vahemiku viimase
päevani.


: n       <kuu>-<päev>     <kuu>-<päev>     <nädalapäev>      <päevaplaan>

Sõnast nädalapäv. sama mis "v" kuid: paneb paika päevaplaani antud
ajavahemikus, antud nädalapäeval. Nädalapäeva kirjeldatakse numbriga.
nädala esimene päev on esmaspäev, talle vastab number 1.


: e       <kuu>-<päev> <päevaplaan>

Sõnast eriline. Paneb paika antud kuupävale antud pävaplaani. Sobib
hästi erakorraliste lüendatud või muul moel muudetud päevaplaanide
kehtestamiseks. Näiteks riigipühad, spordipäev jne.

Kui teatud päeva kohta ei käinud ühtegi kirjet siis toimib vaikimisi
"tuhi" päevaplaan. Kui teatud päeva kohta käis mitu kirjet siis jääb
peale viimane.



* Failide *.PP formaat: (päevaplaanid)
: # <tund>:<minut>  <kell>

Laseb antud ajal antud kella. Võimalikud kella helinad on:

| kella kood | vastav helin       |
|------------+--------------------|
| sis        | kell tundi sisse   |
| val        | kell tunnist välja |

* Faili SYNC.TXT formaat:
faili esimesel kahel real peab olema järgnev:

: KK-PP-AAAA
: TT:MM

kus:
| kood | tähendus |
|------+----------|
| KK   | kuu      |
| PP   | päev     |
| AAAA | aasta    |
| TT   | tunnid   |
| MM   | minutid  |