Merge branch 'main' of github.com:fossasia/pslab-firmware into frequency

Author: CloudyPadmal

src/commands.c

@@ -252,7 +252,7 @@ command_func_t* const cmd_table[NUM_PRIMARY_CMDS + 1][NUM_SECONDARY_CMDS_MAX + 1
      // 12 READ_PROGRAM_ADDRESS         13 WRITE_PROGRAM_ADDRESS        14 READ_DATA_ADDRESS            15 WRITE_DATA_ADDRESS
         Removed,                        Removed,                        DEVICE_ReadRegisterData,        DEVICE_WriteRegisterData,
      // 16 GET_CAP_RANGE                17 SET_RGB2                     18 READ_LOG                     19 RESTORE_STANDALONE
-        Unimplemented,                  Removed,                        Removed,                        DEVICE_Reset,
+        MULTIMETER_GetCapRange,         Removed,                        Removed,                        DEVICE_Reset,
      // 20 GET_ALTERNATE_HIGH_FREQUENCY 21 SET_RGB_COMMON               22 SET_RGB3                     23 START_CTMU
         MULTIMETER_HighFrequencyAlt,    LIGHT_RGBPin,                   Removed,                        CTMU_Start,
      // 24 STOP_CTMU                    25 START_COUNTING               26 FETCH_COUNT                  27 FILL_BUFFER

src/instruments/multimeter.c

@@ -164,6 +164,35 @@ response_t MULTIMETER_ChargeCapacitor(void) {
     return SUCCESS;
 }
 
+response_t MULTIMETER_GetCapRange(void) {
+
+    uint16_t charge_time = UART1_ReadInt();
+
+    ChargeCapacitor(CHARGE, 50000);
+
+    ADC1_SetOperationMode(ADC1_12BIT_AVERAGING_MODE, CH0_CHANNEL_CAP, 0);
+
+    TMR5_Initialize();
+    TMR5_Period16BitSet(charge_time);
+    TMR5_SetPrescaler(TMR_PRESCALER_64);
+    TMR5_Start();
+
+    // Start charging the capacitor through 10K resistor
+    CAP_OUT_SetDigitalOutput();
+    CAP_OUT_SetHigh();
+
+    TMR5_WaitForInterruptEvent();
+
+    // Stop the charging process
+    CAP_OUT_SetDigitalInput();
+    CAP_OUT_SetLow();
+
+    uint16_t range = GetVoltage_Summed(CH0_CHANNEL_CAP);
+    UART1_WriteInt(range);
+
+    return SUCCESS;
+}
+
 response_t MULTIMETER_GetCapacitance(void) {
 
     uint8_t current_range = UART1_Read();

src/instruments/multimeter.h

@@ -100,6 +100,22 @@ extern "C" {
     */
     response_t MULTIMETER_LowFrequency(void);
 
+    /**
+     * @brief Get an estimate of the capacitor range
+     *
+     * @description
+     * This function can be used to get an estimate of how large a 
+     * capacitor is. One use case could be to compare two different
+     * capacitors without having to evaluate the exact capacitance.
+     * This command takes only one argument over serial:
+     * 1. (uint16) Charge time in micro seconds
+     *
+     * It returns the range value as uint16.
+     *
+     * @return SUCCESS
+     */
+    response_t MULTIMETER_GetCapRange(void);
+
     /**
      * @brief Measurements using Charge Time Measurement Unit
      *