Main Content

intelsoc

Connection to processor on Intel SoC board to perform basic Linux shell operations or program the board

Since R2022a

expand all in page

    Description

    The intelsoc object represents a connection from MATLAB® to the processor on a Intel® SoC board. Use this object to perform basic Linux® shell operations, program your FPGA at the MATLAB command-line, and create an fpga object that connects to the FPGA through the processor on the Intel SoC board.

    Creation

    Syntax

    p = intelsoc
    p = intelsoc(ipaddress, username, password)
    p = intelsoc(hostname, username, password)

    Description

    p = intelsoc creates a connection to the Intel SoC hardware board. This connection reuses the IP address or host name, user name, and password from the most recent connection to a specified Intel board. When you connect MATLAB to a Intel board for the first time, enter the host name or IP address, user name, and password of the Intel board.

    p = intelsoc(ipaddress, username, password) creates a connection to the Intel board by using the IP address, user name, and password that you specify.

    example

    p = intelsoc(hostname, username, password) creates a connection to the Intel board by using the host name of the board, user name, and password that you specify.

    Input Arguments

    expand all

    IP address of the Intel board connected to the network, specified as a character vector or string scalar. If no IP address is specified, the most recently specified IP address is used.​

    Example: '192.168.1.101'

    User name to log into the Intel board over SSH, specified as a character vector or string scalar. If no user name is specified, the most recently specified user name is used. The default user name is "root".

    Example: 'root'

    Password used to log into the Intel board over SSH, specified as a character vector or string scalar. If no password is specified, the most recently specified password is used​. The default password is "cyclonevsoc".

    Example: 'cyclonevsoc'

    Host name of the Intel board connected to the network, specified as a character vector or string scalar.

    Example: 'myhost.mydomain.com'

    Output Arguments

    expand all

    Connection from MATLAB to the processor on an Intel SoC hardware board, returned as a intelsoc object. You can use this connection to interact with the hardware board and attached devices, such as the FPGA on-board the SoC board.

    Properties

    expand all

    IP address or host name of the Ethernet port on the Intel board.

    This property is read-only and cannot be changed after you create the intelsoc object.

    Example: '192.168.1.11'

    Data Types: char

    User name used to log into the Intel board over SSH. If no user name is specified, the most recently specified user name is used. The default user name is 'root'.

    Example: 'root'

    Data Types: char

    Object Functions

    Use the object functions to interact with your SoC device.

    systemRun command in Linux shell on SoC board
    getFileTransfer file from SoC board to host computer
    putFileTransfer file from host computer to SoC board
    deleteFileDelete file on SoC board
    dirList directory contents on SoC board
    programFPGAProgram FPGA and set corresponding device tree from processor on SoC board

    Examples

    collapse all

    Create a hardware processor object to connect to an Intel SoC board. You can then use the object to perform basic Linux shell operations on the SoC board.

    Create an Intel processor hardware object and connect to the processor on-board the Intel SoC board.​

    p = intelsoc('192.168.1.101', 'root', 'cyclonevsoc');

    Run the uname command in a Linux shell on the SoC board by using the intelsoc object function system.

    system(p, 'uname')
    ans =

   'Linux'

    Create a hardware processor object to connect to an Intel SoC board. You can use the object to program your FPGA on-board the SoC board at the MATLAB command-line and to create an fpga object that connects to the FPGA through the processor on the SoC board.

    Create an Intel processor hardware object and connect to the processor on-board the Intel SoC board.​

    p = intelsoc('192.168.1.101', 'root', 'cyclonevsoc');

    Program the FPGA and set the corresponding device tree from processor on the SoC board by using the intelsoc object function programFPGA.

    programFPGA(p, "myBitstream.bit", "myDeviceTree.dtb");

    For more information on device trees, see Generate Device Tree for IP Core.

    Connect to the FPGA on-board the SoC board by using the fpga function. Use the processor hardware object p as an input to the fpga function.

    f = fpga(p);

    Version History

    Introduced in R2022a

    See Also

    |