Simpact Freeway 1300 Guía de usuario

Protogate, Inc.12225 World Trade Drive, Suite RSan Diego, CA 92128Protocol Software ToolkitProgrammer GuideDC 900-1338IJanuary 2002

10 DC 900-1338IProtocol Software Toolkit Programmer GuideFigure 6–8: ICP Write Request (Receive Data) Processing... 102Figure 6–9: Sample

100 DC 900-1338IProtocol Software Toolkit Programmer GuideFigure 6–7: ICP Read Request (Transmit Data) ProcessingUtility TaskInput Header QueuesRead R

6: ICP SoftwareDC 900-1338I 101b. The protocol task removes data buffers from the server-to-board queue,processes the requests, then releases the buff

102 DC 900-1338IProtocol Software Toolkit Programmer GuideFigure 6–8: ICP Write Request (Receive Data) ProcessingUtility Task• • •Header buffer partit

6: ICP SoftwareDC 900-1338I 1034. XIO posts a write to the Write Request Queue associated with the node identifiedin the host request header.5. When t

104 DC 900-1338IProtocol Software Toolkit Programmer Guide6.2.1 Link Control TablesThe protocol and utility tasks and the interrupt service routines c

6: ICP SoftwareDC 900-1338I 105bit32 *lct_dma_rda; /* pointer to dma rcv address icp6000 */bit32 *lct_dma_rtc; /* pointer to dma rcv count icp6000 */b

106 DC 900-1338IProtocol Software Toolkit Programmer GuideDATA_BUFFER *lct_frbuf; /* Receive frame buffer */DATA_BUFFER *lct_rprebuf; /* Receive'

6: ICP SoftwareDC 900-1338I 1076.2.2 SPS/ISR Interface for Transmit MessagesWhen the protocol task receives a transmit data block message on a link’s

108 DC 900-1338IProtocol Software Toolkit Programmer Guidethe protocol task removes the buffer from the link-to-board queue, calls the appropri-ate po

6: ICP SoftwareDC 900-1338I 1096.3 Interrupt ServiceAt the interrupt level, the SPS provides specific examples of SCC and IUSC program-ming for asynch

DC 900-1338I 11List of TablesTable 2–1: Vectors Reserved for System Software... 40Table 2–2: ICP Interrupt Priority Assignments...

110 DC 900-1338IProtocol Software Toolkit Programmer Guideno longer transfers characters to the SCC or IUSC), a transmit underrun is generated.The SCC

6: ICP SoftwareDC 900-1338I 111SCC External/Status (ICP6000 only) This interrupt is generated under any of the fol-lowing conditions:Loss of DCD An er

112 DC 900-1338IProtocol Software Toolkit Programmer Guidetransferring the received character from the SCC or IUSC receiver to the receivedata buffer,

6: ICP SoftwareDC 900-1338I 113is set to the number of bytes in the block, including the header and the two-byte CRC,if enabled. The CRC is calculated

114 DC 900-1338IProtocol Software Toolkit Programmer Guide

DC 900-1338I 115Chapter7Host/ICP InterfaceNoteFrom the ICP’s perspective, the “host processor” can be either theserver processor of the Freeway in whi

116 DC 900-1338IProtocol Software Toolkit Programmer Guideto the ICP in order to gain service. Another register is used for ICP-to-host commands,but a

7: Host/ICP InterfaceDC 900-1338I 117The ICP posts read requests to node 1 (the main node) and node 2 (the priority node);all information coming to th

118 DC 900-1338IProtocol Software Toolkit Programmer Guide7.2 Queue ElementsIn general, a queue element consists of one or more linked buffers, and a

7: Host/ICP InterfaceDC 900-1338I 119Figure 7–1: Sample Singly-linked Queue with Three Elements00next elementnext bufferdatadata0next bufferdata000nex

12 DC 900-1338IProtocol Software Toolkit Programmer GuideTable B–4: IUSC Time Constants for 16X Clock Rate for ICP2424 and ICP2432 . . . 193Table C–1:

120 DC 900-1338IProtocol Software Toolkit Programmer GuideFigure 7–2: Sample Doubly-linked Queue with Three Elementsqueue head queue tailLegend000000n

7: Host/ICP InterfaceDC 900-1338I 1217.2.1 System Buffer HeaderAs mentioned previously, every buffer of every queue element must begin with a systembu

122 DC 900-1338IProtocol Software Toolkit Programmer GuideNext Buffer This field contains the address of the next buffer of the queueelement. In gener

7: Host/ICP InterfaceDC 900-1338I 123ment (the disposition flag is then ignored in all other buffers ofthe queue element). POST_BUF, FREE_BUF, TOKEN

124 DC 900-1338IProtocol Software Toolkit Programmer Guideare used by your ICP-resident software to send information in the form of data andcommand ac

7: Host/ICP InterfaceDC 900-1338I 125struct NODEC_TYPE{struct SBH_TYPE sbh; /* system buffer header */unsigned short rqid; /* host read request queue

126 DC 900-1338IProtocol Software Toolkit Programmer Guide7.2.3.1 System Buffer Header InitializationIn the system buffer header, the sb_thse field mu

7: Host/ICP InterfaceDC 900-1338I 127token associated with the resource. If this is the case, the task can make a resourcerequest and obtain the token

128 DC 900-1338IProtocol Software Toolkit Programmer GuideFigure 7–4: Host Request Queue Element with Data AreaSystem Buffer HeaderServerRequestHeader

7: Host/ICP InterfaceDC 900-1338I 129 The header buffer has the following structure:struct SREQ_HDR_TYPE{struct SBH_TYPE sbh;struct sreq_type req;};Th

DC 900-1338I 13PrefacePurpose of DocumentThis document describes the protocol software toolkit for the Freeway server andembedded intelligent communic

130 DC 900-1338IProtocol Software Toolkit Programmer GuideThe data buffer has the following structure:struct data_buffer{struct SBH_TYPE sbh; /* (defi

7: Host/ICP InterfaceDC 900-1338I 131struct prot_hdr /* Protocol message header */{bit16 command; /* function code */bit16 modifier; /* function modif

132 DC 900-1338IProtocol Software Toolkit Programmer GuideIn the header buffer, the disposition flag must be set to one of the values defined for thef

7: Host/ICP InterfaceDC 900-1338I 133disposition flag in the header buffer to FREE_BUF and the disposition flag in the databuffer to REL_BUF. Then, wh

134 DC 900-1338IProtocol Software Toolkit Programmer GuideProtogate implementations, provisions exist for read request queues for these nodes;however,

7: Host/ICP InterfaceDC 900-1338I 135in the snode field. For a read, the node number is generally not specified on request(snode is not used), and on

136 DC 900-1338IProtocol Software Toolkit Programmer GuideThe s_initxio function is called once to initialize the internal data structures and devices

7: Host/ICP InterfaceDC 900-1338I 137Input: A0.L = address of NODEC_TYPE structureOutput: noneAccess: task or ISR7.4.3 XIO Read/Write (s_xio)Issue a r

138 DC 900-1338IProtocol Software Toolkit Programmer GuideOS/Impact initializes the second unused entry in the GST to zero. If OS/Impactencounters a f

7: Host/ICP InterfaceDC 900-1338I 139Identifier 0x700Modifier Disposition flag valueDescription A buffer contains an illegal disposition flag value.Id

14 DC 900-1338IProtocol Software Toolkit Programmer Guide• a client computer that runs the following:• TCP/IP (for a Freeway server)• Freeway data lin

140 DC 900-1338IProtocol Software Toolkit Programmer Guide

DC 900-1338I 141Chapter8Client Applications — DLI OverviewNoteIn this document, the term “Freeway” can mean either a Freewayserver or an embedded ICP.

142 DC 900-1338IProtocol Software Toolkit Programmer Guide• The Freeway Data Link Interface Reference Guide shows a generic code examplewhich can guid

8: Client Applications — DLI OverviewDC 900-1338I 143• transport subsystem interface (TSI) connection configuration• protocol-specific ICP link config

144 DC 900-1338IProtocol Software Toolkit Programmer GuideFigure 8–1 shows a portion of a typical DLI configuration file, such as spsaldcfg. TheBoardN

8: Client Applications — DLI OverviewDC 900-1338I 145//-----------------------------------------------------------------//// "main" section.

146 DC 900-1338IProtocol Software Toolkit Programmer Guidemain // DLI “main” section: //{asyncIO = “yes”; // Use non-blocking I/O //tsiCfgName = "

8: Client Applications — DLI OverviewDC 900-1338I 1478.1.1.2 DLI and TSI Configuration ProcessThis section summarizes the process for configuring DLI

148 DC 900-1338IProtocol Software Toolkit Programmer Guide3. If you have a UNIX or Windows NT system, skip this step. If you have a VMS sys-tem, run t

8: Client Applications — DLI OverviewDC 900-1338I 149VMS example:dlicfg spsaldcfgNT example: freeway\client\op-sys\bin\dlicfg spsaldcfgNoteYou must re

PrefaceDC 900-1338I 15Chapter 7 gives an overview of the interface between the ICP’s host processor and anICP. It also describes the interface between

150 DC 900-1338IProtocol Software Toolkit Programmer Guide8. If you have a Windows NT system, move the binary configuration files that youcreated in S

8: Client Applications — DLI OverviewDC 900-1338I 1518.1.2 Blocking versus Non-blocking I/ONoteEarlier Simpact releases used the term “synchronous” fo

152 DC 900-1338IProtocol Software Toolkit Programmer Guide8.1.3 Buffer ManagementCurrently the interrelated Freeway, DLI, TSI, and ICP buffers default

8: Client Applications — DLI OverviewDC 900-1338I 1538.2 Example Call SequencesTa bl e 8 –3 shows the sequence of DLI function calls to send and recei

154 DC 900-1338IProtocol Software Toolkit Programmer GuideNoteServer-resident applications must use non-blocking I/O. It is alsonecessary to call dlPo

8: Client Applications — DLI OverviewDC 900-1338I 1558.3 Overview of DLI FunctionsAfter the protocol software is downloaded to the ICP, the client and

156 DC 900-1338IProtocol Software Toolkit Programmer GuideTable 8–5: DLI Functions: Syntax and Parameters (Listed in Typical Call Order)DLI Function P

DC 900-1338I 157Chapter9Client Applications — Commands and ResponsesThis chapter presents the data structures required for the client application to e

158 DC 900-1338IProtocol Software Toolkit Programmer Guidetypedef struct {unsigned short usFWPacketType; /* Client’s packet type */unsigned short usFW

9: Client Applications — Commands and ResponsesDC 900-1338I 159struct api_msg {ICP_HDR icp_hdr;PROT_HDR prot_hdr;bit8 *data;};Figure 9–2: “C” Definiti

16 DC 900-1338IProtocol Software Toolkit Programmer Guide• Freeway 8800 Hardware Installation GuideDC-900-1553• Freeway ICP6000R/ICP6000X Hardware Des

160 DC 900-1338IProtocol Software Toolkit Programmer GuideTable 9–1: Comparison of DLI_OPT_ARGS and ICP_HDR/PROT_HDR FieldsDLI_OPT_ARGSin DLI Client P

9: Client Applications — Commands and ResponsesDC 900-1338I 1619.2 Client and ICP CommunicationThe following sections discuss the DLI functions and DL

162 DC 900-1338IProtocol Software Toolkit Programmer Guide9.2.1 Sequence of Client Events to Communicate to the ICP To exchange data with a wide-area

9: Client Applications — Commands and ResponsesDC 900-1338I 1639.2.2 Initiating a Session with the ICP (dlOpen)A session identifier is used by DLI to

164 DC 900-1338IProtocol Software Toolkit Programmer Guide9.2.3 Initiating a Session with an ICP Link (Attach)When the DLI configuration file paramete

9: Client Applications — Commands and ResponsesDC 900-1338I 165From the ICP’s perspective, the attach command establishes a session between the client

166 DC 900-1338IProtocol Software Toolkit Programmer Guideprotocol header. Any subsequent transactions involving this session number will betransmitte

9: Client Applications — Commands and ResponsesDC 900-1338I 1679.2.4 Terminating a Session with an ICP Link (Detach)When the DLI configuration file pa

168 DC 900-1338IProtocol Software Toolkit Programmer GuideICP_HDRcount = size of protocol header (16 bytes)command = DLI_ICP_CMD_DETACHstatus = high b

9: Client Applications — Commands and ResponsesDC 900-1338I 1699.2.5 Activating an ICP Link (Bind)After dlOpen has been called and an attach message w

PrefaceDC 900-1338I 17• OS/Impact Programmer GuideDC-900-1030• Protocol Software Toolkit Programmer GuideDC-900-1338Protocol Support• ADCCP NRM Progra

170 DC 900-1338IProtocol Software Toolkit Programmer GuideICP_HDRcount = size of protocol header (16 bytes)command = DLI_ICP_CMD_BINDstatus = high bit

9: Client Applications — Commands and ResponsesDC 900-1338I 1719.2.5.1 X21bis Line Status Reports (Optional)X21bis line status reports are an optional

172 DC 900-1338IProtocol Software Toolkit Programmer Guide9.2.6 Deactivating an ICP Link (Unbind)Stopping (disabling) the link is accomplished by send

9: Client Applications — Commands and ResponsesDC 900-1338I 173ICP_HDRcount = size of protocol header (16 bytes)command = DLI_ICP_CMD_UNBINDstatus = h

174 DC 900-1338IProtocol Software Toolkit Programmer Guide9.2.7 Writing to an ICP LinkAfter the application has issued a bind command to the ICP, it c

9: Client Applications — Commands and ResponsesDC 900-1338I 1759.2.7.1 Configuring the ICP LinkAfter the client has issued an attach command to the IC

176 DC 900-1338IProtocol Software Toolkit Programmer GuideThe data area in the write is an instance of the CONF_TYPE structure. This structure isdefin

9: Client Applications — Commands and ResponsesDC 900-1338I 177unsigned char parity; /* (async only) 0 = none, 1 = odd,2=even */unsigned char char_len

178 DC 900-1338IProtocol Software Toolkit Programmer GuideICP_HDRcount = size of protocol header (16 bytes) plus data areacommand = DLI_ICP_CMD_WRITEs

9: Client Applications — Commands and ResponsesDC 900-1338I 1799.2.7.2 Requesting Link Statistics From the ICP The get statistics command requests a c

18 DC 900-1338IProtocol Software Toolkit Programmer GuideDocument ConventionsThis document follows the most significant byte first (MSB) and most sign

180 DC 900-1338IProtocol Software Toolkit Programmer GuidePROT_HDRcommand = DLI_PROT_GET_STATISTICS_REPORTsession = session IDAt the ICP, the fields o

9: Client Applications — Commands and ResponsesDC 900-1338I 181DLI_OPT_ARGS.usFWPacketType n/aDLI_OPT_ARGS.usFWCommand n/aDLI_OPT_ARGS.usFWStatus n/aD

182 DC 900-1338IProtocol Software Toolkit Programmer Guide9.2.7.3 Writing Data to an ICP LinkThe write command provides data to the ICP for transmissi

9: Client Applications — Commands and ResponsesDC 900-1338I 183At the ICP, the fields of the ICP and protocol headers that the ICP receives contain th

184 DC 900-1338IProtocol Software Toolkit Programmer GuideDLI_OPT_ARGS.usFWPacketType n/aDLI_OPT_ARGS.usFWCommand n/aDLI_OPT_ARGS.usFWStatus n/aDLI_OP

9: Client Applications — Commands and ResponsesDC 900-1338I 1859.2.8 Reading from the ICP LinkThe ICP sends the following types of messages to the cli

186 DC 900-1338IProtocol Software Toolkit Programmer Guidefrom the link in the area that follows the protocol header. The data area contains thedata r

9: Client Applications — Commands and ResponsesDC 900-1338I 1879.3 Additional Command Types Supported by the SPSIn addition to the API function calls

188 DC 900-1338IProtocol Software Toolkit Programmer Guide9.3.2 Internal Test MessageThe test command is a diagnostic tool used by the client applicat

DC 900-1338I 189AppendixAApplication NotesThis appendix clarifies some points made in the technical manuals and describes somepeculiarities of the dev

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

190 DC 900-1338IProtocol Software Toolkit Programmer GuideThe code required to correctly process SCC interrupts can be found in the sampleprotocol sof

DC 900-1338I 191AppendixBData Rate Time Constants for SCC/IUSC ProgrammingThis appendix provides some commonly used baud rate time constants for SCC/I

192 DC 900-1338IProtocol Software Toolkit Programmer GuideTable B–1: SCC Time Constants for 1X Clock Rate for ICP6000Baud Rate(kbits/sec)Time Constant

B: Data Rate Time Constants for SCC/IUSC ProgrammingDC 900-1338I 193Table B–3: IUSC Time Constants for 1X Clock Rate for ICP2424 and ICP2432Baud Rate(

194 DC 900-1338IProtocol Software Toolkit Programmer Guide

DC 900-1338I 195AppendixCError CodesThere are several methods used by the DLI and ICP software to report errors, asdescribed in the following sections

196 DC 900-1338IProtocol Software Toolkit Programmer GuideTable C–1: ICP Error Status Codes used by the ICPCode Mnemonic Meaning0 DLI_ICP_ERR_NO_ERR A

DC 900-1338I 197IndexNumerics68020 programming environment 37AAbort interrupt 111Acknowledgmentlocal ack 175, 183Acknowledgment response 184Activate I

198 DC 900-1338IProtocol Software Toolkit Programmer Guidecf_lslice 77, 80cf_ltick 77, 80cf_nprior 77, 78cf_ntask 78cfgLink DLI parameter 153chkhio su

IndexDC 900-1338I 199statistics report 181task initialization 73Data structures, size 75DCDloss of 111Deactivate ICP link 172Debug monitor 31DebuggerP

Protogate, Inc.12225 World Trade Drive, Suite RSan Diego, CA 92128(858) 451-0865Protocol Software Toolkit Programmer Guide© 2001 Protogate, Inc. All r

20 DC 900-1338IProtocol Software Toolkit Programmer GuideWe are always interested in suggestions for improving our products. You can use thereport for

200 DC 900-1338IProtocol Software Toolkit Programmer GuideEthernet 24Examplecall sequence 153DLI configuration file 146Exception vector table 39Except

IndexDC 900-1338I 201FREE_QE 122POST_BUF 122POST_QE 122REL_BUF 122TOKEN_BUF 122TOKEN_QE 122disposition modifier 123next buffer 122next element 121part

202 DC 900-1338IProtocol Software Toolkit Programmer GuideSCC transmit buffer empty 110special receive condition 113transmit buffer empty 112transmit

IndexDC 900-1338I 203structure 155, 157Organization of memory 51oscif.h include file 36osdefs.asm file 37OS/Impact 31, 46, 89configuration 65initializ

204 DC 900-1338IProtocol Software Toolkit Programmer GuideReportsstatistics 181statistics data structure 181Request completion 117Responsesattach 166b

IndexDC 900-1338I 205sysequ.asm file 37System buffer header 118, 121initialization 126, 131System callget buffer 118post and resume 126, 133queue crea

206 DC 900-1338IProtocol Software Toolkit Programmer GuideVector table 39Vectors reserved for system software 40VME slave address registersbase addres

Protocol Software Toolkit Programmer GuideDC 900-1338ICustomer Report FormWe are constantly improving our products. If you have suggestions or problem

Protogate, Inc.Customer ServiceP.O. Box 503313San Diego, CA 92150-3313

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

22 DC 900-1338IProtocol Software Toolkit Programmer Guidetiple data links and a variety of network services to LAN-based clients. Figure 1–1 showsthe

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

24 DC 900-1338IProtocol Software Toolkit Programmer GuideSummary of product features:• Provision of WAN connectivity either through a LAN-based Freewa

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

26 DC 900-1338IProtocol Software Toolkit Programmer Guide1.2.1 Establishing Freeway Server Internet AddressesThe Freeway server must be addressable in

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

28 DC 900-1338IProtocol Software Toolkit Programmer Guide1.5 Protocol Toolkit OverviewThe protocol software toolkit helps you develop serial protocol

1: IntroductionDC 900-1338I 29Figure 1–4: ICP PROM and Toolkit Software Components — Freeway ServerICPXIOServer ProcessorSPS TestProgramApplicationPro

DC 900-1338I 3ContentsList of Figures 9List of Tables 11Preface 131Introduction 211.1 Product Overview... 211.1.1 Freew

30 DC 900-1338IProtocol Software Toolkit Programmer GuideFigure 1–5: ICP PROM and Toolkit Software Components — Embedded ICPICPXIOHost ProcessorSPS Te

1: IntroductionDC 900-1338I 311.5.1 Toolkit Software Components The toolkit loopback test program (spsalp.c) is provided in source form and, when com-

32 DC 900-1338IProtocol Software Toolkit Programmer Guide

DC 900-1338I 33Chapter2Software Development for the ICPThis chapter describes the issues involved in developing software for the ProtogateICPs, includ

34 DC 900-1338IProtocol Software Toolkit Programmer Guide• A module containing the source-level debug monitor for the ICP2424(icp2424c.mem), ICP2432 (

2: Software Development for the ICPDC 900-1338I 35During the design and development of your application, you can use this informationto build a comple

36 DC 900-1338IProtocol Software Toolkit Programmer Guide68000 assembler, a linker, and a downloader. The SDS assembler allows you to defineup to 250

2: Software Development for the ICPDC 900-1338I 37For programs written in assembly language, the freeway/icpcode/proto_kit/src directoryincludes the f

38 DC 900-1338IProtocol Software Toolkit Programmer GuideIn user state, the USP is the current stack pointer. In supervisor state, the ISP (usuallycal

2: Software Development for the ICPDC 900-1338I 39NoteThe stack spaces are defined in the linker specification filefreeway/icpcode/proto_kit/icpnnnn1/

4 DC 900-1338IProtocol Software Toolkit Programmer Guide2.4.1 Processor Privilege States... 372.4.2 Stack Pointers...

40 DC 900-1338IProtocol Software Toolkit Programmer GuideWhen programming interrupt service routines in a high-level language, it is usuallynecessary

2: Software Development for the ICPDC 900-1338I 412.4.4 Interrupt Priority LevelsThe Motorola 68xxx supports seven levels of prioritized interrupts, w

42 DC 900-1338IProtocol Software Toolkit Programmer Guide2.5 ICP2424 and ICP2432 Hardware Device ProgrammingThe ICP2424 uses the Motorola 68340 CPU, a

2: Software Development for the ICPDC 900-1338I 43In addition to the Motorola 6834x, the ICP2424 and ICP2432’s programmable devicesinclude: • two, fou

44 DC 900-1338IProtocol Software Toolkit Programmer GuideTimer 1 of the two 8-bit timers is used by the ICP to support DRAM/Refresh. Timer 2is not use

2: Software Development for the ICPDC 900-1338I 452.5.4 Programming the Test Mode RegisterAll modem control signals except Test Mode are handled direc

46 DC 900-1338IProtocol Software Toolkit Programmer Guide• a MC68901 multi-function peripheral (MFP) with four timers, interrupt controllogic, and a s

2: Software Development for the ICPDC 900-1338I 47the console port. Timer channels B and C are dedicated to hardware functions. Do notchange the confi

48 DC 900-1338IProtocol Software Toolkit Programmer Guide2.6.2 Programming the Serial Communications Controllers Four or eight Z8530 or Z85230 serial

2: Software Development for the ICPDC 900-1338I 498 and read register 8 (the transmit and receive data buffers) are accessed directlythrough the chann

ContentsDC 900-1338I 54.3.2.2 Number of Configured Priorities... 784.3.2.3 Tick and Time Slice Lengths... 805Debu

50 DC 900-1338IProtocol Software Toolkit Programmer GuideVector numbers 224–255 (0xE0–0xFF) are dedicated to DMA controller channels 0–31,respectively

DC 900-1338I 51Chapter3Memory OrganizationThis chapter describes the memory maps for the ICP2424, ICP2432, and ICP6000.3.1 ICP2424The 128-kilobyte EPR

52 DC 900-1338IProtocol Software Toolkit Programmer GuideThe ICP2424 Hardware Description and Theory of Operation provides a complete mem-ory map. Ta

3: Memory OrganizationDC 900-1338I 533.2 ICP2432The 128-kilobyte EPROM on the ICP2432 is located at address 0x0000. The EPROMcontains the diagnostics,

54 DC 900-1338IProtocol Software Toolkit Programmer Guide3.3 ICP6000The 64-kilobyte PROM on the ICP6000 is located at address 0x0000. The PROM con-tai

3: Memory OrganizationDC 900-1338I 55Table 3–4: ICP6000 Device and Register Addresses Device or RegisterBase Address(Hexadecimal)DMA command register

56 DC 900-1338IProtocol Software Toolkit Programmer Guide Table 3–5: ICP6000 VME Slave Address Registers Base AddressPhysical Device IDAddress(Hexadec

DC 900-1338I 57Chapter4ICP Download, Configuration, and InitializationSection 4.1 of this chapter describes additional download considerations not cov

58 DC 900-1338IProtocol Software Toolkit Programmer GuideThe Freeway server boot configuration file, used to control the download procedure, iscovered

4: ICP Download, Configuration, and InitializationDC 900-1338I 594.1.1.1 Downloading Without the Debug MonitorUnder normal operations you download the

6 DC 900-1338IProtocol Software Toolkit Programmer Guide7.2.4.3 Completion Status... 1347.3 Reserved System Resources: XIO Int

60 DC 900-1338IProtocol Software Toolkit Programmer GuideNoteDo not remove the comment indicator (#) from the “LOADbuffer.size” statement if the buffe

4: ICP Download, Configuration, and InitializationDC 900-1338I 61## SNMP support notes for SPS toolkit protocol software product SP-000-6013:## When u

62 DC 900-1338IProtocol Software Toolkit Programmer Guide# the example below is for icp6000 normal operation##LOAD xio_6000.mem 40001200#LOAD snmp6000

4: ICP Download, Configuration, and InitializationDC 900-1338I 634.1.1.2 Downloading With the Debug MonitorDuring application development you must dow

64 DC 900-1338IProtocol Software Toolkit Programmer GuideWhen the SDS debug monitor is downloaded along with other executable image files,the placemen

4: ICP Download, Configuration, and InitializationDC 900-1338I 653. Run the make_size utility program, specifying the desired buffer size whenprompted

66 DC 900-1338IProtocol Software Toolkit Programmer GuideFigure 4–2 shows a sample memory layout that specifies the download and start-uplocations in

4: ICP Download, Configuration, and InitializationDC 900-1338I 67Figure 4–3 shows a similar ICP2424 configuration consisting of the system-servicesmod

68 DC 900-1338IProtocol Software Toolkit Programmer GuideFigure 4–4 shows a sample memory layout that specifies the download and start-uplocations in

4: ICP Download, Configuration, and InitializationDC 900-1338I 69Figure 4–5 shows a similar ICP2432 configuration consisting of the system-servicesmod

ContentsDC 900-1338I 79.3.2 Internal Test Message ...1889.3.3 Internal Ping...188A Applicatio

70 DC 900-1338IProtocol Software Toolkit Programmer GuideFigure 4–6 shows a sample memory layout that specifies the download and start-uplocations in

4: ICP Download, Configuration, and InitializationDC 900-1338I 71Figure 4–7 shows a similar ICP6000 configuration consisting of the system-servicesmod

72 DC 900-1338IProtocol Software Toolkit Programmer Guide4.2.1 Configuration Table The format of the configuration table is defined in the OS/Impact P

4: ICP Download, Configuration, and InitializationDC 900-1338I 73Figure 4–9: Sample Configuration Table with Task Initialization Structures** Configur

74 DC 900-1338IProtocol Software Toolkit Programmer Guide4.2.3 Task Initialization RoutineYou must supply a task initialization routine in one of the

4: ICP Download, Configuration, and InitializationDC 900-1338I 753. Allocate space for the timer task’s stack and create the task.4. Use the task init

76 DC 900-1338IProtocol Software Toolkit Programmer GuideTable 4–1: System Data RequirementsStack Bytes RequiredSupervisor stack 1024Timer task’s sta

4: ICP Download, Configuration, and InitializationDC 900-1338I 77Continuing this example, assume that the xio_6000.xrf file shows 0x400045BE as thesys

78 DC 900-1338IProtocol Software Toolkit Programmer Guide4.3.2.1 Number of Configured Task Control StructuresThe cf_ntask field of the configuration t

4: ICP Download, Configuration, and InitializationDC 900-1338I 79For example, suppose that a particular system consists of the following tasks:The ope

8 DC 900-1338IProtocol Software Toolkit Programmer Guide

80 DC 900-1338IProtocol Software Toolkit Programmer Guide4.3.2.3 Tick and Time Slice LengthsTicks measure the duration of alarms and the system’s time

DC 900-1338I 81Chapter5DebuggingThe debugging facilities available depend on whether Software Development Systems’or some other cross development envi

82 DC 900-1338IProtocol Software Toolkit Programmer Guide• the access width (preceded by a semicolon):• b for byte• w for word• l for a longword• an e

5: DebuggingDC 900-1338I 83When PEEKER is entered, a brief summary of the special characters is published afterthe register dump:Peek & Poke <a

84 DC 900-1338IProtocol Software Toolkit Programmer Guide5.2 PTBUG Debugging ToolThe PTBUG debugging tool is available on the ICP6000. The PTBUG Debug

5: DebuggingDC 900-1338I 85Modules built with SDS development tools can be downloaded to the ICP along withthe SDS RAM-based debug monitor. This monit

86 DC 900-1338IProtocol Software Toolkit Programmer GuidePress <ctrl>C to exit this mode. Type one of the following commands, depending on which

5: DebuggingDC 900-1338I 87XIO pushes its panic code onto the stack and calls hio_panic, which executes an illegalinstruction. The illegal instruction

88 DC 900-1338IProtocol Software Toolkit Programmer Guide

DC 900-1338I 89Chapter6ICP SoftwareNoteFrom the ICP’s perspective, the “host processor” can be either theserver processor of the Freeway in which the

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

90 DC 900-1338IProtocol Software Toolkit Programmer Guideconfiguration table, described in Section 4.2 on page 65, are located in the spsasm.asmfile l

6: ICP SoftwareDC 900-1338I 91Figure 6–2: Sample ICP2432 Protocol Software Memory LayoutProtocol Task, Utility Task, and Interrupt Service RoutinesOS

92 DC 900-1338IProtocol Software Toolkit Programmer GuideFigure 6–3: Sample ICP6000 Protocol Software Memory LayoutProtocol Task, Utility Task, and I

6: ICP SoftwareDC 900-1338I 93Figure 6–4: Block Diagram of the Sample Protocol Software — Freeway ServerICPXIOServer ProcessorSPS TestProgramApplicati

94 DC 900-1338IProtocol Software Toolkit Programmer GuideFigure 6–5: Block Diagram of the Sample Protocol Software — Embedded ICPICPXIOHost ProcessorS

6: ICP SoftwareDC 900-1338I 956.1.2 Protocol TaskThis section explains the buffer management method for writing to or reading from theICP’s host. The

96 DC 900-1338IProtocol Software Toolkit Programmer Guidelevel. Completed received data messages are sent to the link’s board-to-server queue toawait

6: ICP SoftwareDC 900-1338I 97the value of the buffer.size file which is downloaded with the application. (See the /free-way/boot/spsload file.)During

98 DC 900-1338IProtocol Software Toolkit Programmer GuideFigure 6–6: Sample Protocol Software Message FormatHeader BufferData BufferHost Request

6: ICP SoftwareDC 900-1338I 996.1.3.1 Read Request ProcessingThe utility task, spshio, issues read requests to XIO to obtain messages from the ICP’sho