Difference between revisions of "IS2083 Getting Started"

From SEGGER Wiki
Jump to: navigation, search
(Created page with "__TOC__ == Setup == * Download and install Keil PK51 tools V9.59 [https://download.segger.com/Alex/tmp/BT5511/JLinkBT5511_Package.zip Download] * Download the J-Link package...")
 
(Setup)
 
(68 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 =
== Setup ==
 
  +
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 =
* Download and install Keil PK51 tools V9.59 [https://download.segger.com/Alex/tmp/BT5511/JLinkBT5511_Package.zip Download]
 
  +
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:
* Download the J-Link package: [https://www.segger.com/downloads/jlink/#J-LinkSoftwareAndDocumentationPack Download]
 
  +
* RESET (mandatory to enable 2-wire JTAG protocol on the IS2083)
* Go to Keil installation directory
 
  +
* 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.
<Screenshot Explorer> AG xxxxxxxxxxxxxxxxxx (pic)
 
[[File:Example.png|none]]
 
   
  +
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.
* Replace the TOOLS.INI in the Keil directory with the one from the J-Link package
 
* Navigate to BIN\
 
   
<Screenshot Explorer> AG xxxxxxxxxxxxxxxxxx (pic)
 
[[File:Example.png|none]]
 
 
* Copy the following files from the J-Link package to this directory:
 
** JLinkBT5511.dll
 
** JLinkARM.dll
 
 
== Connect to J-Link ==
 
 
* Connect a J-Link BASE / PLUS to the PC (HW V10, see label on the back side)
 
* Wait until the green LED becomes steady and stops blinking
 
* Download the uVision test project: [https://download.segger.com/Alex/tmp/BT5511/JLink_TestProject.zip Download]
 
* Open the uVision test project
 
* Go to the project options
 
* Verify that your options look like as follows:
 
AG xxxxxxxxxxxxxxxxxxxx <Pics>
 
[[File:Example.png|none]]
 
 
* Connect your target HW to J-Link via 2-wire JTAG (VTref, GND, RESET, TCK, TDI) as follows:
 
* Wiring:
 
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
 
! J301 pin !! J-Link pin
 
! J301 pin !! J-Link pin
 
|-
 
|-
| 1 || 15 (RESET)
+
| 1 || 15 (RESET, blue)
 
|-
 
|-
| 2 || 1 (VTref)
+
| 2 || 1 (VTref, red)
 
|-
 
|-
| 3 || 4 (GND)
+
| 3 || 4 (GND, black)
 
|-
 
|-
| 4 || 5 (TDI)
+
| 4 || 5 (TDI, green)
 
|-
 
|-
| 5 || 9 (TCK)
+
| 5 || 9 (TCK, yellow)
 
|}
 
|}
   
  +
[[File:BT5511_BoardConnector.png|none]]
* Start a debug session by clicking the <PiC> symbol (Ctrl + F5)
 
  +
* 2-wire JTAG is the default selection for a J-Link BT5511 project
 
  +
= Verifying connection with J-Link Commander =
* You will be asked if you want to update the firmware of the connected J-Link. Select <b>YES</b>.
 
  +
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 =
  +
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: [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:
  +
** JLinkIS2083.dll
  +
** JLinkARM.dll [[File:KeilPK51_BINDir_After.png|none]]
  +
  +
== 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: [[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]]
  +
* '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]
  +
* Rebuild the application (Project -> Rebuild all target files)
  +
* Start a debug session by clicking the "debug" symbol (Ctrl + F5)<sup>1</sup>
 
* 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.