EmuTOS - M548x version

This EmuTOS version runs on ColdFire V4e Evaluation Boards.
No graphical output, only text mode ColdFire TOS programs through RS-232.

emutos-m548x.s19 - RAM executable (English)

Supported hardware:

- M5485EVB (a.k.a. Zoom ColdFire EVB)
http://www.logicpd.com/products/legacy/zoom-coldfire-evb/

- M5484LITE (a.k.a. Zoom ColdFire LITEKIT)
http://www.logicpd.com/products/legacy/zoom-coldfire-litekit/

Requirements:
- An RS-232 connection between the EVB and another computer.
- On the computer, an ANSI terminal emulator connected to the RS-232 port.
- An Ethernet connection between the EVB and your network.
- A TFTP server running somewhere on your network (can be the same computer).
- Optional: a CompactFlash card with a FAT16 partition.

To use the CompactFlash card, you need to have programmed the CPLD
(programmable component) on your board. You need to contact Logic PD
(the board manufacturer) to get the software package.
http://www.logicpd.com/support/

How to run EmuTOS:

1) Ensure that your serial connection works fine. In the terminal, you should
see the dBUG prompt.

2) Ensure that your TCP/IP connection is properly configured.

3) Put emutos-m548x.s19 on your TFTP server.

4) In the terminal, type the following command to download the binary:
dn emutos-m548x.s19

5) Then type the following command to run EmuTOS:
go

6) You will see the EmuTOS welcome screen.
Press C to enter the early console.

7) If you wait too much, the desktop will run in the background.
Press Control+Z to return to EmuCON.

8) Then you can run EmuCON commands, and external text mode programs.

Restrictions:

- No graphical display, no keyboard, no mouse.
Only text I/O through an RS/232 terminal.

- Support for ColdFire TOS programs only. 680x0 programs will not work.

- No Atari hardware emulated. Clean programs using only the OS will work,
the ones trying direct access to the Atari hardware will not work.

This ROM image has been built using:
make m548x

This release has been built using GCC 4.6.4 on Cygwin.

The source package, as well as other binary packages are available at:
http://sourceforge.net/projects/emutos/files/emutos/0.9.3/

If you want to read more about EmuTOS, please look into those files:

doc/announce.txt   - Introduction and general description
doc/authors.txt    - A list with the authors of EmuTOS
doc/bugs.txt       - Currently known bugs
doc/changelog.txt  - Detailed changes
doc/license.txt    - The FSF General Public License for EmuTOS
doc/status.txt     - What is implemented and running (or not yet)
doc/todo.txt       - What should be done in next versions
doc/xhdi.txt       - Current XHDI implementation status

Additional information for developers (just in the source archive):

doc/install.txt    - How to build EmuTOS from sources
doc/coding.txt     - EmuTOS coding standards (never used :-) )
doc/nls.txt        - How to add a native language or use one
doc/old_code.txt   - For developers, a museum of bugs due to old C language

-- 
The EmuTOS development team
http://emutos.sourceforge.net/
