Index: firmware/App/Controllers/DGInterface.h =================================================================== diff -u -r6f8273cb2f98b9fecce42d776b0fb6580b315d1f -rec0ae6f3e8dd68564f9ae0d73dc996f58c86d115 --- firmware/App/Controllers/DGInterface.h (.../DGInterface.h) (revision 6f8273cb2f98b9fecce42d776b0fb6580b315d1f) +++ firmware/App/Controllers/DGInterface.h (.../DGInterface.h) (revision ec0ae6f3e8dd68564f9ae0d73dc996f58c86d115) @@ -42,43 +42,43 @@ /// Enumeration of DG pressure sensors. typedef enum DG_PressureSensors { - DG_PRESSURE_SENSOR_RO_PUMP_INLET = 0, ///< RO pump pressure sensor. - DG_PRESSURE_SENSOR_RO_PUMP_OUTLET, ///< RO pump pressure sensor. - DG_PRESSURE_SENSOR_DRAIN_PUMP_INLET, ///< Drain pump inlet pressure. - DG_PRESSURE_SENSOR_DRAIN_PUMP_OUTLET, ///< Drain pump outlet pressure. - NUM_OF_DG_PRESSURE_SENSORS ///< Number of pressure sensors. + DG_PRESSURE_SENSOR_RO_PUMP_INLET = 0, ///< RO pump pressure sensor + DG_PRESSURE_SENSOR_RO_PUMP_OUTLET, ///< RO pump pressure sensor + DG_PRESSURE_SENSOR_DRAIN_PUMP_INLET, ///< Drain pump inlet pressure + DG_PRESSURE_SENSOR_DRAIN_PUMP_OUTLET, ///< Drain pump outlet pressure + NUM_OF_DG_PRESSURE_SENSORS ///< Number of pressure sensors } DG_PRESSURE_SENSORS_T; /// Payload record structure for an RO pump data message. typedef struct { - U32 setPtPSI; - F32 measFlowRateMlMin; - F32 setPWMDutyCyclePct; + U32 setPtPSI; ///< RO pump set target pressure + F32 measFlowRateMlMin; ///< RO pump measured flow rate in mL per min + F32 setPWMDutyCyclePct; ///< RO pump set PWM duty cycle percent } DG_RO_PUMP_DATA_PAYLOAD_T; /// Payload record structure for a drain pump data message. typedef struct { - U32 setPtRPM; - F32 setDAC; + U32 setPtRPM; ///< Drain pump set RPM value + F32 setDAC; ///< Drain pump set DAC value } DG_DRAIN_PUMP_DATA_PAYLOAD_T; /// Payload record structure for a DG pressures data message. typedef struct { - F32 roInPSI; - F32 roOutPSI; - F32 drainInPSI; - F32 drainOutPSI; + F32 roInPSI; ///< DG inlet pressure in PSI + F32 roOutPSI; ///< DG outlet pressure in PSI + F32 drainInPSI; ///< DG drain inlet pressure in PSI + F32 drainOutPSI; ///< DG drain outlet pressure in PSI } DG_PRESSURES_DATA_PAYLOAD_T; /// Payload record structure for a reservoirs data message. typedef struct { - U32 resID; - U32 setFillToVolumeMl; - U32 setDrainToVolumeMl; + U32 resID; ///< Active reservoir ID + U32 setFillToVolumeMl; ///< Reservoir set fill to target volume in ml + U32 setDrainToVolumeMl; ///< Reservoir set drain to target volume in ml } DG_RESERVOIRS_DATA_PAYLOAD_T; /// Payload record structure for DG temperature sensors data message. @@ -113,16 +113,16 @@ /// Payload record structure for a drain reservoir command message. typedef struct { - U32 drainToVolumeML; - BOOL tareLoadCells; + U32 drainToVolumeML; ///< Drain to target volume in ml + BOOL tareLoadCells; ///< Flag indicates to tare load cells or not } DRAIN_RESERVOIR_CMD_PAYLOAD_T; /// DG command response data record structure. typedef struct { - U32 commandID; ///< The command DG is responding to - BOOL rejected; ///< Flag indicates if the command has been rejected - U32 rejectCode; ///< Reason code for rejecting the command + U32 commandID; ///< The command DG is responding to + BOOL rejected; ///< Flag indicates if the command has been rejected + U32 rejectCode; ///< Reason code for rejecting the command } DG_CMD_RESPONSE_T; // ********** public function prototypes **********