Haukcode.Rdm 6.0.152

dotnet add package Haukcode.Rdm --version 6.0.152
                    
NuGet\Install-Package Haukcode.Rdm -Version 6.0.152
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Haukcode.Rdm" Version="6.0.152" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Haukcode.Rdm" Version="6.0.152" />
                    
Directory.Packages.props
<PackageReference Include="Haukcode.Rdm" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Haukcode.Rdm --version 6.0.152
                    
#r "nuget: Haukcode.Rdm, 6.0.152"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Haukcode.Rdm@6.0.152
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Haukcode.Rdm&version=6.0.152
                    
Install as a Cake Addin
#tool nuget:?package=Haukcode.Rdm&version=6.0.152
                    
Install as a Cake Tool

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 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • 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