VISCA(3X) — NEWS-OS Programmer’s Manual

NAME

visca_open, visca_close, visca_num_devices, visca_check_network − Function to connect to VISCA network.

SYNOPSIS

#include <visca.h>
intvisca_open( port )
char∗port;

intvisca_close( channel )
intchannel;

intvisca_num_devices( channel )
intchannel;

intvisca_check_network( channel )
intchannel;

DESCRIPTION

visca_open opens RS-232C devices indicated by port and executes initialization to use VISCA protocol. If succeeded, channel number (file descriptor) to use VISCA network is returned. If succeeded to open channel, the following three functions visca_clear(3X) visca_address(3X) visca_reset_clock(3X) are called inside the library in this order to initialize VISCA network.

visca_close closes the device that is indicated by channel to terminate use of VISCA protocol.

visca_num_devices returns the number of VISCA devices that are connected to the channel numbers indicated by channel.

visca_check_network checks if VISCA network structure has changed or not. If network structure has changed, 1 is returned. If not changed, 0 is returned. When VISCA network has changed, VISCA network should be initialized using visca_clear(3X) and visca_address(3X).

RETURN VALUE

−1 is returned in all functions when execution error should occur. In this case, error number is set in external variable vs_error

FILES

/usr/sony/lib/libvisca.a library

/usr/sony/include/visca.h header file

Museum