Reference Card

coro: a coroutine; task: a running coroutine

Assign	`dut.mysignal.value = 0xFF00`
Assign immediately	`dut.mysignal.setimmediatevalue(0xFF00)`
Assign metavalue	`dut.mysignal.value = Logic("X")` `dut.mysignal.value = LogicArray("01XZ")` `dut.mysignal.value = BinaryValue("X")` (deprecated)
Read	`val = dut.mysignal.value` (`mysig = dut.mysignal` creates an alias/reference)
Bit slice	`mybit = dut.myarray[0].value` `mybits = dut.mysignal.value[0]`
Convert	`val = dut.mysignal.value.integer` `val = dut.mysignal.value.binstr`
Vector length	`num_bits = len(dut.mysignal)`
Check	`assert dut.mysignal.value == exp, "Not as expected!"`
Logging	`dut._log.info("Value is", dut.mysignal.value)`

Wait time	`await cocotb.triggers.Timer(12, "ns")`
Generate clock	`clk = await cocotb.start(Clock(dut.clk, 12, "ns").start())`
Wait for signal edge	`await cocotb.triggers.RisingEdge(dut.mysignal)` `await cocotb.triggers.FallingEdge(dut.mysignal)` `await cocotb.triggers.Edge(dut.mysignal)`
Run coros concurrently	`task_0 = await cocotb.start(coro_0())` (start coro now) `task_1 = cocotb.start_soon(coro)` `result = await task_0`
Resume on Task 0 or 1	`await cocotb.triggers.First(task_0, task_1)`
Resume on Task 0 and 1	`await cocotb.triggers.Combine(task_0, task_1)`
Kill coro	`task_0.kill()`

Queue write	`await cocotb.queue.Queue.put(item)` `cocotb.queue.Queue.put_nowait(item)`
Queue read	`item = await cocotb.queue.Queue.get()` `item = cocotb.queue.Queue.get_nowait()`
Queue attributes	`queue.maxsize` (`None` == unlimited) `queue.qsize()` `queue.empty()` `queue.full()`
Specialized queues	`.PriorityQueue`, `.LifoQueue`

Set up event	`e = cocotb.triggers.Event()`
Wake up waiters	`e.set()`
Wait until `set()`	`await e.wait()`
Reset after `set()`	`e.clear()`
Timeout	`await cocotb.triggers.with_timeout(coro, 1, "us")`

Force value	`dut.mysignal.value = cocotb.handle.Force(0xFF00)`
Keep value	`dut.mysignal.value = cocotb.handle.Freeze()`
Release Force/Freeze	`dut.mysignal.value = cocotb.handle.Release()`
Normal assignment is a “deposit” (`cocotb.handle.Deposit()`)

Mark as test	`@cocotb.test(skip, expect_fail, timeout_time, timeout_unit)`
Normal func → coro	`@cocotb.external()`
Allow func to block	`@cocotb.function()`

Set up TestFactory	`tf = cocotb.regression.TestFactory(coro)`
Add test option	`tf.add_option("arg", ["val0", "val1"])`
Generate tests	`tf.generate_tests()`