Configuration

The TwinCAT FIAS Server is configured by means of a text file in XML format (TcFIASServer.cfg). The file is provided with the installation and is in the installation directory after completion. The file may neither be moved nor renamed. The table below describes the individual parameters required for the configuration of connections to a hotel management server. Furthermore, there is a description of the dependencies in which a backup file is created and how it is updated during service operation.

TcFIASServer.cfg (example)

<?xml version="1.0" encoding="utf-8" ?>
<TcFiasServerConfig>
   <Client Name="FIAS1" Port="5001" Ip="192.168.0.20" ResyncCycleTime="120" SaveCycleTime="120" SaveType="2" LinkAliveCycleTime="5" />
</TcFiasServerConfig>
Configuration 1:

If you wish to establish a connection to more than one hotel management server, then a further FiasClient configuration must be entered in the TcFIASServer.cfg file. See the following example.

<?xml version="1.0" encoding="utf-8" ?>
<TcFiasServerConfig>
   <Client Name="FIAS1" Port="5001" Ip="192.168.0.21" ResyncCycleTime="120" SaveCycleTime="120" SaveType="2" LinkAliveCycleTime="5" />
   <Client Name="FIAS2" Port="5001" Ip="192.168.0.22" ResyncCycleTime="120" SaveCycleTime="120" SaveType="2" LinkAliveCycleTime="5" />
   <Client Name="FIAS3" Port="5001" Ip="192.168.0.23" ResyncCycleTime="120" SaveCycleTime="120" SaveType="2" LinkAliveCycleTime="5" />
</TcFiasServerConfig>

Description of parameters

Configuration 2:

If a parameter cannot be read, or if it lies outside the permitted range, then each call of a PLC function block from the TcFIAS.Lib returns a specific error. This occurs until the error has been rectified.

Parameter

Description

Name

Name of the hotel management server.

Note The name specified here may not be used several times in the configuration.

Port

The TCP port of the hotel management server.

Note The TCP port is variable and is specified by the integrator of the Fidelio management server.

Ip

IP Address of the hotel management server.

Note The IP Address is variable and is specified by the integrator of the Fidelio management server.

ResyncCycleTime

Specifies the time interval between resyncs of the database. The TwinCAT FIAS Server compares, based on a time stamp in the backup file, whether the time interval to the previous resync has been exceeded. If the ResyncCycleTime has been exceeded, a database resync is performed at the next establishment of a connection to the management server.
After a successful resync of the database, the data received are always written to the backup file. The min. value is 120 minutes and the max. value is 65535 minutes.

Note If ResyncCycleTime set to an invalid value or a value outside the range, the default value of 120 minutes is used automatically.

SaveType

The SaveType specifies the cases in which the backup file is to be written.

  • 1:    In the event of a change.
  • 2:    At periodic intervals.

Note If SaveType set to an invalid value, the default value 2 is used automatically.

SaveCycleTime

Specifies the time interval between the interval for writing the backup file. The SaveCycleTime is expected in minutes. The min. value is 30 minutes, and the max. value is 65535 minutes.

Note A small value means that the backup file is often saved and the mass storage device of the controller is thus accessed more frequently. Therefore, select the parameter so that the number of accesses to the backup file is as small as possible.

Note If SaveCycleTime set to an invalid value or a value outside the range, the default value of 30 minutes is used automatically.

LinkAliveCycleTime

Specifies the time interval between the interval for sending a link alive telegram. The LinkAliveCycleTime is expected in minutes. The min. value is 5 minutes, and the max. value is 30 minutes.

Note If LinkAliveCycleTime set to an invalid value or a value outside the range, the default value of 5 minutes is used automatically.