comparison loadtools/loadtool.help @ 714:e78c7ab3b0e6

loadtool.help: flash prot-reg and flash compal-imei additions documented
author Mychaela Falconia <falcon@freecalypso.org>
date Sat, 06 Jun 2020 17:36:13 +0000
parents 8b1e86dcc3ac
children 74024eb17e04
comparison
equal deleted inserted replaced
713:cf7bd5e705ed 714:e78c7ab3b0e6
161 flash program-m0 Program flash with an image in TI's *.m0 format 161 flash program-m0 Program flash with an image in TI's *.m0 format
162 flash program-srec Program flash with an image in standard S-record format 162 flash program-srec Program flash with an image in standard S-record format
163 flash e-program-bin Combined erase and program-bin 163 flash e-program-bin Combined erase and program-bin
164 flash e-program-m0 Combined erase and program-m0 164 flash e-program-m0 Combined erase and program-m0
165 flash e-program-srec Combined erase and program-srec 165 flash e-program-srec Combined erase and program-srec
166 flash prot-reg Read Intel flash OTP protection register
166 flash quickprog Program a few flash words from the command line 167 flash quickprog Program a few flash words from the command line
167 flash reset Reset flash chip to read array mode 168 flash reset Reset flash chip to read array mode
168 flash sectors Display the list of flash sector addresses and sizes 169 flash sectors Display the list of flash sector addresses and sizes
169 flash status Intel-style flash only: read Status Register 170 flash status Intel-style flash only: read Status Register
170 flash unlock Intel-style flash only: unlock flash sectors 171 flash unlock Intel-style flash only: unlock flash sectors
171 172
172 Additional operation for Compal targets only: 173 Additional operations for Compal targets only:
173 174
175 flash compal-imei Read IMEI from OTP protection register
174 flash erase-program-boot Erase and reprogram the boot sector 176 flash erase-program-boot Erase and reprogram the boot sector
175 177
176 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
177 of Pirelli-style flash memory configurations. Prepend help before a command to 179 of Pirelli-style flash memory configurations. Prepend help before a command to
178 get usage information, e.g., help flash program-bin. 180 get usage information, e.g., help flash program-bin.
182 184
183 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
184 base address of the flash bank) and extending for the specified hex length. 186 base address of the flash bank) and extending for the specified hex length.
185 Reports whether the checked region is blank or not. Flash must be blank (FF in 187 Reports whether the checked region is blank or not. Flash must be blank (FF in
186 all bytes) before it can be programmed. 188 all bytes) before it can be programmed.
189
190 === flash:compal-imei
191 flash compal-imei Display the Compal phone's IMEI
192 flash compal-imei <filename> Display the Compal phone's IMEI, and also
193 save it in the named file
194
195 Compal phones have their factory IMEI stored in the flash chip's OTP protection
196 register. This command reads the Intel flash protection register, checks its
197 content for an IMEI formatted in Compal's particular way, and if a valid-looking
198 IMEI is found, it is displayed on the terminal. The extracted IMEI can also be
199 saved into a text file.
187 200
188 === flash:dump2bin 201 === flash:dump2bin
189 flash[2] dump2bin outfile [offset [length]] 202 flash[2] dump2bin outfile [offset [length]]
190 203
191 Read device flash content and save it to a file. If only a filename is 204 Read device flash content and save it to a file. If only a filename is
330 This command works like flash[2] e-program-m0, but takes in an S-record image 343 This command works like flash[2] e-program-m0, but takes in an S-record image
331 in little-endian byte order, which is the opposite byte order from that used by 344 in little-endian byte order, which is the opposite byte order from that used by
332 TI's *.m0 files. This command is provided only for the sake of symmetry - no 345 TI's *.m0 files. This command is provided only for the sake of symmetry - no
333 practical use case is envisioned. 346 practical use case is envisioned.
334 347
348 === flash:prot-reg
349 This command is only applicable to Intel-style flash chips. These flash chips
350 have an OTP (one time programmable, then physically immutable afterward) area
351 called "protection register"; this command reads the flash chip's protection
352 register and displays its content as in lock word, factory words and user words.
353
335 === flash:quickprog 354 === flash:quickprog
336 flash[2] quickprog hex-offset hex-data-string 355 flash[2] quickprog hex-offset hex-data-string
337 356
338 This command is intended only for developers; it provides raw access to 357 This command is intended only for developers; it provides raw access to
339 loadagent's basic flash write primitive. Read the source code for more 358 loadagent's basic flash write primitive. Read the source code for more