1. INTRODUCTION

The Advanced Control Panel ACP, is a 16k program contained in an EPROM
suitable for the BBC B, B+, Master Series, Master Compact and the Acorn
Electron. It will also run in sideways RAM.

ACP is a language ROM intended to operate as a front end control panel
between the user and the computer, providing a friendly interface for access
to other languages, MOS functions and the user's own files, utilities &c.

Users can create their own windows with their own titles and window options.
These windows could for example, open up a calculator or display the time
from the real time clock, or they could list the user's own files and
EXEC/RUN one when selected. Together these windows form a control panel
which can be saved to Disc/Tape and loaded later. Building this into a !BOOT
file would produce a turn-key system with the users own control panel.

The MOS's configure options can be very easily changed by opening up the
CONFIGURE window and selecting the configure option you want to change.
Changing the option is done by just moving a tick next to the new option.
The current configure options can be preserved by saving a configure file to
Disc/Tape and later restoring them by re-loading the configure file.

On the Master series, which have a real time clock, the CLOCK window can be
used to display the time and date and also make changes to it very simply.
There is also an alarm system which can be used to ring the bell or issue a
MOS command at a specified time and date.

The DIRECTORY window allows the files from the current directory to be
displayed on the screen and a file pointer can be moved around the screen to
select and automatically load or run a particular file. If the entry is a
directory, then the files from that directory are listed on the screen.
Other functions include, dumping and typing a file, deleting a file, loading
a View file into View and loading a Viewsheet file into Viewsheet

The ROMS window displays all 16 sideways ROMs, showing clearly which ones
are turned on or off and which ROMs contain sideways RAM. ROMs can be easily
turned on or off with one key press. ROMs can be saved in a file by copying
their ROM image to Disc/Tape and ROM files can be loaded into sideways RAM
from Disc/Tape. There is also a command to remove a ROM from a sideways RAM
bank.

ACP even has its own calculator, which can add, subtract, multiply and
divide floating point numbers in decimal, binary and hexadecimal.

  2 FITTING THE ACP ROM

The ACP ROM may be fitted into the BBC B, B+, Master series or Master
Compact. It can also be fitted to the Acorn Electron, with a suitable ROM
carrier board, such as an ACP ROM Adaptor board.

Making ACP the Default Language

The ACP ROM can be made to appear when the computer is turned on or after a
CTRL/BREAK by making it the default language ROM.

On the Master series and the Master Compact the ROM socket number is not
important, since the CONFIGURE Lang command can be used to change the
default language.


    NEVER INSERT OR REMOVE A ROM WITHOUT TURNING OFF THE POWER FIRST
        FAILING TO DO SO, MAY CAUSE PERMANENT DAMAGE TO THE ROM.

The BBC Computer

After turning off the power, take off the top cover of the computer by
removing the four fixing screws located at the back of the computer and on
the underside near the front.

Now locate the ROM sockets. In the BBC B+ they are situated to the right of
the power supply. The two sockets nearest the front of the computer are used
by the speech synthesizer and should not be used. In the BBC B the ROM
sockets are situated beneath the keyboard, so remove the screws securing the
keyboard to the computer and move it carefully to one side; just enough to
expose the four ROM sockets located on the right side of the board.

Insert the ACP ROM into one of the empty ROM sockets, with the little notch
in the end of the chip facing the back of the computer. Take care not to
bend any of the legs on the chip. On the BBC B screw the keyboard back on.
Replace the top cover.

The Master Compact

After turning off the power, take off the top cover of the computer by
removing the four fixing screws located on the underside of the computer at
the two ends. Raise the top half of the computer a few inches and rotate
through 90 degrees and lower gently to rest on the bottom half of the
computer. The five ROM sockets are situated on the EAST side of the board.
The socket furthest SOUTH should be occupied.

Insert the ACP ROM into one of the free sockets with the notch in the chip
pointing WEST. Take care not to bend any of the legs on the chip. Replace
the top cover and fixing screws.
The Electron


The ACP ROM must be fitted to the PLUS 1 via a suitable ROM carrier board,
such as the ACP Adaptor board.

The Master

The ACP ROM can either be fitted into one of the two cartridge slots via a
suitable ROM carrier board, or fitted directly into a free ROM socket
located inside the computer.

To insert the ACP ROM into a free socket in the computer, unscrew the four
fixing screws and remove the top cover. Locate the four ROM sockets situated
on the EAST side of the board. The NORTHERNmost socket should already be
occupied. Insert the ACP ROM in one of the free sockets making sure that the
little notch on the chip points WEST. Take care not to bend any of the legs
on the chip.
To make the ALARM function in the ACP ROM operate, the small jumper supplied
must be fitted to Link 4 on the main board.

Remove the top cover
Locate Link 4 situated on the WEST side of the board in the centre, between
the two co-processor connectors. Join the link together by pushing the
jumper over the two pins. Replace the cover and fixing screws.



Testing the ACP ROM

Turn on the power and type:-

*ACP <RETURN>

The ACP front panel should appear. If not it is likely that the ROM has been
fitted incorrectly. Check that all the legs have been properly inserted into
the socket.

On the Electron the panel should appear as soon as the power is switched on.

 3.  THE ACP LANGUAGE


To make the most of ACP it is recommended that the ROM is made the default
language. This is explained in the previous chapter.


To enter ACP from another language type:-

*ACP

or

*ACP<filename> 

where <filename> is the name of a control panel. The control would be loaded
into memory and then displayed on the screen.

To enter BASIC or any other laguage from ACP, simply move the window cursor
using the up and down cursor keys over the language title and press RETURN.

To view all 16 sideways ROMs, move the window cursor over the MOS window
title using the right key and press RETURN. The window which appears shows
all 16 ROMs. Select from this list. Pressing ESCAPE returns you to the MOS
window.

Right and Left arrows move you from window to window.
Up and Down arrows select within the window.Then press RETURN

Press * from any window to enter a * command

Escape returns you to the parent window


Using ACP in sideways RAM

When run in sideways RAM ACP will use the last 32 bytes of the SWR for the
storage of configuration options. This would mean the configuration options
would be preserved until the power was removed, even after running a very
long program which might clear memory with *FX200,2.

If ACP is run in battery backed sideways RAM such as ACP's 32k ABR
cartridge, then the configuration options will be preserved even after the
power is removed. This would make the BBC B, B+ or Electron have similar
characteristics to the MASTER and MASTER Compact with their own CMOS RAM.

 4. LANGUAGE

This WINDOW shows all the language ROMs fitted into the computer. The ACP
ROM will always appear since it is a language itself.

A typical window display on th Master might show:-

Advanced Control Panel
Viewsheet
Edit
BASIC
View
Terminal

An Electron display might be:-

Advanced Control Panel
BASIC
Electron Expansion

Note the appearance of the Electron Expansion ROM, which is included because
it has a language entry point, but is not really a language. Selecting this
ROM as a language is pointless

To exit ACP and enter another language, move the cursor over the language
title and press RETURN.

On entry to another language the MODE number, SHADOW status and
Background/Foreground colours are changed to the values set in the CONFIGURE
option.

To return to ACP enter:-

*ACP

or

*ACP<filename>

where <filename> is the name of a control panel on Disc/Tape

or

if ACP is the default language press CTRL/BREAK

On entering ACP, any panel found in memory at PAGE will be used as the
control panel. Press CTRL/C from any window to return to the ACP main
control panel.

 5. MOS

This window shows a menu of commands which relate to the computer's Machine
Operating System:- MOS ROMS CONFIGURE CLOCK ALARM and CALCULATOR

The ROMS option shows all the ROMS fitted and allows any of them to be
turned on or off. The ROMS option can also be used to load a sideways ROM
file into a RAM bank or save a ROM image as a ROM file. A ROM image can also
be removed from a RAM bank with this option.
The CONFIGURE option allows changes to be made to the current configuration
as shown by *STATUS

The CLOCK option allows the time and date in the Real Time Clock to be
changed.

The CALCULATOR option produces a calculator for addition, subtraction,
multiplication and division of decimal, hexadecimal and binary numbers.


ROMS

The ROMs window displays the titles of all 16 ROM sockets. Sockets which
have been 'unplugged' are shown with a '*' next to the 'socket number' and
sockets which contain a ROM are marked with a '+' next to the 'socket
number'

To turn off a ROM, move the cursor over the ROM title and press RETURN. A
'*' will appear next to the ROM number. This has the same effect as *UNPLUG
on a Master. To turn a ROM back on, press RETURN again and the * will
disappear. This has the same effect as *INSERT on a Master.

To save a ROM image as a ROM file on Disc or Tape, move the cursor over the
ROM title and press CTRL/S. A prompt at the bottom of the screen will
request a filename. After supplying this, press RETURN.

To load a ROM file from Disc or Tape into a sideways Ram bank, move the
cursor over the ROM number and press CTRL/L. A prompt will ask for a
filename. Type this in and press RETURN. The file will be loaded into memory
and then transfered to SWR. The title of the ROM will appear in the ROM
window.

To remove an image from SWR move the cursor over the ROM title and press
CTRL/Z. The RAM bank will be filled with zeros and the ROM title will be
removed from the window.

CONFIGURE

This window allows changes to be made to the current 'STATUS' settings on  a
Master Series which are retained after switch-off in the CMOS RAM.

The window displays:-

TV SETTING
MODE
COLOUR
AUTO-BOOT
DRIVE CONTROL
KEYBOARD STATUS
RS423 OPTIONS
PRINTER OPTIONS
SOUND
SCROLL
ADFS OPTIONS
LANGUAGE
FILING SYSTEM
CO-PROCESSOR
ECONET OPTIONS
LOAD CONFIGRE
SAVE CONFIGURE

To change a particular configuration option select the title from the window
using the cursor keys and press RETURN, when a tick will appear next to the
name.
Repeating this with a second selection will remove the tick from the first
option and insert a tick against the second. The tick therefore always shows
the current selection.

The configure options SCROLL, ADFS OPTIONS, LANGUAGE, FILING SYSTEM,
CO-PROCESSOR and ECONET OPTIONS are only available on the Master series and
the Master Compact.


TV SETTING

This allows adjustments to be made to the  options relating to the TV
settings. This is the same as *CONFIGURE TV on the Master and Compact.

INTERLACE

This allows the TV interlace to be switched 'on' or 'off'. Interlacing is
really only noticeable on video monitors.

INTERLACE ON
INTERLACE OFF

INTERLACE ON is the normal setting, producing a jittery effect. INTERLACE
OFF produces a steadier picture.

VERTICAL ALIGNMENT

This moves the display up or down on the screen

+3
+2
+1
+0
-1
-2
-3
-4

+1 moves the display up one line and -1 move it down one line. +0 moves it
to its normal central position.

On some TV's/monitors moving the screen too far up or down can cause the
picture to flicker.


MODE

This allows the screen MODE to be changed and also determines whether shadow
RAM is used. The screen mode is changed when a new language is entered from
the LANGUAGE window. This is the same as *CONFIGURE Mode on the MASTER
series.

NON-SHADOW
SHADOW
MODE 0
MODE 1
MODE 2
MODE 3
MODE 4
MODE 5 
MODE 6
MODE 7

NON-SHADOW just cancels SHADOW


COLOUR

This allows the background and foreground colours to be changed.These
colours are preerved after changing mode when entering a new language from
the LANGUAGE window, except when changing to MODE 7.

BACKGROUND
FOREGROUND

BACKGROUND changes the normal black background on which the text display is
written.

FOREGROUND changes the normally white foreground (text) colour.

BLACK
RED
GREEN
YELLOW
BLUE
MAGENTA
CYAN
WHITE

These colours are available for both foreground and background.


Auto-Boot

This allows the action of SHIFT/BREAK to be reversed ie. the action of
SHIFT/BREAK is reversed with the action of pressing BREAK on its own.

AUTO-BOOT OFF
AUTO-BOOT ON

AUTO-BOOT OFF causes BREAK to perform a normal reset and SHIFT/BREAK in DFS
to auto-boot the !BOOT file according to the *OPT4 setting. This is the same
as *CONFIGURE NoBoot on the Master series.

AUTO-BOOT ON would make SHIFT/BREAK behave like BREAK and BREAK behave like
SHIFT/BREAK. This is the same as *CONFIGURE Boot on the Master series


DRIVE-CONTROL

This allows adjustments to be made to the step rate applied to the disc
drive(s) connected to the computer. Normally 80 track drives will use the
fastest rates, while 40 track drives will use a slower step rate. This is
the same as *CONFIGURE FDrive on the Master series.

8271   1770   1772

 4ms    6ms    6ms
 6ms   12ms   12ms
 6ms   20ms    2ms
24ms   30ms    3ms

The first column of step rates corresponds to computers fitted with the
Intel 8271 FDC (BBC). The second column corresponds to computers fitted with
the WD1770 FDC(B+, some Master series). The third column corresponds to
computers fitted with the WD1772 FDC (some Master series).


KEYBOARD STATUS

This allows adjustments to be made to options relating to the keyboard.

AUTO-REPEAT RATE

This is the time delay in seconds between each key repeat after holding down
a key. This is the same as *CONFIGURE Repeat on a Master series.

0.02
0.04
0.08
0.16
0.32

AUTO-REPEAT DELAY

This is the time delay in seconds before the key starts to auto-repeat,
after holding down a key. This is the same as *CONFIGURE Delay on a Master
series.

AUTO-REPEAT OFF
0.25
0.50
0.75
1.00

AUTO-REPEAT OFF
After selecting this, a key will fail to repeat if held down continuously.

CAPS/SHIFT LOCK

This allows the CAPS LOCK and SHIFT CAPS LOCK features to be turned 'on' or
'off'. This is the same as *CONFIGURE CAPS and *CONFIGURE ShCAPS.

CAPS LOCK ON
CAPS LOCK OFF
SHIFT CAPS LOCK ON
SHIFT CAPS LOCK OFF

CAPS LOCK ON allows upper case characters to be typed without holding down
the SHIFT key. CAPS LOCK OFF allows the lower case letters to be typed.
SHIFT CAPS LOCK ON allows lower case characters to be typed when the shift
key is held down and CAPS LOCK is 'on'. CAPS LOCK OFF allows the CAPS LOCK
and shift key to operate normally.
 
RS423 OPTIONS

This allows options relating to the serial port to be changed.

TRANSMIT

This allows the transmit baud rate to be changed. This is the same as
*CONFIGURE Baud on the Master series.

   75 BAUD
  150 BAUD
  300 BAUD
 1200 BAUD
 2400 BAUD
 4800 BAUD
 9600 BAUD
19200 BAUD

RECEIVE

This allows the receive baud rate to be changed.

   75 BAUD
  150 BAUD
  300 BAUD
 1200 BAUD
 2400 BAUD
 4800 BAUD
 9600 BAUD
19200 BAUD

DATA FORMAT

This allows the format of the data transmitted or received via the R423
serial port to be changed. The data format consists of 7 or 8 data bits,
whether even or odd parity is used and 1 or 2 stop bits. This is the same as
*CONFIGURE Data on the Master series.

7 DATA + EVEN + 2 BITS
7 DATA + ODD  + 2 BITS
7 DATA + EVEN + 1 BIT
7 DATA + ODD  + 1 BIT
8 DATA + NONE + 2 BITS
8 DATA + NONE + 1 BIT
8 DATA + EVEN + 1 BIT
8 DATA + ODD  + 1 BIT

DATA means data bits, EVEN means even parity, ODD means odd parity and
BIT(s) means the number of stop bit(s)

PRINTER OPTIONS

These options control where the printer output is to be directed and whether
or not 'line feed' is included with 'carriage return' at the end of each
line. This is the same as *CONFIGURE Print and *CONFIGURE Ignore/No Ignore

SINK
PARALLEL
SERIAL
USER PRINTER DRIVER
NETWORK PRINTER
IGNORE LINE FEEDS
SEND LINE FEEDS

SINK Allows printer output to be ignored, so that a program that produced
printer output would not hang up if the printer was not switched on.
PARALLEL Directs the printer output to the parallel printer port andSERIAL
directs output to the serial port. USER PRINTER DRIVER directs output to the
user's printer driver and NETWORK PRINTER directs output to the 'Econet'
network. IGNORE LINE FEEDS sends just a 'carriage return' character at the
end of each line for printers which interpret 'carriage return' as a
'carriage return' plus a 'line feed'. SEND LINE FEEDS sends 'carriage
retuen' plus a 'line feed' at the end of each line for printers which
interpret 'carriage return' as just a 'carriage return'.


SOUND

This allows the sound that comes from the speaker when the bell is rung to
be at full or half volume. This is the same as *CONFIGURE Quiet/Loud. This
option is not available on the Electron.

SOFT
LOUD

SOFT produces a bell at half volume and LOUD a full volume bell.


SCROLL

This allows the scroll protect feature to be turned 'on' or 'off'. This
feature allows a character to be  placed in the last character position on
the bottom line of the screen without scrolling the display up one line and
deleting the top line. This option is only available on the Master series
and is the same as *CONFIGURE Scroll/NoScroll.

PROTECT OFF
PROTECT ON

PROTECT OFF will scroll the screen up one line if a character is placed in
the last position on the bottom line of the screen PROTECT ON will prevent
scrolling in these circumstances. 
ADFS OPTIONS

These options are used under ADFS to determine if the default drive is a
'Winchester' or a 'Floppy' and whether a start-up sequence is required when
ADFS is initialized with BREAK or CTRL/BREAK. The options are only available
on a 'Master' as *CONFIGURE Hard/Floppy and *CONFIGURE Dir/NoDir.

WINCHESTER DRIVE
FLOPPY DRIVE
AUTO START-UP ON
AUTO START-UP OFF

WINCHESTER DRIVE makes the default drive a Winchester drive if both types
are present. FLOPPY DRIVE makes the Floppy the default drive if both types
are present. AUTO START-UP ON initializes a 'start-up sequence' whenever
ADFS is entered after BREAK or CTRL/BREAK. AUTO START-UP OFFdoes not perform
a 'start-up sequence'.


LANGUAGE

This allows the default language to be changed. The languages in this window
will depend upon the language ROMs which are present in the machine (and
turned on). This option is only available on a Master and is the same as
*CONFIGRE Lang.

A typical display might show

Advanced control Panel
VIEWSHEET
Edit
VIEW
TERMINAL


FILING SYSTEM

This allows the default filing system to be changed.
The Filing system names appearing in the window will depend upon the ROMS
present in the machine (and turned on). This option is only available on a
Master and is the same as *CONFIGURE File.

A typical display on a MASTER might show

DFS
Acorn ADFS
Cassette

CO-PROCESSOR

This option relates only to the use of a CO-PROCESSOR or 2nd Processor. This
option is only available on a Master and is the same as *CONFIGURE
Tube/NoTUBE.

PROCESSOR OFF
PROCESSOR ON
INTERNAL PROCESSOR
EXTERNAL PROCESSOR

PROCESSOR OFF turns off the 2nd Processor or CO-Processor if either is
fitted. PROCESSOR ON turns on the use of either, if either is fitted.
INTERNAL PROCESSOR selects the Co-processor (mounted inside the computer)
when turned on, if both Internal and external processors are fitted.
EXTERNAL PROCESSOR selects the 2nd processor (connected externally to the
2nd Processor port) when turned on, if both internal and external processors
are fitted.


ECONET OPTIONS

These options relate to ECONET and are only available on the Master series.
The ECONET options do not form part of the LOAD or SAVE configure file
because they are normally set up only once and are rarely changed unlike the
other configure options.

STATION NUMBER

This identifies the station number the computer has been given on the
Network. The station number can only be changed by moving the ECONET station
links on the ECONET module fitted inside the computer.

FILE SERVER

This allows the Network file server to be specified.

A typical network file server might show:-

000.255

The number on the left is the network number, specified if more than one is
in use, and the number on the right is the file server station number. The
numbers can be changed using the cursor keys with SHIFT.
SHIFT left & right cursor keys move the cursor left or right and SHIFT up &
down cursor keys change the number under the cursor.


PRINTER SERVER

This allows the network printer server to be specified.

A typical network printer server might show:-

000.254

The number on the left is the network number specified if more than one
network is in use, and the number on the right is the printer server station
number. SHIFT left & right cursor keys move the cursor left & right. SHIFT
up & down cursor keys change the number under the cursor.


LOAD CONFIGURE

This allows all the configuration options to be re-set with a previously
saved configure file  on Disc/Tape. A prompt at the bottom of the screen
will request the filename. Enter this and press RETURN. The file will be
loaded and the configure options updated immediately.


SAVE CONFIGURATION

This allows the current configuration options to be saved in a file on
Disc/Tape so that they could be loaded back with LOAD CONFIGURE, without
having to change each option one at a time. A prompt at the bottom of the
screen will request a name to be given to the configure file. The current
configurations will be saved under this name.

Possible reasons for saving a configuration file:-

1.On non-Master series computers without CMOS RAM, the configuration options
are lost each time the computer is turned off. Loading a configure file is
much quicker than changing the options one at a time.

2.If the computer is used by more than one person then each person could
have their own particular configuration stored in a file

3. On the Master series computers CTRL/R/BREAK initializes the
configurations options to zero. Loading a previously saved configre file
would restore them to their original values.


CLOCK

The clock function is only available on the Master series.
On any other computer the message,

Not Supported

will appear. Just press the space bar to continue.

The clock window shows the time and date in the format:-

Day of week, Day of Month, Month, Year, hours, minutes, seconds.

eg.

Thur,09 Apr 1987.13:06:35

The clock is continually updated while the clock window is open. The time
and date can be changed simply by using the shift left & right cursor keys
to move the cursor over the particular field to be updated and using the
shift up & down cursor keys to alter the field under the cursor.


ALARM

The alarm function is only available on the Master series.
On any other computer the message:-

Not Supported

will appear at the SET ALARM and SET FUNCTION options. Just press the space
bar to continue.

SET ALARM

This allows the time at which the alarm goes off to be set. The format of
the alarm is the same as that for the Real Time Clock viz:-

Day of week, Day of Month, Month, Year, Hours, minutes, seconds.

eg.

Thu,09 Apr 1987.13:06:35

The time and date of the alarm can be changed simply by using the Shift left
& right cursor keys to move the cursor over the particular field to be
updated and using the shift up & down cursor keys to alter the field under
the cursor.
 


SET FUNCTION

This determines what the alarm will do at the specified time.

NO ALARM
RING BELL
* COMMAND

NO ALARM means that nothing will happen.

RING BELL Rings the bell at the specified time.

* COMMAND allows an MOS command to be issued at the specified time. A prompt
at the bottom of the screen will request the command. Enter *<command>  and
press RETURN. A maximum of 10 letters may be typed in. This option would be
a useful start to an EXEC file eg.*EXEC !BOOT

NOTE

In order to make the Alarm operate correctly, it is important to know how it
works. When the specified time is reached the Alarm inserts the BELL
character or the *COMMAND characters (whichever is selected by SET FUNCTION)
into the keyboard buffer. This is like someone typing the characters at the
time. This will work providing the computer is accepting input from the
keyboard at the specified time and in the case of a * COMMAND, recognizes
MOS commands and providing the characters are not mixed up with another
command, which the user is typing in at the same time.

The ALARM will function from any window in ACP and any other language at
certain times, eg. in BASIC while the prompt

>

is displayed, or in View or Viewsheet at the command line,

=>

In short, if the command would work by typing it in at the keyboard at the
specified time, then the Alarm will work.

CALCULATOR

The keys have the following meanings

0,1,2,3,4,5,6,7,8,9,A,B,C,D,E,F -numbers (0-15)
^                               -Clear Display
@                               -Change number Base
*                               -Multiply
/                               -Divide
-                               -Subtract
+                               -Add
=                               -Result

 6. FILE

This window shows a menu of commands which relate to the current Filing
System. Certain options in this window may not be relevant in some filing
systems, eg DRIVE in the NET system.

DIRECTORY
DRIVE
FILING SYSTEM
TITLE
!BOOT OPTION

DIRECTORY

This option produces a directory of files in the current drive and
directory. From this window a file can easily be selected and run with one
key press. View/Viewsheet files can be loaded and files can be deleted or
DUMPed/TYPEd to the screen.

An example of a directory window is shown below:-


Filing System ADFS         Title: ACP Control Panel        Option: OFF

Directory: 0.$             Library: O.LIBRARY              Files: 004


    !BOOT             CONFIG                PANEL          PANEL2


File=!BOOT    WR  LOAD=&00000000  EXEC=&FFFFFFFF  LENGTH=&0000000A

The top line of the directory shows the name of the current filing system,
the title of the directory and the auto start-up option (as set by *OPT4).


The line below shows the name and drive of the  current directory and
library and number of files in the directory (including directories).

Below this are listed the filenames in the order they are read from the
directory. If the entry is a directory, the directory name appears with a
'D' after it.

The bottom line shows more information about the file under the cursor. It
shows the name of the file and its access attributes, which have the
following meanings

W=Write only
R=Read only
L=locked
E=execute only (file can only be *RUN)
this is followed by the file's load address, execution address and length in
Hexadecimal.

The file cursor can be moved around using the cursor keys. If RETURN is
pressed the file under the cursor will be loaded into memory and run. If the
entry under the cursor is a directory then the current directory will be
changed to this directory, and the files in it will appear on the screen. A
file can be loaded into memory without running it by pressing 'L'. If the
file is BASIC then the file will be loaded and the current language changed
to BASIC. ACP identifies a file type and consequently the action taken on
it, by the execution address. The file types, execution addresses, and
action taken are shown below.

File type                 Execution Address               Action

EXEC                      &FFFFFFFF or &00000000          *EXEC
BASIC                     &00008000 to &FFFFFFFE          CHAIN / LOAD
Machine Code              Any other address               *RUN / *LOAD

Other keys have the special meanings shown below:-

CTRL/K      -Remove a file (same as *DELETE)
CTRL/D      -Dump a file   (same as *DUMP)
CTRL/T      -Type a file   (same as *TYPE)
CTRL/W      -Exit to View and load a View file
CTRL/S      -Exit to Viewsheet and load a Viewsheet file


DRIVE

This displays the current drive and allows it to be changed. Simply move the
cursor to the new drive number and press RETURN

DRIVE 0
DRIVE 1
DRIVE 2
DRIVE 3


FILING SYSTEM

This displays the current filing system and allows it to be changed. Only
filing systems fitted to the computer and turned on can be selected.

NO SYSTEM
TAPE 1200
TAPE 300
ROM
DISC
ECONET
TELETEXT
IEEE
ADFS
  
TITLE


This allows the disc title to be changed. A prompt at the bottom of the
screen requests the new title. Enter the title and press RETURN.


!BOOT OPTION


This allows the start-up option to be re-specified. This is the same as
*OPT4 The options available are:-

OFF
LOAD
RUN
EXEC




 
 7. PANEL

This window shows a menu whose commands relate to the user's own control
panels. The ACP ROM has one control panel called the Advanced Control Panel.
This panel has four windows:-

LANGUAGE, MOS, FILE and PANEL

Other control panels can be built by the user having more or less windows to
do different things. The PANEL window can be used to build new panels, save
them to Disc/Tape, load old ones from Disc/Tape, list the titles of the
control panels in memory and delete old titles. The PANEL window options
are:-

LIST
LOAD
SAVE
NEW
BUILD

LIST

This opens a window listing the titles of the control panels in memory. If
there no panels in memory, the message,

No panels

is displayed. A new control panel can be selected by moving the cursor over
the title of the panel and pressing RETURN. This will immediately display
the new panel. The title of the new panel will appear at the top of the
screen and the window titles and their windows below it.

To return to Advanced Control Panel press CTRL/C from any window.

LOAD

This allows a previously saved control panel file to be loaded from
Disc/Tape. A prompt at the bottom of the screen will request the name of the
'saved' file. Enter <filename><RETURN>. The new control panel will be loaded
after any other panels in memory and the title of the panel added to the
list of panel titles. If the control panel file contains more than one
panel, then all the panel names will be added to the list of titles.

This allows a series of control panels to be built up in memory. The number
of panels stored in memory at one time is restricted by the amount of user
memory and can not exceed 20.

A previously saved control panel can be loaded and displayed when entering
the ACP language. This is done by adding the name of the control panel file
to *ACP eg.

*ACP panel

This would enter ACP from the language and load the control panel file
'panel'.


SAVE

This allows a control panel to be saved on Disc/Tape. A prompt at the bottom
of the screen will request the name of the file in which to save the panel.
Enter <filename><RETURN> and if there are no panels in memory the message,

No panels

is displayed. If there is more than one panel in memory then all the control
panels will be saved in the one file.


NEW

This allows the control panels in memory to be deleted, so that any new
panel will have all the available memory. If this option is not used then
any new panel built or loaded from a file will be added to the end of the
control panels in memory.


BUILD

This allows a new control panel to be created.

The titles of the current panel will be removed and prompts at the bottom of
the screen will request information about the new panel:-

Panel Title ?
 
This is the main title of the panel which appears at the top of the screen
when a new screen is loaded and it is also to identify it from other panels
in the LIST option. Enter <panel name><RETURN>. The panel name will appear
at the top of the screen. Next a prompt requests:-

Window Title ?

These are the titles that appear above the pull-down windows. The main
control panel has four LANGUAGE, MOS, FILE and PANEL. Enter the title of
each window, pressing RETURN after each. The titles will appear along the
top of the screen. After the last title has been entered press RETURN on its
own. This is followed by the prompt:-

OK (Y/N) ? Y

If you are satisfied with these titles just press RETURN. If not press 'N'
and enter them all again.

The first window title will now appear highlighted and a new window will
appear under it,

WINDOW
*COMMAND
*EXEC FILE
*RUN/CHAIN FILE
*LOAD/LOAD FILE
CALL M/C
TEXT
LANGUAGE
ROMS
CONFIGURE
CLOCK
ALARM
CALCULATOR
DIRECTORY

This window lists the window definitions from which can be chosen the
definition of the highlighted window title. Move the over the selected
definition, using the up & down cursor keys and press RETURN. An explanation
of each definition is given below.


WINDOW

This allows a new window to be created from the window title. A prompt
requests the items of the window.

Window option ? (or RETURN)

Enter the option names one at a time, pressing RETURN after each one. Up to
20 names are allowed. The window, and the options in it will appear below
the highlighted window title. After the last option has been entered press
RETURN. This is followed by the prompt:-

OK (Y/N) ? Y

If you are satisfied with the window, press RETURN; if not press 'N' and
re-enter them.

The WINDOW option can be used extensively to create a large control panel
with numerous windows, in a hierachical manner, rather like the directory
structure of ADFS where files of the same type are grouped together in the
same directory, and all the directories branch out from the 'root', forming
a tree structure. Similarly in ACP windows can be created with options of
the same type, and other windows can branch out of them, forming a 'tree'
structure. In practice this works well because programs and their files can
be divided up into a hierachical structure. For example,

WINDOW ------- WINDOW ------- WINDOW ------- WINDOW ------- PROGRAM
TITLE


               ADVENTURE
               ARCADE         DOMINOES       EASY
GAMES -------- BOARD -------- CHESS -------  HARD --------- *CHESS
               QUIZ           DRAUGHTS       VERY HARD
               EDUCATIONAL

               DATABASE       EXPENSES       INVOICE1
BUSINESS ----- W/PROCESSOR -- INVOICES ----- INVOICE2 ----- *TY.IN1
               SPREAD SHEET   PERSONAL       INVOICE3


* COMMAND

This allows a * command to be issued. A prompt at the bottom of the screen
requests the * command. Enter <command><RETURN>.


*EXEC file

This allows an EXEC file to be run. A prompt at the bottom of the screen
requests the name of the EXEC file. Enter <filename><RETURN>.

*RUN/CHAIN file

This allows a machine code or BASIC program to be run. A prompt at the
bottom of the screen requests the name of the program. Enter
<filename><RETURN>

*LOAD/LOAD

This allows a machine code or BASIC program to be loaded into memory. A
prompt at the bottom of the screen requests the name of the program. Enter
<filename><RETURN>


CALL M/C

This allows a machine code program in memory to be RUN. A prompt at the
bottom of the screen requests the memory address of the program:-

CALL ADDRESS ?

Enter the address of the program in Hexadecimal


TEXT

This allows a window of text to be displayed on the screen, such as a Help
window or comment window. A prompt at the bottom of the screen requests the
text.:-

?

Enter the text one line at a time, pressing RETURN after each line. Each
line of text can be up to 74 characters long, and up to 20 lines are
allowed. The text will be added to the text window below the window title as
each line is entered. After entering the last line, press RETURN on its own.


LANGUAGE

This allows the LANGUAGE window to be opened (see page 5 )

ROMS

This allows the ROMS window to be opened (see page 6)

CONFIGURE

This allows the CONFIGURE window to be opened (see page 7)

CLOCK

This allows the CLOCK window to be opened (see page 16)

ALARM

This allows the ALARM window to be opened (see page 16)

CALCULATOR

This allows the CALCULATOR window to be opened (see page 17)

DIRECTORY

This allows the DIRECTORY window to be opened (see page 18)



Build Control Panel Example 

The following example shows how to use the BUILD option to create a simple
control panel with 4 windows:-

SIDEWAYS ROMS, LANGUAGE ROMS, CALCULATOR and CONFIGURATION

Select the build option in the PANEL window and press RETURN

Respond to the prompts as shown below:-

Panel Title ? Control Panel Example  <RETURN>

Window Title (or RETURN) ? SIDEWAYS ROMS <RETURN>

Window Title (or RETURN) ? LANGUAGE ROMS <RETURN>

Window Title (or RETURN) ? CALCULATOR <RETURN>

Window Title (or RETURN) ? CONFIGURATION <RETURN>

Window Title (or RETURN) ? <RETURN>

Select ROMS from window and press RETURN

Select LANGUAGE option from window and press RETURN

Select CALCULATOR option from window and press RETURN

Select CONFIGURATION option from window and press RETURN

The panel has now been created and is stored in memory. To see that it is
there select the LIST option from The PANEL window which will show the panel
title.

To see the control panel press RETURN. the window titles entered above will
be opened beneath the window title, SIDEWAYS ROMS.

To return to Advanced Control Panel press CTRL/C

 8.TECHNICAL INFORMATION

CONTROL PANEL FILE FORMAT

&00 control panel identifier (&70)
&01 panel length low-byte  (starting from &05)
&02 panel length high-byte (starting from &05)
&03 panel CRC low-byte     (starting from &05)
&04 panel CRC high-byte    (starting from &05)
&05 panel title(last character has top bit set)
    window titles start byte (&00)

    first window title (last character has top bit set)
    window data pointer low-byte   (off-set from &05)
    window data pointer high-byte  (off-set from &05)

    second window title (last character has top bit set)
    window data pointer low-byte   (off-set from &05)
    window data pointer high-byte  (off-set from &05)
    etc., until last window title
    window end byte (&00)

    window data
      &00 = window
            first option name (last character has top bit set)
            window data pointer low-byte  (off-set from &05)
            window data pointer high-byte (off-set from &05)

            second option name (last character has top bit set)
            window data pointer low-byte  (off-set from &05)
            window data pointer high-byte(off-set from &05)
            etc., until last option name
            window end byte &00

      &01 = *COMMAND
            MOS command string (last character has top bit set)

      &02 = *EXEC
            filename (last character has top bit set)

      &03 = *RUN/CHAIN
            filename (last character has top bit set)

      &04 = *LOAD/LOAD
            filename (last character has top bit set)
 
      &05 = call machine code
            low-byte address
            high-byte address

      &06 = text window
            window start byte &00
            first line of text (last character has top bit set) 
            action address low-byte (unused)
 
            action address high-byte (unused)
            second line of text (last character has top bit set)
            action address low-byte (unused)
            action address high-byte (unused)
            etc., until last line of text
            window end byte &00

      &07 = Advanced Control Panel window
            window address low-byte
            window address high-byte
            (window address will point to JMP instruction &4C)
              ROMS       - &8038
              CLOCK      - &803B
              ALARM      - &803E
              CALCULATOR - &8041
              DIRECTORY  - &8044

CONFIGURE FILE FORMAT

&00    configure identifier (&63)
&01    configure CRC low-byte  (starting from &03)
&02    configure CRC high-byte (starting from &03)
       configure options
&03    Interlace
&04    Vertical alignment
&05    Background colour
&06    Foreground colour
&07    Scroll protect
&08    Auto start-up option
&09    Default language
&0A    Default filing system
&0B    RS423 transmit baud rate
&0C    RS423 receive baud rate
&0D    RS423 data format
&0E    Bell
&0F    Drive option
&10    Auto-repeat rate
&11    Auto-repeat delay
&12    Printer type
&13    Caps lock status
&14    Shadow status
&15    ADFS drive type
&16    Processor on/off status
&17    ROMS 0-7 insert/unplug status
&18    Ignore/send line feeds
&19    Shift caps lock status
&1A    Mode
&1B    ADFS auto start-up
&1C    Internal/external processor status
&1D    ROMS 8-15 insert/unplug status
&1E    unused
&1F    unused