simlyfy

core/dbc_decoder.h

@@ -1,6 +1,6 @@
 /**
  * @file dbc_decoder.h
- * @brief
+ * @brief CAN frame decoding API and result types.
  *
  * Created: 2026-03-13
  * Author: Deeaitch (Dim. Himro)
@@ -29,6 +29,7 @@ struct RawCanFrame {
     RawCanFrame() = default;
 };
 
+/** @brief Outcome of signal extraction and physical conversion. */
 enum class SignalDecodeStatus {
     InvalidDefinition,
     InsufficientPayload,
@@ -56,7 +57,7 @@ struct DecodedSignalValue {
     RawSignalValue rawValue = std::uint64_t(0U);    /**< Exact raw value for Valid or PhysicalConversionFailed. */
     double physicalValue = 0.0;                     /**< Conversion result, possibly NaN/Inf on failure. */
     bool valid = false;                             /**< true if decoding succeeded. */
-    SignalDecodeStatus status = SignalDecodeStatus::InvalidDefinition;
+    SignalDecodeStatus status = SignalDecodeStatus::InvalidDefinition; /**< Detailed signal outcome. */
 
     /** Lookup using the raw integer; nullptr for invalid or unmapped values. */
     const std::string *GetValueDescription() const {