👁 Image
Inheco.SiLA2.Scila.Features 0.10.0-BETA

##SiLA2 Implementation of INHECO SCILA Device

This feature enables the integration of SCILA device in a SiLA2 standard conformed software solutions.

For an introduction about SiLA2 development with C# there is a SiLA2 reference implementation sila_csharp.

The service that implements this SiLA2 feature is called

SiLA2.Scila.Features.Services.ScilaSiLA1Service

The configuration of the service in a SiLA2 Server would follow the pattern described in the sila_csharp reference implementation with additional parameters. NetworkInterfaceName and DeviceIP are required.

"ServerConfig": {
 "Name": "Inheco SiLA2 SCILA Prototype Server",
 "UUID": "CB2CDF15-AB7D-4EC1-B7C8-CD0BCE40135C",
 "FQHN": "localhost", //IP or CIDR or Fully Qualified Host Name
 "Port": 7706,
 "NetworkInterface": "Default",
 "DiscoveryServiceName": "_sila._tcp"
 },
 "CommandLifetimeInSeconds": 60,
 "ServerInfo": {
 "VendorURI": "https://www.inheco.com",
 "Description": "SCILA SiLA2 server implementation.",
 "Version": "7.5.3",
 "Type": "SiLA2ScilaServer"
 },
 "NetworkInterfaceName": "My Ethernet",
 "DeviceIp": "192.168.1.128"
 //"ConnectLockId": "myLockId",
 //"CustomDeviceId": "myDeviceId",
 //"EventReceiverPort": 7071

Internally, the feature connects to a IhcPmsLib.Scila.Scila device (specified by the "DeviceIp" above) which sends DataEvents and StatusEvents to the PMS.

Registration of the services with WebApplicationBuilder (from sila_csharp reference implementation) would include also the following lines:

using static Sila2.Com.Inheco.Scila.Scilasila1.V1.ScilaSiLA1;

...
app.MapGrpcService<ScilaSiLA1Service>();
... 
services.AddSingleton<ScilaSiLA1Service>();
...

In a SiLA2 client application, we could call a SiLA2 command as follows:

private static async Task<GrpcChannel> GetChannel(string[] args) {
 var configBuilder = new ConfigurationBuilder()
 .SetBasePath(Directory.GetCurrentDirectory())
 .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true);
 var configuration = configBuilder.Build();
 var clientSetup = new Configurator(configuration, args);
 ILogger<Program> logger = (ILogger<Program>)clientSetup.ServiceProvider.GetService(typeof(ILogger<Program>));
 var clientConfig = clientSetup.ServiceProvider.GetService<IClientConfig>();
 Console.WriteLine($"Using Server-URI '{clientConfig.IpOrCdirOrFullyQualifiedHostName}:{clientConfig.Port}' from ClientConfig");
 GrpcChannel channel = await ((IGrpcChannelProvider)clientSetup.ServiceProvider.GetService(typeof(IGrpcChannelProvider))).GetChannel(clientConfig.IpOrCdirOrFullyQualifiedHostName, clientConfig.Port, accceptAnyServerCertificate: true);
 return channel;
}

try
{
 var client = new ScilaSiLA1.ScilaSiLA1Client(channel);
 var resGS = client.GetStatus(new GetStatus_Parameters());
 var resGDI = client.GetDeviceIdentification(new GetDeviceIdentification_Parameters());
}
catch (Grpc.Core.RpcException rpcex)
{
 _errorMessage = ErrorHandling.HandleException(rpcex);
}
catch (Exception ex)
{
 _errorMessage = ex.Message;
}