The xAdr register class is used for accessing digital registers and can interpret histogram names. It is used for setting up the address register of VXI cards which provides the address component of data words generated by the card.

Attributes :-

-s    VXI slot number

specifies the slot number (1-12) within the VXI crate. Manditory - no default value.

-c    channel number

specifies the hardware channel within the VXI card. Optional. By default -c 0 is assumed.
Normally channel 0 is used for the configuration and common registers positioned at the base of the card address space and channels 1 => n are used for the channel specific registers.

-a    channel base address

specifies the address offset of the channel area relative to the base address of the VXI card. This is the address offset within the card of the base of the channel 0 area. Optional. By default -a 0 is assumed.

-z    channel address size

specifies the address space allocated to each channel within the channel area of the VXI card. Optional. By default -z 256 is assumed.

-o    offset

specifies the address offset of the hardware register relative to the base of the current channel within the VXI card. Manditory - no default value.

-O    offset

specifies the address offset for READ operations of the hardware register relative to the base of the current channel within the VXI card. Optional.
By default it is assumed that the address offset of a register for WRITE and READ operations is the same. The -o attribute is taken by default to be the offset for both WRITE and READ operatation. The -O attribute (if required) specifies the READ offset and MUST be specified AFTER the -o attribute.

-w    width of VME access. Options are 8; 16; 32.

specifies the data width required for accesses to the VXI hardware register.

-p    access permission (rw, ro, wo)

specifies the data access modes permitted to the VXI hardware register. Options are ro (read only); wo (write only); rw (read-write).

-l    length of bit field

specifies the length of the data field for this register in bits.
The server code permits access to VXI hardware registers at the bit level. The hardware will always be accessed using the access width specified by the -w attribute. The server however implements in software objects which may be any subfield of a hardware register. For write access to a subfield of a hardware register it is required that the hardware be readable.
The attribute value -l 0 implies that the data field for this object is the same as the hardware access width specified by the -w attribute. Optional. By default -l 0 is assumed.

-b    bit position

specifies the position of the least significant bit of the data within the hardware register. The hardware is addressed with the least significant bit having the value 0.
This attribute will normally always be used in conjunction with the -l attribute to define the length and position of a software object which is a subfield of the hardware register. Optional. By default -b 0 is assumed.

-i    initial value

specifies the data value to be used by the INITIALISE operation. The register must also have write permission.

The read register operation returns the contents of the address register as a 4 digit hexadecimal number.
The write register operation will accept either a decimal value which is written to the hardware register or a histogram name which is converted into VXI address format (14 bits data - 8 bit detector group and 6 bit data item) before writting to the hardware register.
If the register has an initial value it must be specified in decimal or hexadecimal.

The absolute VME address of a register (relative to the card base address allocated by the Resource Manager) is given by (channel area base address) + (channel number * channel size) + (register offset).