Loggers - Device Connections: DNP3

This article covers loggers related to DNP3 device connections that were introduced in Ignition version 7.8.X.

Loggers in this article:

• xopc.drivers.dnp3.Dnp3Driver

  • xopc.drivers.dnp3.Dnp3Driver

  • xopc.drivers.dnp3.Dnp3SubscriptionModel

  • xopc.drivers.dnp3.requests.IntegrityPollRequest

• xopc.drivers.dnp3.Master

  • xopc.drivers.dnp3.Master
  • xopc.drivers.dnp3.Master.ChannelManager

xopc.drivers.dnp3.Dnp3Driver

A series of loggers monitoring connection status and Tag subscriptions using DNP3.

xopc.drivers.dnp3.Dnp3Driver

• Show the output of the connection when it is first established.
  • DEBUG log showing a successful, default device connection when it is first created, then disabled in the Ignition config. {DeviceConnectionName} is denoted as the name of the specific DNP3 device connection in the Ignition config:
    

    Device {DeviceConnectionName}: Transitioning to Active state... Synchronizing Dnp3 outstation… … Reading outstation conformance level... Found outstation conformance level 0x33 Setting outstation conformance level: 3 Checking time synchronization... Checking restart bit... … Unsolicited messaging remaining disabled on startup. … Shutting down Dnp3 driver… … Canceling integrity poll request on shutdown. Clearing nodes on shutdown. Disconnecting dnp3 master... … Disconnected.

Back to top

xopc.drivers.dnp3.Dnp3SubscriptionModel

• Provides information about created/removed Tag subscriptions for DNP3 device connections.
  • DEBUG log for created Tag subscriptions where {count} is denoted as the number of tags being created. {pollRate} is denoted as the Tag Group/Scan Class used for those sets of Tags. The device is then later disabled:
    

    Optimizing and scheduling {count} items. Scheduled 7 requests @ {pollRate}ms. Optimizing 0 items to run once. ... Shutting down Dnp3 subscriptions.

Back to top

xopc.drivers.dnp3.requests.IntegrityPollRequest

• A logger notifying us when the driver attempts to poll from any existing Tag subscriptions on a DNP3 device.
  • DEBUG log stating a poll request. A response to this log typically comes from the DEBUG output of drivers.dnp3.Dnp3SubscriptionModel:
    

    Executing integrity poll request.

Back to top

xopc.drivers.dnp3.Master

A series of loggers also monitoring connection status and Tag subscriptions using the DNP3. Provides more details about the specified parameters defined on the device connection in Ignition configuration.

xopc.drivers.dnp3.Master

• Shows details between the DNP3 driver and the outstation when connecting, established, and disconnecting.
  • DEBUG log showing interaction between the driver and outstation when connecting, established, and disconnecting. For this example, Unsolicited Messages Enabled was set to false for the device connection. {sourceIP}/{sourcePort} and {destIP}/{destPort} are denoted as the Ignition server and DNP3 device IP and port numbers used for establishing a connection:
    

    Modifying unsolicited: DISABLE_UNSOLICITED requesting permit for DISABLE_UNSOLICITED acquired permit for DISABLE_UNSOLICITED … [[id: 0x71bca2d2, L:/{sourceIP}:{sourcePort} - R:/{destIP}:{destPort}]] response [functionCode=RESPONSE, indicators=[CLASS_1_EVENTS, CLASS_2_EVENTS, CLASS_3_EVENTS, EVENT_BUFFER_OVERFLOW]] requesting permit for READ releasing permit for DISABLE_UNSOLICITED released permit for DISABLE_UNSOLICITED acquired permit for READ … [[id: 0x71bca2d2, L:/{sourceIP}:{sourcePort} ! R:/{destIP}:{destPort}]] channel inactive Canceling pending request.

Back to top

xopc.drivers.dnp3.Master.ChannelManager

• Provides information regarding the connection between Ignition and the DNP3 device.
  • INFO log that appears by default when the connection is established. {sourceIP}/{sourcePort} and {destIP}/{destPort} are denoted as the Ignition server and DNP3 device IP and port numbers used for establishing a connection:
    

    [[id: 0x71bca2d2, L:/{sourceIP}:{sourcePort} - R:/{destIP}:{destPort}]] connected

• • DEBUG log also providing information about the established connection:
    

    Channel bootstrap succeeded: localAddress=/{sourceIP}:{sourcePort}, remoteAddress=/{destIP}:{destPort}

Back to top