Overview
DISCLAIMER
Realtek solution, user guide, study guide and other documents listed on this tutorial(collectively, “Documents”) are provided “as is” and with all faults. Customers agree to use any Documents solely for agreed purpose and subject to the terms of this Disclaimer.
Realtek disclaims all other warranties or representations, express or implied, regarding resources or use thereof, including but not limited to accuracy or completeness, title, any epidemic failure warranty and any implied warranties of merchantability, fitness for a particular purpose, and non-infringement of any third party intellectual property rights. Realtek shall not be liable for and shall not defend or indemnify Customer against any claim, including but not limited to any infringement claim that related to or is based on any combination of products even if described in Documents or otherwise. In no event shall Realtek be liable for any actual, direct, special, collateral, indirect, punitive, incidental, consequential or exemplary damages in connection with or arising out of Documents or use thereof, and regardless of whether Realtek has been advised of the possibility of such damages. Realtek is not responsible for any failure to meet such industry standard requirements. Customers that incorporate Realtek products understand and agree that Customers remain responsible for using their independent analysis, evaluation and judgment in designing their applications and that Customers have full and exclusive responsibility to assure the safety of Customers’ applications and compliance of their applications (and of all Realtek products used in or for Customers’ applications) with all applicable regulations, laws and other applicable requirements. Designer represents that, with respect to their applications, Customer has all the necessary expertise to create and implement safeguards that (1) anticipate dangerous consequences of failures, (2) monitor failures and their consequences, and (3) lessen the likelihood of failures that might cause harm and take appropriate actions.
INTELLECTUAL PROPERTY RIGHT
Copyright 2023 Realtek Semiconductor Corporation. All rights reserved. No part of this tutorial or documents listed on this tutorial may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any language in any form or by any means without prior written permission of Realtek.
Overview
In this document, it will be introduced how the powerful Realtek RTL8763E series platform provides the capabilities to enrich developers’ applications. The Realtek platform offers high computation performance with ultra-low system power consumption. The rich IO interfaces can connect almost all external devices. The high-performance/good compatibility Bluetooth interface lets the application connect to the world through a wireless connection, allowing for endless possibilities. More attractive application cases can be found on the Realtek official website https://www.realmcu.com/.
The Benefit of the Realtek Solution
The Realtek platform provides the SoC platform with the following features:
Rich and highly compatible peripheral interfaces for IOT and BT audio enabled devices
High performance with low power consumption computation environment
Rich development documentation to bridge the gap between Realtek and developers
Mature mass production experience to assist developers in setting up the production line
Document Mapping for BT Audio Solution
Here is the document mapping table for each part number.
| Category | Document name | Part number | Document |
|---|---|---|---|
| Product Brief | RTL87x3E | Product Brief Bluetooth Dual Mode Microcontroller (PDF) | |
| SDK Quick Start Guide | RTL87x3E | RTL87x3E Quick Start User Guide (PDF) | |
| SDK Resources | SDK User Guide | RTL87x3E | RTL87x3E SDK User Guide (PDF) |
| System Introduction | DLPS (Deep Low Power State) | RTL87x3E | RTL87x3E Low Power Mode User Manual (PDF) |
| Memory | RTL87x3E | RTL87x3E Memory Hierarchy User Manual (PDF) | |
| Flash | RTL87x3E | RTL87x3E Flash User Guide (PDF) | |
| Security Mechanism | RTL87x3E | RTL87x3E MP Flow for Secure-Enabled Chip (PDF) | |
| OTA/DFU(Device Firmware Upgrade) | RTL87x3E | RTL87x3E OTA User Manual (PDF) | |
| Debugging System | RTL87x3E | RTL87X3E Debugging System (PDF) | |
| Audio | Audio Subsystem | RTL87x3E | RTL87x3E Audio Subsystem Introduction (PDF) |
| Audio Plugin | RTL87x3E | RTL87x3E Audio Plugin User Manual (PDF) | |
| Audio Route | RTL87x3E | RTL87x3E Audio Route User Manual (PDF) | |
| Peripheral | RTL87x3E | RTL87x3E IO User Manual (PDF) | |
| BLE Stack | RTL87x3E | RTL87x3E BLE Stack User Manual (PDF) | |
| BREDR Stack | RTL87x3E | RTL87x3E BREDR Stack User Manual (PDF) | |
| Application Samples | Audio Demo* | RTL87x3E | RTL87x3E Audio Demo Application Note (PDF) |
| BLE Sample Project | RTL87x3E | RTL87x3E BLE Sample Project Application Note (PDF) | |
| BT Audio* | RTL87x3E | RTL87x3E BT Audio Application Note (PDF) | |
| BT Audio Transceiver* | RTL87x3E | RTL87x3E BT Audio Transceiver Application Note (PDF) RTL87x3E BT Audio Transceiver ACI User Manual (PDF) RTL87x3E BT Audio Transceiver Design Spec (PDF) |
|
| DTM* | RTL87x3E | RTL87x3E DTM Application User Manual (PDF) | |
| BT HID Demo* | RTL87x3E | RTL87x3E BT HID Demo Application Note (PDF) | |
| BT MAP Demo* | RTL87x3E | RTL87x3E BT MAP Demo Application Note (PDF) | |
| BT PBAP Demo* | RTL87x3E | RTL87x3E PBAP Demo Application Note (PDF) | |
| BT iAP Demo* | RTL87x3E | RTL87x3E iAP Demo Application Note (PDF) | |
| LE Audio Sample Project* | RTL87x3E | RTL87x3E LE Audio Sample Project Application Note (PDF) | |
| OTA* | RTL87x3E | RTL87x3E OTA Application Note (PDF) | |
| BT SPP Demo | RTL87x3E | RTL87x3E SPP Demo Application Note (PDF) | |
| Platform Power Test Demo* | RTL87x3E | RTL87x3E Platform Power Test User Manual (PDF) | |
| USB Audio Demo* | RTL87x3E | RTL87x3E USB Audio Demo Application Note (PDF) | |
| USB HID Demo* | RTL87x3E | RTL87x3E USB HID Demo Application Note (PDF) | |
| Development Tool | MCU Config Tool | RTL87x3E | MCU Config Tool User Guide (PDF) |
| DSP Config Tool | RTL87x3E | DSP Config Tool User Guide (PDF) | |
| Image Download Guide (For RD and Mass Production) | RTL87x3E | MPPG Tool User Guide (PDF) | |
| Log Capture Tool | RTL87x3E | Debug Analyzer User Guide (PDF) | |
| CLI Tool for BT Audio Transceiver | RTL87x3E | RTL87x3E BT Audio Transceiver AciHostCLI Tool User Manual (PDF) | |
| RF Test and MP Tool | RF Test and MP Tool User Manual | RTL87x3E | RTL87x3E RF Test and MP Tool User Manual (PDF) |
| iOS/Andriod Application Development Kit | iOS OTA APP User Manual | RTL87x3E | iOS OTA SDK (ZIP) |
| iOS Audio Connect User Manual | RTL87x3E | iOS AudioConnect SDK (ZIP) | |
| Android OTA APP User Manual | RTL87x3E | Android OTA SDK (ZIP) | |
| Android Audio Connect App User Guide | RTL87x3E | Android AudioConnect SDK (ZIP) | |
| Hardware Instruction | RTL87x3E | RTL87x3E Hardware Instruction (PDF) | |
| HDK | RTL8763EFL | RTL8763EFL HDK (PDF) | |
| RTL8763EAU | RTL8763EAU HDK (PDF) | ||
| RTL8763ESE | RTL8763ESE HDK (PDF) | ||
| Evaluation Board User Manual | RTL87x3E | RTL87x3E Evaluation Board User Manual (PDF) | |
| RF Qualification | RTL87x3E | RTL87x3E Qualification User Manual (PDF) | |
Note
The modules with asterisk superscripts (*) are only available in RTL87X3E-MCU-SDK-Common-v3.x.x.x
RWS APP MODULE is only available in RTL87X3E-MCU-SDK-v2.x.x.x and RTL87X3E-MCU-SDK-v3.x.x.x
DONGLE MODULE is only available in RTL87X3E-MCU-SDK-v3.x.x.x
SoC Document Study Guide
Realtek offers a wide range of comprehensive documentation for developers. Below is a study guide that orders the documents to go through for the SDK software, SoC platform, and mobile application development topics. This guide will assist developers in gaining a better understanding of the system. The RTL8763ESE platform will be utilized as an illustrative example.
SDK Software Study Guide
Developers can begin by exploring the SDK background and the required tools, and then utilize the sample applications to gradually acquaint themselves with the Realtek development environment. Here is the study guide for topics related to software development. Developers can refer to the steps depicted in the following figure.
SoC Hardware Platform Study Guide
Prior to designing the developer-specified device, developers can begin by reviewing the datasheet and the EVB platform to understand the characteristics of the SoC. They can then utilize the Realtek-recognized HDK to finalize the product. Developers can refer to the steps depicted in the following figure.
Note
RTL87x3E Datasheet is not available on the website, please request a ticket on DevZone of realmcu.
iOS/Andriod Application Development Guide
Realtek also offers a guide if the product works with the mobile application.
RTL87x3E Software Development Guide
The Realtek SoC offers extensive development resources to assist developers in becoming familiar with the RTL87x3E series and quickly initiate the actual development process. In the following sections, RTL8763ESE will be taken as an example to illustrate the document structure.
Note
In the below sections, developers can reference the link to obtain summary information from each document.
Product Brief
This document primarily introduces the typical features and application scenarios of the dual-mode Bluetooth microcontroller (Dual mode BT MCU) solution. It introduces three types of applications, namely the audio transmitter, audio receiver, and audio transceiver. The document also includes a list of HW features, SW features, supported Bluetooth profiles, audio codec types, and audio routing capability. These details can assist in determining a suitable solution for an application.
SDK Quick Start Guide
The document briefly covers important pins on the EVB, the process of generating and downloading images onto the EVB, printing logs, and provides information on other important documents. This document is particularly useful for those who are completely new to the topic and serves as a starting point for their understanding.
SDK Resources
SDK User Guide
The user guide is designed to offer developers a comprehensive understanding of the DLPS features and their utilization for optimizing battery life. It provides a detailed explanation of how DLPS functions, the procedures for entering and exiting DLPS, and crucial APIs associated with it.
System Introduction
DLPS (Deep Low Power State)
The user guide aims to provide developers with a comprehensive understanding of the DLPS features and how to use them to maximize battery life. It describes how the DLPS works, how to enter and exit it, and important related APIs.
Memory
This document provides an overview of the memory system of the IC and provides instructions on its usage. The memory system includes ROM, RAM, external SPI Flash, and eFuse. The Cache has a separate RAM, which can also be configured as general RAM through Realtek Vendor registers. This flexible memory configuration mechanism enables the IC to cater to diverse applications with different memory usage needs.
Flash
Flash is a kind of non-volatile storage for code shadowing to RAM, executing code directly, or storing data. This document describes how to use Flash-related APIs and how Flash works in the IC.
Security Mechanism
This paper introduces the security mechanism of the IC as well as its usage. This document guides developers on how to enable a non-secure IC as a secure IC, generate an RSA signature key, and prepare RSA signed images for the secure IC. If no security is enabled in products, please skip this document.
DFU/ OTA (Device Firmware Upgrade Over The Air)
OTA represents the technology that uses Bluetooth to update the image (code and data) that runs on the Flash. This document covers how to use OTA, describing things such as the flash layout, the image header format, and OTA protocols.
Debug System
Debugging is the process of finding and resolving bugs within computer programs, software, or systems. Two debugging methods are provided in the SDK to debug user applications: log mechanism and SWD debugging.
Audio
Audio Subsystem
This document provides information about the design philosophy and operating principle of the Audio Subsystem. The Audio Subsystem is an audio-specific domain architecture that standardizes the audio driver abstraction interfaces, virtualizes the audio stream routing mechanism, and provides various high-level modularized components.
Audio Plugin
This document provides information about the usage of the Audio Plugin module. The Audio Plugin is designed to meet the requirements of integrating external audio devices (vendor hardware Codecs, vendor DSPs, DACs, Amplifiers, etc.) into the Audio Subsystem. Developers can use the Audio Plugin module to implement collaborations between customized external audio devices and SoC internal devices.
Audio Route
The purpose of this document is to describe how to use the audio route module in the MCUConfig Tool. The MCUConfig Tool can demonstrate the audio route capability of each IC. Developers can configure the routing relationship of each audio stream using the MCUConfig Tool.
Peripheral
This document describes the technical software details for the various peripherals supported by the IC. It includes information on the data structures used by the peripherals and the library functions that are supported.
BLE Stack
The Realtek SDK provides software documentation including stack/profiles, reference material, example profiles, and user applications to facilitate product development using the Realtek Series of SoC devices. The purpose of this document is to provide an overview of BLE Stack Interfaces. BLE Stack Interfaces can be categorized into GAP interfaces and GATT based profile interfaces.
BREDR Stack
The purpose of this document is to provide an overview of Bluetooth BR/EDR Stack APIs. The Bluetooth BR/EDR Stack APIs are categorized into different modules, including Device Management APIs, SDP APIs, and BR/EDR Link Management APIs. Applications can interact with BR/EDR stack through Device Management/SDP/Link Manager APIs & Callback message.
Application Samples
Audio Demo Application Note
The purpose of this document is to provide an overview of the audio demo application. The audio demo project offers a simple example of how to use VP, ringtone, and line-in. This project demonstrates how to play VP and Ringtone, and how to start or stop Line-in.
BLE Sample Project Application Note
The purpose of this document is to provide an overview of the BLE sample application. The application includes four defined GAP roles (broadcaster, observer, peripheral, central) for devices operating over a LE physical transport. Additionally, the SDK provides a corresponding demo application that developers can reference during development.
BT Audio Application Note
The purpose of this document is to provide an overview of the BT audio demo application. The BT audio project offers a simple example of how to use A2DP and HFP. This project implements both SRC and SNK roles for A2DP. Additionally, for HFP, AG and HF unit are implemented.
BT Audio Transceiver Application Note
BT Audio TRX is an application developed based on the Common SDK. It includes the capabilities of BT, BLE, and Audio. The host, which is an external MCU, can communicate with BT Audio TRX through the UART interface.
BT Audio Transceiver ACI User Manual
This section of the specification outlines the functional specifications for the ACI. The ACI offers a standardized command method for the Host to access the capabilities of the Device and control connections to other Devices. The commands and events are exchanged between the Host and the Device.
BT Audio Transceiver Design Spec
This article focuses on the design specifications of BT Audio TRX. Its purpose is to assist developers in comprehending the code flow of the application in a simple and comprehensive manner.
DTM User Manual
The purpose of this document is to provide an overview of DTM. DTM is utilized for testing the RF PHY layer of Bluetooth low-energy devices. It enables control of the DUT and generates a report to the Tester. DTM can be set up using either the HCI interface or a 2-wire UART interface, both of which are alternative methods. Each DUT is required to implement one of these two DTM methods.
BT HID Demo Application Note
The purpose of this document is to provide an overview of the HID Demo application. The HID Demo project offers a simple example of how to use HID. This project specifically implements the HID mouse device role.
BT MAP Demo Application Note
The purpose of this document is to provide an overview of the BT MAP Demo application. The BT MAP Demo project offers a simple example of how to use MAP. This project specifically implements the MAP MCE role.
PBAP Demo Application Note
The purpose of this document is to provide an overview of the PBAP Demo application. The PBAP Demo project offers a simple example of how to use PBAP. This project specifically implements the client role for PBAP.
iAP Demo Application Note
The purpose of this document is to provide an overview of the iAP Demo application. The iAP Demo project offers a simple example of how to use iAP. This project specifically implements the accessory role for iAP.
LE Audio Sample Project Application Note
The purpose of this document is to provide an overview of the LE Audio Demo application. CAP defines the roles of Acceptor, Initiator, and Commander.
The Acceptor application implements a basic LEA CAP Acceptor device and it can be used as a framework to develop various CAP acceptor-role based applications.
The Commander application implements a basic LEA CAP Commander device and it can be used as a framework to develop various CAP commander-role based applications.
The Initiator application implements a basic LEA CAP Initiator device and it can be used as a framework to develop various CAP initiator-role based applications.
OTA Application Note
OTA represents the technology that applies Bluetooth to update images (code and data) that runs in RTL87X3E Flash. RTL87X3E supports two OTA modes for Android and iOS: OTA via BLE (iOS) and OTA via SPP (Android).
SPP Demo Application Note
The purpose of this document is to provide an overview of the SPP and its demo application. The SPP demo project implements a basic SPP application and it can be used as a framework for developing various SPP applications.
Platform Power Test User Manual
This article provides an introduction to measuring platform power consumption, covering supported test scenarios, RCFG and EVB settings, and how to use CMD to measure power consumption. Developers can refer to platform power consumption to evaluate the power consumption of various functions, such as BLE/BT test scenarios. Additionally, developers can use platform power consumption to identify any hardware or app settings issues related to power consumption, such as in static power test scenarios.
USB Audio Demo Application Note
The purpose of this document is to provide an overview of the USB audio application. The USB audio project implements a basic USB audio device.
USB HID Demo Application Note
The purpose of this document is to provide an overview of the USB HID application. The USB HID project implements a basic USB HID device.
Tool
Development Tool
MCU Config Tool User Guide
This article provides an explanation of the functions, usage, and settings of the MCU Config Tool for Realtek Bluetooth Audio Chip. The Realtek Bluetooth MCU offers configurable BT settings and peripheral control. During the development stage, the MCU Config Tool allows users to easily configure various MCU parameters.
The MCU Config Tool organizes the setting elements into different tabs, including HW Feature, Audio Route, General, System Configuration, Charger, Ringtone, RF TX, and more. These configurations will be further described in the following sections.
DSP Config Tool User Guide
This documentation provides detailed guidance on using the GUI to fine-tune the behavior of the DSP FW in the RTL87x3E IC series. The DSP configuration tool allows developers to configure parameters of the built-in signal processing algorithms for voice and audio applications, as well as the hardware peripheral interfaces connected to the DSP core. These interfaces include the ADC, DAC, and I2S.
Additionally, the DSP configuration tool offers user-friendly parameter fine-tuning functions, which can significantly reduce the time required for parameter tuning.
Furthermore, this tool supports the generation of DSP configuration files for the RTL87x3E toolchain, which includes flash download and mass-production software tools.
MPPG Tool User Guide
MPPG Tool supports flash programming for RTL87XX series chips. There are two modes available for downloading images to the chip. The MP Mode is used for factory mass production purposes, while the RD Mode is intended for factory R&D to perform debugging operations related to image downloading to the chip.
Debug Analyzer User Guide
DebugAnalyzer is a tool utilized for capturing and decoding logs from the Realtek Bluetooth SoC chip. This document provides comprehensive instructions on how to configure and utilize the tool effectively.
BT Audio Transceiver AciHostCLI Tool
AciHostCLI is a test tool that runs on a PC and is designed to demonstrate the usage of ACI. It enables the execution of cmd/event communication tests with an ACI Device through a USB serial port.
RF Test and Certification Tool and MP Tool
RF Test and Certification Tool
This document provides instructions on how to establish the testing environment for the RTL87x3E RF. It covers various test modes specified in the BT specification, as well as the single-tone test mode. The guide is applicable to the entire RTL87x3E chip series. Additionally, this tool can assist in conducting certification tests for FCC, BQB, CE, SRRC, KC, and others. In case any issues arise during the test, please reach out to the Realtek Bluetooth FAE for further assistance.
MP Tool
This document introduces and provides Realtek’s mass production solution for the RTL87x3E MP. It covers the MP flow and test items included in this MP solution. The guide is applicable to the entire RTL87x3E chip series. In case any issues arise during the test, please reach out to the Realtek Bluetooth FAE for further assistance.
Mobile Application Development Kit
iOS OTA APP User Manual
This user manual provides instructions for updating the application through OTA using an iOS device.
iOS Audio Connect User Manual
Audio Connect is an application designed for controlling Realtek Bluetooth earphones/headsets. It offers several features including OTA updates, RHE function, Equalizer function, TTS, and various configuration options such as changing the name, language, and channel. The application is compatible with iOS 8.0 and later versions.
Android OTA APP User Manual
This user manual provides instructions for updating the application through OTA using an Android device.
Android Audio Connect App User Guide
The Audio Connect app is specifically designed to cater to the production needs of Realtek RTL87XX SoC. It offers a range of features including TTS, OTA updates, Equalizer function, and allows for configuring various settings such as changing the device name. These features can be accessed after establishing a connection with an RTL87XX product.
RTL87x3E SoC Platform Guide
Hardware Instruction
This document provides detailed information about the various hardware components that make up the EVB. It covers the mechanisms and functionalities of components such as the flash, microphone, and antenna. Additionally, the document includes various schematic diagrams to aid in understanding these details.
Evaluation Board User Manual
This document serves as an introduction to the hardware of the Evaluation Board. It provides essential information such as explaining the board’s interface, power supply mechanism, various IO ports, and pin allocation. Additionally, it also includes information about the design aspects of the board itself.
RTL87x3E Qualification
This document provides a comprehensive guide on how to efficiently qualify and list products based on existing Realtek RTL8763ESE/RTL8763EAU/RTL8763EWM/RTL8763EFL/RTL8773ESL/RTL8763EW-VC/RTL8763EWE-VP/RTL8763EWE qualified designs. It outlines the essential aspects that developers need to monitor in order to ensure their products are eligible to display the Bluetooth® Logo. By following this guide, developers can streamline the qualification process and increase the chances of their products being recognized with the Bluetooth® Logo.