Haukcode.Rdm
6.0.152
dotnet add package Haukcode.Rdm --version 6.0.152
NuGet\Install-Package Haukcode.Rdm -Version 6.0.152
<PackageReference Include="Haukcode.Rdm" Version="6.0.152" />
<PackageVersion Include="Haukcode.Rdm" Version="6.0.152" />
<PackageReference Include="Haukcode.Rdm" />
paket add Haukcode.Rdm --version 6.0.152
#r "nuget: Haukcode.Rdm, 6.0.152"
#:package Haukcode.Rdm@6.0.152
#addin nuget:?package=Haukcode.Rdm&version=6.0.152
#tool nuget:?package=Haukcode.Rdm&version=6.0.152
Haukcode.Rdm
A transport-independent ANSI E1.20 RDM (Remote Device Management) library for .NET (8.0+), with no dependencies beyond the .NET runtime.
- Packet building and parsing for every PID in ANSI E1.20-2025, E1.37-1, E1.37-2, E1.37-7 and the
RDM PIDs of E1.33, as typed classes (
DeviceInfo.Get/DeviceInfo.GetReply, ...) - Complete E1.20 packets (start code 0xCC through checksum) for DMX interfaces, and the RDM data form Art-Net carries
RdmController: GET/SET with reply matching, NACK handling, ACK_TIMER / QUEUED_MESSAGE and ACK_OVERFLOW reassembly, and binary-search discovery (DISC_UNIQUE_BRANCH, DISC_MUTE, DISC_UN_MUTE)- Runs over any transport that implements
IRdmTransport: send one packet, return what came back
Art-Net support lives in Haukcode.ArtNet, which builds on this package.
Using it with your own transport
using Haukcode.Rdm;
using Haukcode.Rdm.Packets.Product;
public class MyInterfaceTransport : IRdmTransport
{
public async Task<RdmTransportResult> SendAsync(ReadOnlyMemory<byte> packet, bool discoveryUniqueBranch, CancellationToken cancellationToken)
{
// Send the complete packet (0xCC ... checksum) and report what happened:
// RdmTransportResult.Reply(replyPacket), .NoReply, .Sent (broadcast),
// .Heard(rawBytes) for DISC_UNIQUE_BRANCH, or .NotSent(reason)
}
}
var controller = new RdmController(new MyInterfaceTransport(), sourceId: new UId(0x7FF0, 0x00000001));
IReadOnlyList<UId> devices = await controller.DiscoverAsync();
foreach (var device in devices)
{
var info = await controller.GetAsync<DeviceInfo.GetReply>(new DeviceInfo.Get(), device);
var label = await controller.GetAsync<DeviceLabel.GetReply>(new DeviceLabel.Get(), device);
Console.WriteLine($"{device}: {label.Label}, footprint {info.DmxFootprint}");
}
License
MIT. Source and issues: https://github.com/HakanL/Haukcode.ArtNet
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- No dependencies.
-
net8.0
- No dependencies.
-
net9.0
- No dependencies.
NuGet packages (1)
Showing the top 1 NuGet packages that depend on Haukcode.Rdm:
| Package | Downloads |
|---|---|
|
Haukcode.ArtNet
ArtNet library for .NET Core (.NET8+) |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 6.0.152 | 225 | 11/17/2026 |
# Changelog
The package version is major.minor from version.json plus the CI run number, so
every push to main publishes a new patch version. Breaking changes bump the
major version. Haukcode.Rdm is versioned with Haukcode.ArtNet, from the same
version.json.
## 6.0 (unreleased) - breaking
The RDM code moves to a new, transport-independent package, **Haukcode.Rdm**,
so RDM can run over transports other than Art-Net (a USB DMX interface first).
Haukcode.ArtNet depends on it and keeps RDM over Art-Net.
- Breaking: the RDM types move from the `Haukcode.ArtNet.Rdm` namespaces to
`Haukcode.Rdm` (`Haukcode.Rdm.IO`, `Haukcode.Rdm.Packets.*`), and `UId`,
`SubDeviceUId` and `DmxStartCodes` move from `Haukcode.ArtNet` to
`Haukcode.Rdm`. Add `using Haukcode.Rdm;` and replace
`Haukcode.ArtNet.Rdm.Packets` with `Haukcode.Rdm.Packets`. `ArtNetRdmClient`
and `RdmEndPoint` stay in `Haukcode.ArtNet.Rdm`.
- Haukcode.Rdm has no package dependencies. It adds `RdmController`, which runs
GET/SET (typed replies, NACK as `RdmNackException`, ACK_TIMER and
ACK_OVERFLOW follow-ups) and discovery over any `IRdmTransport`: send one
complete RDM packet, get back Reply, NoReply, Sent, Heard (raw
DISC_UNIQUE_BRANCH bytes) or NotSent. Discovery un-mutes every device at the
end unless told not to.
- `RdmPacket.WriteFullPacket`, `ReadFullPacket`, `GetPacketData` and
`IsFullPacketValid` handle complete E1.20 packets (start code 0xCC through
checksum); `WritePacketData` writes the form ArtRdm carries.
- `ArtNetRdmClient.RequestAsync` keeps its behavior and now runs on
`RdmController` over the new `ArtNetRdmTransport`; `CreateController` and
`CreateTransport` give an `RdmController` for one node and Port-Address.
The timeout message no longer states the timeout.
## 5.0 (2026-10-20) - breaking
Standards compliance pass against Art-Net 4 and ANSI E1.20-2025.
- Breaking: fields that Art-Net 4 and E1.20 / E1.37-7 define as unsigned are
now ushort/uint, so values with the top bit set no longer read back negative
(for example ArtPollReplyPacket.Oem, EstaCode and FirmwareVersion,
ArtNetDmxPacket.Universe, ArtTriggerPacket.OemCode, RDM parameter IDs,
sub-devices and sensor values). ArtNetUnknownPacket takes ArtNetOpCodes.
- Wire fixes: Art-Net packet layouts and length validation, RDM packets that
sent or parsed the wrong parameter data, RDM response type and Port ID read
from the header, NACK reason length, ArtSync Aux byte order.
- ArtNetClient follows the Art-Net 4 transmit rules and fixes sequence
wrap-around, the loopback filter and destination handling.
- Added the remaining Art-Net 4 packets, ArtPoll targeted mode and the newer
ArtPollReply fields.
- RDM: request workflow and direct-line discovery, a DISC_UNIQUE_BRANCH
encoder/decoder, typed packets for the E1.20-2025 PIDs, E1.20-2025 sensor
types and units, the E1.37-2 IPv4/DNS PIDs, the remaining E1.33 PIDs and the
published E1.37-7 and E1.33 gateway PIDs. All RDM packet types are
registered in RdmPacketFactory.
- RDM robustness: length limits, malformed replies and checksum validation.
- Timecode generator sample: restart and drift fixes.
- The package targets net10.0 and embeds its PDB with SourceLink, so the
debugger can step into the library source (5.0.149 and later).
- Unicast output leaves through the network interface that owns the local
address, not whichever one the routing table prefers. On Linux a host with
two interfaces on one subnet, or with the other interface holding the lower
route metric, sent unicast from the wrong interface (needs Haukcode.Network
1.1.32, Utils.BindToInterfaceOfAddress).
## 4.0 (2026-06-02) - breaking
- RDM correctness: SET NACKs are no longer parsed as successful replies, and
the ProductCategories Control block, SlotIds.ColorSemaphore and
PowerState.Normal values match E1.20.
- Sensor definition and sensor value replies parse to typed packets.
- Breaking: misspelled identifiers renamed (for example SensoreValue to
SensorValue, IdentifyModes.Quit to Quiet, Colour* to Color*), and RDM PIDs
moved to namespaces matching their category.
- Added net10.0.
Later 4.0.x releases:
- Typed ArtTimeCode packet (OpTimeCode 0x9700) and a timecode generator sample.
- Tolerates ArtSync packets without the spare Aux bytes and truncated legacy
ArtPollReply packets.
- Kernel receive timestamps on Linux (KernelReceiveTimestampsObserved).
- Performance: no per-packet allocations on the send and receive paths,
sending sharded by universe, zero-copy DMX data on parse.
- SendFromListenSocketAsync.
## 3.0 (2025-04-24) - breaking
- RDM split into its own assembly, Haukcode.ArtNet.Rdm, shipped in this
package.
Later 3.0.x releases: .NET 10 support, a send-immediately method, and a check
for DMX4ALL custom packets.
## 2.0 (2024-12-12) - breaking
- Rewritten on the Haukcode.HighPerfComm library.
- Later 2.0.x releases: .NET 8 support, binding fix, OpReply data length fix.
## 1.x
- 1.2.2 - Bug fixes
- 1.1.0 - Implemented ArtSync
- 1.0.18 - Fixed bug in RdmPacketFactory
- 1.0.17 - Fixed bug in ArtNetReplyPacket
- 1.0.0 - Initial release