Eclipse Plugin for

µC/Probe

Quick Start Guide

Chapter

1 Eclipse Plugin for μC/Probe

   The Eclipse plugin for μC/Probe was developed to integrate μC/Probe with Eclipse remotely. μC/Probe will use TCP/IP to connect to the server running on this plugin. It will then interact with the Eclipse debugger to get symbol data. In other words, the Eclipse plugin works as a proxy. This document describes how to install the plugin in your Eclipse-based IDE and how to configure it in μC/Probe. There are two critical components to this plugin: interactions with μC/Probe, and interactions with your program, wherever it may be running. Interaction with μC/Probe is always the same: TCP/IP is used. Interaction with the target may vary:  

Connection Type

Advantages Disadvantages

Eclipse GDB Debugger

Actual connection to the program handled by vendor IDE

Allows analysis of programs not actually running on real hardware yet

No way to get real-time analysis. Debugger must be halted to read data

J-Link Allows proxy to read real time data from a target

More overhead and setup: essentially replicates μC/Probe's J-Link connection. Only really useful if μC/Probe is being used remotely.

The μC/Probe Proxy Plugin suite is a set of plugins. You install only what you need.         

1-1 µ

1-1-1 This instalittle userthe “Insta This tutotutorial, h Load up find the c 

INSTALµC/PRO

Autom

allation techr interventioall New Softw

orial will go however, are

your Eclipsechoice 'Insta

LLING TOBE

matic In

nique is then. It only reware” option

through aute applicable

e IDE of choall New Softw

THE EC

nstallat

e simplest toequires that tns in the Hel

tomatic instato a basic Ec

oice. In this ware' as show

CLIPSE

tion (p2

use as it is the vendor op menu.

allation in Rclipse installa

case, we lown in the figu

E PLUG

2 updat

done directof the Eclips

Renesas e2stuation.

oad e2studioure below:

IN FOR

te site)

tly from Eclise based IDE

udio. The in

o. Go to the

Figure 1-

R

)

ipse and reqE did not di

nstructions i

'Help' menu

1 Eclipse Help

quires isable

n the

u and

p Menu

You will

You will

be brought

want to click

to the follow

k the "Add.

wing screen:

. ." button an

nd create a n

Figure

new update

1-2 Eclipse So

site.

oftware Update

e Sites

Point thefollowing 

You will μC/Probeyour speEclipse-bas well a

e new updag figure:

now see a le Proxy will cific version

based IDE's us a valid J-Li

ate site to  w

list of pluginbe under th

n of Eclipse. using the CDink DLL.

www.micrium

ns. There mahe category Currently, t

DT debugger

m.com/probe/

ay be more in

"Micriμm μthe Debugger. J-Link dep

/p2_eclipse/p

n the futureμC/Probe". Seer Services F

pends on hav

probeproxy  a

Figure 1-3 Ecl

, but all plugelect the oneFramework ving a wind

as shown in

lipse Add Repo

gins pertainies that pertaworks with ows environ

n the

ository

ing to ain to most

nment

 If everyt'Troublesagreemen   

thing goes shooting Autnts to install

well, there tomatic Instathe plugins.

should beallation' part

e no depent of this pag

Figure 1-4 Ec

ndency confge. Click ne

clipse Availabl

flicts. If theext and agre

le Software Up

ere are, seeee to the Lic

pdates

e the cense

1-1-2 Troubleshooting the Automatic Installation If there is a dependency conflict, start by installing the features one by one. Start with the Core (Main) then, move to DSF. As long as at least those two install, you should be able to use the proxy. Bug reports should be sent to plugins@micrium.com

Feature Error Solution

Main (μC/Probe Proxy)

Any Send a bug report. The core should depend only on Eclipse itself and not any third party components.

Debugger Services Framework Communication

Unable to resolve dependency for CDT. . .

Uninstall the CDT Framework and re-install it. This is sometimes caused by an outdated CDT Framework, and should only be occurring on regular Eclipse IDEs.

Direct J-Link Any Send a bug report. J-Link depends on third party plugins but it supplies them itself.

1-2 U

1-2-1 The Eclipto Windo

When yoserver cstraightfonumber anot alreadμC/Probewill send The memthe archit But whatto ensure

USING T

Config

pse plugin foow-Preferenc

ou have reachconfigurationorward, saveand start thedy in use) the. When it red dummy res

mory addresstecture of th

t about the ime the proxy a

THE EC

guring t

or μC/Probe ces and selec

hed the prefn, and the for selectin

e server. Assuhe server wileceives themponses until

s size and ene target syste

mplementatiand μC/Prob

CLIPSE

the Ecl

will create act μC/Probe

ferences pag implemen

ng endianneuming that tll start. At thim it will serv it can.

ndianness ofem. Most sys

on? Setting ube talk. We n

E PLUG

ipse Pl

a single locatProxy Prefer

ge for μC/Prontation selecss and memthe selected is point it wive them imm

f the system stems use 32

up the servernow need to

IN FOR

lugin

tion where yrences (towa

obe Proxy, yction. Serve

mory addressport is validill now be w

mediately ins

will need to2 bit addressi

r and TCP/IPensure the p

R µC/PR

you can edit ards the botto

Figure 1-5

you have twoer configurs size. You d (not a wellwaiting for Ustead of que

o be determing, and Littl

P in μC/Probproxy and th

ROBE

it's settings. om)

5 Eclipse Plug

o main areasration is mcan enter a

l known porUDP requests euing; if it ca

mined by knole Endian.

be is only enhe debugger

Go

in GUI

s: The mostly a port rt and from an't it

owing

nough talk.

GenerallyEclipse Cadvantagweaknessvalues ca Once youup the μwill trans  

1-2-2 You will for Probego to Sett  

And clickproxy demake suron the sathe IP ad

y, we suggeCDT IDEs (ee of automs is lack of annot be read

u have set uC/Probe wo

slate comman

2 Conf

need to set e to run on atings:

k on the TCPefaults to μCre you specifame machineddress of you

est selecting even the ba

matically readreal-time an

d from the d

up the proxyorkspace, andnds, fulfill th

iguring

up μC/Probea different m

P/IP connectC/Probe's deffy it here). Te as the proxur machine w

Debugger asic one dowding whatevnalysis, as thdebugger.

y for both yod whenever

he request, an

g µC/P

e to use the machine as yo

tion type. Sufault, but if

Then supply xy, type 127with Eclipse a

Services Frawnloadable ver programhe program

our program μC/Probe r

nd send μC/

Probe

proxy. Becaour Eclipse in

upply to it thyou changethe IP addre.0.0.1, otherwand supply i

amework. Itfrom the Ec

m is currentlymust be su

and μC/Proruns, it will /Probe back

ause this is pnstallation w

he port you ed it in the pess of the prowise with eiit here.

Figure 1-6

t is supporteclipse websy being deb

uspended in

obe, all that italk to the psome data.

proxy, it is enwith the prox

Figure 1

have the seproxy configoxy. If you aither ipconfig

6 Eclipse Plug

ed on almoite!) and habugged. Its the debugg

is left to do proxy. The p

ntirely possibxy. In μC/Pro

1-7 µC/Probe T

erver runningguration winare running pg or ifconfig

in GUI

ost all as the

only ger or

is set proxy

ble obe,

oolbar

g (the ndow, probe g, find

μC/Probesupport tto the sathe instrube able to

  1-3 D

This is ththe DSF serves reany way.unavailabknown vMost debbreakpoito updateThere is target.

e is now settransferring tme elf file thuction manuao connect to

Debugg

he most basiFramework quests from If it can, it

ble, it will realue, it will sbuggers tendnt. As such, e values durino special c

t up. The prthe .elf file ohat the Eclipal and tutori

o it.

ger Serv

ic implemen(such as thμC/Probe, iwill update ead from it'ssend back ald only to bit can be as

ing step-throonfiguration

oxy is now over TCP/IP,pse debuggeials for μC/P

vices F

ntation, and he CDT debuit will ask tha temporarys cache and ll zeros. be able to rssumed that ough. n to use the D

set up. Unfo so you will

er generated.robe. As lon

Framew

also the mougger) can w

he debugger y cache and

send back

read data winstalling th

DSF impleme

Figure 1-8 Ec

fortunately, μl have to ma. From here ng as the ser

work (D

ost portable. work with tif it can cursend a respothe last kno

whilst the prhis plugin alo

entation. Sim

clipse Availabl

μC/Probe's pake sure μC/you can use

rver is runnin

SF)

Any debuggthis implemerrently get thonse back. Iown value. I

rogram is stone will only

mply select it

le Software Up

protocol doe/Probe has ae μC/Probe: ng, μC/Probe

ger implemeentation. Whhat informatiIf the debuggIf there is no

topped and y allow μC/P

t and debug

pdates

es not access

refer e will

enting hen it ion in ger is o last

at a Probe

g your

1-4 D

This impltime, andcan be inconfigurasupport ocompleteIt comes "μC/Probvisible or 

The intercomputer Once theof the sta

Direct J

lementation d only depennstalled on aation, the seonly for Wi

ely different fwith it's ow

be Proxy Prer the preferen

rface is pretr select only

e server is staate of the deb

J-Link

bypasses thends on havinany Eclipse egregation frndows J-Linfrom what is

wn preferenceeferences" annce window

tty basic; chone. You ca

arted the plubugger.

e debugger ng a J-Link libplatform. Throm the debnk dlls. It is s currently bee window thnd selecting

w is not listed

oose the dllannot select

ugin will star

completely abrary file anhis comes wbugger mean

possible foeing debugghat can be a"J-Link Con

d then this pl

l and then ia .so linux f

rt communic

and talks to Jnd not anythiwith the pricens that it isor it to grabged, so it is imaccessed by cnnection Optlugin was no

Fig

if multiple dfile, as this o

cating with J

J-Link directing integratee of a slights no longer b data from mportant to clicking the tions". If theot installed.  

gure 1-9 Eclipse

devices are only works o

J-Link immed

tly. It is fullyed in Eclipse,tly more invoas intuitivea running tbe careful. plus sign ne

e plus sign i

e Plugin Prefer

connected tn Windows.

diately, regar

y real-, so it olved , and target

ext to is not

rences

o the

rdless

1-5 Troubleshooting

Q: The value of this variable is '1', but μC/Probe shows some gigantic number. Numbers aren't making sense! A: Ensure that both μC/Probe and the proxy are set to the same endianness, and that the endianness matches your target. This is caused when μC/Probe misunderstands the endianness of the values the proxy sends, which can cause it to interpret values in the wrong byte order, leading to erroneous results.