Vidicode Argus Basic Programmers Reference Manual

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
188
  
Examples: 
RECEIVE MESSAGE
RECEIVE B$+.TXT,T
RECEIVE BINARY,X
RECEIVE PROG+VAL$(Nr)+.BIN,X
RECEIVE#3, Name$+.JAN
RECEIVE Page$,B
RECEIVE ROM TEXT,T
Syntax: 
RECEIVE ( #[port] , ) [filename] ( ,T)(,F)(,A)(,X)(,B)
RECEIVE ROM ...
See also: 
DIR, PROTOCOL, ROM, SEND
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
189
  
RECEIVE ALL    receive disk backup 
The command RECEIVE ALL is normally used to receive a RAM-disk backup.  It overwrites the complete contents of the 
RAM chip and only works if the file is created with SEND ALL. 
 
In a RAM-disk filing system this command differs from the command RECEIVE,C which expects a file created with 
SEND,C. 
 
In a Hard-disk filing system, this command is exactly the same as the command RECEIVE,C. 
 
The Xmodem-CRC protocol is used for this purpose; PROTOCOL 1 is set automatically. 
Example: 
RECEIVE ALL
Syntax: 
RECEIVE (ROM) ALL
See also: 
RECEIVE, ROM 
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
190
  
RECEIVE TIMEOUT = [int]    set Sreg66 timeout 
This command is used to set the timeout in S-register 66.  This is used with RECEIVE,F,N.  Note that time is set in 1/10 
seconds. 
Example: 
RECEIVE TIMEOUT = 50
This will set the receive timeout to 5 seconds. 
Syntax: 
RECEIVE TIMEOUT = [integer]
See also: 
RECEIVE 
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
191
  
RECORD [filename]    record a voice file 
The command RECORD [filename] is used to store an encoded voice. 
 
Before entering the RECORD 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 speech quality, bits per sample, must be set in S-register 67 (see VOICE). 
 
4. Microphone control, volume of speaker/headset and speaker on or off must be set right. 
 
5. DTMF detection is active during recoding, except if  bit6 in Sregister 67 is set.  DTMF’s are not detected, if recording is 
done off-line with a microphone.  After detecting a DTMF the recording is stopped (see ERN below).  The DTMF itself is 
stripped from the file, except if bit0 in S-register 66 is set (RECORD TIMEOUT has an odd value). 
 
6. Recording is also stopped after a certain time of silence.  This time can be set per 100ms with RECORD TIMEOUT or 
by setting S-register 66.  The system variable ERN will be 0 in this case.   Detecting silence can be adjusted with bits0+1 in 
S-register 69; 0=Most sensitive (default) and 3=Less sensitive. 
 
7. Detection of the busy-tone (hangup) will also stop the recording; ERN is set to 6 in that case.  Busy-tone detection can be 
disabled by setting S-register 39 to 0 (SREG39=0). 
 
8. An overall timeout can also stop the recording.  This timeout is set per second with the command ON TIMEOUT
 in front of RECORD.  The timeout event itself is disabled again, only the value from  is used.  ERN is set to 
7 after the timeout. 
 
9. Recording  is also stopped if a character from a serial port is received.  This feature must be enabled first by setting bit2 in 
S-register 28 (SREG28=SREG28 OR 4).  This is used when recording is done until control of a serial connected 
computer.  ERN will be 0 on exit. 
 
10. The programmer must take into account that a recorded file can be maximal 16Mbyte big.  If 4 bits per sample is used 
(3600 bytes per second), the recording can last about 4500 seconds.  If 2 bits per sample is used (1800 bytes per second), 
the recording can last about 9000 seconds. 
 
11. If RECORD exits through an event-handler (ON ESCAPE, ON BUTTON, etc.) the RECORD OFF command must 
be executed! 
 
 
On exit the system variable ERN can have the following values: 
ERN = 0 OK
:  Stored (silence timeout) 
ERN = 6 Cancelled
: Busy-tone/hangup detected 
ERN = 7 Failed
: Overall timeout 
ERN = 22 Out of memory
: Disk full 
ERN = 23 Subscript
:  File too big (>16Mbyte) 
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  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
192
  
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 
 
Example: 
RECORD VOICE
Syntax: 
RECORD [FILENAME]
See also: 
ERN, HOOK, RESET MODEM, VOICE
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
193
  
RECORD ON/OFF    turn record mode on/off 
The command RECORD ON is used during testing only.  It sets the record mode, without receiving a file.  Data from the 
encoder can be read from port 3 (GET#3, LINK#3, etc.). 
 
The command RECORD OFF is used to turn off the record mode.  This command must be issued when a recording is 
aborted by an event (TIMEOUT, ESCAPE, etc.). 
Syntax: 
RECORD ON|OFF
See also: 
RESET MODEM, VOICE
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
194
  
RECORD TIMEOUT [num]    set record timeout 
An important variable used with the RECORD command is the Silent Timeout.  With RECORD TIMEOUT you can change 
this.  It is measured in 1/10th of a second.  Changing S-register 66 (SREG66=(num)) has the same effect. 
 
The Silent Timeout determines when the recording is stopped, after a given period of silence.  The Silent Timeout is started 
as soon as the Silent Period is detected.  When no new speech is received, the Silent Timeout runs out and the recording is 
stopped. 
Syntax: 
RECORD TIMEOUT [num]
See also: 
RECORD, RESET MODEM, VOICE
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
195
  
REM    remark 
REM provides the means to include comments within a program.  All text following the REM command up to the end of the 
line is treated as a comment, and is not executed. 
Examples: 
10 REM Protocol Conversion program V2.0
400 GOSUB %Answer : REM Execute Auto-answer routine
Syntax: 
REM text...
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
196
  
RENAME    rename files 
This command will change the name of any file in the filing system.  Using wildcards is not allowed. 
Examples: 
RENAME TEST,MANUAL.TXT.ASC
RENAME TEST TO MANUAL.TXT.ASC
Syntax: 
RENAME (FILE|!) [string] TO|, (FILE|!) [string]
See also: 
COPY
  
						

							ARGUS Programmable Modem 
BASIC Programmers Reference Manual 
© 1990 - 1997 Vidicode Datacommunicatie BV 
197
  
RENUM    renumber program 
RENUM is used to renumber program lines. 
 
Used on its own, RENUM renumbers the entire program using a default start line, and an increment of 10. 
 
Using RENUM with the following program stored in memory: 
10 CLEAR
15 INPUT Enter password :;p$
20 IF p$TULIP THEN END
25 PRINT Welcome to Argus...
30 ....
would result in: 
10 CLEAR
20 INPUT Enter password :;p$
30 IF p$TULIP THEN END
40 PRINT Welcome to Argus...
50 ....
Line numbers and labels referenced in ELSE, THEN, GOTO, GOSUB, ON ... GOTO, ON ... GOSUB, ON
ERROR, RESTORE and ERL commands will be renumbered correctly. 
 
RENUM may also be used with two parameters which specify the start line and the increment to be used; e.g.: 
RENUM 20, 2
Examples: 
RENUM
RENUM 100
RENUM ,50
RENUM 20,20
Syntax: 
RENUM ( [line-num])(,[line-num] )
See also: 
AUTO, LIST