Main Content

raspilist

List Raspberry Pi hardware boards available for MATLAB Online connection

Add-On Required: This feature requires the MATLAB Support Package for Raspberry Pi Hardware add-on.

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.

example

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

collapse all

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

collapse all

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 connectRaspberry Pi has the correct version of matlab-rpi installed. You can create a MATLAB Online connection.
ConnectedRaspberry Pi has the correct version of matlab-rpi installed. A connection to your board already exists in the MATLAB Online workspace.
Upgrade requiredRaspberry Pi has an outdated version of matlab-rpi package installed. For instructions, see MATLAB Package on Raspberry Pi Needs to Be Updated.
Authentication requiredProvide 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.

Version History

Introduced in R2018a