UDP Client for DGI AV Framework

Provides a lightweight client for UDP communications with other devices listening to UDP traffic. If connection is not successful the driver will automatically retry. Connection retry interval is fast in the beginning and (500ms 3 times) and will increase to long intervals (10s after 11 times) . The timing is ideal for applications when the device might not always be online. This way the network is not task with constant UDP connection traffic.

As oppose to the Crestron TCP clients, this driver will not write in the log everytime that a connection was not successful

The driver implements ICommunications for easy interfacing with Devices Drivers.

The constructor takes a configuration file that can be created in the program, or loaded from a JSON file. Loading it from a file needs to be handled by the host application.

It relies entirely on .Net standard libraries.

Structured Logging

This driver accepts a Property of type ILogger to add Serilog as a Dependency Injection. If no property is assigned, the class will log to the Global Logger. If no Global Logger is created, no logging will take place.

This class takes advantage of Serilog's SourceContext, which will Enrich the log with the Class Name. To display it, make sure to add the SouceContext property to your message template.

Logs generated in this class are Verbose, and Debug and Warning. All Exceptions Have Been caught.

A typical Global Logger assigned in the ControlSystem main block will look like this

Log.Logger = new LoggerConfiguration()
    .WriteTo.CrestronConsole(outputTemplate:"[{SourceContext} - {Timestamp:HH:mm:ss} {Level:u3}] {Message:lj}{NewLine}{Exception}" )
    .WriteTo.CrestronErrorLog(outputTemplate:"[{SourceContext} - {Level:u3}] {Message:lj}{NewLine}{Exception}")
    .CreateLogger();