Difference between revisions of "SEAL Components"
(New page: == Sensors == === Real sensors === ==== Light ==== ==== Humidity ==== ==== Temperature ==== ==== AnalogIn ==== ==== DigitalIn ==== === Pseudosensors === ==== Constant ==== ==== Counter...) |
|||
| Line 1: | Line 1: | ||
== Introduction == |
|||
Most of SEAL application syntax is based on component (sensors, LEDs, output channels etc.) use case descriptions. |
|||
The description of a component use case contains the name of the component followed by a list of parameters. For example, the line: |
|||
use Beeper, times 10, period 100ms; |
|||
tells to use Beeper component for 10 times with 100 millisecond period (i.e. beep for one second with 10Hz on/off frequency). |
|||
== Parameters == |
|||
A parameter is described by parameter name followed by optiona parameter value. |
|||
For example, <code>period 1h</code> or <code>on</code> are both valid parameter descriptions. |
|||
==== Parameter value formats === |
|||
* Integer: a whole number, for example 1, 100, 1234 |
|||
* Boolean: true/false value, for example True, False |
|||
* String: a sequence of ASCII symbols, for example "hello world" |
|||
* Time value is an integer with an optional suffix, for example 13min |
|||
** '''h''' - hours |
|||
** '''min''' - minutes |
|||
** '''s''' - seconds |
|||
** '''ms''' - milliseconds. |
|||
* If no suffix is specified, the value is treated as milliseconds. |
|||
If only parameter name is specified, the default value (usually 0 or False) is used. |
|||
==== Parameters for all components ==== |
|||
'''id''' (integer) - object identifier |
|||
'''period''' (time value) - the use/read period |
|||
'''once''' (boolean) - use just once |
|||
'''times''' (integer) - use just the number of times ("times 1" is the same as once) |
|||
'''duration''' (time value) - use just for a specific duration (time period) since first used |
|||
'''pattern''' (pattern name) - read/use using a specific time valu patter. |
|||
==== Sensor-specific parameters ==== |
|||
'''turnOnOff''' (boolean) - turn on the sensor before reading and off afterwards. By default the sensors are on whole time. This parameter can be used to save energy. |
|||
'''cache''' (boolean) - use cache to store and retrieve sensor values? By default, all sensors are read every time they are accessed. |
|||
==== Actuator-specific parameters ==== |
|||
'''on''' (boolean) - turn the component on |
|||
'''off''' (boolean) - turn the component off |
|||
'''blink''' (boolean) - turn the component on, then off (using "period" parameter) |
|||
==== Outputs ==== |
|||
'''agregate''' (boolean) - if true, then a packet is formed; if no, then values are sent indiviually. True by default for all except serial port. |
|||
== Components == |
|||
== Sensors == |
== Sensors == |
||
| Line 4: | Line 56: | ||
==== Light ==== |
==== Light ==== |
||
Sample light reading. |
|||
Parameters: all sensor parameters. |
|||
==== Humidity ==== |
==== Humidity ==== |
||
Sample air humidity sensor reading. |
|||
Parameters: all sensor parameters. |
|||
==== Temperature ==== |
==== Temperature ==== |
||
Sample air humidity sensor reading. |
|||
Parameters: all sensor parameters. |
|||
==== AnalogIn ==== |
==== AnalogIn ==== |
||
Parameters: |
|||
* all sensor parameters |
|||
* '''channel''' (integer) - which channel to read. Possible values depend on device. |
|||
==== DigitalIn ==== |
==== DigitalIn ==== |
||
Revision as of 11:10, 5 October 2012
Contents
Introduction
Most of SEAL application syntax is based on component (sensors, LEDs, output channels etc.) use case descriptions.
The description of a component use case contains the name of the component followed by a list of parameters. For example, the line:
use Beeper, times 10, period 100ms;
tells to use Beeper component for 10 times with 100 millisecond period (i.e. beep for one second with 10Hz on/off frequency).
Parameters
A parameter is described by parameter name followed by optiona parameter value.
For example, period 1h or on are both valid parameter descriptions.
= Parameter value formats
- Integer: a whole number, for example 1, 100, 1234
- Boolean: true/false value, for example True, False
- String: a sequence of ASCII symbols, for example "hello world"
- Time value is an integer with an optional suffix, for example 13min
- h - hours
- min - minutes
- s - seconds
- ms - milliseconds.
- If no suffix is specified, the value is treated as milliseconds.
If only parameter name is specified, the default value (usually 0 or False) is used.
Parameters for all components
id (integer) - object identifier period (time value) - the use/read period once (boolean) - use just once times (integer) - use just the number of times ("times 1" is the same as once) duration (time value) - use just for a specific duration (time period) since first used pattern (pattern name) - read/use using a specific time valu patter.
Sensor-specific parameters
turnOnOff (boolean) - turn on the sensor before reading and off afterwards. By default the sensors are on whole time. This parameter can be used to save energy. cache (boolean) - use cache to store and retrieve sensor values? By default, all sensors are read every time they are accessed.
Actuator-specific parameters
on (boolean) - turn the component on off (boolean) - turn the component off blink (boolean) - turn the component on, then off (using "period" parameter)
Outputs
agregate (boolean) - if true, then a packet is formed; if no, then values are sent indiviually. True by default for all except serial port.
Components
Sensors
Real sensors
Light
Sample light reading.
Parameters: all sensor parameters.
Humidity
Sample air humidity sensor reading.
Parameters: all sensor parameters.
Temperature
Sample air humidity sensor reading.
Parameters: all sensor parameters.
AnalogIn
Parameters:
- all sensor parameters
- channel (integer) - which channel to read. Possible values depend on device.
