/// <summary>
/// Initialize frame parser.
/// </summary>
/// <param name="settings">Key/value pairs dictionary parsed from connection string.</param>
private void InitializeFrameParser(Dictionary<string, string> settings)
{
string setting;
// Instantiate protocol specific frame parser
switch (m_phasorProtocol)
{
case PhasorProtocol.IEEEC37_118V2:
case PhasorProtocol.IEEEC37_118V1:
case PhasorProtocol.IEEEC37_118D6:
m_frameParser = new IEEEC37_118.FrameParser(m_checkSumValidationFrameTypes, m_trustHeaderLength, m_phasorProtocol == PhasorProtocol.IEEEC37_118D6 ? DraftRevision.Draft6 : DraftRevision.Draft7);
break;
case PhasorProtocol.IEEE1344:
m_frameParser = new IEEE1344.FrameParser(m_checkSumValidationFrameTypes, m_trustHeaderLength);
break;
case PhasorProtocol.IEC61850_90_5:
m_frameParser = new IEC61850_90_5.FrameParser(m_checkSumValidationFrameTypes, m_trustHeaderLength);
// Check for IEC 61850-90-5 protocol specific parameters in connection string
IEC61850_90_5.ConnectionParameters iecParameters = m_connectionParameters as IEC61850_90_5.ConnectionParameters;
if ((object)iecParameters != null)
{
if (settings.TryGetValue("useETRConfiguration", out setting))
iecParameters.UseETRConfiguration = setting.ParseBoolean();
if (settings.TryGetValue("guessConfiguration", out setting))
iecParameters.GuessConfiguration = setting.ParseBoolean();
if (settings.TryGetValue("parseRedundantASDUs", out setting))
iecParameters.ParseRedundantASDUs = setting.ParseBoolean();
if (settings.TryGetValue("ignoreSignatureValidationFailures", out setting))
iecParameters.IgnoreSignatureValidationFailures = setting.ParseBoolean();
if (settings.TryGetValue("ignoreSampleSizeValidationFailures", out setting))
iecParameters.IgnoreSampleSizeValidationFailures = setting.ParseBoolean();
}
break;
case PhasorProtocol.BPAPDCstream:
m_frameParser = new BPAPDCstream.FrameParser(m_checkSumValidationFrameTypes, m_trustHeaderLength);
// Check for BPA PDCstream protocol specific parameters in connection string
BPAPDCstream.ConnectionParameters bpaPdcParameters = m_connectionParameters as BPAPDCstream.ConnectionParameters;
if ((object)bpaPdcParameters != null)
{
// INI file name setting is required
if (settings.TryGetValue("iniFileName", out setting))
bpaPdcParameters.ConfigurationFileName = FilePath.GetAbsolutePath(setting);
else if (string.IsNullOrWhiteSpace(bpaPdcParameters.ConfigurationFileName))
throw new ArgumentException("BPA PDCstream INI filename setting (e.g., \"inifilename=DEVICE_PDC.ini\") was not found. This setting is required for BPA PDCstream protocol connections - frame parser initialization terminated.");
if (settings.TryGetValue("refreshConfigFileOnChange", out setting))
bpaPdcParameters.RefreshConfigurationFileOnChange = setting.ParseBoolean();
if (settings.TryGetValue("parseWordCountFromByte", out setting))
bpaPdcParameters.ParseWordCountFromByte = setting.ParseBoolean();
if (settings.TryGetValue("usePhasorDataFileFormat", out setting))
bpaPdcParameters.UsePhasorDataFileFormat = setting.ParseBoolean();
}
break;
case PhasorProtocol.FNET:
m_frameParser = new FNET.FrameParser(m_checkSumValidationFrameTypes, m_trustHeaderLength);
// Check for F-NET protocol specific parameters in connection string
FNET.ConnectionParameters fnetParameters = m_connectionParameters as FNET.ConnectionParameters;
if ((object)fnetParameters != null)
{
if (settings.TryGetValue("timeOffset", out setting))
fnetParameters.TimeOffset = long.Parse(setting);
if (settings.TryGetValue("stationName", out setting))
fnetParameters.StationName = setting;
if (settings.TryGetValue("frameRate", out setting))
fnetParameters.FrameRate = ushort.Parse(setting);
if (settings.TryGetValue("nominalFrequency", out setting))
fnetParameters.NominalFrequency = (LineFrequency)int.Parse(setting);
}
break;
case PhasorProtocol.SelFastMessage:
m_frameParser = new SelFastMessage.FrameParser(m_checkSumValidationFrameTypes, m_trustHeaderLength);
// Check for SEL Fast Message protocol specific parameters in connection string
SelFastMessage.ConnectionParameters selParameters = m_connectionParameters as SelFastMessage.ConnectionParameters;
if ((object)selParameters != null)
{
if (settings.TryGetValue("messagePeriod", out setting))
selParameters.MessagePeriod = (MessagePeriod)Enum.Parse(typeof(MessagePeriod), setting, true);
}
break;
case PhasorProtocol.Macrodyne:
m_frameParser = new Macrodyne.FrameParser(m_checkSumValidationFrameTypes, m_trustHeaderLength);
// Check for Macrodyne protocol specific parameters in connection string
Macrodyne.ConnectionParameters macrodyneParameters = m_connectionParameters as Macrodyne.ConnectionParameters;
if ((object)macrodyneParameters != null)
{
ProtocolVersion protocolVersion;
if (settings.TryGetValue("protocolVersion", out setting) && Enum.TryParse(setting, true, out protocolVersion))
macrodyneParameters.ProtocolVersion = protocolVersion;
// INI file name setting is required for 1690G protocol
if (settings.TryGetValue("iniFileName", out setting))
macrodyneParameters.ConfigurationFileName = FilePath.GetAbsolutePath(setting);
else if (macrodyneParameters.ProtocolVersion == ProtocolVersion.G && string.IsNullOrWhiteSpace(macrodyneParameters.ConfigurationFileName))
throw new ArgumentException("Macrodyne INI filename setting (e.g., \"iniFileName=DEVICE_PDC.ini\") was not found. This setting is required for 1690G devices - frame parser initialization terminated.");
// Device label setting is required for 1690G protocol
if (settings.TryGetValue("deviceLabel", out setting))
macrodyneParameters.DeviceLabel = setting;
else if (macrodyneParameters.ProtocolVersion == ProtocolVersion.G && string.IsNullOrWhiteSpace(macrodyneParameters.DeviceLabel))
throw new ArgumentException("Macrodyne device label setting (e.g., \"deviceLabel=DEVICE1\") was not found. This setting is required for 1690G devices - frame parser initialization terminated.");
if (settings.TryGetValue("refreshConfigFileOnChange", out setting))
macrodyneParameters.RefreshConfigurationFileOnChange = setting.ParseBoolean();
}
break;
default:
throw new InvalidOperationException(string.Format("Phasor protocol \"{0}\" is not recognized, failed to initialize frame parser", m_phasorProtocol));
}
// Assign frame parser properties
m_frameParser.ConnectionParameters = m_connectionParameters;
// Setup event handlers
m_frameParser.ReceivedCommandFrame += m_frameParser_ReceivedCommandFrame;
m_frameParser.ReceivedConfigurationFrame += m_frameParser_ReceivedConfigurationFrame;
m_frameParser.ReceivedDataFrame += m_frameParser_ReceivedDataFrame;
m_frameParser.ReceivedHeaderFrame += m_frameParser_ReceivedHeaderFrame;
m_frameParser.ReceivedUndeterminedFrame += m_frameParser_ReceivedUndeterminedFrame;
m_frameParser.ReceivedFrameImage += m_frameParser_ReceivedFrameImage;
m_frameParser.ConfigurationChanged += m_frameParser_ConfigurationChanged;
m_frameParser.ParsingException += m_frameParser_ParsingException;
m_frameParser.BufferParsed += m_frameParser_BufferParsed;
// Only attach to this event if consumer needs buffer image (i.e., has attached to our event)
if ((object)ReceivedFrameBufferImage != null)
m_frameParser.ReceivedFrameBufferImage += m_frameParser_ReceivedFrameBufferImage;
// Start parsing engine
m_frameParser.Start();
}
