1
0
mirror of https://github.com/cc65/cc65.git synced 2025-02-13 12:30:40 +00:00
sidney 988260c699 sim65: add C/assembly support, docs, and samples for the new peripheral functionality.
This PR is the second 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 second and last PR provides the following things in relation to the new "peripheral" support:

* C support: there is now an include/sim65.h that can be included from C. It provides access to the memory-mapped peripheral addresses.

* Asm support: there is now an asminc/sim65.inc that can be included from assembly. It provides symbolic labels for the memory-mapped peripheral addresses.

Note: the two items above are implemented by adding a "_peripherals" symbol to cfg/sim6502.cfg and cfg/sim65c02.cfg, with the fixed base address of the peripherals memory aperture (0xffc0).

* Updated the sim65 documentation to describe the peripherals in some detail, with examples that show to use the new features from within C.

* Some examples in the new samples/sim5/ directory. These are currently not integrated in the build system (in other words, there's no Makefile there), because I don't know how to do that. I will happily implement that after #2582 is taken care of.

If that is not acceptable, the next best thing will be for somebody else (who understands how the Makefiles are set up) to take care of this.

If that's not going to happen, and we don't want examples that are not properly integrated with the build system, there's always the option of removing these samples from the PR.
2025-01-05 15:58:05 +01:00
2024-12-18 09:04:20 +01:00
2023-05-05 21:56:52 -04:00
2024-08-10 15:29:50 +02:00

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

External contributors

(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

Snapshot Build

Description
cc65 - a freeware C compiler for 6502 based systems
Readme Zlib 405 MiB
Languages
C 62.5%
Assembly 35.5%
PHP 0.7%
Makefile 0.6%
Perl 0.3%
Other 0.3%