nesdev.org

Code: Select all

.zeropage
  some_var: .byte 0

.proc something
  lda #$69
  ; RAM table (for reading/writing bytes) is automatically defined.
  luaExecStr "print( 'value from memory is ' .. RAM[ 0x234 ] )"
  ; RAM table can also be indexed with symbols. Only works for global symbols right now (no scopes, but of course it's always possible to define aliases for scoped variables in CA65).
  luaExecStr "print( 'value from memory is ' .. RAM.some_var )"
  luaExecStr "print( string.format( 'A = %X, X = %X, Y = %X', REG.A, REG.X, REG.Y ) )"
  rts
.endproc

Code: Select all

  luaExecStr "if RAM.some_var > 50 and REG.A = 0x49 then iup.Message( 'Assert failed', 'Something went wrong' ); NDX.stop() end"

Code: Select all

; foo.s (6502 code)
.bss
ARRAY_SIZE = 100
array: .res ARRAY_SIZE

.code
.proc gahh
  luaExecFile "gahh-proto.lua"
  rts
.endproc

-- gahh-proto.lua (Lua code)
-- Fill "array" with something.
array_addr = SYM.array[ 1 ]
for i = 0, SYM.ARRAY_SIZE[ 1 ] - 1 do
  RAM[ array_addr + i ] = i + 123
end

Code: Select all

-- Lua code
ctl = iup.label { title="something", expand="YES" }
dlg = iup.dialog { ctl, title="Debug Helper", size="200x200" }
dlg:show()

; 6502 code
luaExecStr "ctl.title = string.format( 'some_var is %X', RAM.some_var )"

Code: Select all

NDX.getPPUCycles
NDX.setRegister
NDX.print -- For printing to the Nintendulator Debug Information window, normal print() prints to the Lua console
NDX.getRegister
NDX.writeRAM
NDX.getCPUCycles
NDX.stop
NDX.readRAM
NDX.getSymbols

Code: Select all

; Display a message when some condition happens:
lda foo
beq not_foo
  ; The emulator uses addresses (and banking information) to identify these, so
  ; if luaExecStr/luaExecFile is the very last thing before the condition label, it
  ; needs to output one NOP, so that its address is not the same as "not_foo".
  luaExecStr "print( 'foo happened' )", 1
not_foo:

Code: Select all

; NOTE: In Lua, all numbers evaluate as true, so have to explicitly check for non-zero.
luaExecStr "if RAM.foo > 0 then print( 'foo happened' ) end"

Code: Select all

  * "Expand macros" option.
  * CA65 debug header no longer tramples over custom character mappings.
  * Absolute file paths can be used in debug files.
  * Bug fixed from dbginfo.c that caused some (rare) debug files not to
  be loaded.
  * readMemory() function added to the Lua interface.
  * Latest updates from the main Nintendulator repo integrated.
  * Warnings are given for uninitialized PRG-RAM accesses.
  * Memory can be randomized on power-on.
  * Lua, CD and IUP updated to the latest versions.
  * Updated project to Visual Studio 2013.
  * Added limited PowerPak hardware emulation (requires recompilation).
  * Diagnostic message is shown if PPU_DATA is written to during rendering.
  * NTSC NES borders are displayed.

Code: Select all

  * NDX searches for source files in the current working directory
  (previously only relative to the ROM directory)
  * NDX searches for Lua scripts relative to current working directory.
  * Menu option added for NTSC/PAL aspect ratio.
  * NTSC filter support added (blargg's nes_ntsc).
  * Frame skip option removed.
  * Color depths other than 32-bit removed.
  * Diagnostic is shown if invalid black (0xD) is used in rendering.
  * Improved the implementation of Lua require().
  * Fixed a bug that caused the A register to be cleared when
  ndxDebugBreak was used without the debugger window being open.
  * Fixed some problems with POV axes (patch from Nintendulator main
  repository)
  * Lua code can call back into 6502 code (NDX.jsr())
  * Menu option for darkening borders outside the 90% safe area of
  the (NTSC) screen.