/// <summary>
/// Receives the table element data from the calling app (e.g. B2S.Server providing data through the plugin interface).<br/>
/// The received data is put in a queue and the internal thread of the framework is notified about the availability of new data.
/// </summary>
/// <param name="TableElementTypeChar">The table element type char as specified in the TableElementTypeEnum.</param>
/// <param name="Number">The number of the TableElement.</param>
/// <param name="Value">The value of the TableElement.</param>
public void ReceiveData(char TableElementTypeChar, int Number, int Value)
{
InputQueue.Enqueue(TableElementTypeChar, Number, Value);
MainThreadSignal();
ThreadInfoList.HeartBeat("Data delivery");
}
/// <summary>
/// Receives the table element data from the calling app.<br />
/// The received data is put in a queue and the internal thread of the framework is notified about the availability of new data.
/// </summary>
/// <param name="TableElementData">The table element data to be received.</param>
public void ReceiveData(TableElementData TableElementData)
{
InputQueue.Enqueue(TableElementData);
MainThreadSignal();
ThreadInfoList.HeartBeat("Data delivery");
}
/// <summary>
/// This method is constantly beeing executed by the main thread of the framework.<br/>
/// Dont call this method directly. Use the Init and FinishMainThread methods.
/// </summary>
//TODO: Think about implement something which does really check on value changes on tableelements or triggered effects before setting update required.
private void MainThreadDoIt()
{
ThreadInfoList.HeartBeat("DirectOutput");
try
{
while (KeepMainThreadAlive)
{
bool UpdateRequired = false;
DateTime Start = DateTime.Now;
//Consume the tableelement data delivered from the calling application
while (InputQueue.Count > 0 && (DateTime.Now - Start).Milliseconds <= MaxInputDataProcessingTimeMs && KeepMainThreadAlive)
{
TableElementData D;
D = InputQueue.Dequeue();
try
{
DateTime StartTime = DateTime.Now;
Table.UpdateTableElement(D);
UpdateRequired |= true;
UpdateTableElementStatistics(D, (DateTime.Now - StartTime));
}
catch (Exception E)
{
Log.Exception("A unhandled exception occured while processing data for table element {0} {1} with value {2}".Build(D.TableElementType, D.Number, D.Value), E);
ThreadInfoList.RecordException(E);
}
}
if (KeepMainThreadAlive)
{
try
{
//Executed all alarms which have been scheduled for the current time
UpdateRequired |= Alarms.ExecuteAlarms(DateTime.Now.AddMilliseconds(1));
}
catch (Exception E)
{
Log.Exception("A unhandled exception occured while executing timer events.", E);
ThreadInfoList.RecordException(E);
}
}
//Call update on output controllers if necessary
if (UpdateRequired && KeepMainThreadAlive)
{
try
{
Cabinet.Update();
}
catch (Exception E)
{
Log.Exception("A unhandled exception occured while updating the output controllers", E);
ThreadInfoList.RecordException(E);
}
}
if (KeepMainThreadAlive)
{
ThreadInfoList.HeartBeat();
//Sleep until we get more input data and/or a timer expires.
DateTime NextAlarm = Alarms.GetNextAlarmTime();
lock (MainThreadLocker)
{
while (InputQueue.Count == 0 && NextAlarm > DateTime.Now && KeepMainThreadAlive)
{
int TimeOut = ((int)(NextAlarm - DateTime.Now).TotalMilliseconds).Limit(1, 50);
Monitor.Wait(MainThreadLocker, TimeOut); // Lock is released while we’re waiting
ThreadInfoList.HeartBeat();
}
}
}
}
}
catch (Exception E)
{
Log.Exception("A unexpected exception occured in the DirectOutput MainThread", E);
ThreadInfoList.RecordException(E);
}
ThreadInfoList.ThreadTerminates();
}