Skip to content

Latest commit

 

History

History
34 lines (25 loc) · 3.38 KB

README.md

File metadata and controls

34 lines (25 loc) · 3.38 KB

Patches for Ares v121

The last release of Ares put out by Near was listed as "not fully complete or stable" in the release notes, the source code itself can not compile on it's own.

TLCS900H Processor Changes

The release notes state the following changes to the TLCS900H processor:

  • TLCS900H: do not allow interrupts to run between CPDR, LDIR, LDDR instructions; fixes Fantastic Night Dreams Cotton
  • TLCS900H: refactored instruction decoder and disassembler using range-case
  • TLCS900H: improved emulation of (PC+d16) addressing mode (LDAR)
  • TLCS900H: improved prefetch handling and instruction timing (still imperfect)
  • TLCS900H: improved timing further (still imperfect)

Apparently between releases of v120 and v121, Near wanted to remove the name of the structs to make them anonymous. However, this causes a "member with constructor not allowed in anonymous aggregate compiler" error. To resolve this, code was reverted back to it's syntax used in v120.

To apply the patch, place tlcs900h.diff in the /ares/component/processor/ directory and run the following command (linux):

patch -p0 < tlcs900h.diff

GCC 11 Compilation Quirk

If you're using a system that has GCC 11 as the primary compiler, a modification is required to ensure Ares v121 compiles. _serialize was introduced as a macro and was pushed into GCC 11. This is intentional. Thus any source code which uses _serialize as a local variable will need changes. Changes to to platform.hpp will resolve the issue.

To apply this patch, place gcc11_serialize.diff in the /nall/ and run the following command (linux):

patch platform.hpp < gcc11_serialize.diff

Why patches? Why not upload the Ares v121 source and modify as it's now under the ISC permissible license?

The license itself within the code links to the Open Source Initiative's ICS License page, but does not provide the Owner or Year information. It's safe to assume that Near is the owner and the year is 2021, but without an actual license included with this information bundled with the code, I do not wish to upload it.

If you wish to look at the new official branch with a release of Ares v121 with these patches already applied, please visit the release page here on the new official branch.

On a much more personal note, I also do not believe this contribution is worthy of Near's legacy. I did not wish to be the first person to fork Ares post v120. Near was obviously trying to tinker with the TLCS900H processor, leaving "still imperfect" in the release notes and what I have done is revert changes to successfully compile. This is a regression of code, and I would like to believe Near was always moving forward to improve their code, and there might have been a reason they wanted to change their code this way, however, I just couldn't figure out how to get it to work in a way Near probably could have.

This patch is released in the hopes that many will enjoy the legacy that Near/Byuu has created. From bsnes, to higan, to Ares. If this is the final version that Near has touched, I believe everyone has a right to play it and use it freely. I hope you these patches useful, and may they help carry on Near's spirit.