1 package edu.berkeley.fleet.fpga;
2 import edu.berkeley.fleet.fpga.*;
3 import edu.berkeley.fleet.doc.*;
4 import edu.berkeley.fleet.api.*;
5 import edu.berkeley.fleet.ies44.*;
6 import edu.berkeley.fleet.*;
7 import java.lang.reflect.*;
8 import edu.berkeley.sbp.chr.*;
9 import edu.berkeley.sbp.misc.*;
10 import edu.berkeley.sbp.meta.*;
11 import edu.berkeley.sbp.util.*;
15 public class Fpga extends Fleet {
17 public ArrayList<FpgaShip> shiplist = new ArrayList<FpgaShip>();
18 public HashMap<String,FpgaShip> ships = new HashMap<String,FpgaShip>();
19 public Iterator<Ship> iterator() { return (Iterator<Ship>)(Object)shiplist.iterator(); }
21 private String bitfile;
23 public static void main(String[] s) throws Exception {
24 new Fpga().dumpFabric(false);
27 public Fpga() { this("gaspified.bit"); }
28 public Fpga(String bitfile) {
29 this.bitfile = bitfile;
30 createShip("Debug", "debug");
31 createShip("Memory", "memory");
32 createShip("Memory", "memory2"); // need this to avoid a bug
33 createShip("Fifo", "fifo1");
34 createShip("Fifo", "fifo2");
35 createShip("Alu2", "alu2a");
36 createShip("BitFifo", "bitfifo");
37 // above is the minimal ship set needed to run the regression suite, excluding "ships" tests
39 createShip("Fifo", "fifo3");
40 createShip("Alu1", "alu1");
41 createShip("Lut3", "lut3");
42 createShip("Choice", "Choice");
43 createShip("Stack", "Stack");
44 createShip("Alu3", "alu3");
46 // above is the minimal ship set needed to run the regression suite, including "ships" tests
48 // below are extra bonus ships
50 createShip("Alu2", "alu2b");
51 createShip("Alu2", "alu2c");
52 createShip("Alu2", "alu2d");
53 createShip("Fifo", "fifo4");
54 createShip("Memory", "Memory");
55 createShip("Choice", "Choice");
56 createShip("Choice", "Choice");
57 createShip("Choice", "Choice");
62 public Ship createShip(String type, String name) {
64 ShipDescription sd = new ShipDescription(name, new BufferedReader(new InputStreamReader(new FileInputStream("ships/"+type+".ship"))));
65 FpgaShip ship = new FpgaShip(this, name, type, sd);
66 ships.put(name, ship);
69 } catch (IOException e) { throw new RuntimeException(e); }
72 public FleetProcess run(final byte[] instructions) {
74 return new Client(bitfile, instructions);
75 } catch (IOException e) { throw new RuntimeException(e); }
78 public void dumpFabric(boolean quiet) {
79 // FIXME: this is really ugly: the order of port declarations in
80 // the XXXShip.java file must match the order in the .balsa file!
82 ArrayList instructionports = new ArrayList<FpgaPump>();
83 for(FpgaShip ship : shiplist)
84 for(Pump port : ship.getPumps())
85 if (!((FpgaPump)port).special())
86 instructionports.add(port);
87 FabricTree instructions =
88 new FabricTree((FpgaPump[])instructionports.toArray(new FpgaPump[0]),
92 ArrayList inputports = new ArrayList<FpgaPump>();
93 for(FpgaShip ship : shiplist)
94 for(Pump port : ship.getPumps())
95 if (!((FpgaPump)port).special())
98 new FabricTree((FpgaPump[])inputports.toArray(new FpgaPump[0]),
102 ArrayList outputports = new ArrayList<FpgaPump>();
103 for(FpgaShip ship : shiplist)
104 for(Pump port : ship.getPumps())
105 if (!((FpgaPump)port).special() || ((FpgaPump)port).dhorn())
106 outputports.add(port);
108 new FabricTree((FpgaPump[])outputports.toArray(new FpgaPump[0]),
112 ArrayList ihornports = new ArrayList<FpgaPump>();
113 for(FpgaShip ship : shiplist)
114 for(Pump port : ship.getPumps())
115 if (((FpgaPump)port).ihorn())
116 ihornports.add(port);
118 new FabricTree((FpgaPump[])ihornports.toArray(new FpgaPump[0]),
123 System.out.println("`include \"macros.v\"");
124 System.out.println("module fabric(clk, data_Memory0_command_r, data_Memory0_command_a, data_Memory0_command,");
125 System.out.println(" data_Debug0_out_r, data_Debug0_out_a, data_Debug0_out);");
126 System.out.println(" input clk;");
127 System.out.println(" input data_Memory0_command_r;");
128 System.out.println(" output data_Memory0_command_a;");
129 System.out.println(" output data_Debug0_out_r;");
130 System.out.println(" input data_Debug0_out_a;");
131 System.out.println(" output [(`PACKET_WIDTH-1):0] data_Debug0_out;");
132 System.out.println(" input [(`PACKET_WIDTH-1):0] data_Memory0_command;");
133 //System.out.println(" wire [(`INSTRUCTION_WIDTH-1):0] data_Memory0_ihorn;");
134 //System.out.println(" wire [(`PACKET_WIDTH-1):0] data_Memory0_dhorn;");
135 System.out.println();
137 System.out.println();
139 instructions.dumpChannels(true);
140 outputs.dumpChannels(true);
141 inputs.dumpChannels(true);
142 ihorns.dumpChannels(true);
143 for(FpgaShip ship : shiplist)
144 for(Pump port : ship.getPumps())
145 if (!((FpgaPump)port).special() || ((FpgaPump)port).dhorn())
146 System.out.println(" wire [(`PACKET_WIDTH-1):0] data_"
147 +getUniqueName(ship)+"_"+port.getName()+";");
149 System.out.println("wire [(`PACKET_WIDTH-1):0] ihornleft;");
151 System.out.println("");
152 instructions.dumpChannels(false);
153 System.out.println("");
154 outputs.dumpChannels(false);
155 System.out.println("");
156 inputs.dumpChannels(false);
157 System.out.println("");
158 ihorns.dumpChannels(false);
159 System.out.println("");
160 for(FpgaShip ship : shiplist) {
161 System.out.print(ship.getType().toLowerCase());
162 System.out.print(" ");
163 System.out.print("krunk"+(krunk++));
164 System.out.print("(clk, ");
165 boolean first = true;
166 for(Pump port : ship.getPumps()) {
167 if (!first) System.out.print(", ");
169 String prefix = "data_";
170 if (((FpgaPump)port).ihorn()) prefix = "ihorn_";
171 if (((FpgaPump)port).dhorn()) prefix = "source_";
172 System.out.print(prefix+getUniqueName(port.getShip())+"_"+port.getName()+"_r, ");
173 System.out.print(prefix+getUniqueName(port.getShip())+"_"+port.getName()+"_a, ");
174 System.out.print(prefix+getUniqueName(port.getShip())+"_"+port.getName());
175 System.out.print(" ");
177 System.out.println(");");
179 for(Pump port : ship.getPumps()) {
180 if (((FpgaPump)port).special()) continue;
181 if (((FpgaPump)port).inbox) {
182 System.out.print("inbox");
184 System.out.print("outbox");
186 System.out.print(" krunk"+(krunk++)+"(clk, ");
187 System.out.print("instruction_"+getUniqueName(port.getShip())+"_"+port.getName()+"_r, ");
188 System.out.print("instruction_"+getUniqueName(port.getShip())+"_"+port.getName()+"_a, ");
189 System.out.print("`packet_data(instruction_"+getUniqueName(port.getShip())+"_"+port.getName()+"), ");
190 System.out.print("dest_"+getUniqueName(port.getShip())+"_"+port.getName()+"_r, ");
191 System.out.print("dest_"+getUniqueName(port.getShip())+"_"+port.getName()+"_a, ");
192 System.out.print("dest_"+getUniqueName(port.getShip())+"_"+port.getName()+", ");
193 System.out.print("source_"+getUniqueName(port.getShip())+"_"+port.getName()+"_r, ");
194 System.out.print("source_"+getUniqueName(port.getShip())+"_"+port.getName()+"_a, ");
195 System.out.print("source_"+getUniqueName(port.getShip())+"_"+port.getName()+", ");
196 System.out.print("data_"+getUniqueName(port.getShip())+"_"+port.getName()+"_r, ");
197 System.out.print("data_"+getUniqueName(port.getShip())+"_"+port.getName()+"_a, ");
198 System.out.print("data_"+getUniqueName(port.getShip())+"_"+port.getName());
199 System.out.print(");");
200 System.out.println();
205 System.out.println("funnel ihornfun(clk,"+
206 " ihornleft_r, ihornleft_a, ihornleft,"+
207 " ihorn_r, ihorn_a, ihorn,"+
208 " source_r, source_a, source);");
209 System.out.println("horn tophorn(clk,"+
210 " ihornleft_r, ihornleft_a, ihornleft,"+
211 " instruction_r, instruction_a, instruction,"+
212 " dest_r, dest_a, dest);");
214 System.out.println("assign instruction_r = ihorn_r;");
215 System.out.println("assign ihorn_a = instruction_a;");
216 System.out.println("assign instruction = ihorn;");
217 System.out.println("assign dest_r = source_r;");
218 System.out.println("assign source_a = dest_a;");
219 System.out.println("assign dest = source;");
221 System.out.println("endmodule");
224 private static class FabricTree {
228 public void dumpChannels(boolean decl) { root.dumpChannels(0, decl); }
229 public FabricTree(FpgaPump[] ports, String component, String prefix) {
230 this.prefix = prefix;
231 root = (Node)mkNode("", component, ports, 0, ports.length, 0, 0);
233 private Object mkNode(String name, String component, FpgaPump[] ports,
234 int start, int end, int addr, int bits) {
235 if (end-start == 0) return null;
236 if (end-start == 1) {
237 FpgaPump p = ports[start];
238 if (prefix.equals("instruction")) {
239 p.instr_addr = (addr<<1);
240 p.instr_bits = bits+1;
241 } else if (prefix.equals("dest")) {
242 p.addr = (addr << 1) | 1;
245 throw new RuntimeException("too many pumps!");
247 for(Destination d : p.getDestinations()) {
248 if (!(d instanceof FpgaPump.VirtualPort)) continue;
249 FpgaPump.VirtualPort vp = (FpgaPump.VirtualPort)d;
250 vp.addr = p.addr | (count << bits);
260 if (end-start <= 2) {
261 breakpt = (start+end)/2;
263 for(int i=start; i<end; i++)
264 count += count(ports[i].getDestinations());
265 for(int i=start; i<end-1; i++) {
266 count2 += count(ports[i].getDestinations());
268 if (i>start && count2 >= count/2) break;
271 return new Node(name,
273 mkNode(name+"_0", component, ports, start, breakpt, addr, bits+1),
274 mkNode(name+"_1", component, ports, breakpt, end, addr | (1 << bits), bits+1),
278 private String describe(String prefix, Object o) {
279 if (o==null) return null;
280 if (o instanceof FpgaPump) {
281 FpgaPump p = (FpgaPump)o;
282 return prefix+"_"+getUniqueName(p.getShip())+"_"+p.getName();
284 if (o instanceof Node) {
285 return ((Node)o).describe(prefix);
296 public Node(String name, String component, Object left, Object right, int addr, int bits) {
300 this.component = component;
304 public void dumpChannels(int indentamount, boolean decl) {
306 for(int i=0; i<indentamount; i++) indent += " ";
308 String n = describe(prefix).startsWith("instruction")
309 ? "[(`PACKET_WIDTH-1):0]" : "[(`PACKET_WIDTH-1):0]";
310 System.out.println(" wire "+n+" "+indent+describe(prefix)+";");
312 System.out.println(" "+indent+
314 "krunk"+(krunk++)+"(clk, "+
315 describe(prefix)+"_r, "+
316 describe(prefix)+"_a, "+
317 describe(prefix)+", "+
318 FabricTree.this.describe(prefix, left)+"_r, "+
319 FabricTree.this.describe(prefix, left)+"_a, "+
320 FabricTree.this.describe(prefix, left)+", "+
321 FabricTree.this.describe(prefix, right)+"_r, "+
322 FabricTree.this.describe(prefix, right)+"_a, "+
323 FabricTree.this.describe(prefix, right)+
326 dumpChannels(left, indentamount+1, decl);
327 dumpChannels(right, indentamount+1, decl);
329 public void dumpChannels(Object o, int indentamount, boolean decl) {
331 if (o instanceof Node) {
332 ((Node)o).dumpChannels(indentamount, decl);
335 for(int i=0; i<indentamount; i++) indent += " ";
337 String n = FabricTree.this.describe(prefix,o).startsWith("instruction")
338 ? "[(`PACKET_WIDTH-1):0]" : "[(`PACKET_WIDTH-1):0]";
339 System.out.println(" wire "+n+" "+indent+FabricTree.this.describe(prefix,o)+";");
343 public String describe(String prefix) {
348 public static int krunk=0;
350 private static String getUniqueName(Ship ship) {
351 return ship.getType() + ship.getOrdinal();
354 private static int count(Iterable<Destination> it) {
356 for(Destination d : it)
361 public void expand(ShipDescription sd) {
363 if (sd.getSection("fpga")==null) return;
364 String filename = sd.getName().toLowerCase();
365 File outf = new File("build/fpga/"+filename+".v");
366 new File(outf.getParent()).mkdirs();
367 System.err.println("writing to " + outf);
368 FileOutputStream out = new FileOutputStream(outf);
369 PrintWriter pw = new PrintWriter(out);
372 !"debug".equals(filename) &&
373 !"execute".equals(filename) &&
374 !"memory".equals(filename) &&
375 !"fifo".equals(filename);
377 pw.println("`include \"macros.v\"");
379 pw.println("module " + filename + "( clk");
380 for(PumpDescription bb : sd) {
381 String bb_name = bb.getName();
384 pw.print(", " + bb_name+"_r");
385 pw.print(", " + bb_name+"_a_");
386 pw.print(", " + bb_name+"_d");
388 pw.print(", " + bb_name+"_r_");
389 pw.print(", " + bb_name+"_a");
390 pw.print(", " + bb_name+"_d_");
396 pw.println(" input clk;");
397 for(PumpDescription bb : sd) {
398 String bb_name = bb.getName();
401 pw.println("`input(" +
405 "[(`PACKET_WIDTH-1):0],"+
409 pw.println("`output(" +
413 "[(`PACKET_WIDTH-1):0],"+
416 pw.println("`defreg(" +
418 "[(`PACKET_WIDTH-1):0],"+
426 pw.println(sd.getSection("fpga"));
429 pw.println("endmodule");
433 } catch (Exception e) { throw new RuntimeException(e); }
436 public int computeOffset(int origin, int target) { return (target - origin)/6; }
437 public int computeTarget(int origin, int offset) { return origin + (offset*6); }
439 private FpgaInstructionEncoder iie = new FpgaInstructionEncoder();
440 public Instruction readInstruction(DataInputStream is) throws IOException { return iie.readInstruction(is); }
441 public Instruction readInstruction(long instr) { return iie.readInstruction(instr); }
442 public long writeInstruction(Instruction d) { return writeInstruction(d); }
443 public void writeInstruction(DataOutputStream os, Instruction d) throws IOException { iie.writeInstruction(os, d); }
445 private class FpgaInstructionEncoder extends InstructionEncoder {
446 public long getDestAddr(Destination box) { return ((FpgaPump.VirtualPort)box).addr; }
447 public long getBoxInstAddr(Pump box) { return ((FpgaPump)box).instr_addr; }
448 public Destination getDestByAddr(long dest) {
449 for(Ship ship : Fpga.this)
450 for(Pump bb : ship.getPumps())
451 for(Destination d : bb.getDestinations())
452 if (getDestAddr(d)==dest)
456 public Pump getBoxByInstAddr(long dest) {
457 for(Ship ship : Fpga.this)
458 for(Pump bb : ship.getPumps())
459 if (((FpgaPump)bb).instr_addr == dest)