Beckhoff.TwinCAT.Ads 7.0.389

• .NETStandard 2.0

  • Beckhoff.TwinCAT.Ads.Server (>= 7.0.389)
  • Microsoft.Extensions.Logging.Abstractions (>= 3.1.0)
  • System.Buffers (>= 4.5.1)
  • System.ComponentModel.Composition (>= 4.5.0)
  • System.Memory (>= 4.5.5)
  • System.Numerics.Vectors (>= 4.5.0)
  • System.Reactive (>= 5.0.0)
  • System.Runtime.CompilerServices.Unsafe (>= 4.7.1)

• net10.0

  • Beckhoff.TwinCAT.Ads.Server (>= 7.0.389)
  • Microsoft.Extensions.Logging.Abstractions (>= 10.0.12)
  • System.ComponentModel.Composition (>= 10.0.12)
  • System.Reactive (>= 6.1.0)

• net8.0

  • Beckhoff.TwinCAT.Ads.Server (>= 7.0.389)
  • Microsoft.Extensions.Logging.Abstractions (>= 8.0.3)
  • System.ComponentModel.Composition (>= 8.0.0)
  • System.Reactive (>= 6.1.0)

### 7.0.382
Fix: Cached variable handles are dropped on all value accessors when the target reports them as stale, so value access recovers after a target restart, #333367
### 7.0.370
Fix: The symbol loader no longer re-uploads the complete data type table on every access to the Namespaces and BuildInTypes properties. Namespaces evaluated its cache guard inverted, and BuildInTypes never registered its cache marker on targets that deliver their base types within the data type stream, which is every current TwinCAT 3 runtime, #333127, #333128
Enh: The symbol loader now logs every completed data type and symbol upload at Information level, including the number of entries, the transferred size and the target address. The asynchronous load path previously bypassed ILogger entirely
Fix: AdsClientSettings(int timeout) initialized a temporary object instead of the instance being constructed, so the timeout argument was ignored and the client silently used 5000 ms without the default FailFast interceptor, #333207
Fix: The symbol and data type uploads no longer inherit a short client timeout. Only the synchronous symbol upload raised the connection timeout for the duration of the transfer, so a client configured with e.g. 200 ms could fail during connect because each 64 KB block had to be read within that time. The asynchronous upload info request no longer applies a separate 30 s deadline either and now obeys the configured connection timeout like its synchronous counterpart, #333208
### 7.0.361
Fix: AdsClient no longer accepts an ADS confirmation that originates from a different target than the one it is connected to, #332724
Fix: InvokeIDs are now unique per process instead of per client instance, so two clients sharing an AMS port cannot produce colliding IDs, #332724
Enh: The AMS client port and target address are now part of the request timeout, request failure and confirmation warnings, so they can be attributed to a client instance without enabling Debug logging, #332724
Fix: Synchronous reads of a 'REFERENCE TO' symbol used the pointer size instead of the size of the referenced type, so ReadValue failed where ReadValueAsync succeeded, #332792
Fix: The symbol loader no longer re-reads the SymbolUploadInfo from the target on every asynchronous access, halving the number of upload info requests per symbol load, #333053
### 7.0.355
Fix: AdsClient no longer accepts an ADS confirmation that originates from a different target than the one it is connected to, #332724
Fix: InvokeIDs are now unique per process instead of per client instance, so two clients sharing an AMS port cannot produce colliding IDs, #332724
Enh: The AMS client port and target address are now part of the request timeout, request failure and confirmation warnings, so they can be attributed to a client instance without enabling Debug logging, #332724
Fix: Synchronous reads of a 'REFERENCE TO' symbol used the pointer size instead of the size of the referenced type, so ReadValue failed where ReadValueAsync succeeded, #332792
### 7.0.342
Fix: Unregistering the AdsStateChanged notification no longer asserts when the target cannot be reached, #331880
### 7.0.331
Fix: Members created from a bit data type (e.g. BitMappingType) keep their BitValue flag / IsBitType, so bit members of programmatically created StructTypes are packed, addressed and uploaded as bits, #328844
Fix: IMemberCollection.CalcSize() derives the collection size from the member offsets instead of summing the member sizes, so padding and bit packing are taken into account, #328844
Fix: StructType(name, baseType, fields) takes over the passed fields as aligned members instead of only deriving its size from them and leaving Members empty. Members that are already aligned within another type are rejected with an ArgumentException, #328844
### 7.0.306
Fix: Hardened the symbol and datatype upload parser against malformed or malicious upload blocks. Excessively nested datatype entries, invalid entry lengths and inconsistent sub-entry counts are now rejected instead of terminating the process with a StackOverflowException or looping endlessly, #321938
Enh: Reviewed the SumCommand API. The raw SumCommands SumRead, SumWrite and SumReadWrite including their ReadRaw/WriteRaw/ReadWriteRaw methods are now part of the documented API surface, every SumCommand offers a static Create(connection) factory returning a fluent builder that collects the sub commands entry by entry, and the missing raw read by instance path SumInstancePathAnyTypeRead.ReadRaw/ReadRawAsync was added. The existing constructors stay available, the plumbing constructors taking a SumDataEntry list stay hidden, #322397
BreakingChange: Renamed the SumCommand entity types to the Entry vocabulary already used by SumHandleEntry (e.g. SumDataEntity -> SumDataEntry, IgIoSumReadEntity -> IgIoSumReadEntry). All affected types are marked with EditorBrowsable(Never) and excluded from the documentation, #322399
Fix: Corrected several SumCommand defects. Truncated device responses now fail with a DeviceInvalidSize AdsErrorException instead of an ArgumentOutOfRangeException, SumReadWrite supports IndexGroup/IndexOffset addressed entries in the discrete fallback mode, the SumRead constructors taking an IList<IgIoSumReadEntry> no longer throw an InvalidCastException, SumHandleReadAnyType keeps the configured string length, SumAnyTypeRead.Read2 no longer fails in the discrete fallback mode with a MarshalException, and the wrong or copy/pasted XML documentation of the raw write methods, the notification command constructors and ResultSumHandles was fixed, #322397
### 7.0.286
Fix: SumReadWrite (ReadWriteList) result parser now validates per-result lengths from the server response against the remaining reply buffer and the client-requested size before slicing. A malicious or tampered server can no longer cause an uncaught exception or desync the result offset.
### 7.0.280
Fix: Issue starting communication with 32-Bit TwinCAT (hanging on TcpLoopback)
### 7.0.270
Fix: IAdsSymbolLoader.Dispose() throws InvalidCastException (https://github.com/Beckhoff/TF6000_ADS_DOTNET_V5_Samples/issues/82), \#310022
### 7.0.265
Enh: Added support for PouType attribute. Types with PouType=FunctionBlock are now categorized as DataTypeCategory.FunctionBlock, types with PouType=Program as DataTypeCategory.Program instead of DataTypeCategory.Struct.
### 7.0.176
Fix: Cancelling an asynchronous request could return AdsErrorCode.ClientSyncTimeOut instead of AdsErrorCode.ClientRequestCancelled, driving the connection into the Lost state (reconnect delay on cancel). In RequestAsync the cancellation token is wired into the timeout Task.Delay, so on cancellation the delay task completed and the timeout branch was evaluated before the cancellation branch. Cancellation is now checked before timeout. Related to \\#87802, \\#314577.
### 7.0.165
Change: TwinCAT.TypeSystem.IEnumValue.Primitive renamed to IEnumValue.Value to represent the Primitive value of the enum member (old property remains marked as obsolete).
Change: TwinCAT.TypeSystem.IEnumValue.ManagedBaseType renamed to IEnumValue.BaseType to represent the managed base type of the enum member (old property remains marked as obsolete).
Fix: Error "Object must implement IConvertible" on symbolic reading of PLC Enum types via IValueSymbol.ReadValue().
### 7.0.156
Enh: Removing inefficient lock from AdsClient.IsConnected property (changing to volatile field), synchronization of Connect/Disconnect methods by SlimSemaphore instead of lock, \#286141
### 7.0.152
Enh: Implements AdsClient.Connect() timeout (200ms) for sending internal PortConnect/GetLocalNetId command.
Enh: Async implementation of AdsClient.ConnectAsync(CancellationToken cancel) replaces old internal synchronous implementation.
### 7.0.145
Fix: IValueSymbol.WriteValue(object value) throws SymbolException with AdsErrorCode.None
### 7.0.140
Change: TwinCAT.Ads.SumCommand.SumHandleRead renamed to SumHandleReadAnyType
Change: TwinCAT.Ads.SumCommand.SumHandleWrite renamed to SumHandleWriteAnyType
### 7.0.127
Fix: Fixes Double ADS Notifications on Symbol objects when AdsClient.ReadSymbol() is used in combination with the symbol loader on the same Symbol, \3280709
### 7.0.109
Enh: Overall optimizations for performance gains and less memory pressure. More internal usage of ReadOnlyMemory<byte> instead of byte[] reduces the amount of array copy operations.
### 7.0.100
Fix: Calculating all overloads of an IStructType inheritance tree could lead into KeyAlreadyAddedException in IStructType.AllMembers, #274903
Enh: AdsClient.SymbolVersionChanged event internally refactored.
Enh: Implementation of TwinCAT.Ads.SumCommand.SumAddNotifications and TwinCAT.Ads.SumCommand.SumDeleteNotifications
Enh: Discrete Fallbacks for SumCommands if SumCommands are not supported.
### 7.0.90
Enh: Adds Notification Statistics to AdsSession.Statistics.
### 7.0.86
Enh: Several new AdsClient, AdsConnection overloads that take the instancePath string as parameter to Access 'ValueByName'
Enh: Better performance with AdsClient.Disconnect / AdsClient.Dispose methods, \#270737
### 7.0.79
Fix: AdsClient doesn't remove the Variable Handle from HandleCache when calling TryDeleteDeviceNotification, DeleteDeviceNotificationAsync, #269484
### 7.0.74
Fix: Race condition in SymbolCache and HandleCache accessing handles from seperate Threads, [#76](https://github.com/Beckhoff/TF6000_ADS_DOTNET_V5_Samples/issues/76)
### 7.0.60
Fix: Use Encoding.Unicode for marshalling RpcInvoke return values of type WSTRING.
Fix: WString marshalling of DynamicSymbol.TrySetMemberValue
### 7.0.36
Breaking Change: Removes .NET6 as Dependency (out-of-support)
### 7.0.25
Fix: Cannot access symbol that is an alias type to a jagged array, fixes \#197676, \#171438
### 7.0.10
Fix: Fixes to write ReferenceTypes via IValueSymbol.WriteValue() or IValueSymbol.WriteValueAsync(), \#256269
### 7.0
Enh: Using ValueAccessMode.IntancePath for IValueSymbol.ReadValue() / IValueSymbol.WriteValue() instead of 3 roundtrips via ADS handles.
Enh: Supports **locally** installed TwinCAT 2 (via PInvoke channel)
    Fallback usage of 'TcAmsServer.dll' internally enables function on systems that don't have TCP Loopback port open (e.g TC2 and systems with TCP Loopback disabled), \#230847
Enh: Supports internal communication via UnixSockets, TCP/IP Loopback and PInvoke
Enh: TargetFramework dependencies changed to net8.0, net6.0, netstandard2.0