comparison loadtools/loadtool.help @ 675:8b1e86dcc3ac

loadtool.help: new flash e-program-* commands documented
author Mychaela Falconia <falcon@freecalypso.org>
date Sun, 08 Mar 2020 05:46:42 +0000
parents cd031e2501fa
children e78c7ab3b0e6
comparison
equal deleted inserted replaced
674:135de08c5d74 675:8b1e86dcc3ac
158 flash id Perform flash chip autodetection sequence 158 flash id Perform flash chip autodetection sequence
159 flash info Display flash configuration info 159 flash info Display flash configuration info
160 flash program-bin Program flash with a binary file 160 flash program-bin Program flash with a binary file
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
164 flash e-program-m0 Combined erase and program-m0
165 flash e-program-srec Combined erase and program-srec
163 flash quickprog Program a few flash words from the command line 166 flash quickprog Program a few flash words from the command line
164 flash reset Reset flash chip to read array mode 167 flash reset Reset flash chip to read array mode
165 flash sectors Display the list of flash sector addresses and sizes 168 flash sectors Display the list of flash sector addresses and sizes
166 flash status Intel-style flash only: read Status Register 169 flash status Intel-style flash only: read Status Register
167 flash unlock Intel-style flash only: unlock flash sectors 170 flash unlock Intel-style flash only: unlock flash sectors
282 this moko-style m0 format. 285 this moko-style m0 format.
283 286
284 Because each S-record contains an address, no addresses or offsets need to be 287 Because each S-record contains an address, no addresses or offsets need to be
285 specified in the flash[2] program-m0 command, only the image file. 288 specified in the flash[2] program-m0 command, only the image file.
286 289
290 This command does NOT include a built-in flash erase step - see
291 help flash e-program-m0 for the more complete version.
292
287 === flash:program-srec 293 === flash:program-srec
288 flash[2] program-srec image.srec 294 flash[2] program-srec image.srec
289 295
290 This command programs the flash with an image in the standard S-record format, 296 This command programs the flash with an image in the standard S-record format,
291 in the native little-endian byte order of the Calypso ARM7 processor. It is 297 in the native little-endian byte order of the Calypso ARM7 processor. It is
293 see help flash program-m0. Images produced by flash[2] dump2srec are suitable 299 see help flash program-m0. Images produced by flash[2] dump2srec are suitable
294 for flash[2] program-srec. 300 for flash[2] program-srec.
295 301
296 Because each S-record contains an address, no addresses or offsets need to be 302 Because each S-record contains an address, no addresses or offsets need to be
297 specified in the flash[2] program-srec command, only the image file. 303 specified in the flash[2] program-srec command, only the image file.
304
305 === flash:e-program-bin
306 flash[2] e-program-bin flash-offset binfile [file-offset [length]]
307
308 This command is an extension of flash[2] program-bin: it first erases the range
309 of sectors that contains the range of flash words to be programmed, then
310 executes the program-bin operation. All arguments are exactly the same as for
311 flash[2] program-bin - see help flash program-bin. The range of sectors that
312 will be erased will be the minimal set that contains the area of flash to be
313 programmed. This command is intended for automated (no thinking required)
314 flashing of firmware release images that are delivered in binary format; only
315 flash-offset and binfile arguments will be given in this case.
316
317 === flash:e-program-m0
318 flash[2] e-program-m0 image.m0
319
320 This command reads in the specified S-record image in moko-style m0 format,
321 builds a map of potentially discontiguous flash regions into which the image
322 deposits bits, erases the set of flash sectors which need to be erased before
323 programming these regions, then programs the new image bits into flash. This
324 command is intended for automated (no thinking required) flashing of firmware
325 release images that are delivered in moko-style m0 format.
326
327 === flash:e-program-srec
328 flash[2] e-program-srec image.srec
329
330 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
332 TI's *.m0 files. This command is provided only for the sake of symmetry - no
333 practical use case is envisioned.
298 334
299 === flash:quickprog 335 === flash:quickprog
300 flash[2] quickprog hex-offset hex-data-string 336 flash[2] quickprog hex-offset hex-data-string
301 337
302 This command is intended only for developers; it provides raw access to 338 This command is intended only for developers; it provides raw access to