NAME

       srec_brecord - Freescale MC68EZ328 Dragonball bootstrap record format

DESCRIPTION

       This  data  format  is  understood  by Freescale MC68EZ328 Dragonball series processors on
       their internal UART.

   Lines
       Each line contains hexadecimal data, each byte represented by two hexadecimal  nybbles  in
       upper  case.   Characters  not in this set, but larger than 0x30 (e.g. lower case) will be
       ignored, less than 0x30 (e.g. CR or LF) are considered record terminators.   Comments  are
       problematic; don't try this at home.

   Fields
       Each  line contains a 4‐byte address (big endian), a 1‐byte length‐and‐mode, and then data
       bytes as dictated by the length.  There is no  checksum.   A  zero  length  record  is  an
       execution start address record, non‐zero length records are data.

                           ┌──┬───┬───┬───┬───┬───┬───┬───┬───┬────┬─────┬───┐
                           │1 │ 2 │ 3 │ 4 │ 5 │ 6 │ 7 │ 8 │ 9 │ 10 │ ... │ n │
                           ├──┴───┴───┴───┴───┴───┴───┴───┼───┴────┼─────┴───┤
                           │           Address            │ Length │  Data   │
                           └──────────────────────────────┴────────┴─────────┘
       The length‐and‐mode byte is formatted as follows:

                                    ┌──┬───┬───┬───┬───┬───┬───┬───┐
                                    │7 │ 6 │ 5 │ 4 │ 3 │ 2 │ 1 │ 0 │
                                    ├──┴───┼───┼───┴───┴───┴───┴───┤
                                    │Mode  │ R │      Length       │
                                    └──────┴───┴───────────────────┘
       Mode    These  bits  are  ignored  by SRecord in input (00 = bytes, 01 = half words, 10 is
               reserved, 11 = long words).  These bits are always zero on output by SRecord.

       R       This bit indicates a data read rather than a data write; SRecord does  not  accept
               input files with this bit set, and will not set it on output.

       Length  The  length  of the records data bytes.  It does not include the address or length
               bytes.  The maximum payload of a record is 31 bytes of data.

   Size Multiplier
       In general, binary data will expand in sized by at least 2.35 times when represented  with
       this format.

EXAMPLE

       Here is an example b‐record format file.  It contains the data “Hello, World” to be loaded
       at address 0.
              000000000D48656C6C6F2C20576F726C640A

SEE ALSO

       http://www.freescale.com/files/32bit/doc/ref_manual/MC68VZ328UM.pdf

COPYRIGHT

       srec_cat 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_cat  program  comes  with  ABSOLUTELY NO WARRANTY; for details use the 'srec_cat
       -VERSion License' command.  This is free software and you are welcome to  redistribute  it
       under certain conditions; for details use the 'srec_cat -VERSion License' command.

MAINTAINER

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