CAAPE User's Manual - ALSTOM Signaling Inc.

Using the Graphical Simulator10.10.3.1. Identifying Serial ProtocolsSerial protocols are identified by name in CAAPE input files: DT8, K2, MCS1, etc.Internally, the CAAPE uses numerical values which are cross-referenced to informationin the protname.dat, protocol.dat and twc.dat files in the CAAPE's CTCFILES directory.To find the numerical identifier for a non-vital serial protocol, go to protname.dat in theCTCFILES directory and find the value associated with the desired protocol name. ForTWC / NVTWC protocols, do the same with twc.dat.10.10.3.2. Protocol Definition FilesThe protocol identifier is used by the CAAPE to include protocol-specific information inthe prom files. The CAAPE also outputs the protocol numbers in the applicationdefinition file which is read by the Graphical Simulator. The Graphical Simulator canthen use the protocol identifier numbers to read Protocol Definition Files telling it how toperform serial communications based on the specific protocol assigned to a given serialport or TWC / NVTWC board.The master lists of available Protocol Definition files are contained in the Protocolsdirectory off the main Graphical Simulator directory. They are SimProtocols.dat andSimTwcProtocols.dat respectively for non-vital serial and TWC / NVTWC. These filescontain a series of records linking available protocol identification numbers to theircorresponding Protocol Definition files. Protocol identification numbers must be thesame as those used by the CAAPE.Protocol Definition files contain symbol declarations and simulation logic statementswhich are executed once per cycle of the main application logic. Logic statements caninclude:• Any normal simulation logic statement.• Special predefined simulator logic functions, especially those provided for messageprocessing and for accessing special message bits.• Special Event Handler functions which are automatically called when certain serialcommunications events occur.See 12.4. Protocol Definition File Format for details on how to construct a ProtocolDefinition file.P2512A, Rev. Oct/09 10–36 Alstom Signaling Inc.