Vidicode Argus Basic Programmers Reference Manual

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
158
  
OUTPUT    send data to port 
OUTPUT is identical in operation to the PRINT command, and is provided as an alternative to PRINT where program 
clarity may be improved. 
See also: 
PRINT
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
159
  
PARITY    read or set parity 
PARITY is used to read or set the type of parity checking used during the transmission and receipt of data via the serial 
ports.  This must be chosen to suit the parity of the system with which you are communicating, otherwise data will be garbled.  
On the serial ports, parity is usually determined automatically by use of the AT scan.  On the modem port however, no AT 
scan is possible, and you will have to set the parity as required by the remote user. 
 
There are four types of parity; known as EVEN, ODD, MARK and SPACE; with a fifth option being to omit the use of parity 
checking completely.  To select one of the options, the PARITY command is used as follows: 
 0 Disabled 
 1 Odd 
 2 Even 
The PARITY command can be followed by one or more port numbers.  If no port number is specified, the default output 
port as defined by OPORT will be assumed. 
 
Parity checking will be disabled on all ports when the STOP button is pressed. 
Examples: 
PARITY 2
PARITY#2,X
PARITY#1,#2,#3,0
PARITY#3 = PARITY#1
Syntax: 
PARITY ( #[port], ) (#...) [integer 0..2]
[num-var] = PARITY (#[port])
See also: 
BAUD, LENGTH, SBITS 
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
160
  
PBOT    program bottom 
This is an important system variable that contains the address of the start of a BASIC program. 
 
The default value for PBOT is &3000, but this can be changed so that more than one program can be stored in system RAM 
at once.  For example: 
PBOT=&4000
NEW
10 %Sub1
20 PRINT SUBROUTINE 1
30 RETURN
PBOT=&4300
NEW
10 %Sub2
20 PRINT SUBROUTINE 2
30 RETURN
PBOT=&3000
NEW
10 REM Main program
20 REM Press key 1-3 (ESCAPE to stop)
40%Waiting
50 ON GET-48 GOSUB %Sub1,%Sub2 ELSE %Waiting
60 PBOT=&3000 : GOTO %Waiting
80%Sub1
90 PBOT=&4000 : GOTO %Sub1
100%Sub2
110 PBOT=&4300 : GOTO %Sub2
Here, the various programs are used as subroutines which can be called by setting PBOT to the appropriate address. 
Examples: 
PBOT=&4000
PBOT=PBOT+&1000 
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
161
  
PRINT ~PBOT
Syntax: 
PBOT = [integer]
[num-var] = PBOT
See also: 
PTOP
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
162
  
PEEK    read byte from memory 
PEEK reads a single byte from the specified memory location into an 
integer variable. 
Examples: 
Byte=PEEK &4000
X=PEEK Address
X=PEEK(&2000+Ptr1)
PRINT PEEK &9000
Syntax: 
[num-var] = PEEK [integer]
See also: 
PEEK$, POKE, POKE$
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
163
  
PEEK$    read string from memory 
PEEK$ reads a series of bytes starting from the specified memory location up to the first Carriage Return character (ASCII 
13) into a string variable. 
Examples: 
code$=PEEK$ &2000
X$=PEEK$ Address
name$=PEEK$(&Base+Offset)
PRINT PEEK$ &9000
ON BUTTON1 AT PEEK$ BUTTON1
Syntax: 
[string-var] = PEEK$ [integer]
See also: 
PEEK, POKE, POKE$
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
164
  
PLAY [filename]    playback a recorded file 
This command is used to playback a recorded file.  Wildcards in the filename are allowed to playback a sequence of speech. 
 
Before entering the PLAY command, the following points are important to know: 
 
1. The modem must be in voice-mode. This is done with the VOICE command. 
 
2. A RAM buffer of at least 1024 bytes big must be difined with BUFFER. 
 
3. The format of the playback file must be set the same as it was when recording that file; the bits per sample in S-register 67 
must be set correctly if changed earlier (see VOICE). 
 
4. All microphone functions must be disabled, otherwise nothing is heared. 
 
5. The volume of the speaker and headset can be set with VOLUME 1/2/3.  The internal speaker can be turned on or off 
with SPEAKER ON/OFF. 
 
6. DTMF detection is active during playback, except if  bit7 in Sregister 67 is set.  After detecting a DTMF the playback is 
stopped (see ERN below). 
 
7. Detection of the busy-tone (hangup) will also stop playback, excep if bit7 in S-register 39 is cleared (default). 
 
8. If PLAY exits through an event-handler (ON ESCAPE, ON TIMEOUT, ON BUTTON, etc.) the PLAY OFF 
command must be executed! 
 
 
On exit the system variable ERN can have the following values: 
ERN = 0 OK
: Finished 
ERN = 6 Cancelled
: Busy-tone/hangup detected 
ERN = 35 -
:  DTMF # detected 
ERN = 42 -
:  DTMF * detected 
ERN = 48 -
:  DTMF 0 detected 
ERN = 49 -
:  DTMF 1 detected 
ERN = 50 -
:  DTMF 2 detected 
ERN = 51 -
:  DTMF 3 detected 
ERN = 52 -
:  DTMF 4 detected 
ERN = 53 -
:  DTMF 5 detected 
ERN = 54 -
:  DTMF 6 detected 
ERN = 55 -
:  DTMF 7 detected 
ERN = 56 -
:  DTMF 8 detected 
ERN = 57 -
:  DTMF 9 detected 
ERN = 64 -
:  DTMF A detected 
ERN = 65 -
:  DTMF B detected 
ERN = 66 -
:  DTMF C detected 
ERN = 67 -
:  DTMF D detected 
ERN = 73 Not found
:  Filename not found 
 
 
Example program using RECORD & PLAY: 
10 VOICE
20 RECORD TIMEOUT=15
30 PRINT Pick up your phone...; 
40 REPEAT UNTIL ILINE0
50 OLINE0 ON
60 WAIT 100
70 REPEAT 
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
165
  
80 PRINT Speak now...; 
90 RECORD TEST.VOI
100 REPORT ERN
110 PRINT Listen now...; 
120 PLAY TEST.VOI
130 IF ERN PRINT DTMF: ;ERN; ELSE REPORT ERN
140 UNTIL FALSE
 
Syntax: 
PLAY [FILENAME]
See also: 
PLAY ON/OFF, PLAY VOLUME, RECORD, RESET MODEM, VOICE
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
166
  
PLAY ON/OFF    turn play on/off 
The command PLAY ON is used during testing only.  It sets the play mode without sending a file.  Data can be written to 
the decoder through port 3 (PUT#3, PRINT#3, etc.). 
 
The command PLAY OFF is used to turn off the play mode.  This command must be issued when a playback is aborted by 
an event (TIMEOUT, ESCAPE, etc.). 
Syntax: 
PLAY ON|OFF
See also: 
RECORD, RESET MODEM, VOICE
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
167
  
PLAY VOLUME [num]    playback attenuation 
Only one playback parameter can be set. 
 
The default is: PLAY VOLUME 3. 
[num] = Playback Attentuation
This sets the speech signal level and is the same as setting S-register 59. Value 0 is the loudest  (not recommended) and 
value 15 is the most attenuated level. 
Syntax: 
PLAY VOLUME[num]
See also: 
RECORD, RESET MODEM, VOICE