Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
srec_mem(5)		      File Formats Manual		   srec_mem(5)

NAME
       srec_mem	- Lattice Memory Initialization	format

DESCRIPTION
       A  Lattice  Memory Initialization format	(.mem),	by Lattice Semiconduc-
       tor, file is an ASCII text file that consists of	a header  followed  by
       lines of	memory data.

   Syntax
       The  data  must	be  in one of the following formats: Bin (binary), Hex
       (hexadecimal), or Address-Hex (described	below).

       For hexadecimal values, both upper and lower case can be	used.  If  the
       data has	fewer bits than	the specified data width, the most significant
       bits are	filled with 0.	Any address not	specified will be filled  with
       0.

       Comments	 can be	added at any point after the header (defined below) by
       starting	the comment with a pound sign (#) or two  slashes  (//).   The
       comment	then includes everything to the	end of the line.  Comments may
       be added	to any of the data, but	never add comments to the header.

   Header
       A .mem file starts with a header, which declares	the file format,  mem-
       ory size, and address and data display radix for	Memory Generator.  The
       syntax of the header is:
	      #Format=Bin | Hex	| AddrHex
	      #Depth=1 to 65536
	      #Width=1 to 256
	      #AddrRadix=index-number
	      #DataRadix=index-number
	      #Data
       The index-number	can be one of the following  numbers.	AddrRadix  and
       DataRadix can have different values.
	      Binary: 0
	      Octal: 1
	      Decimal: 2
	      Hexadecimal: 3

       For  example,  the following header says	the .mem file is using the bi-
       nary format for a 32x8 memory.  When displayed in Memory	Generator, the
       address	will be	shown in hexadecimal and the data will be shown	in bi-
       nary.
	      #Format=Bin
	      #Depth=32
	      #Width=8
	      #AddrRadix=3
	      #DataRadix=0
	      #Data

   Bin and Hex Formats
       The data	is represented in binary or hexadecimal	format.	 Each line  of
       data  specifies the contents for	one memory location, starting with ad-
       dress 0.	 That is, the first line is for	address	0, the second line  is
       for  address  1,	 and so	on.  For each line, the	data is	interpreted as
       least significant bit on	the right.

       For example, in the Bin format, the following lines will	initialize ad-
       dress  0	 to "00011011",	address	1 to "11111010"	(assuming it is	a 32x8
       memory).
	      #	for a 32x8 memory
	      11011
	      11111010

       In the Hex format, the following	lines will  initialize	address	 0  to
       "003B", address 1 to "FB0A" (assuming it	is a 32x16 memory).
	      #	for a 32x16 memory
	      3B
	      FB0A

   AddrHex
       The  data  is represented in hexadecimal	format.	 Each line consists of
       an address followed by a	colon and then any number of data words, sepa-
       rated by	spaces:
	      address: data data_ data...
       The  data  will be applied starting at <address>	and filling in sequen-
       tially from there.

       For example:
	      A0:03 F3 3E 4F
	      B2:3B 9F
       will initialize A0 with 03, A1 with F3, A2 with 3E, A3 with 4F, B2 with
       3B,  and	B3 with	9F.  The other addresses will be initialized to	0.  So
       A4 through B1 will be set to 0.

   See Also
       http://help.latticesemi.com/docs/webhelp/eng/wwhelp/wwhimpl/common/html/wwhelp.htm#href=Design%20Entry/memory_initialization_file.htm#1371843&single=true

   Size	Multiplier
       The size	multiplier depends on  the  width  selected.   As  files  grow
       larger,	their  size multipliers	will approach those in the table, from
       above.

       Width   Linux   Windows
	 8     2.96	3.0
	16     2.47	2.5
	32     2.25	2.28
	64     2.13	2.15

   Byte	Order
       This format is implicitly big-endian.  Use a -byte-swap filter  if  you
       need something different.

COPYRIGHT
       srec_mem	version	1.64
       Copyright  (C)  1998,  1999,  2000, 2001, 2002, 2003, 2004, 2005, 2006,
       2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014 Peter Miller

       The srec_mem program comes with ABSOLUTELY NO WARRANTY; for details use
       the 'srec_mem -VERSion License' command.	 This is free software and you
       are welcome to redistribute it under certain  conditions;  for  details
       use the 'srec_mem -VERSion License' command.

MAINTAINER
       Scott Finneran	E-Mail:	  scottfinneran@yahoo.com.au
       Peter Miller	E-Mail:	  pmiller@opensource.org.au

Reference Manual		    SRecord			   srec_mem(5)

NAME | DESCRIPTION | COPYRIGHT | MAINTAINER

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=srec_mem&sektion=5&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help