Plantas Electricas

The ActiveX Interface of Facon Communication Server
(Doc.V1.0 05/13/2003)

Methods
OpenProject SaveProject Connect Disconnect AddGroup EditGroup DeleteGroup AddItem DeleteItem GetItem SetItem

Description
Open the previous saved project file (with .fcs file extension). The function is the same as [open project] menu in the Facon Server Windows Save the configuration data into the projectfile. The function is the same as [save project] menu in the Facon Server Windows Start to connect the PLCs and retrieve the data continuously. The function is the same as [connect] menu in the Facon Server Windows Terminate the connection with PLCs. The function is the same as [Disconnect] menu in the Facon Server Windows Add a new data group. The function is the same as [Add group] menu in theFacon Server Windows Edit the data group. The function is the same as [Edit group] menu in the Facon Server Windows Delete the data group. The function is the same as [Delete group] menu in the Facon Server Windows Add a new data item for automatic retrieving. The function is the same as [Add item] menu in the Facon Server Windows Delete a data item. The function is the same as [Delete item] menu inthe Facon Server Windows Get the value of a data item Write value into a data item

1

OpenProject
Open a project file, which was created by Facon Server manually or by the program thru the ActiveX interfaces. Based on the project‟s content (The Channel, controller, group and item specify), while calling the CONNECT method, the Facon server will connect and retrieve or write the datato/from the PLCs accordingly.

HRESULT _stdcall OpenProject( BSTR filename // Project File ); Inputs filename [In] Project File name for opening Returns S_OK while return with success S_FALSE while return with fail Note The application program must first open the project file before it can connect with PLCs. Related methods SaveProject, Connect, Disconnect.

2

SaveProject
Save the project datainto file. HRESULT _stdcall SaveProject( BSTR filename //Project file name ); Inputs filename [In] File name for storing project data. Returns S_OK while return with success S_FALSE while return with fail

Related methods OpenProject, Connect, Disconnect.

3

Connect

Start to establish the connections with PLC and retrieve the data periodically.
HRESULT _stdcall Connect(); Inputs NoneReturns S_OK while return with success S_FALSE while return with fail Notes

Before calling COONECT method, the project should be opened.
Related methods OpenProject, SaveProject, Disconnect.

4

Disconnect

Terminate the connections with PLCs
HRESULT _stdcall Disconnect(); Inputs

None
Returns S_OK while return with success S_FALSE while return with fail Note

Only when theconnection was established by the CONNECT method, can the DISCONNECT method be called Related methods
OpenProject, SaveProject, Connect.

5

AddGroup

Add a new data group. The items under the same group can be managed together Which share the same attributes such as retrieve priority or enable control
HRESULT _stdcall AddGroup( BSTR path, // The
BSTR groupname, //

byte priority,
byteenabled

data path of added group The name of the group // The retrieving priority.
//Enable/Disable control of the data group

);
Inputs path

[In]

The data path of added group The name of the group

groupname [In] priority [In]

The retrieving priority 0 stands for the first priority. 1 stands for the medium priority while 2 is the lowest priority
enabled [In] Initial state of datagroup

0 stands for disable, 1 stands for enable
Returns

S_OK while return with success operation S_FALSE while return with fail operation
Note

Naming notation of group path: When add a “Group1” group under the devices[Channel0] and controller[Station1], the group path name is denoted by “Channel0.Station1”, please note that the device and the controller is separated by a dot character....