tik4net 4.0.0-alpha
Full release notes and version history: Wiki → History
What's new in 4.0
9 new connection types — all implement the same ITikConnection / LoadAll<T>() / Save<T>() interface:
| Type | Transport | Port | Notes |
|---|---|---|---|
Rest / RestSsl
| HTTP/HTTPS | 80/443 | RouterOS 7.1+, CRUD only |
Telnet
| TCP | 23 | plain-text terminal |
MacTelnet
| UDP broadcast | 20561 | Layer-2, no IP needed |
WinboxCli
| TCP | 8291 | WinBox terminal over TCP |
WinboxCliMac
| UDP | 20561 | WinBox terminal over MAC |
WinboxNative
| TCP | 8291 | native M2 binary protocol, full CRUD + streaming |
WinboxNativeMac
| UDP | 20561 | native M2 over MAC |
Ssh (satellite)
| TCP | 22 | requires tik4net.ssh NuGet
|
Other additions:
- Change tracking —
tik4net.entitiestracks which properties changed;Save<T>()sends only the diff - Safe Mode —
TakeSafeMode()/ReleaseSafeMode()across all transports; auto-rollback on disconnect - Streaming monitors —
ExecuteAsync/LoadListenAsyncfor live data (WinBox Native;listenpoll+diff on other transports) TikConnectionSetup— unified connection builder with all transport-specific options- Connection capability model —
connection.Supports(TikConnectionCapability.Listen)etc. - Raw command pass-through —
ExecuteRawfor commands not covered by the O/R mapper - WinBox GUI-name addressing — address entities by their WinBox display name on
WinboxNative
Breaking changes (from 3.6)
- Exception hierarchy unified —
TikCommandExceptionsubtypes restructured; reviewcatchblocks that catch specific exception types - SSH is now a satellite package — add
tik4net.sshand callTik4NetSsh.Register()at startup (the oldTikConnectionType.Sshstub is still in the enum but now routes to the satellite) TikConnectionType.Api_v2/ApiSsl_v2— already[Obsolete(error)]in 3.6, unchanged in 4.0; remove any remaining usages
NuGet packages
| Package | Install |
|---|---|
tik4net
| dotnet add package tik4net --version 4.0.0-alpha
|
tik4net.entities
| dotnet add package tik4net.entities --version 4.0.0-alpha
|
tik4net.ssh (satellite, opt-in)
| dotnet add package tik4net.ssh --version 4.0.0-alpha
|
tik4net.testing
| dotnet add package tik4net.testing --version 4.0.0-alpha
|
tik4net.mcp (dev/debug helper tool)
| dotnet tool install -g tik4net.mcp --version 4.0.0-alpha
|
Tools (in zip asset)
tik4net.entitygenerator.exe— generate entity code from a live routertik4net.entityWikiImporter.exe— generate entity code from MikroTik wiki
Full Changelog: v3.6.0...v4.0.0-alpha