flexutil - Miscellaneous FLEX utilities

SYNOPSIS

Utilities within flexemu:


emu irq | firq | nmi
emu mount <path> <drive_nr>
emu info [<drive nr>];
emu umount <drive nr>
emu format <disk_name> <size_in_KByte>
emu terminal | graphic
emu freq [<target_frequency>]
emu cycles
emu exit
exit
timeset
time
rtc on | off | alarm
cls
tounix <disk_image_name>

Utilities on Linux/WIN32:

fromflex
toflex

Utilities on Linux:

rcvflex

DESCRIPTION

emu is a command to directly communicate with the emulator from within the FLEX command shell. There are different operations concerning the cpu, the floppy controller or the graphical user interface (gui).
emu <irq | firq | nmi>
send a corresponding interrupt signal to the cpu. before invoking this command, there should already be set an interrupt vector before!
emu mount <path> <drive_nr>
mounts a disk image (DSK- or FLX-Format) or a NAtive File System (nafs)-directory <path> as a floppy with drive number <drive_nr>. <drive_nr> can be one of 0 - 3.
emu info [<drive_nr>]
prints some information on drive with number drive_nr or on all drives. <drive_nr>. <drive_nr> can be one of 0 - 3.
emu umount <drive_nr>
unmounts a previously mounted disk image or nafs-directory. <drive_nr> can be one of 0 - 3.
emu format <disk_name> <size_in_KByte>
formats a disk with name <disk_name> and with total size greater or equal to <size_in_KByte>. Disk sizes of up to 800 KByte are available. The disk will be formated in DSK-Format. The newly formated disk will not be mounted automatically!
emu terminal | graphic
At the time only available on Linux (sorry). If started flexemu in full graphics mode (without option -t ) this command can be used to switch between performing I/O on the graphic display or on the terminal. A hardware reset or nmi always switches back to grapic mode. This commond can only be used with Monitor neumon54.hex. It supports a parallel I/O on pia1 (MC6821) which will be used in the graphic mode, and a serial I/O on acia1 (MC6850) wich will be used in the terminal mode. The modes can be switched 'by hand' by changing the contents of address 0xef86 (SERPAR):

SERPARmode
== 0parallel I/O (graphic mode)
!= 0seriell I/O (terminal mode)

After a reset or nmi SERPAR will be initialized by the contents of address 0xf07c (INITSP).

emu freq [<target_frequency>]
Prints the actual frequency on which the virtual CPU is running. An optionaly given target_frequency gives a target frequency.
emu cycles
Prints the actual number of processor cycles executed.
emu exit
immediately exits the emulator. It is equivalent to the exit command.
timeset
a menudriven command to set the time, date or alarm time of the real time clock MC146818. If setting the alarm time a interrupt vector for firq should already be installed! Setting the date only updates the date in the real time clock but not the date used by FLEX.
time
Prints the actual date and time of the real time clock MC146818.
rtc on | off | alarm
Initializes or removes a continuous display of the actual time on the down left corner of the graphic display. The periodic interrupt of the rtc MC146818 will be used for this. The optional parameter specifies the action: on initializes the display to update every second. alarm initializes the display to update if alarm time reached. off removes the clock display.
cls
Clears the graphics display.
tounix <disk_image_name>
This utility is useful on a real FLEX system. It transmits the whole contents of a FLEX disk in drive 1 over the serial line. tounix is available as source file so it can be adapted to any special needs. The counterpart on linux is rcvflex.
fromflex
convert FLEX ASCII format to UNIX/MS-DOS ASCII format. The conversion will be done from stdin to stdout.
toflex
convert a UNIX/MS-DOS ASCII format to FLEX ASCII format. The conversion will be done from stdin to stdout.
rcvflex [-h | <serial_device>]
At the time only available on Linux (sorry). This utility transmits a FLEX disk from a real FLEX system to a Linux box. The counterpart on the FLEX system is the command tounix.cmd. The default for <serial_device> is /dev/cua2.

SEE ALSO