MPI/SynqNet FPGA Compatibility Check

The MPI verifies "forwards" and "backwards" compatibility with the FPGA images loaded on all SynqNet nodes on a network. There are two types of images checked on a per node basis: SqNode and SqMAC images.

Each node type (or module) has three values defined for both sqMAC and sqNode image types: Default, Minimum, and Maximum supported versions.

FPGA Type	FPGA SqMAC Version	FPGA SqNode Version	SynqNet State
Runtime	Version >= MIN and Version <= MAX	Version >= MIN and Version <= MAX	SYNQ
	MPIReturn Value: MPIMessageOK
Runtime	Version >= MIN and Version <= MAX	Version < MIN or Version > MAX	ASYNQ
	MPIReturn Value: MPISynqNetMessageNODE_FPGA_VERSION
Runtime	Version < MIN or Version > MAX	Version >= MIN and Version <= MAX	ASYNQ
	MPIReturn Value: MPISynqNetMessageNODE_MAC_VERSION
Runtime	Version < MIN or Version > MAX	Version >= MIN and Version <= MAX	ASYNQ
	MPIReturn Value: MPISynqNetMessageNODE_MAC_VERSION
BOOT	N/A	N/A	ASYNQ
	MPIReturn Value: MPISynqNetMessageNODE_BOOT_FPGA_VERSION

SqMAC Compatibility Check

The SqMAC logic contains the SyqnNet Medium Access Control layer for SynqNet. It is important to be running with a compatible SqMAC image for basic network operation. If your SqMAC is not compatible with the MPI, your network will probably never reach cyclic (SYNQ) mode.

A compatibility WARNING will be returned from mpiControlInit(...) and mpiSynqNetInit(...) if any node FPGA version number does not fall within the defined minimum and maximum compatibility values for that node type.

In version 03.04.xx (and later), the network initialization will be stopped and the network will remain in ASYNQ mode. In previous versions, the network initialization will continue to SYNQ mode.

SqNode Compatibility Check

The SqNode FPGA image defines the operation of the resources on the node. For example, quadrature feedback, dedicated I/O, etc. If the image is incompatible with the MPI, your network will still reach cyclic mode, but certain node resources may not operate as expected.

The default value for the SqNode FPGA image defines the version of the SynqNet node FPGA image that was built and tested with the current version of the MPI. The mpiSqNodeInfo(...) method will return a value in MPISqNodeInfo.fpga.defaultVersion to indicate if the node is running with the default version of the SqNode FPGA image. This is the recommended version to have loaded on the node, unless otherwise noted in the release note or by an MEI engineer.

The version.exe utility will also report the default version as TRUE or FALSE.