pamas

Purpose:

      Example spec file:
      # Note: Non-printing characters ( i.e. control characters ) are  
      # represented by <XXX> where XXX represents the numonic for the  
      # control character ( i.e. CR for carriage return ) or a numeric  
      # value for the ASCII character in decimal ( i.e. 127 for delete ).  
      #  
      #—————————————————————-  
      #  
      # DEVICE NAME, BAUD RATE, BYTE_LENGTH, PARITY, STOP_BITS  
      #  
      # To set up the XXXXXXXXXXXXXXXXXx Station  
      #  
      #/dev/hst3, 1200, 8, none, 1  
      /dev/ttyS0, 115200, 8, none, 1  
      #  
      #—————————————————————-  
      #  
      # ACKNOWLEDGE CHARACTER  
      #  
      # This is often a single ( i.e. ACK ) or pair of characters (i.e. CRLF )  
      # that the field unit returns to acknowledge correct receipt of a command.  
      #  
      # -1 = none  
      #  
      -1  
      #  
      #—————————————————————-  
      #  
      # COMMAND MESSAGE STRUCTURE  
      #  
      # This section defines the message structure elements used to control  
      # the field unit.  
      #  
      #  
      # Header String  
      # -1 = none  
      <STX>  
      #  
      # Station/Unit Identifier  
      # -1 = none  
      -1  
      #  
      # Trailer String  
      # -1 = none  
      #<CR>  
      <ETX>  
      #  
      # Checksum method  
      # -1 = none  
      #  
      #  1 = CCITT excludes last character uses 0x1021 XOR  
      #  2 = truncated byte sum of all characters  
      #  3 = byte-wise XOR of all previous bytes in package,  
      #      result in 2 ASCII chars, always after message – pierburg smoke meter.  
      -1  
      #  
      # Structure  
      #  
      # This section shows the sequence of message elements  
      # H = header string  
      # S = station identifier  
      # M = message  
      # T = trailer string  
      # C = crc  
      #  
      HMT  
      #  
      #——————————————————————  
      #  
      # RESPONSE MESSAGE STRUCTURE  
      #  
      # This section defines the response message structure elements from  
      # the field unit.  
      #  
      #  
      # Header String  
      # -1 = none  
      # STX = 02h = 02 dec  
      <STX>  
      #  
      # Station/Unit Identifier  
      # -1 = none  
      -1  
      #  
      # Trailer String  
      # -1 = none  
      <ETX>  
      #  
      # CRC method  
      #  
      # -1 = none  
      #  1 = CCITT excludes last character uses 0x1021 XOR  
      #  2 = truncated byte sum of all characters  
      #  3 = byte-wise XOR or all previous bytes in package  
      -1  
      #  
      # Structure  
      #  
      # This section shows the sequence of message elements  
      # H = header string  
      # S = station identifier  
      # M = message  
      # T = trailer string  
      # C = crc  
      #  
      HMT  
      #  
      #—————————————————————–  
      #  
      # COMMAND TABLE  
      #  
      # This table contains expected commands from the client task.  
      #  
      # Each command contains the following information  
      #  
      #  Identifier string   – passed by the requestor  
      #  Message string      – sent when the identifier string is received  
      #  Response identifier – successful response expected (* for none)  
      #  Number of retries   – number of retries to attempt if response is not success  
      #  Timeout             – time in seconds after command is sent for response  
      #  
      #  NOTE: %xyz represents a passed parameter  
      #        where x = number of places  
      #              y = type using C printf formats  
      #              z = parameter number  
      #        Each entry is completed with !  
      #        The table is completed with !!  
      #  
      #  
      !!  
      #  
      #—————————————————————–  
      #  
      # RESPONSE TABLE  
      #  
      # This table contains the unsolicited responses from the device  
      #  
      # Each response contains the following information  
      #  
      #  Message string    – received from the device  
      #  Identifier string – sent to the requestor  
      #  
      #  NOTE: %xyz represents a passed parameter  
      #        where x = number of places  
      #              y = type using C printf formats  
      #              z = parameter number  
      #        Each entry is completed with !  
      #        The table is completed with !!  
      #  
 
       %80s1 %s2 %s3 %s4 %s5 %s6 %s7 %s8 %s9 %s10 %s11 %s12  
      Results:  
      !  
      !!  
 
      #  
      # AUX EVENT TABLE  
      #  
      # This table contains the command(s) to perform upon receipt  
      # of a an asynchronous event.  
      #  
      # This table is only active if a aux name is specified  
      # with the invocation of this instance of ASC and if the table is not empty.  
      #  
      # Each command contains the following information  
      #  
      #  Message string    – sent when the identifier string is received  
      #  Respose string    – sucessful response expected  
      #  Number of retries – number of retries to attempt if response is not sucess  
      #  Timeout           – time in seconds after command is sent for response  
      #  
      #  NOTE: %xyz represents a passed parameter  
      #        where x = number of places  
      #              y = type using C printf formats  
      #              z = parameter number  
      #        Each entry is completed with !  
      #        The table is completed with !!  
      #  
      !!  
      #  
      #