bossdevice API for MATLAB

sync2brain's bossdevice RESEARCH Application Programmable Interface (API) for MATLAB.

sync2brain's bossdevice RESEARCH Application Programmable Interface (API) for MATLAB

Requirements

• MATLAB® R2023b or newer in their latest update available.
• Simulink® Real-Time™
• Simulink® Real-Time™ Target Support Package (no additional license required, installable from within MATLAB when you have Simulink Real-Time installed)
• bossdevice hardware
• bossdevice firmware

Enable bossdevice communication over Control PC

1. Turn on the bossdevice and connect the Control PC Ethernet port on your bossdevice to an available Ethernet port on your computer.
2. On your computer, follow these steps to configure the local Ethernet interface on your PC with the IP address 192.168.7.2.
3. If you are working on Windows, ensure a stable and robust connection between the development PC and the bossdevice:
   • Set the Development-to-Target Computer Ethernet Interface as Private. Please, follow the steps documented here.
   • If you are not allowed by the IT security settings in your company or institution to change the Ethernet Interface's profile or the Development-to-Target Computer Ethernet Interface keeps reverting to Public after some time or even after every system's reboot, please run PowerShell with administrator rights, and execute the command New-NetFirewallRule -DisplayName "bossdevice" -Direction Inbound -LocalPort 5505-5507,5510-5512,5515-5517 -Protocol UDP -Action Allow -Profile Any -RemoteAddress 192.168.7.5. See reference.

Installation and initial toolbox configuration

1. Download bossdevice-api-installer.mltbx from the latest release available in the GitHub project.
2. Download the bossdevice firmware binary file for your MATLAB Release from our downloads portal.
3. Start MATLAB and install the bossdevice API toolbox with double click on bossdevice-api-installer.mltbx.
4. In the MATLAB Command Window, call bd = bossdevice to add the bossdevice with the default settings to the list of targets. If you want to change either the name of the bossdevice or its default IP address in your local MATLAB settings, call bd = bossdevice('bossdevice','192.168.7.5') replacing the function arguments with the name and IP address you want to set on the real-time device.
5. When prompted, select the bossdevice firmware binary file with the mldatx extension you have downloaded above. Please note you may run bd.installFirmwareOnToolbox afterwards to copy the firmware file into your local toolbox folder, so that you can skip this step in later sessions.
6. Open the documentation openBossdeviceDoc or bd.doc.

Optionally, for more information about how to get, install and manage add-ons for MATLAB like the bossdevice API toolbox, please visit this documentation page.

Get started

1. Create an instance of the main control class bossdevice bd = bossdevice in the MATLAB command window from any working path, since the toolbox has already been added to your MATLAB path.
2. If not found in the MATLAB path or you want to use a custom firmware version, please select mainmodel.mldatx real-time application.
3. Initialize the bossdevice with bd.initialize.
4. If your version of the bossdevice does not match your current version of MATLAB, you may get a Target computer software version mismatch error. In that scenario, please simply click on the underlined update(tg) command. The bossdevice hardware will be upgraded automatically. After some seconds, you can rerun bd.initialize.
5. Run the signal processing application on the remote device with bd.start in the MATLAB command window.
6. Open the documentation openBossdeviceDoc and explore examples with demo_script_name and methods available in the bossdevice object.

User manual

Visit our online documentation available here.

Download and install the toolbox in MATLAB for a complete access to the user manual with the command openBossdeviceDoc in the MATLAB console. You will find more details about API properties and methods, example scripts and further technical information.

Feedback, questions and troubleshooting

If you have any issue to report or enhancement to request, please create a new Issue. If you have any other topic to discuss like a question about usage, a tip to share with the community or other topic of interest, please check out our on-going Discussions.