Skip to main content
Version: 2.0.0

ADS Source

The Tributech ADS Source allows to connect to an Beckhoff ADS Server which can be used to ingest or write data. The ADS Source allows to build a connection as a ADS client and forwards the polled or on change data notifications to our Tributech Agent and to the corresponding stream via our MQTT Broker. It is also possible to write values to specific symbol in a cyclic manner (see ADS Parameter Twin)

Following Features are supported :

  • Failure Handling
  • Poll or On Change Data notifications (see ADS Stream Twin)
  • Write values to the ADS Server via Parameters in a cyclic manner
  • Data Control via Data Change Options (PMIN, PMAX, Step)

Manual setup

For the manual setup of the Tributech ADS Source (ads-source) we need the main DSK Edge services as a basis.

  • Copy the docker-compose.override.yml file. (see also Docker doc - Understanding multiple Compose files)

    docker-compose.override.yml
    version: "3.3"

    services:
    ads-source:
    image: ${DOCKER_REGISTRY-tributech.azurecr.io/}ads-source:${SOURCE_TAG:-latest}
    depends_on:
    - mosquitto-server
    - dsk-agent
    environment:
    - MqttOptions__MQTTHost=mosquitto-server
    - Logging__LogLevel__Default=Information
    # push logs to Loki at server via promtail
    - TelemetryOptions__LokiUrl=https://promtail-push.${NODE_NAME:?"The variable NODE_NAME needs to be configured in the .env file."}.dataspace-node.com
    - TelemetryOptions__LokiUser=tributech
    - TelemetryOptions__LokiPassword=${LOKI_PROMTAIL_PW:?"The variable LOKI_PROMTAIL_PW needs to be configured in the .env file."}
    - TelemetryOptions__ServiceName=${AGENT_NAME:?"The variable AGENT_NAME needs to be configured in the .env file."}-ads-source
    - TelemetryOptions__ServiceId=${AGENT_ID:?"The variable AGENT_ID needs to be configured in the .env file."}
    networks:
    - edge-net
    restart: unless-stopped
    logging:
    driver: "json-file"
    options:
    max-size: "2m"
    max-file: "5"
  • Startup all Tributech Edge and ADS service (will automatically retrieve the Docker images).

    docker-compose up -d
  • Configure the ADS Source via our DTDL Model and add an entry to the server ADS AMS Router ADS Network Diagram

  • You can now continue with connecting to, linking & configuring the Tributech Edge Agent and the ADS Source.