Configuration

Configuration takes place via the file TcBangOlufsenServer.cfg, in which the following elements are configured:

A Masterlink Gateway Client for calling virtual buttons.
An ADS device route for describing PLC variables via Custom Strings.

	General: The configuration file TcBangOlufsenServer.cfg is located in the installation directory. If a parameter cannot be read in or if it lies outside the permissible size, then the PLC blocks from the TcBangOlufsen.Lib return a specific error. If a firewall is in use, the port via which the Custom Strings are sent to the controller must be entered in the firewall configuration. The ports that are used by other programs, e.g. FTP, HTTP or Remote Desktop, must also be entered in the firewall configuration.

	Name convention: Must be unique Upper/lower case is ignored Letters and numbers No special characters or umlauts, except “_” (underscore) Minimum length 1 character Maximum length 80 characters

Example: TcBangOlufsenServer.cfg file

<?xml version="1.0" encoding="utf-8" ?>
<TcBangOlufsenServerConfig>
  <MLGW Name="name" Ip="0.0.0.0" Port="9000" />
  <ADSDevice Name="name" AmsNetId="0.0.0.0.1.1" />
</TcBangOlufsenServerConfig>

Configuring a Masterlink Gateway Client

Masterlink Gateway Clients represent the connection between the TwinCAT Bang & Olufsen Server and the Bang & Olufsen Masterlink Gateway. They are needed in order to dispatch Virtual Button Events via Ethernet.

Add the following XML nodes to the <TcBangOlufsenServerConfig> section:

<MLGW Name="name" Ip="0.0.0.0" Port="9000" />

In this way you generate a new Masterlink Gateway Client in service. Repeat the procedure if you have several Bang & Olufsen Masterlink Gateways.

Parameter	Description
Name	Name of the Bang & Olufsen Masterlink Gateway. It is used in the PLC to assign requests to the MLGW Client.
Ip	Internet Protocol address (IP). Address via which the Masterlink Gateway can be reached in the network.
Port	The port is part of the address and describes the network entry point on the Masterlink Gateway. The default setting is 9000.

Configuring ADS device routes

The ADS device routes contain the parameters that are needed so that the TwinCAT Bang & Olufsen Server can assign received Custom Strings to a controller.

Add the following XML nodes to the <TcBangOlufsenServerConfig> section:

<ADSDevice Name="name" AmsPort="801" AmsNetId="0.0.0.0.1.1" />

In this way you generate a new ADS device route in service. Repeat the procedure if you have several controllers that are to be addressed via Custom Strings.

Parameter	Description
Name	Name of the controller. It is used in the Custom String configuration to assign Custom Strings to a controller.
AmsPort	PLC runtime system. The default setting is 801.
AmsNetId	AmsNetId of the controller.