Vidicode Argus Basic Programmers Reference Manual
Have a look at the manual Vidicode Argus Basic Programmers Reference Manual online for free. It’s possible to download the document as PDF or print. UserManuals.tech offer 9 Vidicode manuals and user’s guides for free. Share the user manual or guide on Facebook, Twitter or Google+.
![Page 186
ARGUS Programmable Modem
BASIC Programmers Reference Manual
© 1990 - 1997 Vidicode Datacommunicatie BV
183
RECEIVE receive file or data
RECEIVE is one of the most powerful commands available with this modem, and provides a simple means of transferring
data into the modem under program control, with minimum effort.
There are 3 basic forms of the command:
RECEIVE [port],[address] : receive data using Xmodem
RECEIVE [port],[filename],[type] : receive file
RECEIVE ALL: receive a backup of...](http://img.usermanuals.tech/thumb/5741/85262/w64_vidicode-programming-manual_d-185.png "Page 186
ARGUS Programmable Modem
BASIC Programmers Reference Manual
© 1990 - 1997 Vidicode Datacommunicatie BV
183
RECEIVE receive file or data
RECEIVE is one of the most powerful commands available with this modem, and provides a simple means of transferring
data into the modem under program control, with minimum effort.
There are 3 basic forms of the command:
RECEIVE [port],[address] : receive data using Xmodem
RECEIVE [port],[filename],[type] : receive file
RECEIVE ALL: receive a backup of...")
![Page 187
ARGUS Programmable Modem
BASIC Programmers Reference Manual
© 1990 - 1997 Vidicode Datacommunicatie BV
184
RECEIVE #[port], [address] receive data
Here, RECEIVE is used to transfer data as opposed to a file, using the Xmodem file transfer protocol to prevent the
occurrence of errors.
The command is followed by a port number (1 - 3 only) and an address, which are both optional.
If the parameters are omitted, the default input port as defined by IPORT, and the start address defined by...](http://img.usermanuals.tech/thumb/5741/85262/w64_vidicode-programming-manual_d-186.png "Page 187
ARGUS Programmable Modem
BASIC Programmers Reference Manual
© 1990 - 1997 Vidicode Datacommunicatie BV
184
RECEIVE #[port], [address] receive data
Here, RECEIVE is used to transfer data as opposed to a file, using the Xmodem file transfer protocol to prevent the
occurrence of errors.
The command is followed by a port number (1 - 3 only) and an address, which are both optional.
If the parameters are omitted, the default input port as defined by IPORT, and the start address defined by...")
![Page 188
ARGUS Programmable Modem
BASIC Programmers Reference Manual
© 1990 - 1997 Vidicode Datacommunicatie BV
185
RECEIVE [filename], [type] receive file
When followed by a string, the RECEIVE command is used to receive and store complete files in the filing system:
RECEIVE [filename]
All types of files discussed under the DIR command may be received, and there are various options which are discussed
below.
RECEIVE [filename] (,T/N)
RECEIVE without a parameter, or with the ,T parameter, prepares...](http://img.usermanuals.tech/thumb/5741/85262/w64_vidicode-programming-manual_d-187.png "Page 188
ARGUS Programmable Modem
BASIC Programmers Reference Manual
© 1990 - 1997 Vidicode Datacommunicatie BV
185
RECEIVE [filename], [type] receive file
When followed by a string, the RECEIVE command is used to receive and store complete files in the filing system:
RECEIVE [filename]
All types of files discussed under the DIR command may be received, and there are various options which are discussed
below.
RECEIVE [filename] (,T/N)
RECEIVE without a parameter, or with the ,T parameter, prepares...")
![Page 190
ARGUS Programmable Modem
BASIC Programmers Reference Manual
© 1990 - 1997 Vidicode Datacommunicatie BV
187
If Ymodem-Batch is used, the system variable MATCH contains the number of files received.
RECEIVE [filename],C
The RECEIVE,C command is very useful in combination with the SEND,C command to create and restore file copies.
The used filename is not important (but must be filled in), because the received file contains all the original Argus filenames.
All other Argus-filing-system related...](http://img.usermanuals.tech/thumb/5741/85262/w64_vidicode-programming-manual_d-189.png "Page 190
ARGUS Programmable Modem
BASIC Programmers Reference Manual
© 1990 - 1997 Vidicode Datacommunicatie BV
187
If Ymodem-Batch is used, the system variable MATCH contains the number of files received.
RECEIVE [filename],C
The RECEIVE,C command is very useful in combination with the SEND,C command to create and restore file copies.
The used filename is not important (but must be filled in), because the received file contains all the original Argus filenames.
All other Argus-filing-system related...")
![Page 191
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](http://img.usermanuals.tech/thumb/5741/85262/w64_vidicode-programming-manual_d-190.png "Page 191
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")
![Page 193
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](http://img.usermanuals.tech/thumb/5741/85262/w64_vidicode-programming-manual_d-192.png "Page 193
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")
![Page 194
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...](http://img.usermanuals.tech/thumb/5741/85262/w64_vidicode-programming-manual_d-193.png "Page 194
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...")
![Page 195
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](http://img.usermanuals.tech/thumb/5741/85262/w64_vidicode-programming-manual_d-194.png "Page 195
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 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