FX3Connection Methods

Read a standard iSensors 16-bit register using a bitbang SPI connection

Perform a bit banged SPI transfer, using the config set in BitBangSpiConfig.

Write a byte to an iSensor register using a bitbang SPI connection

BOOTLOADER FW: Blink the on-board LED

BOOTLOADER FW: Turn off the LED

BOOTLOADER FW: Turn on the LED

Cancel a any running stream

Takes interface out of burst mode by setting BurstMode to zero.

Clear the error log stored in flash

Attempts to program the selected FX3 board with the application firmware. The FX3 board should be programmed with the ADI bootloader.

This function sends a reset command to the specified FX3 board, or does nothing if no board is connected

Overload of Disconnect which lets you specify the FX3 serial number to disconnect. Returns a boolean indicating if the board was disconnected.

Determines whether the specified object is equal to the current object.

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

Function which checks if the FX3 is connected and programmed

Gets one frame from the thread safe queue. Waits to return until a frame is available if there is a stream running. If there is not a stream running, and there is no data in the queue this call returns "Nothing".

This function returns a single buffered stream packet. Needed for IBufferedStreamProducer

Gets the current error log from FX3 flash memory

Get the number of errors logged to the FX3 flash memory

Serves as the default hash function.

Get I2C buffer from I2C read stream

Allows the user to retrieve a set of information about the current pin PWM configuration.

This function does the same thing as GetBufferedStreamDataPacket()

This function reads the current value from the 10MHz timer running on the FX3

Gets the Type of the current instance.

Read bytes from an I2C slave device attached to the FX3.

Write bytes to an I2C slave device attached to the FX3

ISpi32 StopStream implementation. Calls generic version.

This function checks to see if the selected pin has already been configured to act as a PWM output pin.

Overload of measure busy pulse which triggers the DUT event using a SPI write instead of a pin drive.

This function triggers a DUT action using a pulse drive, and then measures the following pulse width on a separate busy line. The pulse time on the busy pin is measured using a 10MHz timer with approx. 0.1us accuracy.

This function measures the time delay between toggling a trigger pin, and a state change on the busy pin. This can be used to measure the propagation delay between a sync edge and data ready being de-asserted.

Measures the frequency of an input signal to the selected pin.

Creates a shallow copy of the current Object.

This function drives a pin to the specified level for a given time interval in ms

This function waits for a pin to reach a specified level

This function checks the CRC of each real time streaming frame stored in the Stream Data Queue, and purges the bad ones. This operation is only valid for an ADcmXL series DUT.

Reads the measured DR value

Read data from the FX3 non-volatile memory

Reads the value of a GPIO pin on the FX3

Reads a list of FX3 GPIO pins. This function calls the overload which takes an IEnumerable

Reads a list of FX3 GPIO pins

Reads an array of 16 bit register values.

ReadRegArray overload which includes register writes. Breaks the call into multiple calls of readRegByte and writeRegByte

Overload of ReadRegArray which builds a new IEnumerable of addr and call the overload which takes an enumerable of addr

This is the most generic array register function. All other array read/write functions call down to this one.

This is the most general ReadRegByte. Other implementations are based on this.

Reads a single 16 bit register on the DUT

Not implemented

Drives the Reset pin low for 10ms, sleeps for 100ms, and then blocks until the ReadyPin is high (500ms timeout)

Looks for and resets boards in application mode. Should only be called at program start, after InitBoardList() Note: Should not be used if running multiple instances of the GUI.

Resets the hardware SPI pins to their default operating mode. Can be used to recover the SPI functionality after a bit-bang SPI transaction over the hardware SPI pins without having to reboot the FX3.

Sets the SCLK frequency for a bit bang SPI connection.

Set the SCLK frequency for a bit banged SPI connection. Overloaded to allow for a UInt

Set the bit bang SPI stall time. Driven by a clock with resolution of 49.3ns

Sets the value of a FX3 GPIO pin. This value will persist until the pin is set to a different value, or read from

Set the FX3 GPIO input stage pull up or pull down resistor setting. All FX3 GPIOs have a software configurable pull up / pull down resistor (10KOhm).

Puts interface into burst mode by setting burstMode to match word count.

This function is not currently implemented. Calling it will throw a NotImplementedException.

Starts a buffered stream operation. This is usually called from the TextFileStreamManager. DUTType must be set before executing.

Starts a buffered stream operation. The registers listed in addr are read numCaptures times per register buffer. This process is repeated numBuffers times.

Function to start a burst read using the BurstStreamManager

Starts a generic data stream. This allows you to read/write a set of registers on the DUT, triggering off the data ready if needed. The data read is placed in the thread-safe queue and can be retrieved with a call to GetBuffer. Each "buffer" is the result of reading the addr list of registers numCaptures times. For example, if addr is set to [0, 2, 4] and numCaptures is set to 10, each buffer will contain the 30 register values. The total number of register reads performed is numCaptures * numBuffers

Start an asynchronous I2C read stream. This stream runs on the stream thread and places all data in a thread safe queue. The data can be retrieved using GetI2CBuffer()

This function configures the selected pin to drive a pulse width modulated output.

This function starts real time streaming on the ADcmXLx021 (interface and FX3). Specifying pin exit is optional and must be 0 (disabled) or 1 (enabled)

Starts a buffered stream for only a single buffer. This is equivalent to StartBufferedStream(addr, numCaptures, 1, CurrentTimeout, Nothing)

This function call disables the PWM output from the FX3 and returns the pin to a tri-stated mode.

This function stops real time streaming on the ADcmXLx021 (stream thread in FX3 API and FX3 firmware)

Stops the currently running data stream, if any.

Returns a string that represents the current object.

This function performs a single bi-directional 32 bit SPI transaction. If DrActive is set to false the transfer is performed asynchronously. If DrActive is set to true, the transfer should wait until a data ready condition (determined by DrPin and DrPolarity) is true.

This function performs an array bi-directional SPI transfer. WriteData.Count() total SPI transfers are performed. If DrActive is set to true, the transfer should wait until a data ready condition (determined by DrPin and DrPolarity) is true, and then perform all SPI transfers. If DrActive is false it is performed asynchronously.

This function performs an array bi-directional SPI transfer. This overload transfers all the data in WriteData numCaptures times. The total number of SPI words transfered is WriteData.Count() * numCaptures. If DrActive is set to true, the transfer should wait until a data ready condition (determined by DrPin and DrPolarity) is true, and then perform all SPI transfers. If DrActive is false it is performed asynchronously.

This function performs an array bi-directional SPI transfer. If DrActive is set to true, this overload transfers all the data in WriteData numCaptures times per data ready condition being met. It captures data from numBuffers data ready signals. If DrActive is set to false, all the transfers are performed asynchronously. The total number of SPI transfers is WriteData.Count()*numCaptures*numBuffers. The following pseduo-code snippet would perform 400 total SPI transfers, across 100 data ready conditions. MOSI = {0x1234, 0x5678} myISpi32.DrActive = True MISO = myISpi32.TransferArray(MOSI, 2, 100) During the transfers, the SPI bus would look like the following: MOSI: ---(0x1234)---(0x5678)---(0x1234)---(0x5678)-----------------(0x1234)---(0x5678)---(0x1234)---(0x5678)--...-----(0x1234)-----(0x5678)-----(0x1234)-----(0x5678)-- MISO:----MISO(0)----MISO(1)----MISO(2)----MISO(3)------------------MISO(4)----MISO(5)----MISO(6)----MISO(7)---...-----MISO(196)----MISO(197)----MISO(198)----MISO(199)- DR: ___|¯¯¯|_____________________________________________________|¯¯¯|______________________________________..._____|¯¯¯|____________________________________________

Blink user LED using timer hardware (not available on Cypress Explorer FX3 board)

Turn off user LED (not available on Cypress Explorer FX3 board)

Turn on user LED (not available on Cypress Explorer FX3 board)

This function is used to wait for an FX3 to be programmed with the ADI bootloader. In general, the programming model would go as follows, to connect and program the first board attached: Dim myFX3 as FX3Connection = New FX3Connection(firmwarepath, bootloaderpath, devicetype) If Not myFX3.WaitForBoard(10) Then Msgbox("No boards found") Exit Sub End If myFX3.Connect(myFX3.AvailableFX3s(0))

Overload of WaitForStreamCompletion which blocks indefinitely until a stream completion event is seen.

Blocks until the streaming endpoint mutex can be acquired. Allows a user to synchronize external application the completion of a stream. Returns false if there is not a stream running, or if the timeout is reached without the stream mutex being acquired.

Array transfer which performs an initial SPI transmit (MOSI only, no read back) then starts a read stream. This is useful if you need to issue a write to the DUT, then immediately start reading back data, without the USB transfer overhead of approx 150us

This function writes a single register byte, given as an Address / Data pair

This function writes an enumerable list of data to the DUT as AddrDataPairs

Overload of WriteRegByte which allows for multiple registers to be specified to write to, as an IEnumerable list of register addresses.

This is the most general WriteRegByte, which the others are based on

This function is not currently implemented. Calling it will throw a NotImplementedException.