Parameters

Path to map, references and gateware

pmap (str)

path to the map of components embedded in a board or a test benches. The map is a CSV file decoded by the class p400uc.Map. The path can be absolute or relative to the invocation directory. It can be limited to the file name, e.g. p400t101t.csv. In that case, it is search first in the invocation directory and then in the directory p400map.PATH_MAP.

prefs (str)

path to the references file validating sensors values. The path can be absolute or relative to the invocation directory. It can be limited to the file name, e.g. p400t101t.csv. In that case, it is search first in the invocation directory and then in the directory p400ref.PATH_REF. Required by the functional / acceptance test suite.

fpga_gateware (str)

path to the gateware to be loaded into the Agilex FPGA. The path is relative to the invocation directory or absolute. “ The gateware is loaded by using the JTAG connection. It is not loaded when the path is not defined.

Connection to the outside world

interface_jtag (dict)

dictionary defining the JTAG connection. More details in the Setup JTAG connection(s) within a scenario)

interface_ftdi (dict)

dictionary defining FTDI connections. More details in the Setup FTDI connection(s) within a scenario)

interface_pcie (dict)

dictionary defining the PCIe connection. More details in the section Setup PCIe connection(s) within a scenario)

Configure hardware components

load_cfg (list[dict])

list of dictionary defining configuration for DC/DCs, Mailbox, Max10, OBT and PLLs components. More details in the section Setup configuration within a scenario

Test suites parameters

board_name (str)

part and serial numbers are extracted form the EEPROM. However, when the content of the EEPROM is empty the board name allows to specify the part number and the serial number in one go. The naming convention is {part number}{serial number} matching the regular expression ^(?P<pn>[\w]+\d{2,3}[bpt])(?P<sn>\d+)$, e.g. p400t101t00002 where pn = p400t101t and sn = 00002.

devkit (str)

Devkit identifier, e.g. devkit_ltm4677 to replace board_name. The board_name and devkit identifier are mutually exclusive.

duration (int)

duration of the data collection in seconds. It is required by the collect test suite and ignore in the others cases.

fpga_frequency (int)

the running frequency of the fpga gateware in MHz. It is used in burning tests pushing the card to its limits.

io

parameter defining the number of input and output optical links, e.g. 48/48. By default, this value is extracted from the EEPROM.

keyword

the equivalent of the pytest option -k. Only run tests which match the given substring expression. More information is available in the pytest documentation. By default all tests are run.”

scan_per_minute

number of iterations per minutes. It is required by the collect test suite and ignore in the others cases.

skip_configuration (bool)

skip the configuration step

outdir

path to the output directory containing the data produced by the the test suite. A series of Parquet file, one per entity. The path is either absolute or relative to the invocation directory.

compression

algorithm used to compress the data. Possible values are lz4, uncompressed, snappy, gzip, lzo, brotli, zstd. The default is zstd. For more details, see the polars documentation on the method DataFrame.write_parquet.

compression_level

possible values depend on the compression algorithm. For more details, see the polars documentation on the method DataFrame.write_parquet

loggers

dictionary to set the logging level for individual loggers. Possible names for loggers are p400aji, p400collection, p400model, p400qa, p400uc, pyftdi. Possible values are NOSET, DEBUG, INFO WARNING, ERROR and CRITICAL.