-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathREADME.txt
142 lines (103 loc) · 5.42 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
Example Programs for the rosco_m68k
===================================
Some ready-compiled examples, so you can try out the rosco_m68k
without having to build any code yourself.
To use these, you'll want to have minicom and kermit installed,
so you can upload the programs to your board. See the software
documentation at https://rosco-m68k.com for details
on how to do that, and how to run it.
If you have the toolchain installed and want to build the
examples for yourself, all of the source code for these (and more)
is available at:
* https://github.com/rosco-m68k/rosco_m68k/tree/develop/code/software
The Examples
============
Firstly, you need to make sure you use the correct examples for
your firmware revision. There are four firmware directories:
* **firmware-1.01** contains programs for r1 boards with FW 1.01
* **firmware-1.1** contains programs for r1 boards with FW 1.1
* **firmware-1.2** contains programs for r1.2 boards with FW 1.2
* **firmware-1.3** contains programs for all boards with FW 1.3
Inside each of these directories, you'll find the examples, along
with pre-built ROM images for each release (including alphas and
betas where applicable) and pre-build library images.
All the examples are ready to upload to your board via Kermit,
and are contained in the relevant `examples` directory for your
firmware revision.
ehbasic.bin
-----------
This is a port of Lee Davison's Enhanced BASIC for 680x0 to
the rosco_m68k. When you load this on your rosco_m68k, you'll
be presented with a familar BASIC prompt, where you can type in
your programs and run them, just like any old-school BASIC
interpreter (It's case-sensitive too, commands must be uppercase!)
Note there are two versions - the standard version is designed to
be used with the onboard UART, while the `ehbasic-68681.bin` is
designed for use with the optional 68681 DUART board.
This is the README from the original project:
Enhanced BASIC is a BASIC interpreter for the 68k family
microprocessors. It is constructed to be quick and powerful and
easily ported between 68k systems. It requires few resources to
run and includes instructions to facilitate easy low level
handling of hardware devices. It also retains most of the powerful
high level instructions from similar BASICs.
EhBASIC is copyright Lee Davison 2002 - 2012 and free for
educational or personal use only. For commercial use please
contact me at leeedavison@lgooglemail.com for conditions.
For more information on EhBASIC68, other versions of EhBASIC and
other projects please visit my site at ..
http://mycorner.no-ip.org/index.html
adventure.bin
-------------
This is a port of Jeff Tranter's Abandoned Farmhouse Adventure
for the rosco_m68k. When loaded to your board, you'll start an
old-school text adventure!
This is the README from the original project:
The Abandoned Farmhouse Adventure is a text adventure game in the
spirit of similar games that ran on 8-bit microcomputers of the 1970s
and 80s or the more ambitious Colossal Cave adventure that originally
only ran on mainframes and minicomputers.
The plot and game should be self-explanatory. Figuring it out is the
point of the game.
I started writing it in BASIC but some things were very awkward to do
efficiently in Apple 1 BASIC. I also considered writing it in assembly
language, but ended up writing it in C because the excellent CC65
assembler worked very well for me.
It was written to run on the Apple Replica 1 although it is in
portable C and should run on any system with a C compiler (I did most
of the development and testing on a Linux system).
Because it was intended to run on the Replica 1 it was kept small and
efficient to run within the 32K memory limit and only use uppercase
characters and fit on a 40x24 character screen. Some code looks a
little unusual because it makes some optimizations for size and speed,
e.g. chars instead of ints, pre versus post increment/decrement. It is
a little too big to fit in an 8K EEPROM. It also won't run on an
original Apple 1 with 4K of memory but I am willing to port it if
someone sends me a system :-)
The source is included and under an Apache license so you can modify
and adapt the code if you wish. Much of the code is data-driven and
could be used to implement an entirely different adventure just by
changing the map, strings, and some of the logic that handles special
actions.
Oh and by the way, the farm described here is based on a real
farmhouse where my father lived many years ago, right down to the
layout of most of the rooms. And I also have grandson who was
almost 3 years old at the time I wrote this.
Jeff Tranter <tranter@pobox.com>
http://jefftranter.blogspot.ca/
memcheck.bin
------------
This is a simple memory exerciser for your rosco_m68k. When run, it
will do an exhaustive check of every memory location in the whole
address space, building a map of your memory as it goes.
When done, it will display the map, and halt the machine. Simple!
68010test.bin
-------------
This is a simple program that will crash the computer (making the
red LED blink in groups of three) if your CPU is not a 68010.
If it is a 68010, the green LED will flash quickly instead.
2dmaze.bin & life.bin
---------------------
A 2D maze game and Conway's Game Of Life demo, showing use of libm
in the standard libraries.
Many thanks to Matt Pierce for contributing these!