coe file syntax

kenson

COE File Syntax
The following syntax displays the general form for a COE file:
Keyword =Value ; Optional Comment
Keyword =Value ; Optional Comment
. i4 l" E9 Q& q8 Y$ l<Radix_Keyword> =Value ; Optional Comment
. ~6 f9 W9 E# L
$ k4 D6 a9 ~: J) T$ c9 A9 X2 @<Data_Keyword> =Data_Value1, Data_Value2, Data_Value3;
/ m, p4 H7 d7 KThe following table describes COE file keywords for specifying radix values for data. Keywords are not case sensitive. For information on the specific keywords required for a core, please refer to that core’s data sheet.
COE File Keywords for Radix Values
6 ?: @8 Z  p. V: K5 b0 a8 J0 @3 ZKeyword        Description
RADIX        Used for non-memory cores to indicate the radix being used to specify the coefficients of the filter.
MEMORY_INITIALIZATION_RADIX        Used for memory initialization values to specify the radix used.
The following table describes COE file keywords for data values. Keywords are not case sensitive.
COE File Keywords for Data Values
- k: ~9 v5 x8 l2 pKeyword        Description
COEFDATA        Used for filters to indicate that the data that follows comprises the coefficients of the filter.
MEMORY_INITIALIZATION_VECTOR        Used for block and distributed memories.
PATTERN        Used for Bit Correlator COE files.
BRANCH_LENGTH_VECTOR        Used in Interleaver COE files.
MEMDATA        Obsolete keyword.
Note :  Any text after a semicolon is treated as a comment and is ignored.
8 j! L0 z/ t, w3 EOne of the following keywords must be the last keyword specified in the COE file:
, u( p8 S  z3 p COEFDATA
! }& e* X5 M- V" i+ r  X2 _ MEMORY_INITIALIZATION_VECTOR
9 G  V$ E" g: X* w3 Z, ^8 P MEMDATA (an obsolete keyword, supported for backward compatibility)
Any other keywords that follow are ignored.
You can find examples of COE files for the Distributed Arithmetic FIR Filter, Bit Correlator, Digital Down Converter, RAM-based Shift Register, and Distributed Memory in the $XILINX/coregen/data directory.
Below is a selection of the COE files from this area.
******************************************************************
*************  Example of Virtex Bit Correlator.COE  *************
5 ]) h* w8 q/ K+ i& e) u6 M******************************************************************
" E% s) a. a1 i% `5 h$ e; Sample .COE coefficient file for v2.0 and later
; versions of the Bit Correlator core.
; R. W! k' C+ ~" }- c: ~;
; In this core, a COE file is used to specify the value
; of the bit mask when the Pattern Mask option is selected.
  l  y% {  V/ Y0 N: f/ B' _8 r;
0 B" C9 h9 x+ Z  E$ A% B; Specifications:
4 N" Z: V( I2 Q+ Y( w0 t- k) Q;
8 t. K# q' x' j: e; - 19 taps, hexadecimal coefficients
; - Serial input data
$ X- G( B: Z% p# k  }$ w: u) Y;
; Please refer to the datasheet for this core for more
  }' I2 c5 e% e& r1 Z; details on using the Mask option.
radix = 16;
pattern = 3 0 3 1 0 1 1 3 0 2 2 2 3 0 1 1 3 0 3;
******************************************************************
*********  Example of Dual Port Block Memory .COE file  **********
; Q: t" N: E- U. l******************************************************************
/ h* g! ~4 p6 g2 D3 K; Sample memory initialization file for Dual Port Block Memory,
; v3.0 or later.
9 M; I0 {1 K3 B- j- [;
$ ^7 f- }: i" y/ g( z6 H/ x; This .COE file specifies the contents for a block memory
* a: V& q5 E/ J; of depth=16, and width=4.  In this case, values are specified
1 q. v' G) j9 M4 _5 Y* I/ m; b% o; in hexadecimal format.
memory_initialization_radix=2;
2 R& `6 o5 x$ B- F( Xmemory_initialization_vector=
2 F( B. ~) }6 X1111,
1111,
1111,
1111,
( O0 x' ^) c) _) ?. w2 i! Z" H2 _; f1111,
0000,
0101,
0011,
0000,
" f- Y; h. I) G7 p1111,
, a5 b1 P/ P6 C4 q1111,
1111,
: {. F  Z4 \# w& l1 G* ?, O; M! M' Q1111,
. J+ k* S- ?0 J4 H1111,
1111,
1111;
# e/ I- q1 W. H# n8 h******************************************************************
********  Example of Single Port Block Memory .COE file  *********
******************************************************************
6 i( ]$ D! M$ m. C, |; Sample memory initialization file for Single Port Block Memory,
; v3.0 or later.
( C  E7 }. ?$ b;
; This .COE file specifies initialization values for a block
; memory of depth=16, and width=8. In this case, values are
; specified in hexadecimal format.
1 X3 D& |! q5 u; }: K* Wmemory_initialization_radix=16;
. T1 \6 a9 Z# T6 R4 Umemory_initialization_vector=
3 N) N! [0 D1 C# d2 u- y6 {- ^ff,
; U- e; M6 e# J9 B, M, Cab,
f0,
11,
11,
00,
. p0 d! `3 x& d/ I3 w01,
aa,
bb,
cc,
0 e' u% I* E, W6 Wdd,
ef,
ee,
; {& Z: B6 c0 L0 v% U0 kff,
6 k/ D( {/ P' y3 H$ F00,
ff;
$ o* R  G# k; j: j/ q- N2 J******************************************************************
************  Example of Distributed Memory .COE file  ***********
******************************************************************
; Sample memory initialization file for Distributed Memory v2.0 and
" _8 O7 C' q) x) B; C( l$ b; later.
' {: k6 d3 ^" u' b# C; A2 u;
. o6 f% N2 K1 ]7 ]; This .COE file is NOT compatible with v1.0 of Distributed Memory Core.
;
% P) H. P- k7 }3 N( p% q; The example specifies initialization values for a memory of depth= 32,
; and width=16. In this case, values are specified in hexadecimal
8 d1 o$ ~. P5 Z3 C; format.
memory_initialization_radix = 16;
( q5 u: Y4 z; A; p0 E& hmemory_initialization_vector = 23f4 0721 11ff ABe1 0001 1 0A 0
, A* ?" y. g1 D: h 23f4 0721 11ff ABe1 0001 1 0A 0
23f4 721 11ff ABe1 0001 1 A 0
" B. p! h+ ^. Y 23f4 721 11ff ABe1 0001 1 A 0;
******************************************************************
6 q8 s0 G: d9 |. G) p, p******  Example of Distributed Arithmetic FIR Filter .COE file ***
+ P+ V" O3 ?* \1 Q& W, ]******************************************************************
; Example of a Distributed Arithmetic (DA) FIR Filter .COE file
7 i- f7 `* [1 T! G; o0 {; with hex coefficients, 8 symmetrical taps, and 12-bit
; coefficients.
;
; Compatible with all versions of the Distributed Arithmetic
9 q& T/ U' _) }; Q; FIR Filter which supports Virtex and Spartan
) v0 a6 s; b9 Q" v* t6 b4 Z1 pRadix = 16;
CoefData= 346, EDA, 0D6, F91, F91, 0D6, EDA, 346;


8 u$ D7 U# j4 N4 f' v& Chttps://www.xilinx.com/support/d ... coe_file_syntax.htm