XMOS VocalFusion XVF3510 User Manual page 44

The control protocol does not support variadic (variable number of) arguments. Hence, even when
writing a single byte, the total number of arguments passed must be the maximum. Unwritten values
are ignored.
The following example writes one byte of data (with value 122) to a control register as address 6.
vfctrl_usb SET_SPI_PUSH_AND_EXEC 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
0 0 6 1 122
NOTE: All numbers are decimal. It is necessary to pad the payload to 56 bytes, which includes the
address, length and data values. This is a requirement of the VFCTRL tool, the SPI interface itself will
only transmit the valid data.
Transmitting more than 54 bytes of data is possible using the SET_SPI_PUSH command to queue up
data, using multiple commands before the push is executed. The following example writes values 0 to
69 to address 100 (70 bytes in total) using command to push 56 data values into the queue, followed
by a push the remaining 14 data words and then execute the transfer:
vfctrl_usb SET_SPI_PUSH 55 54 53 52 51 50 49 48 47 46 45 44 43 42 41 40 39 38 37 36
35
34 33 32 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 15 14 13 12 11 10 9
8 7 6 5 4 3 2 1 0
vfctrl_usb SET_SPI_PUSH_AND_EXEC
0
0 0 0 0 0 0 0 0 0 0 0 0 0 0 100 70 69 68 67 66 65 64 63 62 61 60 59 58 57 56
To read one byte at address 6, which contains the value 122, we can do the following:
vfctrl_usb SET_SPI_READ_HEADER 6 1
vfctrl_usb GET_SPI
> GET_SPI: 122 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
-> 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
To read 16 bytes from address 0, which all contain the value 33, we can do the following:
vfctrl_usb SET_SPI_READ_HEADER 0 16
vfctrl_usb GET_SPI
> GET_SPI: 33 33 33 33 33 33 33 33 33 33 33 33 33 33 33 0 0 0 0
-> 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
-> 0
XM-014232-PC
0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
44