rom.h File Reference

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros
#define	ROM_AREA_START   0xE0000
#define	ROM_AREA_END   0xFFFFF
#define	OPTION_ROM_SIGNATURE   0xAA55

Functions
BOOLEAN	WriteProtectRom (IN PVOID RomLocation, IN ULONG RomSize)
BOOLEAN	WriteUnProtectRom (IN PVOID RomLocation, IN ULONG RomSize)
UCHAR	CalcRomChecksum (IN ULONG RomLocation, IN ULONG RomSize)
BOOLEAN	LoadBios (IN PCSTR BiosFileName, OUT PVOID *BiosLocation OPTIONAL, OUT PULONG BiosSize OPTIONAL)
BOOLEAN	LoadRom (IN PCSTR RomFileName, IN PVOID RomLocation, OUT PULONG RomSize OPTIONAL)
VOID	SearchAndInitRoms (IN PCALLBACK16 Context)

Macro Definition Documentation

OPTION_ROM_SIGNATURE

#define OPTION_ROM_SIGNATURE   0xAA55

Definition at line 17 of file rom.h.

ROM_AREA_END

#define ROM_AREA_END   0xFFFFF

Definition at line 15 of file rom.h.

ROM_AREA_START

#define ROM_AREA_START   0xE0000

Definition at line 14 of file rom.h.

Function Documentation

CalcRomChecksum()

UCHAR CalcRomChecksum	(	IN ULONG	RomLocation,
		IN ULONG	RomSize
	)

Definition at line 153 of file rom.c.

{
    ULONG RomLastAddress = RomLocation + RomSize;
    UCHAR Sum = 0x00;   // Using a UCHAR guarantees that we wrap at 0xFF i.e. we do a sum modulo 0x100.

    while (RomLocation < RomLastAddress)
    {
        Sum += *(PUCHAR)REAL_TO_PHYS(RomLocation);
        ++RomLocation;
    }

    return Sum;
}

Referenced by InitRomRange(), and VidBiosInitialize().

LoadBios()

BOOLEAN LoadBios	(	IN PCSTR	BiosFileName,
		OUT PVOID *BiosLocation	OPTIONAL,
		OUT PULONG BiosSize	OPTIONAL
	)

Definition at line 169 of file rom.c.

{
    BOOLEAN Success;
    HANDLE  hBiosFile;
    ULONG   ulBiosSize = 0;
    PVOID   pBiosLocation;

    /* Open the BIOS image file */
    hBiosFile = OpenRomFile(BiosFileName, &ulBiosSize);

    /* If we failed, bail out */
    if (hBiosFile == NULL) return FALSE;

    /* BIOS location needs to be aligned on 32-bit boundary */
    // (PVOID)((ULONG_PTR)BaseAddress + ROM_AREA_END + 1 - ulBiosSize)
    pBiosLocation = MEM_ALIGN_DOWN(TO_LINEAR(0xF000, 0xFFFF) + 1 - ulBiosSize, sizeof(ULONG));

    /* Attempt to load the BIOS image file into memory */
    Success = LoadRomFileByHandle(hBiosFile,
                                  pBiosLocation,
                                  ulBiosSize,
                                  &ulBiosSize);
    DPRINT1("BIOS loading %s ; GetLastError() = %u\n", Success ? "succeeded" : "failed", GetLastError());

    /* Close the BIOS image file */
    FileClose(hBiosFile);

    /*
     * In case of success, write-protect the BIOS location
     * and return the BIOS location and its size if needed.
     */
    if (Success)
    {
        WriteProtectRom(pBiosLocation, ulBiosSize);

        if (BiosLocation) *BiosLocation = pBiosLocation;
        if (BiosSize)     *BiosSize     = ulBiosSize;
    }

    return Success;
}

Referenced by BiosInitialize().

LoadRom()

BOOLEAN LoadRom	(	IN PCSTR	RomFileName,
		IN PVOID	RomLocation,
		OUT PULONG RomSize	OPTIONAL
	)

Definition at line 214 of file rom.c.

{
    BOOLEAN Success;
    HANDLE  hRomFile;
    ULONG   ulRomSize = 0;

    /* Open the ROM image file */
    hRomFile = OpenRomFile(RomFileName, &ulRomSize);

    /* If we failed, bail out */
    if (hRomFile == NULL) return FALSE;

    /* Attempt to load the ROM image file into memory */
    Success = LoadRomFileByHandle(hRomFile,
                                  RomLocation,
                                  ulRomSize,
                                  &ulRomSize);
    DPRINT1("ROM loading %s ; GetLastError() = %u\n", Success ? "succeeded" : "failed", GetLastError());

    /* Close the ROM image file and return */
    FileClose(hRomFile);

    /*
     * In case of success, write-protect the ROM location
     * and return the ROM size if needed.
     */
    if (Success)
    {
        WriteProtectRom(RomLocation, ulRomSize);
        if (RomSize) *RomSize = ulRomSize;
    }

    return Success;
}

Referenced by BiosInitialize().

SearchAndInitRoms()

VOID SearchAndInitRoms

(

IN PCALLBACK16

Context

)

Definition at line 252 of file rom.c.

{
    /* Video ROMs -- Start: C0000, End: C8000, 2kB blocks */
    InitRomRange(Context, 0xC0000, 0xC8000, 0x0800);

    /* Adapters ROMs -- Start: C8000, End: E0000, 2kB blocks */
    InitRomRange(Context, 0xC8000, 0xE0000, 0x0800);

    /* Expansion ROM -- Start: E0000, End: F0000, 64kB block */
    InitRomRange(Context, 0xE0000, 0xEFFFF, 0x10000);
}

Referenced by Bios32Post().

WriteProtectRom()

BOOLEAN WriteProtectRom	(	IN PVOID	RomLocation,
		IN ULONG	RomSize
	)

Definition at line 138 of file rom.c.

{
    return MemInstallFastMemoryHook(RomLocation, RomSize,
                                    NULL, ShadowRomWrite);
}

Referenced by Bios32Initialize(), LoadBios(), LoadRom(), and VidBiosInitialize().

WriteUnProtectRom()

BOOLEAN WriteUnProtectRom	(	IN PVOID	RomLocation,
		IN ULONG	RomSize
	)

Definition at line 146 of file rom.c.

{
    return MemRemoveFastMemoryHook(RomLocation, RomSize);
}