SEAL Tutorial - Revision history

Atis at 10:33, 10 October 2012

2012-10-10T10:33:07Z

Atis at 10:23, 10 October 2012

2012-10-10T10:23:32Z

Atis at 10:20, 10 October 2012

2012-10-10T10:20:06Z

Atis at 19:55, 9 October 2012

2012-10-09T19:55:44Z

Atis at 09:34, 5 October 2012

2012-10-05T09:34:41Z

Atis at 09:34, 5 October 2012

2012-10-05T09:34:11Z

Atis at 09:32, 5 October 2012

2012-10-05T09:32:43Z

Atis: New page: = SEAL lietošanas pamācība = ==Ievads == SEAL ir programmēšanas valoda bezvadu sensoru tīkliem. Atšķirībā no vispārīga pielietojuma programmēšanas valodām. SEAL ir daudz v...

2012-10-05T08:48:06Z

New page: = SEAL lietošanas pamācība = ==Ievads == SEAL ir programmēšanas valoda bezvadu sensoru tīkliem. Atšķirībā no vispārīga pielietojuma programmēšanas valodām. SEAL ir daudz v...

New page

= SEAL lietošanas pamācība =

==Ievads ==

SEAL ir programmēšanas valoda bezvadu sensoru tīkliem. Atšķirībā no vispārīga pielietojuma programmēšanas valodām. SEAL ir daudz vienkāršāka, mazāka, un ātrāk apgūstama. Savukārt programmas rakstītas tajā ir īsākas nekā analoģiskas programmas priekš sensoru tīkliem, rakstītas kādā no vispārīga pielietojuma programmēšanas valodām.

Programmēšanas testa laikā jums būs pieejams sensoru mezgls. Sensoru mezgls var sazināties ar bāzes staciju, kas atrodas vienā telpā ar to. Sensoru mezgls spēj lasīt sensorus, mikršķi

== Valodas sintakse ==

SEAL ir šādi rezervēti atslēgvārdi:

<code>and, config, const, define, else, elsewhen, end, load, networkread, not, parameters, pattern, read, or, output, set, use, when, where</code>.

Visiem SEAL izteikumiem jābeidzas ar noslēdzošo simbolu. Parasti tas ir semikols ';', izņemot <code>when</code> nosacījumus, kuriem jābeidzas ar atslēgvārdu <code>end</code>.

SEAL sintakse nav reģistrjūtīga. Tas ir, <code>USE</code>, <code>use</code>, un <code>Use</code> nozīmē vienu un to pašu. Ieteicams izstrādājot programmas ievērot neformālas konvencijas, lai tās būtu viegli lasāmas. Viena no konvencijām ir apzīmēt simboliskās konstantes ar LIELAJIEM BURTIEM, sensoru vērtības ar Lielo Sākumburtu, savukārt pārējos vārdus programmā sākt ar mazo burtu.

== Valodas elementi ==

* '''Komponentu lietojumus''' apraksta ar vieu no atslēgas vārdiem use, read, output, kuram seku komponentu nosaukums un parameteri. Piemēram,
** <code>use Beeper</code> -- lietot pīkstuli, ja motei tāds ir;
** <code>read Humidity</code> -- nolasīt mitruma sensora vērtību;
** <code>output Serial</code> -- uzvadīt nolasītos datus (visus) uz seriālo saskarni (USB kabeli).
Pilns atbalstīto komponentu saraksts ir [http://selavo.lv/wiki/index.php/SEAL_Components pieejams te].

* '''Funkcijas''' ļauj ielasītos sensoru datus apstrādāt, piemēram, pielietojot tiem aritmētiskas operācijas. Piemēram, funkcija <code>add(Humidity, 10)</code> pieskaita gaismas sensora lasījumam skaitli 10. Pilns atbalstīto funkciju saraksts ir [http://selavo.lv/wiki/index.php/SEAL_Functions pieejams te].

* '''Komponentu definīcījas''' ļauj ar atslēgvārda <code>define</code> palīdzību "izveidot" jaunos, virtuālus komponentus, ar funkciju palīdzību kombinējot jau esošos. Piemēram, <code>define MaxHumidity max(Humidity)</code> definē jaunu komponentu ar nosaukumu ''MaxLight'', kura vērtība būs vienāda ar maksimālo līdz šim nolasītos gaismas sensora vērtību programmas darbības laikā.

* '''Parameterus''' var norādīt gan komponentu lietojumiem, gan komponentu definīcijām. Piemēram, parametrs <code>once</code> saka, ka komponentu vajag lietot (lasīt, ieslēgt utt.) tikai vienreiz. (Pēc noklusēšanas komponenti tiek lietoti periodiski, neierobežotu skaitu periodu.)

* '''Komentāri''' var tikt rakstīti, atdalot tos no pārējā programmas koda ar diviem simboliem "//". Komentārs stiepjas līdz rindiņas beigām, un neietekmē programmas funkcionalitāti. Piemēram:
** <code>use Beeper; // lieto pīkstuli</code>
definē Beeper komponenta lietojumu ar atbilstošu paskaidrojošu tekstu.

==== Mainīgie un konstantes ====

Lielā daļā SEAL programmu nav nepieciešams izmantot ''mainīgos''. Jau nu tie tomēr ir vajadzīgi, mainīgo var definēt un lietot izmantojot <code>set</code> atslēgvārdu.

Piemēram <code>set counter 1;</code> uzstāda mainīgā ar nosaukumu "counter" vērtību vienādu ar viens.

<code>set counter add(counter, 1);</code> uzstāda šī pašam mainīgā vērtību vienādu ar tā iepriekšējo vērtību saskaitītu ar viens.

Visi mainīgie ir skalāri (t.i. var saturēt sevī tikai vienu vērtību).

''Simboliskās konstantes'' (t.i. konstantes ar vārdu) SEAL programmās ir ieteicams izmantot bieži. Konstanti definē ar <code>const</code> atslēgvārda palīdzību.

Piemēram <code>const SLIEKSNIS 1000;</code> definē konstanti ar nosaukumu "SLIEKSNIS" un vērtību vienādu ar 1000.

Konstantes vietā vienmēr var rakstīt arī šīs konstantes vērtību tieši, ar cipariem.

==== Kontroles bloki ====

SEAL programmas izpildīšanos var kontrolēt ar <code>when</code> atslēgvārda palīdzību.

Tā lietošana ir šāda:
when <nosacījums>
<koda bloks 1>
end
Šajā piemērā <code><koda bloks 1></code> izpildās tad un tikai tad, ja <code><nosacījums></code> ir patiess.

Jāņem vērā, ka nosacījumu patiesuma vērtības tiek atkārtoti izvērtētas periodiski. (Pēc noklusēšanas tas notiek 10 reizes sekundē). Koda bloks savukārt izpildās neatkarīgi no tiem. Ja reiz bloks ir sācis izpildīties, tas izpildās vai nu noteiktu reižu skaitu, ja tāds norādīts parametros, vai arī noteiktu laiku, ja norādīts tas. Pēc noklusēšanas koda bloks izpildās neierobežotu reižu skaitu, periodiski. Izpildīšanās periods arī atkarīgs no parametriem un pēc noklusēšanas ir vienāds ar vienu sekundi.

Ir atbalstīti arī <code>else</code> un <code>elsewhen</code> atslēgvārdi ar to intuitīvajām nozīmēm.<code>else</code> norāda, ka tālāk sekos koda bloks, kurš izpildīsies tikai tad, kad visi iepriekšējā koda bloka nosacījumi ir nepatiesi. <code>elsewhen</code> nozīme ir līdzīga <code>else</code>, bet papildus tam kods šajā blokā izpildās tikai tad, kad <code>elsewhen</code> sekojošais nosacījums ir patiess.
when <nosacījums>:
<koda bloks 1>
else:
<koda bloks 2>
end
Šajā piemērā <code>< koda bloks 1 ></code> izpildās tad un tikai tad, ja <code>< nosacījums ></code> ir patiess, savukārt <code>< koda bloks 2 ></code> izpildās pretējā gadījuma -- ja nosacījums ir nepatiess.
when <nosacījums 1>:
<koda bloks 1>
elsewhen <nosacījums 2>:
<koda bloks 2>
else:
<koda bloks 3>
end
Šajā piemērā <code><koda bloks 2></code> izpildās tad un tikai tad, ja <code><nosacījums 1></code> ir nepatiess, savukārt <code><nosacījums 2></code> ir patiess. <code><koda bloks 3></code> izpildās tikai tad, ja abi nosacījumi ir nepatiesi.

Nosacījumi savā starpā var tikt apvienoti ar loģiskajiem atslēgvārdiem <code>AND</code>, <code>OR</code>, kā arī nosacījuma vērtība var tikt invertēta ar atslēgvārdu <code>NOT</code>.

Piemēram:
when (NOT <nosacījums 1>) AND (<nosacījums 2> OR <nosacījums 3>):
<koda bloks>
end
Šeit koda bloks izpildīsies tikai tad, ja <code><nosacījums 1></code> būs nepatiess, bet vismaz viens no nosacījumiem 2 un 3 būš patiess.

== Programmēšanas vide ==

[[File:mansos-ide.png]]

Uzsākot testu, jums priekšā būs MansOS IDE atvērtā stāvoklī (attēlā).

SEAL '''kodu rakstīt''' paredzēts pelēkajā rajonā labajā pusē.

Lai atvieglotu koda ievadīšanu, eksistē '''vizuālais redaktors''' (kreisā puse). Noklikšķinot uz noteikts koda rindas (kura var būt nepilnīgi uzrakstīta), vizuālais redaktors parādīs izvēļu joslu ar atslēgvārdiem, nosaukumiem un parametriem, kurus varētu lietot šajā koda rindā (vai <code>when ... end</code> koda blokā). Lai aktivizētu vizuālo redaktoru, nepieciešams vai nu sākt rakstīt kodu, vai arī nospiest vienu no pogām "Add statement" vai "Add condition".

Lai '''pārbaudītu''', vai jūsu sintakse ir korekta, nospiediet "Compile" pogu. Tiks palaists programmas būvēšanas process, kas vai nu parādīs sintakses kļūdas, vai novedīs līdz paziņojumam par veiksmīgu procesa pabeigšanos. Ja tas nenotiek automātiski, programmas būvēšanās stāvokli iespējams redzēt, aktivizējot "Info" izvēlni apakšējā darbvirsmas daļā.

Lai '''izmēģinātu''' uzlādētu programmu uz motes, nospiediet "Upload" pogu. Tehnisku operētājsistēmas un aparatūras problēmu dēļ uzlādēšana var neizdoties a pirmo mēģinājumu, Tādā gadījumā jāmēģina atkārtoti. Ja neizdodas arī ar otro reizi, pārbaudiet, vai mote ir pilnībā iesprausta. Variet arī lūgt instruktora palīdzību. Informāciju par šo procesu iespējams redzēt "Info" izvēlnē apakšējā darbvirsmas daļā.

Sensoru mezgls var sazināties pa seriālo saskarni (sūtīt diagnostiskus rakstveida ziņojumus) ar datoru, kuram tas ir pieslēgts. Lai '''klausītos''' šos ziņojumus, jums jāaktivizē sadaļa "Listen module 1" apakšējā panelī un jānospiež tur "Start listening" poga. Lai izpildītu jums izsniegtos programmēšanas uzdevumus, seriālās saskarnes izmantošana programmas tekstā nav obligāta. Ja seriālās saskarnes izmantošana programmas tekstā nav norādīta, ziņojumi netiek sūtīti.

@@ Line 86: / Line 86: @@
    &lt;koda bloks&gt;
  end
-Šeit koda bloks izpildīsies tikai tad, ja <code>&lt;nosacījums 1&gt;</code> būs nepatiess, bet vismaz viens no nosacījumiem 2 un 3 būš patiess.
+Šeit koda bloks izpildīsies tikai tad, ja <code>&lt;nosacījums 1&gt;</code> būs nepatiess, bet vismaz viens no nosacījumiem 2 un 3 būs patiess.
+==== Lokālā komunikācija ====
+Lai nosūtītu datus lokāli (datoram, kuram pieslēgta mote), izmantojies <code>Serial</code> komponentu. Pēc noklusēšanas, tas izvadīs visus nolasītos sensorus. Lai izvadītu tikai daļu no tiem, var izmantot iekavās norādītus laukus. Piemēram:
+ read Humidity;
+ output Serial;
+izvadīs mitruma sensora lasījumus. Šis kods ir analoģisks:
+ read Humidity;
+ output Serial (Humidity);
+Ir iespējams izmantot arī <code>Print</code> komponentu, vai arī norādot <code>out ...</code> parameteru tieši aiz sensoru lasījumiem.
+==== Tīkla komunikācija ====
+Komunikācija pa tīklu notiek līdzīgi lokālajai komunikācijai, taču <code>Serial</code> komponenta vietā ir jāizmanto <code>Radio</code> vai<code>Network</code> komponenti. Veiksmīgas komunikācijas gadījumā ziņojumi tiks saņemti uz bāzes stacijas mezgla.
 == Programmēšanas vide ==

@@ Line 90: / Line 90: @@
 == Programmēšanas vide ==
-[[Image:mansos-ide.png]]
+[[Image:mansos-ide-startup.png]]
 Uzsākot testu, jums priekšā būs MansOS IDE atvērtā stāvoklī (attēlā).
@@ Line 98: / Line 98: @@
 Lai atvieglotu koda ievadīšanu, eksistē '''vizuālais redaktors''' (labā puse). Noklikšķinot uz noteikts koda rindas (kura var būt nepilnīgi uzrakstīta), vizuālais redaktors parādīs izvēļu joslu ar atslēgvārdiem, nosaukumiem un parametriem, kurus varētu lietot šajā koda rindā (vai <code>when ... end</code> koda blokā). Lai aktivizētu vizuālo redaktoru, nepieciešams vai nu sākt rakstīt kodu, vai arī nospiest vienu no pogām "Add statement" vai "Add condition".
-Lai '''pārbaudītu''', vai jūsu sintakse ir korekta, nospiediet "Compile" pogu. Tiks palaists programmas būvēšanas process, kas vai nu parādīs sintakses kļūdas, vai novedīs līdz paziņojumam par veiksmīgu procesa pabeigšanos. Ja tas nenotiek automātiski, programmas būvēšanās stāvokli iespējams redzēt, aktivizējot "Info" izvēlni apakšējā darbvirsmas daļā.
+Lai '''pārbaudītu''', vai jūsu sintakse ir korekta, nospiediet "Compile" pogu. [[Image:mansos-ide-compile.png]] Tiks palaists programmas būvēšanas process, kas vai nu parādīs sintakses kļūdas, vai novedīs līdz paziņojumam par veiksmīgu procesa pabeigšanos. Ja tas nenotiek automātiski, programmas būvēšanās stāvokli iespējams redzēt, aktivizējot "Info" izvēlni apakšējā darbvirsmas daļā.
-Lai '''izmēģinātu''' uzlādētu programmu uz motes, nospiediet "Upload" pogu. Tehnisku operētājsistēmas un aparatūras problēmu dēļ uzlādēšana var neizdoties ar pirmo mēģinājumu, Tādā gadījumā jāmēģina atkārtoti. Ja neizdodas arī ar otro reizi, pārbaudiet, vai mote ir pilnībā iesprausta. Variet arī lūgt instruktora palīdzību. Informāciju par šo procesu iespējams redzēt "Info" izvēlnē apakšējā darbvirsmas daļā.
+Lai '''izmēģinātu''' uzlādētu programmu uz motes, nospiediet "Upload" pogu. [[Image:mansos-ide-upload.png]]  Tehnisku operētājsistēmas un aparatūras problēmu dēļ uzlādēšana var neizdoties ar pirmo mēģinājumu, Tādā gadījumā jāmēģina atkārtoti. Ja neizdodas arī ar otro reizi, pārbaudiet, vai mote ir pilnībā iesprausta. Variet arī lūgt instruktora palīdzību. Informāciju par šo procesu iespējams redzēt "Info" izvēlnē apakšējā darbvirsmas daļā.
-Sensoru mezgls var sazināties pa seriālo saskarni (sūtīt diagnostiskus rakstveida ziņojumus) ar datoru, kuram tas ir pieslēgts. Lai '''klausītos''' šos ziņojumus, jums jāaktivizē sadaļa "Listen module 1" apakšējā panelī un jānospiež tur "Start listening" poga. Lai izpildītu jums izsniegtos programmēšanas uzdevumus, seriālās saskarnes izmantošana programmas tekstā nav obligāta. Ja seriālās saskarnes izmantošana programmas tekstā nav norādīta, ziņojumi netiek sūtīti.
+Sensoru mezgls var sazināties pa seriālo saskarni (sūtīt diagnostiskus rakstveida ziņojumus) ar datoru, kuram tas ir pieslēgts. Lai '''klausītos''' šos ziņojumus, nospiediet "Listen" pogu. [[Image:mansos-ide-listen.png]] Nevar vienlaicīgi klausīties un augšupielādēt programmu. Vispirms izslēdziet klausīšanos, pēc tam augšupielādējiet. Lai izpildītu jums izsniegtos programmēšanas uzdevumus, seriālās saskarnes izmantošana programmas tekstā nav obligāta. Ja seriālās saskarnes izmantošana programmas tekstā nav norādīta, ziņojumi netiek sūtīti.

@@ Line 92: / Line 92: @@
 [[Image:mansos-ide.png]]
-Attēls: http://mansos.edi.lv/wp-content/uploads/2012/10/mansos-ide.png
 Uzsākot testu, jums priekšā būs MansOS IDE atvērtā stāvoklī (attēlā).

@@ Line 90: / Line 90: @@
 == Programmēšanas vide ==
+[[Image:mansos-ide.png]]
 Attēls: http://mansos.edi.lv/wp-content/uploads/2012/10/mansos-ide.png

@@ Line 37: / Line 37: @@
 ==== Mainīgie un konstantes ====
-Lielā daļā SEAL programmu nav nepieciešams izmantot ''mainīgos''. Jau nu tie tomēr ir vajadzīgi, mainīgo var definēt un lietot izmantojot <code>set</code> atslēgvārdu.
+Lielā daļā no SEAL programmām nav nepieciešams izmantot ''mainīgos''. Jau nu tie tomēr ir vajadzīgi, mainīgo var definēt un lietot izmantojot <code>set</code> atslēgvārdu.
-Piemēram <code>set counter 1;</code> uzstāda mainīgā ar nosaukumu "counter" vērtību vienādu ar viens.
+Piemēram <code>set counter 1;</code> uzstāda mainīgā ar nosaukumu "counter" vērtību vienādu ar 1.
-<code>set counter add(counter, 1);</code> uzstāda šī pašam mainīgā vērtību vienādu ar tā iepriekšējo vērtību saskaitītu ar viens.
+<code>set counter add(counter, 1);</code> uzstāda mainīgā "counter" vērtību vienādu ar šī mainīgā iepriekšējo vērtību, saskaitītu ar 1.
 Visi mainīgie ir skalāri (t.i. var saturēt sevī tikai vienu vērtību).
 ''Simboliskās konstantes'' (t.i. konstantes ar vārdu) SEAL programmās ir ieteicams izmantot bieži. Konstanti definē ar <code>const</code> atslēgvārda palīdzību.

@@ Line 3: / Line 3: @@
 ==Ievads ==
-SEAL ir programmēšanas valoda bezvadu sensoru tīkliem. Atšķirībā no vispārīga pielietojuma programmēšanas valodām. SEAL ir daudz vienkāršāka, mazāka, un ātrāk apgūstama. Savukārt programmas rakstītas tajā ir īsākas nekā analoģiskas programmas priekš sensoru tīkliem, rakstītas kādā no vispārīga pielietojuma programmēšanas valodām.
+SEAL ir programmēšanas valoda bezvadu sensoru tīkliem. Atšķirībā no vispārīga pielietojuma programmēšanas valodām. SEAL ir daudz vienkāršāka, mazāka, un ātrāk apgūstama. Savukārt programmas, rakstītas SEAL, ir īsākas nekā analoģiskas programmas priekš sensoru tīkliem, kuras ir rakstītas kādā no vispārēja pielietojuma programmēšanas valodām.
-Programmēšanas testa laikā jums būs pieejams sensoru mezgls. Sensoru mezgls var sazināties ar bāzes staciju, kas atrodas vienā telpā ar to. Sensoru mezgls spēj lasīt sensorus, mikršķi
+Programmēšanas testa laikā jums būs pieejams sensoru mezgls. Sensoru mezgls var sazināties (pa radio) ar bāzes staciju, kas atrodas vienā telpā ar to. Sensoru mezgls spēj lasīt sensorus, mikršķināt diodes utml.
 == Valodas sintakse ==
@@ Line 95: / Line 95: @@
 Uzsākot testu, jums priekšā būs MansOS IDE atvērtā stāvoklī (attēlā).
-SEAL '''kodu rakstīt''' paredzēts pelēkajā rajonā labajā pusē.
+SEAL '''kodu rakstīt''' paredzēts pelēkajā rajonā kreisajā pusē.
-Lai atvieglotu koda ievadīšanu, eksistē '''vizuālais redaktors''' (kreisā puse). Noklikšķinot uz noteikts koda rindas (kura var būt nepilnīgi uzrakstīta), vizuālais redaktors parādīs izvēļu joslu ar atslēgvārdiem, nosaukumiem un parametriem, kurus varētu lietot šajā koda rindā (vai <code>when ... end</code> koda blokā). Lai aktivizētu vizuālo redaktoru, nepieciešams vai nu sākt rakstīt kodu, vai arī nospiest vienu no pogām "Add statement" vai "Add condition".
+Lai atvieglotu koda ievadīšanu, eksistē '''vizuālais redaktors''' (labā puse). Noklikšķinot uz noteikts koda rindas (kura var būt nepilnīgi uzrakstīta), vizuālais redaktors parādīs izvēļu joslu ar atslēgvārdiem, nosaukumiem un parametriem, kurus varētu lietot šajā koda rindā (vai <code>when ... end</code> koda blokā). Lai aktivizētu vizuālo redaktoru, nepieciešams vai nu sākt rakstīt kodu, vai arī nospiest vienu no pogām "Add statement" vai "Add condition".
 Lai '''pārbaudītu''', vai jūsu sintakse ir korekta, nospiediet "Compile" pogu. Tiks palaists programmas būvēšanas process, kas vai nu parādīs sintakses kļūdas, vai novedīs līdz paziņojumam par veiksmīgu procesa pabeigšanos. Ja tas nenotiek automātiski, programmas būvēšanās stāvokli iespējams redzēt, aktivizējot "Info" izvēlni apakšējā darbvirsmas daļā.
-Lai '''izmēģinātu''' uzlādētu programmu uz motes, nospiediet "Upload" pogu. Tehnisku operētājsistēmas un aparatūras problēmu dēļ uzlādēšana var neizdoties a pirmo mēģinājumu, Tādā gadījumā jāmēģina atkārtoti. Ja neizdodas arī ar otro reizi, pārbaudiet, vai mote ir pilnībā iesprausta. Variet arī lūgt instruktora palīdzību. Informāciju par šo procesu iespējams redzēt "Info" izvēlnē apakšējā darbvirsmas daļā.
+Lai '''izmēģinātu''' uzlādētu programmu uz motes, nospiediet "Upload" pogu. Tehnisku operētājsistēmas un aparatūras problēmu dēļ uzlādēšana var neizdoties ar pirmo mēģinājumu, Tādā gadījumā jāmēģina atkārtoti. Ja neizdodas arī ar otro reizi, pārbaudiet, vai mote ir pilnībā iesprausta. Variet arī lūgt instruktora palīdzību. Informāciju par šo procesu iespējams redzēt "Info" izvēlnē apakšējā darbvirsmas daļā.
 Sensoru mezgls var sazināties pa seriālo saskarni (sūtīt diagnostiskus rakstveida ziņojumus) ar datoru, kuram tas ir pieslēgts. Lai '''klausītos''' šos ziņojumus, jums jāaktivizē sadaļa "Listen module 1" apakšējā panelī un jānospiež tur "Start listening" poga. Lai izpildītu jums izsniegtos programmēšanas uzdevumus, seriālās saskarnes izmantošana programmas tekstā nav obligāta. Ja seriālās saskarnes izmantošana programmas tekstā nav norādīta, ziņojumi netiek sūtīti.