1 files changed, 155 insertions, 1 deletions

diff --git a/examples/Alert_Window_Mode_with_Latch/Alert_Window_Mode_with_Latch.ino b/examples/Alert_Window_Mode_with_Latch/Alert_Window_Mode_with_Latch.ino
index 8b13789..0ca337d 100644
--- a/examples/Alert_Window_Mode_with_Latch/Alert_Window_Mode_with_Latch.ino
+++ b/examples/Alert_Window_Mode_with_Latch/Alert_Window_Mode_with_Latch.ino
@@ -1 +1,155 @@
-
+/***************************************************************************

+* Example sketch for the ADS1115_WE library

+*

+* This sketch shows how you can use the alert pin with the latch function. The 

+* only difference to Alert_Window_Mode.ino is that latch is enabled (line 112) 

+* and that the alert pin needs to be unlatched (line 148). Try and see the difference.

+* As an alternative to the unlatchAlertPin function you can use getResult_V. 

+* Internally unlatchAlertPin just performs a read of the conversion register.

+*  

+* Further information can be found on:

+* https://wolles-elektronikkiste.de/ads1115

+* 

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

+

+#include<ADS1115_WE.h> 

+#include<Wire.h>

+#define I2C_ADDRESS 0x48

+volatile int interruptPin = 2;

+int ledPin = 10;

+volatile bool outOfLimit = false;

+

+ADS1115_WE adc(I2C_ADDRESS);

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

+

+void setup() {

+  Wire.begin();

+  Serial.begin(9600);

+  

+  pinMode(interruptPin, INPUT_PULLUP);

+  pinMode(ledPin, OUTPUT);

+  digitalWrite(ledPin, LOW);

+  

+  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 paramater 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); //uncomment if you want to change the default

+

+  /* Set number of conversions out of limit after which the alert pin will be active

+   * - or you can disable the alert (including conversion ready alert)

+   *  

+   *  ADS1115_ASSERT_AFTER_1  -> after 1 conversion

+   *  ADS1115_ASSERT_AFTER_2  -> after 2 conversions

+   *  ADS1115_ASSERT_AFTER_3  -> after 3 conversions

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

+   */

+  adc.setAlertPinMode(ADS1115_ASSERT_AFTER_1); // you can also choose ...AFTER_2 or 3 for this sketch

+

+  /* 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 continous or single shot mode:

+   * 

+   *  ADS1115_CONTINOUS  ->  continous mode

+   *  ADS1115_SINGLE     ->  single shot mode (default)

+   */

+  adc.setMeasureMode(ADS1115_CONTINOUS); //comment or change if you want to change single shot

+

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

+   *  be active 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 will be deactivated 

+   *  again (if not latched!)  

+   * 

+   *  ADS1115_MAX_LIMIT

+   *  ADS1115_WINDOW

+   * 

+   */

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

+  

+  /* Enable or disable latch. If latch is enabled the alarm pin will be active until the

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

+   * deactivated 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:

+   *  

+   *  /* Enable or disable latch. If latch is enabled the alarm pin will be active until the

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

+   * deactivated with next value within limits. 

+   *  

+   * 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 be active, 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 - uses the Alert Pin / Window Mode / Latch enabled");

+  Serial.println();

+  Serial.println("Waiting for Value out of Limit");

+  attachInterrupt(digitalPinToInterrupt(interruptPin), outOfLimitAlert, FALLING);

+  adc.startSingleMeasurement();

+}

+

+void loop() {

+  float voltage = 0.0;

+  if(outOfLimit){

+    voltage = adc.getResult_V();

+    Serial.print("Voltage [V]: ");

+    Serial.println(voltage);  

+    digitalWrite(ledPin,HIGH);

+    delay(1000);

+    digitalWrite(ledPin,LOW);

+    outOfLimit = false;

+    attachInterrupt(digitalPinToInterrupt(interruptPin), outOfLimitAlert, FALLING); 

+    adc.unlatchAlertPin(); // unlatches the alert Pin (alternatively use getResult_V)

+  } 

+}

+

+void outOfLimitAlert(){

+  detachInterrupt(2);

+  outOfLimit = true;

+}