DrvIEC104 Communicator Driver (Custom)

Functional Description

DrvIEC104 is a custom Communicator driver in ScadaV6CommExt for field device connectivity. Protocol details follow the source implementation.

Scope and Version

• Source: ScadaV6CommExt/DrvIEC104.Logic
• TFM: net8.0
• Version: 6.1.6

Install and Enable

1. Deploy driver binaries to Communicator folders.
2. Activate driver in Administrator → Communicator → Drivers.
3. Upload configuration and restart Communicator.

Line and Device Configuration

1. Create a communication line with the proper channel type.
2. Add device and set address/timeouts.
3. Set polling options and CmdLine as required by this driver; see Functional notes and configuration (template and source) below for file names, address format, and line keys.

CustomOptions (extracted)

Code hints

33: protected class TemplateDict : Dictionary
46: private DeviceTemplate deviceTemplate;
51: private Connection mIEC104Con; // IEC104连接对象
69: var (hostName, port) = ParseConnectionAddress();
74: mIEC104Con = new Connection(hostName, port);
76: mIEC104Con.ConnectTimeout = 5000;
80: mIEC104Con.SetConnectionHandler(ConnectionHandler, null);
112: private (string hostName, int port) ParseConnectionAddress()
122: if (int.TryParse(address.Substring(colonIndex + 1), out int parsedPort))
124: port = parsedPort;
161: private void ConnectionHandler(object parameter, ConnectionEvent connectionEvent)
169: case ConnectionEvent.OPENED:
170: Log.WriteInfo("ConnectionHandler-> Connection opened successfully");
175: case ConnectionEvent.CLOSED:
176: Log.WriteInfo("ConnectionHandler-> Connection closed");
181: case ConnectionEvent.STARTDT_CON_RECEIVED:
182: Log.WriteInfo("ConnectionHandler-> STARTDT CON received");
185: case ConnectionEvent.STOPDT_CON_RECEIVED:
186: Log.WriteInfo("ConnectionHandler-> STOPDT CON received");
190: Log.WriteInfo($"ConnectionHandler-> Unknown event: {connectionEvent}");
196: Log.WriteError($"ConnectionHandler-> Exception: {ex.Message}");
267: ConnectionRequired = false; // 不使用默认连接池
501: int timeoutMs = mappedCmd.TimeoutMs > 0 ? mappedCmd.TimeoutMs : 5000;
607: int timeoutMs = mappedCmd.TimeoutMs > 0 ? mappedCmd.TimeoutMs : 5000;
633: Log.WriteWarning($"DownloadEntryWithRetry-> Timeout ioa={ioa} nof={nof} try={i}/{attempts}");

Administrator UI (DrvIEC104.View)

Configure in Administrator → Communicator. Labels below come from the View language pack.

• View source: ScadaV6CommExt/DrvIEC104.View
• Main forms:
  • FrmAuthSetting.cs
  • FrmDeviceProps.cs
  • FrmDeviceTemplate.cs
  • FrmTemplateSettings.cs

Functional notes and configuration (template and source)

Derived from Logic/Common and device template XML: driver behavior and the Administrator/Communicator fields to set (address, CmdLine, line CustomOptions, template nodes).

Logic location

• ScadaV6CommExt/DrvIEC104.Logic
• Common: DrvIEC104.Common

Overrides

Session(), SendCommand(), OnCommLineTerminate(), InitDeviceTags()

CmdLine / template

• PollingOptions.CmdLine.Trim();

DeviceConfig properties referenced

Line CustomOptions

XML keys (Common)

Code excerpt

111:         {
112:             var address = DeviceConfig.StrAddress;
113:             var hostName = address;
114:             var port = 2404;

271:         #region 主要会话方法
272:         public override void Session()
273:         {
274:             base.Session();

273:         {
274:             base.Session();
275: 
276:             try

318: 
319:             FinishSession();
320:         }
321: 

1639:         #region 显示功能
1640:         public override void InitDeviceTags()
1641:         {
1642:             deviceTemplate = GetDeviceTemplate();

1641:         {
1642:             deviceTemplate = GetDeviceTemplate();
1643:             if (deviceTemplate == null) return;
1644:             // 配置读取公共地址和总召时间

Troubleshooting

• No data: line, address, template, connectivity.
• Template load errors: check logs.
• Options ignored: verify option scope (line vs device).