ITBees.Lantic 8.0.1

ITBees.Lantic

Biblioteka .NET 8 do obsługi modułów I/O Inveo LanTick po Ethernecie: przekaźniki (PE-8-0, PE-16-0, PE-4-4, …) i wejścia cyfrowe (PE-0-4, PE-0-8, …).

Komunikacja: HTTP GET na wbudowany serwer WWW modułu (port 80).

  • GET /status.xml — stan wyjść/wejść/liczników, bez autoryzacji (tylko odczyt),
  • GET /names.xml — nazwy kanałów, bez autoryzacji,
  • GET /stat.php?... — komendy sterujące, HTTP Basic Auth (konto admin lub user z panelu WWW).

Fabrycznie: IP 192.168.111.15, login admin, hasło admin00.

Funkcje

Obszar API
Logowanie (weryfikacja loginu/hasła + odczyt modelu, stanu, nazw kanałów) LoginAsync()
Health check (osiągalność, czas odpowiedzi, poprawność hasła) CheckHealthAsync()
Odczyt stanu wyjść / wejść / liczników GetStatusAsync() → LantickStatus
Nazwy kanałów GetChannelNamesAsync()
Załącz / wyłącz / przełącz wyjście TurnOnAsync, TurnOffAsync, SetOutputAsync, ToggleAsync
Impuls (np. otwarcie szlabanu) z opcjonalnym opóźnieniem PulseAsync(output, duration, delay)
Miganie (tryb astabilny, np. lampa ostrzegawcza) BlinkAsync(output, on, off)
Wyzwolenie wg trybu ustawionego w panelu WWW TriggerAsync(output)
Wiele wyjść jednym żądaniem SetOutputsAsync(dict), SetAllOutputsAsync(bool)
Liczniki (kanał urządzenia / wejście IN1..INn) SetCounterAsync(channel, value), SetInputCounterAsync(input, value), ResetInputCounterAsync(input)
Rolety / bramy (para przekaźników) ControlShutterAsync, SetShutterPositionAsync
Symulacja wejść SetInputSimulationAsync(bool)
Log diagnostyczny (ostatnie N żądań, czasy, kody HTTP, błędy) client.Diagnostics
Monitor stanu (polling, zdarzenia zmian wejść/wyjść, online/offline) LantickStatusMonitor
Wyszukiwanie modułów w sieci LantickDiscovery.ScanSubnetAsync("192.168.1.0/24")

Każda komenda sterująca zwraca stan modułu odczytany zaraz po jej wykonaniu.

Przykład

using ITBees.Lantic;

using var client = new LantickClient(new LantickConnectionOptions
{
    Host = "192.168.1.103",
    Username = "admin",
    Password = "<hasło>",
});

var info = await client.LoginAsync();              // LantickAuthenticationException przy złym haśle
Console.WriteLine($"{info.Model} {info.ProductName}");   // PE-8-0 Lantick-8-0

await client.PulseAsync(1, TimeSpan.FromMilliseconds(800)); // impuls 0,8 s na OUT1 (szlaban)
await client.TurnOnAsync(2);                                 // OUT2 załączone na stałe
await client.BlinkAsync(3, TimeSpan.FromMilliseconds(500), TimeSpan.FromMilliseconds(500));

var status = await client.GetStatusAsync();
Console.WriteLine(status);                                   // PE-8-0 OUT[1:0 2:1 3:1 ...]

foreach (var entry in client.Diagnostics.GetEntries())
    Console.WriteLine(entry);   // 13:40:01.120 192.168.1.103 TurnOn(2) /stat.php?on=2&bistab -> 200 35ms OK

DI

services.AddLantick();                       // ILantickClientFactory (singleton) + nazwany HttpClient
...
using var client = factory.Create(new LantickConnectionOptions { Host = ip, Password = pass });

Monitor wejść (np. pętle indukcyjne na PE-0-4)

await using var monitor = new LantickStatusMonitor(client, TimeSpan.FromMilliseconds(250));
monitor.StatusChanged += (_, e) =>
{
    foreach (var input in e.ChangedInputs)
        Console.WriteLine($"IN{input.Number} = {input.IsActive}");
};
monitor.ConnectionChanged += (_, e) => Console.WriteLine(e.IsConnected ? "online" : $"offline: {e.Error?.Message}");
monitor.Start();

Zweryfikowane na sprzęcie

Model prod_name / names.xml Co sprawdzono
PE-8-0 (192.168.1.103) Lantick-8-0 / LantickPro-8-0 odczyt stanu i nazw, discovery, kolejność bitów (<out>: ostatni znak = OUT1), tryb impulsowy (ton = czas impulsu, toff = opóźnienie; w czasie opóźnienia <on>=1, styk <out>=0)
PE-0-4 (192.168.1.62) Lantick-0-4 / LantickPro-0-4 odczyt stanu (4 wejścia, brak wyjść), nazw, discovery

Modele i numeracja kanałów

Nazwa modelu to PE-{wyjścia}-{wejścia}. Model jest rozpoznawany automatycznie z prod_name (Lantick-8-0, LantickPro-8-0, Lantick-PE-2-2), można go też podać w LantickConnectionOptions.Model.

  • wyjścia mają numery kanałów 1..OutputCount, wejścia OutputCount+1..OutputCount+InputCount (np. PE-4-4: OUT1-4 = kanały 1-4, IN1-4 = kanały 5-8; PE-0-4: IN1-4 = kanały 1-4) — tak numeruje je urządzenie (liczniki, cnt=; instrukcja: „numery wejść zaczynają się od PE-2-2 x=3,4, PE-4-4 x=5..8”),
  • w API wyjścia i wejścia mają własną numerację od 1 (TurnOnAsync(1) = OUT1, status.GetInput(1) = IN1),
  • ciągi bitów w status.xml (<out>, <on>, <in>) czytane są od prawej: ostatni znak = kanał 1 (potwierdzone w instrukcji przykładem ?set=1110n01n).

<out> = faktyczny stan styku przekaźnika (IsCoilActive), <on> = kanał załączony (IsOn); różnią się np. w trybie astabilnym.

Uwagi o trybach wyjść

  • TurnOnAsync wysyła on=x&bistab — wymusza tryb bistabilny, wyjście zostaje załączone,
  • PulseAsync wysyła on=x&ton=czas&toff=opóźnienie (jednostka 0,1 s) i przestawia kanał w tryb TimeBased; kolejne TurnOnAsync przywraca tryb bistabilny,
  • TriggerAsync wysyła samo on=x — kanał zadziała wg trybu skonfigurowanego w panelu WWW.

Narzędzie CLI (testy na urządzeniu)

dotnet run --project ITBees.Lantic.Cli -- discover 192.168.1.0/24
dotnet run --project ITBees.Lantic.Cli -- status 192.168.1.103
LANTICK_PASSWORD=*** dotnet run --project ITBees.Lantic.Cli -- login 192.168.1.103
LANTICK_PASSWORD=*** dotnet run --project ITBees.Lantic.Cli -- pulse 192.168.1.103 1 800

Hasło: zmienna LANTICK_PASSWORD (albo pytanie w konsoli), login: LANTICK_USER (domyślnie admin).

Do zweryfikowania na kolejnych modelach

  • pozycja bitów wejść w <in> przy aktywnym wejściu (przyjęto numer kanału urządzenia, czytany od prawej jak <out>) — wymaga podania sygnału 10–24 V DC na wejście PE-0-4 (lantick watch 192.168.1.62),
  • znaczenie elementu <insim> gdy symulacja jest włączona (przyjęto: niepusty i różny od 0 = aktywna).

Protokoły nieobsługiwane (na razie): Modbus TCP (port 502), binarny/tekstowy TCP/UDP (port 9761), SNMP, KNX.

No packages depend on ITBees.Lantic.

Version Downloads Last updated
8.0.1 12 10/12/2026