6809 Second Processor

A second processor for the BBC/Master containing a Motorola 6809.

The 6809 client MOS provides the basic system required to communicate with the host computer. The BBC MOS entry block is implemented by using the BA/BS signals to remap the hardware vectors to from &FFF0 to &FEF0.

MOS API Calls

Programs communicate with the kernal and MOS via an entry block at &FF80-&FFFF. Parameters are passed in the A, X and Y registers.

On entry, A, X, Y contain values to pass to system call
On exit,  A, X, Y contain returned data
          All addresses are big-endian, except where noted
          When an application starts it should call OS_INIT which
          returns MI if little-endian addresses are being used.

&FFF7 - OS_CLI

On entry:               On exit:
X=>command string       A=Return value

&FFF4 - OS_BYTE

On entry:               On exit
A=function              A=preserved
X=first parameter       X=returned word
Y=second parameter      Y=returned word DIV 256
                        Cy=returned carry flag

&FFF1 - OS_WORD

On entry:               On exit:
A=function              Control block updated
X=>control block        Y=returned line length for OSWORD 0
Text buffer address at X+0/1 with OSWORD 0 is big-endian

&FFEE - OS_WRCH

On entry:               On exit:
A=character             A=preserved

&FFEC - OS_WRCR

On entry:               On exit:
                        A=13

&FFE7 - OS_NEWL

On entry:               On exit:
                        A=13

&FFE3 - OS_ASCI

On entry:               On exit:
A=character             A=preserved

&FFE0 - OS_RDCH

On entry:               On exit:
                        A=character
                        Cy=carry flag

&FFDD - OS_FILE

On entry:               On exit:
A=function              A=result
X=>control block        X=preserved
Filename address at X+0/1 is big-endian
Control block addresses are big-endian unless indicated by OS_INIT

&FFDA - OS_ARGS

On entry:               On exit:
A=function              A=result
Y=handle                Y=preserved
X=>data                 X=preserved
                        data updated
The data word is big-endian unless indicated by OS_INIT

&FFD7 - OS_BPUT

On entry:               On exit:
A=byte                  A=preserved
Y=handle                Y=preserved

&FFD4 - OS_BGET

On entry:               On exit:
                        A=byte
Y=handle                Y=preserved
                        Cy=carry flag

&FFD1 - OS_GBPB

On entry:               On exit:
A=function              A=preserved
X=>control block        Cy=carry flag
Control block addresses are big-endian unless indicated by OS_INIT

&FFCE - OS_FIND

On entry:               On exit:
A=function              A=handle
X=>string or
Y=handle

&FFBF - OS_INIT Initialise error handler and other environment settings

                 On entry, A=0 to become the current program
                           A=$FF to just read the current settings
                 Returns X=>BRKV, Y=>ESCFLG, DP=>Direct Page, A,B=various
                         CC set from contents of A on return
                         A.b7=1: little-endian filing system calls (CC=MI)
                         A.b7=0: big-endian filing system calls (CC=PL)

                 This must be called by application code as part of its
                 startup, before writing anything to memory. Before making
                 this call, code does not known where BRKV and ESCFLG are,
                 as they can be anywhere in memory.

See also

• 6809 BBC BASIC

External links

• 6809 CoPro information at mdfs.net
• 6809 CoPro technical documentation
• Johan Heusevelt's 6809 CoPro

Jgharston 16:53, 6 November 2009 (UTC) Jgharston (talk) 23:41, 30 January 2016 (UTC) Jgharston (talk) 00:44, 10 February 2022 (CET)