Ronetix PEEDI Manuale utente

PEEDI

Powerful Embedded Ethernet Debug Interface

User’s Manual

Version 3.0

February, 2019

Ronetix has made every attempt to ensure that the information in this document is accurate and

complete. However, Ronetix assumes no responsibility for any errors, omissions, or for any

conse uences resulting from the use of the information included herein or the e uipment it

accompanies. Ronetix reserves the right to make changes in its products and specifications at any

time without notice. Any software described in this document is furnished under a license or non-

disclosure agreement. It is against the law to copy this software on magnetic tape, disk, or other

medium for any purpose other than the licensee’s personal use.

Ronetix Development Tools GmbH

Hirschstettner Str.19/Z110

1220 Vienna

Austria

Tel: +43 1 236 1101

Fax: +43 1 236 1101 9

Web: www.ronetix.at

E-Mail: [email protected]

Acknowledgments:

ARM, ARM7, ARM9, ARM11, Cortex-M, Cortex-A and Thumb are trademarks of ARM Ltd.

PowerPC and ColdFire are trademarks of Freescale Ltd.

Blackfin is trademark of Analog Devices Ltd.

Windows, Win32, Windows CE are trademarks of Microsoft Corporation.

Ethernet is a trademark of XEROX.

MIPS is a trademark of MIPS Technologies.

AVR32 is a trademark of Atmel.

All other trademarks are trademarks of their respective companies.

Table of Contents
PEEDI...................................................................................................................................................1
Powerful Embedded Ethernet Debug Interface....................................................................................1
1 Introduction......................................................................................................................................11
1.1 PEEDI in the development process.........................................................................................12
1.1.1 Single developer environment.........................................................................................12
1.1.2 Multiple developers environment....................................................................................13
1.2 PEEDI in the manufacturing process.......................................................................................13
1.2.1 PEEDI as a standalone FLASH programmer...................................................................14
1.2.2 PEEDI as a device tester..................................................................................................15
1.2.3 High productivity with the Multi Program feature..........................................................15
2 Installation.......................................................................................................................................15
2.1 Hardware installation...............................................................................................................16
2.1.1 Connection instructions....................................................................................................16
2.2 Software installation................................................................................................................18
3 Using PEEDI...................................................................................................................................18
3.1 PEEDI interface.......................................................................................................................18
3.2 Setup with RedBoot.................................................................................................................19
3.2.1 RedBoot Configuration....................................................................................................20
3.3 Firmware update procedure.....................................................................................................21
3.3.1 Update via RS232............................................................................................................22
3.3.2 Update via Ethernet..........................................................................................................22
3.4 RedBoot commands used with PEEDI....................................................................................24
update...................................................................................................................................24
config....................................................................................................................................25
memtest................................................................................................................................25
3.5 Configure PEEDI.....................................................................................................................26
3.5.1 Network configuration.....................................................................................................26
3.5.2 Target configuration file...................................................................................................26
Section LICENSE.................................................................................................................27
Section DEBUGGER...........................................................................................................27
PROTOCOL....................................................................................................................27
REMOTE_PORT.............................................................................................................28
FLASHn...........................................................................................................................28
Section TARGET..................................................................................................................28
PLATFORM....................................................................................................................28
Section PLATFORM_xxx - parameters for all targets with JTAG interface.......................29
JTAG_CHAIN.................................................................................................................29
JTAG_TDO_DELAY......................................................................................................29
TRST_TYPE...................................................................................................................29
RESET_TIME.................................................................................................................30
RESET_TYPE.................................................................................................................30
WAKEUP_TIME.............................................................................................................31
TIME_AFTER_RESET...................................................................................................31
DBGREQ_OUTPUT.......................................................................................................31
COREn.............................................................................................................................31
COREn_STARTUP_MODE............................................................................................32
COREn_INIT...................................................................................................................32
COREn_FLASHm...........................................................................................................32
COREn_ENDIAN...........................................................................................................33
COREn_BREAKMODE.................................................................................................33

COREn_WORKSPACE..................................................................................................34
COREn_DATASPACE....................................................................................................34
COREn_PATH.................................................................................................................34
COREn_FILE..................................................................................................................34
COREn_LOCKOUT_RECOVERY................................................................................35
COREn_OS.....................................................................................................................36
Section PLATFORM_ARM and PLATFORM_ARM11.....................................................36
COREn.............................................................................................................................36
COREn_VECTOR_CATCH_MASK..............................................................................36
COREn_DCC_PORT......................................................................................................37
COREn_USE_FAST_DOWNLOAD..............................................................................37
COREn_BREAK_PATTERN..........................................................................................37
Section PLATFORM_Cortex & Section PLATFORM_Cortex_SWD................................38
COREn.............................................................................................................................38
COREn_APSEL..............................................................................................................38
COREn_DEBUG_ADDR...............................................................................................39
COREn_DAPPC..............................................................................................................39
COREn_PERIODIC_TASK............................................................................................39
COREn_SWO..................................................................................................................40
COREn_PROFILING......................................................................................................40
Section PLATFORM_XSCALE...........................................................................................41
COREn.............................................................................................................................41
COREn_USE_FAST_DOWNLOAD..............................................................................41
COREn_DEBUG_HANDLER_ADDR..........................................................................41
COREn_VECTOR/RELOCATED_UNDEF/SWI/PABORT/DABORT/RES/IRQ/FIQ.42
Section PLATFORM_MPC5200..........................................................................................43
COREn.............................................................................................................................43
COREn_BOOT_ADDR..................................................................................................43
COREn_MEMDELAY....................................................................................................43
Section PLATFORM_MPC5500..........................................................................................43
COREn.............................................................................................................................44
COREn_NEXUS3_ACCESS..........................................................................................44
MPC5XXX_AUX_TAP_CMD, COREn_AUX_TAP_CMD.........................................44
Section PLATFORM_MPC8300..........................................................................................44
COREn.............................................................................................................................45
COREn_BOOT_ADDR..................................................................................................45
COREn_RCW.................................................................................................................45
COREn_MMU_PTBASE................................................................................................45
Section PLATFORM_MPC8500..........................................................................................46
COREn.............................................................................................................................46
COREn_MMU_TRANS.................................................................................................46
COREn_MMU_PTBASE................................................................................................46
Section PLATFORM_QorIQ_P...........................................................................................47
COREn.............................................................................................................................47
COREn_REGLIST..........................................................................................................47
COREn_MMU_TRANS.................................................................................................47
COREn_MMU_PTBASE................................................................................................48
COREn_PMEM_BASE...................................................................................................48
Section PLATFORM_PPC400.............................................................................................48
COREn.............................................................................................................................48
Section PLATFORM_COLDFIRE.......................................................................................49
BDM_CLOCK.................................................................................................................49

CORE...............................................................................................................................49
CORE_MEMMAP..........................................................................................................49
Section PLATFORM_BLACKFIN......................................................................................50
COREn.............................................................................................................................50
COREn_VMEM..............................................................................................................51
COREn_VMEM_WINDOW...........................................................................................51
COREn_VMEM_PINS...................................................................................................51
CORE_MEMMAP..........................................................................................................52
Section PLATFORM_MIPS.................................................................................................52
COREn.............................................................................................................................52
Section PLATFORM_AVR32..............................................................................................53
COREn.............................................................................................................................53
COREn_BLOCK_ACCESS............................................................................................53
Section INIT.........................................................................................................................53
Section FLASH....................................................................................................................54
NOR FLASH programming............................................................................................55
I2C Programming............................................................................................................55
SPI FLASH programming...............................................................................................56
NAND FLASH programming.........................................................................................57
OneNAND FLASH programming...................................................................................59
MMC/SD card programming...........................................................................................59
Atmel SAM3/SAM4 programming.................................................................................59
Atmel AVR32UC3 programming....................................................................................59
Freescale Kinetis programming.......................................................................................60
TI/Luminary LM3S programming...................................................................................60
NXP LPC2000 programming..........................................................................................60
Nordic Semiconductor nRF51 ans nRF52 programming................................................62
Freescale MAC7100 programming.................................................................................63
Freescale ColdFire V2 programming..............................................................................63
Freescale MPC5000 programming..................................................................................64
ST STM32 programming.................................................................................................64
ST STR7 programming....................................................................................................64
ST STR9 programming....................................................................................................65
TI TMS570 programming................................................................................................65
TI TMS470 programming................................................................................................65
PIC32, SmartFusion A2F, ADuC, EFM32 programming................................................66
CHIP................................................................................................................................67
CHECK_ID.....................................................................................................................67
PART_ID.........................................................................................................................67
PARTITION.....................................................................................................................68
BANK..............................................................................................................................68
ACCESS_METHOD.......................................................................................................68
CHIP_WIDTH.................................................................................................................69
CHIP_COUNT................................................................................................................69
CHIP_SIZE......................................................................................................................69
BASE_ADDR..................................................................................................................69
FILE.................................................................................................................................70
SPI_MODE......................................................................................................................70
AUTO_ERASE................................................................................................................70
AUTO_LOCK.................................................................................................................70
CPU_CLOCK..................................................................................................................71
SECURE_FLASH...........................................................................................................71

SET_VECTORS_CHECKSUM......................................................................................71
DATA_BANK..................................................................................................................72
BANK_SIZE...................................................................................................................72
F2F4_PSIZE....................................................................................................................72
PROTECTION_KEY0 – PROTECTION_KEY3...........................................................72
ALLOW_ZERO_KEYS..................................................................................................73
CPU.................................................................................................................................73
SPI_DIV..........................................................................................................................74
nSPI.................................................................................................................................74
nCS..................................................................................................................................74
SPI_SPCK, SPI_MISO, SPI_MOSI, SPI_CS.................................................................74
CMD_BASE....................................................................................................................75
DATA_BASE...................................................................................................................75
ADDR_BASE..................................................................................................................75
CS_ASSERT/RELEASE.................................................................................................76
ALE_ASSERT/RELEASE..............................................................................................76
CLE_ASSERT/RELEASE..............................................................................................76
BAD_BLOCK_TABLE...................................................................................................76
BAD_BLOCKS...............................................................................................................77
ERASE_BAD_BLOCKS................................................................................................77
SWAP_BI.........................................................................................................................77
OOB_INFO.....................................................................................................................77
DAVINCI_UBL_DESCIPTOR_MAGIC........................................................................79
DAVINCI_UBL_DESCIPTOR_ENTRY_POINT..........................................................79
DAVINCI_UBL_DESCIPTOR_LOAD_ADDR.............................................................80
DAVINCI_UBL_MAX_IMAGE_SIZE..........................................................................80
NUM_ECC......................................................................................................................80
HEADER.........................................................................................................................80
IPS_BASE.......................................................................................................................81
SPIFI_BASE....................................................................................................................81
NCB_DATA.....................................................................................................................81
LDLB_DATA..................................................................................................................81
SERIAL_NUM................................................................................................................82
I2C_ADDR......................................................................................................................83
I2C_DELAY....................................................................................................................83
SDA_SET/CLR, SDA_IN/OUT, SDA_READ, SCL_SET/CLR....................................83
CS_ASSERT/RELEASE, SCLK_SET/CLR, MOSI_SET/CLR, MISO_READ............83
Section OS............................................................................................................................84
ITEM...............................................................................................................................84
Section SERIAL...................................................................................................................85
BAUD..............................................................................................................................85
STOP_BITS.....................................................................................................................85
PARITY...........................................................................................................................85
TCP_PORT......................................................................................................................86
Section TELNET..................................................................................................................86
PROMPT.........................................................................................................................86
BACKSPACE..................................................................................................................87
Section DISPLAY................................................................................................................87
VOLUME........................................................................................................................87
Section ACTIONS................................................................................................................87
3.6 CPU specific considerations....................................................................................................88
3.6.1 Philips LPC2000 family...................................................................................................88

3.6.2 ST STM32 family............................................................................................................88
3.6.3 Intel XScale family..........................................................................................................89
3.6.4 Freescale PowerQUICC II Pro MPC83XX family..........................................................90
3.6.5 Analog Devices Blackfin family......................................................................................91
3.7 Boot se uence..........................................................................................................................91
3.8 Multiple core support...............................................................................................................94
3.9 Script execution using the front panel interface......................................................................96
3.10 Serial Interface.......................................................................................................................98
3.11 ARM DCC Interface..............................................................................................................98
3.12 Working with gdb..................................................................................................................99
3.13 Debugging Linux kernel......................................................................................................101
3.14 Target OS thread awareness.................................................................................................102
3.15 Working with CLI (Command Line Interface)....................................................................105
3.15.1 File path convention.....................................................................................................106
3.15.2 CLI commands.............................................................................................................108
help.....................................................................................................................................108
transfer................................................................................................................................109
type.....................................................................................................................................109
wait.....................................................................................................................................110
core.....................................................................................................................................110
clock....................................................................................................................................111
run.......................................................................................................................................111
go........................................................................................................................................112
gm.......................................................................................................................................112
step......................................................................................................................................113
execute................................................................................................................................114
set........................................................................................................................................114
halt......................................................................................................................................115
reset.....................................................................................................................................115
reboot..................................................................................................................................116
echo.....................................................................................................................................117
jtag......................................................................................................................................117
beep.....................................................................................................................................117
target...................................................................................................................................118
 uit......................................................................................................................................118
info......................................................................................................................................119
Info flash.............................................................................................................................119
info registers.......................................................................................................................119
info target............................................................................................................................120
info config..........................................................................................................................120
info ice................................................................................................................................121
info cp15, info cp14............................................................................................................121
info spr................................................................................................................................123
info ctrl...............................................................................................................................123
info breakpoint...................................................................................................................124
memory...............................................................................................................................124
memory read.......................................................................................................................125
memory write.....................................................................................................................125
memory or..........................................................................................................................126
memory and........................................................................................................................127
memory crc.........................................................................................................................128
memory load.......................................................................................................................128

memory multi load.............................................................................................................129
memory verify....................................................................................................................130
memory dump.....................................................................................................................130
memory management.........................................................................................................131
memory test........................................................................................................................132
flash....................................................................................................................................132
flash set...............................................................................................................................133
flash blank..........................................................................................................................133
flash erase...........................................................................................................................133
flash lock............................................................................................................................134
flash unlock........................................................................................................................135
flash  uery..........................................................................................................................135
flash program......................................................................................................................136
flash multi erase..................................................................................................................136
flash multi blank.................................................................................................................137
flash multi program............................................................................................................138
flash verify..........................................................................................................................139
flash multi verify................................................................................................................139
flash dump..........................................................................................................................140
flash read............................................................................................................................141
flash info.............................................................................................................................141
flash find.............................................................................................................................142
flash test..............................................................................................................................142
flash area.............................................................................................................................143
flash this.............................................................................................................................144
flash this hidden..................................................................................................................144
flash this markbad..............................................................................................................145
flash this nvmbit.................................................................................................................145
flash this secure..................................................................................................................145
flash this option..................................................................................................................146
flash this option..................................................................................................................146
flash this write....................................................................................................................147
flash this part......................................................................................................................147
flash this prot......................................................................................................................148
flash this prot read..............................................................................................................148
flash this prot program.......................................................................................................149
flash this ppb......................................................................................................................149
flash this isc_erase..............................................................................................................150
flash this isc_conf_write.....................................................................................................150
flash this isc_conf_read......................................................................................................151
flash this isc_conf_boot_bank............................................................................................151
flash this isc_conf_lock......................................................................................................151
breakpoint...........................................................................................................................152
breakpoint add....................................................................................................................152
breakpoint list.....................................................................................................................153
breakpoint delete................................................................................................................154
card.....................................................................................................................................154
card cd................................................................................................................................155
card rd.................................................................................................................................155
card dir................................................................................................................................155
card copy............................................................................................................................156
card type.............................................................................................................................156

card delete...........................................................................................................................157
card rename........................................................................................................................157
eeprom................................................................................................................................158
eeprom dir...........................................................................................................................158
eeprom copy.......................................................................................................................158
eeprom type........................................................................................................................159
eeprom delete.....................................................................................................................159
eeprom rename...................................................................................................................160
eeprom format....................................................................................................................160
eeprom alias........................................................................................................................161
test......................................................................................................................................161
amp.....................................................................................................................................162
3.15.3 Working with the FLASH programmer.......................................................................162
3.16 Multiple FLASH support.....................................................................................................164
3.17 Working with a MMC/SD memory card.............................................................................164
3.18 JTAG cable adapters............................................................................................................165
3.19 PEEDI licenses....................................................................................................................166
4 Specifications................................................................................................................................167
4.1 JTAG Target connector signals..............................................................................................168
4.2 RS232 Connector (DB9F, female).........................................................................................170
4.3 Schematics.............................................................................................................................170
5 Warranty........................................................................................................................................170
6 PEEDI Package contents...............................................................................................................171
7 FAQ...............................................................................................................................................171
8 Glossary.........................................................................................................................................176

Table of Figures
Figure 1.1: Single developer environment.........................................................................................12
Figure 1.2: Multiple developers environment....................................................................................13
Figure 1.3: FLASH programmer with PC..........................................................................................14
Figure 1.4: FLASH programmer without PC.....................................................................................14
Figure 1.5: Multi board programming................................................................................................15
Figure 2.1: PEEDI Front Panel...........................................................................................................16
Figure 2.2: PEEDI Rear Panel............................................................................................................16
Figure 2.3: Direct host connection.....................................................................................................17
Figure 2.4: LAN connection...............................................................................................................17
Figure 2.5: Target connection.............................................................................................................17
Figure 3.1: Front panel interface........................................................................................................18
Figure 3.2: Rear panel interface.........................................................................................................19
Figure 3.3: MMU_PTBASE...............................................................................................................91
Figure 3.4: PEEDI Boot Se uence.....................................................................................................93
Figure 3.5: Multi Target connection...................................................................................................94
Figure 3.6: Adapter JTAG cable.......................................................................................................165
Figure 3.7: JTAG Adapter PEEDI-4xARM20..................................................................................165
Figure 4.1: PEEDI JTAG connector.................................................................................................167
Figure 4.2: RS232 connector............................................................................................................169