DP44/docs/ai/Common/DTS.Common/Classes/Hardware.md

source_files, generated_at, model, schema_version, sha256

source_files	generated_at	model	schema_version	sha256
Common/DTS.Common/Classes/Hardware/ExternalTilt.cs Common/DTS.Common/Classes/Hardware/DragAndDropPayload.cs Common/DTS.Common/Classes/Hardware/SerializableAAF.cs Common/DTS.Common/Classes/Hardware/DASDBRecord.cs Common/DTS.Common/Classes/Hardware/DASChannelDBRecord.cs Common/DTS.Common/Classes/Hardware/DASMonitorInfo.cs	2026-04-17T15:35:23.326019+00:00	zai-org/GLM-5-FP8	1	4e304d35fc9dc2de

DTS.Common.Classes.Hardware Documentation

Purpose

This module provides data structures and persistence logic for hardware-related entities within the DTS (Data Acquisition System) domain. It contains database record mappings for DAS units and their channels, monitor configuration state for tilt sensors and channel metadata, and utility classes for hardware identification and drag-and-drop operations. The module serves as the data layer abstraction between the hardware abstraction layer and the database/serialization infrastructure.

---

Public Interface

ExternalTilt

A simple POCO (Plain Old CLR Object) representing an external tilt sensor device.

Properties:

• string SerialNumber { get; set; } - Serial number of the tilt device
• byte TiltID { get; set; } - Numeric identifier for the tilt device
• string SystemID { get; set; } - System identifier where the tilt device is registered
• string SystemLocation { get; set; } - Physical location of the tilt device within the system

---

DragAndDropPayload

Static container class defining clipboard format identifiers for drag-and-drop operations involving hardware table rows.

Constants:

• const string FORMAT = "RESOLVECHANNELS_HARDWARETABLE" - Standard drag format
• const string ALT_FORMAT = "ALT_RESOLVECHANNELS_HARDWARETABLE" - Alternate drag format (Alt key modifier)
• const string CTRL_FORMAT = "CTRL_RESOLVECHANNELS_HARDWARETABLE" - Control drag format (Ctrl key modifier)

---

SerializableAAF

Container for Anti-Alias Filter serialization logic (currently non-functional).

Nested Types:

• enum DAS_TYPE { TDAS = 0, SLICE = 1 } - Enumeration identifying DAS hardware types

Note: All implementation methods (GetSerializedKey(), GetSerializedValue(), FromSerializedStrings()) are commented out. The class currently serves only as a container for the DAS_TYPE enum.

---

DASDBRecord

Entity class representing a Data Acquisition System (DAS) database record. Implements IDASDBRecord and extends BasePropertyChanged.

Constructors:

• DASDBRecord() - Default constructor
• DASDBRecord(IDASDBRecord copy) - Copy constructor; performs shallow copy of most properties and deep copy of ChannelTypes array
• DASDBRecord(IDataReader reader) - Constructs instance from database reader using Utility helper methods

Static Properties:

• static DateTime INVALID_DATE => new DateTime(1970, 1, 1) - Sentinel value for unset date fields

Instance Properties (Key Database Columns):

• int DASId { get; set; } - Primary key ([Key], mapped to column "DASId")
• string SerialNumber { get; set; } - Required, max length 50
• int DASType { get; set; } - DAS type identifier
• int MaxModules { get; set; } - Maximum module count
• long MaxMemory { get; set; } - Maximum memory in bytes
• double MaxSampleRate { get; set; } - Maximum sample rate (decimal(18,0) in DB)
• double MinSampleRate { get; set; } - Minimum sample rate (decimal(18,0) in DB)
• string FirmwareVersion { get; set; } - Firmware version string (max 50 chars)
• DateTime CalDate { get; set; } - Calibration date (defaults to INVALID_DATE)
• int ProtocolVersion { get; set; } - Protocol version number
• DateTime LastModified { get; set; } - Last modification timestamp
• string LastModifiedBy { get; set; } - User who last modified (max 50 chars)
• int Version { get; set; } - Record version
• bool LocalOnly { get; set; } - Whether record is local-only
• DateTime LastUsed { get; set; } - Last usage timestamp (defaults to INVALID_DATE)
• string LastUsedBy { get; set; } - User who last used (max 50 chars)
• string Connection { get; set; } - Connection string/info (max 50 chars)
• int Channels { get; set; } - Channel count
• string Position { get; set; } - Required position string (max 50 chars)
• int[] ChannelTypes { get; set; } - Array of channel type identifiers (max 255 chars in DB)
• bool IsProgrammable { get; set; } - Whether DAS is reprogrammable
• bool IsReconfigurable { get; set; } - Whether DAS is reconfigurable
• bool IsModule { get; set; } - Whether this is a module
• int PositionOnDistributor { get; set; } - Position index on distributor
• int PositionOnChain { get; set; } - Position index on chain
• int Port { get; set; } - Port number
• string ParentDAS { get; set; } - Parent DAS serial number (max 50 chars)
• DateTime? FirstUseDate { get; set; } - Nullable first use date
• int? TestId { get; set; } - Nullable test ID
• int? GroupId { get; set; } - Nullable group ID
• bool StandIn { get; set; } - Stand-in flag
• double MaxAAFRate { get; set; } - Maximum Anti-Alias Filter rate (decimal(18,0) in DB)
• bool IsFirstUseValid { get; set; } - Whether first use date is valid (references issue 15524)

---

DASChannelDBRecord

Entity class representing a DAS channel database record. Implements IDASChannelDBRecord and extends BasePropertyChanged.

Constructors:

• DASChannelDBRecord() - Default constructor
• DASChannelDBRecord(IDataReader reader) - Constructs from database reader
• DASChannelDBRecord(IDASChannelDBRecord copy) - Copy constructor

Constants (Bitmask Defaults):

• const int DEFAULT_SUPPORTED_BRIDGES = 12 - Default: half bridge (4) + full bridge (8)
• const int DEFAULT_SUPPORTED_EXCITATIONS = 16 - Default: 5V excitation
• const int DEFAULT_SUPPORTED_DI_MODES = 16 - Default digital input mode (CCNC)
• const int DEFAULT_SQUIB_FIRE_MODES = 16 - Default squib fire mode
• const int DEFAULT_SUPPORTED_DO_MODES = 16 - Default digital output mode

Properties:

• string HardwareId { get; set; } - Composite ID: "{serialnumber}_{dastype}"
• int DaschannelId { get; set; } - Primary key ([Key], mapped to "DASChannelId")
• int? Dasid { get; set; } - Foreign key to parent DAS record
• int ChannelIdx { get; set; } - Physical channel index on DAS
• int SupportedBridges { get; set; } - Bitmask: IEPE(0), quarter(1), half(2), full(3), DI(4), squib(5), DO(6), half-bridge-signal-plus(7), RTC(8), UART(9)
• int SupportedExcitations { get; set; } - Bitmask: invalid(0), 2V(1), 2.5V(2), 3V(3), 5V(4), 10V(5), 1V(6)
• int DASDisplayOrder { get; set; } - Display order (may differ from physical order)
• bool LocalOnly { get; set; } - Deprecated; indicates local-only storage
• int SupportedDigitalInputModes { get; set; } - Bitmask: invalid(0), TLH(1), THL(2), CCNO(3), CCNC(4)
• int SupportedSquibFireModes { get; set; } - Bitmask: invalid(0), capacitor-discharge(1), constant-current(2), AC-discharge(3)
• int SupportedDigitalOutputModes { get; set; } - Bitmask: FVLH(0), FVHL(1), CCNO(2), CCNC(3)
• string ModuleSerialNumber { get; set; } - Serial of containing module (max 16 chars)
• int SettingId { get; set; } - Setting ID reference
• int ModuleArrayIndex { get; set; } - Index of module within DAS/Rack

---

DASMonitorInfo

Class for persisting and retrieving DAS monitor configuration including tilt sensor calibration data. Implements IDASMonitorInfo.

Constructors:

• DASMonitorInfo(IDASCommunication das, IsoViewMode mode) - Constructs from live DAS communication object
• DASMonitorInfo(string path) - Constructs by reading from file at specified path

Properties:

• string SerialNumber { get; private set; } - DAS serial number
• double[] TiltSensorCals { get; private set; } - 18-element array of tilt sensor calibration values
• short[] TiltSensorDataPre { get; private set; } - 3-element array of pre-capture tilt data
• DFConstantsAndEnums.TiltAxes TiltAxes { get; private set; } - Tilt axis configuration (default: IXIYIZ)
• int AxisIgnored { get; private set; } - Which axis is ignored
• double MountOffsetAxisOne { get; private set; } - Mount offset for axis one (default: NaN)
• double MountOffsetAxisTwo { get; private set; } - Mount offset for axis two (default: NaN)

Methods:

• string GetChannelName(int index) - Returns channel name or generates default "Ch#XX" format
• double GetOffsetTolerancemVHigh(int index) - Returns high offset tolerance in mV
• double GetOffsetTolerancemVLow(int index) - Returns low offset tolerance in mV
• void ReadFromFile(string path) - Populates instance from file
• void WriteToFile(string path) - Serializes instance to file

---

Invariants

1. DASDBRecord.InvalidDate: The INVALID_DATE constant (1970-01-01) serves as a sentinel value for unset date fields. Code comparing dates should account for this.

2. DASDBRecord.FirstUseDate Validity: FirstUseDate is only considered valid when IsFirstUseValid is true. A null FirstUseDate with IsFirstUseValid == false indicates the feature is not in use.

3. DASDBRecord.ChannelTypes: The ChannelTypes array is never null (defaults to new int[0]). The copy constructor performs a deep copy via Array.Copy.

4. DASChannelDBRecord Bitmasks: All Supported* properties use bit positions documented in XML comments. Bit 0 typically indicates "invalid" or "unset" for mode properties.

5. DASMonitorInfo Array Sizes:

   • TiltSensorCals is