tools.nes/tests/runrom, branch mainTools for NES/Famicom development.
https://git.mssola.com/nes/tools.nes/atom?h=main2026-10-09T19:45:05Zvnf,runrom: detect bad data access2026-10-09T19:45:05ZMiquel Sabaté Solàmssola@mssola.com2026-10-09T19:45:05Zurn:sha1:f6df4314945c1d37d314a7c88553b97b23c748e9
This includes detection for:
- Stack underflows (it was theoretically already there but it had never
been properly tested).
- Load/store out of bounds for a given variable known via the .nasm/
directory.
- Load out of bounds on a set of data referenced via a raw label (see
commit aa5174fc055d ("xixanta: Add an hint for the ending of data
labels")).
Signed-off-by: Miquel Sabaté Solà <mssola@mssola.com>
vnf: display also the break mark on report()2026-09-07T21:19:53ZMiquel Sabaté Solàmssola@mssola.com2026-09-07T21:19:53Zurn:sha1:e2a20dedc354c0b8d2e5253ffd4ac22d2b2898aa
When reporting the final instruction, if that was actually a brk (and
hence we stopped because of it), show the breaking mark as that could be
relevant when debugging.
Signed-off-by: Miquel Sabaté Solà <mssola@mssola.com>
tests: add a test on branching instructions2026-09-06T20:55:50ZMiquel Sabaté Solàmssola@mssola.com2026-09-06T20:55:50Zurn:sha1:2d61e42fab657d61212a7aff1ecacbd674be8cda
Signed-off-by: Miquel Sabaté Solà <mssola@mssola.com>
vnf: also set the carry on a zero compare2026-09-06T19:42:34ZMiquel Sabaté Solàmssola@mssola.com2026-09-06T19:42:34Zurn:sha1:9c685d5b6ca1686f944fb239ec89511f24801d44
Add also a test to further check corner cases on compare instructions.
Signed-off-by: Miquel Sabaté Solà <mssola@mssola.com>
vnf: add support for standard joypads2026-09-06T13:47:50ZMiquel Sabaté Solàmssola@mssola.com2026-08-29T22:06:39Zurn:sha1:ad77503d953302f22a621093ba359e24526892ec
This means adding constants so developers can actually trigger which key
presses are available at any given read, as well as a simple interface
that allows to add button presses and clear them.
Signed-off-by: Miquel Sabaté Solà <mssola@mssola.com>
vnf: add support for all stack instructions2026-08-27T05:12:42ZMiquel Sabaté Solàmssola@mssola.com2026-08-27T05:12:42Zurn:sha1:50ebac34fec99c853b2f010bfd100c11b5e0a603
This also includes brk and rti, for which we are also storing and
exporting the break mark, just in case it can be useful to library users
in case they want to add error codes in break marks.
This commit also includes a fix for accounting the Z and N flags on
transfer instructions, which couldn't easily be split into a separate
commit, but it's a fairly simple change.
Signed-off-by: Miquel Sabaté Solà <mssola@mssola.com>
runrom: add tests for --start and --until-address2026-08-26T06:09:16ZMiquel Sabaté Solàmssola@mssola.com2026-08-26T06:09:16Zurn:sha1:7feba90e6bec87796a39e53bec81647c64bfd7dc
Signed-off-by: Miquel Sabaté Solà <mssola@mssola.com>
Add the runrom crate and the vnf library2026-08-17T21:06:23ZMiquel Sabaté Solàmssola@mssola.com2026-08-17T14:03:21Zurn:sha1:df1041d40431251e22e03ec5c4df7fc5767e1543
The vnf library supports the runrom crate and they both combined enable
users to "run" a ROM file. This is basically an emulator, but with two
key differences:
1. It is to be run programatically. That is, you are not expected to
play games with this, but to run code by steps, start at a given
address, run a function, etc.
2. It is headless: there are no graphics displayed on screen, nor sound
being delivered.
Thus, the target for both these things are developers, not players. This
way developers can validate code paths without needing a full blown
emulator. You can write tests with this and be able to run some checks
as part of your testing infrastructure.
Signed-off-by: Miquel Sabaté Solà <mssola@mssola.com>