DAQ OS: front end libraries

All front end libraries are licated in $CODA/src/rol/code.s directory. To compile use gmake clean, gmake and gmake install. For vxWorks use clon10/clon00 servers only (it will work on RHEL as well, but historically we do it on sparc machines).

Generic software development rules

• All vxWorks- or UNIX-specific functions must have identical names and interfaces and must be included in kernels, BSPs or separate libraries, so board-specific library will be generic. In particular following functions must be available:

sysBusToLocalAdrs(int modifier,(char *)addr,(char **)&laddr)

vxMemProbe((char *)addr,int,int,(char *)&data)

usrVmeDmaShow()
usrVmeDmaConfig(UINT32 addrType, UINT32 dataType)
usrVme2MemDmaStart(UCHAR *localVmeAddr, UCHAR *localAddr, UINT32 nbytes)
usrVme2MemDmaListSet(UINT32 *localVmeAddr, UINT32 *localAddr, int *size, int numt)
usrVmeDmaListStart()
usrVme2MemDmaDone()

val = vmeRead8(unsigned char *addr)
vmeWrite8(unsigned char *addr, unsigned char val)
val = vmeRead16(unsigned short *addr)
vmeWrite16(unsigned short *addr, unsigned short val)
val = vmeRead32(unsigned int *addr)
vmeWrite32(unsigned int *addr, unsigned int val)

• Every board has distinctive name, for example v1495 or tdc1190. That name must be used in the files name, as well as in function names and global names to avoid duplicates. At least two files must be provided, for example v1495.c and v1495.h, where header file will be used in user readout lists.

• Board initialization function must have at least three following arguments (as first arguments):

first board address (as it set by onboard switches)
address step between boards
the number of boards

It does a scan looking for all available boards and assign board IDs starting from 0. All individual board operations must be performed using that ID. It returns the number of boards found.