updated license and email addresses
[qbasicapps.git] / automation / school clock / kell / juhend.txt
index 5ffaadb..2aed5c4 100644 (file)
-\r
-\r
-\r
-               Kooli Kell programmi kasutusjuhend\r
-\r
+
+                Kooli Kell programmi kasutusjuhend
+
 2002.10
-\r
-Programmi, juhendi ja skeemi autor:\r
-Svjatoslav Agejenko\r
-n0@hot.ee
-www.hot.ee/n0/
-\r
-K\93ik on vabavara!\r
-\r
-Programm Kooli Kell on m\93eldud kella laskmiseks koolis, tundi sisse ja v\84lja.\r
-Samuti juhib programm arvuti k\81ljes olevat liidest, kahekohaliste numbrite\r
-n\84itamiseks (minutid / tunnid), 3 klahvilist klaviatuuri ja releed.\r
-Tundi sisse minev kell on 1 pikk ning 1 l\81hem helin. V\84ljaminev kell on 1\r
-tavaline pikk helin. Programm loeb aega arvuti s\81steemsest kellast.\r
-Kella laskmis ajad on organiseeritud failidesse  *.PP .\r
-Aasta v\93i p\84evaplaani muutmiseks tuleb redakteerida vastavaid faile.\r
-(s\93nast P\84eva Plaan) Programm valib sobiva p\84evaplaani l\84htudes aastaplaanist,\r
-mis asub failis "aasta.ap" . Programmi saab kasutada arvutil millele on\r
-printeri pesasse (LPT1) \81hendatud spetsiaalne liides, liidese skeem on\r
-failis "skeem.bmp". Liides omab kolme nummerdatud nuppu paigutusega:\r
-\r
-       [1]   [2]\r
-          [3]\r
-\r
-Programm on etten\84htud iseseisvalt t\94\94tama, kuid on ka v\93imalus erandkorras\r
-k\84sitsi kella lasta, aega muuta jne.. Programm eristab tavalisi nupuvajutusi\r
-ja topeltkl\93pse. Eesm\84rgiga suurendada funktsionaalsust v\84heste nuppudega.\r
-\r
-        Nuppude funktsioonid peamen\81\81s:\r
-\r
-[1] kl\93ps      - laseb kella tundi sisse\r
-    topeltkl\93ps - laseb kella tunnist v\84lja\r
-[2] kl\93ps       - l\84heb aja muutmis men\81\81sse\r
-    topeltkl\93ps - hakkab t\94\94le uuendatud graafikuga, vajalik p\84rast\r
-                 sisendfailide redigeerimist.\r
-[3] kl\93ps      - \81mardab s\81steemse aja t\84istunnini, vajalik aja\r
-                 s\81nkroniseerimiseks.\r
-    topeltkl\93ps - laeb s\81steemse: aasta, kuu, p\84eva, tunnid, minutid\r
-                 failist "sync.txt"\r
-\r
-        Nuppude funktsioonid aja muutmis men\81\81s:\r
-\r
-[1] kl\93ps       - v\84hendab s\81steemsed tunnid/minutid 1. v\93rra\r
-[2] kl\93ps       - suurendab s\81steemsed tunnid/minutid 1. v\93rra\r
-[3] kl\93ps       - valib n\84itamiseks ja redigeerimiseks tunnid v\93i minutid.\r
-    topeltkl\93ps - l\84heb tagasi peamen\81\81sse.\r
-\r
-Aja muutmis men\81\81d tunneb \84ra selle j\84rgi et indikaator tunnid v\93i\r
-minutid vilgub, mitte ei p\93le nagu peamen\81\81s.\r
-\r
-\r
-\r
-               faili AASTA.AP formaat: (aastaplaan)\r
-\r
-\r
-v      <kuu>-<p\84ev>    <kuu>-<p\84ev>    <p\84evaplaan>\r
-\r
-S\93nast vahemik. Paneb paika p\84evaplaani antud ajavahemikus. Esimene\r
-daatum peab kindlasti olema v\84iksem kui teine. St. kui on t\93esti vaja:\r
-\r
-v      10-4    2-1     eri\r
-\r
-tuleb kirjutada:\r
-\r
-v      10-4    12-31   eri\r
-v      1-1     2-1     eri\r
-\r
-P\84evaplaan kehtib vahemiku esimesest p\84evast kuni vahemiku viimase p\84evani.\r
-\r
-\r
-n      <kuu>-<p\84ev>    <kuu>-<p\84ev>    <n\84dalap\84ev>    <p\84evaplaan>\r
-\r
-S\93nast n\84dalap\84ev. sama mis "v" kuid: paneb paika p\84evaplaani antud\r
-ajavahemikus, antud n\84dalap\84eval. N\84dalap\84eva kirjeldatakse numbriga.\r
-n\84dala esimene p\84ev on esmasp\84ev, talle vastab number 1.\r
-\r
-\r
-e      <kuu>-<p\84ev> <p\84evaplaan>\r
-\r
-S\93nast eriline. Paneb paika antud kuup\84evale antud p\84evaplaani. Sobib h\84sti\r
-erakorraliste l\81hendatud v\93i muul moel muudetud p\84evaplaanide kehtestamiseks.\r
-N\84iteks riigip\81had, spordip\84ev jne.\r
-\r
-Kui teatud p\84eva kohta ei k\84inud \81htegi kirjet siis toimib vaikimisi "tuhi"\r
-p\84evaplaan. Kui teatud p\84eva kohta k\84is mitu kirjet siis j\84\84b peale viimane.\r
-\r
-\r
-\r
-               failide *.PP formaat: (p\84evaplaanid)\r
-\r
-\r
-#      <tund>:<minut>  <kell>\r
-\r
-Laseb antud ajal antud kella. V\93imalikud kella helinad on:\r
-\r
-       sis     -kell tundi sisse\r
-       val     -kell tunnist v\84lja\r
-\r
-\r
-\r
-               faili SYNC.TXT formaat:\r
-\r
-faili esimesel kahel real peab olema j\84rgnev:\r
-\r
-KK-PP-AAAA\r
-TT:MM\r
-\r
-kus    KK = kuu\r
-       PP = p\84ev\r
-       AAAA = aasta\r
-       TT = tunnid\r
-       MM = minutid\r
+
+Programm Kooli Kell on m\93eldud kella laskmiseks koolis, tundi sisse ja v\84lja.
+Samuti juhib programm arvuti k\81ljes olevat liidest, kahekohaliste numbrite
+n\84itamiseks (minutid / tunnid), 3 klahvilist klaviatuuri ja releed.
+Tundi sisse minev kell on 1 pikk ning 1 l\81hem helin. V\84ljaminev kell on 1
+tavaline pikk helin. Programm loeb aega arvuti s\81steemsest kellast.
+Kella laskmis ajad on organiseeritud failidesse  *.PP .
+Aasta v\93i p\84evaplaani muutmiseks tuleb redakteerida vastavaid faile.
+(s\93nast P\84eva Plaan) Programm valib sobiva p\84evaplaani l\84htudes aastaplaanist,
+mis asub failis "aasta.ap" . Programmi saab kasutada arvutil millele on
+printeri pesasse (LPT1) \81hendatud spetsiaalne liides, liidese skeem on
+failis "skeem.bmp". Liides omab kolme nummerdatud nuppu paigutusega:
+
+        [1]   [2]
+           [3]
+
+Programm on etten\84htud iseseisvalt t\94\94tama, kuid on ka v\93imalus erandkorras
+k\84sitsi kella lasta, aega muuta jne.. Programm eristab tavalisi nupuvajutusi
+ja topeltkl\93pse. Eesm\84rgiga suurendada funktsionaalsust v\84heste nuppudega.
+
+        Nuppude funktsioonid peamen\81\81s:
+
+[1] kl\93ps       - laseb kella tundi sisse
+    topeltkl\93ps - laseb kella tunnist v\84lja
+[2] kl\93ps       - l\84heb aja muutmis men\81\81sse
+    topeltkl\93ps - hakkab t\94\94le uuendatud graafikuga, vajalik p\84rast
+                  sisendfailide redigeerimist.
+[3] kl\93ps       - \81mardab s\81steemse aja t\84istunnini, vajalik aja
+                  s\81nkroniseerimiseks.
+    topeltkl\93ps - laeb s\81steemse: aasta, kuu, p\84eva, tunnid, minutid
+                  failist "sync.txt"
+
+        Nuppude funktsioonid aja muutmis men\81\81s:
+
+[1] kl\93ps       - v\84hendab s\81steemsed tunnid/minutid 1. v\93rra
+[2] kl\93ps       - suurendab s\81steemsed tunnid/minutid 1. v\93rra
+[3] kl\93ps       - valib n\84itamiseks ja redigeerimiseks tunnid v\93i minutid.
+    topeltkl\93ps - l\84heb tagasi peamen\81\81sse.
+
+Aja muutmis men\81\81d tunneb \84ra selle j\84rgi et indikaator tunnid v\93i
+minutid vilgub, mitte ei p\93le nagu peamen\81\81s.
+
+
+
+                faili AASTA.AP formaat: (aastaplaan)
+
+
+v       <kuu>-<p\84ev>     <kuu>-<p\84ev>     <p\84evaplaan>
+
+S\93nast vahemik. Paneb paika p\84evaplaani antud ajavahemikus. Esimene
+daatum peab kindlasti olema v\84iksem kui teine. St. kui on t\93esti vaja:
+
+v       10-4    2-1     eri
+
+tuleb kirjutada:
+
+v       10-4    12-31   eri
+v       1-1     2-1     eri
+
+P\84evaplaan kehtib vahemiku esimesest p\84evast kuni vahemiku viimase p\84evani.
+
+
+n       <kuu>-<p\84ev>     <kuu>-<p\84ev>     <n\84dalap\84ev>      <p\84evaplaan>
+
+S\93nast n\84dalap\84ev. sama mis "v" kuid: paneb paika p\84evaplaani antud
+ajavahemikus, antud n\84dalap\84eval. N\84dalap\84eva kirjeldatakse numbriga.
+n\84dala esimene p\84ev on esmasp\84ev, talle vastab number 1.
+
+
+e       <kuu>-<p\84ev> <p\84evaplaan>
+
+S\93nast eriline. Paneb paika antud kuup\84evale antud p\84evaplaani. Sobib h\84sti
+erakorraliste l\81hendatud v\93i muul moel muudetud p\84evaplaanide kehtestamiseks.
+N\84iteks riigip\81had, spordip\84ev jne.
+
+Kui teatud p\84eva kohta ei k\84inud \81htegi kirjet siis toimib vaikimisi "tuhi"
+p\84evaplaan. Kui teatud p\84eva kohta k\84is mitu kirjet siis j\84\84b peale viimane.
+
+
+
+                failide *.PP formaat: (p\84evaplaanid)
+
+
+#       <tund>:<minut>  <kell>
+
+Laseb antud ajal antud kella. V\93imalikud kella helinad on:
+
+        sis     -kell tundi sisse
+        val     -kell tunnist v\84lja
+
+
+
+                faili SYNC.TXT formaat:
+
+faili esimesel kahel real peab olema j\84rgnev:
+
+KK-PP-AAAA
+TT:MM
+
+kus     KK = kuu
+        PP = p\84ev
+        AAAA = aasta
+        TT = tunnid
+        MM = minutid