add read measurement convenience method again

Author: LeonieFierz

scd4x_i2c.c

@@ -159,6 +159,20 @@ int16_t scd4x_read_measurement_raw(uint16_t* co2_concentration,
     return local_error;
 }
 
+int16_t scd4x_read_measurement(uint16_t* co2, int32_t* temperature_m_deg_c,
+                               int32_t* humidity_m_percent_rh) {
+    int16_t error;
+    uint16_t temperature;
+    uint16_t humidity;
+    error = scd4x_read_measurement_raw(co2, &temperature, &humidity);
+    if (error) {
+        return error;
+    }
+    *temperature_m_deg_c = ((21875 * (int32_t)temperature) >> 13) - 45000;
+    *humidity_m_percent_rh = ((12500 * (int32_t)humidity) >> 13);
+    return NO_ERROR;
+}
+
 int16_t scd4x_stop_periodic_measurement() {
     int16_t local_error = NO_ERROR;
     uint8_t* buffer_ptr = communication_buffer;

scd4x_i2c.h

@@ -195,6 +195,21 @@ int16_t scd4x_read_measurement_raw(uint16_t* co2_concentration,
                                    uint16_t* temperature,
                                    uint16_t* relative_humidity);
 
+/**
+ * @brief Read sensor output and convert to pyhsical unit.
+ *
+ * See @ref scd4x_read_measurement_raw() for more details.
+ *
+ * @param[out] co2 CO₂ concentration in ppm
+ * @param[out] temperature_m_deg_c Temperature in milli degrees celsius (°C *
+ * 1000)
+ * @param[out] humidity_m_percent_rh Relative humidity in milli percent RH
+ * (%RH * 1000)
+ * @return 0 on success, an error code otherwise
+ */
+int16_t scd4x_read_measurement(uint16_t* co2, int32_t* temperature_m_deg_c,
+                               int32_t* humidity_m_percent_rh);
+
 /**
  * @brief Stop periodic measurement to change the sensor configuration or to
  * save power.