Abatron BDI2000 User Manual

Manual is about: JTAG debug interface for GNU Debugger PowerPC 7440 / 7450 / 86xx

Summary of BDI2000

  • Page 1

    Bdi gdb jtag debug interface for gnu debugger pa6t user manual manual version 1.00 for bdi2000 ©1997-2008 by abatron ag.

  • Page 2

    Bdi gdb for bdi2000 (pa6t) user manual 2 © copyright 1997-2008 by abatron ag switzerland v 1.00 1 introduction ................................................................................................................................. 3 1.1 bdi2000.................................................

  • Page 3

    Bdi gdb for bdi2000 (pa6t) user manual 3 © copyright 1997-2008 by abatron ag switzerland v 1.00 1 introduction bdigdb enhances the gnu debugger (gdb), with jtag/cop debugging for p.A. Semi pa6t based targets. With the built-in ethernet interface you get a very fast code download speed. No target com...

  • Page 4

    Bdi gdb for bdi2000 (pa6t) user manual 4 © copyright 1997-2008 by abatron ag switzerland v 1.00 1.2 bdi configuration as an initial setup, the ip address of the bdi2000, the ip address of the host with the configuration file and the name of the configuration file is stored within the flash of the bd...

  • Page 5

    Bdi gdb for bdi2000 (pa6t) user manual 5 © copyright 1997-2008 by abatron ag switzerland v 1.00 2 installation 2.1 connecting the bdi2000 to target the cable to the target system is a 16 pin flat ribbon cable. In case where the target system has an appropriate connector, the cable can be directly co...

  • Page 6

    Bdi gdb for bdi2000 (pa6t) user manual 6 © copyright 1997-2008 by abatron ag switzerland v 1.00 bdi target b connector signals: pin name describtion 1 tdo jtag test data out this input to the bdi2000 connects to the target tdo pin. 2 3 tdi jtag test data in this output of the bdi2000 connects to the...

  • Page 7

    Bdi gdb for bdi2000 (pa6t) user manual 7 © copyright 1997-2008 by abatron ag switzerland v 1.00 2.1.1 changing target processor type before you can use the bdi2000 with an other target processor type (e.G. Cpu32 ppc), a new setup has to be done (see chapter 2.5). During this process the target cable...

  • Page 8

    Bdi gdb for bdi2000 (pa6t) user manual 8 © copyright 1997-2008 by abatron ag switzerland v 1.00 2.2 connecting the bdi2000 to power supply the bdi2000 needs to be supplied with 5 volts (max. 1a) via the power connector. The available power supply from abatron (option) or the enclosed power cable can...

  • Page 9

    Bdi gdb for bdi2000 (pa6t) user manual 9 © copyright 1997-2008 by abatron ag switzerland v 1.00 2.3 status led «mode» the built in led indicates the following bdi states: mode led bdi states off the bdi is ready for use, the firmware is already loaded. On the power supply for the bdi2000 is blink th...

  • Page 10

    Bdi gdb for bdi2000 (pa6t) user manual 10 © copyright 1997-2008 by abatron ag switzerland v 1.00 2.4 connecting the bdi2000 to host 2.4.1 serial line communication serial line communication is only used for the initial configuration of the bdigdb system. The host is connected to the bdi through the ...

  • Page 11

    Bdi gdb for bdi2000 (pa6t) user manual 11 © copyright 1997-2008 by abatron ag switzerland v 1.00 2.4.2 ethernet communication the bdi2000 has a built-in 10 base-t ethernet interface (see figure below). Connect an utp (un- shilded twisted pair) cable to the bd2000. For thin ethernet coaxial networks ...

  • Page 12

    Bdi gdb for bdi2000 (pa6t) user manual 12 © copyright 1997-2008 by abatron ag switzerland v 1.00 2.5 initial configuration of the bdigdb system on the enclosed cd you will find the bdi configuration software and the firmware / logic required for the bdi2000. For windows users there is also a tftp se...

  • Page 13

    Bdi gdb for bdi2000 (pa6t) user manual 13 © copyright 1997-2008 by abatron ag switzerland v 1.00 2.5.1 configuration with a linux / unix host the firmware / logic update and the initial configuration of the bdi2000 is done with a command line utility. In the zip archive bdisetup.Zip are all sources ...

  • Page 14

    Bdi gdb for bdi2000 (pa6t) user manual 14 © copyright 1997-2008 by abatron ag switzerland v 1.00 4. Transmit the initial configuration parameters: with "bdisetup -c" the configuration parameters are written to the flash memory within the bdi. The following parameters are used to configure the bdi: b...

  • Page 15

    Bdi gdb for bdi2000 (pa6t) user manual 15 © copyright 1997-2008 by abatron ag switzerland v 1.00 2.5.2 configuration with a windows host first make sure that the bdi is properly connected (see chapter 2.1 to 2.4). To avoid data line conflicts, the bdi2000 must be disconnected from the target system ...

  • Page 16

    Bdi gdb for bdi2000 (pa6t) user manual 16 © copyright 1997-2008 by abatron ag switzerland v 1.00 bdi ip address enter the ip address for the bdi2000. Use the following format: xxx.Xxx.Xxx.Xxx e.G.151.120.25.101 ask your network administrator for assigning an ip address to this bdi2000. Every bdi2000...

  • Page 17

    Bdi gdb for bdi2000 (pa6t) user manual 17 © copyright 1997-2008 by abatron ag switzerland v 1.00 2.6 testing the bdi2000 to host connection after the initial setup is done, you can test the communication between the host and the bdi2000. There is no need for a target configuration file and no tftp s...

  • Page 18

    Bdi gdb for bdi2000 (pa6t) user manual 18 © copyright 1997-2008 by abatron ag switzerland v 1.00 3 using bdigdb 3.1 principle of operation the firmware within the bdi handles the gdb request and accesses the target memory or registers via the jtag interface. There is no need for any debug software o...

  • Page 19

    Bdi gdb for bdi2000 (pa6t) user manual 19 © copyright 1997-2008 by abatron ag switzerland v 1.00 3.2 configuration file the configuration file is automatically read by the bdi after every power on. The syntax of this file is as follows: ; comment [part name] identifier parameter1 parameter2 ..... Pa...

  • Page 20

    Bdi gdb for bdi2000 (pa6t) user manual 20 © copyright 1997-2008 by abatron ag switzerland v 1.00 3.2.1 part [init] the part [init] defines a list of commands which should be executed every time the target comes out of reset. The commands are used to get the target ready for loading the program file....

  • Page 21

    Bdi gdb for bdi2000 (pa6t) user manual 21 © copyright 1997-2008 by abatron ag switzerland v 1.00 rm8 addr read a byte (8bit) from the selected memory place. Addr the memory address example: rm8 0x00000000 rm16 addr read a half word (16bit) from the selected memory place. Addr the memory address exam...

  • Page 22

    Bdi gdb for bdi2000 (pa6t) user manual 22 © copyright 1997-2008 by abatron ag switzerland v 1.00 3.2.2 part [target] the part [target] defines some target specific values. Cputype type [32bit] this value gives the bdi information about the connected cpu. The op- tional 32bit parameter forces the bdi...

  • Page 23

    Bdi gdb for bdi2000 (pa6t) user manual 23 © copyright 1997-2008 by abatron ag switzerland v 1.00 bdimode mode [param] this parameter selects the bdi debugging mode. The following modes are supported: loadonly loads and starts the application core. No debugging via jtag port. Agent the debug agent ru...

  • Page 24

    Bdi gdb for bdi2000 (pa6t) user manual 24 © copyright 1997-2008 by abatron ag switzerland v 1.00 catch list this entry allows to define the events that should trigger a debug mode en- try (halting the core). The following events can be fetched: mchk machine check hdec hypervisor decrementer dec decr...

  • Page 25

    Bdi gdb for bdi2000 (pa6t) user manual 25 © copyright 1997-2008 by abatron ag switzerland v 1.00 sio port [baudrate] when this line is present, a tcp/ip channel is routed to the bdi’s rs232 connector. The port parameter defines the tcp port used for this bdi to host communication. You may choose any...

  • Page 26

    Bdi gdb for bdi2000 (pa6t) user manual 26 © copyright 1997-2008 by abatron ag switzerland v 1.00 3.2.3 part [host] the part [host] defines some host specific values. Ip ipaddress the ip address of the host. Ipaddress the ip address in the form xxx.Xxx.Xxx.Xxx example: ip 151.120.25.100 file filename...

  • Page 27

    Bdi gdb for bdi2000 (pa6t) user manual 27 © copyright 1997-2008 by abatron ag switzerland v 1.00 dump filename the default file name used for the telnet dump command. Filename the filename including the full path example: dump dump.Bin telnet mode by default the bdi sends echoes for the received cha...

  • Page 28

    Bdi gdb for bdi2000 (pa6t) user manual 28 © copyright 1997-2008 by abatron ag switzerland v 1.00 3.2.4 part [flash] the telnet interface supports programming and erasing of flash memories. The bdigdb system has to know which type of flash is used, how the chip(s) are connected to the cpu and which s...

  • Page 29

    Bdi gdb for bdi2000 (pa6t) user manual 29 © copyright 1997-2008 by abatron ag switzerland v 1.00 workspace address if a workspace is defined, the bdi uses a faster programming algorithm that runs out of ram on the target system. Otherwise, the algorithm is pro- cessed within the bdi. The workspace i...

  • Page 30

    Bdi gdb for bdi2000 (pa6t) user manual 30 © copyright 1997-2008 by abatron ag switzerland v 1.00 supported flash memories: there are currently 3 standard flash algorithm supported. The amd, intel and atmel at49 algorithm. Almost all currently available flash memories can be programmed with one of th...

  • Page 31

    Bdi gdb for bdi2000 (pa6t) user manual 31 © copyright 1997-2008 by abatron ag switzerland v 1.00 note: some intel flash chips (e.G. 28f800c3, 28f160c3, 28f320c3) power-up with all blocks in locked state. In order to erase/program those flash chips, use the init list to unlock the appropriate blocks:...

  • Page 32

    Bdi gdb for bdi2000 (pa6t) user manual 32 © copyright 1997-2008 by abatron ag switzerland v 1.00 3.2.5 part [regs] in order to make it easier to access target registers via the telnet interface, the bdi can read in a register definition file. In this file, the user defines a name for the register an...

  • Page 33

    Bdi gdb for bdi2000 (pa6t) user manual 33 © copyright 1997-2008 by abatron ag switzerland v 1.00 example for a register definition: entry in the configuration file: [regs] file $regpa6t.Def the register definition file: ;name type addr size ;------------------------------------------- ; sp gpr 1 ; a...

  • Page 34

    Bdi gdb for bdi2000 (pa6t) user manual 34 © copyright 1997-2008 by abatron ag switzerland v 1.00 3.3 debugging with gdb because the gdb server runs within the bdi, no debug support has to be linked to your application. There is also no need for any bdi specific changes in the application sources. 3....

  • Page 35

    Bdi gdb for bdi2000 (pa6t) user manual 35 © copyright 1997-2008 by abatron ag switzerland v 1.00 3.3.3 gdb monitor command the bdi supports the gdb "monitor" command. Telnet commands are executed and the telnet out- put is returned to gdb. This way you can for example switch the bdi breakpoint mode ...

  • Page 36

    Bdi gdb for bdi2000 (pa6t) user manual 36 © copyright 1997-2008 by abatron ag switzerland v 1.00 3.3.4 target serial i/o via bdi a rs232 port of the target can be connected to the rs232 port of the bdi2000. This way it is possible to access the target’s serial i/o via a tcp/ip channel. For example, ...

  • Page 37

    Bdi gdb for bdi2000 (pa6t) user manual 37 © copyright 1997-2008 by abatron ag switzerland v 1.00 3.4 telnet interface a telnet server is integrated within the bdi. The telnet channel is used by the bdi to output error messages and other information. Also some basic debug commands can be executed. Te...

  • Page 38

    Bdi gdb for bdi2000 (pa6t) user manual 38 © copyright 1997-2008 by abatron ag switzerland v 1.00 the telnet commands: "md [ "mdh [ "mdb [ "mm [] modify word(s) (32bit) in target memory", "mmh [] modify half word(s) (16bit) in target memory", "mmb [] modify byte(s) (8bit) in target memory", "mc [ "mv...

  • Page 39

    Bdi gdb for bdi2000 (pa6t) user manual 39 © copyright 1997-2008 by abatron ag switzerland v 1.00 3.5 multi-core support the bdigdb system supports concurrent debugging of the two cores present in the pa6t-1682. For every core you can start its own gdb session. The port numbers used to attach the rem...

  • Page 40

    Bdi gdb for bdi2000 (pa6t) user manual 40 © copyright 1997-2008 by abatron ag switzerland v 1.00 3.6 low level jtag mode it is possible to switch to a mode where you can enter low level jtag commands via the telnet in- terface. You activate this mode via the telnet "jtag" command. Once the bdi has e...

  • Page 41

    Bdi gdb for bdi2000 (pa6t) user manual 41 © copyright 1997-2008 by abatron ag switzerland v 1.00 4 specifications operating voltage limiting 5 vdc ± 0.25 v power supply current typ. 500 ma max. 1000 ma rs232 interface: baud rates 9’600,19’200, 38’400, 57’600,115’200 data bits 8 parity bits none stop...

  • Page 42

    Bdi gdb for bdi2000 (pa6t) user manual 42 © copyright 1997-2008 by abatron ag switzerland v 1.00 5 environmental notice disposal of the equipment must be carried out at a designated disposal site. 6 declaration of conformity (ce).

  • Page 43

    Bdi gdb for bdi2000 (pa6t) user manual 43 © copyright 1997-2008 by abatron ag switzerland v 1.00 7 warranty abatron switzerland warrants the physical diskette, cable, bdi2000 and physical documentation to be free of defects in materials and workmanship for a period of 24 months following the date of...

  • Page 44: Appendices

    Bdi gdb for bdi2000 (pa6t) user manual 44 © copyright 1997-2008 by abatron ag switzerland v 1.00 appendices a troubleshooting problem the firmware can not be loaded. Possible reasons • the bdi is not correctly connected with the target system (see chapter 2). • the power supply of the target system ...

  • Page 45

    Bdi gdb for bdi2000 (pa6t) user manual 45 © copyright 1997-2008 by abatron ag switzerland v 1.00 b maintenance the bdi needs no special maintenance. Clean the housing with a mild detergent only. Solvents such as gasoline may damage it. If the bdi is connected correctly and it is still not responding...

  • Page 46

    Bdi gdb for bdi2000 (pa6t) user manual 46 © copyright 1997-2008 by abatron ag switzerland v 1.00 observe precautions for handling (electrostatic sensitive device) unplug the cables before opening the cover. Use exact fuse replacement (microfuse msf 1.6 af). 4 5 4.1 while holding the casing, slide ca...

  • Page 47

    Bdi gdb for bdi2000 (pa6t) user manual 47 © copyright 1997-2008 by abatron ag switzerland v 1.00 c trademarks all trademarks are property of their respective holders..