IS2083 SDK Debugger User's Guide

1.1. Reference Documentation

Please visit http://www.microchip.com/IS2083 or http://www.microchip.com/BM83 to access the following documents:

• IS2083 Bluetooth® Stereo Audio SoC Data Sheet
• BM83 Bluetooth® Stereo Audio Module Data Sheet
• BM83 Bluetooth® Audio Development Board User's Guide
• IS2083 SDK User's Guide

1.2. Software Prerequisites

• IS2083 Software Development Kit
• isUpdate tool

Refer to the IS2083 SDK User's Guide, Section 1.2, for the recommended Keil® µVision® version. Ensure your PK51 license is valid and within its support period. If the license expires on or before the support period, Keil C51 may restrict debugger usage. For example, if C51 9.59 (released May 2018) is used and your license expired before May 2018, debugger support will be unavailable. If the license expired after May 2018, support remains available.

The following DLL files are required for debugging the IS2083BM using Keil µVision:

• JLinkARM.dll
• JLinkIS2083.dll

The Initsession.ini file is used to stop Keil µVision at the first execution of the SDK. Note: These DLL files and Initsession.ini are available in the release package at http://www.microchip.com/IS2083 or http://www.microchip.com/BM83.

Additionally, J-Link Commander (found in the folder path: \Software\Debugger Support\Commander) can be used to verify if J-Link probes can communicate with the IS2083BM via an executable command prompt.

1.3. Hardware Prerequisites

• SEGGER J-Link Debug Probe

Figure 1-1. J-Link Debug Probe: A black SEGGER J-Link debug probe device with "j-link" branding, USB and LAN ports, and a multi-pin "Target" connector.

Supported J-Link models include J-Link PRO, J-Link ULTRA+, J-Link PLUS, and J-Link BASE.

• BM83 EVB (Evaluation Board)

The BM83 EVB provides a two-wire JTAG interface for communication with the IS2083BM.

• J-Link 6-pin adapter from Microchip

Figure 1-2. J-Link 6-pin Adapter: A small printed circuit board adapter with a 6-pin connector on one end and a larger connector on the other, labeled "J-Link Pan Adapter V1.0" and "MICROCHIP".

2.1. Keil µVision Setup

This section details the step-by-step procedure for setting up Keil µVision. Users must first configure µVision and connect to J-Link debug probes, then to the BM83 EVB. Refer to Section 3.1 for J-Link Probes Connection.

2.2. SDK Settings

The 2-wire JTAG debug port (pins P1_2 and P1_3) on the IS2083BM is multiplexed with the I2C function. Before debugging, the user must enable the build option ENABLE_JTAG_DEBUG. This option enables SW I2C and disables Low Power mode, allowing the debugger to run correctly. Users can select the MSPKv2_App_MSPK_Debug project target, which includes the ENABLE_JTAG_DEBUG build option.

ENABLE_JTAG_DEBUG uses the SW I2C port (pins P2_3 and P2_6 by default) instead of the HW I2C. The SDK enables Low Power mode, which turns off the debugger clock and disconnects the debugger. ENABLE_JTAG_DEBUG is used to disable Low Power mode to prevent this. Refer to the IS2083 Bluetooth® Stereo Audio SoC Data Sheet for more details on JTAG program and debug features.

For information on which SDK features are included in the MSPKv2_App_MSPK_Debug project, see the IS2083 SDK User's Guide, Section 2.2, and Table 2-1.

Figure 2-6. Target Build: A screenshot of the Keil µVision IDE, showing the project tree with various target builds, highlighting "MSPKv2_App_MSPK_Debug."

3.1. J-Link Probes Connection

SEGGER J-Link debug probes can be used with Keil µVision for software debugging and downloading on the IS2083BM.

Perform the following steps:

Case 1 – Connecting J-Link Probes to BM83 EVB

Connect the J-Link, BM83 EVB, and 6-pin adapter as shown in the following figures.

Figure 3-1. J-Link Probes to BM83 EVB Connection: A photograph showing a SEGGER J-Link debug probe connected via a 6-pin adapter to a Microchip BM83 Bluetooth Audio Development Board (EVB).

Ensure correct orientation when inserting the 6-pin adapter to a BM83 EVB.

Figure 3-2. 6-pin Adapter Connection: A close-up photograph of the 6-pin adapter connected to the BM83 EVB, showing specific pin headers and jumper locations (JP307, JP308). It also shows a schematic of the BM83 board with pin labels.

Note: Be sure to unplug jumpers in-between JP307 and JP308 so the HW-I2C interface will not be used.

To use Embedded mode, connect P2_6 of JP309 to P1_3 of JP402, and P2_3 of JP309 to P1_2 of JP402. This allows the IS2083BM to communicate with the ST codec over SW I2C.

Figure 3-3. RST_N Connection to BM83 Module: A close-up photograph showing the RST_N connection on the BM83 EVB, highlighting the connection to a specific pin header.

Ensure that RST_N of SW402 on the BM83 EVB is connected to the BM83 module. J-Link uses this pin to reset the debugger.

Case 2 – Connecting J-Link Probes to application board with IS2083BM

Figure 3-4. J-Link 6-pins connector schematic: A schematic diagram illustrating the 6-pin connector for the J-Link, showing pin assignments like RESET, TDI, TCK, and GND, connected to a capacitor and 3V3_IO.

Connect the following pins from your board to the 6-pin connector:

4.1. Enabling Debug Mode

The SEGGER J-Link debugger downloads the 8051 image and automatically updates the Flash header in the IS2083BM. Pre-program the IS2083BM device with voice prompt, UI Config, and DSP images before using the debugger. It is recommended to pre-program with the demo package, which contains the following files:

• Embedded mode – Demo_Package_Embedded_Mode_RTP.hex
• Host mode – Demo_Package_MCU_Mode_RTP.hex

Choose one of these files according to your desired application mode. Refer to the BM83 Bluetooth® Audio Development Board User's Guide for instructions on downloading the image with tools.

Perform the following steps to enable Debugging mode:

1. In the Keil µVision tool, select and build "MSPKv2_App_MSPK_debug".
2. Click the [play/debug icon] or navigate to Debug > Start/Stop Debug Session for debugging. Keil µVision uses the DLL files to communicate with the IS2083BM and access Flash. J-Link checks for the Flash header and downloads the compiled 8051 images to the correct bank.
3. After Flash, the program counter stops at 0x27_0000, which is the Application_Init function. This is the first function where the application code can execute.

During debugging, the 8051 MCU will halt once the program counter hits a breakpoint. Program ROM is suspended, and the Bluetooth connection is dropped simultaneously.

Figure 4-1. Application_Init: A screenshot showing the Keil µVision IDE's disassembly view and C code editor, highlighting the Application_Init function and related disassembly lines.

The following example shows how to add a breakpoint in the App_init function. When the user runs the debugger, it stops at line 94. Keil µVision provides the local variables of APP_init on the right-hand side. The user can investigate global variables using the Watch window.

Figure 4-2. Watch Window: A screenshot of the Keil µVision IDE's "Watch Window", displaying local variables and their values within the APP_init function.

The Microchip Website

Microchip provides online support via its website at http://www.microchip.com/. This site offers easy access to files and information for customers. Available content includes:

• Product Support: Data sheets, errata, application notes, sample programs, design resources, user's guides, hardware support documents, and software releases.
• General Technical Support: Frequently Asked Questions (FAQs), technical support requests, online discussion groups, and a Microchip design partner program member listing.
• Business of Microchip: Product selector and ordering guides, press releases, seminar and event listings, and sales office/distributor information.

Product Change Notification Service

Microchip's product change notification service keeps customers updated on Microchip products. Subscribers receive email notifications for changes, updates, revisions, or errata related to specified product families or development tools. To register, visit http://www.microchip.com/pcn and follow the registration instructions.

Customer Support

Users can receive assistance through several channels:

• Distributor or Representative
• Local Sales Office
• Embedded Solutions Engineer (ESE)
• Technical Support

Customers should contact their distributor, representative, or ESE for support. Local sales offices are also available. Technical support is accessible via the website: http://www.microchip.com/support.

Microchip Devices Code Protection Feature

Details of the code protection feature on Microchip devices:

• Microchip products comply with specifications in their respective Microchip Data Sheets.
• Microchip believes its product family is among the most secure available when used as intended under normal conditions.
• Dishonest or illegal methods to breach code protection typically involve using products outside their operating specifications, potentially constituting intellectual property theft.
• Microchip collaborates with customers concerned about code integrity.
• No semiconductor manufacturer can guarantee absolute code security; code protection does not imply the product is "unbreakable."

Code protection is continuously evolving. Microchip is committed to improving these features. Attempts to break code protection may violate the Digital Millennium Copyright Act, potentially allowing legal action for unauthorized access to copyrighted work.

Legal Notice

Information regarding device applications is provided for convenience and may be superseded by updates. Users are responsible for ensuring their applications meet specifications. MICROCHIP MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND, EXPRESS OR IMPLIED, STATUTORY OR OTHERWISE, RELATED TO THE INFORMATION, INCLUDING ITS CONDITION, QUALITY, PERFORMANCE, MERCHANTABILITY, OR FITNESS FOR PURPOSE. Microchip disclaims all liability arising from this information and its use. Use of Microchip devices in life support and/or safety applications is at the buyer's risk. Buyers agree to defend, indemnify, and hold Microchip harmless from any damages, claims, or expenses resulting from such use. No licenses are conveyed under Microchip intellectual property rights unless otherwise stated.

Trademarks

The Microchip name and logo, Adaptec, AnyRate, AVR, AVR Freaks, BesTime, BitCloud, chipKIT, CryptoMemory, CryptoRF, dsPIC, FlashFlex, flexPWR, HELDO, IGLOO, JukeBlox, KeeLoq, Kleer, LANCheck, LinkMD, maXStylus, maXTouch, MediaLB, megaAVR, Microsemi, MOST, MPLAB, OptoLyzer, PackeTime, PIC, picoPower, PICSTART, PIC32, PolarFire, Prochip Designer, QTouch, SAM-BA, SenGenuity, SpyNIC, SST, SuperFlash, Symmetricom, SyncServer, Tachyon, TempTrackr, TimeSource, tinyAVR, UNI/O, Vectron, and XMEGA are registered trademarks of Microchip Technology Incorporated in the U.S.A. and other countries.

APT, ClockWorks, The Embedded Control Solutions Company, EtherSynch, FlashTec, Hyper Speed Control, HyperLight Load, IntelliMOS, Libero, motorBench, mTouch, Powermite 3, Precision Edge, ProASIC, ProASIC Plus, Quiet-Wire, SmartFusion, SyncWorld, Temux, TimeCesium, TimeHub, TimePictra, TimeProvider, Vite, WinPath, and ZL are registered trademarks of Microchip Technology Incorporated in the U.S.A.

Adjacent Key Suppression, AKS, Analog-for-the-Digital Age, Any Capacitor, AnyIn, AnyOut, BlueSky, BodyCom, CodeGuard, CryptoAuthentication, CryptoAutomotive, CryptoCompanion, CryptoController, dsPICDEM, dsPICDEM.net, Dynamic Average Matching, DAM, ECAN, EtherGREEN, In-Circuit Serial Programming, ICSP, INICnet, Inter-Chip Connectivity, JitterBlocker, KleerNet, memBrain, Mindi, MiWi, MPASM, MPF, MPLAB Certified logo, MPLIB, MPLINK, MultiTRAK, NetDetach, Omniscient Code Generation, PICDEM, PICDEM.net, PICkit, PICtail, PowerSmart, PureSilicon, QMatrix, REAL ICE, Ripple Blocker, SAM-ICE, Serial Quad I/O, SMART-I.S., SQI, SuperSwitcher, SuperSwitcher II, Total Endurance, TSHARC, USBCheck, VariSense, ViewSpan, WiperLock, Wireless DNA, and ZENA are trademarks of Microchip Technology Incorporated in the U.S.A. and other countries.

SQTP is a service mark of Microchip Technology Incorporated in the U.S.A.

The Adaptec logo, Frequency on Demand, Silicon Storage Technology, and Symmcom are registered trademarks of Microchip Technology Inc. in other countries.

GestIC is a registered trademark of Microchip Technology Germany II GmbH & Co. KG, a subsidiary of Microchip Technology Inc., in other countries.

All other trademarks mentioned herein are property of their respective companies.

© 2019, Microchip Technology Incorporated, Printed in the U.S.A., All Rights Reserved. ISBN: 978-1-5224-4805-1

Quality Management System

For information regarding Microchip's Quality Management Systems, please visit http://www.microchip.com/quality.