IL:signalIndicator

From railML 3 Wiki
Jump to navigation Jump to search

Introduction

Documentation

Syntax

Autoexport from the XML-Schema for element IL:signalIndicator of railML® version 3.2
Documentation Definition of an additional signal indicator which appears on the HMI near the signal.
Subschema interlocking
Parents* signalIndicators
Children designator (0..*), hasCommand (0..*), hasIndication (0..*)
Attributes:
  • indicatorType: The type of the additional signal indicator which appears on the HMI near the signal. (optional; xs:string; patterns: other:w{2,})
Possible values:
  • cautiousDriving: type of the additional signal indicator which is shown on HMI as separate element
  • other,

  • elementNumber: number of the element in the set of interlocking data (optional; xs:nonNegativeInteger),

  • id: unique identifier (obligatory; xs:string; patterns: (urn:uuid:)?[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}|{[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}}); compare: Dev:Identities
*Notice:
Elements may have different parent elements. As a consequence they may be used in different contexts.
Please, consider this as well as a user of this wiki as when developing this documentation further.
Aspects that are only relevant with respect to one of several parents should be explained exclusively in the documentation of the respective parent element.

This element does not appear in railML® 3.1 within the IL subschema. It is available only in railML® 3.2. Do not hesitate to contact railML.org for further questions.


Changes 3.1→3.2

Introduced with version 3.2.

Semantics

Best Practice / Examples

The <signalIndicator> element is for rather special purpose. In some cases the signal is fitted with additional indicators on the mast which might be activated in combination of the normal signal aspect or even completely independent. However, the indicator status is to be indicated with a separate graphic element on the HMI independent of the signal status according to the rules of the infrastructure manager. A good example is the subsidary signal for cautious driving in Norway.

CautiousDriving.png

In order to access and control this additional element for the <signalBox> or the <controller> (HMI) this asset is defined.

  • @elementNumber - A positive integer number unique within one <signalBox> to index the element in internal lists of engineering data.
  • @id - The unique identifier used to reference this element within railML.
  • @indicatorType - There is currently only cautiousDriving defined for use. Other values might be defined to extend the list.
  • <hasCommand> - In case the indicator has commands (independent from the signal) the can be referred here. They need to be predefined for the <specificInfrastructureManager>.
  • <hasIndication> - Any kind of defined status indication can be referred here.
<rail3:signalIndicator elementNumber="0" id="" indicatorType="cautiousDriving">
	<rail3:designator description="" entry="" register=""/>
	<rail3:hasCommand entityCode="" ref=""/>
	<rail3:hasIndication entityCode="" ref=""/>
</rail3:signalIndicator>


Additional Information

Notes

Open Issues