Source code for py_register_machine2.core.device

#!/usr/bin/python3

"""
**py_register_machine2.core.device**: Device BUS and attached devices
"""

from ..core import parts

[docs]class BUS(parts.BUS):
	"""
	The processor's device BUS, usually the Flash is attached to this BUS,
	but there might be more devices.
	"""
	def __init__(self, width = 64, debug = 0):
		parts.BUS.__init__(self, width = width, debug = debug)


[docs]class Flash(parts.WordDevice):
	"""
	.. _Flash:
	
	**The Program Flash**

	If the size of the program exceeds the size of the ROM the program has to be written into
	the Flash. The Flash is a Read/Write device and contains

	* The Program
	* Constants
	* Static Variables

	The Flash is a WordDevice and attached to the ``device.BUS`` .
	"""

	def __init__(self, size, width = 64, debug = 0):
		parts.WordDevice.__init__(self, size, width = width, mode = 0b11, debug = debug)

[docs]	def program(self, prog, offset = 0):
		"""
		Write the content of the iterable ``prog`` starting with the optional offset ``offset``
		to the device.

		Invokes ``program_word``.
		"""
		for addr, word in enumerate(prog):
			self.program_word(offset + addr, word)
[docs]	def program_word(self, offset, word):
		"""
		Program one word of the Flash device.
		Might raise AddressError_.
		"""
		if(offset >= self.size):
			raise AddressError("Offset({}) not in address space({})".format(offset, self.size))
		self.repr_[offset].setvalue(word)