VxWorks - ELTEC Elektronik AG
Contents
1. This routine disables a specified VMEbus interrupt level OK or ERROR if lt intLevel gt is not in the range 1 7 sysLib sysIntEnable Programmers Reference Manual ELTEC sysIntEnable 2 VxWorks Reference Manual sysIntEnable 2 sysIntEnable 2 Name sysIntEnable enable a bus interrupt level Synopsis STATUS sysIntEnable int intLevel interrupt level to enable 1 7 Description This routine enables a specified VMEbus interrupt level Returns OK or ERROR if lt intLevel gt is not in the range 1 7 See Also sysLib sysIntDisable ELTEC Programmers Reference Manual 57 sysLocalToBusAdrs 2 VxWorks Reference Manual sysLocalToBusAdrs 2 sysLocalToBusAdrs 2 Name sysLocalToBusAdrs convert a local address to a bus address Synopsis STATUS sysLocalToBusAdrs int adrsSpace bus address space in which busAdrs resides char localAdrs local address to convert char pBusAdrs where to return bus address Description This routine gets the VMEbus address that accesses a specified local memory address Returns OK or ERROR if the mapping is not possible See Also sysLib sysBusToLocalAdrs 58 Programmers Reference Manual ELTEC sysMailboxConnect 2 VxWorks Reference Manual sysMailboxConnect 2 sysMailboxConnect 2 Name Synopsis Description Returns See Also ELTEC sysMailboxConnect connect a routine to the mailbox interrupt STATUS sysMai2. gt E y elektronik mainz VxWorks BSP Manual for EUROCOM 27 Revision 1 A Revision History VxWorks Rev Changes Date 1A First Edition valid for VxWorks 5 2 23 10 95 F G DISCLAIMER The information in this document has been carefully checked and is believed to be entirely reliable However no responsibility is assumed for inaccuracies ELTEC reserves the right to make changes to any products to improve reliability function or design ELTEC does not assume any liability arising out of the application or use of any product or circuit described in this manual neither does it convey any license under its patent rights nor the rights of others ELTEC products are not authorized for use as components in life support devices or systems intended for surgical implant into the body or intended to support or sustain life Buyer agrees to notify ELTEC of any such intended end use whereupon ELTEC shall determine availability and suitability of its product or products for the use intended ELTEC points out that there is no legal obligation to document internal relationships between any functional modules realized in either hardware or software of a delivered entity This document contains copyrighted information All rights including those of translation reprint broadcasting photomechanical or similar reproduction and storage or processing in computer systems in whole or in part are reserved
3. fbFlush 2 fbFlush 2 Name Synopsis Description Returns See Also 24 VxWorks Reference Manual fbFlush 2 fbFlush sets the entire screen to the specified color VOID fbFlush CON_ DEV dev device descriptor char color color This routine sets the entire screen to the specified color N A fbLib Programmers Reference Manual ELTEC fbInitConsole 2 fbInitConsole 2 Name Synopsis Description Returns See Also ELTEC VxWorks Reference Manual fbInitConsole 2 fbInitConsole initialize the frame buffer for use with the VxWorks console STATUS fbInitConsole CON_DEV dev device descriptor int baseAdrs base address of frame buffer int height height of screen int width width of screen This routine initializes the frame buffer console library OK or ERROR if unable to initialize the frame buffer fbLib Programmers Reference Manual 25 VxWorks Reference Manual fbSetColor 2 fbSetColor 2 fbSetColor 2 Name fbSetColor sets the foreground and background colors Synopsis VOID fbSetColor CON_ DEV dev device descriptor char bgColor background color char fgColor foreground color Description This routine sets the foreground and background colors for the display Returns N A See Also fbLib ELTEC Programmers Reference Manual 26 ilattach 2 ilattach 2 Name Synopsis Description Returns See
4. EUROCOM is a trademark of ELTEC Elektronik AG Other brands and their products are trademarks of their respective holders and should be noted as such O 1995 ELTEC Elektronik AG Mainz fn ELTEC Elektronik AG Galileo Galilei Str 11 Postfach 421363 D 55129 Mainz D 55071 Mainz Telephone 49 6131 918 0 Telefax 49 6131 918 199 lt a VxWorks Table of Contents Table of Contents Page eteco Dis A A AAA nde AA bt date 1 Tinttoducti Oni ri A A Aa taa Sa ees 1 BOOt ROMS io ste A O A AAA A AA A E Rte Me 1 JuMpPETS sie es ra A A A A A A AAA 1 SO bob E E nrate E pad td Ra alone he ae enable Brera T E dl ala Sas 2 DEVICES Pre ee une a ten ng tee ANS A M ne Ve 2 De Re A Rs EE PR NASA 3 Special Considerations ea Toine bs nd Ae RS da at nd ee ne en ja 4 Board Layout sanguine nent nee dans ane a rene mt ne ride iz 5 SyS LIBU A irte e a dan dattes MS Dal US aan Mie tends dedi Ds 6 O SAR TS Gad 10 ner 2OLAD D PRE UN e 14 YEMA CDS A o AO Sr Re RME 17 EDTA DOU a a PE E PEE E ad gor ee A moe Se ee Bk ee A er c 18 ed2400CoDevGreate 2 ss ntm annee ai as a are A ea lens ae nue 19 Cd2400CODIV O A tee ee aes Se aces tet Shadow ae O nes he is 20 eltecConDevCreate 2 ifs pain mat ae woe Wha ee ed ee Le ae ie A 21 AE AN ates ove Las ota a Lane ea thane MEGA se hee ew oes Ow nee ee wee ow ee AS 22 PHD isplay 2 veto A A ne Bd hed a thal hee 23 FORTUS ne ts in RARA TAI st AONA Bite AAA NS aE Sts 24 DICE oler sete Esch aes
5. Synopsis NCR_720_SCSI_CTRL ncr720CtrlCreate UINT8 baseAdrs base address of the SIOP UINT freqValue clock controller 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 calling this routine at least one call to ncr720Ctrllnit should be performed 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 determine the 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 ncr720Lib 28 Programmers Reference Manual ELTEC ncr720CtrlInit 2 VxWorks Reference Manual ncr720CtrlInit 2 ncr720CtrlInit 2 Name ncr720CtrlInit initialize a control structure for the SIOP Synopsis STATUS ncr720CtrlInit NCR_720_SCSI_CTRL pSiop ptr to SIOP struct int scsiCtrlBusId SCSI bus ID of this SIOP int scsiPriority
6. priority of a task when doing SCSI I O Description This routine initializes an SIOP structure after the structure is created with ncr720CtrICreate 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 routine 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 conventional 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 O to 255 Alternately a 1 indicates that the priority should not be altered during SCSI transactions Returns OK or ERROR if parameters are out of range See Also ncr720Lib ELTEC Programmers Reference Manual 29 ncr720SetHwRegister 2 VxWorks Reference Manual ncr720SetHwRegister 2 ncr720SetHwRegister 2 Name ncr720SetHwRegister set hardware dependent registers Synopsis STATUS ncr720SetHwRegister SIOP pSiop Pointer to SIOP infos NCR720_HW_REGS pHwRegs Point
7. 27 Starred settings indicate the factory default and are appropriate for use with VxWorks Programmers Reference Manual 1 eltec27 T Switches VxWorks Reference Manual eltec27 T Jumper Description 31201 Digclk inversion 1 2 not inverted 2 3 inverted 31202 TTL Video Outputs open when disabled closed when enabled 31401 Watchdog period closed when 100 ms open when 1 6 seconds J1601 Flash programming voltage open when not present closed when present J1605 Pin1 connection for EPROM 1 2 when 5 volts 2 3 when A19 J1702 EEPROM write enable closed when disabled open when enabled J1801 Snooping of secondary computer 1 2 ignore 2 3 observe J1703 VMEbus Interrupts for secondary CPU The EUROCOM 27 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 0xE0000000 0xE000 D 0xD0000000 0xD000 2 0x20000000 0x2000 1 0x10000000 0x1000 0 RMon defined RMon defined A24 addressing is always disabled by using the RMon defaults Programmers Reference Manual ELTEC eltec27 T ELTEC Devices VxWorks Reference Manual eltec27 T VxWorks can inherit the addressing assignments set up by RMon if desired When VxWorks is built
8. 3 For instance to create the device tyCo 0 with buffer sizes of 512 bytes the proper call would be tyCoDevCreate tyCo 0 0 512 512 OK or ERROR if the driver is not installed the channel is invalid or the device already exists tyCoDrv tyCoDrv Programmers Reference Manual ELTEC tyCoDrv 2 tyCoDrv 2 ELTEC Name Synopsis Description Returns See Also VxWorks Reference Manual tyCoDrv 2 tyCoDrv initialize the tty driver STATUS tyCoDrv void This routine initializes the tty driver for the ELTEC EUROCOM 27 It sets up the serial devices and the graphics keyboard device The graphics keyboard device may optionally be omitted from the VxWorks kernel by undefining the INCLUDE_GRAPHICS_KEYBOARD This routine will initialize the driver and the hardware for the serial ports and the graphics keyboard device This routine should be called exactly once before any reads writes or calls to tyCoDevCreate Normally it is called by usrRoot in usrConfig c OK or ERROR if the driver cannot be installed tyCoDrv tyCoDevCreate Programmers Reference Manual 77
9. Also ELTEC VxWorks Reference Manual ilattach 2 ilattach publish the interface and initialize the driver and device 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 The routine publishes the il interface by filling in a network interface record and adding this record to the system 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 OK or ERROR if_il Programmers Reference Manual 27 ncr720CtrlCreate 2 VxWorks Reference Manual ncr720CtrlCreate 2 ncr720CtrlCreate 2 Name ncr 20CtrlCreate create a control structure for the SIOP
10. Also ELTEC sysFrontPanelSwitch read the front panel switches int sysFrontPanelSwitch int swNum switch number to read This routine returns the value of the specified front panel switch Value that switch is set to sysLib Programmers Reference Manual 53 sysHwInit 2 sysHwInit 2 Name Synopsis Description Note Returns See Also 54 VxWorks Reference Manual sysHwInit 2 sysHwInit initialize the CPU board hardware void sysHwInit void This routine initializes various features of the CPU board hardware It is called from usrInit in usrConfig c This routine should not be called by the user N A sysLib Programmers Reference Manual ELTEC sysIlaccIntEnable 2 VxWorks Reference Manual sysIlaccIntEnable 2 sysIlaccIntEnable 2 Name _ sysllaccIntEnable enable the ILACC interrupt level Synopsis int sysIlaccIntEnable int level interrupt level not used Description This routine enables 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 vector Returns OK See Also sysLib ELTEC Programmers Reference Manual 55 sysIntDisable 2 sysIntDisable 2 Name Synopsis Description Returns See Also 56 VxWorks Reference Manual sysIntDisable 2 sysIntDisable disable a bus interrupt level STATUS sysIntDisable int intLevel interrupt level to disable 1 7
11. STATUS sysToMonitor int startType STATUS sysLocalToBusAdrs int adrsSpace char STATUS sysBusToLocalAdrs int adrsSpace char int sysProcNumGet void void sysProcNumSet int procNum BOOL sysBusTas char adrs STATUS sysSysfailConnect VOIDFUNCPTR routine STATUS sysAcfailConnect VOIDFUNCPTR routine int sysIlaccIntEnable int level localAdrs char pBusAdrs busAdrs char pLocalAdrs int arg int arg Programmers Reference Manual ELTEC sysLib 1 ELTEC Description Include Files See Also VxWorks Reference Manual sysLib 1 This library provides board specific routines The chip drivers included are e eltecSerial c Cirrus CD2400 serial device module library e mk48TxxClock c MK48Txx time keeper clock module library e nvRam c nonvolatile RAM library e vic064Vme c Cypress VIC068 VMEbus interface controller library e z8536Timer c Zilog 8536 Counter Timer device library sysLib h Programmer s Guide Configuration Programmers Reference Manual 9 if_il 1 if_ 10 il 1 Name Synopsis Description General Information Board Layout External Interface Target Specific Parameters VxWorks Reference Manual if_il 1 if_il AMD 79900 ILACC Ethernet network interface driver ilattach publish the interface and initialize the driver and device STATUS ilattach int unit char devAdrs int ivec int ilevel char memAdrs ULONG memSize int memWidth int spare int spar
12. board serial port Synopsis STATUS cd2400CoDevCreate 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 associated with it by calling this routine For instance to create the device 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 ELTEC Programmers Reference Manual 19 cd2400CoDrv 2 cd2400CoDrv 2 Name Synopsis Description Returns See Also 20 VxWorks Reference Manual cd2400CoDrv 2 cd2400CoDrv tty driver initialization routine STATUS cd2400CoDrv void This routine initializes the serial driver sets up interrupt vectors and performs hardware initialization of the serial ports This routine should be called exactly once before any reads writes or calls to tyCoDevCreate Normally it is called by usrRoot in usrConfig c OK or ERROR if the driver cannot be installed tyCoDrv Programmers Reference Manual ELTEC eltecConDevCreate 2 VxWorks Reference Manual eltecConDevCreate 2 eltecConDevCreate 2 Name eltecConDevCreate create a device for the keyboard and graph
13. int startType parameter passed to ROM to tell it how to boot This routine transfers control to the ROM monitor Normally it is called only by reboot which services X and bus errors at interrupt level However in some circumstances the user may wish to introduce a lt startType gt to enable special boot ROM facilities Does not return sysLib Programmers Reference Manual 71 sys VicBIkAdj 2 sys VicBIkAdj 2 Name Synopsis Description Returns See Also 72 VxWorks Reference Manual sysVicBlkAdj 2 sysVicBIkAdjO adjust burst length and interleave period for DMA transfers STATUS sysVicBlkAdj int burstLength burst length of DMA block transfer 1 64 int interleave interleave period between bursts 1 15 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 cycle interleave period between block transfers The interleave time is equal to 250 ns times lt interleave gt OK or ERROR if parameters are out of range sysLib sys VicBlkEnable sys VicBIkCopy Programmers Reference Manual ELTEC sysVicBIkCopy 2 sys VicBIkCopy 2 ELTEC Name Synopsis Description Returns See Also VxWorks Reference Manual sysVicBIkCopy 2 sys VicBIkCopy copy blocks over the VMEbus using the VIC s DMA feature STATUS sysVicB
14. the console port can be selected via the setting of switch 2 The NCR53C520 SCSI library supports SCSI wide and SCSI fast however these 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 sysScsiMode for additional information The EUROCOM 27 has a watchdog function that when enabled must be triggered at a minimum of the frequency selected by the J1401 setting 100 ms or 1 6 seconds The INCLUDE_WDOG definition within config h enables this feature The VIC064 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 sysVicBIkCopy for additional information on block copies The MK48Txx time keeper module on the EUROCOM 27 can be used to provide system time for VxWorks If the definition INCLUDE_MK48TIME is defined in the config h file the time keeper functions are included The ANSI time support also needs to be included within the VxWorks kernel which is the default The definition INCLUDE_ANSI TIME controls the inclusion of the ANSI time Programmers Reference Manual ELTEC eltec27 T ELTEC Board Layout See Also VxWorks Reference Manual eltec27 T functions When the time keeper functions are included and the DOS file system is also included the DOS files are
15. with the USE_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 within config h and the processor number Switch number 2 is used to select the start up mode that is used by RMon For automatic transfer to the VxWorks programmed in the user EPROM this switch must be set to positions 8 F All other positions will not perform an automatic start of VxWorks When the VxWorks kernel is built to include support for the selection of console port by switch the switch specifies the port to use for the VxWorks console as follows Position VxWorks_Device 8 tyCo 0 9 tyCo 1 A tyCo 2 B AyCo 3 C tyCo 4 To enable this operation the SELECT_CONSOLE_SWITCH must be defined within the config h file Switch S3 on the front panel is used to select VME system controller functions When the EUROCOM 27 is placed in slot 1 of the VME chassis the system controller option should be selected When another processor is placed in slot 1 then that processor will usually fulfil the system controller function and the S3 should not select the system controller function The eltecSerial c Cirrus Logic CD2401 try driver is provided for the four on board serial ports see the manual entry for tyCoDrv The eltecConsole c driver provides support for the graphics keyboard interface The console driver will inherit the charact
16. A AAA AAA RT 45 SYSCIKINT 2 a a E Date A A A as AO ee 46 Sy CIKRateGE trat rd E en D see tie ea iaa 47 SYSCIKR ate SEIZ trans its dd ip db bi 48 SVSCIOCK GED ae anda a rare auth oe sas Id A uns Ses Re AN alle 49 SYSCIOCKPrint 2 ay a EAS PES a SETS SO SE ee Se 50 S SCIOCKSet Q ree E AO NO fa She 51 sysClockStop 2 ise v0 25 lene a rd AAA dad in 52 sysFrontPatielS Witch iii A alla une alu 53 SS WI a A A dee A A Ba eda ee ee Ae es 54 sysllaccIntEnable vid A acted ea oe iy ea ot Ga asta at ok Wyn 55 SYSIRED1SADI 2 M a alee Ghetto Gin ee aia MEAs biden dan Maasai DO ees 56 SysInthnable 2 PR aro aah aves 57 SYSLOCALTOBUSAGES st ais AS AIN RCL eg RM STAR hcg Meg ER D dla RA 58 sys Mailbox COEL ui na mnt Roger a E a heed WAC a 59 sysMallboxEnabl ita nude Golesi ada ts A AS A ones 60 Sy MEM OP AA A n on sat ang heli dr Pa en sd 61 SYSMOdel 2 A E NR AS 62 SyYSNvRamGet 2 A A A a la 63 INR da A i Ses 64 SYSPrOCNUMGEL 2 iii A OO Pee Po E EA EAEE EAE ee Ree 65 SYSPLOCNUMS CUD 3 a rare rte A A adi g tue tla ste ace ita alana tens 66 SNS ESTILISTAS ahd oan ae Det Gee teed A 67 SYSOCSIMOdE D ia A actives E tee te Waban ed A cack 68 SVSSCUL COD A O RN 69 SysSystailConnect 2 2s fared ete biens dat lanterne pides des ee fe Rose 70 SYSTOMONMITOr 2 2584 ahd eet donna RA A RGR AR en a A in 71 SYS VICBILA DL a a A AR SE ee AAA dt nant 72 SYS VICBIK Opy 2 Wise ace e dt Toke een co tate te ace Me 73 SYS ViCBIKEnabl 2 viii A bela A Wea we eg
17. ARES wa aS 74 SVS VACSNOW 2 aii id ne mutant Ai di ne naaa dista 75 YCOD vCredte 2 Ris ra a id Shas Ss neg ME ee BaP es 76 COMIDA A A Lat E hike MeN a held ashe tes eho NS San Meh Ad A oes nea Lies ab hie 77 Technical Action Request Form Sheet Reader Comments Form Sheet Il Programmers Reference Manual ELTEC VxWorks Conventions ELTEC Conventions If not otherwise specified addresses are written in hexadecimal notation and identified by a leading dollar sign Signal names preceded by a slash indicate that this signal is either active low or that this signal becomes active with the trailing edge bit byte kilo means the factor 400 in hex 1024 decimal mega the multiplication with 100 000 in hex 1 048576 decimal MHz 1 000 000 Hertz A Programmers Reference Manual III VxWorks IV Programmers Reference Manual ELTEC eltec27 T eltec27 T ELTEC Name Introduction Boot ROMs A Jumpers VxWorks Reference Manual eltec27 T ELTEC EUROCOM 27 The following provides board specific information necessary 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 RS232 connection The EUROCOM 27 uses a flash EPROM for the resident monitor program RMon which is always resident on the EUROCOM 27 The RMon performs various initialization functions on
18. IkEnable Programmers Reference Manual 43 sysCIkDisable 2 sysCIKDisable 2 Name Synopsis Description Returns See Also 44 VxWorks Reference Manual sysCIkDisable 2 sysCIkDisable turn off system clock interrupts void sysClkDisable void This routine disables system clock interrupts N A sysLib sysCIkEnable Programmers Reference Manual ELTEC sysClkEnable 2 VxWorks Reference Manual sysClkEnable 2 sysCIkEnable 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 sysClkDisableQ sysCIKRateSet ELTEC Programmers Reference Manual 45 sysCIkInt 2 sysCIkInt 2 Name Synopsis Description See Also 46 VxWorks Reference Manual sysCIkInt 2 sysCIkInt handle a system clock interrupt void sysClkInt void This routine handles a system clock interrupt It acknowledges the interrupt and calls the routine installed by sysClkConnect sysLib Programmers Reference Manual ELTEC sysClkRateGet 2 sysClkRateGet 2 Name Synopsis Description Returns See Also ELTEC VxWorks Reference Manual sysClkRateGet 2 sysClkRateGet get the system clock rate int sysClkRateGet void This routine returns the interrupt rate of the system clock The number of ticks per second of the system clock sysLib sysCIkEnable sysClkRateSet Pr
19. N vRamGet 2 sysNvRamSet 2 sysProcNumGet 2 sysProcNumSet 2 sysScsilnit 2 sysScsiMode 2 sysSetLed 2 sysSysfailConnect 2 sysToMonitor 2 sysVicBIkAdj 2 sys VicBIkCopy 2 sysVicBIkEnable 2 sysVicShow 2 tyCoDevCreate 2 tyCoDrv 1 tyCoDrv 2 Programmers Reference Manual ncr720Lib 1 stops the nonvolatile clock read the front panel switches initialize the CPU board hardware enable the ILACC interrupt level disable a bus interrupt level enable a bus interrupt level ELTEC EUROCOM 27 library convert a local address to a bus address connect a routine to the mailbox interrupt enable the mailbox interrupt get the address of the top of memory return the model name of the CPU board get the contents of nonvolatile RAM write to nonvolatile RAM get the processor number set the processor number initialize NCR720 SCSI chip change the SCSI mode for a target set value in LED connect a routine to the SYSFAIL signal transfer control to the ROM monitor adjust burst length and interleave period for DMA transfers copy blocks over the VMEbus using the VIC s DMA feature initialize the DMA copy operation for the VICO64 displays the contents of the VIC064 registers create a device for an on board serial port ELTEC EUROCOM 27 tty driver initialize the tty driver system dependent ELTEC tyCoDrv 1 tyCoDrv 1 Name Synopsis Description User callable Rout
20. Sere ae eset PT a cee ip a dt de a Do 25 fbSetColor 2 sss wives TE TEETE EL a aa ale sales bale 26 HAE EACH CD E asst A A aan eee AA viele blue A eaters dle a 21 NCT72OC TIC re ate 2 tica sa es a ad il Dada Dada cad Dada dira hacks Baca Saas 28 ner 2OC ELITE is teks a ek e peto ds bist ce dd De e eal oh 29 ner720setHwResister 2 ita a ed Shiekh Niet a EA let Re a Lede ie ay 30 Net ZOSHOW OQ sn ae hee eer adore Teh ideas E E dd ee Reeder ea ae ete a 31 sysAcfatlConnect 2 sae wists ads suse hal en A amas AUR ia 32 SySAUXCIKCONNECI 2 ing oe dR annee See Aa Pe eR Re ER I Re LA Ac me wes 33 sys AUXCAED1S abla ea ta sla belo A Lian Wg a ee it eS a 34 sysAUXC KEnabl Q ta ote nea thas ies chee dine cde eee Re E ida GP eee a gees 35 SVSAUXCIKRATEGEE 2 d de astern aaa cari des 36 SYSAUXCIKRATE STD LE a Pr ee ARA DA SA A lec a aes Se dct eRe cd tee feds 37 SYSBSPREV Q EEE ce A dont Sai tate Mek zeit A tha a ds N ete Le el 38 SYSBUSINCA CKD steeds a trang Galen at tla CNN ace etal Uae og ale oie sae 39 SYSBusIntGen 2 id Se oh dla eee aie ie gan H shew eee da eae Ge ee mle eS RS SE 40 SVSBUS TAS A pme Ma ele dh etats rente Cents eee dt ta neo ie ete Sitar ican 41 sysBusToLocalAdrs 2 A A SEAS DES Sees Lis ne 42 S SCIKConneCt Q ta eue ME tree M ne ee dl ie NE 43 SYSCIKDISADIE 2 ivi A as he ee ae eae are ee oo on De et bd ebb 44 ELTEC Programmers Reference Manual I Table of Contents Continued VxWorks Page SYSCIKENA DIE Di Lats a AA AE
21. ating mode of an SCSI target from narrow to wide or asynchronous to synchronous This facility should be located in the scsiLib eventually OK or ERROR if the mode change could not be accomplished sysLib Programmers Reference Manual ELTEC sysSetLed 2 sysSetLed 2 Name Synopsis Description Returns See Also ELTEC VxWorks Reference Manual sysSetLed 2 sysSetLed set value in LED int sysSetLed int hexVal value to display in LED display This routine sets a value into the hex display If the value to display is negative the display will be blanked OK sysLib Programmers Reference Manual 69 sysSysfailConnect 2 sysSysfailConnect 2 Name Synopsis Description Returns See Also 70 VxWorks Reference Manual sysSysfailConnect 2 sysSysfailConnect connect a routine to the SYSFAIL signal STATUS sysSysfailConnect VOIDFUNCPTR routine routine to be connected to SYSFAIL signal int arg argument with which to call routine This routine connects a specified routine to the board s SYSFAIL signal OK or ERROR if the routine cannot be connected to the interrupt sysLib intConnect Programmers Reference Manual ELTEC sysToMonitor 2 sysToMonitor 2 Name Synopsis Description Returns See Also ELTEC VxWorks Reference Manual sysToMonitor 2 sysToMonitor transfer control to the ROM monitor STATUS sysToMonitor
22. e2 This module implements the AMD 79900 ILACC Ethernet network interface driver This driver is designed to achieve a moderate level of genericism across the range of architectures and targets that VxWorks 5 1 supports This allows the driver to be run unmodified on a variety of target hardware To achieve this goal the driver must be given several target specific parameters and some external support routines must be provided These parameters and the mechanisms used to communicate them to the driver are detailed below If any of the assumptions mentioned below are not true for your particular hardware this driver will probably not function correctly This driver supports only one ILACC unit per CPU The driver can be configured to support big endian or little endian architectures This device is on board No jumpering diagram required This driver provides the standard external interface with the following exceptions All initialization is performed within the attach routine and there is no separate init routine Therefore in the global interface structure the function pointer to the init routine is NULL There is one user callable routine ilattach See the manual entry for this routine for usage details e bus mode This parameter is globally accessed The ILACC control register 3 determines the bus mode of the device This allows the support of big endian and little endian architectures This parameter defined as
23. er 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 line ifLib Programmers Reference Manual 13 ncr720Lib 1 ncr720Lib 1 Name Synopsis Description User Callable Routines Include Files See Also 14 VxWorks Reference Manual ncr720Lib 1 ner720Lib NCR53C720 SCSI I O Processor SIOP library ncr720CtrlCreate create a control structure for the SIOP ncr720Ctrlnit initialize a control structure for the SIOP ncr720SetHwRegister set hardware dependent registers ncr720Show display values of all readable ncr720 SIOP registers NCR_720_SCSI_CTRL ncr720CtrlCreate UINT8 baseAdrs UINT freqValue STATUS ncr720CtrlInit NCR_720_SCSI_CTRL pSiop int scsiCtrlBusld int scsiPriority STATUS ncr720SetHwRegister SIOP pSiop NCR720_HW_REGS pHwRegs STATUS ncr720Show SCSI_CTRL pScsiCtrl This is the I O driver for the NCR53C720 SCSI I O Processor SIOP It is designed to work in conjunction with scsiLib This driver runs in conjunction with a script program for the NCR53C720 chip The script uses the NCR53C720 DMA function for data transfers This driver supports cache functions through cacheLib Most of the routines in this driver are accessible only through the I O system Three routines however must be called directly ncr720CtrlCreate to create a controller structure and ncr720Ct
24. er 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 routine is called by the sysScsilnit routine from the bsp The input parameters are the pointer returned by ncr720CtrlCreate and a pointer to a NCR720_HW_REGS structure that is filled with the logical values 0 or 1 for each bit of each register describe below This routine includes only the bit registers that could modify the behavior of the chip The default configuration used during ncr720CtirCreate and ner720CrtlInit 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 ctest0Bit7 Disable enable burst cache capability int ctest0Bit6 Snoop control bit1 int ctestO0Bit5 Snoop control bitO int ctest0Bitl invert ttl pin sync bus host mode only int ctest2Bit5 enable differential scsi bus capability int ctest3Bit0 Set snoop pins mode int dmodeBit7 Burst Length transfer bit 1 int dmodeBit6 Burst Length transfer bit 0 int dmodeBit5 Function code bit FC2 int dmodeBit4 Function code bit FC1 int dmodeBit3 Program data bit FCO int dmodeBit1 user programmable transfer type int dent1Bit5 Enable Ack pin int dcntlBitl Enable fast arbitration on host port NCR720_HW_REGS To get a more detailed explanation regarding the descri
25. eristics of the monitor as specified within the RMon monitor program This includes the screen dimensions and background foreground colors When the graphics keyboard support is selected when the VxWorks kernel is built the graphics keyboard will be accessed as tyCo 0 and the serial ports will be accessed as tyCo 1 through tyCo 4 The INCLUDE_GRAPHICS_KEYBOARD is defined within the eltec27 h file to include the support for the console driver Programmers Reference Manual 3 eltec27 T Special Considerations VxWorks Reference Manual eltec27 T The chip drivers included are e mk48TxxClock c MK48Txx time keeper e nvRam c nonvolatile RAM e vic064Vme c Cypress VIC064 VME interface e z8536Timer c Zilog Counter Timer Parallel I O CIO timer 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 NCR53C720 SCSI Input Output Processor SIOP is provided The INCLUDE_SCSI directive must be enabled in config h 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 can be via any of the serial ports or the graphics keyboard interface Selection of the console port is made through the VxWorks kernel build process When enabled
26. g sysLib Programmers Reference Manual ELTEC sysBusIntAck 2 sysBusIntA ck 2 Name Synopsis Description Returns See Also ELTEC VxWorks Reference Manual sysBusIntAck 2 sysBusIntAck acknowledge a bus interrupt int sysBusIntAck int intLevel interrupt level to acknowledge This routine acknowledges a specified VMEbus interrupt level The VIC064 performs this function automatically NULL Performed by hardware sysLib sysBusIntGen Programmers Reference Manual 39 sysBusIntGen 2 sysBusIntGen 2 Name Synopsis Description Returns See Also 40 VxWorks Reference Manual sysBusIntGen 2 sysBusIntGen generate a bus interrupt STATUS sysBusIntGen int level VMEbus interrupt level to generate 1 7 int vector interrupt vector to generate 0 255 This routine generates a bus interrupt for a specified level with a specified vector 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 sysLib sysBusIntAck Programmers Reference Manual ELTEC sysBusTas 2 sysBusTas 2 Name Synopsis Description Returns See Also ELTEC VxWorks Reference Manual sysBusTas 2 sysBusTas test and set a location across the bus BOOL sysBusTas char adrs address to be tested and set This routine performs a 680x0 test and set instruction acr
27. ics ports Synopsis STATUS eltecConDevCreate char name Name to use for this device int rdBufSize Read buffer size in bytes int wrtBufSize Write buffer size in bytes int fbBaseAdrs base address of frame buffer UINT16 width width of screen UINT16 height height of screen UINT8 fgColor background color UINT8 bgColor foreground color Description This routine creates a device for keyboard and graphics ports Returns OK or ERROR if no driver or already exists See Also tyCoDrv ELTEC Programmers Reference Manual 21 eltecConDrv 2 eltecConDrv 2 Name Synopsis Description Returns See Also 22 VxWorks Reference Manual eltecConDrv 2 eltecConDrv console driver initialization routine STATUS eltecConDrv void This routine initializes the console driver sets up interrupt vectors and performs hardware initialization of the keyboard and display OK or ERROR if unable to install driver tyCoDrv Programmers Reference Manual ELTEC fbDisplay 2 fbDisplay 2 Name Synopsis Description Returns See Also ELTEC VxWorks Reference Manual fbDisplay 2 fbDisplay display characters to the frame buffer VOID fbDisplay CON_DEV dev device descriptor char outChar character to display This routine converts the requested characters to the required pixels within the frame buffer N A fbLib Programmers Reference Manual 23
28. ine during the execution of a SCSI command the result will be unpredictable 0xa5 Scntl2 0x00 Sdid 0x00 Ssid 0x00 Sstatl 0x00000000 0x00 0x00 Ctest2 0x00000000 0x00 Ctest5 0x50000000 0x00066144 0x00066144 0x00066174 0x00 Scratch2 0x21 Dwt 0x000cc2b8 0x00 Sistl 0x00 Macntl 0x00 Stest2 0x0000 0x0000 0x0000 0x00000000 0x00 0x00 0x00 0x00 0x21 0x00 0x00 0x00 0x00 0x00 0x00 Scntll Sxfer Socl SstatO Ctestl Ctest4 Scratchl Dien Sienl Swide Stimel Stestl ncr720Lib ncr720CtrlCreate 0x00 0x80 0x00 0x00 Ox 0 0x00 0x00 0x37 0x00 0x00 0x00 0x00 Scnt10 Scid Sfbr Dstat Ctest0 Dfifo ScratchO Dmode Sien0 Slpar Stime0 StestO 0x04 0x80 0x00 0x80 0x00 0x00 0x0a 0x01 0x00 0x00 0x00 0x00 OK or ERROR if lt pScsiCtrl gt and lt pSysScsiCtrl gt are both NULL Programmers Reference Manual 31 sysA cfailConnect 2 sysAcfailComnect 2 Name Synopsis Description Returns See Also 32 VxWorks Reference Manual sysAcfailConnect 2 sysAcfailConnect connect a routine to the ACFAIL signal STATUS sysAcfailConnect VOIDFUNCPTR routine routine to be connected to ACFAIL signal int arg argument with which to call routine This routine connects a specified routine to the board s ACFAIL signal OK o
29. ines ELTEC loctl Functions See Also VxWorks Reference Manual tyCoDrv 1 tyCoDrv ELTEC EUROCOM 27 tty driver cd2400CoDrv tty driver initialization routine cd2400CoDevCreate create a device for an on board serial port tyCoDrv initialize the tty driver tyCoDevCreate create a device for an on board serial port STATUS cd2400CoDrv void STATUS cd2400CoDevCreate char name int channel int rdBufSize int wrtBufSize STATUS tyCoDrv void STATUS tyCoDevCreate char name int channel int rdBufSize int wrtBufSize This is the driver for the ELTEC tty driver It provides support for the Cirrus Logic CD2400 MPCC and the graphics keyboard interfaces The graphics keyboard interface is treated as tyCo 0 and the CD2400 ports start at tyCo 1 The driver uses the CD2400 only in asynchronous mode Most of the routines in this driver are accessible 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 calling 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 This CD2401 driver respond
30. iption Returns See Also 50 VxWorks Reference Manual sysClockPrint 2 sysClockPrint prints value stored in the nonvolatile clock STATUS sysClockPrint void This routine prints the specified time as set in the nonvolatile clock OK sysLib sysClockGet Programmers Reference Manual ELTEC sysClockSet 2 sysClockSet 2 ELTEC Name Synopsis Description Returns See Also VxWorks Reference Manual sysClockSet sets the nonvolatile clock STATUS sysClockSet UINT8 UINT8 UINT8 UINT8 UINT8 UINT8 date month year hour minute second date 1 31 month 1 12 year 0 99 hours 0 23 minute 0 59 seconds 0 59 sysClockSet 2 This routine sets the clock to the specified time If the clock was stopped this function will start the clock OK sysLib sysClockGet sysClockStop Programmers Reference Manual 51 sysClockStop 2 sysClockStop 2 Name Synopsis Description Returns See Also 52 VxWorks Reference Manual sysClockStop 2 sysClockStop stops the nonvolatile clock STATUS sysClockStop void This routine stops the nonvolatile clock such that the clock battery can be conserved OK sysLib sysClockSet Programmers Reference Manual ELTEC sysFrontPanelSwitch 2 VxWorks Reference Manual sysFrontPanelSwitch 2 sysFrontPanelSwitch 2 Name Synopsis Description Returns See
31. isable 2 sysAuxClkEnable 2 sysAuxClkRateGet 2 sysAuxClkRateSet 2 sysBspRev 2 sysBusIntAck 2 sysBusIntGen 2 sysBusTas 2 sysBusToLocalAdrs 2 sysCIkConnect 2 sysCIkDisable 2 sysCIkEnable 2 sysClklnt 2 sysClkRateGet 2 sysClkRateSet 2 sysClockGet 2 sysClockPrint 2 sysClockSet 2 display values of all readable ncr720 SIOP registers connect a routine to the ACFAIL signal connect a routine to the auxiliary clock interrupt turn off auxiliary clock interrupts turn on auxiliary clock interrupts get the auxiliary clock rate set the auxiliary clock rate return the bsp version with the revision e g 1 0 lt x gt acknowledge a bus interrupt generate a bus interrupt test and set a location across the bus convert a bus address to a local address connect a routine to the system clock interrupt turn off system clock interrupts turn on system clock interrupts handle a system clock interrupt get the system clock rate set the system clock rate get the contents of the clock prints value stored in the nonvolatile clock sets the nonvolatile clock Programmers Reference Manual 15 VxWorks Reference Manual sysClockStop 2 sysFrontPanelSwitch 2 sysHwInit 2 sysilaccIntEnable 2 sysIntDisable 2 sysIntEnable 2 sysLib 1 sysLocalToBusAdrs 2 sysMailboxConnect 2 sysMailboxEnable 2 sysMemTop 2 sysModel 2 sys
32. lboxConnect FUNCPTR routine routine called at each mailbox interrupt int arg argument with which to call routine This routine specifies the interrupt service routine to be called at each mailbox interrupt OK always sysLib intConnect sysMailboxEnable Programmers Reference Manual 59 sysMailboxEnable 2 sysMailboxEnable 2 Name Synopsis Description Returns See Also 60 VxWorks Reference Manual sysMailboxEnable 2 sysMailboxEnable enable the mailbox interrupt STATUS sysMailboxEnable 2 mailboxAdrs address of mailbox ignored This routine enables the ICMS 0 mailbox on the VIC064 OK always sysLib sysMailboxConnect Programmers Reference Manual ELTEC sysMemTop 2 sysMemTop 2 Name Synopsis Description Returns See Also ELTEC VxWorks Reference Manual sysMemTop 2 sysMemTop get the address of the top of memory char sysMemTop void This routine finds the size of memory The address of the top of memory sysLib Programmers Reference Manual 61 sysModel 2 sysModel 2 Name Synopsis Description Returns See Also 62 VxWorks Reference Manual sysModel 2 sysModel return the model name of the CPU board char sysModel void This routine returns the model name of the CPU board A pointer to the string ELTEC EUROCOM 27 sysLib Programmers Reference Manual ELTEC sysN vRamGet 2 sysNvRamGet 2 Name Synop
33. lkCopy char localAddr char remoteAddr int nbytes BOOL toVme BOOL doD64 local address vme address transfer length in bytes copy local memory to vme or vice versa do D64 transfer 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 transfers lt nbytes gt bytes in the direction specified by lt toVme gt OK or ERROR if transfer was unsuccessful Unsuccessful transfers result from bus errors sysLib sysVicBlkEnable sysVicBIkAdj Programmers Reference Manual 73 sys VicBlkEnable 2 VxWorks Reference Manual sys VicBlkEnable 2 sys VicBlkEnable 2 Name sysVicBlkEnable initialize the DMA copy operation for the VIC064 Synopsis STATUS sysVicBlkEnable VOIDFUNCPTR vector interrupt vector for DMA done interrupt int level interrupt level for DMA done interrupt int burstLength burst length of DMA block transfer 1 64 int interleave interleave period between bursts 1 15 Description This routine initializes operations for DMA transfers using the VIC064 The DMA done interrupt is attached using the lt vector gt as the interrupt vector and lt level gt as the interrupt level lt burstLength gt is the number of VMEbus cycles per burst lt interleave gt is the local cycle interleave period be
34. mber for the CPU board sysLib sysProcNumSet Programmers Reference Manual 65 sysProcNumSet 2 sysProcNumSet 2 Name Synopsis Description Returns See Also 66 VxWorks Reference Manual sysProcNumSet 2 sysProcNumSet set the processor number void sysProcNumSet int procNum This routine sets the processor number for the CPU board Processor numbers should be unique on a single backplane N A sysLib sysProcNumGet Programmers Reference Manual ELTEC sysScsilnit 2 VxWorks Reference Manual sysScsilnit 2 sysScsilnit 2 Name _ sysScsilnit initialize NCR720 SCSI chip Synopsis STATUS sysScsiInit void Description This routine creates and initializes an SIOP structure enabling use of the on board SCSI port It also connects the proper interrupt service routine to the desired vector and enables the interrupt at the desired level Returns OK or ERROR if the control structure is not created or the interrupt service routine cannot be connected to the interrupt See Also sysLib ELTEC Programmers Reference Manual 67 sysScsiMode 2 sysScsiMode 2 68 Name Synopsis Description Returns See Also VxWorks Reference Manual sysScsiMode change the SCSI mode for a target STATUS sysScsiMode int mode transfer mode 0 1 narrow sync 2 wide async 3 wide sync int scid SCSI ID sysScsiMode 2 narrow async This routine changes the oper
35. ogrammers Reference Manual 47 sysClkRateSet 2 sysClkRateSet 2 Name Synopsis Description Note Returns See Also 48 VxWorks Reference Manual sysClkRateSet 2 sysClkRateSet set the system clock rate STATUS sysClkRateSet int ticksPerSecond number of clock interrupts per second 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 The valid range for the system clock is 40 to 5000 ticks per second OK or ERROR if the tick rate is invalid or the timer cannot be set sysLib sysClkEnable sysClkRateGet Programmers Reference Manual ELTEC sysClockGet 2 sysClockGet 2 Name Synopsis Description Returns See Also ELTEC VxWorks Reference Manual sysClockGet 2 sysClockGet get the contents of the clock time t sysClockGet struct tm time This routine copies the time from the time keeper device into the time structure provided as the input argument see time h The function will automatically calculate the day of the week from the time provided in the time keeper device ERROR if time keeper is not running otherwise the calendar time sysLib sysClockSet sysClockStop Programmers Reference Manual 49 sysClockPrint 2 sysClockPrint 2 Name Synopsis Descr
36. oss the backplane TRUE successful set or FALSE failure sysLib vxTas Programmers Reference Manual 41 sysBusToLocalAdrs 2 VxWorks Reference Manual sysBusToLocalAdrs 2 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 char pLocalAdrs where to return local address Description This routine gets the local address that accesses a specified VMEbus address Returns OK or ERROR if the address space is unknown or the mapping is not possible See Also sysLib sysLocalToBusAdrs 42 Programmers Reference Manual ELTEC sysCIkConnect 2 sysCIkComnect 2 Name Synopsis Description Returns See Also ELTEC VxWorks Reference Manual sysCIkConnect 2 sysCIkConnect connect a routine to the system clock interrupt STATUS sysClkConnect FUNCPTR routine routine called at each system clock interrupt int arg argument with which to call routine 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 service routine OK or ERROR if the routine cannot be connected to the interrupt sysLib intConnect usrClock sysC
37. owledge a bus interrupt generate a bus interrupt connect a routine to the mailbox interrupt enable the mailbox interrupt initialize the DMA copy operation for the VICO64 adjust burst length and interleave period for DMA transfers copy blocks over the VMEbus using the VIC s DMA feature displays the contents of the VIC064 registers connect a routine to the system clock interrupt handle a system clock interrupt turn off system clock interrupts turn on system clock interrupts get the system clock rate set the system clock rate connect a routine to the auxiliary clock interrupt turn off auxiliary clock interrupts turn on auxiliary clock interrupts get the auxiliary clock rate set the auxiliary clock rate return the model name of the CPU board return the bsp version with the revision e g 1 0 lt x gt initialize the CPU board hardware read the front panel switches set value in LED get the address of the top of memory transfer control to the ROM monitor convert a local address to a bus address convert a bus address to a local address Programmers Reference Manual ELTEC sysLib 1 ELTEC VxWorks Reference Manual sysLib 1 sysProcNumGet get the processor number sysProcNumSet set the processor number sysBusTas test and set a location across the bus sysSysfailConnect connect a routine to the SYSFAIL signal sysAcfailConnect connect a routine to the ACFAIL signal sysIlaccIntEnable enable the ILACC inte
38. ption of each register involved see the User s Manual of the NCR53C720 Note Because this routine writes to the chip registers you can t use it if there is any SCSI bus activity Returns OK or ERROR if any input parameter is NULL See Also ncr720Lib ncr720 h ncr720CtlrCreate 30 Programmers Reference Manual ELTEC ncr720Show 2 ncr720Show 2 Name Synopsis Description Note Example gt ncr720Show NCR720 Registers Oxfff47000 Sent13 0xfff47004 Gpreg 0xfff47008 Sbcl Oxfff4700c Sstat2 Oxfff47010 Dsa Oxfff47014 Istat 0xfff47018 Ctest3 Oxfff4701c Temp Oxfff47020 Ctest6 Oxfff47024 Demd Ddc 0xfff47028 Dnad Oxfff4702c Dsp 0xfff47030 Dsps 0xfff47034 Scratch3 0xfff47038 Dentl 0xfff4703c Adder Oxfff47040 Sistl Oxfff47046 Gpentl Oxfff4704a RespID Oxfff4704c Stest3 Oxfff47052 Sidl 0xfff47056 Sodl Oxfff4705a Ssbdl Oxfff4705c ScracthB value 0 0x0 See Also Returns ELTEC VxWorks Reference Manual ncr720Show 2 ner720Show Display values of all readable ncr720 SIOP registers STATUS ncr720Show SCSI_CTRL pScsiCtrl ptr to SCSI controller info 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 ncr720CtrlCreate call The only readable register during a script execution is Istat register If you use this rout
39. r ERROR if the routine cannot be connected to the interrupt sysLib intConnect Programmers Reference Manual ELTEC sysAuxClkConnect 2 VxWorks Reference Manual sysAuxClkConnect 2 sysAuxClkConnect 2 Name sysAuxClkConnect connect a routine to the auxiliary clock interrupt Synopsis STATUS sysAuxClkConnect FUNCPTR routine routine called at each aux clock interrupt int arg argument with which to call routine Description This routine specifies the interrupt service routine to be called at each auxiliary clock interrupt It also connects the clock error interrupt service routine Returns OK or ERROR if the routine cannot be connected to the interrupt See Also sysLib intConnect sysAuxClkEnable ELTEC Programmers Reference Manual 33 sysAuxClkDisable 2 sysAuxClkDisable 2 Name Synopsis Description Returns See Also 34 VxWorks Reference Manual sysAuxClkDisable 2 sysAuxClkDisable turn off auxiliary clock interrupts void sysAuxClkDisable void This routine disables auxiliary clock interrupts N A sysLib sysAuxClkEnable Programmers Reference Manual ELTEC sysAuxCIkEnable 2 VxWorks Reference Manual sysAuxClkEnable 2 sysAuxClkEnable 2 Name sysAuxClkEnable turn on auxiliary clock interrupts Synopsis void sysAuxClkEnable void Description This routine enables auxiliary clock interrupts Returns N A See Also sysLib sysAuxClkDisable ELTEC Programmers Refe
40. rence Manual 35 sysAuxClkRateGet 2 VxWorks Reference Manual sysAuxClkRateGet 2 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 36 Programmers Reference Manual ELTEC sysAuxClkRateSet 2 sysAuxClkRateSet 2 Name Synopsis Description Returns See Also ELTEC VxWorks Reference Manual sysAuxClkRateSet 2 sysAuxClkRateSet set the auxiliary clock rate STATUS sysAuxClkRateSet int ticksPerSecond number of clock interrupts per second 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 OK or ERROR sysLib sysAuxClkEnable sysAuxClkRateGet Programmers Reference Manual 37 sysBspRev 2 sysBspRev 2 Name Synopsis Description Returns See Also 38 VxWorks Reference Manual sysBspRev 2 sysBspRev return the bsp version with the revision e g 1 0 lt x gt char sysBspRev void This function returns a pointer to a bsp version with the revision e g 1 0 lt x gt BSP_REV defined in config h is concatenated to BSP_VERSION defined in bspVersion h and returned A pointer to the BSP version revision strin
41. rlInit to initialize it The NCR53C720 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 ner720 h ner720Script h scsiLib Programmer s Guide I O System Programmers Reference Manual ELTEC ncr720Lib 1 ELTEC VxWorks Reference Manual ncr720Lib 1 cd2400CoDevCreate 2 create a device for an on board serial port cd2400CoDrv 2 eltecConDevCreate 2 eltecConDrv 2 fbDisplay 2 fbFlush 2 fbInitConsole 2 fbLib 1 fbSetColor 2 if_il 1 ilattach 2 ncr720CtrlCreate 2 ncr720Ctrilnit 2 ncr720Lib 1 tty driver initialization routine create a device for the keyboard and graphics ports console driver initialization routine display characters to the frame buffer sets the entire screen to the specified color initialize the frame buffer for use with the VxWorks console Frame Buffer console library sets the foreground and background colors AMD 79900 ILACC Ethernet network interface driver publish the interface and initialize the driver and device create a control structure for the SIOP initialize a control structure for the SIOP NCR53C720 SCSI I O Processor SIOP library ncr720SetHwRegister 2 set hardware dependent registers ncr720Show 2 sysAcfailConnect 2 sysAuxClkConnect 2 sysAuxClkD
42. rrupt level time_t sysClockGet struct tm time STATUS sysClockSet UINT8 date UINT8 month UINT8 year UINT8 hour UINT8 minute UINT8 second STATUS sysClockStop void STATUS sysClockPrint void STATUS sysNvRamGet char string int strLen int offset STATUS sysNvRamSet char string int strLen int offset STATUS sysIntDisable int intLevel STATUS sysIntEnable int intLevel int sysBusIntAck int intLevel STATUS sysBusIntGen int level int vector STATUS sysMailboxConnect FUNCPTR routine int arg STATUS sysMailboxEnable char mailboxAdrs STATUS sysVicBlkEnable VOIDFUNCPTR vector int level int burstLength int interleave STATUS sysVicBlkAdj int burstLength int interleave STATUS sysVicBlkCopy char localAddr char remoteAddr int nbytes BOOL toVme BOOL doD64 intsysVicShow STATUS sysClkConnect FUNCPTR routine int arg void sysClkInt void void sysClkDisable void Programmers Reference Manual 7 sysLib 1 VxWorks Reference Manual sysLib 1 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 void int sysFrontPanelSwitch int swNum int sysSetLed int hexVal char sysMemTop void
43. s 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 ilattach 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 targets performing an access of an invalid width will cause a bus 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 targets requiring these restrictions shared memory buffer size This parameter is passed to the driver with the ilattach routine The 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 Network performance 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 a
44. s 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 In addition the character size and parity is selected using the FIOBAUDRATE ioctl The argument to the ioctl call specifies the baud rate character size and parity Bits 0 15 specify the baud rate bits 26 and 27 specify the parity 0 none 1 odd and 2 even and bits 28 31 specify the character size size of zero is use the default The graphics keyboard device responds to the same ioctl codes as a normal tty driver tyLib Programmers Reference Manual 17 fbLib 1 fbLib 1 18 Name Synopsis VxWorks Reference Manual fbLib 1 fbLib Frame Buffer console library fbInitConsole initialize the frame buffer for use with the VxWorks console fbSetColor sets the foreground and background colors fbFlush sets the entire screen to the specified color fbDisplay display characters to the frame buffer STATUS fbInitConsole CON_DEV dev int baseAdrs int height int width VOID fbSetColor CON_DEV dev char bgColor char fgColor VOID fbFlush CON_DEV dev char color VOID fbDisplay CON_DEV dev char outChar Programmers Reference Manual ELTEC cd2400CoDevCreate 2 VxWorks Reference Manual cd2400CoDevCreate 2 cd2400CoDevCreate 2 Name cd2400CoDevCreate create a device for an on
45. sis Description Returns See Also ELTEC VxWorks Reference Manual sysN vRamGet 2 sysNvRamGet get the contents of nonvolatile RAM STATUS sysNvRamGet char string where to copy nonvolatile RAM int strLen maximum number of bytes to copy int offset byte offset into nonvolatile RAM This routine copies the contents of nonvolatile memory into a specified string The string will be terminated with an EOS OK or ERROR if access is outside the nonvolatile RAM range sysLib sysNvRamSet Programmers Reference Manual 63 sySNvRamSet 2 sySNvRamSet 2 Name Synopsis Description Returns See Also 64 VxWorks Reference Manual sySNvRamSet 2 sysNvRamSet write to nonvolatile RAM STATUS sysNvRamSet char string string to be copied into nonvolatile RAM int strLen maximum number of bytes to copy int offset byte offset into nonvolatile RAM This routine copies a specified string into nonvolatile RAM OK or ERROR if access is outside the nonvolatile RAM range sysLib sysNvRamGet Programmers Reference Manual ELTEC sysProcNumGet 2 sysProcNumGet 2 Name Synopsis Description Returns See Also ELTEC VxWorks Reference Manual sysProcNumGet 2 sysProcNumGet get the processor number int sysProcNumGet void This routine returns the processor number for the CPU board which is set with sysProcNumSet The processor nu
46. ssumes 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 Programmers Reference Manual ELTEC if_il 1 External Support Requirements System Resource Usage ELTEC See Also VxWorks Reference Manual if_il 1 This driver requires one external support routine to be provided void sysllaccIntEnable int level This routine provides a target specific enable of the interrupt for the ILACC device This typically involves interrupt controller hardware either internal or external to the CPU This routine is called once from the ilattach routine The driver requires the following system resources e one mutual exclusion semaphore e one interrupt vector e 5016 bytes in code section text e 28 bytes in the initialized data section data e 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 size requested is 80 542 bytes If a memory region is provided 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 driv
47. stamped with the date and time as maintained by the MK48Txx The EUROCOM 27 does not have any jumpers that need be in set positions for operation with VxWorks Refer to the EUROCOM 27 technical manual for the locations of jumpers switches and EPROMs Programmer s Guide Getting Started Configuration RMon Monitor Program Programmers Reference Manual RMon User Manual Software Manual EUROCOM 27 Technical Manual Programmers Reference Manual 5 sysLib 1 sysLib 1 Name Synopsis VxWorks Reference Manual sysLib 1 sysLib ELTEC EUROCOM 27 system dependent library sysClockGet sysClockSet sysClockStop sysClockPrint sysN vRamGet sysNvRamSet sysIntDisable sysIntEnable sysBusIntAck sysBusIntGen sysMailboxConnect sysMailboxEnable sys VicBlkEnable sysVicBIkAdj sys VicBIkCopy sys VicShow sysClkConnect sysClkIntQ sysCIkDisable sysCIkEnable sysClkRateGet sysClkRateSet sysAuxClkConnect sysAuxClkDisable sysAuxClkEnable sysAuxClkRateGet sysAuxClkRateSet sysModel sysBspRev sysHwInit sysFrontPanelSwitch sysSetLed sysMemTop sysToMonitor sysLocalToBusAdrs sysBusToLocalAdrs get the contents of the clock sets the nonvolatile clock stops the nonvolatile clock prints value stored in the nonvolatile clock get the contents of nonvolatile RAM write to nonvolatile RAM disable a bus interrupt level enable a bus interrupt level ackn
48. terrupt sources This driver avoids all board specific knowledge of such devices During the initialization of this driver an external routine is called to perform any board specific operations required to allow the servicing of an ILACC interrupt This routine is described below This parameter is passed to the external routine e shared memory address This parameter is passed to the driver with the ilattach 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 concerns 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 particular 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 Programmers Reference Manual 11 if_il 1 12 VxWorks Reference Manual if_il 1 e shared memory size This parameter is passed to the driver with the ilattach routine This parameter can be used to explicitly 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 i
49. the board and then optionally transfers to the program resident within the user EPROM The user EPROM located at Ul602 is used to program VxWorks This EPROM must be a 32 pin device and can be from 128 KB to 1 MB 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 memory 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 The EUROCOM 27 has nonvolatile RAM thus boot parameters are preserved whenever the system is powered off To load VxWorks and for more information follow the instructions in the chapter Getting Started of the VxWorks Programmer s Guide The delivered Boot EPROM is designed for the most common board configuration For the EUROCOM 27 this corresponds to 8 MB RAM graphics SCSI and network devices on board If the board differs from this combination the standard Boot EPROM may hang up the system e g less memory or SCSI chip missing If the system hangs config h and or eltec27 h must be modified and a new Boot EPROM must be rebuilt Do not mix up different versions of Boot EPROM and BSP e g Boot EPROM Version 5 11 BSP Version 5 2 The EUROCOM 27 is factory configured for immediate operation with VxWorks The table below lists the jumpers for the EUROCOM
50. tween block transfers The interleave time is equal to 250 ns times lt interleave gt This routine is typically called by sysHwInit2 Returns OK or ERROR if the DMA parameters are not valid See Also sysLib sysVicBIKAdjO sys VicBIkCopy 74 Programmers Reference Manual ELTEC sys VicShow 2 VxWorks Reference Manual sys VicShow 2 sys VicShow 2 Name sysVicShow displays the contents of the VIC064 registers Synopsis int sysVicShow Description This routine displays the contents of the VIC064 registers Returns OK always See Also sysLib ELTEC Programmers Reference Manual 75 tyCoDevCreate 2 tyCoDevCreate 2 Name Synopsis Description Returns See Also 76 VxWorks Reference Manual tyCoDevCreate 2 tyCoDevCreate create a device for an on board serial port 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 This routine creates a device for a specified tty port Each port to be used should have exactly one device associated with it by calling this routine When the graphics keyboard device is included it is considered to be channel O and the serial ports are considered to be channels 1 through 4 When the graphics keyboard device is not included in the VxWorks kernel then the serial ports are considered to be channels 0 through
51. 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 Programmers Reference Manual ELTEC if_il 1 ELTEC VxWorks Reference Manual if_il 1 e base address of device registers This parameter is passed to the driver with the ilattach routine The ILACC presents two registers to the external interface 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 accessible 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 where to find the RDP register e interrupt vector This parameter is passed to the driver with the ilattach routine This driver configures the ILACC device to generate hardware interrupts for various events within the device 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 e interrupt level This parameter is passed to the driver with the ilattach routine Some target hardware use additional interrupt controller devices to help organize and service the various in
Download Pdf Manuals
Related Search