generateDefaultInputString

Generate input string from AMI file

Since R2026a

collapse all in page

Syntax

InputString = generateDefaultInputString(AMIFile)

Description

InputString = generateDefaultInputString(AMIFile) generates the input string to the serdes.AMI object from the provided AMI file with the default values.

Examples

collapse all

Open Live Script

Create the TX AMI System object.

txAMI = serdes.AMI;
txAMI.LibraryPath = 'C:\serdes';                        % Path to the directory containing the DLL/SO file
txAMI.LibraryName = ['serdes_tx_' computer('arch')];    % Name of the DLL or SO file
txAMI
txAMI = 
  serdes.AMI with properties:

       LibraryName: 'serdes_tx_glnxa64'
       LibraryPath: 'C:\serdes'
       InputString: ''
        SymbolTime: 1.0000e-10
    SampleInterval: 6.2500e-12
         BlockSize: 1024
           RowSize: 7065
        Aggressors: 0
       PassThrough: false
          InitOnly: true
    SkipFirstBlock: true
        OutputName: 'AMIOut'
           AMIData: [1×1 struct]

Generate the input string from the AMI file for the transmitter attached with this example. You can also use your custom AMI file, but it must be available in the present working directory.

txInputString = txAMI.generateDefaultInputString('serdes_tx.ami');

Observe the generated input string. This transmitter contains an FFE operating in fixed mode and the modulation scheme is set to 3.

disp(serdes.AMI.generateDefaultInputString('serdes_tx.ami'));
(serdes_tx(Modulation_Levels 3)(FFE(Mode 1)(TapWeights(-1 0)(0 1)(1 0)(2 0))))

You can modify the input string to set the modulation scheme to 2 and bypass the FFE by setting FFE mode to 0.

txInputString = '(serdes_tx(Modulation_Levels 2)(FFE(Mode 0)(TapWeights(-1 0)(0 1)(1 0)(2 0))))';

Recreate the TX AMI system object with the updated input string.

txAMI.InputString = txInputString;
txAMI
txAMI = 
  serdes.AMI with properties:

       LibraryName: 'serdes_tx_glnxa64'
       LibraryPath: 'C:\serdes'
       InputString: '(serdes_tx(Modulation_Levels 2)(FFE(Mode 0)(TapWeights(-1 0)(0 1)(1 0)(2 0))))'
        SymbolTime: 1.0000e-10
    SampleInterval: 6.2500e-12
         BlockSize: 1024
           RowSize: 7065
        Aggressors: 0
       PassThrough: false
          InitOnly: true
    SkipFirstBlock: true
        OutputName: 'AMIOut'
           AMIData: [1×1 struct]

Input Arguments

collapse all

AMI file containing AMI settings and parameters, specified as a text file.

Output Arguments

collapse all

Generated input string per IBIS-AMI standard based on the default values in the provided AMI file, returned as a character vector.

Version History

Introduced in R2026a

See Also