SDK Errata: FAQ

In the SDK package there is a Changelog.txt file that details all known additions, changes and bugs at the time of release. This page contains a list of SDK and TES Errata found after release, which will be updated as each bug is reported or resolved. 

Last Edited: 17 February 2023

New Line At End Of File Causes TES Error

Bug:

When loading a file to TES e.g. FH table, that has a new line (carriage return) at the end of the file, TES will report an error: Exception has been thrown by the target of an invocation

Customer Impact:

Customer can manually remove the new line from the file and reload the file in TES.

Autogenerated Python Sample Code

Bug:

Autogenerated sample code may not run in some circumstances without changes. Work is on going to determine the root cause of the issue.

Customer Impact:

Occasionally the interpreter will return a SystemError at the line "board = platform.Boards[0]"
Changing this to "board = platform.CustomerBoard" has been known to resolve this issue.

Note: The "import clr" line currently requires a pythonnet version of 2.5.2 or older (at time of writing, version 3 and newer will not work).
Additionally, it is important to ensure that the TES version used to produce the sample code is the same as the version that copied the server files onto the FPGA SD card. This can be ensured by removing the folder "/home/analog/adrv9001_server", then connecting with the TES that is used to generate the sample code.

CLGC in FDD mode freezes when Tx and Rx are both enabled

Bug:

When using CLGC in FDD mode, CLGC freezes when both Tx and Rx are enabled together.

Customer Impact:

A fix will be available shortly for this bug.

Program failure when using DPD in some profiles

Bug:

An error is reported when trying to program transceiver when using DPD under certain profiles e.g. 9.6 MSPS. 

Customer Impact:

A fix will be available shortly for this bug. It is still possible to use these profile without DPD and it is also possible to use DPD in other profiles.

FPGA source code not included

Bug:

FPGA source code was omitted from the SDK 17 release. 

Customer Impact:

Users can download a new release of SDK from the product page (version 17.1) that has the FPGA source code included.

This is fixed in SDK 17.1

MCS Operation not working 

Bug:

MCS operation in SDK version 17 did not function as expected and as a result was not useable. 

Customer Impact:

Users can download a new release of SDK from the product page (version 17.1) that has resolved this issue. 

This is fixed in SDK 17.1

Segmentation fault due to large memory allocations on the stack

Bug:

By default, ADI_FPGA9001_MAX_CAPTURE_BYTES is set to the absolute maximum supported by the FPGA. This may cause a segmentation fault due to large memory allocations on the stack.

Customer Impact:

This can be resolved by either:
Modify the makefile CFLAGS to include -DADI_FPGA9001_USE_DYNAMIC_MEMORY. This makes the ADI_FPGA9001_MAX_CAPTURE_BYTES value irrelevant, instead allocating memory on the heap.
Modify the value of ADI_FPGA9001_MAX_CAPTURE_BYTES to be smaller - ideally only as large as the largest required data capture/transmit

This is fixed in SDK 18

MCS profile configuration crashes the TES

Bug:

When programming a configuration that includes Multi-Chip Synchronization the TES GUI will crash. This is caused by a timer timeout issue in the FW and is currently being looked at. 

Customer Impact:

Currently stay using SDK version 17 to test the MCS function. An update will follow shortly to fix this in the SDK 18. 

This is fixed in SDK 18.1