Python 3; Host Build Tools; Command-Line Interface (Vfctrl) - XMOS VocalFusion XVF3510 User Manual

3.2.2. PYTHON 3

Some operations, such as running the SPI boot example on the Raspberry Pi, require the use of Python
3 (v3.7 onward is recommended). Python can be downloaded from http://python.org/downloads.

3.2.3. HOST BUILD TOOLS

In order to build the host utilities, the use of a platform-specific compiler is required.
WINDOWS
The host utilities are built with the
Build Tools for Visual Studio.
of the
writing latest versions available here:
visual-studio-2019). It is important to ensure that the optional
included when setting up the installation.
LINUX
Depending on the distribution and version of Linux used, the following packages may need to be
installed:
sudo apt-get install -y build-essential
sudo apt-get install -y pkg-config
sudo apt-get install -y libusb-1.0-0-dev
MAC OS
The XCode Command Line tools are required to build in on macOS. The following command can be
used to install the tools.
xcode-select --install

3.3. COMMAND-LINE INTERFACE (VFCTRL)

To allow command-line access to the control interface on the XVF3510 processor, the vfctrl
( V ocal F usion c on tr o l ) utility is provided as part of the release package. This utility
Two versions of this utility are provided for control of the device (a third is used internally by the Data
Partition generation process):
Table 3-2 vfctrl versions and platforms
VERSION FUNCTION
vfctrl_usb Control of XVF3510-UA over a USB interface
vfctrl_i2c Control of XVF3510-INT over i2c interface
Source code for the utility is also provided for compilation for other host devices if required.
The general syntax of the command line tool, when used for device control, is as follows:
vfctrl_usb <COMMAND_VERB> [ arg 1] [arg 2]....[arg N] [# Comment]
The <COMMAND_VERB> is required and is used to control the parameters of the device. Commands
can be read and write commands and are distinguished by the prefix 'GET_' and 'SET_' for parameter
read and write respectively.
XM-014232-PC
x86 Native Tools Command Prompt for VS
This can be downloaded from Microsoft website (at the time of
https://visualstudio.microsoft.com/downloads/#build-tools-for-
which is installed as part
C++ CMake tools for Windows
HOST PLATFORMS SUPPORTED
Windows, MacOS, Linux, Raspbian
Raspberry Pi (Raspbian) only
are
14