WERMA WIN ETHERNET

Overview

The Werma WIN system is a wireless communication system for making simple machine state information available for digital processing. The system especially enables connected stacklights. With the Cybus Connectware, the Werma WIN data can easily be made available in your shopfloor data structure.

The Werma WIN system consists of the following components:

Werma WIN Ethernet Master
The master acts as an access point to the wireless sensor system. Its ethernet port must be reachable by the Cybus Connectware. In order to commission the data acquisition, the IP address of the ethernet master must be known. A single master is used for managing access to many slaves.
Werma WIN Slaves

Each machine / stack light is equipped with a dedicated slave. Each slave is identified with a mac address, which can be found out by inspecting the Cybus logs or with the Werma WIN Windows Configuration tool. Every slave provides the following data points:

  • RSSI: an indicator for the wireless signal strength of this particular slave
  • Tiers (t1,t2,t3,t4): represent the state of the up to four digital switches. A tier is usually associated with a specific color. Tiers may carry one of the following values: ‘on’, ‘off’, ‘blink’.

State updates from slaves come asynchronously at both a fixed time interval and upon each state change at any of the tiers.

Werma WIN Easy Software (???)
For system setup and configuration and especially the association between master and slaves, you need to use the Werma WIN Windows Software that is shipped with the hardware.
Werma WIN Shopfloor Manager (???)
The proprietary shopfloor managment application from Werma can be used in conjunction with Cybus. Because a Werma WIN Ethernet Master does not allow multiple concurrent connections, the Cybus Werma Proxy Service can be used to distribute data simultaneously.

The Cybus Connectware driver werma maps the proprietary Werma WIN Protocol into MQTT/JSON.

Commissioning file specifics

A typical commissioning file for the Werma protocol looks like this:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
# ----------------------------------------------------------------------------#
# Commissioning File
# ----------------------------------------------------------------------------#
# Manufacturer: Werma
# Device: Werma WIN Ethernet Master
# Copyright: Cybus GmbH (2018)
# Contact: support@cybus.io
# ----------------------------------------------------------------------------#
# Source Interface Definition - Werma WIN Ethernet Master
# ----------------------------------------------------------------------------#
source:
  driver: werma
  connection:
    protocol: werma-ethernet
    host: {{Master IP Address}}
    password: {{Master Password}}
  defaults:
    operation: subscribe
# ----------------------------------------------------------------------------#
# Target Interface Definition - MQTT (Cybus Connectware Broker)
# ----------------------------------------------------------------------------#
target:
  driver: mqtt
  defaults:
    operation: write
    topicPrefix: io/cybus/werma
# ----------------------------------------------------------------------------#
# Each slave/tier combination is mapped to an individual datapoint
# ----------------------------------------------------------------------------#
mappings:
- source:
    mac: 006709
    field: t1
  target:
    topic: machine1/red
- source:
    mac: 006709
    field: t2
  target:
    topic: machine1/green
- source:
    mac: 006709
    field: rssi
  target:
    topic: machine1/yellow
# ----------------------------------------------------------------------------#
# For debugging and in order to use the Cybus Werma Proxy Service, the raw
# data can be subscribed, too
# ----------------------------------------------------------------------------#
- source:
    mac: all
    field: raw
  target:
    topic: raw

Important

The Werma interface is only able to provide data. Writing to this interface is not foreseen.

Mapping Fields

mac
MAC Address of the slave, can be found out either in the Cybus Device Mapper logs (watch out for ‘New Werma Slave appeared’) or in the Werma WIN Easy Software. To catch all raw messages, use ‘all’
field
Selector for the field to be mapped. Valid values are: ‘raw’ (only together with mac: ‘all’), ‘t1’, ‘t2’, ‘t3’, ‘t4’ (for the four tiers) and ‘rssi’.

Received data for tiers

1
2
3
4
{
  "timestamp": "<unix timestamp in ms>",
  "value": "'on'|'off'|'blink'"
}

Received data for rssi

1
2
3
4
{
  "timestamp": "<unix timestamp in ms>",
  "value": "<float>"
}

Received data for raw

The raw data is forwarded as received from the Werma WIN Ethernet master without any further processing or decoration.