_port_assign

#port_assign

###Assign a device id to a tcp or serial port.

Syntax

status = port_assign ( id,port ) ;

Arguments

1. int id

Device id. Valid range from 0 to 65535.

2. handle port

A port handle returned by the port_open or port_service functions.

Return Value

str status

• $ACKNOWLEDGE : The device id was assigned to the port handle.

The STATUS variable is set to $ACKNOWLEDGE

• 0 : No port port 'x'. Use port_open() to open port.

The STATUS variable is set to %UNDEFINED

• 0 : Device Id 'x' is already assigned to port 'y' by instance 'z'.

The STATUS variable is set to %port

Warnings

• %UNDEFINED : No port port 'x'. Use port_open() to open port.
• %port : Device Id 'x' is already assigned to port 'y' by instance 'z'.

Exceptions

• %ARGUMENT: Invalid arguments. Usage: status = port_assign ( id,port ) ;

• %BOUNDS: Device ID out of range.

Description

p

Examples

puts "Create an example for the function 'port_assign'" ;

Related Links

port_open