manual:chapter6:usb:cmd

Synopsis

Receive an object and execute it

Stack Diagram

Input Stack		Output Stack
	→	[O]_XEQ
Level 1	→	Level 1

Legend

Legend	Object type
O	Any object
I	Integer number
R	Real number
#	Binary number
Num	Scalar (Integer, Real or Binary number)
Z	Complex number
U	Unit
∡	Angle
A	Symbolic expression
C	Symbolic constant
V	Vector
M	Matrix
S	String
1/0	Any expression evaluating to True or False
G	Grob
F	Font
D	Binary data container
T	Tag object
L	List
cL	Case list
N	Variable name / Identifier
Dir	Directory
pDir	Packed Directory
P	Program
Lib	Library

Type	Command
Parallel list processing	Group 1
Affected by flags	-47	Automatic reception and execution of data sent via USB

Description

The USBAUTORCV command receives an object transmitted by another calculator using the USB link, provided the connection has been successufully negotiated. Since by default object reception happens automatically without an explicit use of USBAUTORCV, the pre-condition for usage of USBAUTORCV is the disabling of automatic reception by setting flag -47.

If the transfer succeeds USBAUTORECV will be automatically XEQted - see USBRECV if this feature is not desired.

To signal the user of an incoming object waiting to be received an RX indicator is displayed in the status area. If there's no data incoming USBAUTORCV silently terminate itself.

Compatibility

This command is new in newRPL and does not exist in userRPL.

Usage

If the following program

« "KNOCK! KNOCK!" »

has been sent from another calculator and it's waiting to be received, then

1:                              
……………………………………………………………………………………
USBAUTORCV

will result in

1:               "KNOCK! KNOCK!"
……………………………………………………………………………………

Related Commands

USB Communications 8 NEW

Command	Short Description
USBSTATUS	Get status of the USB driver	NEW
USBRECV	Receive an object through USB link	NEW
USBSEND	Send an object through the USB link	NEW
USBOFF	Disable USB port	NEW
USBON	Enable USB port	NEW
USBAUTORCV	Receive an object and execute it	NEW
USBARCHIVE	Create a backup on a remote machine	NEW
USBRESTORE	Restore a backup from a remote machine	NEW