comparison loadtools/loadtool.help @ 995:74024eb17e04

fc-loadtool help: improve language regarding 16 MiB flash chips In FC project history, 16 MiB flash originally meant Pirelli DP-L10. Then we got FCDEV3B with the same flash (our own design), but now we are discovering more Calypso devices that used such large flash, both late Calypso era (Sony Ericsson K2x0) as well as much earlier ones (FIC FLUID devices.txt file with 2004 dates, Leonardo+ rev 5). Hence we need to migrate to more generic or neutral language in associated documentation, without giving elevated status to specific examples that drove our early project history.
author Mychaela Falconia <falcon@freecalypso.org>
date Sun, 03 Dec 2023 21:11:12 +0000
parents e78c7ab3b0e6
children 162d2cf394e2
comparison
equal deleted inserted replaced
994:ad3041e19884 995:74024eb17e04
28 dump2bin Dump a target memory region to a file in binary format 28 dump2bin Dump a target memory region to a file in binary format
29 dump2srec Dump a target memory region to a file in S-record format 29 dump2srec Dump a target memory region to a file in S-record format
30 exec Execute a command script 30 exec Execute a command script
31 exit Exit from loadtool and clean up the target device state 31 exit Exit from loadtool and clean up the target device state
32 flash Flash operations 32 flash Flash operations
33 flash2 Operations on the 2nd flash bank (FC and Pirelli devices only) 33 flash2 Operations on the 2nd flash bank (16 MiB flash chips only)
34 quit Alias for exit 34 quit Alias for exit
35 r8 Read an 8-bit register or memory location 35 r8 Read an 8-bit register or memory location
36 r16 Read a 16-bit register or memory location 36 r16 Read a 16-bit register or memory location
37 r32 Read a 32-bit register or memory location 37 r32 Read a 32-bit register or memory location
38 w8 Write an 8-bit register or memory location 38 w8 Write an 8-bit register or memory location
142 === flash 142 === flash
143 === flash2 143 === flash2
144 The primary end use of fc-loadtool is for reading and writing the NOR flash 144 The primary end use of fc-loadtool is for reading and writing the NOR flash
145 memories of the supported GSM devices. Most Calypso phones and modems have 145 memories of the supported GSM devices. Most Calypso phones and modems have
146 only one flash bank (as in chip select), and are manipulated with the flash 146 only one flash bank (as in chip select), and are manipulated with the flash
147 command. FreeCalypso development boards and the Pirelli DP-L10 phone have two 147 command. FreeCalypso development boards and some complex phones (Pirelli
148 flash banks (as in chip selects) of 8 MiB each; they are manipulated with the 148 DP-L10, Sony Ericsson K2x0) have two flash banks (as in chip selects) of 8 MiB
149 flash and flash2 commands. 149 each; they are manipulated with flash and flash2 commands.
150 150
151 The following flash operations are available: 151 The following flash operations are available:
152 152
153 flash blankchk Blank-check a region of flash 153 flash blankchk Blank-check a region of flash
154 flash dump2bin Dump flash content to a file in binary format 154 flash dump2bin Dump flash content to a file in binary format
174 174
175 flash compal-imei Read IMEI from OTP protection register 175 flash compal-imei Read IMEI from OTP protection register
176 flash erase-program-boot Erase and reprogram the boot sector 176 flash erase-program-boot Erase and reprogram the boot sector
177 177
178 Substitute flash2 instead of flash when operating on the 2nd flash chip select 178 Substitute flash2 instead of flash when operating on the 2nd flash chip select
179 of Pirelli-style flash memory configurations. Prepend help before a command to 179 of 16 MiB flash chips (FCDEV3B, Pirelli DP-L10 etc). Prepend help before a
180 get usage information, e.g., help flash program-bin. 180 command to get usage information, e.g., help flash program-bin.
181 181
182 === flash:blankchk 182 === flash:blankchk
183 flash[2] blankchk hex-start-offset hex-length 183 flash[2] blankchk hex-start-offset hex-length
184 184
185 Blank-checks an area of flash starting at the specified hex offset (from the 185 Blank-checks an area of flash starting at the specified hex offset (from the