1srec_mips_flash.5(5) File Formats Manual srec_mips_flash.5(5)
2
3
4
6 srec_mips_flash - MIPS‐Flash file format
7
9 The MIPS SDE tool chain has a convert program that is able to output
10 this format. I have no idea what reads it, some kind of flash program‐
11 mer I suppose.
12
13 Format
14 The file must start with '!R' to reset the state machine. White space
15 appears to be ignored, except as it serves to separate tokens.
16
17 Data is presented as 32‐bit hexadecimal numbers, in the normal big‐
18 endian text number format. To write them to memory, you have to know
19 if the target is big‐endian or little‐endian. for little endian tar‐
20 gets, reverse the order of the bytes in this number.
21
22 The eight bytes following a '>' are a sort of comment. The SDE code
23 reads like they are displayed in the flash programmer as a kind of
24 progress indicator.
25
26 The number following '@' is a new address for the following data.
27
28 Each segment must be erased before it can be written, this is done with
29 the '!E' command. Each segment is assumed to be 128kB in size.
30
31 Special segments must unlocked (with the '!C' command) and locked again
32 (with the '!S' command).
33
34 This file format contains no checksum mechanism.
35
36 Command Line Options
37 This format is specified using one of the -Mips‐Flash‐Big_Endian or
38 -Mips‐Flash‐Little_Endian options. The endian‐ness must be specified
39 on the command line, because there is nothing in the file contents to
40 indicate the endian‐ness of the data it contains.
41
42 Size Multiplier
43 In general, binary data will expand in sized by approximately 2.3 times
44 when represented with this format (worse if you use shorter lines).
45
47 Here is an example MIPS‐Flash file. It contains the data “Hello,
48 World” to be loaded at bytes address 0x0000 (but remember, the file
49 contents are always multiples of four bytes).
50 !R
51 >00000xxx @00000000 !E
52 @00000000
53 >00000000
54 48656C6C 6F2C2057 6F726C64 210A0000
55 >#DL_DONE
56 >FINISHED
57
59 srec_cat version 1.64
60 Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
61 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014 Peter Miller
62
63 The srec_cat program comes with ABSOLUTELY NO WARRANTY; for details use
64 the 'srec_cat -VERSion License' command. This is free software and you
65 are welcome to redistribute it under certain conditions; for details
66 use the 'srec_cat -VERSion License' command.
67
69 Scott Finneran E‐Mail: scottfinneran@yahoo.com.au
70 Peter Miller E‐Mail: pmiller@opensource.org.au
71
73 srec_cat version 1.64
74 Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
75 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014 Peter Miller
76
77 The srec_cat program comes with ABSOLUTELY NO WARRANTY; for details use
78 the 'srec_cat -VERSion License' command. This is free software and you
79 are welcome to redistribute it under certain conditions; for details
80 use the 'srec_cat -VERSion License' command.
81
83 Scott Finneran E‐Mail: scottfinneran@yahoo.com.au
84 Peter Miller E‐Mail: pmiller@opensource.org.au
85
86
87
88Reference Manual SRecord srec_mips_flash.5(5)