tools.nes/lib/vnf/src, 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>
Add an option for setting a cycle limit2026-09-08T15:32:08ZMiquel Sabaté Solàmssola@mssola.com2026-09-08T15:32:08Zurn:sha1:1601d0353342230a2a93baa6f008bc16a10137a1
This can be quite handy when it comes to checking that a piece of code
doesn't exceed a given amount of cycles, or when you are tuning a block
of code in order to make it go beyond the current amount of cycles.
Signed-off-by: Miquel Sabaté Solà <mssola@mssola.com>
vnf: refuse to proceed if the machine is inactive2026-09-08T15:31:44ZMiquel Sabaté Solàmssola@mssola.com2026-09-08T15:31:44Zurn:sha1:37c9824cd7674aa9b8b9f094cf3a93e6da2c1f99
Signed-off-by: Miquel Sabaté Solà <mssola@mssola.com>
vnf: validate the minimum stack value2026-09-07T21:41:48ZMiquel Sabaté Solàmssola@mssola.com2026-09-07T21:41:48Zurn:sha1:6000556d5005b5cd5faf72cb290e1d9a72beee35
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>
vnf: add the 'Machine.halt_on_brk' field2026-09-07T21:03:55ZMiquel Sabaté Solàmssola@mssola.com2026-09-07T20:31:33Zurn:sha1:a17bd972a99007099057d7901b88732b22d08270
This allows developers to use 'brk' as asserts which can then be
debugged. This is true by default but it can be turned off via the
--no-halting-brk option from runrom.
Signed-off-by: Miquel Sabaté Solà <mssola@mssola.com>
vnf: convert StatusRegister.break_mark to Option<u8>2026-09-07T14:38:48ZMiquel Sabaté Solàmssola@mssola.com2026-09-07T14:38:48Zurn:sha1:2f4caa8e39ac39969522c4a2a285256c9a13b2c6
Instead of assuming a default value, it's safer to just implement it in
Rust's native Option<_> type.
Signed-off-by: Miquel Sabaté Solà <mssola@mssola.com>
vnf: improve documentation2026-09-07T14:38:16ZMiquel Sabaté Solàmssola@mssola.com2026-09-07T14:38:16Zurn:sha1:44f98890a6d91cd9f0b64dec743a22a6e0013590
Provide documentation for the library, and improve the documentation for
some of the structs and interfaces.
Signed-off-by: Miquel Sabaté Solà <mssola@mssola.com>
vnf: properly document how branching works2026-09-06T20:50:50ZMiquel Sabaté Solàmssola@mssola.com2026-09-06T20:50:50Zurn:sha1:076b1b31f37b37560382545d424ee063903b6b31
Signed-off-by: Miquel Sabaté Solà <mssola@mssola.com>
vnf: don't flip the given joypad inputs2026-09-06T20:44:29ZMiquel Sabaté Solàmssola@mssola.com2026-09-06T20:44:29Zurn:sha1:83e5edac2cde5630a6acb26f7e1135f1b933db9a
I am not sure from where I got this bit flipping part, but I believe
things worked because of another bug (see 9c685d5b6ca1 ("vnf: also set
the carry on a zero compare")).
Fixes: ad77503d9533 ("vnf: add support for standard joypads")
Signed-off-by: Miquel Sabaté Solà <mssola@mssola.com>