Vidicode Argus Basic Programmers Reference Manual

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
228
  
SEQUENCE    select escape sequence 
The escape sequence is part of the Hayes compatible aspect of modem operation. 
 
It is explained in more detail in the Modem User Guide, and also with the sequence event handler ON SEQUENCE. 
 
The possibility of an escape sequence occurring can be enabled with SEQUENCE ON; disabled with SEQUENCE OFF. 
 
The escape sequence character can be set with SEQUENCE [num]. This is the same as setting S-register 2 
(SREG2=[num]). 
Examples: 
SEQUENCE ON
SEQUENCE 37
Syntax: 
SEQUENCE ON/OFF
SEQUENCE [num]
See also: 
ON SEQUENCE, ESCAPE
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
229
  
SGN    get sign of number 
SGN is used to determine the sign of a number and returns three possible values, depending on whether the test value is 
negative, zero or positive. 
 
The following apply: 
SGN 56
returns 1   
SGN 0
returns 0   
SGN -45
returns -1   
Examples: 
Dif=SGN(X1-X2)
X=SGN(y)
Syntax: 
[num-var] = SGN [integer]
See also: 
ABS 
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
230
  
SOUND  (MODEM)  make a sound 
SOUND has two optional parameters frequency and duration, set in hundredths of a second.  If the parameters are left out, 
then 2000 Hz and 250 ms are taken by default. 
 
The command SOUND, without MODEM behind, will produce a sound on the speaker only, by toggling the speaker-mute-bit 
(see VOICE) with the desired frequency. 
 
The command SOUND MODEM will produce a sound through the modem-chip and can therefor be hearded on the 
telephone line.  The modem-chip must not be in sleep-mode (see RESET MODEM 2). 
After SOUND MODEM, the modem-chip is always put back in voice-mode, except if a duration of zero (0 ms) is defined, in 
which case the modem-chip is left in sound-mode and immediatly returns. 
  
Examples: 
SOUND 2000,25
SOUND MODEM 1250,100
Syntax: 
SOUND (MODEM) ([num]) (,[num])
See also: 
RESET MODEM 2 
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
231
  
SPC$    repeat spaces 
The SPC$ string function produces a string containing the specified number of ASCII Space characters. 
Examples: 
Title$=Name=SPC$(10)+Age+SPC$(5)+Sex
PRINT Port number+SPC$(20)+VAL$(port)
Syntax: 
[string-var]=SPC$[integer 0..255]
See also: 
RPT$ 
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
232
  
SPEAKER ON/OFF    speaker control 
The SPEAKER command is used to enable or disable the modems internal loudspeaker.  Same as AT M2/0. 
 
If a headset is connected to the Argus, the SPEAKER OFF command disables the headset as well and is therefor not 
suitable to control the speaker while the headset is active.  In that case the speaker-mute-bit must be set or cleared with 
POKE (see VOICE). 
Examples: 
SPEAKER ON
SPEAKER OFF
Syntax: 
SPEAKER ON|OFF
See also: 
VOICE, VOLUME 
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
233
  
SPEED [number]    line speed select 
This command is used to set S-register 51 within the programming environment.  Same as AT S51=x or
SREG51=[num].  SPEED is used when connecting as a modem or fax. 
After connection, S-register 50  (bits0-5) is set to the connected speed as listed below: 
 
 1 = 1200 (V22)  38 = 28800 (Vfast) 
 2 = 2400 (V22bis)  39 = 26400 (Vfast) 
 3 = 300  (V21)  40 = 24000 (Vfast) 
 4 = 4800 (V32)  41 = 21600 (Vfast) 
 5 = 4800 (V27ter) Fax  42 = 19200 (Vfast) 
 6 = 2400 (V27ter) Fax  43 = 16800 (Vfast) 
 7 = 7200 (V29) Fax  44 = 14400 (Vfast) 
 8 = 2400 (V26bis) Synchronous  45 = Vfast all speeds 
 9 = 9600 (V32 TCM)  46 = 4800 (Bell 208) 
10 = 9600 (V32 U)  47 = 1200 (Bell 212A) 
11 = 9600 (V29) Fax  48 = 300 (Bell 103) 
12 = 12000 (V32bis)  49 = 33600 (V34plus) 
13 = 12000 (V33) Half Duplex  50 = 31200 (V34plus) 
14 = 14400 (V32bis)  51 = 28800 (V34) 
15 = 14400 (V33) Half Duplex  52 = 26400 (V34) 
16 = 600   (V22)  53 = 24000 (V34) 
17 = 1200/75 (V23 Answ)  54 = 21600 (V34) 
18 = 4800 (V29) Half Duplex  55 = 19200 (V34) 
19 = 7200 (V32bis)  56 = 16800 (V34) 
20 = V8 Auto-mode (all speeds)  57 = 14400 (V34) 
21 = V32bis Auto-mode  58 = 12000 (V34) 
22 = V8 High speed only  59 = 9600 (V34) 
23 = 75/1200 (V23 Orig)  60 = 7200 (V34) 
25 = 9600 (V33) Half Duplex  61 = 4800 (V34) 
26 = 4800 (V33) Half Duplex  62 = 2400 (V34) 
27 = 300 (V21 channel 2) Fax  63 = V34(plus) all speeds 
28 = 14400 (V17) Fax   
29 = 12000 (V17) Fax   
30 = 9600 (V17) Fax   
31 = 7200 (V17) Fax   
Example: 
SPEED 10
SPEED Line
Syntax: 
SPEED [number]
See also: 
FAX, ON CONNECT, SCAN 
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
234
  
SPEED BUFFER ON/OFF    speed buffer on/off 
The command is another way to set S-register 52 within the programming environment.  Same as AT S52=1/0 or 
SREG52=1/0. 
 
When speed buffering is enabled (default), there is no relationship between the modem-speed on the line and the speed at 
the serial ports of the modem.  The ports will only change their speed when AT is entered at a new baud rate or after using 
the BAUD command. 
 
When speed buffering is disabled, the speed at the port will automatically change to the speed on the line after the 
CONNECT message has been sent. 
Example: 
SPEED BUFFER ON
Syntax: 
SPEED BUFFER ON|OFF
See also: 
SCAN 
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
235
  
SREG    set/read S-registers 
SREG is used as another way to set or read the 80 available S-registers that the modem keeps in memory.  These registers 
are holding various types of parameters which are used by the modem operating system for all sorts of purposes.  Most of 
them are mentioned throughout this manual.  For further information, see the Modem User Guide. 
 
This way of manipulating the S-registers is very useful within the programming environment, because it then enables you to 
treat these registers as system variables. 
 
The command RESET ALL SREG will set all the registers back to factory settings. 
Examples: 
SREG0=1
PRINT SREG3
IF RING AND NOT SREG0 THEN SOUND 2000,200
Syntax: 
SREG[integer0...79] = [num]
[num-var] = SREG
See also: 
AT [string], RESET ALL SREG 
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
236
  
STOP    halt program execution 
STOP terminates program execution, and is most often used during program debugging to temporarily halt a program so 
that variables can be examined. 
 
Execution may be restarted by entering a GOTO command for the line following the line containing the STOP command. 
 
A special command to control the STOP button is: 
STOP ON/OFF
With STOP ON, the button will function normally.  With STOP OFF, the button will only work when the S/A-button is in the 
in-position.  This prevents that BASIC programs are stopped if the STOP button is pressed by accident. 
Examples: 
IF x>500 THEN STOP
ON ERROR STOP
STOP OFF
Syntax: 
STOP
STOP ON/OFF
See also: 
RUN
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
237
  
TIME$    read or set time 
TIME$ is used to read the current time as a string or to set the clock. 
 
The string has the format hh:mm:ss (hour, minutes, seconds) for input as well as for output. 
Examples: 
TIME$ = 14:20:00
Tstamp$ = TIME$
Syntax: 
TIME$ = [string]
[string-var] = TIME$
See also: 
DATE$