mirror of
https://github.com/cc65/cc65.git
synced 2025-08-05 17:25:17 +00:00
988260c699
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.
76 lines
3.0 KiB
PHP
76 lines
3.0 KiB
PHP
|
|
; *******************************************************************************
|
|
; ** **
|
|
; ** sim65.inc : assembler definitions for the sim6502 and sim65c02 targets. **
|
|
; ** **
|
|
; ** Sidney Cadot, January 2025 **
|
|
; ** **
|
|
; *******************************************************************************
|
|
|
|
; The '_peripherals' symbol is defined in the linker configuration
|
|
; file to correspond to the first address in the periperal memory
|
|
; aparture.
|
|
;
|
|
; We use it here as a base address for all peripheral addresses.
|
|
|
|
.import _peripherals
|
|
|
|
; **************************************************************
|
|
; ** **
|
|
; ** Define assembler symbols for the "counter" peripheral. **
|
|
; ** **
|
|
; **************************************************************
|
|
|
|
peripheral_counter_base := _peripherals + 0
|
|
|
|
peripheral_counter_latch := peripheral_counter_base + 0
|
|
peripheral_counter_select := peripheral_counter_base + 1
|
|
peripheral_counter_value := peripheral_counter_base + 2
|
|
|
|
; Values for the peripheral_counter_select register.
|
|
|
|
COUNTER_SELECT_CLOCKCYCLE_COUNTER = $00
|
|
COUNTER_SELECT_INSTRUCTION_COUNTER = $01
|
|
COUNTER_SELECT_IRQ_COUNTER = $02
|
|
COUNTER_SELECT_NMI_COUNTER = $03
|
|
COUNTER_SELECT_WALLCLOCK_TIME = $80
|
|
COUNTER_SELECT_WALLCLOCK_TIME_SPLIT = $81
|
|
|
|
; ********************************************************************
|
|
; ** **
|
|
; ** Define assembler symbols for the "sim65 control" peripheral. **
|
|
; ** **
|
|
; ********************************************************************
|
|
|
|
peripheral_sim65_base := _peripherals + 10
|
|
|
|
peripheral_sim65_cpu_mode := peripheral_sim65_base + 0
|
|
peripheral_sim65_trace_mode := peripheral_sim65_base + 1
|
|
|
|
; Values for the peripheral_sim65_cpu_mode register.
|
|
|
|
SIM65_CPU_MODE_6502 = $00
|
|
SIM65_CPU_MODE_65C02 = $01
|
|
SIM65_CPU_MODE_6502X = $02
|
|
|
|
; Bitfield values for the peripheral_sim65_trace_mode field.
|
|
|
|
SIM65_TRACE_MODE_FIELD_INSTR_COUNTER = $40
|
|
SIM65_TRACE_MODE_FIELD_CLOCK_COUNTER = $20
|
|
SIM65_TRACE_MODE_FIELD_PC = $10
|
|
SIM65_TRACE_MODE_FIELD_INSTR_BYTES = $08
|
|
SIM65_TRACE_MODE_FIELD_INSTR_ASSEMBLY = $04
|
|
SIM65_TRACE_MODE_FIELD_CPU_REGISTERS = $02
|
|
SIM65_TRACE_MODE_FIELD_CC65_SP = $01
|
|
|
|
; Values for the peripheral_sim65_trace_mode field that fully disable / enable tracing.
|
|
|
|
SIM65_TRACE_MODE_DISABLE = $00
|
|
SIM65_TRACE_MODE_ENABLE_FULL = $7F
|
|
|
|
; ************************
|
|
; ** **
|
|
; ** End of sim65.inc **
|
|
; ** **
|
|
; ************************
|