DataMuseum.dk

Presents historical artifacts from the history of:

CR80 Wang WCS documentation floppies

This is an automatic "excavation" of a thematic subset of
artifacts from Datamuseum.dk's BitArchive.

See our Wiki for more about CR80 Wang WCS documentation floppies

Excavated with: AutoArchaeologist - Free & Open Source Software.


top - download

⟦063f69bd0⟧ Wang Wps File

    Length: 15647 (0x3d1f)
    Types: Wang Wps File
    Notes: PC/PSP/001                
    Names: »3845A «

Derivation

└─⟦375fa32af⟧ Bits:30006243 8" Wang WCS floppy, CR 0325A
    └─ ⟦this⟧ »3845A « 

WangText



)…09…)…86…1  
      
      
      
      
      
      
      
 …02…     
     …02… 
  …02…    
    

…02…PC/PSP/001
    

…02…PMO/830624…02……02…
 
PC LTU
 DRIVER
 PRODUCT
 SPECIFICATION
…02……02…    PC








                    T̲A̲B̲L̲E̲ ̲O̲F̲ ̲C̲O̲N̲T̲E̲N̲T̲S̲


    1   SCOPE ....................................... 
        001
      1.1 INTRODUCTION .............................. 
          001
      1.2 ABBREVIATIONS ............................. 
          001
      1.2 INTERFACE BLOCK DIAGRAM ................... 
          001

    2 APPLICABLE DOCUMENTS .......................... 
      002

    3 COMMANDS ...................................... 
      003
      3.1 BOOTLOAD .................................. 
          004
      3.2 CSLP ̲REOPEN ............................... 
          005
      3.3 CSLP ̲SET ̲UP ̲LINES ......................... 
          006
      3.4 CSLP ̲DISC ̲LINES ........................... 
          007
      3.5 CSLP ̲SET ̲UP ̲LINK .......................... 
          008
      3.6 CSLP ̲DISC ̲LINK ............................ 
          009
      3.7 LP ̲REQUEST ̲INPUT .......................... 
          010
      3.8 LP ̲REQUEST ̲OUTPUT ......................... 
          011
      3.9 LP ̲CANCEL ̲INPUT ........................... 
          012
      3.10  LP ̲CANCEL ̲OUTPUT ........................ 
            013
      3.11  CSLP ̲STATISTICS ......................... 
            014
      3.12  CLP ̲OPEN ̲LINK ........................... 
            015
      3.13  CLP ̲CLOSE ̲LINK .......................... 
            016
      3.14  CLP ̲SHOW ̲STATISTICS ..................... 
            017
      3.15  CLP ̲RESET ̲STASTISTICS ................... 
            018

    4 GENERAL COMPLETION CODES ...................... 
      019


1.       S̲C̲O̲P̲E̲

         The purpose of this document is to describe the functions
         performed by the PC LTU Driver.



1.1      I̲N̲T̲R̲O̲D̲U̲C̲T̲I̲O̲N̲

         The Driver is a single CR80 Process that interfaces
         a LTU to the Application Process.

         The Application Process sends commands to the Driver
         and answers are sent back to the Application Process.

         A PC LTU Driver Process can drive one LTU, the LTU
         being either a CAMPS/SCARS LTU or a CCIS LTU, so two
         PC LTU Driver Processes are required to drive both
         the CAMPS/SCARS LTU and the CCIS LTU. The two processes
         share the same program area.



1.2      A̲B̲B̲R̲E̲V̲I̲A̲T̲I̲O̲N̲S̲

         LTU     Line Termination Unit
         PC      Protocol Converter
         SCADRV  CAMPS/SCARS LTU Driver
         CISDRV  CCIS LTU Driver



1.3      I̲N̲T̲E̲R̲F̲A̲C̲E̲ ̲B̲L̲O̲C̲K̲ ̲D̲I̲A̲G̲R̲A̲M̲


     +----------------+       +--------------+       +-----------+
     ^ APPLICATION    ^-----  ^ PC LTU       ^-----  ^ LTU       ^
     ^ PROCESS        ^       ^ DRIVER       ^       ^           ^
     ^                ^ ----- ^              ^ ----- ^           ^
     +----------------+       +--------------+       +-----------+

                                                The LTU
                                             is downloaded
                                                with X25
                                             Firmware
                                                or
                                                DINDAC Firmware


2.       A̲P̲P̲L̲I̲C̲A̲B̲L̲E̲ ̲D̲O̲C̲U̲M̲E̲N̲T̲S̲

         1.  CR80 AMOS KERNEL
             PRODUCT SPECIFICATION
             CSS/302/PSP/0008

         2.  CR80 LTU I/F
             FUNCTIONAL SPECIFICATION
             CSS-MIC/040/FNC/001
             ISSUE: 5, DATE: 811104

         3.  PROTOCOL CONVERTER
             PACKAGE DESIGN SPECIFICATION
             CONTRACT SHNMO-82-9205-INF

         4.  X25 LAP (LEVEL 1 AND 2)
             PRODUCT SPECIFICATION
             CSS-MIC/0402/PSP/1014

         5.  LTU ON BOARD TEST (LOBT)
             PRODUCT SPECIFICATION
             CSS-MIC/0405/PSP/1028



3.       C̲O̲M̲M̲A̲N̲D̲S̲

         The following commands are supported by the Driver:

             BOOTLOAD

             CSLP ̲REOPEN             "only for CAMPS/SCARS

             CSLP ̲SET ̲UP ̲LINES       "only for CAMPS/SCARS

             CSLP ̲DISC ̲LINES         "only for CAMPS/SCARS

             CSLP ̲SET ̲UP ̲LINK        "only for CAMPS/SCARS

             CSLP ̲DISC ̲LINK          "only for CAMPS/SCARS

             LP ̲REQUEST ̲INPUT

             LP ̲REQUEST ̲OUTPUT

             LP ̲CANCEL ̲INPUT

             LP ̲CANCEL ̲OUTPUT

             CSLP ̲STATISTICS         "only for CAMPS/SCARS

             CLP ̲OPEN ̲LINK           "only for CCIS

             CLP ̲CLOSE ̲LINK          "only for CCIS

             CLP ̲SHOW ̲STATISTICS     "only for CCIS

             CLP ̲RESET ̲STATISTICS    "only for CCIS



3.1      B̲O̲O̲T̲L̲O̲A̲D̲

         Function:
           For SCADRV the X25 Firmware is downloaded.
           For CISDRV the DINDAC Firmware is downloaded.

           *  Interrupts from the LTU are reserved by the Driver
           *  The LTU is set into Bootload Mode
           *  The LTU Firmware is downloaded from CR80 Memory
              (EPROM)
           *  The LTU is enabled

         Command:
           This command is executed when the Application Process
           sends a message to the Driver.

           Command Message Buffer:
           Word 0: BOOTLOAD ̲ID

         Response:
           When the Driver has executed this command, an answer
           is sent back to the Application Process.

           Answer Message Buffer:
           Word 0: BOOTLOAD ̲ID
           Word 1: Completion Code

         Completion Codes:                      SCADRV   CISDRV

           Ok                               =   #0000    #0000
           Bad reserve interrupt            =   #E012    #F012
           Bootload not implemented         =   #E013    #F013
           Bootload failed at first status  =   #E014    #F014
           Bootload failed at byte count    =   #E015    #F015
           Bootload failed at last status   =   #E016    #F016

           and the completion code listed in the section 'General
           Completion Codes'.


3.2      C̲S̲L̲P̲ ̲R̲E̲O̲P̲E̲N̲

         Function:
           REOPEN command to CAMPS/SCARS LTU
           Reopen parameters are read from the abs addr specified
           in the Command Message Buffer word 1.

         Command:
           This command is executed when the Application Process
           sends a message to the Driver.

           Command Message Buffer:
           Word 0:   CSLP ̲REOPEN ̲ID
           Word 1:   Abs addr for reopen parameters
           Word 2:   Parameter count in bytes

         Response:
           When the Driver receives response for this command,
           an answer is sent back to the application process.

           Answer Message Buffer:
           Word 0:   CSLP ̲REOPEN ̲ID
           Word 1:   Completion Code

           Completion Codes:                             SCADRV

              Ok                                =        #0000

              and the comletion codes listed in the section
              'General Completion Codes'.


3.3      C̲S̲L̲P̲ ̲S̲E̲T̲ ̲U̲P̲ ̲L̲I̲N̲E̲S̲

         Function:
           SET ̲UP ̲LINES command to CAMPS/SCARS LTU

         Command:
           This command is executed when the Application Process
           sends a message to the Driver.

           Command Message Buffer:
           Word 0:   CSLP ̲SET ̲UP ̲LINES ̲ID

         Response:
           When the Driver receives response for this command,
           an answer is sent back to the Application Process.

           Answer Message Buffer:
           Word 0:   CSLP ̲SET ̲UP ̲LINES ̲ID
           Word 1:   Completion Code

           Completion Codes:                             SCADRV

           Ok                                   =        #0000
           Protocol level 2 not disconnected    =        #E001

           and the completion codes listed in the section 'General
           Completion Codes'.


3.4      C̲S̲L̲P̲ ̲D̲I̲S̲C̲ ̲L̲I̲N̲E̲S̲

         Function:
           DISC ̲LINES command to CAMPS/SCARS LTU

         Command:
           This command is executed when the Application Process
           sends a message to the Driver.

           Command Message Buffer:
           Word 0:   CSLP ̲DISC ̲LINES ̲ID

         Response:
           When the Driver receives response for this command,
           an answer is sent back to the Application Process.

           Answer Message Buffer:
           Word 0:   CSLP ̲DISC ̲LINES ̲ID
           Word 1:   Completion Code

           Completion Codes:                             SCADRV

              Ok                                =        #0000
              Protocol level 2 not disconnected =        #E001

              and the completion codes listed in the section
              'General Completion Codes'.


3.5      C̲S̲L̲P̲ ̲S̲E̲T̲ ̲U̲P̲ ̲L̲I̲N̲K̲

         Function:
           SET ̲UP ̲LINK command to CAMPS/SCARS LTU

         Command:
           This command is executed when the Application Process
           sends a message to the Driver.

           Command Message Buffer:
           Word 0:   CSLP ̲SET ̲UP ̲LINK ̲ID

         Response:
           When the Driver has executed the command, an answer
           is sent back to the Application Process.

           Answer Message Buffer:
           Word 0:   CSLP ̲SET ̲UP ̲LINK ̲ID
           Word 1:   Completion Code

           Completion Codes:                             SCADRV

              Ok                                =        #0000
              Protocol level 2 not disconnected =        #E001

              and the completion codes listed in the section
              'General Completion Codes'.


3.6      C̲S̲L̲P̲ ̲D̲I̲S̲C̲ ̲L̲I̲N̲K̲

         Function:
           DISC ̲LINK to CAMPS/SCARS LTU

         Command:
           This command is executed when the Application Process
           sends a message to the Driver.

           Command Message Buffer:
           Word 0:   CSLP ̲DISC ̲LINK ̲ID

         Response:
           When the Driver receives response for this command,
           an answer is sent back to the Application Process.

           Answer Message Buffer:
           Word 0:   CSLP ̲DISC ̲LINK ̲ID
           Word 1:   Completion Code

           Completion Codes:                             SCADRV

              Ok                                =        #0000
              Protocol level 2 not connected    =        #E002

              and the completion codes listed in the section
              'General Completion Codes'.


3.7      L̲P̲ ̲R̲E̲Q̲U̲E̲S̲T̲ ̲I̲N̲P̲U̲T̲

         Function:
           REQUEST ̲INPUT command to CAMPS/SCARS or CCIS LTU
           The Application Process input buffer abs addr must
           be specified in the Command Message Buffer word 1.
           The number of bytes received is specified in Answer
           Message Buffer word 2.

           When the LTU responds to the command, the driver
           transfers N bytes to the CR80 buffer. N is specified
           in Answer Message Buffer word 2.

         Command:
           This command is executed when the Application Process
           sends a message to the Driver.

           Command Message Buffer:
           Word 0:   LP ̲REQUEST ̲INPUT ̲ID
           Word 1:   Abs addr for input data

         Response:
           When the Driver receives rsponse for this command,
           an answer is sent back to the Application Process.

           Answer Message Buffer:
           Word 0:   LP ̲REQUEST ̲INPUT ̲ID
           Word 1:   Completion Code
           Word 2:   Bytes

           Completion Codes:                    SCADRV   CISDRV

           Ok                               =   #0000    #0000

           and the completion codes listed in the section 'General
           Completion Codes'.


3.8      L̲P̲ ̲R̲E̲Q̲U̲E̲S̲T̲ ̲O̲U̲T̲P̲U̲T̲

         Function:
           REQUEST ̲OUTPUT command to CAMPS/SCARS or CCIS LTU

         Command:
           This command is executed when the Application Process
           sends a message to the Driver.

           Command Message Buffer:
           Word 0:   LP ̲REQUEST ̲OUTPUT ̲ID
           Word 1:   Abs addr for output data
           Word 2:   Bytes

         Response:
           When the Driver receives response for this command,
           an answer is sent back to the Application Process.

           Answer Message Buffer:
           Word 0:   LP ̲REQUEST ̲OUTPUT ̲ID
           Word 1:   Completion Code

           Completion Codes:                    SCADRV   CISDRV

           Ok                               =   #0000    #0000

           and the completion codes listed in the section 'General
           Completion Codes'.


3.9      L̲P̲ ̲C̲A̲N̲C̲E̲L̲ ̲I̲N̲P̲U̲T̲

         Functions:
           CANCEL ̲INPUT command to CAMPS/SCARS to CCIS LTU

         Command:
           This command is executed when the Application Process
           sends a message to the Driver.

           Command Message Buffer:
           Word 0:   LP ̲CANCEL ̲INPUT ̲ID

         Response:
           When the Driver receives response for this command,
           an answer is sent back to the Application Process.

         Answer Message Buffer:
         Word 0:     LP ̲CANCEL ̲INPUT ̲ID
         Word 1:     Completion Code

         Completion Codes:                      SCADRV   CISDRV

           Ok                               =   #0000    #0000

           and the completion codes listed in the section 'General
           Completion Codes'.


3.10     L̲P̲ ̲C̲A̲N̲C̲E̲L̲ ̲O̲U̲T̲P̲U̲T̲

         Function:
           CANCEL ̲INPUT command to CAMPS/SCARS or CCIS LTU

         Command:
           This commmand is executed when the Application Process
           sends a message to the Driver.

           Command Message Buffer:
           Word 0:   LP ̲CANCEL ̲OUTPUT ̲ID

         Response:
           When the driver receives response for this command,
           an answer is sent back to the Application Process.

           Answer Message Buffer:
           Word 0:   LP ̲CANCEL ̲OUTPUT ̲ID
           Word 1:   Completion Code

           Completion Codes:                    SCADRV   CISDRV

              Ok                            =   #0000    #0000

              and the completion codes listed in the section
              'General Completion Codes'.


3.11     C̲S̲L̲P̲ ̲S̲T̲A̲T̲I̲S̲T̲I̲C̲S̲

         Function:
           STATISTICS command to CAMPS/SCARS LTU
           Statistics parameters are read from the abs addr
           specified in Command Message Buffer word 1. 7 bytes
           are transferred to the LTU.
           When the LTU responds to the command, the driver
           transfers 10 bytes to the CR80 Buffer.

         Command:
           This command is executed when the Application Process
           sends a message to the Driver.

           Command Message Buffer:
           Word 0:   CSLP ̲STATISTICS ̲ID
           Word 1:   Abs addr to parameters/statistic data

         Response:
           When the Driver receives response for this command,
           an answer is sent back to the Application Process.

           Answer Message Buffer:
           Word 0:   CSLP ̲STATISTICS ̲ID
           Word 1:   Completion Code

           Completion Codes:                    SCADDR

              Ok                            =   #0000

              and the completion codes listed in the section
              'General Completion Codes'.


3.12     C̲L̲P̲ ̲O̲P̲E̲N̲ ̲L̲I̲N̲K̲

         Function:
           OPEN ̲LINK command to CCIS LTU
           Open-link parameters are read from the abs addr specified
           in the Command Message Buffer word 1.

         Command:
           This command is executed when the Application Process
           sends a message to the Driver.

           Command Message Buffer:
           Word 0:   CLP ̲OPEN ̲LINK ̲ID
           Word 1:   Abs addr for parameters
           Word 2:   Parameter count in bytes

         Response:
           When the Driver receives response for this command,
           an answer is sent back to the Application Process.

           Answer Message Buffer:
           Word 0:   CLP ̲OPEN ̲LINK ̲ID
           Word 1:   Completion Code

           Completion Codes:                             CISDRV

              Ok                            =            #0000

              and the completion codes listed in the section
              'General Completion Codes'.


3.13     C̲L̲P̲ ̲C̲L̲O̲S̲E̲ ̲L̲I̲N̲K̲

         Function:
           CLOSE ̲LINK command to CCIS LTU

         Command:
           This command is executed when the Application Process
           sends a message to the Driver.

           Command Message Buffer:
           Word 0:   CLP ̲CLOSE ̲LINK ̲ID

         Response:
           When the Driver receives response for this command,
           an answer is sent bck to the Application Process.

           Answer Message Buffer:
           Word 0:   CLP ̲CLOSE ̲LINK ̲ID
           Word 1:   Completion Code

           Completion Codes:                             CISDRV

              Ok                            =            #0000

              and the completion codes listed in the section
              'General Completion Codes'.



3.14     C̲L̲P̲ ̲S̲H̲O̲W̲ ̲S̲T̲A̲T̲I̲S̲T̲I̲C̲S̲

         Function:
           SHOW ̲STATISTICS command to CCIS LTU

           When the LTU responds to this command, the Driver
           transfers 8 bytes to the CR80 buffer.

         Command:
           This command is executed when the Application Process
           sends a message to the Driver.

           Command Message Buffer:
           Word 0:   CLP ̲SHOW ̲STATISTICS ̲ID
           Word 1:   Abs addr to statistics data

         Response:
           When the Driver received response for this command,
           an answer is sent back to the Application Process.

           Answer Message Buffer:
           Word 0:   CLP ̲SHOW ̲STATISTICS ̲ID
           Word 1:   Completion Code

           Completion Code                               CISDRV

              Ok                            =            #0000

              and the completion codes listsed in the section
              'General Completion Codes'.



3.15     C̲L̲P̲ ̲R̲E̲S̲E̲T̲ ̲S̲T̲A̲S̲T̲I̲S̲T̲I̲C̲S̲

         Function:
           RESET ̲STATISTICS command to CCIS LTU

         Command:
           This command is executed when the Application Process
           sends a message to the Driver.

           Command Message Buffer:
           Word 0:   CLP ̲STATISTICS ̲ID

         Response:
           When the Driver receives response for this command,
           an answer is sent back to the Application Process.

           Answer Message Buffer:
           Word 0:   CLP ̲STATISTICS ̲ID
           Word 1:   Completion Code

           Completion Codes:                             CISDRV

              Ok                            =            #0000

              and the completion codes listed in the section
              'General Completion Codes'.


4.       G̲E̲N̲E̲R̲A̲L̲ ̲C̲O̲M̲P̲L̲E̲T̲I̲O̲N̲ ̲C̲O̲D̲E̲S̲

         These are the completion codes that the Driver generate.
         They can occur in all commands.

         Completion Codes:                      SCADRV   CISDRV

           Flow Error                       =   #E017    #F017
           Buffer Error                     =   #E018    #F018
           Command Error                    =   #E019    #F019

         Flow Error:
           A command X is sent, before response is sent back
           to the previous command X.

         Buffer Error:
           The LTU does not handle the Shared RAM Buffers correctly.

         Command Error:
           Two possibilities exists:
              1)     The Shared RAM Buffer size is too small
              2)     The Tx full semaphore is not set.