raspilist

List Raspberry Pi hardware boards available for MATLAB Online connection

Syntax

list = raspilist

list = raspilist("Timeout",time)

Description

list = raspilist lists available Raspberry Pi™ hardware boards that you can connect to from MATLAB^® Online™. The output shows the name, serial number, matlab-rpi package version, and status of the board. Before running raspilist, make sure you have configured your boards by following the instructions in Connect to Raspberry Pi Hardware Board in MATLAB Online.

Note

This function is supported only in MATLAB Online.

list = raspilist("Timeout",time) scans for up to time seconds. The default timeout period is 10 seconds. The value of time can be any positive number. If you are unable to find your Raspberry Pi hardware board, you can specify a larger timeout value.

Note

This function is supported only in MATLAB Online.

Examples

Display Available Raspberry Pi Boards

After following the steps to configure your Raspberry Pi in Connect to Raspberry Pi Hardware Board in MATLAB Online, use raspilist to show the details of the available Raspberry Pi boards.

list = raspilist

list =

  2x4 table

       Name        SerialNumber       PackageVersion          Status
      ______    __________________    ______________    __________________

     "homePi"   "00000000a9f2c18c"       "18.1.0"       "Ready to connect"
     "workPi"   "00000000f23438fd"       "18.1.0"       "Ready to connect"

In this example, two devices were configured under the same MathWorks^® user credentials. The Ready to connect status indicates that you can create a connection to both devices from MATLAB Online.

Output Arguments

list — Table with information about available Raspberry Pi boards

table

Table with information about available Raspberry Pi boards, returned as a table. The table lists the name, serial number, matlab-rpi package version, and status for each. The board name is the name you specify during setup, the serial number is a unique identifier for each device, the matlab-rpi package version is the version of the MATLAB package installed on the device, and the status describes whether you can connect. These are the possible statuses and what each represents:

Ready to connect	Raspberry Pi has the correct version of matlab-rpi installed. You can create a MATLAB Online connection.
Connected	Raspberry Pi has the correct version of matlab-rpi installed. A connection to your board already exists in the MATLAB Online workspace.
Upgrade required	Raspberry Pi has an outdated version of matlab-rpi package installed. For instructions, see MATLAB Package on Raspberry Pi Needs to Be Updated.
Authentication required	Provide your MathWorks Account credentials to reauthenticate online connection. This status appears two weeks before your login credentials expire. For instructions, see MathWorks Account Credentials Have Expired.