BM innovations GmbH BM-USBRTX4 Benutzerhandbuch
3DJHRI
1 Introduction
A BlueRobin interface DLL is available providing all functions required for a PC application to communicate
with a BM-USBRTX3/BM-USBRTX4 transceiver unit or a BM-USBD1/BM-USBD4 transceiver dongle via a
USB interface. It supports the following operating systems:
• Windows:
WinXP, Windows 7, Windows 8, Windows 8.1
• MacOS:
>=
10.7
• Linux:
Kernel
2.9x
Currently only a 32-bit version is supported for Windows Operating Systems.
The System Development Kit (SDK) also includes code examples based on Microsoft Visual Studio MFC
(Microsoft Visual Studio 2008).
2
BlueRobin
®
Support in BM-USBRTXx and BM-USBDx
The transceivers provide full
BlueRobin
®
receiver (RX mode) support with messaging system and high
speed data download.
3 Interface Function Overview
Function
Description
rtxDll_GetVersion
Get BlueRobin DLL Version
rtxDll_Initalize
Initialize BlueRobin DLL
rtxDll_DeInitialize
Deinitialize BlueRobin DLL
rtxDll_IsInitialized
Check if BlueRobin DLL is initialized
rtxInterface_ScanForDevices
Scan interface for all connected devices
rtxInterface_GetDeviceInfo
Get device interface information
rtxInterface_UnplugDetectionStart
Start device unplug detection
rtxInterface_UnplugDetectionStop
Stop device unplug detection
rtxInterface_UnplugDetected
Device unplug detection status function
rtxDevice_Open
Open port the device is connected to
rtxDevice _Close
Close previously opened port
rtxDevice _IsOpen
Check if port has already been opened
rtxDevice _InitHardware
Initialize device
rtxDevice_GetInfo
Get device configuration and version info
rtxConfig_RxMode
Configure BlueRobin RX mode operation
rtxConfig_RxLinkFailureLimit
Set limit for consecutive lost data packets in RX mode
rtxConfig_RxSearchTimeout
Set timeout when trying to find a transmitter in RX mode
rtxConfig_RxPairingSensitivity
Set receiver sensitivity for transmitter pairing mode (ID set to 0) in RX mode
rtxConfig_RxSearchRatio
Set ratio between active search time and search pause in RX mode
rtxRX_ChannelReset
Reset RX channel to default settings
rtxRX_ChannelSetProfile
Set profile of transmitter to be received on RX channel
rtxRX_ChannelGetProfile
Get profile of RX channel
rtxRX_ChannelSetID
Set ID of transmitter to be received on RX channel
rtxRX_ChannelGetID
Get ID of RX channel
rtxRX_ChannelStart
Start search or pairing for transmitter on RX channel
rtxRX_ChannelStop
Stop RX channel
rtxRX_ChannelGetState
Get state of RX channel