Cyclone Automated Control Package
21
4.3 Cyclone Connecting / Disconnecting Calls
4.3.1 connect_to_cyclonepromax
function connect_to_cyclonepromax(port_type : longword;
identifier_type : longword; port_identifier : pchar) : longword;
unsigned long connect_to_cyclonepromax(unsigned long port_type,
unsigned long identifier_type, char* port_identifier);
UInt32 connect_to_cyclonepromax(UInt32 port_type, UInt32
identifier_type, String port_identifier);
This function opens a session with a Cyclone unit and tests the
connection. The handle returned by this function is passed as a parameter
to all other functions provided by the DLL. If you connect to a Cyclone that
already has a handle, the same handle is returned. If there is a failure
contacting the Cyclone, the function returns a 0.
Note that the DLL does not support multiple Cyclones connected via the
serial port. If you require more than one Cyclone to use a serial port
connection, P&E recommends using the RS232 communication protocols
available in the Enterprise Edition.
@param port_type
Specifies how the Cyclone is currently
connected to the host PC. One of three
possible values:
PortType_USB
PortType_Ethernet
PortType_Serial
@param identifier_type
Specifies whether to identify the Cyclone by its
IP address or its name. One of two possible
values:
Open_by_IP_Address
Open_by_Name
Open_by_Port_Num
@param port_identifier
This parameter is a pointer to a null-terminated
character string which identifies the Cyclone.
If identifying by IP address, the string should be
in the format of xxx.xxx.xxx.xxx, where xxx =
0…255.