DP44/enriched-qwen3-coder-next/Common/DTS.Common/Enums/Sensors.md

source_files, generated_at, model, schema_version, sha256

source_files	generated_at	model	schema_version	sha256
Common/DTS.Common/Enums/Sensors/SensorChangeTypes.cs Common/DTS.Common/Enums/Sensors/SensorStatus.cs Common/DTS.Common/Enums/Sensors/PossibleFilters.cs Common/DTS.Common/Enums/Sensors/LinearizationFormula.cs Common/DTS.Common/Enums/Sensors/CalibrationEnforcement.cs Common/DTS.Common/Enums/Sensors/SensitivityInspection.cs Common/DTS.Common/Enums/Sensors/CalibrationBehaviors.cs Common/DTS.Common/Enums/Sensors/InitialOffsetTypes.cs Common/DTS.Common/Enums/Sensors/FilterClassType.cs Common/DTS.Common/Enums/Sensors/ZeroMethodType.cs Common/DTS.Common/Enums/Sensors/CSVImportTags.cs Common/DTS.Common/Enums/Sensors/SensorConstants.cs	2026-04-16T03:20:17.284188+00:00	Qwen/Qwen3-Coder-Next-FP8	1	fb4f3c61e14ed27e

Sensor Enums and Constants Documentation

1. Purpose

This module defines core enumerations and static constants used throughout the DTS system to represent sensor metadata, configuration, calibration behavior, filtering, and import/export semantics. It serves as the canonical source of truth for sensor-related data types, ensuring consistency across data import/export (especially CSV), channel configuration, calibration enforcement, and system behavior validation. The enums and constants support legacy compatibility, versioned CSV schema evolution, and domain-specific requirements (e.g., GM-ISF, TSR AIR, IR-TRACC).

2. Public Interface

Enumerations

SensorChangeTypes

• OffsetTolerance: Represents a change type related to sensor offset tolerance.

SensorStatus

• Available: Sensor is available for use.
• InUse: Sensor is currently in use.
• OutForService: Sensor is out for service.
• OutForCalibration: Sensor is out for calibration.
• Retired: Sensor is retired and no longer usable.

PossibleFilters

• All: Include all channel/sensor types.
• Analog: Analog channels.
• Squib: Squib channels.
• DigitalIn: Digital input channels.
• DigitalOut: Digital output channels.
• UART: UART channels.
• StreamOut: Stream output channels.
• StreamIn: Stream input channels.
• CAN: CAN channels.

NonLinearStyles

• IRTraccManual
• IRTraccDiagnosticsZero
• IRTraccZeroMMmV
• IRTraccAverageOverTime
• Polynomial
• IRTraccCalFactor

NonLinearSLICEWareStyles

• Manual
• DiagnosticZeroMMmV
• ZeroMMmV
• AverageOverTime
• Polynomial

CalibrationEnforcement

• None: No calibration enforcement.
• NonLinear: Enforce non-linear calibration.
• Linear: Enforce linear calibration.

SensitivityInspectionType

• NotSet: Inspection status not set (value 0).
• Required: Inspection required (value 1).
• Cleared: Inspection cleared (value 2).

CalibrationBehaviors

• LinearIfAvailable: Prefer linear calibration if available.
• NonLinearIfAvailable: Prefer non-linear calibration if available.
• UseBothIfAvailable: Use both linear and non-linear calibrations if available.

InitialOffsetTypes

• None: No initial offset (value 0).
• EU: Offset specified in engineering units (EU) (value 1).
• EUAtMV: Offset specified in EU at a specific mV (value 2).
• LHS: Left-hand side offset (value 3).
• RHS: Right-hand side offset (value 4).
• FRONTAL: Frontal offset (value 5).

FilterClassType

• None: No filter (code P unless UseZeroForUnfiltered is true, then 0) (value 0).
• AdHoc: Ad-hoc filter (value -1).
• Unfiltered: Unfiltered (code 0) (value -2).
• CFC10: 17 Hz cutoff (code 17) (value 17).
• CFC60: 100 Hz cutoff, code D (value 100).
• CFC180: 300 Hz cutoff, code C (value 300).
• CFC600: 1000 Hz cutoff, code B (value 1000).
• CFC1000: 1650 Hz cutoff, code A (value 1650).

ZeroMethodType

• AverageOverTime: Calculate zero using average over time (value 0).
• UsePreEventDiagnosticsZero: Calculate zero using pre-event diagnostics (value 1).
• None: No software zero (injected value) (value 2).

OriginalZeroMethodType

• AverageOverTime
• UsePreCalZero
• None

CSVImportTags.Tags

A large set of tags used for CSV import/export, each annotated with [Display(Name = "...")] and [Version(n)]. Key examples:

• DatabaseReferenceNumber (v0)
• SensorSN (v0)
• ChannelName (v0)
• FilterClass (v0)
• SoftwareZeroReference (v0)
• Version (v1)
• InitialOffset (v2)
• ZeroMethod (v2)
• DASSerialNumber (v4)
• ClockMasterInputType (v5)
• PTPDomainId (v6)

Static methods:

• IsSensorTag(int version): Returns true if version is in {0, 2, 3, 4}.
• GetVersionTags(int version): Returns array of Tags valid for given version.
• GetStringForTag(Tags tag): Returns display string for tag.
• GetTagForString(string s): Returns Tags for display string s; Tags.Unknown if not found.
• GetVersionForTag(Tags t): Returns version int for tag; int.MaxValue if not annotated.

SensorConstants.SensorSettings

Enum of sensor configuration settings (used internally, not for serialization):

• Range, CFC, Polarity, Position, LimitDuration (deprecated), Duration (deprecated), Delay (deprecated), OutputMode, SQMode, DIMode, DefaultValue, ActiveValue
• SquibLimitDuration, SquibDuration, SquibDelay, DigitalOutLimitDuration, DigitalOutDuration, DigitalOutDelay, SquibCurrent
• ZeroMethod, ZeroMethodStart, ZeroMethodEnd, UserValue1, UserValue2, UserValue3, InitialOffset, FilterClass
• UartBaudRate, UartDataBits, UartStopBits, UartParity, UartFlowControl, UartDataFormat
• StreamOutUDPProfile, StreamOutUDPAddress, StreamOutUDPTimeChannelId, StreamOutUDPDataChannelId, StreamOutUDPTmNSConfig, StreamOutIRIGTimeDataPacketIntervalMs
• StreamInUDPAddress, ACCouplingEnabled, BridgeType

SensorConstants.SensorType

• Analog
• DigitalIn
• DigitalOut
• Squib
• Clock
• UART
• StreamOut
• StreamIn
• Thermocoupler

SensorConstants.SensUnits

• NONE: Polynomial sensor (value 0)
• mV: Sensitivity in mV (value 1)
• mVperV: Sensitivity in mV/V (value 2)
• mVperVperEU: Sensitivity in mV/V/EU (value 3)
• mVperEU: Sensitivity in mV/EU (value 4)

SensorConstants.BridgeType

Bitmask enum:

• IEPE (1 << 0)
• QuarterBridge (1 << 1)
• HalfBridge (1 << 2)
• FullBridge (1 << 3)
• DigitalInput (1 << 4)
• SQUIB (1 << 5)
• TOMDigital (1 << 6)
• HalfBridge_SigPlus (1 << 7)
• RTC (1 << 8)
• UART (1 << 9)
• StreamOut (1 << 10)
• StreamIn (1 << 11)
• Thermocoupler (1 << 12)
• CAN (1 << 13)

Static helpers:

• ConvertIntToBridgeType(int bridge): Maps integer to BridgeType.
• ConvertBridgeToInt(BridgeType bridge): Maps BridgeType to integer (legacy DB storage).

SensorConstants.SensorCalPolicy

• AllowAlways: Allow sensors regardless of calibration status.
• DONT_ALLOW: Reject out-of-cal sensors.

SensorConstants.CouplingModes

• AC (0)
• DC

Constants (Static Fields)

Global Settings (Runtime Cache)

• UseInitSignalTOM: bool, default false.
• UseSensorFirstUseDate: bool, default false.
• DontAllowDataCollectionIfOverused: bool, default false.
• AllowInspectBeforeUse: bool, default false.
• UsageRemainingForWarning: int, default 5.
• DefaultMaxUsageAllowed: int, default 2500.
• UseISOCodeFilterMapping: bool, default true.
• DefaultZeroMethodType: ZeroMethodType, default AverageOverTime.
• DefaultZeroMethodStart: double, default -0.05.
• DefaultZeroMethodEnd: double, default -0.02.
• DefaultRangeHiG: double, default 400.
• DefaultRangeLowG: double, default 64.
• DefaultRangeLowGDisplay: double, default 50.
• DefaultRangeARS: double, default 2000.
• DefaultRangeTemperature: double, default 85.
• DefaultRangeHumidity: double, default 100.
• DefaultRangePressure: double, default 16.
• SensorCalOutOfDateWarningPeriodDays: int, default 14.
• SensorCalPolicyCurrent: SensorCalPolicy, default DONT_ALLOW.
• DisableAutoSense: bool, default false.
• DefaultBridgeOffsetMVTolLow/High: -100 / 100.
• DefaultIEPEOffsetMVTolLow/High: -2000 / 2000.

IR-TRACC Constants

• δThorax: 15.65
• δAbdomen: 0
• D0Thorax: 141.8
• D0Abdomen: 150.9
• δThoraxLower: -15.65
• D0ThoraxLower: 141.8

Unit Strings

• VOLTAGE_INSERTION_UNIT: "mV"
• TSRAIR_ACCEL_UNIT: "g"
• TSRAIR_ARS_UNIT: "deg/sec"
• TSRAIR_TEMPERATURE_UNIT: "C"
• TSRAIR_HUMIDITY_UNIT: "%"
• TSRAIR_PRESSURE_UNIT: "PSI"
• DEGREES: "deg"
• DEGREE_ANGLE: "deg-ang"
• POTUnits: new[] { "deg", "deg-ang" }

Bridge Resistance Limits

• MIN_BRIDGE_RESISTANCE_OHMS: 1
• MAX_BRIDGE_RESISTANCE_OHMS: 32000

Sensor Defaults

• SENSOR_FIRST_USE_DEFAULT: false
• ALLOW_INSPECT_BEFORE_USE_DEFAULT: false
• SENSOR_OVERUSE_DEFAULT: false
• SENSOR_USAGE_REMAINING_FOR_WARNING_DEFAULT: 5
• SENSOR_DEFAULT_MAX_USAGE_DEFAULT: 2500
• CAL_SENSOR_POLICY_DEFAULT: DONT_ALLOW
• CAL_SENSOR_POLICY_WARNING_DAYS_DEFAULT: 14

Squib Defaults (Legacy)

• SQUIB_DELAY_CONSTANT: 0
• SQUIB_LIMIT_DURATION_CONSTANT: true
• SQUIB_DURATION_CONSTANT: 10
• SQUIB_LOW_TOLERANCE_CONSTANT: 1
• SQUIB_HIGH_TOLERANCE_CONSTANT: 10
• SQUIB_FIREMODE_CONSTANT: SquibFireMode.CAP
• SQUIB_CURRENT_CONSTANT: 1.5

Digital Output Defaults (Legacy)

• DIGITALOUT_MODE_CONSTANT: DigitalOutputModes.FVLH
• DIGITALOUT_DELAY_CONSTANT: 0
• DIGITALOUT_LIMITDURATION_CONSTANT: true
• DIGITALOUT_DURATION_CONSTANT: 10

UART Defaults (Legacy)

• UART_DATABITS_CONSTANT: 8
• UART_STOPBITS_CONSTANT: StopBits.One
• UART_PARITY_CONSTANT: Parity.None
• UART_FLOWCONTROL_CONSTANT: Handshake.None
• UART_DATAFORMAT_CONSTANT: UartDataFormat.Binary

Stream Defaults (Legacy)

• STREAMIN_ADDRESS_CONSTANT: "UDP://239.1.2.10:8400"
• STREAMOUT_PROFILE_CONSTANT: UDPStreamProfile.CH10_PCM_128BIT_2HDR
• STREAMOUT_ADDRESS_CONSTANT: "UDP://239.1.2.10:8400"
• STREAMOUT_TIME_CHID_CONSTANT: 1
• STREAMOUT_DATA_CHID_CONSTANT: 3
• STREAMOUT_TMNS_CONFIG_CONSTANT: "(1,6,60,0,0,0,0,0)"
• STREAMOUT_IRIG_TDP_INTERVAL_CONSTANT: 500

Test-Specific Serial Number Prefixes

• TEST_SPECIFIC_DOUT: "TSD_"
• TEST_SPECIFIC_SQUIB: "TSQ_"
• TEST_SPECIFIC_DIN: "TSI_"
• TEST_SPECIFIC_EMB: "TSA_"
• TEST_SPECIFIC_THERMO: "TST_"
• TEST_SPECIFIC_EMB_CLK: "TSC_"
• TEST_SPECIFIC_UART: "TSU_"
• TEST_SPECIFIC_STREAM_OUT: "TSS_"
• TEST_SPECIFIC_STREAM_IN: "TSN_"
• TEST_SPECIFIC_CAN: "TSF_"

Static helper methods:

• IsTestSpecificDigitalOut(string sn)
• IsTestSpecificSquib(string sn)
• IsTestSpecificDigitalIn(string sn)
• IsTestSpecificEmbedded(string sn)
• IsTestSpecificThermoCouple(string sn)
• IsTestSpecificEmbeddedClock(string sn)
• IsTestSpecificStreamOut(string sn)
• IsTestSpecificStreamIn(string sn)
• IsTestSpecificUart(string sn)
• IsTestSpecificThermocoupler(string sn)
• IsTestSpecificCAN(string sn)

Other Constants

• LinearValuesSeparator: "||" (used for encoding added linear calibration with non-linear sensor)
• EditObjectSensorChannelDragFormat: "EditObjectSensorsChannelTable.UserData []"
• TSRAirTemperatureChannel: 9
• TSRAirHumidityChannel: 10
• TSRAirPressureChannel: 11
• ARS2000, LowG64: 2000, 64
• HighG, LowG, ARS, Atm: "-High g", "-Low g", "-ARS", "-Atm"
• IsTSRAirHighGChannel, IsTSRAirLowGChannel, IsTSRAirARSChannel, IsTSRAirAtmChannel, IsTSRAirHumidityChannel: Helper methods.

3. Invariants

• CSV Import Versions: Valid versions are 0 through 6. Only versions {0, 2, 3, 4} are considered sensor tag versions (IsSensorTag).
• ZeroMethodType ordering: The values 0, 1, 2 are critical for legacy compatibility (e.g., GM-ISF import).
• BridgeType bitmask: Values are powers of two; ConvertBridgeToInt maps to legacy integer storage (e.g., FullBridge → 3).
• SensitivityInspectionType values: NotSet=0, Required=1, Cleared=2.
• FilterClassType codes: Values map to SAE filter class codes (e.g., CFC60 → 100 → code D).
• CalibrationEnforcement and CalibrationBehaviors: Must be used consistently with NonLinearStyles and NonLinearSLICEWareStyles.
• InitialOffsetTypes: Values EU, EUAtMV, LHS, RHS, FRONTAL are mutually exclusive and context-dependent.
• **`