use 5.014000;
use strict;
use warnings;
+use re '/s';
+use Carp qw/croak/;
use Data::Dumper qw/Dumper/;
use Data::SExpression qw/consp scalarp/;
use Scalar::Util qw/looks_like_number/;
-our $VERSION = '0.004';
+our $VERSION = '1.000';
our %TYPES = (
LIST => 0,
}
$addr += (1 << $self->{addr_bits}) if $addr < 0;
- die "Type too large: $type\n" unless $type < (1 << $self->{type_bits});
- die "Addr too large: $addr\n" unless $addr < (1 << $self->{addr_bits});
+ die "Type too large: $type\n" if $type >= (1 << $self->{type_bits});
+ die "Addr too large: $addr\n" if $addr >= (1 << $self->{addr_bits});
my $result = ($type << $self->{addr_bits}) + $addr;
+
unless ($location) {
$self->{freeptr}++;
$location = $self->{freeptr}
$args{addr_bits} //= 8;
$args{freeptr} //= 6;
$args{memory} //= [0, 0, (1<<$args{addr_bits}), (1<<$args{addr_bits}), 0, 0, 0];
- $args{comment} = ['(cdr part of NIL)', '(car part of NIL)', '(cdr part of T)', '(car part of T)', '(free storage pointer)', '', '(result of computation)'];
+ my @default_comments = ('(cdr part of NIL)', '(car part of NIL)', '(cdr part of T)', '(car part of T)', '(free storage pointer)', '', '(result of computation)');
+ for (0 .. $#default_comments) {
+ $args{comment}[$_] = $default_comments[$_]
+ }
bless \%args, $class
}
die "addr_bits + type_bits >= 16\n"if $self->{addr_bits} + $self->{type_bits} > 16;
my $length = @{$self->{memory}};
- print $fh pack('n', $length);
+ print $fh pack 'n', $length or croak "Failed to print memory size: $!"; # uncoverable branch true
for (@{$self->{memory}}) {
- print $fh pack('n', $_)
+ print $fh pack 'n', $_ or croak "Failed to print memory: $!" # uncoverable branch true
}
}
my $spaces = ' ' x ($bits + 5 - (length $val));
$index = sprintf $index_format, $index;
- print $fh "mem[$index] <= $val;";
- print $fh "$spaces // $comment" if defined $comment;
- print $fh "\n";
+ my $string = "mem[$index] <= $val;";
+ $string .= "$spaces // $comment" if defined $comment;
+ say $fh $string or croak "Failed to print verilog: $!"; # uncoverable branch true
}
}
C<(tag value)>, for example C<(symbol 2)>, represents a value to be
put in memory (for example a number, or a symbol, or a variable
-reference).
+reference). The value must be a number.
C<(tag list)>, where C<list> is of one of these three types,
represents a tagged pointer. In this case, C<list> is (recursively)
A word is made of a type and an address, with the type occupying the
most significant C<type_bits> (default 3) bits, and the address
occupying the least significant C<address_bits> (default 8) bits.
-Therefore the word size is C<type_bits + address_bits> (default 13).
+Therefore the word size is C<type_bits + address_bits> (default 11).
=item freeptr
=item comment
The initial comments for memory entries. C<< $comment->[$i] >> is the
-comment for C<< $memory->[$i] >>.
+comment for C<< $memory->[$i] >>. Note that the first 7 entries of
+this array will be overwritten with the default comments. This is
+useful when using custom initial memory contents and freeptr, because
+this key can be used to provide comments for the extra reserved
+locations in memory.
=back