MTConnect.NET-AgentModule-MqttRelay 6.4.3

MTConnect MQTT Relay Module

This Agent Module writes data to an External MQTT Broker

Configuration

modules:
  - mqtt-relay:
      server: localhost
      port: 1883
      topic: enterprise/site/area/line/cell/MTConnect
      topicStructure: Document

• server - The MQTT broker hostname

• port - The MQTT broker port number

• timeout - The UUID or Name of the Device to read data for

• reconnectInterval - The UUID or Name of the Device to read data for

• username - Sets the Username to use for authentication

• password - Sets the Password to use for authentication

• clientId - Sets the Client ID to use for the connection

• qos - Sets the Quality Of Service (QoS) to use. 0 = At Most Once, 1 = At least Once, 2 = Exactly Once

• useTls - Sets whether to use TLS or not (true or false)

• topicPrefix - The prefix to add to the MQTT topics that are published

• topicStructure - (Document or Entity) Sets how MQTT topics and messages are stuctured

• currentInterval - Sets the Interval (in milliseconds) to send Current messages at

• sampleInterval - Sets the Interval (in milliseconds) to send Sample messages at

• documentFormat - The Document Format ID to use to format the payload

• tls - Sets the TLS settings

  • pfx - The PFX certificate settings

    • certificatePath - The path to the (.pfx) file
    • certificatePassword - The certificate password

  • pem - The PEM certificate settings

    • certificatePath - The path to the (.pem) file
    • privateKeyPath - The path to the key containing the private key
    • privateKeyPassword - The certificate password
    • certificateAuthority - The path to the (.pem) file containing the Certificate Authority

  • verifyClientCertificate - Toggles whether Client Certificate chains are verified ("true" or "false")

AWS IoT Configuration Example

- mqtt-relay:
    server: akljadkfjdlsf-ats.iot.us-east-1.amazonaws.com
    port: 8883
    tls:
      pem:
        certificateAuthority: certs/AmazonRootCA1.pem
        certificatePath: certs/asfdslkafjdslkfjdklsdjf-certificate.pem.crt
        privateKeyPath: certs/sdlkajlksdajfldskjfdldlskfjdslkaj-private.pem.key
    documentFormat: json-cppagent
    currentInterval: 5000
    sampleInterval: 500
    topicPrefix: enterprise/site/area/line/cell/MTConnect

AWS Greengrass Moquette Configuration Example

modules:
  - mqtt-relay:
      server: localhost
      port: 8883
      clientId: mtconnect-test # Set the ClientId to the AWS Thing ID
      tls:
        verifyClientCertificate: false
        pem:
          certificateAuthority: certs/AmazonRootCA1.pem
          certificatePath: certs/2316549874654321654984984158961634984794-certificate.pem.crt
          privateKeyPath: certs/2316549874654321654984984158961634984794-private.pem.key
      documentFormat: json-cppagent
      currentInterval: 5000
      sampleInterval: 500
      topicPrefix: enterprise/site/area/line/cell/MTConnect

HiveMQ Configuration Example

modules:
  - mqtt-relay:
      server: 5679887d308d402888f32.s1.eu.hivemq.cloud
      port: 8883
      username: mtconnect
      password: mtconnect
      useTls: true
      documentFormat: json-cppagent
      currentInterval: 5000
      sampleInterval: 500
      topicPrefix: enterprise/site/area/line/cell/MTConnect

Contribution / Feedback

• Please use the Issues tab to create issues for specific problems that you may encounter
• Please feel free to use the Pull Requests tab for any suggested improvements to the source code
• For any other questions or feedback, please contact TrakHound directly at info@trakhound.com.

License

This application and it's source code is licensed under the MIT License and is free to use.