COMMODORE 64 - Examples in 6502 Assembly language

Installation

1. Setup Turbo Macro Pro Cross Assembler (TMPx)
   • MacOS (vendors/tmpx/tmpx): Allow tmpx to be executed as program: sudo chmod +x PATH/tmpx
   • Windows (vendors/tmpx/TMPx.exe)
2. Compile all *.asm files to *.prg files in src with make convert
3. Load specific program into C64 Emulator VICE
   • make load name={PATH_TO_PROGRAM_NAME} (f.e. PATH_TO_PROGRAM_NAME = examples/printString.prg)
   • sys call in the C64 Emulator, specified in the program file (f.e. sys 679)
4. Delete all *.prg files in src with make clean

Tools

Visual Studio Code

Visual Studio Code is a streamlined code editor with support for development operations like debugging, task running, and version control. It aims to provide just the tools a developer needs for a quick code-build-debug cycle and leaves more complex workflows to fuller featured IDEs, such as Visual Studio IDE.

Extensions

• Retro Assembler

Turbo Macro Pro Cross Assembler (TMPx)

TMPx (pronounced "T-M-P cross") is the multiplatform cross assembler version of Turbo Macro Pro, itself derived from the famous Turbo Assembler series for the native C64. TMPx was the first cross assembler released with full support for the syntax of Turbo Macro Pro (i.e. same as the original Turbo Assembler Macro).

Current version: TMPx v1.0, released 04/29/2012 by The Wiz/Style and Elwix/Style

C1541

C1541 is a stand-alone disk image maintenance utility. This tool is installed together with VICE.

Documentation

• Syntax Documentation

VICE

VICE is a program that runs on a Unix, MS-DOS, Win32, OS/2, BeOS, QNX 4.x, QNX 6.x, Amiga, Syllable or Mac OS X machine and executes programs intended for the old 8-bit computers. The current version emulates the C64, the C64DTV, the C128, the VIC20, practically all PET models, the PLUS4 and the CBM-II (aka C610/C510). An extra emulator is provided for C64 expanded with the CMD SuperCPU.

Interesting readings

• 6502 opcodes
• C64 Memory Map
• C64 User's Guide Examples in Machine Language
• Codebase 64
• Commodore 64 Architecture by Jim Butterfield
• Compute! Magazine Archive
• Dustlayer Tutorials
• Guide to the 6502 Assembly language
• The almost completely commented C64 ROM disassembly, Lee Davison

Tools

• Spritemate
• PETSCII Editor

Buy me a coffee

Whether you use this project, have learned something from it, or just like it, please consider supporting it by buying me a coffee.

License

MIT License

Copyright (c) 2020 - 2023 digitsensitive [email protected]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.