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® R2022b or newer in their latest update available.
• Simulink Real-Time®
• Simulink Real-Time Target Support Package
• bossdevice hardware
• bossdevice firmware (MLDATX file included in the toolbox installer)

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, please set the Development-to-Target Computer Ethernet Interface as Private. Follow the steps documented here.

Installation and initial toolbox configuration

1. Download bossdevice-api-installer.mltbx from the latest release available in the GitHub project.
2. Start MATLAB and install the bossdevice API toolbox with double click on bossdevice-api-installer.mltbx.
3. 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.
4. 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. Click on the update command if prompted to update the software dependencies on the bossdevice.
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

Please 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.