Table of Contents

Changelog

[2.9.34] - 2024-10-11

Fixed

  • SmppServer would not accept new connections until the first connection was fully established.
  • Portuguese charset map

Added

  • SmppServerConnectionOptions.SessionInitTimeout - the maximum time allowed between establishing a network connection and sending a bind_transmitter or bind_receiver request to the SMPP server.
  • base classes for TLV parameters: IntParameter and BcdParameter

[2.9.33] - 2024-09-04

Fixed

  • The DisconnectAsync method in the SmppClient is encountering a hanging issue when used with SSL connections in the .NET Framework.

[2.9.32] - 2024-01-26

Changed

  • The extension method SmppClient.SubmitWithRepeatAsync can now queue a batch of SubmitSm requests regardless of the SMPP session state. The queued requests will be sent as soon as the SMPP session is established or restored.

[2.9.31] - 2024-01-16

Fixed

  • The DisconnectAsync method in the SmppClient is experiencing a hanging issue within the .NET Framework.

[2.9.30] - 2023-10-27

Added

  • Add extension method GetMessageBytes for SmppPdu classes.

Fixed

  • Recover the features of SendQueueLimit and ReceivedRequestQueueLimit. The thread should be blocked to prevent excessive memory consumption.

[2.9.29] - 2023-09-12

Added

  • National language shift tables for Portuguese language

[2.9.28] - 2023-08-02

Added

  • support of .NET 6.0
  • new telemetry feature for monitoring and analysis of SMPP operations. Only for applications targeting .NET 6.0 or later.

Fixed

  • SubmitAsync may experience a hang when SendSpeedLimit is utilized and the session becomes disconnected.
  • Memory leak occurs when suppressing the response in the request handler and then sending a new response using the SendResponseAsync method.

[2.9.27] - 2023-04-03

Improved

  • don't block threads when using SendQueueLimit or ReceivedRequestQueueLimit

Fixed

  • throw exception with SocketError.Timeout instead of SocketError.OperationAborted from ConnectAsync when connection timeout

[2.9.26] - 2022-11-25

Improved

  • process responses faster and prevent SMPPCLIENT_RCVTIMEOUT

Changed

  • when ReceivedRequestQueueLimit is specified, a free slot for the request will be added when response is sent

[2.9.25] - 2022-11-13

Improved

  • RetryUntilBindAsync extension method. Retries bind when ESME_RALYBND is received.

Fixed

  • Prevent ObjectDisposedException when request is being sent and SMPP session is closed. SMPPCLIENT_NOCONN response status is returned instead.

[2.9.24] - 2022-10-03

Fixed

  • ResponseTimeout set after bind is not saved for the later session created from the SmppClient instance.

[2.9.23] - 2022-09-28

Added

  • ActualEndpoint property in SmppServer class. Gets the actual endpoint after server start.

Fixed

  • ResponseTimeout not respected if set after connect

[2.9.22] - 2022-08-29

Fixed

  • GsmPackedEncoding. Use CR control as a padding filler.

[2.9.21] - 2022-08-18

Fixed

  • DeliverSm with Receipt encoded with UCS2 data_coding in the message_payload

[2.9.20] - 2022-08-10

Fixed

  • Memory leak around TCP connections

[2.9.19] - 2022-06-06

Changed

  • Initiate TLS connection only when SmppConnectionOptions.Ssl property is defined.

[2.9.18] - 2022-05-19

Added

  • SmppOutbindClient class that can establish SMPP session with ESME using Outbind command.
  • SmppOutbindServerClient class, that passed down to the evClientOutBind event in the SmppServer class.
  • SmppOutbindServerClient has evDeliverSm event that can be used to receive outstanding messages from SMSC.

[2.9.17] - 2022-04-12

Added

  • Extension method SmppClient.RetryUntilBindAsync

[2.9.16] - 2022-01-20

Added

  • Response time metrics

Fixed

  • ReceivedRequestQueueLimit doesn't work
  • sometimes SubmitAsync hangs when the server drops the connection

[2.9.15] - 2022-01-11

Changed

  • SmppServer is now sealed class
  • Remove unused CancellationToken parameter from SmppServer.StopAsync method
  • default SmppClientBase.ReceiveTaskScheduler to TaskScheduler.Default

Improved

  • Performance for developer version

Fixed

  • several warnings in the code

[2.9.14] - 2021-08-31

Fixed

  • NullReferenceException warning on accepting connection when server disconnects the newly connected client.
  • SmppClientBase.Dispose doesn't free internal objects when connection is already closed.

[2.9.13] - 2021-07-30

Fixed

  • endless repetition of sending in the SubmitWithRepeatAsync extension method

[2.9.12] - 2021-07-01

Fixed

  • unnecessary delay on success submit in the SubmitWithRepeatAsync extension method
  • The metric client.Metrics.Sent.Requests.PerSecond reports incorrect results.

[2.9.11] - 2021-06-24

Fixed

  • When client disconnects the PDU packets that already received from network stream must be processed.
  • Better logging for disconnect routine
  • When client receives corrupted response PDU with readable SMPP Header and non-ok status, return this response in corresponding method and write the warning into the log.

[2.9.10] - 2021-06-12

Fixed

  • SmppClient. memory leak in SMPP connection.
  • SmppClient. Deadlock on disconnection in Windows Forms application for in .NET Framework.

[2.9.9] - 2021-05-13

Fixed

  • Performance. Default buffer size was 4096 bytes. This significantly reduces the throughput. Now default buffer size is 65536 for send and receive.
  • SmppServer. SendBufferSize and ReceiveBufferSize properties changed in SmppServerClient in evClientConnected event handler are not applied to Socket buffer size.
  • SmppServer. SmppServer may hang when stopped.
  • SmppServer. Missing binds after failed accept connection.
  • SmppClient. When remote side drops the connection, the response status SMPPCLIENT_RCVTIMEOUT maybe returned instead of SMPPCLIENT_NOCONN.
  • SmppClientBase. Don't disconnect when remote side doesn't response on our EnquiryLink request, but send any other request PDU.

[2.9.8] - 2021-04-28

Fixed

  • wrong User Data Length with 16-Bit concatenation

[2.9.7] - 2021-04-12

Fixed

  • Developer License. Unable to cast object of type 'System.Security.Cryptography.RSACng' to type 'System.Security.Cryptography.RSACryptoServiceProvider'

[2.9.6] - 2021-04-09

Added

  • Tag property to SmppClientBase class to associate any data with the client.

[2.9.5] - 2021-03-18

Added

  • SmppClient.SubmitWithRepeatAsync extension method for sending single SubmitSm.
  • SmppClient.ConnectAsync(SmppConnectionOptions) method with extended connection options
  • SmppConnectionOptions.SinglePDUinTCPPacket allows to send each PDU in single TCP packet
  • new async methods in SmppServer class: StartAsync, StopAsync, RunAsync

Fixed

  • SmppServerClient.Status is Closed in the event SmppServer.evClientConnected
  • InvalidOperationException on SmppServer.Stop

[2.9.4] - 2021-02-06

Fixed

  • Incorrect length of ShortMessage for the first part in the concatenated message when using NationalLanguageSingleShift user data header.

[2.9.3] - 2021-02-04

Fixed

  • Delivery Receipt parsing

[2.9.2] - 2021-02-01

Fixed

  • Incorrect length of ShortMessage for concatenated message part when using NationalLanguageSingleShift user data header.

[2.9.1] - 2021-01-29

Fixed

  • SmppServerClient.RemoteEndPoint is null when client connection is accepted.

[2.9.0] - 2021-01-25

Added

  • MMS m-notification-ind and m-delivery-ind over SMPP
  • WorkersTaskScheduler class creates worker threads to handle received requests for a client.
  • ReceiveTaskScheduler property in SmppClientBase class. Received requests can be handled in individual or global TaskScheduller or in standard TaskScheduler.Default. By default client uses WorkersTaskScheduler with 3 worker threads.
  • RetryUntilConnectedAsync extension method for SmppClient class that helps to establish connection when a SMPP server is temporary unreachable.
  • SubmitBatchAndWaitForDeliveryAsync extension method for SmppClient class that helps to submit a batch of SubmitSm PDUs and receive all delivery receipts.
  • SubmitWithRepeatAsync extension method that help to repeat the SubmitSm requests on disconnection or unsuccess reponse status.

Changed

  • Target Framework changed from .NET 4.5.2 to .NET 4.6.1
  • SmppClientBase.SendQueueLimit limits a number of requests waiting for response. When this limit is exceeded, SubmitAsync method is blocked until queue has a free slot.
  • Less GC pressure by reusing reading buffer.
  • Improve DeliverReceipt deserialization when received PDU has wrong DataCoding.
  • Deliver receipt serializer enriches DeliverSm PDU with optional parameters (MessageState, ReceiptedMessageId, NetworkErrorCode) only when PDU was not received from remote side.
  • Throws GenericNackSmppException when GENERICK_NACK response received in Submit methods.
  • Throws ObjectDisposedException when trying to call public method on disposed classes SmppClientBase, SmppClient, SmppServerClient
  • New implementation of SMPP connection that frees all used resources after disconnect.
  • Improved batch submit. Send several PDUs in one TCP packet.

Fixed

  • ArgumentNullException in MessageComposer by adding a PDU with empty text
  • SmppClientBase.SendSpeedLimit sends more than allowed PDUs when run SubmitAsync in tasks.
  • GSMEncoding returns wrong number of bytes for Turkish charset when both NationalLanguageLockingShift and NationalLanguageSingleShift are specified.
  • Text splitting. The maximum length of the short_message field is not used if NationalLanguageSingleShift is enabled.

Removed

  • evConnected event from SmppClientBase class. SmppClient is connected after call of the method ConnectAsync or on the event evRecoverySucceeded. SmppServer has own method evClientConnected.
  • Obsolete properties from PDU classes.
  • QueueState class and SmppClientBase.Queue property. Use SmppClientBase.Metrics instead.
  • SmppClientBase.WorkerThreads property. Set the SmppClientBase.ReceiveTaskScheduler property to the instance new WorkersTaskScheduler(3).

[2.8.6] - 2020-11-19

Fixed

  • CancelSm serialization

[2.8.5] - 2020-11-12

Fixed

  • NationalLanguageLockingShift user data header

[2.8.4] - 2020-11-12

Breaking Changes

  • license file Inetlab.SMPP.license must contain product name. Generate new license file in your Inetlab Account.

Fixed

  • write license loading errors in license status.

[2.8.3] - 2020-11-04

Fixed

  • failed to verify license on macos

[2.8.2] - 2020-09-01

Fixed

  • inaccurate SendSpeedLimit on the machine with high-resolution performance counter.

[2.8.1] - 2020-06-16

Fixed

  • SendSpeedLimit and result speed has significant difference.
  • Send Queue can be blocked in some edge cases.
  • Reconnect doesn't start when ThreadPool is overloaded
  • Race condition in MessageComposer causes NullReferenceException

[2.8.0] - 2020-04-02

Added:

  • SendResponseAsync method in SmppClientBase class. Response sending can be prevented in a event handler by changing it to null. req.Response = null;
  • Extension method CanBeEncoded to validate an Encoding for given text message
  • MessageComposer with persistence storage interface to save message parts in external database instead of memory.

Fixed:

  • NullReferenceException in the event evFullMessageReceived of MessageComposer class
  • Setup Project: Unable to update the dependencies of the project. The dependencies for the object 'Inetlab.SMPP.dll' cannot be determined.

[2.7.1] - 2020-01-20

Changed

  • move InterfaceVersion property to the SmppClientBase class

Fixed:

  • GenericNack PDU has not been sent when wrong PDU header is received.

[2.7.0] - 2019-12-11

Added

  • Added Metrics property for SmppClientBase class.
  • Support of 16 bit concatenation parameters in SMS builder classes.

Changed

  • ReceiveSpeedLimit with rate limiting. Measure PDU count for defined time unit instead of interval between PDUs.
  • rename async-methods according to the dotnet naming conventions
  • InactivityTimeout starts when SmppServerClient is connected and EnquireLinkInterval is not defined for this client.
  • Generate long number MessageId for SubmitSmResp and SubmitMultiResp. According to SMPP Protocol MessageId should contain only digits.
  • Timeout timer in MessageComposer restarts when next segment of the message is received.

Fixed

  • Submit hangs after unexpected disconnect.
  • Exception by changing send or receive buffer size.
  • SmppTime.Format for relative time.
  • OverflowException in GSMEncoding.

Removed

  • Support of .NET Standard 1.4
  • InactivityTimeout from SmppClient

[2.6.14] - 2019-09-20

Fixed

  • SmppTime.Format for relative time.
  • exception in demo applications

[2.6.13] - 2019-08-14

Fixed

  • multithread-issue with ConnectedClients in SmppServer class
  • set SmppClient.SystemID and SmppClient.SystemType properties when client is bound.

[2.6.12] - 2019-07-26

Added

  • convert UserDataHeader to and from byte array
  • SmppTime functions for formatting and parsing scheduled delivery times and expiry times in PDU.
  • EnsureReferenceNumber method that sets next reference number for a list of concatenated PDUs.
  • property InactivityTimeout in the class SmppClientBase. Default is 2 minutes. Connection will be dropped when in specified period of time no SMPP message was exchanged. InactivityTimeout doesn't work when EnquireLinkInterval is defined.

Fixed

  • SmppServer: when client.ReceiveSpeedLimit is set to any value, first message is always throttled.
  • text splitting: Incorrect message length of 1st PDU when text encoded in GSM encoding and contains extended characters
  • ReferenceNumber=0 for submitted concatenated PDUs.

[2.6.11] - 2019-04-20

Fixed

  • Connection failed. Error Code: 10048. Only one usage of each socket address (protocol/network address/port) is normally permitted. Occurs when call Connect method from different threads at the same time.

[2.6.10] - 2019-04-19

Fixed

  • exceptions by incorrect disconnect.

[2.6.9] - 2019-04-15

Fixed

  • Request property is null in received response PDU class.

Added

  • ReceiveBufferSize and SendBufferSize properties for SmppClientBase.

[2.6.8] - 2019-03-27

Fixed

  • wrong text splitting in SMS builder for GSMPackedEncoding.

[2.6.7] - 2019-03-27

Fixed

  • StackOverflowException by submitting array of SubmitMulti.
  • destination addresses serialization for SubmitMulti
  • short message length calculation

[2.6.6] - 2019-03-25

Fixed

  • exception in GetMessageText method for DeliverSm with empty text.

[2.6.5] - 2019-03-18

Fixed

  • exception in GetMessageText method for DeliverSm without receipt.

[2.6.4] - 2019-03-15

Fixed

  • missed last character in the last segment of the concatenated message created with SMS builders.

Added

  • Extension method smppPdu.GetMessageText(EncodingMapper) as replacement for MessageText property in a PDU class.
  • TLVCollection.RegisterParameter(ushort tag) method for registering custom TLV parameter type for any tag value. It helps to represent some complex parameters as structured objects. Example: var parameter = pdu.Parameters.Of();

Changed

  • MessageText property in PDU classes is obsolete. Use the function client.EncodingMapper.GetMessageText(pdu) or pdu.GetMessageText(client.EncodingMapper) to get th message text contained in the PDU.

[2.6.3] - 2019-03-04

Fixed

  • failed to raise some events with attached delegate that doesn't has target object.

Improved

  • FileLogger multi-threading improvements.

[2.6.2] - 2019-02-07

Added

  • ILogFactory interface with implementations for File and Console

Fixed

  • client hangs by Dispose when it was never connected

[2.6.1] - 2019-02-04

Fixed

  • Cannot send 160 characters in one part SMS in GSM Encoding

[2.6.0] - 2019-01-14

Added

  • ProxyProtocolEnabled property for SmppServerClient class. This property should be enabled in evClientConnected event handler to detect proxy protocol in the network stream of connected client.
  • Signed with Strong Name
  • ClonePDU, Serialize methods for SmppPDU classes.
  • SMS.ForData method for building concatenated DataSm PDUs.
  • SMS.ForDeliver is able to create delivery receipt in MessagePayload parameter.

Fixed

  • SmppServer stops accepting new connections by invalid handshake
  • Text splitter for building concatenated message parts
  • Event evClientDataSm didn't raise in the SmppServer.
  • Sometimes SmppServerClient doesn't disconnect properly in SmppServer
  • concurrency issues in MessageComposer
  • library sends response with status ESME_ROK when SmppServer has no attached event handler for a request PDU. It should send unsuccess status f.i. ESME_RINVCMDID.

API Changes

  • Replaced methods AddMessagePayload, AddSARReferenceNumber, AddSARSequenceNumber, AddSARTotalSegments and AddMoreMessagesToSend with corresponding classes in Inetlab.SMPP.Parameters namespace.
  • Renamed the property "Optional" to "Parameters" in PDU classes. (backwards-compatible)
  • Removed unnecessary TLV constructor with length parameter. Length is always equal to value array length.
  • Removed ISmppMessage interface
  • Renamed namespace Inetlab.SMPP.Common.Headers to Inetlab.SMPP.Headers
  • Rename propery UserDataPdu to UserData for classes SubmitSm, SubmitMulti DeliverSm, ReplaceSm. (backwards-compatible)
  • MessageInPayload method tells SMS builder to send complete message text in message_payload parameter. With optional messageSize method parameter you can decrease the size of message segment if you need to send concatenation in SAR parameters.
  • Simplified ILog interface

[2.5.4] - 2018-09-16

Changed

  • MessageComposer.Timeout property to TimeStamp

Added

  • SmppClient.Submit methods with IEnumerable parameter
  • better documentation

Fixed

  • Hanlde SocketException OperationAborted when server stops

[2.5.3] - 2018-09-08

Fixed

  • SubmitSpeedLimit is ignored
  • sometimes SMPP PDU reading is failed

[2.5.2] - 2018-08-06

Fixed

  • Messages with data coding Class0 (0xF0) are split up in wrong way

[2.5.1] - 2018-07-30

Fixed

  • wrong BindingMode for SmppServerClient after Unbind.

[2.5.0] - 2018-07-29

Added

Implemented

  • Unbind logic for SmppClient and SmppServerClient classes

[2.4.1] - 2018-06-19

Fixed

  • issue with licensing module

[2.4.0] - 2018-05-30

Added

  • Automatic connection recovery.

[2.3.2] - 2018-04-20

Added

  • MessageComposer allows to get its items for concatenated messages.

Changed

  • creation for user data headers types.

[2.3.1] - 2018-04-18

Fixed

  • PDU reader and writer
  • split text on concatenation parts

[2.3.0] - 2018-03-18

Added

  • SmppClientBase.SendQueueLimit limits the number of sending SMPP messages to remote side. Delays further SMPP requests when limit is exceeded.

Changed

  • SmppServerClient.ReceiveQueueLimit replaced with SmppClientBase.ReceivedRequestQueueLimit

Improved

  • improved: processing of connect and disconnect.

[2.2.0] - 2018-02-01

Improved

  • better processing of request and response PDU

Changed

  • Flow Control. SmppServerClient.ReceiveQueueLimit defines allowed number of SMPP requests in receive queue. If receive queueu is full, library stops receive from network buffer and waits until queue has a place again. It is better alternative for ESME_RMSGQFUL response status.

Fixed

  • MessageComposer raises evFullMessageReceived sometimes two times by processing concatenated message with two parts.

[2.1.2] - 2017-12-11

Improved

  • internal queue for processing PDU.

[2.1.1] - 2017-12-10

Improved

  • processing of connect and disconnect

Added

  • From and To methods with SmeAddress parameter to SMS Builders

[2.1.0] - 2017-10-18

Added

  • SendSpeedLimit property for SmppClientBase class, that limits number of requests per second to remote side
  • Priority processing for response PDUs.
  • Name property to distinguish instances in logger
  • Deliver method in SmmpServerClient class
  • SubmitData method in SmppClientBase class

[2.0.1] - 2017-10-06

Added

  • decode receipt for IntermediateDeliveryNotification

Fixed

  • sequence number generation

[2.0.0] - 2017-08-15

  • first version for .NET Standard 1.4