1srec_logisim.5(5) File Formats Manual srec_logisim.5(5)
2
3
4
6 srec_logisim - format Logisim EPROM load files
7
9 The file format used for image files is intentionally simple; this per‐
10 mits you to write a program, such as an assembler, that generates mem‐
11 ory images that can then be loaded into memory. As an example of this
12 file format, if we had a 256‐byte memory whose first five bytes were 2,
13 3, 0, 20, and -1, and all subsequent values were 0, then the image
14 would be the following text file.
15 v2.0 raw
16
17 02 03 00 14 ff
18 The first line identifies the file format used (currently, there is
19 only one file format recognized). Subsequent values list the values in
20 hexadecimal, starting from address 0; you can place several such values
21 on the same line. Logisim will assume that any values unlisted in the
22 file are zero.
23
24 The image file can use run‐length encoding; for example, rather than
25 list the value 00 sixteen times in a row, the file can include 16*00
26 rather than repeat 00 sixteen times. Notice than the number of repeti‐
27 tions is written in base 10. Files produced by Logisim will use run‐
28 length encoding for runs of at least four values
29
30 Size Multiplier
31 In general, binary data will expand in sized by approximately 2.95
32 times when represented with this format.
33
34 Commentary
35 This format is particularly deficient.
36
37 · The is no way for changing address in‐flight. And therefore the for‐
38 mat can't have holes in the data.
39
40 · There are no checksums, or any other error checking.
41
42 · There is no provision for a comment header, as distinct to the “v2.0
43 raw” magic number.
44
45 · There is no provision for an execution start adddress.
46
48 http://ozark.hendrix.edu/~burch/logisim/docs/2.3.0/guide/mem/menu.html
49
51 srec_logisim.5 version 1.64
52 Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
53 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014 Peter Miller
54
55 The srec_logisim.5 program comes with ABSOLUTELY NO WARRANTY; for
56 details use the 'srec_logisim.5 -VERSion License' command. This is
57 free software and you are welcome to redistribute it under certain con‐
58 ditions; for details use the 'srec_logisim.5 -VERSion License' command.
59
61 Scott Finneran E‐Mail: scottfinneran@yahoo.com.au
62 Peter Miller E‐Mail: pmiller@opensource.org.au
63
64
65
66Reference Manual SRecord srec_logisim.5(5)