From 03760c25d6a0609480c0ef5672ba0861f2838153 Mon Sep 17 00:00:00 2001 From: Miquel Sabaté Solà Date: Sun, 3 Dec 2023 07:51:06 +0100 Subject: Added readme file MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Miquel Sabaté Solà --- README.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..bd759b1 --- /dev/null +++ b/README.md @@ -0,0 +1,29 @@ +[Advent of Code 2023](https://adventofcode.com/2023) on the NES, baby! (let's +see if I actually finish it...) + +Each day is written into its own file inside of `src`. Build everything by just +calling `make` and you will get a `.nes` file per day inside of the `out` +directory. Before doing that, though, you will need a compiler for the 6052 +platform. A good option is [cc65](https://github.com/cc65/cc65), which is +available on all major platforms. Otherwise, if you want to use another +compiler, you can pass the `CC65` and `CCOPTS` variables to the Makefile. + +After that, it's recommended that you run the ROMs with an emulator with +debugging support or at least some form of memory visualization. This is because +some days have nothing to show for other than updating some values on the NES +memory. A safe bet is to go with either [fceux](https://fceux.com/web/home.html) +or [Mesen](https://github.com/SourMesen/Mesen2/), which provide tools like RAM +watchers or a full debugger. + +Notice also that I will use some terms without actually introducing them. That +is, I expect you to go over the [NES Dev +wiki](https://www.nesdev.org/wiki/Nesdev_Wiki) for glossary or for full +documentation on the stuff being shown here. That is, if you find that on a +bunch of comments I write stuff like "memory mapper", "MMC3 chip", "OAM" or +stuff like that, just go to the [NES Dev +wiki](https://www.nesdev.org/wiki/Nesdev_Wiki) to get a better picture. + +## License + +Released under the [GPLv3+](http://www.gnu.org/licenses/gpl-3.0.txt), Copyright +(C) 2023-Ω Miquel Sabaté Solà. -- cgit v1.2.3