FreeCalypso > hg > freecalypso-tools

comparison loadtools/loadtool.help @ 621:f44770a652eb

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
loadtool.help: additional details documented for dump commands This documentation addition explains the alignment requirements for dump, dump2bin and dump2srec commands, and explains that dump2srec is deprecated.
author Mychaela Falconia <falcon@freecalypso.org>
date Thu, 27 Feb 2020 04:27:18 +0000
parents 34d544c0f639
children ae4330d86029
comparison
equal deleted inserted replaced
620:dd162a4cb9fa 621:f44770a652eb
92 === dump 92 === dump
93 dump hex-start hex-len 93 dump hex-start hex-len
94 94
95 The first argument is the starting target memory address in hex; the second 95 The first argument is the starting target memory address in hex; the second
96 argument is the length of the area to dump, also in hex. The dump will be 96 argument is the length of the area to dump, also in hex. The dump will be
97 displayed on the terminal in hex and ASCII. 97 displayed on the terminal in hex and ASCII. As an implementation limit, both
98 the starting target memory address and the length of the area to dump need to
99 be aligned to 16 bytes.
98 100
99 === dump2bin 101 === dump2bin
100 === dump2srec 102 === dump2srec
101 dump2bin hex-start hex-len outfile 103 dump2bin hex-start hex-len outfile
102 dump2srec hex-start hex-len outfile 104 dump2srec hex-start hex-len outfile
103 105
104 The first argument is the starting target memory address in hex; the second 106 The first argument is the starting target memory address in hex; the second
105 argument is the length of the area to dump, also in hex; the third argument 107 argument is the length of the area to dump, also in hex; the third argument
106 is the name of the output file to be created/written. The dump will be saved 108 is the name of the output file to be created/written. The dump will be saved
107 in binary or S-records as per the chosen command, always in the native byte 109 in binary or S-records as per the chosen command, always in the native byte
108 order of the Calypso ARM7 target (little-endian). 110 order of the Calypso ARM7 target (little-endian). As an implementation limit,
111 both the starting target memory address and the length of the area to dump need
112 to be aligned to 128 bytes.
113
114 dump2srec is deprecated, please use dump2bin instead. If you do use dump2srec,
115 the S-record image will be written with 128 bytes of payload per record (270
116 ASCII characters per line), which is significantly longer records than most
117 SREC conventions.
109 118
110 === exec 119 === exec
111 exec <script-file> 120 exec <script-file>
112 121
113 Read and execute commands from the named file. If the execution of a script 122 Read and execute commands from the named file. If the execution of a script