Embedded Linux Explorer
Connect to hardware, monitor resources, and control applications running embedded Linux
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.
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.
Configure SoC Hardware Board
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.
Open the Embedded Linux Explorer app, and select Configure SoC Hardware Board.
Enter the IP address, username, password, and SSH port for the board.
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.
Monitor Deployed Application on SoC Board
This example shows how to use the Embedded Linux Explorer app in SoC Blockset to monitor resources for deployed applications.
Open SoC Builder and load the model from the last stage of the Task Execution example.
In the Prepare section, on the Select Build Action screen, select Build, load, and run.
In the Connect Hardware screen, enter your login credentials.
In the Run Application screen, select Load and Run.
Open the Embedded Linux Explorer app.
Enter login credentials that match the device selected in SoC Builder.
Observe the information about the selected device in the Deployed Applications table:
soc_task_execution_step4_sw.elfappears in the table.
The state of the application is
The CPU (%) and RAM (MB) columns display the total core and RAM percentage occupancy, respectively.
A process ID (PID) is assigned to the application.
Observe the information in the Processor section:
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.
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.
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.
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 Message||Possible Cause||Solution|
|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>.||
||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.||
||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 platform||Only 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.|
Introduced in R2023a