Besides the extension features developed in the SoC system, tool sets developed in the host are also provided in the sdk\tool directory for extended feature development, user application development, or mass production.
This document provides a brief introduction to these tools and their usage methods.
For the user manual for each tool, please refer to the tool user manual in the specific directory.
The brief descriptions of each tool are as follows:
MPPG Tool supports mass production and debug mode.
MP Mode: supports various features, including downloading up to 8 devices simultaneously and changing the Bluetooth address of the device.
Debug Mode: allows developers to use the tool for debugging and feature development.
MP Pack, Flash Map Generator and OTA Header Generator functions are integrated into the MPPG Tool chain.
For instructions on how to use these functions, please refer to MPPG Tool Chain User Guide available on the Realtek official website at RealMCU.
In the following section, a brief overview of the usage of the MPPG Tool in debug mode is provided.
RTL8763ESE will be used as an example to illustrate the steps involved in the downloading process.
Please refer to MPPG Tool User Guide available on the Realtek official website at RealMCU for more details.
The download connection varies for different RTL87x3 ICs.
Please refer to the respective Evaluation Board User Guide available on the Realtek official website at RealMCU for detailed instructions.
Double-click to run MPPGTool.exe located in \tool\MPPGTool-vx.x.x.x. Then, choose the chip type and click the Confirm button.
Generate Bluetooth snoop log for further analysis by Frontline capture tool.
Support Ellisys injection.
A brief introduction to the usage of Debug Analyzer is described as follows.
RTL8763ESE is taken as an example to illustrate the steps.
Please refer to Debug Analyzer User Guide available on the Realtek official website at RealMCU for more details.
Set the EVB to Log Print Mode (refer to Log Pin Wiring) and then power on the EVB (refer to Power Supply).
Note
Log debugging connection varies for different RTL87x3 ICs.
Please refer to the respective Evaluation Board User Guide available on the Realtek official website at RealMCU for detailed instructions.
Double-click to run DebugAnalyzer.exe located in \tool\DebugAnalyzer-vx.x.x.x.
Set parameters in the following UI according to requirements and click Confirm. Taking bt_audio_receiver demo bin as an example, the trace path is shown as follows.
MCUConfig Tool is used for changing application and system behaviors without any modification in source code.
The system configuration is used to change system-wide configuration, such as logging, link numbers for different profile links, etc.
Stack options: Bluetooth stack and profile options.
Platform options: System options, including internal charger.
The application configuration is designed to provide vendors a simple way to change application UI parameters on its binary image.
In the following section, the common operations of MCUConfig Tool are briefly introduced.
Users can make customized modification based on the default RCFG bin provided by Realtek SDK.
For more information, please refer to MCUConfig Tool User Guide available on the Realtek official website at RealMCU.
Double-click to run McuConfigTool.exe located in \tool\MCUConfigTool-vx.x.x.x. Choose the chip type and click Import Bin File button.
If users need to re-import the RCFG bin during the configuration process, please click Reset ‣ Reset all data to return to the main interface and select the required RCFG bin again to import.
If the flash layout in the SDK is changed, the new flash_map.ini should be imported by clicking Import flash map.ini in the System Configuration tab, as shown below.
The DSPConfig Tool allows developers to configure parameters of built-in signal processing algorithms for phone calls, music playback, and VAD.
In addition, this DSPConfig Tool also provides user-friendly parameter fine-tuning functions, which can greatly shorten the turnaround time of parameter tuning.
This tool also supports the generation of DSP configuration images.
As for how to use the DSPConfig Tool, please refer to DSPConfig Tool User Guide available on the Realtek official website at RealMCU.
The ANC Design Tool is convenient for users to choose the actual number of biquad filters used in a filter, design coefficients of biquad filters, and visualize the overall response of a filter.
As for how to use the ANC Design Tool, please refer to its user guide in the \tool\AncDesignTool-vx.x.x.x directory.
The ANC MP Tool supports the functionality to read gain, write gain to RAM, and download gain to Flash for feedforward and/or feedback filters.
Additionally, the write gain function can be used to enable or disable the feedforward and/or feedback filters.
As for how to use the ANC MP Tool, please refer to its user guide in the \tool\ANCMPTool-vx.x.x.x directory.
An Android tool set for Bluetooth audio could implement features such as TTS, OTA, and renaming device.
With the apk installed on an Android phone, the Android tool set could communicate with Bluetooth audio devices and support the corresponding features described as follows:
An iOS tool set is designed for the iOS platform.
With the ipa installed on an iOS phone, the iOS tool set could communicate with Bluetooth audio devices and support the corresponding features described as follows:
The MP Kit Setup Package is used to verify RF performance and certification.
This tool can generate non-signaling Bluetooth signals of various modulation for regulatory certification and enter the direct test mode of Bluetooth.
As for how to use the MP Kit Setup Package, please refer to its user guide in the \tool\MPKitSetupPackage-vx.x.x.x directory.
The Realtek Bluetooth MP Tool is matched with Realtek’s Genesis production version used in mass-production.
The tool supports functions such as writing image, measuring voltage, simple frequency calibration, audio loopback, and modifying configuration data during mass-production.
The MP tool can support up to 1 to 8 mass production modes.
As for how to use the Bluetooth MP Tool, please refer to RF Test and MP Tool User Manual available on the Realtek official website at RealMCU.
The Fast MP Tool must be matched with Realtek’s FastMP production board used in mass-production.
RTK Fast MP Tool allows for simultaneous functional testing of the Windows 10/11 system on a computer, and the application is multithreaded.
It can support testing of up to 24 DUTs, including functions such as writing image, RF calibration, and modifying configuration data.
As for how to use the Fast MP Tool, please refer to RF Test and MP Tool User Manual available on the Realtek official website at RealMCU.
The ACI Host CLI Tool is a test tool running on PC, which is used to demo ACI usage.
It can perform CMD/event communication test with ACI Device through USB serial port.
As for how to use the ACI Host CLI Tool, please refer to ACI Host CLI Tool.
The OTA Dongle Tool is used for downloading OTA images in the OTA tooling board to follow the SPP OTA procedure for Realtek Audio chips.
The tool also supports controlling the OTA tooling board for SPP connection, force engagement, and SPP OTA testing.
As for how to use the OTA Dongle Tool, please refer to its user guide in the \tool\OtaDongleTool-vx.x.x.x directory.
