# memorySimulator.py

import os

MEMORY_FILE = "memory.mem"

TOTAL_MEMORY = 8 * 1024 * 1024          # 8 MB
BANKS = 4
BANK_SIZE = TOTAL_MEMORY // BANKS       # 2 MB per bank

ROW_SIZE = 256
COL_SIZE = 256

# ----------------------------------------
# ADDRESS MAPPING
# ----------------------------------------

def address_to_bank_row_col(address):

    bank = address // BANK_SIZE

    offset = address % BANK_SIZE

    row = offset // COL_SIZE

    col = offset % COL_SIZE

    return bank, row, col


# ----------------------------------------
# CREATE MEMORY FILE
# ----------------------------------------

def create_memory_file():

    if os.path.exists(MEMORY_FILE):
        return

    print("Creating 8MB memory file...")

    with open(MEMORY_FILE, "w") as f:

        for address in range(TOTAL_MEMORY):

            bank, row, col = address_to_bank_row_col(address)

            f.write(
                f"ADDR={address:08X} "
                f"BANK={bank} "
                f"ROW={row} "
                f"COL={col} "
                f"VALUE=00\n"
            )

    print("Finished.")


# ----------------------------------------
# READ ENTRY
# ----------------------------------------

def read_memory(address):

    if address < 0 or address >= TOTAL_MEMORY:
        raise ValueError("Address out of range")

    with open(MEMORY_FILE, "r") as f:

        for line_number, line in enumerate(f):

            if line_number == address:

                parts = line.strip().split()

                value = parts[-1].split("=")[1]

                return value

    return None


# ----------------------------------------
# WRITE ENTRY
# ----------------------------------------

def write_memory(address, value):

    if address < 0 or address >= TOTAL_MEMORY:
        raise ValueError("Address out of range")

    value = value.upper()

    if len(value) != 2:
        raise ValueError("Value must be 2 hex digits")

    with open(MEMORY_FILE, "r") as f:
        lines = f.readlines()

    bank, row, col = address_to_bank_row_col(address)

    lines[address] = (
        f"ADDR={address:08X} "
        f"BANK={bank} "
        f"ROW={row} "
        f"COL={col} "
        f"VALUE={value}\n"
    )

    with open(MEMORY_FILE, "w") as f:
        f.writelines(lines)


# ----------------------------------------
# MEMORY DUMP
# ----------------------------------------

def dump_memory(start_address, length):

    end_address = start_address + length

    if end_address > TOTAL_MEMORY:
        end_address = TOTAL_MEMORY

    with open(MEMORY_FILE, "r") as f:

        lines = f.readlines()

    print()

    for address in range(start_address, end_address):

        print(lines[address].strip())

    print()


# ----------------------------------------
# BANK INFORMATION
# ----------------------------------------

def show_bank_layout():

    print()
    print("PHYSICAL MEMORY MAP")
    print("=" * 60)

    for bank in range(BANKS):

        start = bank * BANK_SIZE
        end = (start + BANK_SIZE) - 1

        print(
            f"Bank {bank} : "
            f"0x{start:08X} - 0x{end:08X}"
        )

    print()


# ----------------------------------------
# STATUS
# ----------------------------------------

def show_address(address):

    bank, row, col = address_to_bank_row_col(address)

    value = read_memory(address)

    print()
    print("ADDRESS INFORMATION")
    print("-" * 40)
    print(f"Address : 0x{address:08X}")
    print(f"Bank    : {bank}")
    print(f"Row     : {row}")
    print(f"Column  : {col}")
    print(f"Value   : {value}")
    print()


# ----------------------------------------
# DEMO
# ----------------------------------------

def demonstration():

    print()
    print("WRITING DATA")
    print()

    write_memory(100, "41")
    write_memory(101, "42")
    write_memory(102, "43")

    show_address(100)
    show_address(101)
    show_address(102)

    print("ASCII")
    print(chr(int(read_memory(100), 16)))
    print(chr(int(read_memory(101), 16)))
    print(chr(int(read_memory(102), 16)))
    print()


# ----------------------------------------
# MENU
# ----------------------------------------

def menu():

    while True:

        print()
        print("Memory Simulator")
        print("=" * 50)
        print("1 - Show Memory Map")
        print("2 - Read Address")
        print("3 - Write Address")
        print("4 - Dump Memory")
        print("5 - Demo Write ABC")
        print("0 - Exit")

        choice = input("Selection: ").strip()

        if choice == "1":

            show_bank_layout()

        elif choice == "2":

            address = int(input("Address: "))

            show_address(address)

        elif choice == "3":

            address = int(input("Address: "))
            value = input("Hex Value (00-FF): ")

            write_memory(address, value)

            print("Written")

        elif choice == "4":

            start = int(input("Start Address: "))
            length = int(input("Length: "))

            dump_memory(start, length)

        elif choice == "5":

            demonstration()

        elif choice == "0":

            break


# ----------------------------------------
# MAIN
# ----------------------------------------

if __name__ == "__main__":

    create_memory_file()

    menu()