VxWorks 5.1.1 - ELTEC Elektronik AG
Contents
1. sysBusToLocalAdrs 2 VXWORKS REFERENCE MANUAL sysBusToLocalAdrs 2 NAME sysBusToLocalAdrs convert a bus address to a local address SYNOPSIS STATUS sysBusToLocalAdrs int adrsSpace bus address space in which busAdrs resides char busAdrs bus address to convert ia char pLocalAdrs where to return local address Ay DESCRIPTION This routine gets the local address that accesses a speci fied VMEbus address RETURNS OK or ERROR if the address space is unknown or the mapping is not possible SEE ALSO sysLib sysLocalToBusAdrs Rev 19 Oct 94 31 sysClkConnect 2 VXWORKS REFERENCE MANUAL sysClkConnect 2 NAME sysClkConnect connect a routine to the system clock interrupt SYNOPSIS STATUS sysClkConnect FUNCPTR routine routine called at each system clock int arg argument with which to call routine DESCRIPTION This routine specifies the interrupt service routine to be called at each clock interrupt It is called from usrRoot in usrConfig c to connect usrClock to the system clock interrupt It also connects the clock error interrupt ser vice routine RETURNS OK or ERROR if the routine cannot be connected to the interrupt un r E ALSO sysLib intConnect usrClock sysClkEnable Rev 19 Oct 94 32 interrupt sysClkDisable 2 NAM Gl sysClkDi2. VxWorks 5 BSP Manual for EUROCOM Revision 1 A elektronik mainz 1 1 17 eltec NAM Gl INTRO BOOT JUMPE Rev 17 CI Reference eltec17 T Eltec EUROCOM 17 DUCTION This manual entry provides board specific information neces sary to run VxWorks Before running VxWorks verify that the board runs in the factory configuration using vendor supplied monitor program RMon and jumper settings and check operation through the RS 232 connection ROMS he EUROCOM 17 uses a flash EPROM for the resident monitor program RMon which is always resident on the EUROCOM 17 The RMon performs various initialization functions on the board and then optionally transfers to the program resident within the user EPROM The user EPROM located at U1602 is used to program VxWorks This EPROM must be a 32 pin device and can be from 128 Kbyte to 1 Mbyte 27C010 to 27C080 The Rmon needs to be set up such that the RMon automatically starts execution of the program resident in the user EPROM nemory To set up the automatic start of the program in user EPROM set rotary switch number 2 to position 8 or higher When the switch is set in this manner the RMon will transfer control to the program located in the user EPROM he EUROCOM 17 has non volatile RAM thus boot parameters are preserved whenever the system is powered off To load V
3. ALSO Rev sysLib 19 Oct 94 VXWORKS REE ER ENC F get th void MANUAL sysMemTop 2 address of the top of memory The address of the top of memory This routine finds the size of memory 45 sysModel 2 VXWORKS REFERENCE MANUAL sysModel 2 NAME sysModel return the model name of the CPU board SYNOPSIS char sysModel void DESCRIPTION This routine returns the model name of the CPU board RETURNS A pointer to the string Eltec EUROCOM 17 SEE ALSO sysLib Rev 19 Oct 94 46 sysNvRamGet 2 VXWORKS REFERENCE MANUAL sysNvRamGet 2 NAME sysNvRamGet get the contents of non volatile RAM SYNOPSIS STATUS sysNvRamGet char string where to copy non volatile RAM 7 int strLen maximum number of bytes to copy auf int offset byte offset into non volatile RAM DESCRIPTION This routine copies the contents of non volatile memory into a specified string The string will be terminated with an EOS RETURNS OK or ERROR if access is outside the non volatile RAM range SEE ALSO sysLib sysNvRamSet Rev 19 Oct 94 47 sysNvRamSet 2 VXWORKS REFERENCE MANUAL sysNvRamSet 2 NAME sysNvRamSet write to non volatile RAM SYNOPSIS STATUS sysNvRamSet char string string to be copied into non vola
4. Switch number 2 is used to select the start up mode that is us pr po au ed by RMon For automatic transfer to the the VxWorks ogrammed in the user EPROM this swicth must be set to sitions 8 F All other positions will not perform an tomatic start of VxWorks Switch S3 on the front panel is used to select VME system co se th fu fu DEVIC ES Rev Th vi ntroller functions When the EUROCOM 17 is placed in slot of the VME chassis the system controller option should be lected When another processor is placed in slot 1 then at processor will usually fulfill the system controller nction and th S3 should not select the system controller nction e cd2400Serial c Cirrus Logic CD 2401 tty driver is pro ded for the four on board serial ports see the manual entry for tyCoDrv Th timer e chip drivers included are nvRam c non volatile RAM z8536Timer c Zilog Counter Timer Parallel I O CIO vic064Vme c Cypress VIC 64 VME interface 19 Oct 94 2 eltec17 T Reference eltec17 T A network interface for the on board ILACC chip allows VxWorks to run without an additional network board The interface is called il and should be specified as the boot device to the boot ROMs A device driver for the NCR 53C720 SCSI Input Output Proces sor SIOP is provided The INCLUDE SCSI directive must be enabled in config h SPECIAL CONSIDERATION
5. See the mode big endian parameter LELLI VXWORKS REFERENCE MANUAL if_il 1 defined as u_short ilCSR_3B is the value that will be placed into ILACC control register 3 The default value supports Motorola type busses See the ILACC manual to change this parameter base address of device registers This parameter is passed to the driver with the ilat tach routine he ILACC presents two registers to the external inter face the RDP register and the RAP register This driver assumes that these two registers occupy two unique addresses in a memory space that is directly accessable by the CPU executing this driver This driver assumes that the RDP register is mapped at a lower address than the RAP register and is therefore considered the base address This parameter indicates to the driver wher to find the RDP register interrupt vector This parameter is passed to the driver with the ilat tach routine This driver configures the ILACC device to generate hardware interrupts for various events within the dev ice Therefore this driver contains an interrupt handler routine This driver will call the VxWorks system function intConnect to connect its interrupt handler to the interrupt vector generated as a result of the ILACC interrupt interrupt level This parameter is passed to the driver with the ilat tach routine Som
6. bus address space in which busAdrs resides char localAdrs local address to convert x char pBusAdrs where to return bus address 7 DESCRIPTION This routine gets the VMEbus address that accesses a speci fied local memory address RETURNS OK or ERROR if the mapping is not possible SEE ALSO sysLib sysBusToLocalAdrs Rev 19 Oct 94 42 sysMailboxConnect 2 VXWORKS REFERENCE MANUAL sysMailboxConnect 2 NAME sysMailboxConnect connect a routine to the mailbox interrupt SYNOPSIS STATUS sysMailboxConnect FUNCPTR routine routine called at each mailbox interrupt int arg argument with which to call routine Ay DESCRIPTION This routine specifies the interrupt service routine to be called at each mailbox interrupt RETURNS OK always SEE ALSO sysLib intConnect sysMailboxEnable Rev 19 Oct 94 43 sysMailboxEnable 2 VXWORKS REFERENCE MANUAL sysMailboxEnable NAME sysMailboxEnable nable the mailbox interrupt SYNOPSIS STATUS sysMailboxEnable char mailboxAdrs address of mailbox ignored DESCRIPTION This routin nables the ICMS 0 mailbox on the VIC064 RETURNS OK always SEE ALSO sysLib sysMailboxConnect Rev 19 Oct 94 2 44 sysMemTop 2 NAM Gl sysMemTop SYNOPSIS char sysMemTop DESCRIPTION RETURNS un I an
7. 2 OK or ERROR if any input parameter is NULL ner720CtlrCreate 18 ner720Show 2 VXWORKS REFERENCE MANUAL ner720Show 2 NAME ner720Show Display values of all readable ncr720 SIOP registers SYNOPSIS STATUS ncr 20Show SCSI_CTRL pScsiCtrl ptr to SCSI controller info DESCRIPTION Displays the state of the SIOP registers in a user friendly way Primarily used during debugging The input parameter is the pointer to the SIOP info structure returned by the ner720CtrlCreate call NOTE The only readable register during a script execution is Istat register If you use this routine during the execution of a SCSI comand the result will be unpredictable EXAMPLE gt ncr 20Show NCR720 Registers Oxfff47000 Scntl3 Oxa5 Scnt12 0x00 Scntl1l 0x00 Scntl0 Oxfff47004 Gpreg 0x00 Sdid 0x00 Sxfer 0x80 Scid Oxfff47008 Sbcl 0x00 Ssid 0x00 Socl 0x00 Sfbr Oxfff4700c Sstat2 0x00 Sstatl 0x00 SstatO 0x00 Dstat Oxfff47010 Dsa 0x00000000 Oxfff47014 Istat 0x00 Oxff 47018 Ctest3 0x00 Ctest2 0x21 Ctestl Oxf0 CtestO Oxfff4701c Temp 0x00000000 Oxff 47020 Ctest6 0x00 Ctest5 0x00 Ctest4 0x00 Dfifo Oxfff47024 Demd Ddc 0x50000000 Oxfff47028 Dnad 0x00066144 Oxfff4702c Dsp 0x00066144 Oxff 47030 Dsps 0x00066174 Oxf 47034 Scratch3 0x00 Scratch2 0x00 Scratchl 0x00 Scratch0 Oxfff47038 Dentl 0x21 Dw
8. RETURNS OK always un r E ALSO sysLib Rev 19 Oct 94 57 tyCoDevCreate 2 VXWORKS REFERENCE MANUAL tyCoDevCreate 2 NAME tyCoDevCreate create a devic for an on board serial port SYNOPSIS STATUS tyCoDevCreate char name name to use for this device int channel physical channel for this device int rdBufSize read buffer size in bytes int wrtBufSize write buffer size in bytes DESCRIPTION This routine creates a device on a specified serial port Each port to be used should have exactly one device associ ated with it by calling this routine For instance to create the devic tyCo 0 with buffer sizes of 512 bytes the proper call would be tyCoDevCreate tyCo 0 0 512 512 RETURNS OK or ERROR if the driver is not installed or the channel is invalid SEE ALSO tyCoDrv Rev 19 Oct 94 58 sf if if wy
9. a network interface record and adding this record to the sys tem list This routine also initializes the driver and the device to the operational state The lt memAdrs gt parameter can be used to specify the location of the memory that will be shared between the driver and the device The value NONE may be used to indicate that the driver should obtain the memory The lt memSize gt parameter is only valid if the lt memAdrs gt parameter is not set to NONE In this case this parameter indicates the size of the provided memory region The lt memWidth gt parameter sets the memory pool s data port width in bytes if NONE any data width will be used RETURNS OK or ERROR SEE ALSO if_il Rev 19 Oct 94 14 74 Af ay f ef Af ne ner720CtriCreate 2 VXWORKS REFERENCE MANUAL ner720CtriCreate 2 NAM Gl ner720CtrlCreate create a control structure for the SIOP SYNOPSIS NCR_720_SCSI_CTRL ncr 720CtrlCreate UINT8 baseAdrs base address of the SIOP UINT freqValue clock controller A DESCRIPTION This routine creates an SIOP data structure and must be called before using an SIOP chip It should be called only once for a given SIOP Since it allocates memory for a structure needed by all routines in ncr720Lib it must be called before any other routines in the library After cal li Ss ng this routine at least one call to ner720CtrlInit hould be perf
10. clock sysClkRateSet 36 sysClkRateSet 2 VXWORKS REFERENCE MANUAL sysClkRateSet 2 NAME sysClkRateSet set the system clock rate SYNOPSIS STATUS sysClkRateSet int ticksPerSecond number of clock interrupts per second DESCRIPTION This routine sets the interrupt rate of the system clock The new interrupt rate is saved If the system clock is currently enabled the clock is disabled and then re enabled with the new rate This routine is called by usrRoot in usrConfig c NOTE The valid range for the system clock is 40 to 5000 ticks per second RETURNS OK or ERROR if the tick rate is invalid or the timer cannot be set SEE ALSO sysLib sysClkEnable sysClkRateGet Rev 19 Oct 94 37 sysHwInit 2 VXWORKS REFERENCE MANUAL sysHwInit 2 NAME sysHwInit initialize the CPU board hardware SYNOPSIS void sysHwInit void DESCRIPTION This routine initializes various features of the CPU board hardware It is called from usrInit in usrConfig c NOTE This routine should not be called by the user RETURNS N A SEE ALSO sysLib Rev 19 Oct 94 38 sysllaccIntEnable 2 VXWORKS REFERENCE MANUAL sysIlaccIntEnable 2 NAME sysIlaccIntEnable nable the ILACC interrupt level SYNOPSIS int sysIlaccIntEnable int level interrupt level
11. in conjunction with a script program for the NCR 53C720 chip The script uses the NCR 53C720 DMA function for data transfers This driver supports cache functions through cacheLib USER CALLABLE ROUTINES Most of the routines in this driver ar accessibl only through the I O system Three routines however must be called directly ncr720CtrlCreate to create a controller structure and ner720CtrliInit to initialize it The NCR 53C720 hardware registers need to be configured according to the hardware implementation If the default configuration is not proper the routine ncr720SetHwRegister should be used to properly configure the registers INCLUDE FILES ner720 h ncr7 720Script h SEE ALSO scsiLib Programmer s Guide I O System Rev 19 Oct 94 13 ilattach 2 VXWORKS REFERENCE MANUAL ilattach 2 NAME ilattach publish the interface and initialize the driver and device SYNOPSIS STATUS ilattach int unit unit number char devAdrs ILACC i o address int ivec interrupt vector int ilevel interrupt level char memAdrs address of memory pool 1 malloc it ULONG memSize only used if memory pool is NOT malloced int memWidth byte width of data 1 any width int spare not used int spare2 not used DESCRIPTION The routine publishes the il interface by filling in
12. nt level int vector sysMailboxConnect UNCPTR routine int arg sysMailboxEnable char mailboxAdrs STATUS sysVicBlkEnable VOIDFUNCPTR vector int level int burstLength int interleave STATUS sysVicBlkAd j int burstLength int interleave STATUS sysVicBlkCopy char localAddr char remoteAddr int nbytes BOOL toVme intsysVicShow STATUS sysClkConnect FUNCPTR routine int arg i r G E WEEK PDP DANA void sysClkInt void void sysClkDisable void void sysClkEnable void int sysClkRateGet void STATUS sysClkRateSet int ticksPerSecond STATUS sysAuxClkConnect FUNCPTR routine int arg void sysAuxClkDisable void void sysAuxClkEnable void int sysAuxClkRateGet void STATUS sysAuxClkRateSet int ticksPerSecond char sysModel void char sysBspRev void void sysHwInit Rev 19 Oct 94 5 sysLib 1 VXWORKS REE ERENCE MANUAL void int sysFrontPanelSwitch int swNum int sysSetLed int hexVal char sysMemTop void US sysToMonitor int startType US sysLocalToBusAdrs int adrsSpace char US sysBusToLocalAdrs int adrsSpace char sysProcNumGet void void sysProcNumSet int procNum BOOL sysBusTas char adrs US sysSysfailConnect VOIDFUNCPTR routine US sysAcfailConnect VOIDFUNCPTR routine int sysIlaccIntEnable int lev
13. 1 for each bit of each register describe bellow This routine includes only the bit registers that could modify the behavior of the chip The default configuration used during ner720CtlrCreate and ner720CrtliInit is 0 0 0 0 1 0 0 0 0 0 0 0 0 1 0 typedef struct int ctest4Bit7 Host bus multiplex mode int ctestOBit7 Disable enable burst cache capability int ctestOBit6 Snoop control bitl int ctestOBit5 Snoop control bitO int ctestOBitl invert ttl pin sync bus host mode only int ctest2Bit5 enable differential scsi bus capability int ctest3Bit0 Set snoop pins mode int dmodeBit7 Burst Lenght transfer bit 1 int dmodeBit6 Burst Lenght transfer bit 0 int dmodeBit5 Function code bit FC2 int dmodeBit4 Function code bit FCl int dmodeBit3 Program data bit FCO int dmodeBitl user programmable transfer type int dentlBit5 Enable Ack pin int dcentlBitl Enable fast arbitration on host port NCR720_HW_REGS To get a more detailled explanation regarding the descrip tion of each register involved s the User s Manual of the NCR 53C720 NOTE Because this routine writes to the chip registers you can t use it if there is any SCSI bus activity Rev 19 Oct 94 17 ER ENCE F ncr 20SetHwRegister 2 VXWORKS REF RETURNS n I E ALSO ner720Lib Rev 19 Oct 94 ner720 h MANUAnLcr720SetHwRegister
14. ERENCE MANUAL if_il 1 size requested is 80 542 bytes If a memory region is pro vided to the driver the size of this region is adjustable to suit your needs The ILACC can only be operated if the shared memory region is write coherent with regards to the data cache The driver cannot maintain cache coherency for the device for data that is written by the driver This is because fields within the shared structures are asynchronously modified by both the driver and the device and these fields may share the same cache lin un T E ALSO ifLib Rev 19 Oct 94 12 ner720Lib 1 VXWORKS REFERENCE MANUAL ner720Lib 1 NAME ncr720Lib NCR 53C720 SCSI I O Processor SIOP library SYNOPSIS ner720CtrlCreate create a control structure for the SIOP ner720CtrlInit initialize a control structure for the SIOP ncer720SetHwRegister set Hardware dependant registers ner720Show Display values of all readable ncr720 SIOP registers NCR_720_SCSI_CTRL ncr720CtrlCreate UINT8 baseAdrs UINT freqValue STATUS ner720CtrliInit NCR_720_SCSI_CTRL pSiop int scsiCtrlBusld int scsiPriority STATUS ncr 20SetHwRegister SIOP pSiop NCR720_HW_REGS pHwRegs STATUS ncr720Show SCSI_CTRL pScsiCtrl DESCRIPTION This is the I O driver for the NCR 53C720 SCSI I O Processor SIOP It is designed to work in conjuction with scsiLib This driver runs
15. ERENCE MANUAL sysAuxClkRateGet 2 NAME sysAuxClkRateGet get the auxiliary clock rate SYNOPSIS int sysAuxClkRateGet void DESCRIPTION This routine returns the interrupt rate of the auxiliary clock RETURNS The number of ticks per second of the auxiliary clock SEE ALSO sysLib sysAuxClkEnable sysAuxClkRateSet Rev 19 Oct 94 25 sysAuxClkRateSet 2 VXWORKS REFERENCE MANUAL sysAuxClkRateSet 2 NAME sysAuxClkRateSet set the auxiliary clock rate SYNOPSIS STATUS sysAuxClkRateSet int ticksPerSecond number of clock interrupts per second DESCRIPTION This routine sets the interrupt rate of the auxiliary clock If the auxiliary clock is currently enabled the clock is disabled and then re enabled with the new rate RETURNS OK or ERROR SEE ALSO sysLib sysAuxClkEnable sysAuxClkRateGet Rev 19 Oct 94 26 sysBspRev 2 VXWORKS REFERENCE MANUAL sysBspRev 2 NAME sysBspRev return the bsp version with the revision eg 1 0 lt x gt SYNOPSIS char sysBspRev void DESCRIPTION This function returns a pointer to a bsp version with the revision for eg 1 0 lt x gt BSP_REV defined in config h is concatanated to BSP_VERSION defined in bspVersion h and returned RETURNS A pointer to the BSP version revision string SEE ALSO sysLib Rev 19 Oct 94 27 sysBu
16. S BOARD LAYOUT un T E The ILACC chip needs to be informed of its Ethernet address before it can attach to the LAN The address is obtained from the RMon EPROM which is unique for each board Console connection is through serial port number 1 which is located on the the front connector An adapter cable is available for this interface The adapter cable converts the telephone jack connector to a D9 connection in the DCE con figuration The NCR53C520 SCSI library supports SCSI wide and SCSI fast however thes features are currently not supported by the SCSI library Therefore special functions are present to place a compatible SCSI device in the fast and or wide mode See the manual pages for sysScsiFast and sysScsiWide for additional information he EUROCOM 17 has a watchdog fucntion that when enabled ust be triggerred at a minumum of the frequency selected by J1401 setting 100 ms or 15 56 seconds The NCLUDE_WDOG definition within config h enables this eature The VIC 64 VME interface driver provides an optional VME DMA copy function which is enabled by the inclusion of the INCLUDE_VIC_BLK_XFER definition within the config h file See the manual entry for sysVicBlkCopy for additional infor mation on block copies x The EUROCOM 17 does not have any jumpers that need be in set positions for operation with VxWorks Refer to the EUROCOM 17 technical man
17. S sysAuxClkConnect FUNCPTR routine int arg Vegi DESCRIPTION ct a routine to the auxiliary routine called at each aux clock interrupt argument with which to call routine 7 interrupt service routine to be This routine specifies th called at each auxiliary clock interrupt It also connects the clock error interrupt RETURNS OK or ERROR if the routi interrupt un E ALSO service routine ne cannot be connected to the sysLib intConnect sysAuxClkEnable Rev 19 Oct 94 22 sysAuxClkDisable 2 NAM Gl sysAuxClkDisable SYNOPSIS void sysAuxClkDisable DESCRIPTION This routine disables auxiliary clock RETURNS un r iy N A ALSO Rev VXWORKS REEF ER ENC F MANUAL sysAuxClkDisable 2 turn off auxiliary clock interrupts void sysLib sysAuxClkEnable 19 Oct 94 interrupts 23 sysAuxClkEnable 2 NAM Gl sysAuxClkEnable SYNOPSIS VXWORKS REEF Enable void sysAuxClk DESCRIPTION RETURNS N A un I IE ALSO ER ENC F void sysLib sysAuxClkDisable Rev 19 Oct 94 MANUAL sysAuxClk This routine enables auxiliary clock interrupts Enable 2 turn on auxiliary clock interrupts 24 sysAuxClkRateGet 2 VXWORKS REF
18. driver of target hardware given several the mechanisms used detailed below If and assumptions mentioned below a this driver will ar re not true for your not function hardware T driver e can be ndian architectures LAYOUT his device is onboard J INTERFACE his driver provides the he following thin the attach routine Therefore function poi C wi ma TARGE Rev F SPECIFIC PARAM ETERS buss mode This parame Ger The ILACC con of the device and little endian 19 Oct 94 his driver supports only configured to support exceptions There is one user callable probably one ILACC unit per big endian Ethernet to if_il 1 Ethernet network interface driver and initialize the int ilevel int spare network gen be run To achieve target specific support routines must be pro to commun any of the particular correctly CPU The or little No jumpering diagram required standard external All routine and there is no separate in the global interface structure nter to the init routine is NULL routine ilattach nual entry for this routine for usage details is globally accessed trol register 3 determines the buss This allows the support of architectures This interface initialization is performed with ne ipit t
19. e target hardware use additional interrupt con troller devices to help organize and service the vari ous interrupt sources This driver avoids all board specific knowledge of such devices During the ini tialization of this driver an external routine is called to perform any board specific operations required to allow the servicing of a ILACC interrupt This routine is described below This parameter is passed to the external routine shared memory address Rev 19 Oct 94 9 LELLI Rev VXWORKS REFERENCE MANUAL Ptah O D This parameter is passed to the driver with the ilat tach routine The ILACC device is a DMA type of device and typically shares access to some region of memory with the CPU This driver is designed for systems that directly share memory between the CPU and the ILACC This driver assumes that this shared memory is directly available to this driver without any arbitration or timing con cerns This parameter may be used to specify an explicit memory region for use by the ILACC This should be used on hardware that restricts the ILACC to a particu lar memory region The constant NONE may be used to indicate that there are no memory limitations In this case the driver will attempt to allocate the shared memory from the system space shared memory size his parameter is passed to the driver with the ilat tach routine his parameter can be used to exp
20. el STA A A int STA A ESCRIPTION This library provides drivers included are nvRam c cd2400Serial c library z8536Timer c library vic064Vme c roller library INCLUDE FILES sysLib h un T E ALSO Programmer s Guide Rev 19 Oct 94 board specific Zilog Cypress VIC 068 VMEbus interface sysLib 1 localAdrs char pBusAdrs busAdrs char pLocalAdrs int arg int arg routines The chip non volatile RAM library Cirrus CD 2400 serial device module 8536 Counter Timer devic con Configuration tyCoDrv 1 VXWORKS REFERENCE MANUAL tyCoDrv 1 NAME tyCoDrv Eltec EUROCOM 17 Cirrus Logic CD2400 MPCC tty driver SYNOPSIS tyCoDrv tty driver initialization routine tyCoDevCreate create a device for an on board serial port STATUS tyCoDrv void STATUS tyCoDevCreate char name int channel int rdBufSize int wrtBufSize DESCRIPTION This is the driver for the Cirus Logic CD2400 MPCC It uses the SCC s in asynchronous mode only USER CALLABLE ROUTINES Most of the routines in this driver ar accessibl only through the I O system Two routines however must be called directly tyCoDrv to initialize the driver and tyCoDevCreate to create devices Before the driver can be used it must be initialized by ca
21. isplay is negative then blanked RETURNS OK un T T ALSO sysLib Rev 19 Oct 94 the display will be 51 sysSysfailConnect 2 VXWORKS REFERENCE MANUAL sysSysfailConnect 2 NAME sysSysfailConnect connect a routine to the SYSFAIL sig nal SYNOPSIS STATUS sysSysfailConnect VOIDFUNCPTR routine routine to be connected to SYSFAIL signal int arg argument with which to call routine xy DESCRIPTION This routine connects a specified routine to the board s SYSFAIL signal RETURNS OK or ERROR if the routine cannot be connected to the interrupt SEE ALSO sysLib intConnect Rev 19 Oct 94 52 sysToMonitor 2 VXWORKS REFERENCE MANUAL sysToMonitor 2 NAME sysToMonitor transfer control to the ROM monitor SYNOPSIS STATUS sysToMonitor int startType parameter passed to ROM to tell it how to boot DESCRIPTION This routine transfers control to the ROM monitor Nor mally it is called only by reboot which services X and bus errors at interrupt level However in some cir cumstances the user may wish to introduce a lt startType gt to enable special boot ROM facilities RETURNS Does not return un T E ALSO sysLib Rev 19 Oct 94 53 sysVicBlkAdj 2 VXWORKS REFERENCE MANUAL sysVicBlkAdj 2 NAME sysVicB
22. licitly limit the amount of shared memory bytes this driver will use The constant NONE may be used to indicate no specific size limitation This parameter is only used if a specific memory region is being provided to the driver shared memory width This parameter is passed to the driver with the ilat tach routine Some target hardware that restricts the shared memory region to a specific location also restricts the access width to this region by the CPU On these tar gets performing an access of an invalid width will cause a buss error This parameter can be used to specify the number of bytes of access width to be used by the driver during access to the shared memory The constant NONE may be used to indicate no restrictions The current internal implementation of supporting this mechanism is not robust and may not work on all tar gets requiring these restrictions shared memory buffer size 19 Oct 94 10 LELLI VXWORKS REFERENCE MANUAL if_il 1 This parameter is passed to the driver with the ilat tach routine he driver and ILACC device exchange network data in buffers This parameter allows you to limit the size of these individual buffers A value of zero indicates that the default buffer size should be used The default buffer size is large enough to hold a maximum size Ethernet packet Use of this parameter should be extremely rare Net work perfor
23. lignments SEE ALSO sysLib sysVicBlkEnable sysVicBlkAdj Rev 19 Oct 94 55 Rif ne A sysVicBlkEnable 2 VXWORKS REFERENCE MANUAL sysVicBlkEnable 2 NAME sysVicBlkEnable initialize the DMA copy operation for the VIC 64 SYNOPSIS STATUS sysVicBlkEnable VOIDFUNCPTR vector interrupt vector for DMA done interrupt 7 int level interrupt level for DMA done interrupt 7 int burstLength burst length of DMA block transfer 1 64 int interleave interleave period between bursts 1 15 a DESCRIPTION This routine initializes operations for DMA transfers using the VIC 64 The DAM done interrupt is attached using the lt vector gt as the interrupt vector and lt level gt as the inter rupt level lt burstLength gt is the number of VMEbus cycles per burst lt interleave gt is the local cycle interleave period between block transfers The interleave time is equal to 250ns times lt interleave gt This routine is typically called by sysHwInit2 RETURNS OK or ERROR if the DMA paramters are not valid SEE ALSO sysLib sysVicBlkAdj sysVicBlkCopy Rev 19 Oct 94 56 sysVicShow 2 VXWORKS REFERENCE MANUAL sysVicShow 2 NAM Gl sysVicShow displays the contents of the VIC 64 registers SYNOPSIS int sysVicShow DESCRIPTION This routine displays the contents of the VIC 64 registers
24. lkAdj adjust burst length and interleave period for DMA transfers SYNOPSIS STATUS sysVicBl1kAdj int burstLength burst length of DMA block transfer 1 64 int interleave interleave period between bursts 1 15 DESCRIPTION This routine changes the burst length and interleave period that are to be used for VME DMA transfers lt burstLength gt is the number of VMEbus cycles per burst lt interleave gt is the local cycl interleave period between block transfers The interleave time is equal to 250ns times lt interleave gt RETURNS OK or ERROR if parameters are out of range SEE ALSO sysLib sysVicBlkEnable sysVicBlkCopy Rev 19 Oct 94 54 sysVicBlkCopy 2 VXWORKS REFERENCE MANUAL sysVicBlkCopy 2 NAME sysVicBlkCopy copy blocks over the VMEbus using the VIC s DMA feature SYNOPSIS STATUS sysVicBlkCopy char localAddr local address char remoteAddr vme address int nbytes transfer length in bytes BOOL toVme copy local memory to vme or vise versa DESCRIPTION This routine uses the DMA feature of the VIC to do block mode copies to from the VMEbus This routine takes a local address lt localAddr gt and remote address lt remoteAddr gt and tranfers lt nbytes gt bytes in the direction specified by lt toVme gt RETURNS OK or ERROR if transfer was unsuccessful Unsuccessful transfers result from bus errors or bad a
25. lling tyCoDrv This routine should be called exactly once before any reads writes or calls to tyCoDevCreate Normally it is called from usrRoot in usrConfig c Before a terminal can be used it must be created using tyCoDevCreate Each port to be used should have exactly one device associated with it by calling this routine IOCTL FUNCTIONS This driver responds to the same ioctl codes as a normal tty driver for more information see the manual entry for tyLib The available baud rates are 50 110 150 300 600 1200 2400 3600 4800 7200 9600 19200 and 38400 un T E ALSO tyLib Rev 19 Oct 94 7 LELLI NAM Gl SYNOPSIS EN VXWORKS R f il AMD 79900 ILACC ilattach publish the driver and device STATUS ilattach int unit char memAdrs int spare2 ULONG ESCRIPTION ERAL INFORMATION BOA EXT RD ERNAL his module implements t interface driver his driver is designed ericism VxWorks 5 1 supports T unmodified on a this goal parameters and some ex icate them to th EE ER ENCE MANUAL char devAdrs he AMD 79900 ILACC variety the driver must be ternal vided These parameters driver interface int ivec memSize int memWidth to achieve a moderate level of across the range of architectures and targets that his allows the
26. mance will be affected since the target will no longer be able to receive all legal sizes of packets Ethernet address This parameter is obtained directly from a global memory location During initialization the driver needs to know the Ethernet address for the ILACC device The driver assumes that this address is available in a global 6 byte character array named ilEnetAddr This array is typically created and stuffed by the BSP code EX ERNAL SUPPORT REQUIREMENTS This driver requires on xternal support routine to be pro vided void sysIlaccIntEnable int level This routine provides a target specific enable of the interrupt for the ILACC device This typically involves interrupt controller hardware ither internal or external to the CPU This routine is called once from the ilattach routine SYSTEM RESOURCE USAGE The driver requires the following system resources one mutual exclusion semaphore one interrupt vector 5016 bytes in code section text 28 bytes in the initialized data section data 2244 bytes in the uninitialized data section bss The sections are quoted for the MC68040 architecture and will vary for other architectures If the driver allocates the memory to share with the ILACC it does so by calling the cacheDmaMalloc routine The Rev 19 Oct 94 Aa LELLI VXWORKS REF
27. ne pulses RST reset on the SCSI bus thus resetting all attached devices A detailed description of the input parameters follows lt pSiop gt a pointer to the NCR_720_SCSI_CTRL structure created with ncr720CtrlCreate lt scsiCtrlBusId gt the SCSI bus ID of the SIOP Its value is somewhat arbitrary seven 7 or highest priority is conven tional The value must be in the range 0 7 lt scsiPriority gt the priority to which a task is set when performing a SCSI transaction Legal priorities are 0 to 255 Alternately a 1 indicates that the priority should not be altered during SCSI transactions OK or ERROR if parameters are out of range SEE ALSO ner720Lib Rev 19 Oct 94 16 ner720SetHwRegister 2 VXWORKS REFERENCE MANUAnLcr720SetHwRegister 2 NAME ncer720SetHwRegister set Hardware dependant registers SYNOPSIS STATUS ncr 20SetHwRegister SIOP pSiop Pointer to SIOP infos LT NCR720_HW_REGS pHwRegs Pointer to a NCR720 HW _REGS info DESCRIPTION This routine is used to set up the registers involved in the hardware implementation of the chip Typically this rou tine is called by the sysScsiInit routine from the bsp The input parameters are the pointer returned by ner720CtriCreate and a pointer to a NCR720_HW_REGS struc ture that is filled with the logical values 0 or
28. not used DESCRIPTION This routin nables interrupts for the on board ILACC chip at a specified level ILACC interrupts are controlled by the VIC chip The VIC chip also provides the interrupt vec tor RETURNS OK SEE ALSO sysLib Rev 19 Oct 94 39 sysIntDisable 2 VXWORKS REFERENCE MANUAL sysintDisable 2 NAME sysIntDisable disable a bus interrupt level SYNOPSIS STATUS sysIntDisable int intLevel interrupt level to disable 1 7 DESCRIPTION This routine disables a specified VMEbus interrupt level RETURNS OK or ERROR if lt intLevel gt is not in the range 1 7 SEE ALSO sysLib sysIntEnable Rev 19 Oct 94 40 sysIintEnable 2 NAM Gl sysIntEnable SYNOPSIS STATUS sysInt VXWORKS REEF ER ENC F Enable MANUAL sysIntEnable 2 enable a bus interrupt level int intLevel interrupt level to enable 1 7 DESCRIPTION RETURNS n T E ALSO sysLib sysIntDisable Rev 19 Oct 94 This routine enables a specified VMEbus interrupt level OK or ERROR if lt intLevel gt is not in the range 1 7 41 sysLocalToBusAdrs 2 VXWORKS REFERENCE MANUAL sysLocalToBusAdrs 2 NAME sysLocalToBusAdrs convert a local address to a bus address SYNOPSIS STATUS sysLocalToBusAdrs int adrsSpace
29. orm before any SCSI transactions are initiated using the SIOP A detailed description of the input parameters follows lt baseAdrs gt The address at which the CPU would access the lowest register of the SIOP lt freqValue gt The value at the SIOP SCSI CLK input This is used to determin th clock period for the scsi core of the chip and the synchronous divider value for synchronous transfer It is important to have the right timing on the SCSI bus RETURNS A pointer to NCR_720_SCSI_CTRL structure or NULL if memory is unavailable or there are bad parameters SEE ALSO ner720Lib Rev 19 Oct 94 15 ncr 20Ctrlinit 2 VXWORKS REFERENCE MANUAL ner720CtrliInit 2 NAME ner720CtrliInit initialize a control structure for the SIOP SYNOPSIS STATUS ner720CtrlInit NCR_720_SCSI_CTRL pSiop ptr to SIOP struct a int scsiCtrlBusId SCSI bus ID of this SIOP Ai int scsiPriority priority of a task when doing SCS 1 T O 7 DESCRIPTION RETURNS This routine initializes an SIOP structure after the struc ture is created with ncr720CtrlCreate This structure must be initialized before the SIOP can be used It may be called more than once if needed however it should only be called while there is no activity on the SCSI interface Before using the SIOP it must be initialized by calling this routine Before returning this routi
30. rate sysClkRateSet set the system clock rate sysAuxClkConnect connect a routine to the auxiliary clock interrupt sysAuxClkDisable turn off auxiliary clock interrupts sysAuxClkEnable turn on auxiliary clock interrupts sysAuxClkRateGet get the auxiliary clock rate sysAuxClkRateSet set the auxiliary clock rate sysModel return the model name of the CPU board sysBspRev return the bsp version with the revision eg 1 0 lt x gt sysHwInit initialize the CPU board hardware sysFrontPanelSwitch read the front panel switches sysSetLed set value in LED sysMemTop get the address of the top of memory sysToMonitor transfer control to the ROM monitor sysLocalToBusAdrs convert a local address to a bus address sysBusToLocalAdrs convert a bus address to a local address sysProcNumGet get the processor number sysProcNumSet set the processor number sysBusTas test an d set a location across the bus sysSysfailConnect signal connect a routine to the SYSFAIL sysAcfailConnect connect a routine to the ACFAIL signal sysIlaccIntEnable Rev 19 Oct 94 nable the ILACC interrupt level sysLib 1 VXWORKS REFERENCE MANUAL sysLib 1 STATUS sysNvRamGet har string int strLen int offset sysNvRamSet har string int strLen int offset sysIntDisable nt intLevel sysIntEnable nt intLevel sBusIntAck nt intLevel sysBusIntGen
31. sIntAck 2 VXWORKS REFERENCE MANUAL sysBusIntAck 2 NAME sysBusIntAck acknowledge a bus interrupt SYNOPSIS int sysBusIntAck int intLevel interrupt level to acknowledge DESCRIPTION This routine acknowledges a specified VMEbus interrupt level The VIC 64 performs this function automatically RETURNS NULL Performed by hadrware SEE ALSO sysLib sysBusIntGen Rev 19 Oct 94 28 sysBusIntGen 2 VXWORKS REFERENCE MANUAL sysBusIntGen 2 NAME sysBusIntGen generate a bus interrupt SYNOPSIS STATUS sysBusIntGen int level VMEbus interrupt level to generate 1 7 int vector interrupt vector to generate 0 255 DESCRIPTION This routine generates a bus interrupt for a specified level with a specified vector RETURNS OK ERROR if interrupt level out of range 1 7 or vector is out of range 0 255 or a previous unacknowledged interrupt is pending SEE ALSO sysLib sysBusIntAck Rev 19 Oct 94 29 sysBusTas 2 VXWORKS REFERENCE MANUAL sysBusTas 2 NAME sysBusTas test and set a location across the bus SYNOPSIS BOOL sysBusTas char adrs address to be tested and set DESCRIPTION This routine performs a 680x0 test and set instruction across the backplane RETURNS TRUE successful set or FALSE failure SEE ALSO sysLib vxTas Rev 19 Oct 94 30
32. sable SYNOPSIS void sysClkDisable void DESCRIPTION This routine disables system clock interrupts RETURNS un ry N A ALSO Rev VXWORKS REEF ER ENC F MANUAL sysClkDisable 2 turn off system clock interrupts sysLib sysClkEnable 19 Oct 94 33 sysClkEnable 2 VXWORKS REFERENCE MANUAL sysClkEnable 2 NAME sysClkEnable turn on system clock interrupts SYNOPSIS void sysClkEnable void DESCRIPTION This routine enables system clock interrupts RETURNS N A SEE ALSO sysLib sysClkConnect sysClkDisable sysClkRateSet Rev 19 Oct 94 34 sysClkInt 2 VXWORKS REFERENCE MANUAL sysClkInt 2 NAME sysClkInt handle a system clock interrupt SYNOPSIS void sysClkInt void DESCRIPTION This routine handles a system clock interrupt It ack nowledges th interrupt and calls the routine installed by sysClkConnect SEE ALSO sysLib Rev 19 Oct 94 35 sysClkRateGet 2 VXWORKS R NAM Gl EE ER ENC E MANUAL sysClkRateGet get th SYNOPSIS int sysClkRateGet void ESCRIPTION ETURNS The number of un I iF ALSO sysLib sysClkEnable Rev 19 Oct 94 sysClkRateGet 2 system clock rate This routine returns the interrupt rate of the system clock ticks per second of the system
33. t 0x00 Dien 0x37 Dmode Oxfff4703c Adder 0x000cc2b8 Oxfff47040 Sistl 0x00 Sistl 0x00 Sienl 0x00 Sien0 Oxfff47046 Gpentl 0x00 Macntl 0x00 Swide 0x00 Slpar Oxfff4704a RespID Stimel 0x00 StimeO Oxfff4704c Stest3 0x00 Stest2 0x00 Stestl 0x00 StestO Oxfff47052 Sidl 0x0000 Oxfff47056 Sodl 0x0000 Oxfff4705a Ssbdl 0x0000 Oxfff4705c ScracthB 0x00000000 value 0 0x0 Rev 19 Oct 94 19 0x04 0x80 0x00 0x80 0x00 0x00 Ox0a 0x01 0x00 0x00 0x00 0x00 ncr 20Show 2 VXWORKS REFERENCE SEE ALSO ner720Lib ncr720CtrlCreate RETURNS OK or ERROR if lt pScsiCtrl gt and NULL Rev 19 Oct 94 MANUAL ner720Show 2 lt pSysScsiCtrl gt are both 20 sysAcfailConnect 2 VXWORKS REFERENCE MANUAL sysAcfailConnect 2 NAME sysAcfailConnect connect a routine to the ACFAIL signal SYNOPSIS STATUS sysAcfailConnect VOIDFUNCPTR routine routine to be connected to ACFAIL signal int arg argument with which to call routine Ka DESCRIPTION This routine connects a specified routine to the board s ACFAIL signal RETURNS OK or ERROR if the routine cannot be connected to the interrupt SEE ALSO sysLib intConnect Rev 19 Oct 94 2al sysAuxClkConnect 2 VXWORKS REE ERENCE MANUAL sysAuxClkConnect 2 NAME sysAuxClkConnect conn clock interrupt SYNOPSIS STATU
34. tile RAM int strLen maximum number of bytes to copy xf int offset byte offset into non volatile RAM x DESCRIPTION This routine copies a specified string into non volatile RAM RETURNS OK or ERROR if access is outside the non volatile RAM range SEE ALSO sysLib sysNvRamGet Rev 19 Oct 94 48 sysProcNumGet 2 sysProcNumGet 2 VXWORKS REFERENCE MANUAL NAME sysProcNumGet get the processor number SYNOPSIS int sysProcNumGet void DESCRIPTION This routine returns the processor number for the CPU board which is set with sysProcNumSet RETURNS The processor number for the CPU board SEE ALSO sysLib sysProcNumSet Rev 19 Oct 94 49 sysProcNumSet 2 VXWORKS R EE ERENCE MANUAL processor number sysProcNumSet 2 the CPU board Processor numbers should be unique on a single backplane NAME sysProcNumSet set th SYNOPSIS void sysProcNumSet int procNum DESCRIPTION This routine sets the processor number for RETURNS N A SEE ALSO sysLib sysProcNumGet Rev 19 Oct 94 50 sysSetLed 2 VXWORKS REFERENCE MANUAL NAM Gl sysSetLed set value in LED SYNOPSIS int sysSetLed sysSetLed 2 int hexVal value to display in DESCRIPTION This routine sets a value into the hex LED display display When the value to d
35. ual for the locations of jumpers switches and EPROMs ALSO Rev Programmer s Guide Getting Started Configuration RMon Mon itor Program Programmers Reference Manual RMon User Manual Software Manual EUROCOM 17 Technical Manual 19 Oct 94 3 sysLib 1 VXWORKS R BE ER ENCE MANUAL sysLib 1 NAME sysLib Eltec EUROCOM 17 system dependent library SYNOPSIS sysNvRamGet get the contents of non volatile RAM sysNvRamSet write to non volatile RAM sysIntDisable disable a bus interrupt level sysIntEnable enable a bus interrupt level sysBusIntAck acknowledge a bus interrupt sysBusIntGen generate a bus interrupt sysMailboxConnect connect a routine to the mailbox interrupt sysMailboxEnable nable the mailbox interrupt sysVicBlkEnable initialize the DMA copy operation for the VIC 64 sysVicBlkAdj adjust burst length and interleave period for DMA transfers sysVicBlkCopy copy blocks over the VMEbus using the sysVicShow VIC s DMA feature displays the contents of t he VIC 64 registers sysClkConnect connect a routine to the system clock interrupt sysClkInt handle a system clock interrupt sysClkDisable turn off system clock interrupts sysClkEnable turn on system clock interrupts sysClkRateGet get the system clock
36. xWorks and for more information follow the instructions in the Getting Started chapter of the VxWorks Programmer s Guide RS The EUROCOM 17 factory configured for immediate operation with VxWorks The table below lists the jumpers for the EUROCOM 17 Starred settings indicate the factory default and are appropriate for use with VxWorks Jumper Description J1401 Watch dog period closed when 100 ms open when 1 6 seconds J1601 Flash programming voltage open when not present closed when present J1605 Pinl connection for EPROM 1 2 when 5 volts 2 3 when A19 19 Oct 94 1 eltec17 T Reference eltec17 T SWITC HES The EUROCOM 17 has two rotary switches on the front panel of the processor board Switch number 1 is used to select the VMEbus address A32 and A16 for RMon The addressing is as defined in the following table Position A32 Space A16 Space F 0xF0000000 OxF000 E 0xF0000000 OxF000 D 0xF0000000 OxF000 2 0x20000000 0x2000 ii 0x10000000 0x1000 0 RMon defined RMon defined A24 addressing is always disbled by using the RMon defaults VxWorks can inherit the addressing asignments set up by RMon LE desired When VxWorks is built with the US E_RMON_CONFIG defined then VxWorks will use the RMon addressing When USE_RMON_CONFIG is not defined the addressing is set as per the LOCAL_MEM_BUS_ADRS definition wi thin config h and the processor number
Download Pdf Manuals
Related Search