Files
FireBee_Setup/firebee/flasher

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
Flashing the FireBee

--------------------



The FireBee's system software - that includes the FPGA firmware, the BaS,

FireTOS and EmuTOS - is stored in flash memory. The FireBee has 8MB of flash

memory which can be updated from TOS or MiNT by software.



Although there are no known problems when flashing the ROM under MiNT, we

recommend to perform this operation in a clean FireTOS or EmuTOS environment,

so the risk of "interferences" from other running tasks is kept to

a minimum while flashing.



The system software files can be downloaded from http://firebee.org.





FLASH_CF.PRG/FLASH060.PRG

-------------------------



There are two versions of the flash tool; FLASH_CF.PRG is a native ColdFire

compiled tool and can be used in both EmuTOS and FireTOS. The second,

FLASH060.PRG, is for the FireTOS environment only.



Flashing the "firmware" components is easy - start the program and click on

the harddrive-icon to open the fileselector. Select which file to flash.

You don't have to specify what kind of file it is (BaS, dBUG, FPGA, FireTOS,

EmuTOS...) as Flash* program will automatically detect this.



When you've selected a file, Flash program will load and verify it. This will

take a few seconds. When it's finished loading, click on the "Program" button.

The "LEDs" will light up one by one. When all are lit the programming has

finished and you can reboot.



NB! Don't flash the FireBee when it's running on battery power! If the

battery runs low during flashing you might end up with a "dead" FireBee and

external hardware is needed to reflash the flash memory!





FPGA firmware

-------------



The FPGA firmware specifies the behaviour of the FPGA. Inside the FPGA all

the Atari legacy components are implemented and most of the pins of most of

the FireBee's connectors/ports are directly connected to it.





BaS (Basis System) and dBUG

---------------------------



BaS or dBUG is the first thing that runs when the FireBee is switched on.

It initializes the hardware, loads the FPGA firmware into the FPGA and then

starts the operating system.

You can not install dBUG and BaS at the same time, it´s only possible to

use one of them.



dBUG has some additional features which are very handy if you're a developer.

First of all, it can boot an operating system (like TOS or Linux) from the

network. It also has a monitor which is accessible via the serial port.



BaS is written by Fredi Aschwanden.

dBUG by Freescale, adapted to the FireBee by Didier Mequignon.





EmuTOS

------



This is a version of EmuTOS built specifically for the FireBee and its

Coldfire CPU. As it is a Coldfire native OS, it is not capable of running

68k native programs, unless a 68K software emulator is used.

With the 68K emulator running 68K programs depends on several factors. As a

general rule, programs that do not break the Atari rules or relay on

undocumented/old/unofficial/deprecated features should run.





FireTOS

-------



FireTOS is the default Operating System for the FireBee and is derived

directly from the TOS60 for the CT6x Falcon accelerator. The FireTOS OS is

a heavily patched TOS 4.0.4 with the following additional key features:



- Support of most of the 68k opcodes with the help of the

  built-in CF68Klib (Freescale).

- Extended video modes via the built-in VDI driver for the FireBee Videl and

  ATI Radeon PCI graphics cards.

- USB drivers for keyboard, mouse and mass storage devices (memory sticks,

  USB harddrives...) that works under both TOS and FreeMiNT and also under

  EmuTOS when started from FireTOS boot menu.

- RAM-disk, TFTP-support, web-server, STiK compatible network stack.



Both EmuTOS and FireTOS have built-in harddisk drivers for the SD and CF cards.

They can access (and boot from) DOS-partitioned cards/drives.



The partition size limit for SD/CF cards is 2GB in FireTOS and EmuTOS with

the standard 8.3 Atari filenames.

In FreeMiNT, thanks to the VFAT option (set as default in our Setup),

disks/partitions of any size are possible and long filenames are supported.



Both EmuTOS and FireTOS are installed by default in the FireBee ROM. You can

select which one to start per default with setting the DIP switches on

the motherboard.



FireTOS: Switch #5 up, #6 up.

EmuTOS: Switch #5 down, #6 up.



EmuTOS started from switch is fully native and will access the Atari legacy

components only. This means that USB devices will not available, including

USB mice and keyboards.



ACP, May 2019.

http://firebee.org