Next: , Previous: Specification, Up: Input file format


5.3 Component declaration

  (5) component             ::= "component" component-name component-body ";"
  (6) component-name        ::= identifier
  (7) component-body        ::= [ "{" exports "}" ]

  (8) exports               ::= { export }
  (9) export                ::= idl-statement
                              | property
                              | ids
                              | task
                              | port
                              | attribute
                              | service

 (10) component-property    ::= ( "doc" string-literals | "version"
                                string-literals | "lang" string-literals |
                                "email" string-literals | "requires"
                                string-list | "codels-require" string-list
                                | "clock-rate" const-expr time-unit |
                                  "provides" interface-list | "uses"
                                  interface-list ) ";"

A component declaration describes a instance of the GenoM component model. It is defined by a unique name (an identifier) that also defines an IDL scope for any embedded types.

Components export objects from the GenoM component model, namely: IDS (see IDS declaration), tasks (see Task declaration), ports (see Port declaration), attributes (see Attribute declaration) or services (see Service declaration).

Components may also define new types via IDL statements. These types will be defined within the component scope.

A number of properties can be attached to a component:

doc
A string that describes the functionality of the component.
version
The component version number, as a string
lang
The programming language of the codels interface.
email
A string containing the e-mail address of the author of the component.
requires
A list of dependencies of the component (see #pragma requires). Each string should contain a package name in pkg-config format.
codels-requires
A list of dependencies of the codels. Each string should contain a package name in pkg-config format.
clock-rate
The period of the internal component clock. It is usually not necessary to define it explicitly. If the component defines periodic task, the component clock period will be automatically computed as the greatest common divisor of the period of all periodic tasks.
provides
A list of interfaces (see Interface declaration) that the component implements. All objects from the interface are imported as-is into the component description. Ports and services may be further refined once imported, typically by defining codels (see Codel declaration) that implement the services.
uses
A list of interfaces (see Interface declaration) that the component uses. Ports are imported in the opposite direction (e.g. a port out is imported as a port in. Services are imported as remote objects that can be accessed via codel parameters (see Codel declaration). Other objects are imported as-is.