FreeCalypso > hg > freecalypso-tools
comparison loadtools/loadtool.help @ 621:f44770a652eb
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 |