1 |
14 |
lampret |
//////////////////////////////////////////////////////////////////////
|
2 |
|
|
//// ////
|
3 |
|
|
//// WISHBONE GPIO Definitions ////
|
4 |
|
|
//// ////
|
5 |
|
|
//// This file is part of the GPIO project ////
|
6 |
|
|
//// http://www.opencores.org/cores/gpio/ ////
|
7 |
|
|
//// ////
|
8 |
|
|
//// Description ////
|
9 |
|
|
//// GPIO IP Definitions. ////
|
10 |
|
|
//// ////
|
11 |
|
|
//// To Do: ////
|
12 |
|
|
//// Nothing ////
|
13 |
|
|
//// ////
|
14 |
|
|
//// Author(s): ////
|
15 |
|
|
//// - Damjan Lampret, lampret@opencores.org ////
|
16 |
|
|
//// ////
|
17 |
|
|
//////////////////////////////////////////////////////////////////////
|
18 |
|
|
//// ////
|
19 |
|
|
//// Copyright (C) 2000 Authors and OPENCORES.ORG ////
|
20 |
|
|
//// ////
|
21 |
|
|
//// This source file may be used and distributed without ////
|
22 |
|
|
//// restriction provided that this copyright statement is not ////
|
23 |
|
|
//// removed from the file and that any derivative work contains ////
|
24 |
|
|
//// the original copyright notice and the associated disclaimer. ////
|
25 |
|
|
//// ////
|
26 |
|
|
//// This source file is free software; you can redistribute it ////
|
27 |
|
|
//// and/or modify it under the terms of the GNU Lesser General ////
|
28 |
|
|
//// Public License as published by the Free Software Foundation; ////
|
29 |
|
|
//// either version 2.1 of the License, or (at your option) any ////
|
30 |
|
|
//// later version. ////
|
31 |
|
|
//// ////
|
32 |
|
|
//// This source is distributed in the hope that it will be ////
|
33 |
|
|
//// useful, but WITHOUT ANY WARRANTY; without even the implied ////
|
34 |
|
|
//// warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR ////
|
35 |
|
|
//// PURPOSE. See the GNU Lesser General Public License for more ////
|
36 |
|
|
//// details. ////
|
37 |
|
|
//// ////
|
38 |
|
|
//// You should have received a copy of the GNU Lesser General ////
|
39 |
|
|
//// Public License along with this source; if not, download it ////
|
40 |
|
|
//// from http://www.opencores.org/lgpl.shtml ////
|
41 |
|
|
//// ////
|
42 |
|
|
//////////////////////////////////////////////////////////////////////
|
43 |
|
|
//
|
44 |
|
|
// CVS Revision History
|
45 |
|
|
//
|
46 |
|
|
// $Log: not supported by cvs2svn $
|
47 |
21 |
lampret |
// Revision 1.2 2001/11/15 02:24:37 lampret
|
48 |
|
|
// Added GPIO_REGISTERED_WB_OUTPUTS, GPIO_REGISTERED_IO_OUTPUTS and GPIO_NO_NEGEDGE_FLOPS.
|
49 |
|
|
//
|
50 |
17 |
lampret |
// Revision 1.1 2001/09/18 18:49:07 lampret
|
51 |
|
|
// Changed top level ptc into gpio_top. Changed defines.v into gpio_defines.v.
|
52 |
|
|
//
|
53 |
14 |
lampret |
// Revision 1.1 2001/08/21 21:39:28 lampret
|
54 |
|
|
// Changed directory structure, port names and drfines.
|
55 |
|
|
//
|
56 |
|
|
// Revision 1.3 2001/07/15 00:21:10 lampret
|
57 |
|
|
// Registers can be omitted and will have certain default values
|
58 |
|
|
//
|
59 |
|
|
// Revision 1.2 2001/07/14 20:39:26 lampret
|
60 |
|
|
// Better configurability.
|
61 |
|
|
//
|
62 |
|
|
// Revision 1.1 2001/06/05 07:45:26 lampret
|
63 |
|
|
// Added initial RTL and test benches. There are still some issues with these files.
|
64 |
|
|
//
|
65 |
|
|
//
|
66 |
|
|
|
67 |
|
|
//
|
68 |
|
|
// Number of GPIO I/O signals
|
69 |
|
|
//
|
70 |
|
|
// This is the most important parameter of the GPIO IP core. It defines how many
|
71 |
|
|
// I/O signals core has. Range is from 1 to 32. If more than 32 I/O signals are
|
72 |
|
|
// required, use several instances of GPIO IP core.
|
73 |
|
|
//
|
74 |
|
|
// Default is 16.
|
75 |
|
|
//
|
76 |
|
|
`define GPIO_IOS 16
|
77 |
|
|
|
78 |
|
|
//
|
79 |
|
|
// Undefine this one if you don't want to remove GPIO block from your design
|
80 |
|
|
// but you also don't need it. When it is undefined, all GPIO ports still
|
81 |
|
|
// remain valid and the core can be synthesized however internally there is
|
82 |
|
|
// no GPIO funationality.
|
83 |
|
|
//
|
84 |
|
|
// Defined by default (duhh !).
|
85 |
|
|
//
|
86 |
|
|
`define GPIO_IMPLEMENTED
|
87 |
|
|
|
88 |
17 |
lampret |
//
|
89 |
|
|
// Define to register all WISHBONE outputs.
|
90 |
|
|
//
|
91 |
|
|
// Register outputs if you are using GPIO core as a block and synthesizing
|
92 |
|
|
// and place&routing it separately from the rest of the system.
|
93 |
|
|
//
|
94 |
|
|
// If you do not need registered outputs, you can save some area by not defining
|
95 |
|
|
// this macro. By default it is defined.
|
96 |
|
|
//
|
97 |
|
|
`define GPIO_REGISTERED_WB_OUTPUTS
|
98 |
|
|
|
99 |
|
|
//
|
100 |
|
|
// Define to register all GPIO pad outputs.
|
101 |
|
|
//
|
102 |
|
|
// Register outputs if you are using GPIO core as a block and synthesizing
|
103 |
|
|
// and place&routing it separately from the rest of the system.
|
104 |
|
|
//
|
105 |
|
|
// If you do not need registered outputs, you can save some area by not defining
|
106 |
|
|
// this macro. By default it is defined.
|
107 |
|
|
//
|
108 |
|
|
`define GPIO_REGISTERED_IO_OUTPUTS
|
109 |
|
|
|
110 |
|
|
//
|
111 |
|
|
// Define to avoid using negative edge clock flip-flops for external clock
|
112 |
|
|
// (caused by RGPIO_CTRL[NEC] bit. Instead an inverted external clock with
|
113 |
|
|
// positive edge clock flip-flops will be used.
|
114 |
|
|
//
|
115 |
|
|
// By default it is defined.
|
116 |
|
|
//
|
117 |
|
|
`define GPIO_NO_NEGEDGE_FLOPS
|
118 |
|
|
|
119 |
14 |
lampret |
//
|
120 |
|
|
// Undefine if you don't need to read GPIO registers except for RGPIO_IN register.
|
121 |
|
|
// When it is undefined all reads of GPIO registers return RGPIO_IN register. This
|
122 |
|
|
// is usually useful if you want really small area (for example when implemented in
|
123 |
|
|
// FPGA).
|
124 |
|
|
//
|
125 |
|
|
// To follow GPIO IP core specification document this one must be defined. Also to
|
126 |
|
|
// successfully run the test bench it must be defined. By default it is defined.
|
127 |
|
|
//
|
128 |
|
|
`define GPIO_READREGS
|
129 |
|
|
|
130 |
|
|
//
|
131 |
|
|
// Full WISHBONE address decoding
|
132 |
|
|
//
|
133 |
|
|
// It is is undefined, partial WISHBONE address decoding is performed.
|
134 |
|
|
// Undefine it if you need to save some area.
|
135 |
|
|
//
|
136 |
|
|
// By default it is defined.
|
137 |
|
|
//
|
138 |
|
|
`define GPIO_FULL_DECODE
|
139 |
|
|
|
140 |
|
|
//
|
141 |
|
|
// Strict 32-bit WISHBONE access
|
142 |
|
|
//
|
143 |
|
|
// If this one is defined, all WISHBONE accesses must be 32-bit. If it is
|
144 |
|
|
// not defined, err_o is asserted whenever 8- or 16-bit access is made.
|
145 |
|
|
// Undefine it if you need to save some area.
|
146 |
|
|
//
|
147 |
|
|
// By default it is defined.
|
148 |
|
|
//
|
149 |
|
|
`define GPIO_STRICT_32BIT_ACCESS
|
150 |
|
|
|
151 |
|
|
//
|
152 |
|
|
// WISHBONE address bits used for full decoding of GPIO registers.
|
153 |
|
|
//
|
154 |
17 |
lampret |
`define GPIO_ADDRHH 6
|
155 |
14 |
lampret |
`define GPIO_ADDRHL 5
|
156 |
|
|
`define GPIO_ADDRLH 1
|
157 |
|
|
`define GPIO_ADDRLL 0
|
158 |
|
|
|
159 |
|
|
//
|
160 |
|
|
// Bits of WISHBONE address used for partial decoding of GPIO registers.
|
161 |
|
|
//
|
162 |
|
|
// Default 4:2.
|
163 |
|
|
//
|
164 |
|
|
`define GPIO_OFS_BITS `GPIO_ADDRHL-1:`GPIO_ADDRLH+1
|
165 |
|
|
|
166 |
|
|
//
|
167 |
|
|
// Addresses of GPIO registers
|
168 |
|
|
//
|
169 |
|
|
// To comply with GPIO IP core specification document they must go from
|
170 |
|
|
// address 0 to address 0x18 in the following order: RGPIO_IN, RGPIO_OUT,
|
171 |
|
|
// RGPIO_OE, RGPIO_INTE, RGPIO_PTRIG, RGPIO_AUX and RGPIO_CTRL
|
172 |
|
|
//
|
173 |
|
|
// If particular register is not needed, it's address definition can be omitted
|
174 |
|
|
// and the register will not be implemented. Instead a fixed default value will
|
175 |
|
|
// be used.
|
176 |
|
|
//
|
177 |
|
|
`define GPIO_RGPIO_IN 3'h0 // Address 0x00
|
178 |
|
|
`define GPIO_RGPIO_OUT 3'h1 // Address 0x04
|
179 |
|
|
`define GPIO_RGPIO_OE 3'h2 // Address 0x08
|
180 |
|
|
`define GPIO_RGPIO_INTE 3'h3 // Address 0x0c
|
181 |
|
|
`define GPIO_RGPIO_PTRIG 3'h4 // Address 0x10
|
182 |
|
|
`define GPIO_RGPIO_AUX 3'h5 // Address 0x14
|
183 |
|
|
`define GPIO_RGPIO_CTRL 3'h6 // Address 0x18
|
184 |
21 |
lampret |
`define GPIO_RGPIO_INTS 3'h7 // Address 0x1c
|
185 |
14 |
lampret |
|
186 |
|
|
//
|
187 |
|
|
// Default values for unimplemented GPIO registers
|
188 |
|
|
//
|
189 |
|
|
`define GPIO_DEF_RGPIO_IN `GPIO_IOS'h0
|
190 |
|
|
`define GPIO_DEF_RGPIO_OUT `GPIO_IOS'h0
|
191 |
|
|
`define GPIO_DEF_RGPIO_OE `GPIO_IOS'h0
|
192 |
|
|
`define GPIO_DEF_RGPIO_INTE `GPIO_IOS'h0
|
193 |
|
|
`define GPIO_DEF_RGPIO_PTRIG `GPIO_IOS'h0
|
194 |
|
|
`define GPIO_DEF_RGPIO_AUX `GPIO_IOS'h0
|
195 |
|
|
`define GPIO_DEF_RGPIO_CTRL `GPIO_IOS'h0
|
196 |
|
|
|
197 |
|
|
//
|
198 |
|
|
// RGPIO_CTRL bits
|
199 |
|
|
//
|
200 |
|
|
// To comply with the GPIO IP core specification document they must go from
|
201 |
|
|
// bit 0 to bit 3 in the following order: ECLK, NEC, INTE, INT
|
202 |
|
|
//
|
203 |
|
|
`define GPIO_RGPIO_CTRL_ECLK 0
|
204 |
|
|
`define GPIO_RGPIO_CTRL_NEC 1
|
205 |
|
|
`define GPIO_RGPIO_CTRL_INTE 2
|
206 |
21 |
lampret |
`define GPIO_RGPIO_CTRL_INTS 3
|