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 (kontoadminlubuserz 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ściaOutputCount+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ść
TurnOnAsyncwysyłaon=x&bistab— wymusza tryb bistabilny, wyjście zostaje załączone,PulseAsyncwysyłaon=x&ton=czas&toff=opóźnienie(jednostka 0,1 s) i przestawia kanał w tryb TimeBased; kolejneTurnOnAsyncprzywraca tryb bistabilny,TriggerAsyncwysyła samoon=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 od0= 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.
.NET 8.0
- Microsoft.Extensions.Http (>= 8.0.1)
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.2)
| Version | Downloads | Last updated |
|---|---|---|
| 8.0.1 | 12 | 10/12/2026 |