Dump Method
UP ]

 

Description

Retrieves an array with the target’s memory contents between two addresses. This is an asynchronous method that must be used in combination with an implementation of the OnDump event which is actually fired when the operation is completed.

Syntax

HCS121.Dump (StartAddress, FinalAddress)

Part Type Description
StartAddress Long Target’s memory address of the first data retrieved into the array. This parameter is rounded down to a multiple of 2 (word alignment) because of the implementation. See DumpB method.
FinalAddress Long Target’s memory address of the last byte of data retrieved into the array. FinalAddress values must be greater than StartAddress ones.

Remarks

The retrieving of target’s memory data using this method is faster than using its similar DumpB. The only problem is care must be taken to be sure that the CPU is stopped. See Stop method. On the other hand, using DumpB, you can keep running your user code while retrieving a memory data block from your target processor.

In order to access flash memory space larger than 64k bytes, you can use (additionally to using16 bit addresses between $8000 and $BFFF for StartAddress and FinalAddress together to PPAGE programming) linear addresses for StartAddress and FinalAddress. The activex component automatically looks after for PPAGE programming. For instance, if you target processor is one MC9S12DP256 and you want to retrieve the first 50 bytes of memory data from the flash block number 3, first page, you will have to write $30 into the PPAGE register and then access to memory using the page window located between $8000 and $BFFF, setting the values $8000 and $8031 onto StartAddress and FinalAdrress respectively. The other way to do that would be setting the linear addresses $C0000 and $C0031 onto StartAddress and FinalAdrress respectively and leaving to HCS12 ActiveX the PPAGE programming task.

See also:

DumpB method

OnDump event

Stop method

 

If you have a question or suggestion please contact me. Updated: 12.31.2003
Copyright (c) 2003-2004 J.Gorgas. All rights reserved. All trademarks mentioned are the property of their respective owners.