1
0
mirror of https://github.com/myhdl/myhdl.git synced 2025-01-24 21:52:56 +08:00
Josy Boelen a9d65c0f87
Class based design (#447)
* 1) added J. Villars code from PR#238 (https://github.com/myhdl/myhdl/pull/328)  to augment the `@block` decorator with arguments, initially to keep the generated names simpler especially when nesting `block`s without adding *hdl* code - I modified it a bit using `skipname=False` rather than `keepname=True` as default
2) added _hdlclass.py to support Class Based Design, look at bot test/conversion/general/test_hdlclass.py and test/conversion/general/test_hdlclass2.py
This needed the changes of 1) above.

* 1) _Signal.py
added property `.nbits` for use in HDL iso `len(sig)`, anticipating Structure and Array where `len()` is not what `.nbits` will give you ...
added `duplicate(value=None)` method to avoid that ugly `newsig = Signal(oldsig._val)`
2) _block.py
minor changes
3)_hdlclass.py
removed ForwardPorts resolution as this currently adds a *stray* sig in the .vcd output - even if noe ForwardPorts are present
cleaned the code to what is actually working
4) _traceSignals.py
The `@block(skipname=True), which is heavily used in Class Based Design, applies `None` as that block-name and this will show up as an additional level in the .vcd which looks ugly and distracting.
So reworked this file to skip adding the None-level
Also added indents in the .vcd var section, primarily for debugging, but kept this as it looks nice.
Introduce f'strings
5) _analyze.py
changed UPPER_CASE naming of processe/always into lower case, making the generated signals conform with the producing process/always
6) test_xxxx.py
changed @instance with *logic* as function name into *comb* as `logic` has become a reserved Verilog keyword

* cleaned test/bugs
replacing generator names *logic* and *output* with *comb* as `logic` and `output` have become Verilog reserved keywords

* replacing more occurrences of *logic* by either *comb* or *synch*

* one *comb* too many :(

* added small test_hdlclass0.py to help in debugging
updated the 'doc' section -- needs publishing
added direct conversion of Class Based Design modules - resulting in lesss boiler-plate code
2024-12-21 17:21:11 +01:00

58 lines
1.7 KiB
Python

import myhdl
from myhdl import *
ACTIVE = 0
DirType = enum('RIGHT', 'LEFT')
def jc2(goLeft, goRight, stop, clk, q):
""" A bi-directional 4-bit Johnson counter with stop control.
I/O pins:
--------
clk : input free-running slow clock
goLeft : input signal to shift left (active-low switch)
goRight : input signal to shift right (active-low switch)
stop : input signal to stop counting (active-low switch)
q : 4-bit counter output (active-low LEDs; q[0] is right-most)
Operation:
---------
The counter is triggered on the rising edge of the clock (clk).
A low pulse on the goLeft input will cause the counter to start
shifting left from its current state. A low pulse on the goRight
input will cause the counter to start shifting right from its
current state. A low pulse on the stop input will cause the
counter to hold its current state until goLeft or goRight is pulsed.
After power-up, the counter is stopped with all outputs low (LEDs lit).
"""
dir = Signal(DirType.LEFT)
run = Signal(False)
@always(clk.posedge)
def synch():
# direction
if goRight == ACTIVE:
dir.next = DirType.RIGHT
run.next = True
elif goLeft == ACTIVE:
dir.next = DirType.LEFT
run.next = True
# stop
if stop == ACTIVE:
run.next = False
# counter action
if run:
if dir == DirType.LEFT:
q.next[4:1] = q[3:]
q.next[0] = not q[3]
else:
q.next[3:] = q[4:1]
q.next[3] = not q[0]
return synch