Difference between revisions of "IS2083 Getting Started"

From SEGGER Wiki
Jump to: navigation, search
(Setup)
 
(65 intermediate revisions by 3 users not shown)
Line 1: Line 1:
  +
The IS2083 series is an 8051 based device from Microchip that is designed for low power Bluetooth applications.
  +
 
__TOC__
 
__TOC__
   
  +
= J-Link support =
== Debugging with Keil PK51 tools ==
 
  +
J-Link supports the Microchip IS2083 series devices. For an overview which min. hardware of J-Link is required for support, please refer to the [[Software and Hardware Features Overview | feature overview]].
   
  +
= Hardware connection to BM83 EVB =
== Video ==
 
  +
J-Link uses the Microchip 2-wire JTAG protocol to communicate with the IS2083 MCU. This protocol specifies the following pins which are all mandatory to connect:
The following shows a short video that demonstrates debugging with J-Link under Keil PK51 tools.
 
  +
* RESET (mandatory to enable 2-wire JTAG protocol on the IS2083)
[[File:KeilPK51_JLinkDebugging.mp4|none]]
 
  +
* VTref (used as reference voltage by J-Link to adapt to different CPU operating voltages)
  +
* GND
  +
* bi-directional data pin
  +
* clock (provided by J-Link)
   
  +
On the BM8x EVB connector J301 is used to connect J-Link to the IS2083 MCU.
   
  +
We recommend to use the [https://www.segger.com/products/debug-probes/j-link/accessories/adapters/microchip-2-wire-jtag-tdi-adapter/ J-Link Microchip 2-Wire JTAG TDI Adapter] to connect J-Link to J301.
== Setup ==
 
   
  +
{| class="wikitable"
* Download and install Keil PK51 tools V9.59 [https://download.segger.com/Alex/tmp/BT5511/KeilPK51_V959.exe Download]
 
  +
|-
* Download the J-Link package: [https://download.segger.com/Alex/tmp/BT5511/JLinkBT5511_Package.zip Download]
 
  +
! J301 pin !! J-Link pin
* Go to Keil installation directory
 
  +
|-
  +
| 1 || 15 (RESET, blue)
  +
|-
  +
| 2 || 1 (VTref, red)
  +
|-
  +
| 3 || 4 (GND, black)
  +
|-
  +
| 4 || 5 (TDI, green)
  +
|-
  +
| 5 || 9 (TCK, yellow)
  +
|}
   
[[File:KeilPK51_InstallDir.png|none]]
+
[[File:BT5511_BoardConnector.png|none]]
* Make sure uVision is <b>NOT</b> started before continuing.
 
* Open TOOLS.INI in text editor and add the following line:
 
<syntaxhighlight lang="text">TDRV10=BIN\JLinkBT5511.dll ("J-Link / J-Trace BT5511 Driver")</syntaxhighlight>
 
   
  +
= Verifying connection with J-Link Commander =
[[File:KeilPK51_ToolsINI_Edit.png|none]]
 
  +
J-Link Commander (JLink.exe from the J-Link package) can be used to verify the connection between J-Link and the IS2083 device.
  +
* Download the J-Link IS2083 package: [[Media:JLink_IS208x_Keil_Package.zip | Download]]
  +
* Start J-Link Commander (JLink.exe)
  +
[[File:BT5511_JLinkCommander.png|none]]
   
  +
= Supported IDEs and debuggers =
* Navigate to BIN\
 
  +
Currently, the IS2083 is only supported in J-Link Commander and Keil uVision for PK51. Other utilities (J-Flash, ...) / IDEs etc. do not support this device series.
   
  +
= Debugging with Keil C51 tools =
[[File:KeilPK51_BINDir.png|none]]
 
   
  +
== Setup ==
  +
  +
* Download and install Keil C51/PK51 tools V9.59 or later: [https://www.keil.com/download/product/ Download]
  +
* Download the latest J-Link software from our website (to make sure that the USB drivers etc. are installed): [https://www.segger.com/downloads/jlink/ Download]
  +
* Download the J-Link IS2083 Keil package: [[Media:JLinkIS2083_6.44.4.zip | JLinkIS2083_6.44.4.zip]]
  +
* Make sure uVision is <b>NOT</b> started before continuing
  +
* Go to Keil installation directory [[File:KeilPK51_InstallDir.png|none]]
  +
* Open TOOLS.INI in text editor and add the following line (if TDRV10 already exists, use the next available number/entry): <syntaxhighlight lang="text">TDRV10=BIN\JLinkIS2083.dll ("J-Link / J-Trace IS2083 Driver")</syntaxhighlight> [[File:KeilPK51_ToolsINI_Edit.png|none]]
  +
  +
* Navigate to BIN\ [[File:KeilPK51_BINDir.png|none]]
 
* Copy the following files from the J-Link package to this directory:
 
* Copy the following files from the J-Link package to this directory:
** JLinkBT5511.dll
+
** JLinkIS2083.dll
** JLinkARM.dll
+
** JLinkARM.dll [[File:KeilPK51_BINDir_After.png|none]]
   
== Connect to J-Link ==
+
== Debug session ==
   
* Connect a J-Link BASE / PLUS to the PC (HW V10, see label on the back side)
+
* Connect to the PC
* Wait until the green LED becomes steady and stops blinking
+
* Wait until the green LED of J-Link becomes steady and stops blinking
  +
* Download the Microchip BM83 SDK application sample project from Microchip
* Download the uVision test project: [https://download.segger.com/Alex/tmp/BT5511/JLink_TestProject.zip Download]
 
  +
* Make sure that you followed the initial preparation steps for the BM83x EVB from Microchip (flashing of initial image + DSP config etc.)
* Open the uVision test project
 
  +
* Open project in uVision
 
* Go to the project options
 
* Go to the project options
 
* Verify that your options look like as follows:
 
* Verify that your options look like as follows:
* 'Device' tab:
+
* 'Device' tab: [[File:KeilPK51_BT5511_Options_Device.png|none]]
[[File:KeilPK51_BT5511_Options_Device.png|none]]
+
* 'Debug' tab: [[File:KeilPK51_BT5511_Options_Debug.png|none]]
  +
* Click on 'Settings' [[File:KeilPK51_BT5511_Options_Debug_Use.png|none]]
* 'Debug' tab:
 
[[File:KeilPK51_BT5511_Options_Debug.png|none]]
+
* 'Settings' dialog [[File:KeilPK51_BT5511_Options_JLink.png|none]]
  +
* Connect your target HW to J-Link via [https://www.segger.com/products/debug-probes/j-link/accessories/adapters/microchip-2-wire-jtag-tdi-adapter/ J-Link Microchip 2-wire JTAG TDI adapter]
* Click on 'Settings'
 
  +
* Rebuild the application (Project -> Rebuild all target files)
[[File:KeilPK51_BT5511_Options_Debug_Use.png|none]]
 
  +
* Start a debug session by clicking the "debug" symbol (Ctrl + F5)<sup>1</sup>
* 'Settings' dialog
 
[[File:KeilPK51_BT5511_Options_JLink.png|none]]
 
 
* Connect your target HW to J-Link via 2-wire JTAG (VTref, GND, RESET, TCK, TDI) as follows:
 
Wiring:
 
{| class="wikitable"
 
|-
 
! J301 pin !! J-Link pin
 
|-
 
| 1 || 15 (RESET)
 
|-
 
| 2 || 1 (VTref)
 
|-
 
| 3 || 4 (GND)
 
|-
 
| 4 || 5 (TDI)
 
|-
 
| 5 || 9 (TCK)
 
|}
 
* Rebuild your application (Project -> Rebuild all target files)
 
* Start a debug session by clicking the <PiC> symbol (Ctrl + F5)
 
[[File:KeilPK51_PiC_Symbol.png|none]]
 
* 2-wire JTAG is the default selection for a J-Link BT5511 project
 
* You will be asked if you want to update the firmware of the connected J-Link. Select <b>YES</b>.
 
 
* Happy debugging!
 
* Happy debugging!
  +
<sup>1</sup> If you are asked if you want to update the J-Link firmware, please hit <b>YES</b>.

Latest revision as of 11:04, 6 August 2019

The IS2083 series is an 8051 based device from Microchip that is designed for low power Bluetooth applications.

J-Link support

J-Link supports the Microchip IS2083 series devices. For an overview which min. hardware of J-Link is required for support, please refer to the feature overview.

Hardware connection to BM83 EVB

J-Link uses the Microchip 2-wire JTAG protocol to communicate with the IS2083 MCU. This protocol specifies the following pins which are all mandatory to connect:

  • RESET (mandatory to enable 2-wire JTAG protocol on the IS2083)
  • VTref (used as reference voltage by J-Link to adapt to different CPU operating voltages)
  • GND
  • bi-directional data pin
  • clock (provided by J-Link)

On the BM8x EVB connector J301 is used to connect J-Link to the IS2083 MCU.

We recommend to use the J-Link Microchip 2-Wire JTAG TDI Adapter to connect J-Link to J301.

J301 pin J-Link pin
1 15 (RESET, blue)
2 1 (VTref, red)
3 4 (GND, black)
4 5 (TDI, green)
5 9 (TCK, yellow)
BT5511 BoardConnector.png

Verifying connection with J-Link Commander

J-Link Commander (JLink.exe from the J-Link package) can be used to verify the connection between J-Link and the IS2083 device.

  • Download the J-Link IS2083 package: Download
  • Start J-Link Commander (JLink.exe)
BT5511 JLinkCommander.png

Supported IDEs and debuggers

Currently, the IS2083 is only supported in J-Link Commander and Keil uVision for PK51. Other utilities (J-Flash, ...) / IDEs etc. do not support this device series.

Debugging with Keil C51 tools

Setup

  • Download and install Keil C51/PK51 tools V9.59 or later: Download
  • Download the latest J-Link software from our website (to make sure that the USB drivers etc. are installed): Download
  • Download the J-Link IS2083 Keil package: JLinkIS2083_6.44.4.zip
  • Make sure uVision is NOT started before continuing
  • Go to Keil installation directory
    KeilPK51 InstallDir.png
  • Open TOOLS.INI in text editor and add the following line (if TDRV10 already exists, use the next available number/entry):
    TDRV10=BIN\JLinkIS2083.dll ("J-Link / J-Trace IS2083 Driver")
    
    KeilPK51 ToolsINI Edit.png
  • Navigate to BIN\
    KeilPK51 BINDir.png
  • Copy the following files from the J-Link package to this directory:
    • JLinkIS2083.dll
    • JLinkARM.dll
      KeilPK51 BINDir After.png

Debug session

  • Connect to the PC
  • Wait until the green LED of J-Link becomes steady and stops blinking
  • Download the Microchip BM83 SDK application sample project from Microchip
  • Make sure that you followed the initial preparation steps for the BM83x EVB from Microchip (flashing of initial image + DSP config etc.)
  • Open project in uVision
  • Go to the project options
  • Verify that your options look like as follows:
  • 'Device' tab:
    KeilPK51 BT5511 Options Device.png
  • 'Debug' tab:
    KeilPK51 BT5511 Options Debug.png
  • Click on 'Settings'
    KeilPK51 BT5511 Options Debug Use.png
  • 'Settings' dialog
    KeilPK51 BT5511 Options JLink.png
  • Connect your target HW to J-Link via J-Link Microchip 2-wire JTAG TDI adapter
  • Rebuild the application (Project -> Rebuild all target files)
  • Start a debug session by clicking the "debug" symbol (Ctrl + F5)1
  • Happy debugging!

1 If you are asked if you want to update the J-Link firmware, please hit YES.