# Hottinger Baldwin Messtechnik (HBM)

{% hint style="danger" %}
The HBM DAQ protocol may require root permissions in some constellations. If you experience problems with running this protocol, please make sure to install your service on an agent with root permissions as described in [agent orchestration](https://docs.cybus.io/2-0-6/agents/installing-agents#orchestration).
{% endhint %}

The HBM company provides hardware (h/w) and software (s/w) solutions for configuring and reading out sensors of various types.

Sensors are connected to controller boxes of varying capability with respect to number and type of the latter. The controller boxes themselves are typically connected to LAN via ethernet for configuration and data acquisition (DAQ).

<figure><img src="https://639096190-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfDpOJO2upcq5EpoSahvK%2Fuploads%2Fgit-blob-ee605b4d2e09c8b9de9029f3bc56bca2c3ba0c82%2FHBM-MX410B.jpg?alt=media" alt=""><figcaption></figcaption></figure>

The Connectware `HbmDaq` protocol reads the HBM specific DAQ protocol and maps it into the industry standard protocol MQTT.

The configuration interface is **not** interfaced.

[Connection Properties](https://docs.cybus.io/2-0-6/documentation/industry-protocol-details/hottinger-baldwin-messtechnik-hbm/hbmdaqconnection)

[Endpoint Properties](https://docs.cybus.io/2-0-6/documentation/industry-protocol-details/hottinger-baldwin-messtechnik-hbm/hbmdaqendpoint)

Using the Windows based (*HBM-MXAssistant*) configuration interface, it is possible to create *virtual* channels with custom chosen names. Hence, those won’t follow the regular structure and must be added specifically.

{% hint style="danger" %}
As data is streamed out in a scheduled push fashion, proper update rates should be configured using the *MXAssistant* tool.
{% endhint %}

<figure><img src="https://639096190-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfDpOJO2upcq5EpoSahvK%2Fuploads%2Fgit-blob-d348be81add45bc4778fce181e05968f20e08d68%2Fhbm-datarate-adjustment.png?alt=media" alt=""><figcaption><p>Screenshot showing the data-rate configuration panel.¶</p></figcaption></figure>

The HBM DAQ connections created by Connectware are resilient against disconnects and will automatically reconnect as soon as possible and continue streaming out data.

## Service Commissioning File Example

The following example demonstrates how to configure a simple HbmDaq connection and endpoint that subscribes to an *AnalogIn\_Connector1.Signal1* device signal.

{% hint style="warning" %}
The HBM DAQ interface is only able to provide data. Writing to this interface is not implemented.
{% endhint %}

{% code lineNumbers="true" %}

```yaml
hbmdaqConnection:
  type: Cybus::Connection
  properties:
    protocol: HbmDaq
    connection:
      host: 192.168.2.160
      port: 8081

hbmdaqSubscribe:
  type: Cybus::Endpoint
  properties:
    protocol: HbmDaq
    connection: !ref hbmdaqConnection
    subscribe:
      signal: AnalogIn_Connector1.Signal1
```

{% endcode %}