bossdevice API for MATLAB
- MATLAB® R2024a 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® real-time digital processor
- bossdevice® firmware
The following products are required for some advanced functionality such as designing custom filters but are not strictly required for a standard operation or triggering of the bossdevice.
- Turn on the bossdevice and connect the
Control PC
Ethernet port on your bossdevice to an available Ethernet port on your computer. - On your computer, follow these steps to configure the local Ethernet interface on your PC with the IP address
192.168.7.2
.
If you cannot connect to the bossdevice facing message errors like Error: Cannot connect to target 'bossdevice': Cannot connect to target.
or experience frequent disconnection issues, please check out the following recommended steps.
- 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 commandNew-NetFirewallRule -DisplayName "bossdevice" -Direction Inbound -RemotePort 5505-5507,5510-5512,5515-5517 -Protocol UDP -Action Allow -Profile Any -RemoteAddress 192.168.7.5
. See reference.
- Set the Development-to-Target Computer Ethernet Interface as
- Download
bossdevice-api-installer.mltbx
from the latest release available in the GitHub project. - Download the bossdevice firmware binary file for your MATLAB Release from our downloads portal.
- Start MATLAB and install the bossdevice API toolbox with double click on
bossdevice-api-installer.mltbx
. - 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, callbd = 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. - 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. - Open the documentation
openBossdeviceDoc
orbd.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.
- 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. - If not found in the MATLAB path or you want to use a custom firmware version, please select
mainmodel.mldatx
real-time application. - Initialize the bossdevice with
bd.initialize
. - 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 underlinedupdate(tg)
command. The bossdevice hardware will be upgraded automatically. After some seconds, you can rerunbd.initialize
. - Run the signal processing application on the remote device with
bd.start
in the MATLAB command window. - Open the documentation
openBossdeviceDoc
and explore examples withdemo_script_name
and methods available in the bossdevice object.
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.
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.
Citar como
Pablo (2024). bossdevice API for MATLAB (https://github.com/sync2brain/bossdevice-api-matlab/releases/tag/v0.14.2), GitHub. Recuperado .
Compatibilidad con la versión de MATLAB
Compatibilidad con las plataformas
Windows macOS LinuxCategorías
- Sciences > Neuroscience > Human Brain Mapping > EEG/MEG/ECoG >
- Sciences > Neuroscience > Brain Computer Interfaces >
Etiquetas
Community Treasure Hunt
Find the treasures in MATLAB Central and discover how the community can help you!
Start Hunting!Descubra Live Editor
Cree scripts con código, salida y texto formateado en un documento ejecutable.