|
EmuTOS |
|
** This page is
under construction ** |
|
|
| Setting up the
EmuTOS build environment |
| |
|
1. |
Start
the Cygwin64 Terminal |
|
|
The
$ prompt appears |
|
2. |
Type:
cd emutos |
|
3. |
Type:
mkdir build |
|
4. |
Type: cd build |
|
5. |
Type:
cmake -DCMAKE_BUILD_TYPE=Debug -DCMAKE_TOOLCHAIN_FILE=../cmake/toolchain.cmake
.. |
|
| |
|
Building EmuTOS |
|
|
|
Here we create a version
of EmuTOS that can be downloaded to a Mega-680x0
Computer System's RAM and started from the SYS> prompt using the GO command. |
|
|
|
Defining where
EmuTOS will reside in memory |
|
|
|
1. |
In
Windows browse for the emutos.ld file, |
|
|
the file
will typically be located here: |
|
|
c:\cygwin64\home\{windows profile name}\emutos\ |
|
2. |
Open the
file using Windows Notepad |
|
3. |
Locate the
section: /* The ROM address depends on the
target */ |
|
4. |
For the
target MEGA_68000, edit the
line: '# define ROM_ORIGIN 0x00f80000' |
|
5. |
For 2MB
Mega-680x0 Systems use: 0x001c0000 |
|
|
For 4MB
Mega-680x0 Systems use: 0x003c0000 |
|
|
For 8MB
Mega-680x0 Systems use: 0x007c0000 |
|
6. |
Save and
close the file |
|
|
|
|
Defining how much
RAM EmuTOS can use |
|
|
|
1. |
In
Windows browse for the config_mega_68000.h file, |
|
|
the file
will typically be located here: |
|
|
c:\cygwin64\home\{windows profile name}\emutos\include\ |
|
2. |
Open the
file using Windows Notepad |
|
3. |
Edit the
line: '# define CONF_STRAM_SIZE 0x00400000' |
|
4. |
For 2MB
Mega-680x0 Systems use: 0x001c0000 |
|
|
For 4MB
Mega-680x0 Systems use: 0x003c0000 |
|
|
For 8MB
Mega-680x0 Systems use: 0x007c0000 |
|
5. |
Save and
close the file |
|
|
|
|
Building the
s-record file |
| |
|
1. |
Start
the Cygwin64 Terminal |
|
|
The
$ prompt appears |
|
2. |
Type:
cd emutos |
|
3. |
Type:
cd build |
|
4. |
Type:
make mega_68000.bin |
|
5. |
Type:
srec_cat mega_68000.bin -binary -offset 0x1C0000
-execution-start-address 0x1C0000 -crlf
-output mega_68000.srec |
|
| |
| Rebuilding the
s-record file |
| |
|
1. |
Start
the Cygwin64 Terminal |
|
|
The
$ prompt appears |
|
2. |
Type:
cd emutos |
|
3. |
Type:
cd build |
|
4. |
Type:
make clean |
|
5. |
Type:
rm *.bin |
|
6. |
Type:
rm *.srec |
|
7. |
Type:
make mega_68000.bin |
|
8. |
Type:
srec_cat mega_68000.bin -binary -offset 0x1C0000
-execution-start-address 0x1C0000 -crlf
-output mega_68000.srec |
|
| |
| Downloading
and running EmuTOS |
| |
|
1. |
In
Windows browse for the mega_68000.srec file, |
|
|
the file
will typically be located here: |
|
|
c:\cygwin64\home\{windows profile name}\emutos\build\ |
|
2. |
Open the
file using Windows Notepad |
|
3. |
Copy ALL
the text to the Windows Clipboard |
|
4. |
Start the
Mega-680x0 Computer System |
|
5. |
At the
SYS> prompt type: LO |
|
|
'Waiting
for Motorola S-Record file - ESC aborts' appears |
|
6. |
Paste the
copied text into the Console Window |
|
|
The
Mega-680x0 receives and processes the S-Record
formatted binary file, |
|
|
when
reception is complete, the Mega-680x0 will
accept the
next command |
|
7. |
At the
SYS> prompt type: GO 1C0000 (jump to EmuTOS
start address) |
|
|
The EmuTOS
splash screen appears followed by the C:\>
command prompt |
|
| |
| EmuTOS
compact flash test |
| |
|
1. |
Start
EmuTOS |
|
|
The C:\>
prompt appears |
|
2. |
Type: XFERRATE |
|
|
The
following appears: |
|
|
To start
the test, enter the drive letters that you wish
to
test, optionally separated by spaces and/or
commas. You may
enter an asterisk (*) to test all drives. To
quit now, press
enter: |
|
3. |
Type: C |
|
|
The
following appears: |
|
|
XFERRATE
v1.2 starting
Testing drive C:
Rwabs() transfer rate: 1730 kb/sec *
XHDI transfer rate: 1730 kb/sec *
XFERRATE exiting with code 0 ... press return |
|
4. |
Hit ENTER
to return to the C:\> prompt |
|
| |
| * transfer
rate may differ as it is system dependant |
| |
| EmuTOS C
compiler test |
| |
|
1. |
Start
EmuTOS |
|
|
The C:\>
prompt appears |
|
2. |
Type: CD STEVIE |
|
3. |
Type: RM
*.O |
|
|
Delete ALL
matching files (y/N)? appears |
|
4. |
Type: Y |
|
5. |
Type: C:\PURE_C\PCMAKE
STEVIE.PRJ |
|
|
Compilation starts - 4 warnings are expected but
there should be no errors |
|
| |
| EmuCON |
| |
|
Using the PATH command |
| |
|
To view the current path |
Type:
PATH |
|
To erase the current path |
Type:
PATH ; |
|
To set a new path * |
Type:
PATH C:\;C:\PURE_C\ |
|
| |
| * this example
sets the search path to C:\ and also C:\PURE_C\ |
| |
| EmuTOS file
types |
| |
| Program files |
| |
|
.TOS |
A TOS
program is one that requires no parameters |
|
.TTP |
A TTP
program is a "TOS Takes Parameters" program |
|
|
|
|
Note: |
|
TTP programs are designed to accept command-line
arguments or parameters. When you run a TTP
program the system prompts you to input
these arguments, which the program then
processes during execution. |
| |
| Creating/editing a
text file |
| |
| Type: UEMACS
<file name> |
| |
| Type:
CTRL+F |
To
move the cursor
forward |
| Type:
CTRL+B |
To
move the cursor back |
| Type:
CTRL+N |
To
move the cursor to the next
line |
| Type:
CTRL+P |
To
move the cursor to the
previous line |
| Type:
CTRL+X CTRL+S |
To
save the file |
| Type:
CTRL+X CTRL+C |
To
quit |
| Type:
ESC Z |
To
save and quit |
|
| |
|
If you use
C-Kermit for Windows as your Terminal Emulator
(recommended), follow
the instructions below to add cursor key support
for UEMACS. |
| |
|
1. |
Close
C-Kermit for Windows |
|
2. |
Open the
k95custom.ini file located in the C:\c-kermit
folder |
|
3. |
Add the
following line entries: |
|
|
|
set key \4903 |
\6 |
|
set key \4901 |
\2 |
|
set key \4904 |
\14 |
|
set key \4902 |
\16 |
|
|
4. |
Save and
Quit |
|
5. |
Restart
C-Kermit for Windows |
|
| |
| You can now
move around UEMACS by holding down the SHIFT key while
using the cursor keys. |
| |
| |
