EmuTOS - M548x BaS_gcc version

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

emutos-m548x-bas.s19 - RAM executable (English)

Supported hardware:

- M5485EVB (a.k.a. Zoom ColdFire EVB)
http://www.nxp.com/products/microcontrollers-and-processors/more-processors/coldfire-plus-coldfire-mcus-mpus/coldfire-mpus/v4-mpu/mcf5485-evaluation-board:M5485EVB

- M5484LITE (a.k.a. Zoom ColdFire LITEKIT)
http://www.nxp.com/pages/mcf5484-lite-evaluation-kit:M5484LITE

Prerequisites:
Your EVB needs to boot to BaS_gcc. It is a pre-OS similar to the one found on
the FireBee. You can download it there:
http://www.atariforge.org/gf/project/firebee/frs/?action=FrsReleaseBrowse&frs_package_id=19
Then you can flash the file m5484lite/bas.s19. Beware, after that, your EVB will
boot straight to BaS_gcc, and dBUG will not be available anymore.

Requirements:
- An RS-232 connection between the EVB and a controlling computer.
- On the computer, an ANSI terminal emulator connected to the RS-232 port.
- 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 appropriate software package.
https://support.logicpd.com/

How to flash EmuTOS:
You just have to flash emutos-m548x-bas.s19 with your favorite flash tool.
Beware: The start address specified in this file is set regarding to the BaS
address space, which is different than dBUG's one. If you use Freescale's
CF Flasher on Windows, you need to go to the Target Config dialog and set the
Flash Base Address to 0xE0000000 before flashing.

How to run EmuTOS:

1) Switch on the EVB.
You will see a few BaS_gcc debug messages in the terminal.

2) Then you will see the EmuTOS welcome screen.
Press C to enter the early console.

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

4) 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-bas

This release has been built on Linux Mint (a Ubuntu derivative), using
Vincent Rivière's GCC 4.6.4 cross-compiler.  The custom tools used in
the build process were built with native GCC 4.8.4.

The source package and other binary packages are available at:
http://sourceforge.net/projects/emutos/files/emutos/0.9.5/

If you want to read more about EmuTOS, please take a look at these files:

doc/announce.txt   - Introduction and general description, including
                     a summary of changes since the previous version
doc/authors.txt    - A list of the authors of EmuTOS
doc/bugs.txt       - Currently known bugs
doc/changelog.txt  - A list of changes: detailed up to and including
                     version 0.9.4; summarised for subsequent versions
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 future 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/country.txt    - An overview of i18n issues in EmuTOS
dos/fat16.txt      - Notes on the FAT16 filesystem in EmuTOS
doc/nls.txt        - How to add a native language or use one
doc/old_code.txt   - A museum of bugs due to old C language
doc/osmemory.txt   - All about OS internal memory in EmuTOS
doc/reschange.txt  - How resolution change works in the desktop
doc/resource.txt   - Modifying resources in EmuTOS

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