Download - Eclipse Plugin for uC/Probe - Micrium
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 [email protected]
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.