DP44/docs/ai/DataPRO/SensorDB/TDCINI.md

source_files, generated_at, model, schema_version, sha256

source_files	generated_at	model	schema_version	sha256
DataPRO/SensorDB/TDCINI/INIDataZeroTimeWindowSeconds.cs DataPRO/SensorDB/TDCINI/INISmartBatteryThresholds.cs DataPRO/SensorDB/TDCINI/INIViewerROI.cs DataPRO/SensorDB/TDCINI/TSFINIRegionOfInterest.cs DataPRO/SensorDB/TDCINI/TDCINIRS232Info.cs DataPRO/SensorDB/TDCINI/INIIIHSExport.cs DataPRO/SensorDB/TDCINI/INIRackInventory.cs DataPRO/SensorDB/TDCINI/TDCINIError.cs DataPRO/SensorDB/TDCINI/INIISOExportParameters.cs	2026-04-17T15:48:03.697947+00:00	zai-org/GLM-5-FP8	1	507c2abf21a4f505

TDCINI Module Documentation

1. Purpose

This module provides a collection of helper classes for parsing configuration data from INI files within the DTS.SensorDB.TDCINI namespace. Each class corresponds to a specific INI section, responsible for deserializing comma-delimited text lines into strongly-typed properties. The module centralizes error handling through the TDCINIError class, enabling consistent validation and error reporting across all configuration sections.

---

2. Public Interface

TDCINIError

Error container class for INI parsing failures.

Properties:

• Error (INIErrors) — The error type enum value
• Line (int) — Line number where error occurred (default: -1)
• ExtraInfo (string) — Additional context (e.g., the problematic line or token)

Constructors:

• TDCINIError(INIErrors error)
• TDCINIError(INIErrors error, string extraInfo)
• TDCINIError(INIErrors error, string extraInfo, int currentLine)

Nested Enum:

• INIErrors — Contains 60+ error codes including INI_FILE_NOT_FOUND, INI_COMINFO_INVALID, INI_ROI_INVALID, INI_RACKINVENTORY_INVALID, INI_ISOEXPORTPARAMETERS_INVALID, INI_IIHSExport_INVALID, etc.

---

INIDataZeroTimeWindowSeconds

Parses the DataZeroTimeWindow section.

Properties:

• Start (double) — Start of data zero window
• End (double) — End of data zero window

Methods:

• bool ReadFrom(string line, ref List<TDCINIError> errors, int iCurrentLine) — Parses a comma-delimited line with exactly 2 double values. Returns true on success, false on failure.

---

INISmartBatteryThresholds

Parses the SmartBatteryThreshold section.

Properties:

• Yellow (int) — Time in minutes for yellow battery warning
• Red (int) — Time in minutes for red battery warning

Methods:

• bool ReadFrom(string line, int curLine, ref List<TDCINIError> errors) — Parses a comma-delimited line with exactly 2 integer values.

---

INIViewerROI

Parses the ViewerROI section.

Properties:

• XMin (double) — X minimum value
• XMax (double) — X maximum value

Methods:

• bool ReadFrom(string line, int curLine, ref List<TDCINIError> errors) — Parses a comma-delimited line with exactly 2 double values.

---

TSFINIRegionOfInterest

Parses the RegionOfInterest section.

Properties:

• StartSeconds (double) — Start of ROI relative to T0
• EndSeconds (double) — End of ROI relative to T0

Methods:

• bool ReadFrom(string line, int currentLine, ref List<TDCINIError> errors) — Parses a comma-delimited line with exactly 2 double values.

---

TDCINIRS232Info

Parses the RS232 section.

Properties:

• ComPortNumber (int) — Communication port number
• MaxComSpeed (int) — Maximum speed of COM port
• MaxComPorts (int) — Maximum number of ports

Methods:

• bool ReadFrom(string line, ref List<TDCINIError> errors) — Parses a comma-delimited line with exactly 3 integer values. Note: No line number parameter.

---

INIIIHSExport

Parses the IIHS Export section.

Properties:

• ApplyROI (bool) — Whether to apply region of interest
• ROIStartSeconds (double) — Start of ROI in seconds
• ROIEndSeconds (double) — End of ROI in seconds

Methods:

• bool ReadFrom(string line, int curLine, ref List<TDCINIError> errors) — Parses a comma-delimited line with exactly 3 values. First token is parsed as boolean (accepts "0"/"F"/"N" for false, "1"/"T"/"Y" for true).

---

INIISOExportParameters

Parses the ISO Export section.

Properties:

• AutomaticISOExportOnDownload (bool)
• MMEHeaderTemplateFilename (string)
• PromptUserForMMETemplateFilename (bool)
• ChannelHeaderTemplateFilename (string)
• PromptUserForChannelHeaderFilename (bool)
• FilterOutput (FilterOutputOptions) — Enum with values: UnFiltered = 0, Filtered = 1, PromptUser = 2
• SuppressExportCompletionDialog (bool)
• DummyTemplateFilename (string)
• PromptUserForDummyTemplateFilename (bool)

Methods:

• bool ReadFrom(string line, int curLine, ref List<TDCINIError> errors) — Parses a comma-delimited line with exactly 9 tokens. Boolean tokens accept "0"/"F"/"N" for false and "1"/"T"/"Y" for true.

---

INIRackInventory

Parses the RackInventory section (multi-line).

Nested Class: INIRackInfo

• Number (int)
• SerialNumber (string)
• Size (int)
• IPAddress (string)
• bool ReadFrom(string line, ref List<TDCINIError> errors) — Parses single rack entry (4 tokens)
• TSFRackDescription ToTSFRackDescription() — Converts to TSFRackDescription object

Properties:

• Racks (INIRackInfo[]) — Array of rack information entries

Methods:

• bool ReadFrom(string[] lines, ref int iCurLine, ref List<TDCINIError> errors) — Reads multiple lines until a line starting with "----" is encountered. Decrements iCurLine before returning.

---

3. Invariants

• Number parsing: All numeric parsing uses System.Globalization.NumberStyles.Any with CultureInfo.InvariantCulture — INI files must use invariant culture formatting (period as decimal separator).
• Delimiter: All parsing uses comma (,) as the field delimiter via line.Split(new char[] { ',' }).
• Token count validation: Each parser enforces an exact token count; deviation results in failure.
• Error accumulation: The errors list passed by reference accumulates errors; callers must provide a non-null list.
• Boolean encoding: Boolean fields accept multiple string representations: "0", "F", "N" → false; "1", "T", "Y" → true.
• FilterOutputOptions encoding: Accepts string values "0", "1", "2" mapping to respective enum values.
• RackInventory termination: Multi-line rack inventory must terminate with a line starting with "----".

---

4. Dependencies

This module depends on:

• System
• System.Collections.Generic
• System.Globalization (via CultureInfo.InvariantCulture)
• System.Linq
• System.Text
• TDCINIFile — Static method GetNextLine is called in INIRackInventory.ReadFrom
• TSFRackDescription — Referenced in INIRackInventory.INIRackInfo.ToTSFRackDescription()

What depends on this module:

• Not determinable from source alone; consumers would include any code parsing TDC INI configuration files.

---

5. Gotchas

1. Inconsistent ReadFrom signatures: The method signature varies across classes:
   • INIDataZeroTimeWindowSeconds.ReadFrom takes (string, ref List<TDCINIError>, int) — line number is third parameter
   • TDCINARS232Info.ReadFrom takes `(string, ref List<TDCINIError