DP44/enriched-qwen3-coder-next/Common/DTS.Common.DataModel/Classes/Hardware.md

source_files, generated_at, model, schema_version, sha256

source_files	generated_at	model	schema_version	sha256
Common/DTS.Common.DataModel/Classes/Hardware/DASSettings.cs Common/DTS.Common.DataModel/Classes/Hardware/DASHardwareList.cs Common/DTS.Common.DataModel/Classes/Hardware/BatteryAndInputVoltageDefaults.cs	2026-04-16T03:33:19.361594+00:00	Qwen/Qwen3-Coder-Next-FP8	1	ea5a7a11d2e6d80b

Documentation: DAS Hardware and Configuration Data Models

1. Purpose

This module provides core data models and utility classes for managing Data Acquisition System (DAS) hardware configuration and settings within the DataPROWin7 system. It defines structured representations of DAS hardware components (DASHardware, referenced indirectly), their specific settings (DASSettings), and battery/input voltage thresholds (DasBatteryInputSettings), enabling serialization to/from the database (tblTestSetupDASSettings), caching for performance optimization during bulk operations, and type-specific default configuration retrieval. The module serves as the data layer abstraction for DAS hardware state and configuration across test setup, validation, and execution workflows.

2. Public Interface

DASSettings (in DataPROWin7.DataModel namespace)

• DASSettings()
  Default constructor. Initializes an empty instance.

• DASSettings(DASSettings setting)
  Copy constructor. Copies all property values from the provided setting instance.

• string DASSerialNumber { get; set; }
  Serial number of the DAS device. Serialized to tblTestSetupDASSettings.

• double SampleRate { get; set; }
  Sample rate in Hz. Serialized to tblTestSetupDASSettings.

• int ExcitationWarmupTimeMS { get; set; }
  Excitation warm-up time in milliseconds. Serialized to tblTestSetupDASSettings.

• double HardwareAAF { get; set; }
  Hardware Anti-Aliasing Filter (AAF) setting. Serialized to tblTestSetupDASSettings.

• double PreTriggerSeconds { get; set; }
  Duration of pre-trigger buffer in seconds. Serialized to tblTestSetupDASSettings.

• double PostTriggerSeconds { get; set; }
  Duration of post-trigger buffer in seconds. Serialized to tblTestSetupDASSettings.

• bool StatusLineCheck { get; set; }
  Flag indicating whether status line monitoring is enabled. Serialized to tblTestSetupDASSettings.

• bool BatteryCheck { get; set; }
  Flag indicating whether battery voltage checks are enabled. Serialized to tblTestSetupDASSettings.

• double InputVoltageMin { get; set; }
  Minimum acceptable input voltage threshold. Serialized to tblTestSetupDASSettings.

• double InputVoltageMax { get; set; }
  Maximum acceptable input voltage threshold. Serialized to tblTestSetupDASSettings.

• double BatteryVoltageMin { get; set; }
  Minimum acceptable battery voltage threshold. Serialized to tblTestSetupDASSettings.

• double BatteryVoltageMax { get; set; }
  Maximum acceptable battery voltage threshold. Serialized to tblTestSetupDASSettings.

Note

: All properties use SetProperty (inherited from BasePropertyChanged) for change notification.

---

DASHardwareList (in DataPROWin7.DataModel.Classes.Hardware namespace)

• static bool Cache { get; set; }
  Enables/disables database caching. When true, hardware lookups use in-memory cache instead of querying the database. Setting to false clears _cachedDASHardware.

• static DASHardwareList GetList()
  Returns the singleton instance of DASHardwareList. Does not auto-populate hardware (commented-out PopulateHardware() call).

• void ReloadAll()
  Placeholder method (implementation commented out). Intended to reload hardware list.

• void SetCache(ICachedContainer container)
  Sets the _cachedHardware field for use in GetHardware(string, bool, out bool, bool).

• void ClearCache()
  Clears _cachedHardware.

• string GetDASSerialNumberFromId(int id)
  Retrieves the serial number for a given DAS ID by querying DbOperations.DASGet. Returns empty string if not found.

• DASHardware GetHardware(int id)
  Retrieves DASHardware by ID using GetDASSerialNumberFromId(id) → GetHardware(string).

• DASHardware GetHardware(string id, bool bUseCache = true)
  Retrieves DASHardware by serial number (or key like "SN_type"), optionally using cache.

• DASHardware[] GetHardware(string[] ids, bool bUseCache = true)
  Batch retrieval of DASHardware instances.

• DASHardware GetHardware(string id, bool bThrowExceptionIfChanged, out bool changed, bool bUseCache = true)
  Core retrieval logic. Checks _cachedHardware and _cachedDASHardware if caching is enabled. Falls back to DTS.Common.ISO.Hardware.GetAllDAS(id, null). Sets changed = false unconditionally.

• class HardwareTypeChangedException : Exception
  Exception type declared but never thrown in source.

• DASHardware GetHardware(string serialNumber, string ipaddress)
  Ignores ipaddress and delegates to GetHardware(serialNumber).

• void UpdateMaxMemory(DASHardware h, long newMaxMemory)
  Updates MaxMemory on the underlying DTS.Common.ISO.Hardware object and calls Update().

• DASHardware GetPrototypeHardware(string serial, int type)
  Retrieves prototype hardware using key "{serial}_{type}" and DbOperations.DAS.PROTOTYPE_POSITION. Sets CalDate = DateTime.MinValue.

• static DASHardware[] GetAllHardware()
  Retrieves all DAS hardware via DTS.Common.ISO.Hardware.GetAllDAS(). Caches result if Cache == true.

• static List<int> GetEmbeddedModules(IDASHardware[] hardware, int id)
  Returns list of DASIds of modules whose Connection starts with the serial number of the hardware identified by id.

• static Dictionary<string, double> GetEmbeddedModuleInfo(DASHardware[] hardware, int id)
  Returns dictionary mapping serial numbers of embedded modules to their GetMaxSampleRateDouble() values.

• enum Tags { Hardware }
  Tag used in OnPropertyChanged calls.

• void Commit(DASHardware hardware, bool bExisting = false, bool bCheckExisting = true, bool Unassociate = true)
  Persists DASHardware state to database via DTS.Common.ISO.Hardware.

  • If Unassociate == true and IsPseudoRack(), calls UnassociateParentDAS.
  • If bCheckExisting == true, sets bExisting based on DASHardware.GetDataBaseID.
  • Inserts if !bExisting, otherwise updates with incremented Version.
  • Raises OnPropertyChanged(Tags.Hardware.ToString()).

• void Delete(IHardware hardware)
  Deletes via IISOHardware.Delete() if supported.

• void Delete(DASHardware hardware)
  Deletes underlying ISO.Hardware, and if IsPseudoRack(), calls UnassociateParentDAS.

• void Delete(IHardware[] hardware) / void Delete(DASHardware[] hardware)
  Batch deletion helpers.

• static void UnassociateParentDAS(string distributorSerialNumber)
  Executes stored procedure sp_DASChildrenUnAssociate to remove child associations for the given distributor.

---

DasBatteryInputSettings (in DataPROWin7.DataModel.BatteryAndInputVoltageDefaults namespace)

• enum Settings
  Ordered list of 14 battery/input voltage thresholds. Order matters for serialization:

  • BatteryLowDiagnosticsThreshold
  • BatteryHighDiagnosticsThreshold
  • BatteryLowArmedThreshold
  • BatteryHighArmedThreshold
  • InputLowDiagnosticsThreshold
  • InputHighDiagnosticsThreshold
  • InputLowArmedThreshold
  • InputHighArmedThreshold
  • MinimumValidBatteryThreshold
  • MinimumValidInputThreshold
  • MaximumValidBatteryThreshold
  • MaximumValidInputThreshold
  • BatteryMediumDiagnosticsThreshold
  • BatteryMediumArmedThreshold
  • InputMediumDiagnosticsThreshold
  • InputMediumArmedThreshold

• Properties (14 total)
  Each has a get/set that wraps GetValue(Settings) / SetValue(Settings, double).

• Dictionary<Settings, double> SettingsProperty { get; }
  Internal storage for settings.

• DasBatteryInputSettings(string s)
  Parses comma-separated string into settings (assumes order matches Settings enum). Uses double.TryParse(..., CultureInfo.InvariantCulture).

• DasBatteryInputSettings(DasBatteryInputSettings copy)
  Copy constructor.

• DasBatteryInputSettings()
  Initializes with hardcoded defaults (e.g., BatteryLowArmedThreshold = 6.8, InputHighArmedThreshold = 15.3, etc.). Throws NotSupportedException for unknown settings.

• string ToSerializedString()
  Serializes settings in Settings enum order to comma-separated string.

• double GetValue(Settings setting)
  Returns value for setting. Throws NotSupportedException if missing.

• void SetValue(Settings setting, double d)
  Sets value for setting.

---

InputAndBatterySettings (static class, same namespace)

• static Dictionary<HardwareTypes, DasBatteryInputSettings> _cache
  Cache of settings per hardware type.

• static void ClearCache()
  Clears _cache.

• static double GetValue(string DasType, DasBatteryInputSettings.Settings setting)
  Parses DasType to HardwareTypes, then calls GetValue(HardwareTypes, Settings). Returns double.NaN on parse failure.

• static DasBatteryInputSettings GetDefaultSettingForHWType(HardwareTypes type)
  Returns default settings for type from Common.SerializedSettings.*_PowerSetting_Default fields. Caches if RunTestVariables.InRunTest && CacheVoltageSettingsInRunTest. Throws NotSupportedException if type unsupported.

• static void SetSettingForHWType(HardwareTypes type, DasBatteryInputSettings setting)
  Assigns setting to corresponding Common.SerializedSettings.*_PowerSetting field.

• static DasBatteryInputSettings GetSettingForHWType(HardwareTypes type)
  Returns current (possibly overridden) settings for type from Common.SerializedSettings.*_PowerSetting fields. Caches if applicable. Throws NotSupportedException if type unsupported.

• static double GetValue(HardwareTypes type, DasBatteryInputSettings.Settings setting)
  Returns GetSettingForHWType(type).GetValue(setting).

3. Invariants

• DASSettings

  • All properties are nullable (no validation constraints enforced in class).
  • Serialization format is fixed: properties map directly to columns in tblTestSetupDASSettings.
  • Property names match exactly those used in SetProperty calls (case-sensitive).

• DASHardwareList

  • Cache flag controls whether _cachedDASHardware is populated/used. Setting Cache = false clears _cachedDASHardware.
  • GetHardware(string, bool, out bool, bool) always sets changed = false; the bThrowExceptionIfChanged parameter is unused.
  • Commit assumes DASHardware wraps a valid DTS.Common.ISO.Hardware instance.
  • UnassociateParentDAS is called only for pseudo-rack hardware during Commit or Delete.

• DasBatteryInputSettings

  • Settings enum order must not change without updating serialization logic (ToSerializedString, constructor from string).
  • Default constructor initializes all 14 settings; missing cases throw NotSupportedException.
  • GetValue/SetValue assume key exists; missing keys throw NotSupportedException.

4. Dependencies

Imports/References (from source):

• DTS.Common.Base → Provides BasePropertyChanged.
• DTS.Common.ISO.Hardware → Core hardware data model (GetAllDAS, Hardware, HardwareChannel).
• DTS.Common.Storage → DbOperations, DbOperationsEnum.StoredProcedure.
• DTS.Common.Interface.DASFactory.Diagnostics, DTS.Common.Interface.DataRecorders, DTS.Common.Interface.DASFactory.Diagnostics.HardwareList → Interfaces for hardware diagnostics and storage.
• System, System.Linq, System.Collections.Generic, System.Windows, System.Configuration → Standard libraries.
• DataPROWin7.DataModel.Classes.TestTemplate → Test template classes.
• DTS.Common.Enums, DTS.Common.Enums.Hardware → HardwareTypes enum.
• Common.SerializedSettings → Static class holding default/overridden settings per hardware type.
• RunTestVariables → Controls caching behavior during run tests.

Inferred Usage:

• DASSettings is serialized to tblTestSetupDASSettings (database table).
• DASHardwareList interacts with DASHardware (not shown here but referenced).
• InputAndBatterySettings relies on Common.SerializedSettings and RunTestVariables for runtime configuration.

5. Gotchas

• DASHardwareList.GetHardware(...) always sets changed = false
  Despite having an out bool changed parameter and a HardwareTypeChangedException type, the implementation never detects changes or throws the exception.

• DASHardwareList.GetHardware(string id, bool bThrowExceptionIfChanged, out bool changed, bool bUseCache) ignores bThrowExceptionIfChanged
  The parameter is unused in the method body.

• DASHardwareList.GetHardware(string serialNumber, string ipaddress) discards ipaddress
  Only uses serialNumber.

• DASHardwareList.Commit assumes hardware.GetHardware() is non-null
  No null-check before accessing hardware.GetHardware() properties.

• DASHardwareList.UnassociateParentDAS is called only for pseudo-rack hardware
  Logic depends on IsPseudoRack() (not defined here), but no validation ensures this condition is checked correctly.

• DasBatteryInputSettings serialization order is fragile
  Constructor from string assumes exact enum order; reordering Settings will break deserialization.

• InputAndBatterySettings._cache is shared globally
  ClearCache() affects all callers; caching behavior depends on RunTestVariables flags.

• DASSettings copy constructor copies private fields directly
  No deep-copy or validation; mutable reference types (if added later) could cause side effects.

• DASHardwareList.GetAllHardware() may return stale data if Cache = true
  Once cached, _cachedDASHardware persists until Cache is set to false.

• No validation of numeric ranges
  Properties like SampleRate, PreTriggerSeconds, or voltage thresholds accept any double/int without bounds checking.

• GetEmbeddedModules/GetEmbeddedModuleInfo use hardware.First(...).SerialNumber without null-check
  If no hardware matches DASId == id, First() throws InvalidOperationException.