2.3 KiB
| title | weight | pre | chapter |
|---|---|---|---|
| Memory Access | 30 | false |
read / readWord
Syntax
emu.read(address, type, signed = false)
emu.readWord(address, type, signed = false)
Parameters
address - Integer The address/offset to read from.
type - Enum The type of memory to read from. See memType.
signed - (optional) Boolean If true, the value returned will be interpreted as a signed value.
Return value
An 8-bit (read) or 16-bit (readWord) value.
Description
Reads a value from the specified memory type.
When calling read / readWord with the memType.cpu or memType.ppu memory types, emulation side-effects may occur.
To avoid triggering side-effects, use the memType.cpuDebug or memType.ppuDebug types, which will not cause side-effects.
write / writeWord
Syntax
emu.write(address, value, type)
emu.writeWord(address, value, type)
Parameters
address - Integer The address/offset to write to.
value - Integer The value to write.
type - Enum The type of memory to write to. See memType.
Return value
None
Description
Writes an 8-bit or 16-bit value to the specified memory type.
Normally read-only types such as PRG-ROM or CHR-ROM can be written to when using memType.prgRom or memType.chrRom.
Changes will remain in effect until a power cycle occurs.
To revert changes done to ROM, see revertPrgChrChanges.
When calling write / writeWord with the memType.cpu or memType.ppu memory types, emulation side-effects may occur.
To avoid triggering side-effects, use the memType.cpuDebug or memType.ppuDebug types, which will not cause side-effects.
revertPrgChrChanges
Syntax
emu.revertPrgChrChanges()
Return value
None
Description
Reverts all modifications done to PRG-ROM and CHR-ROM via write/writeWord calls.