PsiFS: SWI Calls

PsiFS_Set

PsiFS_Set
(SWI &520C2)
Modify a PsiFS option

On entry:R0 =option to modify
If the option specified by R0 requires a numeric value
R1 =value to set
If the option specified by R0 requires a string value
R1 =pointer to control-character terminated string

On exit:Registers preserved

Interrupts:Interrupt status is undefined
Fast interrupts are enabled

Processor mode:Processor is in SVC mode

Re-entrancy:SWI is not re-entrant

Use: This call sets the value of a PsiFS option. An error may be returned if an attempt is made to modify an option that is meaningless for the current mode of operation.

The options that may be set are:
R0TypeOption
&100stringname of the serial block driver
&101numericserial block driver port number
&102numericserial block driver baud rate
&103stringoptional extra serial block driver options
&104numericautomatic baud rate identification mode
&110numericclock synchronization mode
&120numericremote link idle disconnect time
&121numericprinter mirror idle disconnect time
&122numericidle disconnect external power mode
&128numericidle background operations mode


Related SWIs:PsiFS_Get, PsiFS_Mode

Related vectors:None

PsiFS_Set &100
(SWI &520C2)
Set the serial block driver name

On entry:R0 =&100
R1 =pointer to control-character terminated serial block driver name string

On exit:Registers preserved

Use: This call sets the name of the configured serial block driver.

PsiFS_Set &101
(SWI &520C2)
Set the serial block driver port number

On entry:R0 =&101

On exit:R1 =port number (0 for the first)

On exit:Registers preserved

Use: This call sets the configured serial block driver port number.

PsiFS_Set &102
(SWI &520C2)
Set the serial block driver baud rate

On entry:R0 =&102

On exit:R1 =baud rate

On exit:Registers preserved

Use: This call sets the configured serial block driver baud rate. If the requested baud rate is not available then a valid alternative is selected.

PsiFS_Set &103
(SWI &520C2)
Set the serial block driver options

On entry:R0 =&103
R1 =pointer to control-character terminated serial block driver options string

On exit:Registers preserved

Use: This call sets the optional parameter string of the configured serial block driver.

PsiFS_Set &104
(SWI &520C2)
Set the automatic baud rate identification mode

On entry:R0 =&104
R1 =automatic baud rate identification (0 disables)

On exit:Registers preserved

Use: This call enables or disables automatic baud rate identification. Only the remote link is affected; the printer mirror always uses the configured baud rate.

PsiFS_Set &110
(SWI &520C2)
Set the clock synchronization mode

On entry:R0 =&110
R1 =clock synchronization mode (0 disables)

On exit:Registers preserved

Use: This call enables or disables synchronization of clocks on connection of the remote link. This only affects EPOC devices; it is not possible to synchronize the clock of SIBO devices.

PsiFS_Set &120
(SWI &520C2)
Set the remote link idle disconnect time

On entry:R0 =&120
R1 =idle disconnect time in seconds (0 disables)

On exit:Registers preserved

Use: This call enables or disables automatic disconnection of the remote link after a period of activity.

PsiFS_Set &121
(SWI &520C2)
Set the printer mirror idle disconnect time

On entry:R0 =&121
R1 =idle disconnect time in seconds (0 disables)

On exit:Registers preserved

Use: This call enables or disables automatic disconnection of the printer mirror after a period of activity.

PsiFS_Set &122
(SWI &520C2)
Set the idle disconnect external power mode

On entry:R0 =&122
R1 =idle disconnect external power mode (0 disables)

On exit:Registers preserved

Use: This call enables or disables automatic disconnection after a period of inactivity if running on external power. This only affects EPOC devices; it is not possible to determine the status of external power for SIBO devices.

PsiFS_Set &128
(SWI &520C2)
Set the idle background operations mode

On entry:R0 =&128
R1 =idle background operations mode (0 disables)

On exit:Registers preserved

Use: This call enables or disables throttling back of background operations when idle.

[Contents] [Up] Copyright © Alexander Thoukydides, 1998, 1999, 2000, 2001, 2002