BSV by Example - Computation Structures Group

15 Importing existing RTL into a BSV design 150
15.1 Using an existing interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
15.1.1 Module header definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
15.1.2 Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
15.1.3 Clocks and Resets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
15.1.4 Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
15.2 Defining a new interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
A Source Files 157
A.1 Getting started with BSV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
A.1.1 A simple example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
A.1.2 Testbench communicating with DUT . . . . . . . . . . . . . . . . . . . . . . . 158
A.1.3 Multiple packages in a single design . . . . . . . . . . . . . . . . . . . . . . . 158
A.2 Data types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
A.2.1 Using abstract types instead of Bit . . . . . . . . . . . . . . . . . . . . . . . . 159
A.2.2 Integers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
A.2.3 Strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
A.3 Variables, assignments, and combinational circuits . . . . . . . . . . . . . . . . . . . 163
A.3.1 Variable declaration and initialization . . . . . . . . . . . . . . . . . . . . . . 163
A.3.2 Combinational circuits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
A.4 Rules, registers, and FIFOs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
A.4.1 Defining and updating a Register . . . . . . . . . . . . . . . . . . . . . . . . . 165
A.4.2 Composition of rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
A.4.3 Multiple registers in a rigid pipeline . . . . . . . . . . . . . . . . . . . . . . . 166
A.4.4 Using register syntax shorthand . . . . . . . . . . . . . . . . . . . . . . . . . . 167
A.4.5 Using valid bits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
A.4.6 Asynchronous pipeline using FIFOs . . . . . . . . . . . . . . . . . . . . . . . 170
A.5 Module hierarchy and interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
A.5.1 Module hierarchies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
A.5.2 Implicit conditions of methods . . . . . . . . . . . . . . . . . . . . . . . . . . 172
A.5.3 ActionValue method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
A.5.4 ActionValue method with type error . . . . . . . . . . . . . . . . . . . . . . . 174
A.5.5 ActionValue method with error in rule condition . . . . . . . . . . . . . . . . 174
A.5.6 Defining an Action function . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
A.5.7 Nested interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
A.5.8 Standard connectivity interfaces . . . . . . . . . . . . . . . . . . . . . . . . . 178
A.6 Scheduling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
6