manual:chapter6:usb:cmd_usbsend [newRPL User Manual]

Synopsis

Send an object through the USB link

Stack Diagram

Input Stack		Output Stack
O	→	1/0
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 5
Affected by flags	-47	Automatic reception and execution of data sent via USB

Description

The USBSEND command sends an object to another calculator using the USB link, provided the connection has been successufully negotiated. If the transfer succeeds USBSEND will leave 1 on the stack, otherwise it will leave 0.

The setting of flag -47 on the destination machine has an effect on USBSEND on the source machine, because the transfer queue can manage just one object at a time: until the object currently sent is not received by the destination calc any subsequent transfer will fail.

Compatibility

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

Usage

The following program

«  @@ Make a list with value and variable name and send it
  2 →LIST
  DO
    DUP 
  UNTIL
    USBSEND
  END
  DROP 
  
  @@ Write a program to explode the list and do 'STO' in  the other calc...
  «
    OBJ→ DROP STO 
  »

  @@ ...and send it!
  DO
    DUP 
  UNTIL
    USBSEND
  END
  DROP 
»

executes a STO through USB. See USBRECV for implementation of a USB RCL.

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