Functions
int EXPRT	mvme_open (MVME_INTERFACE **vme, int idx)

int EXPRT	mvme_close (MVME_INTERFACE *vme)

int EXPRT	mvme_sysreset (MVME_INTERFACE *vme)

int EXPRT	mvme_read (MVME_INTERFACE vme, void dst, mvme_addr_t vme_addr, mvme_size_t n_bytes)

unsigned int EXPRT	mvme_read_value (MVME_INTERFACE *vme, mvme_addr_t vme_addr)

int EXPRT	mvme_write (MVME_INTERFACE vme, mvme_addr_t vme_addr, void src, mvme_size_t n_bytes)

int EXPRT	mvme_write_value (MVME_INTERFACE *vme, mvme_addr_t vme_addr, unsigned int value)

int EXPRT	mvme_set_am (MVME_INTERFACE *vme, int am)

int EXPRT	mvme_get_am (MVME_INTERFACE vme, int am)

int EXPRT	mvme_set_dmode (MVME_INTERFACE *vme, int dmode)

int EXPRT	mvme_get_dmode (MVME_INTERFACE vme, int dmode)

int EXPRT	mvme_set_blt (MVME_INTERFACE *vme, int mode)

int EXPRT	mvme_get_blt (MVME_INTERFACE vme, int mode)

int EXPRT	mvme_interrupt_generate (MVME_INTERFACE mvme, int level, int vector, void info)

int EXPRT	mvme_interrupt_attach (MVME_INTERFACE mvme, int level, int vector, void(isr)(int, void , void ), void *info)

int EXPRT	mvme_interrupt_detach (MVME_INTERFACE mvme, int level, int vector, void info)

int EXPRT	mvme_interrupt_enable (MVME_INTERFACE mvme, int level, int vector, void info)

int EXPRT	mvme_interrupt_disable (MVME_INTERFACE mvme, int level, int vector, void info)

Detailed Description

dox

Function Documentation

int EXPRT mvme_close ( MVME_INTERFACE * vme)

Close and release ALL the opened VME channel. See example in mvme_open()

Parameters

*vme	VME structure.

Returns: MVME_SUCCESS, MVME_ACCESS_ERROR

Definition at line 45 of file bt617.c.

References MVME_INTERFACE::handle, and MVME_SUCCESS.

 {
         close(vme->handle);
         return MVME_SUCCESS;
 }

int EXPRT mvme_get_am	(	MVME_INTERFACE *	vme,
		int *	am
	)

Get Address Modifier.

Parameters

*vme	VME structure
*am	returned address modifier

Returns: MVME_SUCCESS

Definition at line 116 of file bt617.c.

References MVME_INTERFACE::am.

 {
         *am = vme->am;
         return 0;
 }

int EXPRT mvme_get_blt	(	MVME_INTERFACE *	vme,
		int *	mode
	)

Get current Data mode.

Parameters

*vme	VME structure
*mode	returned BLT mode

Returns: MVME_SUCCESS

Definition at line 143 of file bt617.c.

References MVME_INTERFACE::blt_mode.

 {
         *mode = vme->blt_mode;
         return 0;
 }

int EXPRT mvme_get_dmode	(	MVME_INTERFACE *	vme,
		int *	dmode
	)

Get current Data mode.

Parameters

*vme	VME structure
*dmode	returned address modifier

Returns: MVME_SUCCESS

Definition at line 149 of file bt617.c.

References MVME_INTERFACE::dmode.

Referenced by v1290_AcqModeRead(), v1290_ContinuousSet(), v1290_DisableAllChannels(), v1290_EnableAllChannels(), v1290_EnableBypassTDC(), v1290_EnableChannel(), v1290_EnableHeader(), v1290_EnableTDCErrorMark(), v1290_EnableTriggerSubtraction(), v1290_Read16(), v1290_Read32(), v1290_ReadMicro(), v1290_TriggerConfRead(), v1290_TriggerMatchingSet(), v1290_Write16(), and v1290_WriteMicro().

 {
         *dm = vme->dmode;
         return 0;
 }

int EXPRT mvme_interrupt_attach	(	MVME_INTERFACE *	mvme,
		int	level,
		int	vector,
		void()(int, void , void *)	isr,
		void *	info
	)

int EXPRT mvme_interrupt_detach	(	MVME_INTERFACE *	mvme,
		int	level,
		int	vector,
		void *	info
	)

int EXPRT mvme_interrupt_disable	(	MVME_INTERFACE *	mvme,
		int	level,
		int	vector,
		void *	info
	)

int EXPRT mvme_interrupt_enable	(	MVME_INTERFACE *	mvme,
		int	level,
		int	vector,
		void *	info
	)

int EXPRT mvme_interrupt_generate	(	MVME_INTERFACE *	mvme,
		int	level,
		int	vector,
		void *	info
	)

int EXPRT mvme_open	(	MVME_INTERFACE **	vme,
		int	idx
	)

VME open

The code below summarize the use of most of the mvme calls included in this interface.

#include "vmicvme.h"  // or other VME interface driver.
int main () {
  int i, status, vmeio_status, data;
  MVME_INTERFACE *myvme;
  // Open VME channel 
  status = mvme_open(&myvme, 0);
  // Reset VME 
  // Under VMIC reboot CPU!!
  //  status = mvme_sysreset(myvme);
  // Setup AM 
  status = mvme_set_am(myvme, MVME_AM_A24_ND);
  // Setup Data size 
  status = mvme_set_dmode(myvme, MVME_DMODE_D32);
  // Read VMEIO status 
  status = mvme_read(myvme, &vmeio_status, 0x78001C, 4); 
  printf("VMEIO status : 0x%x\n", vmeio_status);
  // Write Single value 
  mvme_write_value(myvme, 0x780010, 0x3);
  // Read Single Value 
  printf("Value : 0x%x\n", mvme_read_value(myvme, 0x780018));
  // Write to the VMEIO in latch mode 
  for (i=0;i<10000;i++) {
    data = 0xF;
    status = mvme_write(myvme, 0x780010, &data, 4);
    data = 0x0;
    status = mvme_write(myvme, 0x780010, &data, 4);
  }
  // Close VME channel 
  status = mvme_close(myvme);
  return 1;
}

Parameters

**vme	user VME pointer to the interface
index	interface number should be used to distingush multiple VME interface access within the same program.

Returns: status MVME_SUCCESS, MVME_NO_INTERFACE, MVME_INVALID_PARAM, MVME_ACCESS_ERROR

Definition at line 19 of file bt617.c.

References bt617_SetAccessMode(), DEV_FILE, MVME_AM_A32_ND, MVME_BLT_NONE, MVME_DMODE_D32, MVME_NO_MEM, and MVME_SUCCESS.

Referenced by rpv130_init().

 {
         *vme = (MVME_INTERFACE *) malloc(sizeof(MVME_INTERFACE));
         if (*vme == NULL)
                 return MVME_NO_MEM;
         memset(*vme, 0, sizeof(MVME_INTERFACE));
 
         int fd;
         if ((fd = open(DEV_FILE, O_RDWR))<0)
         {
                 perror("ERROR: fd open()");
                 exit(EXIT_FAILURE);
         }
 
         (*vme)->handle = fd;
         (*vme)->am = MVME_AM_A32_ND;
         (*vme)->dmode = MVME_DMODE_D32;
         (*vme)->initialized = 1;
         bt617_SetAccessMode(*vme);
 
         (*vme)->blt_mode = MVME_BLT_NONE;
         (*vme)->table = NULL;
 
         return MVME_SUCCESS;
 }

int EXPRT mvme_read	(	MVME_INTERFACE *	vme,
		void *	dst,
		mvme_addr_t	vme_addr,
		mvme_size_t	n_bytes
	)

Read from VME bus. Implementation of the read can include automatic DMA transfer based on the size of the data. See example in mvme_open()

Parameters

*vme	VME structure
*dst	destination pointer
vme_addr	source address (VME location).
n_bytes	requested transfer size.

Returns: MVME_SUCCESS

Definition at line 155 of file bt617.c.

References MVME_INTERFACE::handle, and printf().

Referenced by mvme_read_value(), and v1290_DataRead().

 {
         int read_size;
         if(lseek(vme->handle,vme_addr,SEEK_SET) == -1)
         {
                 printf("lseek err\n");
                 return -1;
         }
         read_size = read(vme->handle,dst,n_bytes);
 
         if (read_size < 0)
         {
                 printf("read err\n");
                 return -1;
         }
         else 
                 return read_size;
 }

unsigned int EXPRT mvme_read_value	(	MVME_INTERFACE *	vme,
		mvme_addr_t	vme_addr
	)

Read single data from VME bus. Useful for register access. See example in mvme_open()

Parameters

*vme	VME structure
vme_addr	source address (VME location).

Returns: MVME_SUCCESS

Definition at line 193 of file bt617.c.

References MVME_INTERFACE::dmode, MVME_DMODE_D16, MVME_DMODE_D32, mvme_read(), and value.

Referenced by rpv130_IsBusy1(), rpv130_IsBusy2(), rpv130_IsBusy3(), v1290_MicroRead(), v1290_MicroWrite(), v1290_Read16(), and v1290_Read32().

 {
         int read_size,nbytes;
         unsigned int value;
         switch (vme->dmode)
         {
                 case MVME_DMODE_D32:
                         nbytes = 4;
                         break;
                 case MVME_DMODE_D16:
                         nbytes = 2;
                         break;
                 default:
                         nbytes = 4;
                         break;
         }
         read_size = mvme_read(vme,&value,vme_addr,nbytes);
         return value;
 }

int EXPRT mvme_set_am	(	MVME_INTERFACE *	vme,
		int	am
	)

Set Address Modifier.

Parameters

*vme	VME structure
am	address modifier

Returns: MVME_SUCCESS

Definition at line 109 of file bt617.c.

References MVME_INTERFACE::am, and bt617_SetAccessMode().

Referenced by rpv130_Clear(), rpv130_ClearBusy1(), rpv130_ClearBusy2(), rpv130_ClearBusy3(), rpv130_IsBusy1(), rpv130_IsBusy2(), rpv130_IsBusy3(), rpv130_Pulse(), v1290_DataRead(), v1290_MicroRead(), v1290_MicroWrite(), v1290_Read16(), v1290_Read32(), and v1290_Write16().

 {
         vme->am = am;
         bt617_SetAccessMode(vme);
         return 0;
 }

int EXPRT mvme_set_blt	(	MVME_INTERFACE *	vme,
		int	mode
	)

Set Block Transfer mode.

Parameters

*vme	VME structure
mode	BLT mode

Returns: MVME_SUCCESS

Definition at line 129 of file bt617.c.

References MVME_INTERFACE::blt_mode, bt617_SetBLT(), and MVME_BLT_NONE.

Referenced by v1290_DataRead().

 {
         vme->blt_mode = mode;
         if (mode == MVME_BLT_NONE)
         {
                 bt617_SetBLT(vme, false);
         }
         else
         {
                 bt617_SetBLT(vme, true);
         }
         return 0;
 }

int EXPRT mvme_set_dmode	(	MVME_INTERFACE *	vme,
		int	dmode
	)

Set Data mode.

Parameters

*vme	VME structure
dmode	Data mode

Returns: MVME_SUCCESS

Definition at line 122 of file bt617.c.

References bt617_SetAccessMode(), and MVME_INTERFACE::dmode.

Referenced by rpv130_Clear(), rpv130_ClearBusy1(), rpv130_ClearBusy2(), rpv130_ClearBusy3(), rpv130_IsBusy1(), rpv130_IsBusy2(), rpv130_IsBusy3(), rpv130_Pulse(), v1290_AcqModeRead(), v1290_ContinuousSet(), v1290_DataRead(), v1290_DisableAllChannels(), v1290_EnableAllChannels(), v1290_EnableBypassTDC(), v1290_EnableChannel(), v1290_EnableHeader(), v1290_EnableTDCErrorMark(), v1290_EnableTriggerSubtraction(), v1290_MicroRead(), v1290_MicroWrite(), v1290_Read16(), v1290_Read32(), v1290_ReadMicro(), v1290_TriggerConfRead(), v1290_TriggerMatchingSet(), v1290_Write16(), and v1290_WriteMicro().

 {
         vme->dmode = dm;
         bt617_SetAccessMode(vme);
         return 0;
 }

int EXPRT mvme_sysreset ( MVME_INTERFACE * vme)

VME bus reset. Effect of the VME bus reset is dependent of the type of VME interface used. See example in mvme_open()

Parameters

*vme	VME structure.

Returns: MVME_SUCCESS, MVME_ACCESS_ERROR

int EXPRT mvme_write	(	MVME_INTERFACE *	vme,
		mvme_addr_t	vme_addr,
		void *	src,
		mvme_size_t	n_bytes
	)

Write data to VME bus. Implementation of the write can include automatic DMA transfer based on the size of the data. See example in mvme_open()

Parameters

*vme	VME structure
vme_addr	source address (VME location).
*src	source array
n_bytes	size of the array in bytes

Returns: MVME_SUCCESS

Definition at line 175 of file bt617.c.

References MVME_INTERFACE::handle, and printf().

Referenced by mvme_write_value().

 {
         int write_size;
         if(lseek(vme->handle,vme_addr,SEEK_SET) == -1)
         {
                 printf("lseek err\n");
                 return -1;
         }
         write_size = write(vme->handle,src,n_bytes);
         if (write_size < 0)
         {
                 printf("write err\n");
                 return -1;
         }
         else 
                 return write_size;
 }

int EXPRT mvme_write_value	(	MVME_INTERFACE *	vme,
		mvme_addr_t	vme_addr,
		unsigned int	value
	)

Write single data to VME bus. Useful for register access. See example in mvme_open()

Parameters

*vme	VME structure
vme_addr	source address (VME location).
value	Value to be written to the VME bus

Returns: MVME_SUCCESS

Definition at line 213 of file bt617.c.

References MVME_INTERFACE::dmode, MVME_DMODE_D16, MVME_DMODE_D32, mvme_write(), and printf().

Referenced by rpv130_Clear(), rpv130_ClearBusy1(), rpv130_ClearBusy2(), rpv130_ClearBusy3(), rpv130_Pulse(), v1290_MicroWrite(), and v1290_Write16().

 {
         int write_size,nbytes;
         switch (vme->dmode)
         {
                 case MVME_DMODE_D32:
                         nbytes = 4;
                         break;
                 case MVME_DMODE_D16:
                         nbytes = 2;
                         break;
                 default:
                         nbytes = 4;
                         break;
         }
         write_size = mvme_write(vme,vme_addr,&value,nbytes);
         if (write_size < 0)
         {
                 printf("write_value err \n");
                 return -1;
         }
         else 
                 return 0;
 }

Functions

Detailed Description

Function Documentation