srec_mem(5)

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, 20 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