Main Content

Embedded Linux Explorer

Connect to hardware, monitor resources, and control applications running embedded Linux

Since R2023a

expand all in page

Description

The Embedded Linux Explorer app provides utilities that help you to develop and deploy embedded Linux® applications. With the app, you can:

  • Connect to hardware boards running embedded Linux.

  • Monitor resource usage.

  • Manage processes on the board.

  • Troubleshoot issues with resources and processes.

Embedded Linux Explorer

Open the Embedded Linux Explorer App

  • MATLAB® toolstrip: On the Apps tab, scroll to the Test and Measurement section, and select Embedded Linux Explorer.

  • Simulink® toolstrip: On the Apps tab, select System on Chip. Then, in the Prepare section, select Embedded Linux Explorer.

  • MATLAB command line: Enter the following.

    embeddedLinuxExplorer

Examples

expand all

This example shows how to use the Embedded Linux Explorer app in SoC Blockset™ to configure a hardware board on your host computer. For successful communication, ensure that the board and the host computer connect to the same network.

  1. Open the Embedded Linux Explorer app, and select Configure SoC Hardware Board.

  2. Enter the IP address, username, password, and SSH port for the board.

    Configure SoC Hardware board

  3. Click Confirm Parameters. You can view the configured board in the Device List pane of the app.

Follow the same steps to configure another SoC Blockset board on the host computer. Each configured SoC Blockset board appears in Device List pane of the app.

Embedded Linux Explorer app. On the device List pane, there are two configured devices.

This example shows how to use the Embedded Linux Explorer app in SoC Blockset to monitor resources for deployed applications.

  1. Open SoC Builder and load the model from the last stage of the Task Execution example.

    socBuilder('soc_task_execution_step4')

    1. In the Prepare section, on the Select Build Action screen, select Build, load, and run.

    2. In the Connect Hardware screen, enter your login credentials.

    3. In the Run Application screen, select Load and Run.

  2. Open the Embedded Linux Explorer app.

  3. Enter login credentials that match the device selected in SoC Builder.

  4. Observe the information about the selected device in the Deployed Applications table:

    • The application soc_task_execution_step4_sw.elf appears in the table.

    • The state of the application is Running.

    • The CPU (%) and RAM (MB) columns display the total core and RAM percentage occupancy, respectively.

    • A process ID (PID) is assigned to the application.

  5. Observe the information in the Processor section:

    • System uptime

    • Number of cores in the processor

    • Per-core load: A comma separated list, showing the load percentage per core. In this example, there are four values for four cores.

    • A round chart showing the average load per processor.

  6. Observe the information in the RAM section:

    • Total — shows the total processor random access memory (RAM).

    • Used — shows the amount of used RAM.

    • Available — shows the amount of available RAM.

    • A round chart showing RAM usage, as a percentage of total RAM.

  7. Observe the information in the Storage section:

    • Total — shows the total storage memory.

    • Used — shows the amount of used storage memory.

    • Available — shows the amount of available storage memory.

    • A round chart showing storage usage, as a percentage of total storage memory.

Embedded Linux Explorer open with the soc_task_execution_step4_sw.elf application running.

To run the application every time the board reboots, select the row for the model in the Deployed Applications table, and select Run-On-Boot.

Troubleshoot SSH Connections

Error MessagePossible CauseSolution
Hardware board with address ip-address already present.A device with the same IP address, username, password, and SSH port has already been connected.In the app, select the appropriate device to connect (instead of creating new connection).
There was no response to a ping command at address ip-address.

  • The hardware board is not powered.

  • The hardware board is not connected to the network.

  • The host computer does not have access to the network that the hardware board is on.

Ensure that the hardware board has power, is connected to the network, and that the host device and board are visible to each other over the network.
Could not SSH to hardware board at address ip-address. Check login credentials and try again.

  • The hardware board is not powered.

  • The hardware board is not connected to the network.

  • The host computer does not have access to the network that the hardware board is on.

  • Provided Username, Password and SSH port are incorrect

Ensure that the hardware board has power, is connected to the network, that the host computer and hardware board are visible to each other over the network, and that the SSH credentials are valid.
Unsupported host development platformOnly Windows® and Linux hosts are supported.Change to a supported operating system.
The operating system present on the hardware board with address ip-address is not supported.The hardware board is not running a Linux operating system.Change to a supported operating system.

Version History

Introduced in R2023a

See Also

Apps