1 package net.mograsim.logic.core.tests;
3 import static org.junit.jupiter.api.Assertions.assertArrayEquals;
4 import static org.junit.jupiter.api.Assertions.assertEquals;
5 import static org.junit.jupiter.api.Assertions.fail;
7 import java.util.function.LongConsumer;
9 import org.junit.jupiter.api.Test;
11 import net.mograsim.logic.core.components.Connector;
12 import net.mograsim.logic.core.components.Demux;
13 import net.mograsim.logic.core.components.Merger;
14 import net.mograsim.logic.core.components.Mux;
15 import net.mograsim.logic.core.components.Splitter;
16 import net.mograsim.logic.core.components.TriStateBuffer;
17 import net.mograsim.logic.core.components.gates.AndGate;
18 import net.mograsim.logic.core.components.gates.NandGate;
19 import net.mograsim.logic.core.components.gates.NorGate;
20 import net.mograsim.logic.core.components.gates.NotGate;
21 import net.mograsim.logic.core.components.gates.OrGate;
22 import net.mograsim.logic.core.components.gates.XorGate;
23 import net.mograsim.logic.core.timeline.Timeline;
24 import net.mograsim.logic.core.types.Bit;
25 import net.mograsim.logic.core.types.BitVector;
26 import net.mograsim.logic.core.wires.Wire;
27 import net.mograsim.logic.core.wires.Wire.ReadEnd;
28 import net.mograsim.logic.core.wires.Wire.ReadWriteEnd;
30 @SuppressWarnings("unused")
33 private Timeline t = new Timeline(11);
36 void circuitExampleTest()
38 Wire a = new Wire(t, 1, 1), b = new Wire(t, 1, 1), c = new Wire(t, 1, 10), d = new Wire(t, 2, 1), e = new Wire(t, 1, 1),
39 f = new Wire(t, 1, 1), g = new Wire(t, 1, 1), h = new Wire(t, 2, 1), i = new Wire(t, 2, 1), j = new Wire(t, 1, 1),
40 k = new Wire(t, 1, 1);
41 new AndGate(t, 1, f.createReadWriteEnd(), a.createReadOnlyEnd(), b.createReadOnlyEnd());
42 new NotGate(t, 1, f.createReadOnlyEnd(), g.createReadWriteEnd());
43 new Merger(t, h.createReadWriteEnd(), c.createReadOnlyEnd(), g.createReadOnlyEnd());
44 new Mux(t, 1, i.createReadWriteEnd(), e.createReadOnlyEnd(), h.createReadOnlyEnd(), d.createReadOnlyEnd());
45 new Splitter(t, i.createReadOnlyEnd(), k.createReadWriteEnd(), j.createReadWriteEnd());
47 a.createReadWriteEnd().feedSignals(Bit.ZERO);
48 b.createReadWriteEnd().feedSignals(Bit.ONE);
49 c.createReadWriteEnd().feedSignals(Bit.ZERO);
50 d.createReadWriteEnd().feedSignals(Bit.ONE, Bit.ONE);
51 e.createReadWriteEnd().feedSignals(Bit.ZERO);
55 assertEquals(Bit.ONE, j.getValue());
56 assertEquals(Bit.ZERO, k.getValue());
63 Wire a = new Wire(t, 3, 1), b = new Wire(t, 2, 1), c = new Wire(t, 3, 1), in = new Wire(t, 8, 1);
64 in.createReadWriteEnd().feedSignals(Bit.ZERO, Bit.ONE, Bit.ZERO, Bit.ONE, Bit.ZERO, Bit.ONE, Bit.ZERO, Bit.ONE);
65 new Splitter(t, in.createReadOnlyEnd(), a.createReadWriteEnd(), b.createReadWriteEnd(), c.createReadWriteEnd());
69 assertBitArrayEquals(a.getValues(), Bit.ZERO, Bit.ONE, Bit.ZERO);
70 assertBitArrayEquals(b.getValues(), Bit.ONE, Bit.ZERO);
71 assertBitArrayEquals(c.getValues(), Bit.ONE, Bit.ZERO, Bit.ONE);
78 Wire a = new Wire(t, 3, 1), b = new Wire(t, 2, 1), c = new Wire(t, 3, 1), out = new Wire(t, 8, 1);
79 a.createReadWriteEnd().feedSignals(Bit.ZERO, Bit.ONE, Bit.ZERO);
80 b.createReadWriteEnd().feedSignals(Bit.ONE, Bit.ZERO);
81 c.createReadWriteEnd().feedSignals(Bit.ONE, Bit.ZERO, Bit.ONE);
83 new Merger(t, out.createReadWriteEnd(), a.createReadOnlyEnd(), b.createReadOnlyEnd(), c.createReadOnlyEnd());
87 assertBitArrayEquals(out.getValues(), Bit.ZERO, Bit.ONE, Bit.ZERO, Bit.ONE, Bit.ZERO, Bit.ONE, Bit.ZERO, Bit.ONE);
94 Wire a = new Wire(t, 3, 1), b = new Wire(t, 2, 1), c = new Wire(t, 3, 1), out = new Wire(t, 8, 1);
95 Wire.fuse(a, out, 0, 0, a.length);
96 Wire.fuse(b, out, 0, a.length, b.length);
97 Wire.fuse(c, out, 0, a.length + b.length, c.length);
98 ReadWriteEnd rA = a.createReadWriteEnd();
99 rA.feedSignals(Bit.ZERO, Bit.ONE, Bit.ZERO);
100 ReadWriteEnd rB = b.createReadWriteEnd();
101 rB.feedSignals(Bit.ONE, Bit.ZERO);
102 ReadWriteEnd rC = c.createReadWriteEnd();
103 rC.feedSignals(Bit.ONE, Bit.ZERO, Bit.ONE);
105 assertBitArrayEquals(out.getValues(), Bit.ZERO, Bit.ONE, Bit.ZERO, Bit.ONE, Bit.ZERO, Bit.ONE, Bit.ZERO, Bit.ONE);
106 out.createReadWriteEnd().feedSignals(Bit.ONE, Bit.ZERO, Bit.ONE, Bit.ZERO, Bit.ONE, Bit.ZERO, Bit.ONE, Bit.ZERO);
108 assertBitArrayEquals(rA.getValues(), Bit.X, Bit.X, Bit.X);
109 assertBitArrayEquals(rB.getValues(), Bit.X, Bit.X);
110 assertBitArrayEquals(rC.getValues(), Bit.X, Bit.X, Bit.X);
115 assertBitArrayEquals(rA.getValues(), Bit.ONE, Bit.ZERO, Bit.ONE);
116 assertBitArrayEquals(rB.getValues(), Bit.ZERO, Bit.ONE);
117 assertBitArrayEquals(rC.getValues(), Bit.ZERO, Bit.ONE, Bit.ZERO);
121 void triStateBufferTest()
123 Wire a = new Wire(t, 1, 1), b = new Wire(t, 1, 1), en = new Wire(t, 1, 1), notEn = new Wire(t, 1, 1);
124 new NotGate(t, 1, en.createReadOnlyEnd(), notEn.createReadWriteEnd());
125 new TriStateBuffer(t, 1, a.createReadOnlyEnd(), b.createReadWriteEnd(), en.createReadOnlyEnd());
126 new TriStateBuffer(t, 1, b.createReadOnlyEnd(), a.createReadWriteEnd(), notEn.createReadOnlyEnd());
128 ReadWriteEnd enI = en.createReadWriteEnd(), aI = a.createReadWriteEnd(), bI = b.createReadWriteEnd();
129 enI.feedSignals(Bit.ONE);
130 aI.feedSignals(Bit.ONE);
131 bI.feedSignals(Bit.Z);
135 assertEquals(Bit.ONE, b.getValue());
137 bI.feedSignals(Bit.ZERO);
141 assertEquals(Bit.X, b.getValue());
142 assertEquals(Bit.ONE, a.getValue());
145 enI.feedSignals(Bit.ZERO);
149 assertEquals(Bit.ZERO, a.getValue());
157 Wire a = new Wire(t, 4, 3), b = new Wire(t, 4, 6), c = new Wire(t, 4, 4), select = new Wire(t, 2, 5), out = new Wire(t, 4, 1);
158 ReadWriteEnd selectIn = select.createReadWriteEnd();
160 selectIn.feedSignals(Bit.ZERO, Bit.ZERO);
161 a.createReadWriteEnd().feedSignals(Bit.ONE, Bit.ZERO, Bit.ONE, Bit.ZERO);
162 c.createReadWriteEnd().feedSignals(Bit.ZERO, Bit.ONE, Bit.ZERO, Bit.ONE);
164 new Mux(t, 1, out.createReadWriteEnd(), select.createReadOnlyEnd(), a.createReadOnlyEnd(), b.createReadOnlyEnd(),
165 c.createReadOnlyEnd());
168 assertBitArrayEquals(out.getValues(), Bit.ONE, Bit.ZERO, Bit.ONE, Bit.ZERO);
169 selectIn.feedSignals(Bit.ZERO, Bit.ONE);
172 assertBitArrayEquals(out.getValues(), Bit.ZERO, Bit.ONE, Bit.ZERO, Bit.ONE);
174 selectIn.feedSignals(Bit.ONE, Bit.ONE);
177 assertBitArrayEquals(out.getValues(), Bit.Z, Bit.Z, Bit.Z, Bit.Z);
185 Wire a = new Wire(t, 4, 3), b = new Wire(t, 4, 6), c = new Wire(t, 4, 4), select = new Wire(t, 2, 5), in = new Wire(t, 4, 1);
186 ReadWriteEnd selectIn = select.createReadWriteEnd();
188 selectIn.feedSignals(Bit.ZERO, Bit.ZERO);
189 in.createReadWriteEnd().feedSignals(Bit.ONE, Bit.ZERO, Bit.ONE, Bit.ZERO);
191 new Demux(t, 1, in.createReadOnlyEnd(), select.createReadOnlyEnd(), a.createReadWriteEnd(), b.createReadWriteEnd(),
192 c.createReadWriteEnd());
195 assertBitArrayEquals(a.getValues(), Bit.ONE, Bit.ZERO, Bit.ONE, Bit.ZERO);
196 assertBitArrayEquals(b.getValues(), Bit.U, Bit.U, Bit.U, Bit.U);
197 assertBitArrayEquals(c.getValues(), Bit.U, Bit.U, Bit.U, Bit.U);
198 selectIn.feedSignals(Bit.ZERO, Bit.ONE);
201 assertBitArrayEquals(a.getValues(), Bit.Z, Bit.Z, Bit.Z, Bit.Z);
202 assertBitArrayEquals(b.getValues(), Bit.U, Bit.U, Bit.U, Bit.U);
203 assertBitArrayEquals(c.getValues(), Bit.ONE, Bit.ZERO, Bit.ONE, Bit.ZERO);
205 selectIn.feedSignals(Bit.ONE, Bit.ONE);
208 assertBitArrayEquals(a.getValues(), Bit.Z, Bit.Z, Bit.Z, Bit.Z);
209 assertBitArrayEquals(b.getValues(), Bit.U, Bit.U, Bit.U, Bit.U);
210 assertBitArrayEquals(c.getValues(), Bit.Z, Bit.Z, Bit.Z, Bit.Z);
218 Wire a = new Wire(t, 4, 1), b = new Wire(t, 4, 3), c = new Wire(t, 4, 1);
219 new AndGate(t, 1, c.createReadWriteEnd(), a.createReadOnlyEnd(), b.createReadOnlyEnd());
220 a.createReadWriteEnd().feedSignals(Bit.ONE, Bit.ONE, Bit.ZERO, Bit.ZERO);
221 b.createReadWriteEnd().feedSignals(Bit.ZERO, Bit.ONE, Bit.ZERO, Bit.ONE);
225 assertBitArrayEquals(c.getValues(), Bit.ZERO, Bit.ONE, Bit.ZERO, Bit.ZERO);
232 Wire a = new Wire(t, 4, 1), b = new Wire(t, 4, 3), c = new Wire(t, 4, 1);
233 new OrGate(t, 1, c.createReadWriteEnd(), a.createReadOnlyEnd(), b.createReadOnlyEnd());
234 a.createReadWriteEnd().feedSignals(Bit.ONE, Bit.ONE, Bit.ZERO, Bit.ZERO);
235 b.createReadWriteEnd().feedSignals(Bit.ZERO, Bit.ONE, Bit.ZERO, Bit.ONE);
239 assertBitArrayEquals(c.getValues(), Bit.ONE, Bit.ONE, Bit.ZERO, Bit.ONE);
246 Wire a = new Wire(t, 4, 1), b = new Wire(t, 4, 3), c = new Wire(t, 4, 1), d = new Wire(t, 4, 1);
247 new NandGate(t, 1, d.createReadWriteEnd(), a.createReadOnlyEnd(), b.createReadOnlyEnd(), c.createReadOnlyEnd());
248 a.createReadWriteEnd().feedSignals(Bit.ONE, Bit.ONE, Bit.ZERO, Bit.ZERO);
249 b.createReadWriteEnd().feedSignals(Bit.ZERO, Bit.ONE, Bit.ZERO, Bit.ONE);
250 c.createReadWriteEnd().feedSignals(Bit.ONE, Bit.ONE, Bit.ZERO, Bit.ZERO);
254 assertBitArrayEquals(d.getValues(), Bit.ONE, Bit.ZERO, Bit.ONE, Bit.ONE);
261 Wire a = new Wire(t, 4, 1), b = new Wire(t, 4, 3), c = new Wire(t, 4, 1), d = new Wire(t, 4, 1);
262 new NorGate(t, 1, d.createReadWriteEnd(), a.createReadOnlyEnd(), b.createReadOnlyEnd(), c.createReadOnlyEnd());
263 a.createReadWriteEnd().feedSignals(Bit.ONE, Bit.ONE, Bit.ZERO, Bit.ZERO);
264 b.createReadWriteEnd().feedSignals(Bit.ZERO, Bit.ONE, Bit.ZERO, Bit.ONE);
265 c.createReadWriteEnd().feedSignals(Bit.ONE, Bit.ONE, Bit.ZERO, Bit.ZERO);
269 assertBitArrayEquals(d.getValues(), Bit.ZERO, Bit.ZERO, Bit.ONE, Bit.ZERO);
276 Wire a = new Wire(t, 3, 1), b = new Wire(t, 3, 2), c = new Wire(t, 3, 1), d = new Wire(t, 3, 1);
277 new XorGate(t, 1, d.createReadWriteEnd(), a.createReadOnlyEnd(), b.createReadOnlyEnd(), c.createReadOnlyEnd());
278 a.createReadWriteEnd().feedSignals(Bit.ZERO, Bit.ONE, Bit.ONE);
279 b.createReadWriteEnd().feedSignals(Bit.ONE, Bit.ZERO, Bit.ONE);
280 c.createReadWriteEnd().feedSignals(Bit.ONE, Bit.ZERO, Bit.ONE);
284 assertBitArrayEquals(d.getValues(), Bit.ZERO, Bit.ONE, Bit.ONE);
291 Wire a = new Wire(t, 3, 1), b = new Wire(t, 3, 2);
292 new NotGate(t, 1, a.createReadOnlyEnd(), b.createReadWriteEnd());
293 a.createReadWriteEnd().feedSignals(Bit.ZERO, Bit.ONE, Bit.ONE);
297 assertBitArrayEquals(b.getValues(), Bit.ONE, Bit.ZERO, Bit.ZERO);
301 void rsLatchCircuitTest()
304 Wire r = new Wire(t, 1, 1), s = new Wire(t, 1, 1), t1 = new Wire(t, 1, 15), t2 = new Wire(t, 1, 1), q = new Wire(t, 1, 1),
305 nq = new Wire(t, 1, 1);
307 new OrGate(t, 1, t2.createReadWriteEnd(), r.createReadOnlyEnd(), nq.createReadOnlyEnd());
308 new OrGate(t, 1, t1.createReadWriteEnd(), s.createReadOnlyEnd(), q.createReadOnlyEnd());
309 new NotGate(t, 1, t2.createReadOnlyEnd(), q.createReadWriteEnd());
310 new NotGate(t, 1, t1.createReadOnlyEnd(), nq.createReadWriteEnd());
312 ReadWriteEnd sIn = s.createReadWriteEnd(), rIn = r.createReadWriteEnd();
314 sIn.feedSignals(Bit.ONE);
315 rIn.feedSignals(Bit.ZERO);
319 assertEquals(Bit.ONE, q.getValue());
320 assertEquals(Bit.ZERO, nq.getValue());
322 sIn.feedSignals(Bit.ZERO);
325 assertEquals(Bit.ONE, q.getValue());
326 assertEquals(Bit.ZERO, nq.getValue());
328 rIn.feedSignals(Bit.ONE);
332 assertEquals(Bit.ZERO, q.getValue());
333 assertEquals(Bit.ONE, nq.getValue());
337 void numericValueTest()
341 Wire a = new Wire(t, 4, 1);
342 a.createReadWriteEnd().feedSignals(Bit.ONE, Bit.ONE, Bit.ONE, Bit.ONE);
346 assertEquals(15, a.getUnsignedValue());
347 assertEquals(-1, a.getSignedValue());
350 boolean flag = false;
353 void simpleTimelineTest()
355 Timeline t = new Timeline(3);
360 fail("Events executed out of order!");
366 fail("Events executed out of order!");
372 fail("Events executed out of order!");
377 fail("Only supposed to execute until timestamp 20, not 25");
380 t.executeUntil(t.laterThan(20), 100);
383 fail("Not all events were executed in order!");
387 void multipleInputs()
390 Wire w = new Wire(t, 2, 1);
391 ReadWriteEnd wI1 = w.createReadWriteEnd(), wI2 = w.createReadWriteEnd();
392 wI1.feedSignals(Bit.ONE, Bit.Z);
393 wI2.feedSignals(Bit.Z, Bit.X);
395 assertBitArrayEquals(w.getValues(), Bit.ONE, Bit.X);
397 wI2.feedSignals(Bit.ZERO, Bit.Z);
399 assertBitArrayEquals(w.getValues(), Bit.X, Bit.Z);
401 wI2.feedSignals(Bit.Z, Bit.Z);
403 assertBitArrayEquals(w.getValues(), Bit.ONE, Bit.Z);
405 wI2.feedSignals(Bit.ONE, Bit.Z);
406 ReadEnd rE = w.createReadOnlyEnd();
407 rE.registerObserver((i) -> fail("WireEnd notified observer, although value did not change."));
410 wI1.feedSignals(Bit.X, Bit.X);
412 wI1.registerObserver((i) -> fail("WireEnd notified observer, although it was closed."));
414 assertBitArrayEquals(w.getValues(), Bit.ONE, Bit.Z);
418 void wireConnections()
420 // Nur ein Experiment, was über mehrere 'passive' Bausteine hinweg passieren würde
424 Wire a = new Wire(t, 1, 2);
425 Wire b = new Wire(t, 1, 2);
426 Wire c = new Wire(t, 1, 2);
427 ReadWriteEnd aI = a.createReadWriteEnd();
428 ReadWriteEnd bI = b.createReadWriteEnd();
429 ReadWriteEnd cI = c.createReadWriteEnd();
431 TestBitDisplay test = new TestBitDisplay(t, c.createReadOnlyEnd());
432 TestBitDisplay test2 = new TestBitDisplay(t, a.createReadOnlyEnd());
433 LongConsumer print = time -> System.out.format("Time %2d\n a: %s\n b: %s\n c: %s\n", time, a, b, c);
435 cI.feedSignals(Bit.ONE);
436 test.assertAfterSimulationIs(print, Bit.ONE);
438 cI.feedSignals(Bit.X);
439 test.assertAfterSimulationIs(print, Bit.X);
441 cI.feedSignals(Bit.X);
442 cI.feedSignals(Bit.Z);
443 test.assertAfterSimulationIs(print, Bit.Z);
445 new Connector(t, b.createReadWriteEnd(), c.createReadWriteEnd()).connect();
446 test.assertAfterSimulationIs(print, Bit.Z);
447 System.err.println("ONE");
448 bI.feedSignals(Bit.ONE);
449 test.assertAfterSimulationIs(print, Bit.ONE);
450 System.err.println("ZERO");
451 bI.feedSignals(Bit.ZERO);
452 test.assertAfterSimulationIs(print, Bit.ZERO);
453 System.err.println("Z");
454 bI.feedSignals(Bit.Z);
455 test.assertAfterSimulationIs(print, Bit.Z);
457 new Connector(t, a.createReadWriteEnd(), b.createReadWriteEnd()).connect();
458 System.err.println("Z 2");
459 aI.feedSignals(Bit.Z);
460 test.assertAfterSimulationIs(print, Bit.Z);
461 test2.assertAfterSimulationIs(Bit.Z);
462 System.err.println("ONE 2");
463 aI.feedSignals(Bit.ONE);
464 test.assertAfterSimulationIs(print, Bit.ONE);
465 test2.assertAfterSimulationIs(Bit.ONE);
466 System.err.println("ZERO 2");
467 aI.feedSignals(Bit.ZERO);
468 test.assertAfterSimulationIs(print, Bit.ZERO);
469 test2.assertAfterSimulationIs(Bit.ZERO);
470 System.err.println("Z 2 II");
471 aI.feedSignals(Bit.Z);
472 test.assertAfterSimulationIs(print, Bit.Z);
473 test2.assertAfterSimulationIs(Bit.Z);
475 System.err.println("No Conflict yet");
476 bI.feedSignals(Bit.ONE);
477 test.assertAfterSimulationIs(print, Bit.ONE);
478 test2.assertAfterSimulationIs(Bit.ONE);
479 aI.feedSignals(Bit.ONE);
480 test.assertAfterSimulationIs(print, Bit.ONE);
481 test2.assertAfterSimulationIs(Bit.ONE);
482 System.err.println("Conflict");
483 aI.feedSignals(Bit.ZERO);
484 test.assertAfterSimulationIs(print, Bit.X);
485 test2.assertAfterSimulationIs(Bit.X);
486 aI.feedSignals(Bit.ONE);
487 test.assertAfterSimulationIs(print, Bit.ONE);
488 test2.assertAfterSimulationIs(Bit.ONE);
491 private static void assertBitArrayEquals(BitVector actual, Bit... expected)
493 assertArrayEquals(expected, actual.getBits());