Protogate Freeway 3600 Betriebsanweisung

Stöbern Sie online oder laden Sie Betriebsanweisung nach Server Protogate Freeway 3600 herunter. Protogate Freeway 3600 User`s guide Benutzerhandbuch

  • Herunterladen
  • Zu meinen Handbüchern hinzufügen
  • Drucken
  • Seite
    / 186
  • Inhaltsverzeichnis
  • LESEZEICHEN
  • Bewertet. / 5. Basierend auf Kundenbewertungen

Inhaltsverzeichnis

Seite 1 - Programmer’s Guide

Protogate, Inc.12225 World Trade Drive, Suite RSan Diego, CA 92128ADCCP NRMProgrammer’s GuideDC 900-1317JApril 2005

Seite 2

10 DC 900-1317JADCCP NRM Programmer’s Guide

Seite 3 - Contents

100 DC 900-1317JADCCP NRM Programmer’s GuideThe DLI and TSI configuration process is a part of the loopback testing proceduredescribed in Appendix C a

Seite 4

5: ADCCP NRM Link Configuration Using dlicfgDC 900-1317J 101UNIX example: freeway/client/op-sys/bin/tsicfg nrmaltcfgNT example: freeway\client\op-sys\

Seite 5

102 DC 900-1317JADCCP NRM Programmer’s Guideration files you created in Step 4 and Step 5 into the bin directory for your partic-ular TCP/IP package.@

Seite 6

5: ADCCP NRM Link Configuration Using dlicfgDC 900-1317J 103Figure 5–1: DLI and TSI Configuration ProcessApplicationDLITSITransportEnvironment2836dlic

Seite 7

104 DC 900-1317JADCCP NRM Programmer’s Guide5.2 DLI Session ConfigurationThe DLI text configuration file used by the dlicfg program consists of the fo

Seite 8 - 8 DC 900-1317J

5: ADCCP NRM Link Configuration Using dlicfgDC 900-1317J 105main // DLI “main” section: //{asyncIO = “no”; // Wait for I/O completion //tsiCfgName = “

Seite 9 - List of Figures

106 DC 900-1317JADCCP NRM Programmer’s GuideTable 5–1: ADCCP NRM ICP Link Configuration Parameters for Using dlicfgdlicfg Option Name Default Valid Ra

Seite 10 - ADCCP NRM Programmer’s Guide

5: ADCCP NRM Link Configuration Using dlicfgDC 900-1317J 107The parameters and values shown in Ta bl e 5 –1 are described in the following places: •

Seite 11 - List of Tables

108 DC 900-1317JADCCP NRM Programmer’s Guide

Seite 12 - 12 DC 900-1317J

DC 900-1317J 109Chapter6ADCCP NRM Line-Monitor FunctionThis chapter describes the Line-Monitor function of the ADCCP NRM protocol. Whenselected, this

Seite 13 - Required Equipment

DC 900-1317J 11List of TablesTable 1–1: ADCCP NRM Data Rate and Number of Links... 28Table 2–1: ADCCP Frame Types...

Seite 14 - Organization of Document

110 DC 900-1317JADCCP NRM Programmer’s Guide6.2 Configuring the Line-Monitor FunctionWhen the Monitor Session for an ICP becomes attached, monitoring

Seite 15 - Hardware Support

6: ADCCP NRM Line-Monitor FunctionDC 900-1317J 111The normal ICP response to the Configure Monitor command is the same command(usProtCommand field set

Seite 16 - Protocol Support

112 DC 900-1317JADCCP NRM Programmer’s GuideusTime: This field of the Monitor Data Notification header contains the time of theevent, in terms of mill

Seite 17

6: ADCCP NRM Line-Monitor FunctionDC 900-1317J 113usFiller[2]: This field of the Monitor Data Notification header rounds out the first 12bytes. It con

Seite 18 - Revision History

114 DC 900-1317JADCCP NRM Programmer’s GuideusFrameID: This field of the Frame Abstract contains a code for the frame ID in theframe’s Control field.

Seite 19 - Customer Support

6: ADCCP NRM Line-Monitor FunctionDC 900-1317J 1156.5 Line-Monitor Client Program (nrmmon)Protogate’s provides an ADCCP NRM Line-Monitor client progra

Seite 20 - 20 DC 900-1317J

116 DC 900-1317JADCCP NRM Programmer’s Guide

Seite 21 - Introduction

DC 900-1317J 117AppendixAClock SignalsThe ADCCP NRM communication interface is designed to use either externally orinternally generated clock signals.

Seite 22 - Freeway

118 DC 900-1317JADCCP NRM Programmer’s Guide

Seite 23 - ● ● ●

DC 900-1317J 119AppendixBError CodesThere are several methods used by the DLI and ADCCP NRM software to report errors(Ta bl e B –1 lists the ADCCP NR

Seite 24

12 DC 900-1317JADCCP NRM Programmer’s Guide

Seite 25 - Industry

120 DC 900-1317JADCCP NRM Programmer’s GuideTabl e B– 1: ADCCP NRM Error CodesCode Mnemonic Meaning0DLI_ICP_ERR_NO_ERRA data block has been successful

Seite 26 - 1.4 Client Operations

DC 900-1317J 121AppendixCADCCP NRM Loopback Test ProgramsNoteIn this document, the term “Freeway” can mean either a Freewayserver or an embedded ICP.

Seite 27 - 1.5 ADCCP NRM Overview

122 DC 900-1317JADCCP NRM Programmer’s GuideTo run the test program, perform the following steps:1. Make sure the server TSI configuration parameter i

Seite 28 - An external clock source is

C: ADCCP NRM Loopback Test ProgramsDC 900-1317J 123osf1 (for an OSF1 system)UNIX example: make -f makefile.bsd allmake -f makefile.test.bsd nrmtestFor

Seite 29 - 1.5.2 Hardware Description

124 DC 900-1317JADCCP NRM Programmer’s GuideUNIX example: freeway/client/<op-sys>/binVMS example: [FREEWAY.CLIENT.<vms_platform>_tcp-sys

Seite 30 - 30 DC 900-1317J

C: ADCCP NRM Loopback Test ProgramsDC 900-1317J 125• Before you run dlicfg and tsicfg, run the makefc.com command file to create theforeign commands u

Seite 31 - ADCCP NRM Protocol

126 DC 900-1317JADCCP NRM Programmer’s Guidemakefile. It uses the same TSI configuration file as nrmalp, but it uses a unique DLIconfiguration file: n

Seite 32 - DRWG-0526

DC 900-1317J 127AppendixDADCCP NRM Detailed Command and Response Headers This appendix is intended as an aid to programmers writing an application pro

Seite 33 - 2.3 Symmetric Configurations

128 DC 900-1317JADCCP NRM Programmer’s GuideD.1 Application Sequence of Events1. Establish a connection to a link • Attach to the ICP • Set buffer siz

Seite 34 - 2.4 Frame Addressing

D: ADCCP NRM Detailed Command and Response HeadersDC 900-1317J 129D.2 Command sequences1. Sequence of packet exchanges for establishing a connection a

Seite 35

DC 900-1317J 13PrefacePurpose of DocumentThis document contains information for the development of applications that use Pro-togate’s ADCCP NRM softwa

Seite 36 - 2.7 Optional Functions

130 DC 900-1317JADCCP NRM Programmer’s GuideReceive a resp_normal-ack-packet (DLI_PROT_RESP_NORMAL_ACK)Receive a resp_local-ack-packet

Seite 37

D: ADCCP NRM Detailed Command and Response HeadersDC 900-1317J 131D.3 attach-packet Packet Description This packet is used to attach an application to

Seite 38 - 2.8 Summary of Frame Types

132 DC 900-1317JADCCP NRM Programmer’s GuideD.4 set-buffer-size-packet Packet Description This packet is used to set an ICP Message buffer size. The i

Seite 39 - Table 2–1: ADCCP Frame Types

D: ADCCP NRM Detailed Command and Response HeadersDC 900-1317J 133D.5 set-buffer-size-ack-packet Packet Description This packet is used to receive an

Seite 40 - DRWG-1136

134 DC 900-1317JADCCP NRM Programmer’s GuideD.6 link-config-packet Packet Description This packet is used to configure a link. The data field consists

Seite 41

D: ADCCP NRM Detailed Command and Response HeadersDC 900-1317J 135 usProtLinkID = port number usProtCircuitID = 0 usProtSessio

Seite 42

136 DC 900-1317JADCCP NRM Programmer’s GuideD.7 station-config-packet Packet Description This packet is used to configure a station on a link. The dat

Seite 43 - DLI Functions

D: ADCCP NRM Detailed Command and Response HeadersDC 900-1317J 137NoteThe Freeway header is used only with DLI (it is not applicable forDLITE), and th

Seite 44 - * codes freeway.h

138 DC 900-1317JADCCP NRM Programmer’s GuideD.8 limit-config-packet Packet Description This packet is used to adjust station timer and retry limit whe

Seite 45

D: ADCCP NRM Detailed Command and Response HeadersDC 900-1317J 139D.9 start-link-packet Packet Description This packet is used to start or enable a li

Seite 46

14 DC 900-1317JADCCP NRM Programmer’s Guide• a client computer that runs the following:• TCP/IP (for a Freeway server)• Freeway data link interface (D

Seite 47

140 DC 900-1317JADCCP NRM Programmer’s GuideD.10 start-link-ack-packet Packet Description This packet is used to receive a start link ack packet. Pack

Seite 48

D: ADCCP NRM Detailed Command and Response HeadersDC 900-1317J 141D.11 start-station-packet Packet Description This packet is used to start or enable

Seite 49

142 DC 900-1317JADCCP NRM Programmer’s GuideD.12 start-station-ack-packet Packet Description This packet is used to receive a start station ack packet

Seite 50 - 50 DC 900-1317J

D: ADCCP NRM Detailed Command and Response HeadersDC 900-1317J 143D.13 set-multipoint-list-packet (optional)Packet Description Valid only if option 7

Seite 51 - 3.3.1 DLI Optional Arguments

144 DC 900-1317JADCCP NRM Programmer’s GuideNoteSend a size of 0 if multi-point addressing for all stations on a phys-ical link is to be suppressed.Pa

Seite 52

D: ADCCP NRM Detailed Command and Response HeadersDC 900-1317J 145D.14 station-init-packet (optional) Packet Description This packet is valid only if

Seite 53 - DC 900-1317J 53

146 DC 900-1317JADCCP NRM Programmer’s GuidePacket ExchangesusProtCommand sent usProtCommand received------------------ ----------

Seite 54 - 54 DC 900-1317J

D: ADCCP NRM Detailed Command and Response HeadersDC 900-1317J 147D.15 station-init-ack-packet (optional) Packet Description This packet is used to ac

Seite 55

148 DC 900-1317JADCCP NRM Programmer’s GuideD.16 send-exchange-id-packet (optional) Packet Description This packet is only valid if option 1 (station-

Seite 56

D: ADCCP NRM Detailed Command and Response HeadersDC 900-1317J 149D.17 recv-exchange-id-packet (optional) Packet Description This packet is valid only

Seite 57

PrefaceDC 900-1317J 15Protogate ReferencesThe following documents provide useful supporting information, depending on thecustomer’s particular hardwar

Seite 58

150 DC 900-1317JADCCP NRM Programmer’s GuideD.18 station-reset-packet Packet Description This packet is used to reset an active NRM remote secondary (

Seite 59

D: ADCCP NRM Detailed Command and Response HeadersDC 900-1317J 151D.19 station-reset-ack-packet Packet Description The ICP uses this packet to report

Seite 60 - DLI_PROT_SEND_NORM_DATA), the

152 DC 900-1317JADCCP NRM Programmer’s GuideD.20 recv-station-reset-packet Packet Description The ICP uses this packet to report when an active statio

Seite 61

D: ADCCP NRM Detailed Command and Response HeadersDC 900-1317J 153D.21 recv-station-reset-ack-packet Packet Description The client uses this packet to

Seite 62

154 DC 900-1317JADCCP NRM Programmer’s GuideD.22 write-unform-data-packet (or write-unform-data-eom-packet)Packet Description This packet is valid onl

Seite 63

D: ADCCP NRM Detailed Command and Response HeadersDC 900-1317J 155Packet ExchangesusProtCommand sent usProtCommand received----------------

Seite 64

156 DC 900-1317JADCCP NRM Programmer’s GuideD.23 receive-unform-data-packet Packet Description This packet is valid only if option 5 (station-config-p

Seite 65

D: ADCCP NRM Detailed Command and Response HeadersDC 900-1317J 157D.24 write-unnum-data-packet (or write-unnum-eom-data-packet)Packet Description This

Seite 66 - • DLI_ICP_ERR_XMIT_TIMEOUT

158 DC 900-1317JADCCP NRM Programmer’s GuideDataData to be sent to remote application. Packet ExchangesusProtCommand sent usProtCommand rec

Seite 67 - DLI_PROT_RESP_ERROR packet

D: ADCCP NRM Detailed Command and Response HeadersDC 900-1317J 159D.25 receive-unnum-data-packet Packet Description This packet is valid only if optio

Seite 68

16 DC 900-1317JADCCP NRM Programmer’s Guide• Getting Started with Freeway 1200 DC 900-1536• Getting Started with Freeway 1300 DC 900-1538• Getting Sta

Seite 69

160 DC 900-1317JADCCP NRM Programmer’s GuideD.26 write-data-packet Packet Description This packet is valid only if the client has not enabled option 9

Seite 70 - 3.4.20.1 First Variant

D: ADCCP NRM Detailed Command and Response HeadersDC 900-1317J 161DataData to be sent to remote application. Packet ExchangesusProtCommand sent

Seite 71 - 3.4.20.2 Second Variant

162 DC 900-1317JADCCP NRM Programmer’s GuideD.27 receive-data-packet Packet Description This packet is valid for primary stations if option 8 (station

Seite 72

D: ADCCP NRM Detailed Command and Response HeadersDC 900-1317J 163D.28 resp-normal-ack-packet Packet Description This packet is used to acknowledge on

Seite 73

164 DC 900-1317JADCCP NRM Programmer’s GuideD.29 resp-local-ack-packet Packet Description This packet is used by the ICP to acknowledge a DLI_PROT_SEN

Seite 74

D: ADCCP NRM Detailed Command and Response HeadersDC 900-1317J 165D.30 buffer-rpt-packet Packet Description This packet is used to request a buffer re

Seite 75 - 3.4.20.3 Third Variant

166 DC 900-1317JADCCP NRM Programmer’s GuideD.31 buffer-rpt-ack-packet Packet Description This packet is received in response to a "buffer-rpt-pa

Seite 76

D: ADCCP NRM Detailed Command and Response HeadersDC 900-1317J 167typedef int INT32;typedef struct sdlc_port_buffers{ INT32 RcvbufPrealloc;

Seite 77

168 DC 900-1317JADCCP NRM Programmer’s GuideD.32 stats-rpt-packet Packet Description This packet is used to request a link’s statistics report. This c

Seite 78

D: ADCCP NRM Detailed Command and Response HeadersDC 900-1317J 169D.33 stats-rpt-ack-packet Packet Description This packet is received in response to

Seite 79

PrefaceDC 900-1317J 17Document ConventionsThis document follows the most significant byte first (MSB) and most significant wordfirst (MSW) conventions

Seite 80

170 DC 900-1317JADCCP NRM Programmer’s GuideD.34 version-rpt-packet Packet Description This packet is used to request the ICP software versions. P

Seite 81

D: ADCCP NRM Detailed Command and Response HeadersDC 900-1317J 171D.35 version-rpt-ack-packet Packet Description This packet is received in respon

Seite 82

172 DC 900-1317JADCCP NRM Programmer’s GuideD.36 recv-link-except-packet Packet Description The ICP uses this packet to report operational excepti

Seite 83 - DC 900-1317J 83

D: ADCCP NRM Detailed Command and Response HeadersDC 900-1317J 173D.37 resp-error-packet Packet Description The ICP uses this packet to report receipt

Seite 84 - 84 DC 900-1317J

174 DC 900-1317JADCCP NRM Programmer’s GuideD.38 stop-station-packet Packet Description This packet is used to stop a station on a link. Packet Header

Seite 85 - Operations

D: ADCCP NRM Detailed Command and Response HeadersDC 900-1317J 175D.39 stop-station-ack-packet Packet Description This packet is used to acknowledge s

Seite 86 - 4.1.2.1 Link Configuration

176 DC 900-1317JADCCP NRM Programmer’s GuideD.40 stop-link-packet Packet Description This packet is used to stop or disable a link and all active

Seite 87 - 4.1.2.2 Station Configuration

D: ADCCP NRM Detailed Command and Response HeadersDC 900-1317J 177D.41 stop-link-ack-packet Packet Description This packet is used to acknowledge

Seite 88

178 DC 900-1317JADCCP NRM Programmer’s GuideD.42 detach-packet Packet Description This packet is used to detach an application from the protocol.

Seite 89

DC 900-1317J 179IndexAABM 38ADCCP NRMerror codes 119hardware description 29overview 27protocol summary 31software description 29Addressingframe 34Inte

Seite 90

18 DC 900-1317JADCCP NRM Programmer’s GuideRevision HistoryThe revision history of the ADCCP NRM Programmer’s Guide, Protogate documentDC 900-1317J, i

Seite 91

180 DC 900-1317JADCCP NRM Programmer’s Guidesymmetric 33unbalanced 31third variant 75Configure link command 99, 104Control packets 52clientDLI_PROT_CF

Seite 92

IndexDC 900-1317J 181dlRead functionsee Control packetsdlRead (see also Functions) 50dlTerm (see also Functions) 50dlWrite functionsee Control packets

Seite 93 - 4.2.1 Non-blocking I/O

182 DC 900-1317JADCCP NRM Programmer’s GuideMaximum data buffer size 85see also Control packetsMore data indication 60, 62, 94, 97move.com file 101, 1

Seite 94 - 4.2.2 More Data Indicator

IndexDC 900-1317J 183Transport subsystem interface (TSI) 26TSI configurationsee Configuration, TSItsicfg preprocessor program 100UUNIXconfiguration pr

Seite 95

184 DC 900-1317JADCCP NRM Programmer’s Guide

Seite 96 - 4.4 Broadcast Procedures

ADCCP NRM Programmer’s GuideDC 900-1317JCustomer Report FormWe are constantly improving our products. If you have suggestions or problems you wouldlik

Seite 97

Protogate, Inc.Customer Service12225 World Trade Drive, Suite RSan Diego, CA 92128

Seite 98 - 98 DC 900-1317J

PrefaceDC 900-1317J 19Customer SupportIf you are having trouble with any Protogate product, call us at (858) 451-0865 Mondaythrough Friday between 8 a

Seite 99 - Configuration Using dlicfg

Protogate, Inc.12225 World Trade Drive, Suite RSan Diego, CA 92128(858) 451-0865ADCCP NRM Programmer’s Guide© 2005 Protogate, Inc. All rights reserved

Seite 100

20 DC 900-1317JADCCP NRM Programmer’s Guide

Seite 101

DC 900-1317J 21Chapter1Introduction1.1 Product OverviewProtogate provides a variety of wide-area network (WAN) connectivity solutions forreal-time fin

Seite 102

22 DC 900-1317JADCCP NRM Programmer’s GuideTo maintain high data throughput, Freeway uses a multi-processor architecture to sup-port the LAN and WAN s

Seite 103 - DC 900-1317J 103

1: IntroductionDC 900-1317J 231.1.2 Embedded ICPThe embedded ICP connects your client computer directly to the WAN (for example,using Protogate’s ICP2

Seite 104 - 5.2 DLI Session Configuration

24 DC 900-1317JADCCP NRM Programmer’s GuideSummary of product features:• Provision of WAN connectivity either through a LAN-based Freeway server ordir

Seite 105 - DC 900-1317J 105

1: IntroductionDC 900-1317J 251.2 Freeway Client-Server EnvironmentThe Freeway server acts as a gateway that connects a client on a local-area network

Seite 106 - 106 DC 900-1317J

26 DC 900-1317JADCCP NRM Programmer’s Guide1.2.1 Establishing Freeway Server Internet AddressesThe Freeway server must be addressable in order for a c

Seite 107

1: IntroductionDC 900-1317J 271.4.2 Opening a SessionAfter the DLI and TSI configurations are properly defined, your client application usesthe dlOpen

Seite 108 - 108 DC 900-1317J

28 DC 900-1317JADCCP NRM Programmer’s GuideEach serial port (link) on the ICP operates independently of the other links on the sameICP and can be conf

Seite 109 - Function

1: IntroductionDC 900-1317J 291.5.1 Software Description Protogate’s ADCCP NRM product includes the following major software components:• A group of c

Seite 110 - Modifier

DC 900-1317J 3ContentsList of Figures 9List of Tables 11Preface 131Introduction 211.1 Product Overview... 211.1.1 Freeway

Seite 111

30 DC 900-1317JADCCP NRM Programmer’s Guide

Seite 112

DC 900-1317J 31Chapter2ADCCP NRM Protocol SummaryProtogate’s ADCCP NRM interface product is based on the American National Stan-dard for Advanced Data

Seite 113

32 DC 900-1317JADCCP NRM Programmer’s GuideIn an unbalanced configuration (see Figure 2–1), the primary station transmits com-mands and the secondary

Seite 114

2: ADCCP NRM Protocol SummaryDC 900-1317J 332.2 Balanced ConfigurationsSome applications require two stations (one local and one remote) to exchange c

Seite 115

34 DC 900-1317JADCCP NRM Programmer’s Guidedefined. Although the configuration is symmetric, link communications may not be.The link between one prima

Seite 116 - 116 DC 900-1317J

2: ADCCP NRM Protocol SummaryDC 900-1317J 35between the primary function in one combined station and the secondary function inthe other. Each dialog u

Seite 117 - Clock Signals

36 DC 900-1317JADCCP NRM Programmer’s Guide2.6 Operational StatesADCCP link operation procedures define three fundamental states: logically discon-nec

Seite 118 - 118 DC 900-1317J

2: ADCCP NRM Protocol SummaryDC 900-1317J 37(or function) to issue a disconnect (DISC) command. This option isnot normally used in ARM or ABM operatio

Seite 119 - Error Codes

38 DC 900-1317JADCCP NRM Programmer’s GuideOPTION 8 This option forbids the use of information response frames. Thisimplies that a secondary station c

Seite 120 - 120 DC 900-1317J

2: ADCCP NRM Protocol SummaryDC 900-1317J 39Table 2–1: ADCCP Frame TypesInformation Transfer Format Commands/ResponsesI InformationSupervisory Format

Seite 121 - Test Programs

4 DC 900-1317JADCCP NRM Programmer’s Guide2.7 Optional Functions ... 362.8 Summary of Frame Types...

Seite 122

40 DC 900-1317JADCCP NRM Programmer’s GuideFigure 2–4. The major areas of difference occur in the handling of polling, F-bitresponses, checkpoint retr

Seite 123

2: ADCCP NRM Protocol SummaryDC 900-1317J 41Because normal response mode (NRM) operation is usually used in a multidrop unbal-anced configuration, pri

Seite 124 - [FREEWAY.CLIENT.VAX_UCX.BIN]

42 DC 900-1317JADCCP NRM Programmer’s GuideF-bit checkpoint recovery occurs when the primary station receives a supervisory frameor I-frame with the F

Seite 125

DC 900-1317J 43Chapter3ADCCP NRM DLI FunctionsNoteIn this document, the term “Freeway” can mean either a Freewayserver or an embedded ICP. For the emb

Seite 126

44 DC 900-1317JADCCP NRM Programmer’s Guide• The various mnemonic codes mentioned throughout this document are definedin the include files provided wi

Seite 127 - Headers

3: ADCCP NRM DLI FunctionsDC 900-1317J 45The Freeway server is normally configured only once, during the installation proce-dures described in the Fre

Seite 128

46 DC 900-1317JADCCP NRM Programmer’s Guideexchange, Normal and Raw operation can be mixed. The client application sessionshould be configured for No

Seite 129 - D.2 Command sequences

3: ADCCP NRM DLI FunctionsDC 900-1317J 473.2 Example ADCCP NRM Call SequencesTa ble 3 –2 shows the sequence of DLI function calls to send and receive

Seite 130 - 130 DC 900-1317J

48 DC 900-1317JADCCP NRM Programmer’s GuideNoteWhen using non-blocking I/O, a dlRead request must always bequeued to avoid loss of data or responses f

Seite 131 - D.3 attach-packet

3: ADCCP NRM DLI FunctionsDC 900-1317J 493.3 Overview of DLI Functions for ADCCP NRMThis section summarizes the DLI functions used in writing a client

Seite 132 - D.4 set-buffer-size-packet

ContentsDC 900-1317J 53.4.21DLI_PROT_RECV_STATION_RESET Packet... 773.4.22DLI_PROT_SEND_STATION_RESET Packet... 773.4.23DLI_PROT_R

Seite 133 - Packet Header

50 DC 900-1317JADCCP NRM Programmer’s GuideTable 3–4: DLI Functions: Syntax and Parameters (Listed in Typical Call Order)DLI Function Parameter(s) Par

Seite 134 - D.6 link-config-packet

3: ADCCP NRM DLI FunctionsDC 900-1317J 513.3.1 DLI Optional ArgumentsThe dlWrite and dlRead functions handle the control packets for an ADCCP NRM appl

Seite 135 - Packet Exchanges

52 DC 900-1317JADCCP NRM Programmer’s Guide3.4 Client/ICP Control Packet Formats The ADCCP NRM protocol software running on an ICP is controlled by a

Seite 136 - D.7 station-config-packet

3: ADCCP NRM DLI FunctionsDC 900-1317J 53Table 3–5: Client Packet dlWrite usProtCommand and iProtModifier Fields dlWrite usProtCommand Field dlWrite i

Seite 137 - DLI_PROT_CFG_LINK none

54 DC 900-1317JADCCP NRM Programmer’s GuideTable 3–6: ICP Packet dlRead usProtCommand and iProtModifier FieldsdlRead usProtCommand Field dlRead iProtM

Seite 138 - D.8 limit-config-packet

3: ADCCP NRM DLI FunctionsDC 900-1317J 55The usProtXParms[0] field is used to specify the station ID. The station ID field is speci-fied in most contr

Seite 139 - D.9 start-link-packet

56 DC 900-1317JADCCP NRM Programmer’s GuideThe client uses this packet to change station operation to the initialization state. TheiProtModifier field

Seite 140 - D.10 start-link-ack-packet

3: ADCCP NRM DLI FunctionsDC 900-1317J 57The ICP sends to the client a DLI_PROT_RECV_STATION_INIT packet with zero in theiProtModifier field following

Seite 141 - D.11 start-station-packet

58 DC 900-1317JADCCP NRM Programmer’s Guideon the ICP, an application in the client attempting to write a control packet to the ICPexperiences delayed

Seite 142

3: ADCCP NRM DLI FunctionsDC 900-1317J 59specify the usProtCommand field (DLI_PROT_SEND_EXCHANGE_ID), the usProtXParms[0] field(station ID), the usPro

Seite 143

6 DC 900-1317JADCCP NRM Programmer’s Guide5 ADCCP NRM Link Configuration Using dlicfg 995.1 Configuration Overview... 995.2 DL

Seite 144

60 DC 900-1317JADCCP NRM Programmer’s Guidestations unless the client has enabled ADCCP option 8 for the specified secondary sta-tion. The client must

Seite 145

3: ADCCP NRM DLI FunctionsDC 900-1317J 61the ICP uses selective broadcast addressing. If bit 1 is reset to zero and bit 2 is set to one,the ICP uses g

Seite 146

62 DC 900-1317JADCCP NRM Programmer’s Guidebroadcast addressing is indicated. If bit 1 is reset to zero and bit 2 is set to one, generalbroadcast addr

Seite 147

3: ADCCP NRM DLI FunctionsDC 900-1317J 63NRM secondary station and the station’s transmit window is still open, the ICP trans-mits the data in a respo

Seite 148

64 DC 900-1317JADCCP NRM Programmer’s Guideaddressing is indicated. If bit 1 is set to one and bit 2 is reset to zero, selective broadcastaddressing i

Seite 149

3: ADCCP NRM DLI FunctionsDC 900-1317J 65The client specifies the usProtCommand field (DLI_PROT_SEND_SET_MULTIPNT_LIST), the linkID, the usProtXParms[

Seite 150 - D.18 station-reset-packet

66 DC 900-1317JADCCP NRM Programmer’s Guide• DLI_ICP_ERR_NO_ERR• DLI_ICP_ERR_XMIT_ABORTED• DLI_ICP_ERR_XMIT_TIMEOUTPacket type identifier codes that c

Seite 151

3: ADCCP NRM DLI FunctionsDC 900-1317J 673.4.16 DLI_PROT_SEND_BIND PacketThe client uses this packet to enable a physical link or to enable a station.

Seite 152

68 DC 900-1317JADCCP NRM Programmer’s GuideThe presence of the zeroed station ID tells the client that the control packet relates tothe physical link,

Seite 153

3: ADCCP NRM DLI FunctionsDC 900-1317J 69ful for temporarily stopping the link without terminating the session (for example, toreconfigure the link us

Seite 154

ContentsDC 900-1317J 7D.18station-reset-packet...150D.19station-reset-ack-packet...151D.20recv-sta

Seite 155

70 DC 900-1317JADCCP NRM Programmer’s Guide3.4.20.1 First VariantThe first variant of the DLI_PROT_CFG_LINK packet allows the client to configure a ph

Seite 156

3: ADCCP NRM DLI FunctionsDC 900-1317J 713.4.20.2 Second VariantThe second variant of the DLI_PROT_CFG_LINK packet allows the client to configure a st

Seite 157

72 DC 900-1317JADCCP NRM Programmer’s GuideusProtXParms[1] field (data size = 16), and the data area. The iProtModifier field valuemust be 1, which in

Seite 158

3: ADCCP NRM DLI FunctionsDC 900-1317J 73rate, round-trip propagation delay time (as in satellite data links), and data frame sizemust all be consider

Seite 159

74 DC 900-1317JADCCP NRM Programmer’s GuideThe loc_size variable specifies the length of the local station address. The rem_size vari-able specifies t

Seite 160 - D.26 write-data-packet

3: ADCCP NRM DLI FunctionsDC 900-1317J 75the final address octet must be set to one. This requirement ensures that the basic andextended address field

Seite 161

76 DC 900-1317JADCCP NRM Programmer’s GuideWord 2 in the data area contains the poll timer parameter value. This parameter is validonly for NRM second

Seite 162 - D.27 receive-data-packet

3: ADCCP NRM DLI FunctionsDC 900-1317J 773.4.21 DLI_PROT_RECV_STATION_RESET PacketThe ICP uses this packet to report when an active station on the lin

Seite 163 - D.28 resp-normal-ack-packet

78 DC 900-1317JADCCP NRM Programmer’s Guideremain unacknowledged and may have been lost in transit. The client is responsible forinitiating recovery p

Seite 164 - D.29 resp-local-ack-packet

3: ADCCP NRM DLI FunctionsDC 900-1317J 79A iProtModifier field value of one means that the indicated active NRM secondary sta-tion has received no pol

Seite 165 - D.30 buffer-rpt-packet

8 DC 900-1317JADCCP NRM Programmer’s Guide

Seite 166 - D.31 buffer-rpt-ack-packet

80 DC 900-1317JADCCP NRM Programmer’s GuideThis packet contains the following counters:• Invalid address and control fields received• FCS errors • I-f

Seite 167 - DC 900-1317J 167

3: ADCCP NRM DLI FunctionsDC 900-1317J 81application. The ICP modifies the offending control packet to specify theusProtCommand field (DLI_PROT_RESP_E

Seite 168 - D.32 stats-rpt-packet

82 DC 900-1317JADCCP NRM Programmer’s GuideIf your application must set the ICP message buffer size itself, you must set the cfgLinkand enable DLI con

Seite 169 - D.33 stats-rpt-ack-packet

3: ADCCP NRM DLI FunctionsDC 900-1317J 83in the usProtXParms[1] field, and ASCII text identifying the ICP software version in thedata area.

Seite 170 - D.34 version-rpt-packet

84 DC 900-1317JADCCP NRM Programmer’s Guide

Seite 171 - D.35 version-rpt-ack-packet

DC 900-1317J 85Chapter4ADCCP NRM OperationsThis chapter describes some of the ADCCP NRM operations using the control packetsdescribed in Chapter 3. S

Seite 172 - D.36 recv-link-except-packet

86 DC 900-1317JADCCP NRM Programmer’s GuideTo change the default maximum buffer size, the client sends a DLI_PROT_SET_BUF_SIZEpacket (see Section 3.4.

Seite 173 - D.37 resp-error-packet

4: ADCCP NRM OperationsDC 900-1317J 87Before attempting to reconfigure a link that has already been configured, the clientmust ensure that the link is

Seite 174 - D.38 stop-station-packet

88 DC 900-1317JADCCP NRM Programmer’s Guidelocal station address field length and content. The existence of the primary station isimplied; the client

Seite 175 - D.39 stop-station-ack-packet

4: ADCCP NRM OperationsDC 900-1317J 89The initialization state is supported only on stations configured to use ADCCP option5. A transition from the lo

Seite 176 - D.40 stop-link-packet

DC 900-1317J 9List of FiguresFigure 1–1: Freeway Configuration... 22Figure 1–2: Embedded ICP Configuration...

Seite 177 - D.41 stop-link-ack-packet

90 DC 900-1317JADCCP NRM Programmer’s Guidelevel protocol transactions. The client transmits and receives frames as UnformattedData packets and is res

Seite 178 - D.42 detach-packet

4: ADCCP NRM OperationsDC 900-1317J 914.1.5 Information Transfer State OperationOnce a station is in the information transfer state, data transfer is

Seite 179 - DC 900-1317J 179

92 DC 900-1317JADCCP NRM Programmer’s GuideUnformatted data cannot be exchanged in the information transfer state. If the clientattempts to send an Un

Seite 180 - 180 DC 900-1317J

4: ADCCP NRM OperationsDC 900-1317J 934.2 User Application Design CriteriaThis section describes criteria to be considered when designing an applicati

Seite 181 - DC 900-1317J 181

94 DC 900-1317JADCCP NRM Programmer’s Guide4.2.2 More Data IndicatorIn normal response mode (NRM) operation, the primary station must intersperse poll

Seite 182 - 182 DC 900-1317J

4: ADCCP NRM OperationsDC 900-1317J 95On the other hand, if a primary station only periodically polls its secondary stations andwithholds I-frame ackn

Seite 183 - DC 900-1317J 183

96 DC 900-1317JADCCP NRM Programmer’s Guide4.3.2 ICP Station Reset ConditionIf the client application receives an DLI_PROT_RECV_STATION_RESET packet,

Seite 184 - 184 DC 900-1317J

4: ADCCP NRM OperationsDC 900-1317J 97This practice ensures that the sequence number variables for all secondary stationsreceiving a broadcast remain

Seite 185 - Customer Report Form

98 DC 900-1317JADCCP NRM Programmer’s Guide

Seite 186 - San Diego, CA 92128

DC 900-1317J 99Chapter5ADCCP NRM Link Configuration Using dlicfgNoteIn this document, the term “Freeway” can mean either a Freewayserver or an embedde

Kommentare zu diesen Handbüchern

Keine Kommentare