1 files changed, 157 insertions, 126 deletions

diff --git a/examples/Continuous/Continuous.ino b/examples/Continuous/Continuous.ino
index 3f4ca68..ce41808 100644
--- a/examples/Continuous/Continuous.ino
+++ b/examples/Continuous/Continuous.ino
@@ -1,126 +1,157 @@
-/***************************************************************************
-* Example sketch for the ADS1115_WE library
-*
-* This sketch shows how to use the ADS1115 in continuous mode. 
-*  
-* Further information can be found on:
-* https://wolles-elektronikkiste.de/ads1115 (German)
-* https://wolles-elektronikkiste.de/en/ads1115-a-d-converter-with-amplifier (English)
-* 
-***************************************************************************/
-
-#include<ADS1115_WE.h> 
-#include<Wire.h>
-#define I2C_ADDRESS 0x48
-
-ADS1115_WE adc(I2C_ADDRESS);
-// ADS1115_WE adc = ADS1115_WE(); // Alternative: uses default address 0x48
-
-void setup() {
-  Wire.begin();
-  Serial.begin(9600);
-  if(!adc.init()){
-    Serial.println("ADS1115 not connected!");
-  }
-
-  /* Set the voltage range of the ADC to adjust the gain
-   * Please note that you must not apply more than VDD + 0.3V to the input pins!
-   * 
-   * ADS1115_RANGE_6144  ->  +/- 6144 mV
-   * ADS1115_RANGE_4096  ->  +/- 4096 mV
-   * ADS1115_RANGE_2048  ->  +/- 2048 mV (default)
-   * ADS1115_RANGE_1024  ->  +/- 1024 mV
-   * ADS1115_RANGE_0512  ->  +/- 512 mV
-   * ADS1115_RANGE_0256  ->  +/- 256 mV
-   */
-  adc.setVoltageRange_mV(ADS1115_RANGE_6144); //comment line/change parameter to change range
-
-  /* Set the inputs to be compared
-   *  
-   *  ADS1115_COMP_0_1    ->  compares 0 with 1 (default)
-   *  ADS1115_COMP_0_3    ->  compares 0 with 3
-   *  ADS1115_COMP_1_3    ->  compares 1 with 3
-   *  ADS1115_COMP_2_3    ->  compares 2 with 3
-   *  ADS1115_COMP_0_GND  ->  compares 0 with GND
-   *  ADS1115_COMP_1_GND  ->  compares 1 with GND
-   *  ADS1115_COMP_2_GND  ->  compares 2 with GND
-   *  ADS1115_COMP_3_GND  ->  compares 3 with GND
-   */
-  adc.setCompareChannels(ADS1115_COMP_0_GND); //comment line/change parameter to change channel
-
-  /* Set number of conversions after which the alert pin asserts
-   * - or you can disable the alert 
-   *  
-   *  ADS1115_ASSERT_AFTER_1  -> after 1 conversion
-   *  ADS1115_ASSERT_AFTER_2  -> after 2 conversions
-   *  ADS1115_ASSERT_AFTER_4  -> after 4 conversions
-   *  ADS1115_DISABLE_ALERT   -> disable comparator / alert pin (default) 
-   */
-  //adc.setAlertPinMode(ADS1115_ASSERT_AFTER_1); //uncomment if you want to change the default
-
-  /* Set the conversion rate in SPS (samples per second)
-   * Options should be self-explaining: 
-   * 
-   *  ADS1115_8_SPS 
-   *  ADS1115_16_SPS  
-   *  ADS1115_32_SPS 
-   *  ADS1115_64_SPS  
-   *  ADS1115_128_SPS (default)
-   *  ADS1115_250_SPS 
-   *  ADS1115_475_SPS 
-   *  ADS1115_860_SPS 
-   */
-  // adc.setConvRate(ADS1115_8_SPS); //uncomment if you want to change the default
-
-  /* Set continuous or single shot mode:
-   * 
-   *  ADS1115_CONTINUOUS  ->  continuous mode
-   *  ADS1115_SINGLE     ->  single shot mode (default)
-   */
-  adc.setMeasureMode(ADS1115_CONTINUOUS); //comment line/change parameter to change mode
-
-   /* Choose maximum limit or maximum and minimum alert limit (window) in Volt - alert pin will 
-   *  assert when measured values are beyond the maximum limit or outside the window 
-   *  Upper limit first: setAlertLimit_V(MODE, maximum, minimum)
-   *  In max limit mode the minimum value is the limit where the alert pin assertion will be  
-   *  cleared (if not latched)  
-   * 
-   *  ADS1115_MAX_LIMIT
-   *  ADS1115_WINDOW
-   * 
-   */
-  //adc.setAlertModeAndLimit_V(ADS1115_MAX_LIMIT, 3.0, 1.5); //uncomment if you want to change the default
-  
-  /* Enable or disable latch. If latch is enabled the alert pin will assert until the
-   * conversion register is read (getResult functions). If disabled the alert pin assertion will be
-   * cleared with next value within limits. 
-   *  
-   *  ADS1115_LATCH_DISABLED (default)
-   *  ADS1115_LATCH_ENABLED
-   */
-  //adc.setAlertLatch(ADS1115_LATCH_ENABLED); //uncomment if you want to change the default
-
-  /* Sets the alert pin polarity if active:
-   *  
-   * ADS1115_ACT_LOW  ->  active low (default)   
-   * ADS1115_ACT_HIGH ->  active high
-   */
-  //adc.setAlertPol(ADS1115_ACT_LOW); //uncomment if you want to change the default
- 
-  /* With this function the alert pin will assert, when a conversion is ready.
-   * In order to deactivate, use the setAlertLimit_V function  
-   */
-  //adc.setAlertPinToConversionReady(); //uncomment if you want to change the default
-
-  Serial.println("ADS1115 Example Sketch - Continuous Mode");
-  Serial.println();
-}
-
-void loop() {
-  float voltage = 0.0;
-  voltage = adc.getResult_V(); // alternative: getResult_mV for Millivolt
-  Serial.print("Channel 0 vs GND [V]: ");
-  Serial.println(voltage);
-  Serial.println("-------------------------------");
-  delay(2000);
-}
+/***************************************************************************

+* Example sketch for the ADS1115_WE library

+*

+* This sketch shows how to use the ADS1115 in continuous mode. 

+*  

+* Further information can be found on:

+* https://wolles-elektronikkiste.de/ads1115 (German)

+* https://wolles-elektronikkiste.de/en/ads1115-a-d-converter-with-amplifier (English)

+* 

+***************************************************************************/

+

+#include<ADS1115_WE.h> 

+#include<Wire.h>

+#define I2C_ADDRESS 0x48

+

+ADS1115_WE adc(I2C_ADDRESS);

+// ADS1115_WE adc = ADS1115_WE(); // Alternative: uses default address 0x48

+

+void setup() {

+  Wire.begin();

+  Serial.begin(9600);

+  if(!adc.init()){

+    Serial.println("ADS1115 not connected!");

+  }

+

+  /* Set the voltage range of the ADC to adjust the gain

+   * Please note that you must not apply more than VDD + 0.3V to the input pins!

+   * 

+   * ADS1115_RANGE_6144  ->  +/- 6144 mV

+   * ADS1115_RANGE_4096  ->  +/- 4096 mV

+   * ADS1115_RANGE_2048  ->  +/- 2048 mV (default)

+   * ADS1115_RANGE_1024  ->  +/- 1024 mV

+   * ADS1115_RANGE_0512  ->  +/- 512 mV

+   * ADS1115_RANGE_0256  ->  +/- 256 mV

+   */

+  adc.setVoltageRange_mV(ADS1115_RANGE_6144); //comment line/change parameter to change range

+

+  /* Set the inputs to be compared

+   *  

+   *  ADS1115_COMP_0_1    ->  compares 0 with 1 (default)

+   *  ADS1115_COMP_0_3    ->  compares 0 with 3

+   *  ADS1115_COMP_1_3    ->  compares 1 with 3

+   *  ADS1115_COMP_2_3    ->  compares 2 with 3

+   *  ADS1115_COMP_0_GND  ->  compares 0 with GND

+   *  ADS1115_COMP_1_GND  ->  compares 1 with GND

+   *  ADS1115_COMP_2_GND  ->  compares 2 with GND

+   *  ADS1115_COMP_3_GND  ->  compares 3 with GND

+   */

+  adc.setCompareChannels(ADS1115_COMP_0_GND); //comment line/change parameter to change channel

+

+  /* Set number of conversions after which the alert pin asserts

+   * - or you can disable the alert 

+   *  

+   *  ADS1115_ASSERT_AFTER_1  -> after 1 conversion

+   *  ADS1115_ASSERT_AFTER_2  -> after 2 conversions

+   *  ADS1115_ASSERT_AFTER_4  -> after 4 conversions

+   *  ADS1115_DISABLE_ALERT   -> disable comparator / alert pin (default) 

+   */

+  //adc.setAlertPinMode(ADS1115_ASSERT_AFTER_1); //uncomment if you want to change the default

+

+  /* Set the conversion rate in SPS (samples per second)

+   * Options should be self-explaining: 

+   * 

+   *  ADS1115_8_SPS 

+   *  ADS1115_16_SPS  

+   *  ADS1115_32_SPS 

+   *  ADS1115_64_SPS  

+   *  ADS1115_128_SPS (default)

+   *  ADS1115_250_SPS 

+   *  ADS1115_475_SPS 

+   *  ADS1115_860_SPS 

+   */

+  // adc.setConvRate(ADS1115_8_SPS); //uncomment if you want to change the default

+

+  /* Set continuous or single shot mode:

+   * 

+   *  ADS1115_CONTINUOUS  ->  continuous mode

+   *  ADS1115_SINGLE     ->  single shot mode (default)

+   */

+  adc.setMeasureMode(ADS1115_CONTINUOUS); //comment line/change parameter to change mode

+

+   /* Choose maximum limit or maximum and minimum alert limit (window) in Volt - alert pin will 

+   *  assert when measured values are beyond the maximum limit or outside the window 

+   *  Upper limit first: setAlertLimit_V(MODE, maximum, minimum)

+   *  In max limit mode the minimum value is the limit where the alert pin assertion will be  

+   *  cleared (if not latched)  

+   * 

+   *  ADS1115_MAX_LIMIT

+   *  ADS1115_WINDOW

+   * 

+   */

+  //adc.setAlertModeAndLimit_V(ADS1115_MAX_LIMIT, 3.0, 1.5); //uncomment if you want to change the default

+  

+  /* Enable or disable latch. If latch is enabled the alert pin will assert until the

+   * conversion register is read (getResult functions). If disabled the alert pin assertion will be

+   * cleared with next value within limits. 

+   *  

+   *  ADS1115_LATCH_DISABLED (default)

+   *  ADS1115_LATCH_ENABLED

+   */

+  //adc.setAlertLatch(ADS1115_LATCH_ENABLED); //uncomment if you want to change the default

+

+  /* Sets the alert pin polarity if active:

+   *  

+   * ADS1115_ACT_LOW  ->  active low (default)   

+   * ADS1115_ACT_HIGH ->  active high

+   */

+  //adc.setAlertPol(ADS1115_ACT_LOW); //uncomment if you want to change the default

+ 

+  /* With this function the alert pin will assert, when a conversion is ready.

+   * In order to deactivate, use the setAlertLimit_V function  

+   */

+  //adc.setAlertPinToConversionReady(); //uncomment if you want to change the default

+

+  Serial.println("ADS1115 Example Sketch - Continuous Mode");

+  Serial.println("All values in volts");

+  Serial.println();

+}

+

+  /* If you change the compare channels you can immediately read values from the conversion 

+   * register, although they might belong to the former channel if no precautions are taken. 

+   * It takes about the time needed for two conversions to get the correct data. In single 

+   * shot mode you can use the isBusy() function to wait for data from the new channel. This 

+   * does not work in continuous mode. 

+   * To solve this issue the library adds a delay after change of channels if you are in contunuous

+   * mode. The length of the delay is adjusted to the conversion rate. But be aware that the output 

+   * rate will be much lower that the conversion rate if you change channels frequently. 

+   */

+

+void loop() {

+  float voltage = 0.0;

+

+  Serial.print("0: ");

+  voltage = readChannel(ADS1115_COMP_0_GND);

+  Serial.print(voltage);

+

+  Serial.print(",   1: ");

+  voltage = readChannel(ADS1115_COMP_1_GND);

+  Serial.print(voltage);

+  

+  Serial.print(",   2: ");

+  voltage = readChannel(ADS1115_COMP_2_GND);

+  Serial.print(voltage);

+

+  Serial.print(",   3: ");

+  voltage = readChannel(ADS1115_COMP_3_GND);

+  Serial.println(voltage);

+

+  delay(1000);

+}

+

+float readChannel(ADS1115_MUX channel) {

+  float voltage = 0.0;

+  adc.setCompareChannels(channel);

+  voltage = adc.getResult_V(); // alternative: getResult_mV for Millivolt

+  return voltage;

+}