litex/gen: Move LiteXModule to gen/fhdl/module.py.

This commit is contained in:
Florent Kermarrec 2022-10-28 19:38:24 +02:00
parent e3e99c527c
commit 2829ca93f7
3 changed files with 52 additions and 45 deletions

View file

@ -1,2 +1,3 @@
from litex.gen.sim import * from litex.gen.sim import *
from litex.gen.common import * from litex.gen.common import *
from litex.gen.fhdl.module import *

View file

@ -5,12 +5,6 @@
# SPDX-License-Identifier: BSD-2-Clause # SPDX-License-Identifier: BSD-2-Clause
from migen import * from migen import *
from migen.fhdl.module import _ModuleProxy
from migen.fhdl.specials import Special
from litex.soc.interconnect.csr import AutoCSR
from litex.soc.integration.doc import AutoDoc
# Bit/Bytes Reversing ------------------------------------------------------------------------------ # Bit/Bytes Reversing ------------------------------------------------------------------------------
@ -48,42 +42,3 @@ def Reduce(operator, value):
# Return Python's reduction. # Return Python's reduction.
return reduce(operators[operator], value) return reduce(operators[operator], value)
# LiteX Module -------------------------------------------------------------------------------------
class LiteXModule(Module, AutoCSR, AutoDoc):
def __setattr__(m, name, value):
# Migen:
if name in ["comb", "sync", "specials", "submodules", "clock_domains"]:
if not isinstance(value, _ModuleProxy):
raise AttributeError("Attempted to assign special Module property - use += instead")
# LiteX fix-up: Automatically collect specials/submodules/clock_domains:
# - m.module_x = .. equivalent of Migen's m.submodules.module_x = ..
elif isinstance(value, Module) and ((name, value) not in m._submodules):
setattr(m.submodules, name, value)
# - m.special_x = .. equivalent of Migen's m.specials.special_x = ..
elif isinstance(value, Special) and (value not in m._fragment.specials):
setattr(m.specials, name, value)
# - m.cd_x = .. equivalent of Migen's m.clock_domains.cd_x = ..
elif isinstance(value, ClockDomain) and (value not in m._fragment.clock_domains):
setattr(m.clock_domains, name, value)
# Else use default __setattr__.
else:
object.__setattr__(m, name, value)
# LiteX fix-up: Automatically collect specials/submodules/clock_domains:
def __iadd__(m, other):
# - m += module_x equivalent of Migen's m.submodules += module_x.
if isinstance(other, Module):
print(other)
m.submodules += other
# - m += special_x equivalent of Migen's m.specials += special_x.
elif isinstnace(other, Special):
m.specials += other
# - m += cd_x equivalent of Migen's m.clock_domains += cd_x.
elif isinstance(other, ClockDomain):
m.clock_domains += other
# Else use default __iadd__.
else:
object.__iadd__(m, other)
return m

51
litex/gen/fhdl/module.py Normal file
View file

@ -0,0 +1,51 @@
#
# This file is part of LiteX.
#
# This file is Copyright (c) 2022 Florent Kermarrec <florent@enjoy-digital.fr>
# SPDX-License-Identifier: BSD-2-Clause
from migen import *
from migen.fhdl.module import _ModuleProxy
from migen.fhdl.specials import Special
from litex.soc.interconnect.csr import AutoCSR
from litex.soc.integration.doc import AutoDoc
# LiteX Module -------------------------------------------------------------------------------------
class LiteXModule(Module, AutoCSR, AutoDoc):
def __setattr__(m, name, value):
# Migen:
if name in ["comb", "sync", "specials", "submodules", "clock_domains"]:
if not isinstance(value, _ModuleProxy):
raise AttributeError("Attempted to assign special Module property - use += instead")
# LiteX fix-up: Automatically collect specials/submodules/clock_domains:
# - m.module_x = .. equivalent of Migen's m.submodules.module_x = ..
elif isinstance(value, Module) and ((name, value) not in m._submodules):
setattr(m.submodules, name, value)
# - m.special_x = .. equivalent of Migen's m.specials.special_x = ..
elif isinstance(value, Special) and (value not in m._fragment.specials):
setattr(m.specials, name, value)
# - m.cd_x = .. equivalent of Migen's m.clock_domains.cd_x = ..
elif isinstance(value, ClockDomain) and (value not in m._fragment.clock_domains):
setattr(m.clock_domains, name, value)
# Else use default __setattr__.
else:
object.__setattr__(m, name, value)
# LiteX fix-up: Automatically collect specials/submodules/clock_domains:
def __iadd__(m, other):
# - m += module_x equivalent of Migen's m.submodules += module_x.
if isinstance(other, Module):
print(other)
m.submodules += other
# - m += special_x equivalent of Migen's m.specials += special_x.
elif isinstnace(other, Special):
m.specials += other
# - m += cd_x equivalent of Migen's m.clock_domains += cd_x.
elif isinstance(other, ClockDomain):
m.clock_domains += other
# Else use default __iadd__.
else:
object.__iadd__(m, other)
return m