.. _user/protocols/werma: ****************** 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 multiple slaves. Werma WIN Slaves Each machine / stack light is equipped with a dedicated slave. Each slave is identified by its 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', or 'blink'. State updates from slaves can be triggered asynchronously at fixed time intervals as well as on state changes of 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 management application from Werma can be used in conjunction with the Connectware. 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* ``Werma`` protocol maps the proprietary Werma WIN Protocol into MQTT/JSON. .. _user/protocols/werma_connection: .. include:: ../protocolSchemas/WermaConnection.rst .. _user/protocols/werma_endpoint: .. include:: ../protocolSchemas/WermaEndpoint.rst Example Configuration ===================== The following example demonstrates how to configure a simple Werma connection and endpoint that subscribes to a device specified by its MAC address. .. code-block:: yaml :linenos: wermaConnection: type: Cybus::Connection properties: protocol: Werma connection: port: !ref host host: !ref host password: !ref password connectionStrategy: initialDelay: 1000 maxDelay: 10000 incrementFactor: 2 wermaSubscribe: type: Cybus::Endpoint properties: protocol: Werma connection: !ref wermaConnection subscribe: mac: !ref macAddress Received data for tiers ----------------------- .. code-block:: json :linenos: { "timestamp": "", "value": "'on'|'off'|'blink'" } Received data for rssi ----------------------- .. code-block:: json :linenos: { "timestamp": "", "value": "" } Received data for all --------------------- .. code-block:: json :linenos: { "timestamp": "", "value": { "t1": "'on'|'off'|'blink'", "t2": "'on'|'off'|'blink'", "t3": "'on'|'off'|'blink'", "t4": "'on'|'off'|'blink'", "rssi": "" } } Received data for raw --------------------- The raw data is forwarded as received from the Werma WIN Ethernet master without any further processing or decoration.