Module Coordinator-TMM – step 0030 – December 2009

1 Purpose of SrrModCoordTm

SrrModCoordTm coordinates activities of the SRR Framework regarding trains and vehicles within one module.

If a module contains tracks, it instantiates the SrrModCoordTm exactly once (in each scene instance). The instance is added to the srrModCoordModules field of the base module of the module coordinator SrrModCoord.x3d.

SrrModCoordTm keeps a list of all announced track edges of this module (their objId) and of all announced track nodes of this module (their objId).

Furthermore, SrrModCoordTm keeps a list of all setup points within one module.

SrrModCoordTm provides the user interface for the module’s main file (interface uiMod, which is described in this document).

2 User Interface of SrrModCoordTm (uiMod)

SrrModCoordTm is an external prototype, available in the directory srr/.

<ProtoDeclare name='SrrModCoordTm'>

<ProtoInterface>

<field accessType='inputOutput' name='objType' type='SFString' value='SrrModCoordTm'/>

<field accessType='inputOutput' name='version' type='SFFloat' value='0.0023'/>

<field accessType='inputOutput' name='moduleId' type='SFString' value='TrainManager'/>

<field accessType='inputOutput' name='modParam' type='SFNode'/>

<field accessType='inputOutput' name='localTraceLevel' type='SFInt32' value='1'/>

<field accessType='outputOnly' name='initialized' type='SFNode'/>

<field accessType='inputOnly' name='registerVehicles' type='MFString'/>

</ProtoInterface>

The fields of the user interface can be arranged according to the following categories:

x) Modularity of the SRR Framework

The fields moduleId, modParam, localTraceLevel and initialized are used by the module coordinator SrrModCoord.x3d and need not be further described here.

x) Vehicle and Train Management (Vehicle Registration/Setup Points, Train/Vehicle Status)

The field registerVehicles has nearly the same semantics as the field registerVehicles of SrrControlTm.x3d and is described there. It can be used after successful initialization of the module coordinator. A difference is, that the SrrModCoordTm will add the own module name as a prefix for the vehicle ID.