Frends.Mllp.Receive / 2.1.0

Summary

Listens on a port for HL7 messages framed with MLLP for a bounded period, collecting what arrives and optionally acknowledging each one, with TLS and client certificate checks available.

Typical use — acting as the receiving endpoint for a clinical system that pushes HL7 over a socket rather than HTTP

Details

Frends version: 5.7 and newer
Agent: Crossplatform
Target framework: net8.0

2.1.02026-08-06

Changed

Updated package copyright to comply with Frends task standards.

2.0.02026-06-05

Added

WriteMessagesToFile and MessageOutputDirectory options to handle streaming messages to temp files instead of memory - Output returns file paths. Users are responsible for managing temp files.
MaxConcurrentConnections option to limit simultaneous connections - excess connections are rejected and logged.
MaxMessageSize option to reject oversized messages with a NACK.
EnableLogging, LogFilePath and LogMessageContent options to log message events to a file.
StartBlockByte, EndBlockByte, CarriageReturnByte and CarriageReturnRequired options to configure MLLP framing.
AcknowledgementFormat, AckSenderApplication, AckReceiverApplication, AckHl7Version and AcknowledgementType options to configure ACK/NACK behavior.

Changed

ACK generation now uses only the MSH line instead of full payload - fixes crash on large messages.
Breaking AcknowledgementMessage renamed to AcknowledgementType in Connection and changed from string to AcknowledgementType enum. Valid values: AA, AE, AR.

1.4.02026-05-18

Added

Options.AcknowledgementFormat with Hl7 (default) and ControlByte to configure outbound acknowledgement format.
Options.AcknowledgementByte (default 0x06) for the positive control-byte acknowledgement value.

1.3.02026-05-06

Added

Options.StartBlockByte, Options.EndBlockByte, and Options.CarriageReturnByte to allow configuring MLLP framing bytes (defaults: 11, 28, 13)

1.2.02026-04-17

Added

Connection.ClientCertificateThumbprints property to specify client certificate thumbprints for authentication in MTLS mode

1.1.02026-04-13

Added

Connection.Encoding is now selectable and can be set custom by user

1.0.02026-02-06

Added

Initial implementation