Rename Example01. Add Example02 and setConversionMode

Author: PaulZC

examples/Example01_Basic_SingleShot/Example01_Basic_SingleShot.ino renamed to examples/Example01_SingleShot/Example01_SingleShot.ino

@@ -0,0 +1,72 @@
+/*
+  Using the ADS1219 ADC in continuous mode.
+
+  This example shows how to put the ADS1219 into continuous mode
+  and then read the conversions.
+
+  By: Paul Clark
+  SparkFun Electronics
+  Date: 2023/12/11
+  SparkFun code, firmware, and software is released under the MIT License.
+  Please see LICENSE.md for further details.
+
+  Hardware Connections:
+  IoT RedBoard --> ADS1219
+  QWIIC        --> QWIIC
+
+  Open the serial monitor at 115200 baud to see the voltage.
+
+  Feel like supporting our work? Buy a board from SparkFun!
+  https://www.sparkfun.com/products/23455 - Qwiic ADS1219 1x1
+*/
+
+// You will need the SparkFun Toolkit. Click here to get it: http://librarymanager/All#SparkFun_Toolkit
+
+#include <SparkFun_ADS1219.h> // Click here to get the library: http://librarymanager/All#SparkFun_ADS1219
+
+SfeADS1219ArdI2C myADC;
+
+void setup()
+{
+
+  delay(1000); // Allow time for the microcontroller to start up
+
+  Serial.begin(115200); // Begin the Serial console
+  while (!Serial)
+  {
+    delay(100); // Wait for the user to open the Serial Monitor
+  };
+  Serial.println("SparkFun ADS1219 Example");
+
+  Wire.begin(); // Begin the I2C bus
+
+  // Initialize ADC - this also performs a soft reset
+  while (myADC.begin() == false)
+  {
+    Serial.println("ADC failed to begin. Please check your wiring! Retrying...");
+    delay(1000);
+  }
+
+  // Put the ADC into continuous mode
+  myADC.setConversionMode(ADS1219_CONVERSION_CONTINUOUS);
+
+  // Start the continuous conversions
+  myADC.startSync();
+
+  Serial.println("ADC initialized");
+
+  Serial.println("Reading the differential voltage between AIN0 (+) and AIN1 (-)");
+}
+
+void loop()
+{
+  while (myADC.dataReady() == false) // Check if the conversion is complete. This will return true if data is ready.
+  {
+    delay(10); // The conversion is not complete. Wait a little to avoid pounding the I2C bus.
+  }
+
+  myADC.readConversion(); // Read the conversion result from the ADC. Store it internally.
+  float milliVolts = myADC.getConversionMillivolts(); // Convert to millivolts.
+  Serial.print("ADC voltage (mV): ");
+  Serial.println(milliVolts, 3); // Print milliVolts with 3 decimal places
+}

examples/Example02_Continuous/Example02_Continuous.ino

@@ -30,6 +30,8 @@ bool SfeADS1219Driver::begin()
     if (!reset())
         return false;
 
+    delay(1); // Wait >100us (tRSSTA)
+
     sfe_ads1219_reg_cfg_t config;
     bool result = (_theBus->readRegisterByte(kSfeADS1219RegConfigRead, config.byte) == kSTkErrOk);
     return (result && (config.byte == 0));
@@ -56,6 +58,17 @@ bool SfeADS1219Driver::powerDown()
     return (_theBus->writeByte(kSfeADS1219CommandPowerDown) == kSTkErrOk);
 }
 
+/// @brief Configure the conversion mode.
+/// @return True if successful, false otherwise.
+bool SfeADS1219Driver::setConversionMode(const ads1219_conversion_mode_config_t mode)
+{
+    sfe_ads1219_reg_cfg_t config;
+    if (_theBus->readRegisterByte(kSfeADS1219RegConfigRead, config.byte) != kSTkErrOk) // Read the config register
+        return false;
+    config.cm = (uint8_t)mode; // Update (only) the conversion mode
+    return (_theBus->writeRegisterByte(kSfeADS1219RegConfigWrite, config.byte) == kSTkErrOk); // Write the config register
+}
+
 /// @brief Reads the ADC conversion data, converts it to a usable form, and
 /// saves it to the internal result variable.
 /// @return true if successful, false otherwise.

src/SparkFun_ADS1219.cpp

@@ -178,6 +178,10 @@ class SfeADS1219Driver
     /// @return True if successful, false otherwise.
     bool setInputMultiplexer(const ads1219_input_multiplexer_config_t config = ADS1219_CONFIG_MUX_DIFF_P0_N1);
 
+    /// @brief Configure the conversion mode.
+    /// @return True if successful, false otherwise.
+    bool setConversionMode(const ads1219_conversion_mode_config_t mode = ADS1219_CONVERSION_SINGLE_SHOT);
+
     /// @brief  Return the conversion result which was read by readConversion.
     /// Convert it to mV using referenceVoltageMillivolts and the _adcGain.
     /// @param  referenceVoltageMillivolts Usually the internal 2.048V reference voltage.