scan

R2026b

Detect devices connected to a JTAG chain

Since R2026b

collapse all in page

Syntax

scan(jtagObj)

Description

scan(jtagObj) scans the JTAG chain and updates the Devices property of the specified jtagchain object with information about the detected devices.

Before scanning the JTAG chain, scan:

  • Verifies that the required vendor tools are available and that the tool path is configured in MATLAB®. If the tool path is not configured, the function returns an error.

  • Verifies that the required drivers are installed for the selected vendor.

  • Detects JTAG cables connected to the development computer.

  • If multiple JTAG cables are detected, the function scans the cable specified by the CableName property. Otherwise, the function returns an error.

  • Retrieves information about each device in the JTAG scan chain and updates the Devices property.

When you create a jtagchain object for the AMD® and Altera® devices, the constructor scans the JTAG chain and populates the Devices property. If the connected JTAG cable or devices change after object creation, use scan to rescan the JTAG chain and update the Devices property. The constructor does not perform a JTAG scan for Microchip devices.

example

Examples

collapse all

Create a jtagchain object and view information about devices detected in the JTAG chain. If the connected JTAG cable or devices change, use scan to refresh the device information stored in the Devices property.

Set your system environment for accessing Altera tools from MATLAB by using the hdlsetuptoolpath function.

hdlsetuptoolpath('ToolName','Altera Quartus II',...
                 'ToolPath','C:\altera\24.1\quartus\bin\quartus.exe');

Create a jtagchain object. The constructor automatically scans the JTAG chain and detects connected devices.

jtagObj = jtagchain("Altera");

Rescan the JTAG chain and update the Devices property.

scan(jtagObj)

View the updated device information.

jtagObj.Devices
ans =

  1×3 table

    ChainPosition         Manufacturer               Part
    _____________    _______________________    _____________

          1          "Intel (Altera FPGA)"     "5CSEMA5F31"

Input Arguments

collapse all

Instance of JTAG chain object, specified as a jtagchain object.

Version History

Introduced in R2026b

See Also

|