মেমরি ম্যাপ — Flash, SRAM ও পেরিফেরাল রেজিস্টার

class MemoryBus:
    # মাইক্রোকন্ট্রোলারের একক অ্যাড্রেস স্পেসের সিমুলেশন -- Flash, SRAM, পেরিফেরাল সব একসাথে
    def __init__(self):
        self.memory_map = [
            (0x0000, 0x7FFF, "FLASH", "প্রোগ্রাম Flash"),
            (0x8000, 0xBFFF, "SRAM", "ডেটা SRAM"),
            (0xC000, 0xC00F, "PERIPHERAL", "GPIO রেজিস্টার ব্লক"),
            (0xC010, 0xC01F, "PERIPHERAL", "টাইমার রেজিস্টার ব্লক"),
        ]
        self.flash_data = {0x0010: 0xAB}  # সিমুলেটেড প্রি-লোডেড ফার্মওয়্যার বাইট
        self.sram_data = {}               # রানটাইম ডেটা ও পেরিফেরাল স্টেটের জন্য ফাঁকা ডিকশনারি
        self.peripheral_log = []          # পেরিফেরাল রাইটের সাইড-ইফেক্ট লগ

    def _decode(self, addr):
        for start, end, region_type, name in self.memory_map:
            if start <= addr <= end:
                return region_type, name
        return None, None

    def read(self, addr):
        region_type, name = self._decode(addr)
        if region_type is None:
            raise ValueError(f"ঠিকানা 0x{addr:04X} মেমরি ম্যাপের বাইরে -- আনম্যাপড অ্যাক্সেস")
        if region_type == "FLASH":
            value = self.flash_data.get(addr, 0x00)
            print(f"READ  0x{addr:04X} [{name}] -> {value:#04x}")
            return value
        value = self.sram_data.get(addr, 0x00)
        tag = " (পেরিফেরাল স্ট্যাটাস রিড)" if region_type == "PERIPHERAL" else ""
        print(f"READ  0x{addr:04X} [{name}] -> {value:#04x}{tag}")
        return value

    def write(self, addr, value):
        region_type, name = self._decode(addr)
        if region_type is None:
            raise ValueError(f"ঠিকানা 0x{addr:04X} মেমরি ম্যাপের বাইরে -- আনম্যাপড অ্যাক্সেস")
        if region_type == "FLASH":
            raise PermissionError(f"0x{addr:04X} [{name}] Flash-এ সরাসরি রাইট করা যায় না -- রিড-অনলি রিজিয়ন")
        self.sram_data[addr] = value & 0xFF
        if region_type == "SRAM":
            print(f"WRITE 0x{addr:04X} [{name}] <- {value:#04x} (সাধারণ ডেটা মেমরি রাইট)")
        else:
            self.peripheral_log.append((addr, value & 0xFF))
            print(f"WRITE 0x{addr:04X} [{name}] <- {value:#04x} -> পেরিফেরাল সাইড-ইফেক্ট: হার্ডওয়্যার স্টেট পরিবর্তিত হলো!")


bus = MemoryBus()

print("প্রি-লোডেড Flash থেকে রিড:")
bus.read(0x0010)

print("\nSRAM-এ ডেটা রাইট ও রিড:")
bus.write(0x8000, 0x2A)
bus.read(0x8000)

print("\nGPIO পেরিফেরাল রেজিস্টারে রাইট (পিন সেট করার সিমুলেশন):")
bus.write(0xC000, 0x01)

print("\nটাইমার পেরিফেরাল রেজিস্টারে রাইট (রিলোড ভ্যালু সেট):")
bus.write(0xC010, 0xFF)

print(f"\nমোট পেরিফেরাল সাইড-ইফেক্ট লগ: {[(hex(a), hex(v)) for a, v in bus.peripheral_log]}")

print("\nFlash-এ রাইট করার চেষ্টা (এটি ব্যর্থ হওয়া উচিত):")
try:
    bus.write(0x0010, 0x99)
except PermissionError as e:
    print(f"ত্রুটি ধরা পড়ল -> {e}")

print("\nআনম্যাপড ঠিকানায় (0xFFFF) রিড করার চেষ্টা:")
try:
    bus.read(0xFFFF)
except ValueError as e:
    print(f"ত্রুটি ধরা পড়ল -> {e}")