NAME

       srec_mem - Lattice Memory Initialization format

DESCRIPTION

       A  Lattice Memory Initialization format (.mem), by Lattice Semiconductor, 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,  memory  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 binary format for a 32x8 memory.  When
       displayed in Memory Generator, the address will be shown in hexadecimal and the data  will  be  shown  in
       binary.
              #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 address 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 address 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, separated by spaces:
              address: data data> data...
       The data will be applied starting at <address> and filling in sequentially 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)