mirror of
https://github.com/cc65/cc65.git
synced 2025-03-19 07:30:24 +00:00
5be0b10b62
This PR is the first of two PRs that replaces earlier PRs #2589 and #2590. Due to a git branching mishap it was decided to re-partition the new functionality in two sequential PRs that offer self-contained, new functionality to sim65. The functionality in this first PR extends the sim65 simulator in the following ways: (1) It provides tracing functionality, i.e., the possibility of printing one line of simulator state information per instruction executed. (2) It provides a memory mapped "sim65 control" peripheral that allows control of (a) the tracing functionality, and (b) the cpu mode. (3) It provides command-line options to sim65 to enable the tracing, and to override the CPU mode as specified in the program file header. More detailed information and some discussion can be found in the discussions with the (now retracted) PRs #2589 and #2590. This PR provides the technical infrastructure inside the sim65 simulator program itself. Once this PR is accepted, a follow-up PR will be posted that adds C and assembly-language support for the new tracing and peripheral features so they can be easily accessed from the CC65 compiler and the CA65 assembler; some examples; and the documentation for these features. The lack of the latter, in this pull request, will be addressed then.
The cc65 cross-compiler suite
cc65 is a complete cross-development package for 65(C)02 systems, including a powerful macro assembler, a C compiler, linker, archiver, simulator and several other tools. cc65 has C and runtime library support for many of the old 6502 machines. For details look at the cc65 web site:
| Company / People | Machine / Environment |
|---|---|
| Apple | Apple II |
| Apple IIe enhanced | |
| Atari | Atari 400/800 |
| Atari 2600 | |
| Atari 5200 | |
| Atari 7800 | |
| Atari XL | |
| Lynx | |
| Tangerine | Oric Atmos |
| Eureka | Oric Telestrat |
| Acorn | BBC series |
| Commodore | C128 |
| C16 | |
| C64 | |
| CBM 510/610 | |
| PET | |
| Plus/4 | |
| VIC-20 | |
| VTech | CreatiVision |
| Commander X16 Community | Commander X16 |
| Bit Corporation | Gamate |
| Berkeley Softworks | GEOS (Apple/CBM) |
| LUnix Team | LUnix (C64) |
| Nintendo | Nintendo Entertainment System (NES) |
| Ohio Scientific | OSI C1P |
| MOS Technology, Inc. | KIM-1 |
| NEC | PC Engine (PCE) |
| Dr. Jozo Dujmović | Picocomputer (RP6502) |
| Watara | Watura/QuickShot Supervision |
| Synertek | SYM-1 |
A generic configuration to adapt cc65 to new targets is also around.
People
cc65 is originally based on the "Small C" compiler by Ron Cain and enhanced by James E. Hendrix.
Project founders
- John R. Dunning: original implementation of the C compiler and runtime library, Atari hosted.
- Ullrich von Bassewitz:
- moved Dunning's code to modern systems,
- rewrote most parts of the compiler,
- rewrote all of the runtime library.
Core team members
- Christian Groessler: Atari, Atari5200, and CreatiVision library Maintainer
- dqh: GHA help
- Greg King: all around hackery
- groepaz: CBM library, Project Maintainer
- Oliver Schmidt: Apple II library Maintainer
External contributors
- acqn: various compiler fixes
- jedeoric: Telestrat target
- jmr: compiler fixes
- karrika: Atari 7800 target
- Stephan Mühlstrasser: osic1p target
- Wayne Parham: Sym-1 target
- Dave Plummer: KIM-1 target
- rumbledethumps: Picocomputer target
(The above list is incomplete, if you feel left out - please speak up or add yourself in a PR)
For a complete list look at the full team list or the list of all contributors.
Contact
For general discussion, questions, etc subscribe to the mailing list or use the github discussions.
Some of us may also be around on IRC #cc65 on libera.chat.
Documentation
- The main Documentation for users and developers.
- Info on Contributing to the CC65 project. Please read this before working on something you want to contribute, and before reporting bugs.
- The Wiki contains some extra info that does not fit into the regular documentation.
Downloads
