Welcome to the Calypsi C compiler for the 6502!

• 1. Introduction
  • 1.1. Using this guide
  • 1.2. Copyright notice
  • 1.3. Disclaimer
• 2. Installation
  • 2.1. macOS
  • 2.2. Debian Linux
  • 2.3. Fedora Linux
  • 2.4. Arch and Manjaro Linux
  • 2.5. Windows
  • 2.6. Using multiple versions
• 3. Tutorial
  • 3.1. Simulator
  • 3.2. Commodore 64
  • 3.3. MEGA65
• 4. Getting started
  • 4.1. C language
  • 4.2. File extensions
  • 4.3. Building applications
  • 4.4. Configuring
  • 4.5. Low level control
  • 4.6. Example projects
• 5. Data storage
  • 5.1. Ways to store data
  • 5.2. Address spaces
• 6. Placing code and data
  • 6.1. Sections
  • 6.2. Data initialization
  • 6.3. Stack
• 7. C language
  • 7.1. Overview
  • 7.2. Extensions
• 8. Efficient coding
  • 8.1. Data types
  • 8.2. Use prototypes
  • 8.3. Use tables
• 9. Target specifics
  • 9.1. Board support
  • 9.2. Commodore 64
  • 9.3. MEGA65
  • 9.4. Commander X16
  • 9.5. Linking
  • 9.6. Banked linking
• 10. Running the compiler
  • 10.1. Basic invocation
  • 10.2. Include search path
  • 10.3. Compiler output
  • 10.4. Diagnostics
  • 10.5. Command line options
• 11. Data representation
  • 11.1. Basic types
  • 11.2. Structure types
  • 11.3. Union types
  • 11.4. Enumeration types
  • 11.5. Type qualifiers
  • 11.6. Type definitions
  • 11.7. Alignment
• 12. Extended attributes
  • 12.1. Overview
  • 12.2. Using attributes
  • 12.3. Attribute reference
• 13. Language extensions
  • 13.1. Overloaded functions
  • 13.2. Statement expressions
  • 13.3. Auto type
  • 13.4. Typeof
  • 13.5. Generics
• 14. Pragma directives
  • 14.1. Pragma directives reference
• 15. Intrinsic functions
  • 15.1. Intrinsic functions reference
• 16. Preprocessor
  • 16.1. Overview
• 17. Section reference
  • 17.1. Section overview
  • 17.2. Sections used by the compiler
• 18. Runtime library
  • 18.1. Design considerations
  • 18.2. Using the library
  • 18.3. Provided library files
  • 18.4. Stubs interface
  • 18.5. Examine use of library
  • 18.6. Library on a diet
  • 18.7. Override library functions
  • 18.8. C startup
  • 18.9. Time and date
  • 18.10. Rebuilding the C library
• 19. The optimizer
  • 19.1. Overview
  • 19.2. Function inlining
  • 19.3. Cross call
• 20. Assembly language interface
  • 20.1. Intrinsic functions
  • 20.2. Assembly functions
  • 20.3. Calling convention
  • 20.4. Inline assembler
• 21. Assembler
  • 21.1. Overview
  • 21.2. Syntax
  • 21.3. 6502 assembly
  • 21.4. Sections
  • 21.5. Expressions
  • 21.6. Numeric constants
  • 21.7. Location counter
  • 21.8. Local labels
  • 21.9. Directives
  • 21.10. Relocations
  • 21.11. Macro language
• 22. Running the assembler
  • 22.1. Basic invocation
  • 22.2. Include search path
  • 22.3. Assembler output
  • 22.4. Command line options
• 23. Linker
  • 23.1. Running the linker
  • 23.2. Linking process
  • 23.3. Simplified placement rules
  • 23.4. ROM based systems
  • 23.5. Host based systems
  • 23.6. Objects
  • 23.7. Memory
  • 23.8. Linker rules file
  • 23.9. Scatter
  • 23.10. Linker list files
  • 23.11. Output formats
  • 23.12. More on linker rules
  • 23.13. Command line options
• 24. Librarian
  • 24.1. Creating a library
  • 24.2. File format
  • 24.3. Command line options
• 25. Debugger introduction
  • 25.1. Command line debugger
  • 25.2. Running the debugger
  • 25.3. Command line options
• 26. Console command line
  • 26.1. Command structure
  • 26.2. A simple debugging session
• 27. Remote debugging
  • 27.1. Serial port
• 28. Visual Studio Code
  • 28.1. Installation
  • 28.2. Project setup
  • 28.3. Building
  • 28.4. Running the debugger
• 29. Lua scripting
  • 29.1. Running a script
  • 29.2. Lua environments
  • 29.3. Command interpreters
  • 29.4. Console commands
  • 29.5. MI commands
  • 29.6. Adapted MI commands
  • 29.7. Choosing a command set
  • 29.8. Arrays and Lua
  • 29.9. Debugger API
• 30. Lua data types reference
  • 30.1. Address
  • 30.2. Adapted MI functions
• 31. Lua function reference
  • 31.1. Execution
  • 31.2. Breakpoint