VRac/M6502/M6502.pm

package M6502;

use strict;
use warnings;

use Data::Dump qw/dump/;
use Carp qw/confess/;
use Exporter 'import';
our @EXPORT = qw'dump_R @mem $PC $A $P $X $Y $S $IPeriod $ICount $IRequest $IAutoReset $TrapBadOps $Trap $Trace $run_for $debug';
our $VERSION = '0.0.2';
require XSLoader;
XSLoader::load('M6502', $VERSION);

=head1 NAME

M6502 - perl bindings for M6502 CPU emulator

=head1 FUNCTIONS

=cut

our $debug = 0;

our @mem = (0xff) x 0x10000;    # 64M

# program counter
our $PC = 0xbeef;
# CPU registars
our ( $A, $P, $X, $Y, $S ) = (0) x 5;

our $IPeriod=1;         # Set IPeriod to number of CPU cycles between calls to Loop6502
our $ICount;
our $IRequest;          # Set to the INT_IRQ when pending IRQ
our $IAutoReset;        # Set to 1 to autom. reset IRequest
our $TrapBadOps=1;      # Set to 1 to warn of illegal opcodes
our $Trap;                      # Set Trap to address to trace from
our $Trace;                     # Set Trace=1 to start tracing

# Exec6502 cycles
our $run_for = 0;

=head2 init

Setup read and write memory hooks (to implement memory mapped devices)

  $init->(
        read => sub {
                return $mem[$_[0]];
        },
        write => sub {
                $mem[$_[0]] = $_[1];
        },
  );

=cut

our $_rw_hooks = {
        read => sub {
                warn sprintf("# callback read(%04x) not implemented", @_) if $debug;
                return $mem[$_[0]];
        },
        write => sub {
                warn sprintf("# callback write(%04x,%02x) not implemented", @_) if $debug;
                $mem[$_[0]] = $_[1];
        },
};

sub init {
        my $self = shift;
        my $args = {@_};
        warn "inside init low-level M6502 from ",ref($self),"\n";

        foreach my $p ( qw/read write/ ) {
                confess "need $p argument as coderef" unless ( $args->{$p} && ref($args->{$p}) eq 'CODE' );
                $_rw_hooks->{$p} = $args->{$p};
        }

};

=head2 poke_code

Write series of bytes into memory passing through MMU (C<read> and C<write>)
functions. If you don't want to trigger MMU, use C<write_chunk>.

  $emu->poke_code( 0xbeef, 0xff, 0x00, 0xff, 0x00, 0xaa );

=cut

sub poke_code {
        my $self = shift;
        my $addr = shift;
        warn sprintf("## M6502::poke_code(%04x,%s)\n", $addr, dump( @_ )) if $self->debug;
        #$mem[$addr++] = $_ foreach @_;
        # call low-level write
        $_rw_hooks->{write}->( $addr++, $_ ) foreach @_;
}

=head2 ram

Read series of bytes into memory without MMU interaction

  my @code = $emu->ram( 0xc000, 0xc1000 );

=cut

sub ram {
        my $self = shift;
        my ( $from, $to ) = @_;
        warn sprintf("## M6502::ram(%04x,%04x)\n", $from, $to) if $self->debug;
        return @mem[ $from .. $to ];
}

=head2 write_chunk

Low-level update of memory, overriding user specified MMU functions C<read> and C<write>

  $emu->write_chunk( $address, $chunk_of_data );

=cut

sub write_chunk {
        my ($self, $addr, $chunk) = @_;
        my $len = length($chunk);
        splice @mem, $addr, $len, unpack('C*', $chunk);
}

=head2 prompt

Call this after C<< $run_for >> cycles have been run on processor

=cut

sub prompt {
        warn "prompt -- you should override this\n";
        return 1;
}

=head1 XS Callbacks

This functions are called from C<M6502.xs>

=head2 _read

Read from memory C callback

  $byte = M6502::_read( $address );

=cut

sub _read {
        return $_rw_hooks->{read}->( @_ );
}

=head2 _write

Write into memory C callback

  M6502:_write( $address, $byte );

=cut

sub _write {
        return $_rw_hooks->{write}->( @_ );
}

=head2 _update_perl_R

called by C<M6502.xs> to push changes in registars back to perl variables

=cut

sub _update_perl_R {
        warn "## M6502::update_perl_R(",dump(@_),")\n" if $debug;
        ( $A, $P, $X, $Y, $S, $PC, $IPeriod, $ICount, $IRequest, $IAutoReset, $TrapBadOps, $Trap, $Trace ) = @_;
        dump_R();
}

=head2 dump_R

helper function which dumps registers in humanly readable form

  my $dump = dump_R;

=cut

sub dump_R {
        my $dump = sprintf(" PC: %04x A:%02x P:%02x X:%02x Y:%02x S:%02x "
                . "IPeriod:%d ICount:%d IRequest:%02x IAutoReset:%02x TrapBadOps:%d Trap:%d Trace:%d"
                . "\n",
                $PC, $A, $P, $X, $Y, $S, $IPeriod, $ICount, $IRequest, $IAutoReset, $TrapBadOps, $Trap, $Trace,
        );
        warn "## M6502::dump_R $dump" if $debug;
        return $dump;
}

=head2 debug

Turn perl and C-level debugging on/off

  $emu->debug( 0 );
  $emu->debug( 1 );
  print $emu->debug;

=cut

sub debug {
        my $self = shift;
        my $value = shift;
        if (defined($value)) {
                $debug = M6502::set_debug($value);
        } else {
                $debug = M6502::get_debug();
        }
        return $debug;
}

=head1 SEE ALSO

L<Orao> is sample implementation using this module

=head1 AUTHOR

Dobrica Pavlinusic, C<< <dpavlin@rot13.org> >>

=head1 COPYRIGHT & LICENSE

Copyright 2007 Dobrica Pavlinusic, All Rights Reserved.

This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.

=cut
1;
1	dpavlin	24	package M6502;
2
3			use strict;
4			use warnings;
5
6	dpavlin	27	use Data::Dump qw/dump/;
7	dpavlin	29	use Carp qw/confess/;
8	dpavlin	34	use Exporter 'import';
9	dpavlin	86	our @EXPORT = qw'dump_R @mem $PC $A $P $X $Y $S $IPeriod $ICount $IRequest $IAutoReset $TrapBadOps $Trap $Trace $run_for $debug';
10	dpavlin	80	our $VERSION = '0.0.2';
11			require XSLoader;
12			XSLoader::load('M6502', $VERSION);
13	dpavlin	27
14	dpavlin	29	=head1 NAME
15	dpavlin	24
16	dpavlin	54	M6502 - perl bindings for M6502 CPU emulator
17	dpavlin	29
18	dpavlin	89	=head1 FUNCTIONS
19
20	dpavlin	29	=cut
21
22	dpavlin	87	our $debug = 0;
23	dpavlin	24
24	dpavlin	29	our @mem = (0xff) x 0x10000; # 64M
25
26	dpavlin	25	# program counter
27	dpavlin	34	our $PC = 0xbeef;
28	dpavlin	25	# CPU registars
29	dpavlin	36	our ( $A, $P, $X, $Y, $S ) = (0) x 5;
30	dpavlin	74
31			our $IPeriod=1; # Set IPeriod to number of CPU cycles between calls to Loop6502
32			our $ICount;
33			our $IRequest; # Set to the INT_IRQ when pending IRQ
34			our $IAutoReset; # Set to 1 to autom. reset IRequest
35			our $TrapBadOps=1; # Set to 1 to warn of illegal opcodes
36			our $Trap; # Set Trap to address to trace from
37			our $Trace; # Set Trace=1 to start tracing
38
39	dpavlin	40	# Exec6502 cycles
40	dpavlin	42	our $run_for = 0;
41	dpavlin	24
42	dpavlin	54	=head2 init
43
44	dpavlin	89	Setup read and write memory hooks (to implement memory mapped devices)
45	dpavlin	26
46	dpavlin	89	$init->(
47			read => sub {
48			return $mem[$_[0]];
49			},
50			write => sub {
51			$mem[$_[0]] = $_[1];
52			},
53			);
54
55	dpavlin	26	=cut
56
57	dpavlin	89	our $_rw_hooks = {
58			read => sub {
59	dpavlin	92	warn sprintf("# callback read(%04x) not implemented", @_) if $debug;
60	dpavlin	89	return $mem[$_[0]];
61			},
62			write => sub {
63	dpavlin	92	warn sprintf("# callback write(%04x,%02x) not implemented", @_) if $debug;
64	dpavlin	89	$mem[$_[0]] = $_[1];
65			},
66			};
67
68	dpavlin	26	sub init {
69	dpavlin	33	my $self = shift;
70	dpavlin	89	my $args = {@_};
71			warn "inside init low-level M6502 from ",ref($self),"\n";
72	dpavlin	27
73	dpavlin	89	foreach my $p ( qw/read write/ ) {
74			confess "need $p argument as coderef" unless ( $args->{$p} && ref($args->{$p}) eq 'CODE' );
75			$_rw_hooks->{$p} = $args->{$p};
76			}
77	dpavlin	27
78	dpavlin	89	};
79	dpavlin	27
80	dpavlin	29	=head2 poke_code
81
82	dpavlin	42	Write series of bytes into memory passing through MMU (C<read> and C<write>)
83			functions. If you don't want to trigger MMU, use C<write_chunk>.
84	dpavlin	29
85			$emu->poke_code( 0xbeef, 0xff, 0x00, 0xff, 0x00, 0xaa );
86
87			=cut
88
89			sub poke_code {
90			my $self = shift;
91			my $addr = shift;
92	dpavlin	50	warn sprintf("## M6502::poke_code(%04x,%s)\n", $addr, dump( @_ )) if $self->debug;
93	dpavlin	42	#$mem[$addr++] = $_ foreach @_;
94	dpavlin	51	# call low-level write
95	dpavlin	90	$_rw_hooks->{write}->( $addr++, $_ ) foreach @_;
96	dpavlin	29	}
97
98	dpavlin	51	=head2 ram
99
100			Read series of bytes into memory without MMU interaction
101
102			my @code = $emu->ram( 0xc000, 0xc1000 );
103
104			=cut
105
106			sub ram {
107			my $self = shift;
108			my ( $from, $to ) = @_;
109			warn sprintf("## M6502::ram(%04x,%04x)\n", $from, $to) if $self->debug;
110			return @mem[ $from .. $to ];
111			}
112
113	dpavlin	31	=head2 write_chunk
114
115	dpavlin	42	Low-level update of memory, overriding user specified MMU functions C<read> and C<write>
116
117	dpavlin	31	$emu->write_chunk( $address, $chunk_of_data );
118
119			=cut
120
121			sub write_chunk {
122			my ($self, $addr, $chunk) = @_;
123			my $len = length($chunk);
124			splice @mem, $addr, $len, unpack('C*', $chunk);
125			}
126
127	dpavlin	42	=head2 prompt
128
129			Call this after C<< $run_for >> cycles have been run on processor
130
131			=cut
132
133			sub prompt {
134			warn "prompt -- you should override this\n";
135			return 1;
136			}
137
138	dpavlin	89	=head1 XS Callbacks
139
140			This functions are called from C<M6502.xs>
141
142			=head2 _read
143
144			Read from memory C callback
145
146			$byte = M6502::_read( $address );
147
148			=cut
149
150			sub _read {
151			return $_rw_hooks->{read}->( @_ );
152			}
153
154			=head2 _write
155
156			Write into memory C callback
157
158			M6502:_write( $address, $byte );
159
160			=cut
161
162			sub _write {
163			return $_rw_hooks->{write}->( @_ );
164			}
165
166	dpavlin	87	=head2 _update_perl_R
167	dpavlin	38
168	dpavlin	87	called by C<M6502.xs> to push changes in registars back to perl variables
169	dpavlin	38
170			=cut
171
172	dpavlin	87	sub _update_perl_R {
173			warn "## M6502::update_perl_R(",dump(@_),")\n" if $debug;
174	dpavlin	74	( $A, $P, $X, $Y, $S, $PC, $IPeriod, $ICount, $IRequest, $IAutoReset, $TrapBadOps, $Trap, $Trace ) = @_;
175	dpavlin	38	dump_R();
176			}
177
178			=head2 dump_R
179
180	dpavlin	68	helper function which dumps registers in humanly readable form
181	dpavlin	38
182	dpavlin	68	my $dump = dump_R;
183
184	dpavlin	38	=cut
185
186			sub dump_R {
187	dpavlin	74	my $dump = sprintf(" PC: %04x A:%02x P:%02x X:%02x Y:%02x S:%02x "
188			. "IPeriod:%d ICount:%d IRequest:%02x IAutoReset:%02x TrapBadOps:%d Trap:%d Trace:%d"
189			. "\n",
190			$PC, $A, $P, $X, $Y, $S, $IPeriod, $ICount, $IRequest, $IAutoReset, $TrapBadOps, $Trap, $Trace,
191			);
192	dpavlin	68	warn "## M6502::dump_R $dump" if $debug;
193			return $dump;
194	dpavlin	38	}
195
196	dpavlin	87	=head2 debug
197
198			Turn perl and C-level debugging on/off
199
200			$emu->debug( 0 );
201			$emu->debug( 1 );
202			print $emu->debug;
203
204			=cut
205
206			sub debug {
207			my $self = shift;
208			my $value = shift;
209			if (defined($value)) {
210			$debug = M6502::set_debug($value);
211			} else {
212			$debug = M6502::get_debug();
213			}
214			return $debug;
215			}
216
217	dpavlin	55	=head1 SEE ALSO
218	dpavlin	54
219	dpavlin	55	L<Orao> is sample implementation using this module
220
221	dpavlin	54	=head1 AUTHOR
222
223			Dobrica Pavlinusic, C<< <dpavlin@rot13.org> >>
224
225			=head1 COPYRIGHT & LICENSE
226
227			Copyright 2007 Dobrica Pavlinusic, All Rights Reserved.
228
229			This program is free software; you can redistribute it and/or modify it
230			under the same terms as Perl itself.
231
232			=cut
233	dpavlin	24	1;