diff options
author | Wolfgang (Wolle) Ewald <wolfgang.ewald@wolles-elektronikkiste.de> | 2020-08-08 11:53:15 +0200 |
---|---|---|
committer | GitHub <noreply@github.com> | 2020-08-08 11:53:15 +0200 |
commit | 6fa375430ed70ee2c400f8a71a21e11e73f51a21 (patch) | |
tree | f8bc42c66310cff52ff547aadd32e8153057e22f /src/ADS1115_WE.h | |
parent | Add files via upload (diff) | |
download | ADS1115_WE-6fa375430ed70ee2c400f8a71a21e11e73f51a21.tar ADS1115_WE-6fa375430ed70ee2c400f8a71a21e11e73f51a21.tar.gz ADS1115_WE-6fa375430ed70ee2c400f8a71a21e11e73f51a21.tar.bz2 ADS1115_WE-6fa375430ed70ee2c400f8a71a21e11e73f51a21.tar.lz ADS1115_WE-6fa375430ed70ee2c400f8a71a21e11e73f51a21.tar.xz ADS1115_WE-6fa375430ed70ee2c400f8a71a21e11e73f51a21.tar.zst ADS1115_WE-6fa375430ed70ee2c400f8a71a21e11e73f51a21.zip |
Diffstat (limited to 'src/ADS1115_WE.h')
-rw-r--r-- | src/ADS1115_WE.h | 81 |
1 files changed, 40 insertions, 41 deletions
diff --git a/src/ADS1115_WE.h b/src/ADS1115_WE.h index 888ef00..ae75df6 100644 --- a/src/ADS1115_WE.h +++ b/src/ADS1115_WE.h @@ -110,26 +110,26 @@ public: void reset(); bool init(); - /* Set number of conversions after which the alert pin will be active + /* Set number of conversions after which the alert pin will be active * - 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) - */ + */ void setAlertPinMode(ADS1115_COMP_QUE mode); - /* Enable or disable latch. If latch is enabled the alarm pin will be active until the + /* 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 - */ + */ void setAlertLatch(ADS1115_LATCH latch); - /* Sets the alert pin polarity if active: + /* 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 @@ -137,10 +137,10 @@ public: * * ADS1115_ACT_LOW -> active low (default) * ADS1115_ACT_HIGH -> active high - */ + */ void setAlertPol(ADS1115_ALERT_POL polarity); - /* Choose maximum limit or maximum and minimum alert limit (window)in Volt - alert pin will + /* Choose maximum limit or maximum 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 (if @@ -148,10 +148,10 @@ public: * * ADS1115_MAX_LIMIT * ADS1115_WINDOW - */ + */ void setAlertModeAndLimit_V(ADS1115_COMP_MODE mode, float hithres, float lothres); - /* Set the conversion rate in SPS (samples per second) + /* Set the conversion rate in SPS (samples per second) * Options should be self-explaining: * * ADS1115_8_SPS @@ -162,18 +162,17 @@ public: * ADS1115_250_SPS * ADS1115_475_SPS * ADS1115_860_SPS - */ + */ void setConvRate(ADS1115_CONV_RATE rate); - /* Set continuous or single shot mode: + /* Set continuous or single shot mode: * * ADS1115_CONTINUOUS -> continuous mode * ADS1115_SINGLE -> single shot mode (default) - */ + */ void setMeasureMode(ADS1115_MEASURE_MODE mode); - /* - * Set the voltage range of the ADC to adjust the gain + /* 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 @@ -182,10 +181,10 @@ public: * ADS1115_RANGE_1024 -> +/- 1024 mV * ADS1115_RANGE_0512 -> +/- 512 mV * ADS1115_RANGE_0256 -> +/- 256 mV - */ + */ void setVoltageRange_mV(ADS1115_RANGE range); - /* Set the inputs to be compared + /* Set the inputs to be compared * * ADS1115_COMP_0_1 -> compares 0 with 1 (default) * ADS1115_COMP_0_3 -> compares 0 with 3 @@ -195,7 +194,7 @@ public: * ADS1115_COMP_1_GND -> compares 1 with GND * ADS1115_COMP_2_GND -> compares 2 with GND * ADS1115_COMP_3_GND -> compares 3 with GND - */ + */ void setCompareChannels(ADS1115_MUX mux); bool isBusy(); @@ -203,39 +202,39 @@ public: float getResult_V(); float getResult_mV(); - /* Get the raw result from the conversion register: - * The conversion register contains the conversion result of the amplified (!) - * voltage. This means the value depends on the voltage as well as on the - * voltage range. E.g. if the voltage range is 6.144 mV (ADS1115_RANGE_6144), - * +32767 is 6.144 mV; if the range is 4.096 mV, +32767 is 4.096 mV, and so on. - */ + /* Get the raw result from the conversion register: + * The conversion register contains the conversion result of the amplified (!) + * voltage. This means the value depends on the voltage as well as on the + * voltage range. E.g. if the voltage range is 6.144 mV (ADS1115_RANGE_6144), + * +32767 is 6.144 mV; if the range is 4.096 mV, +32767 is 4.096 mV, and so on. + */ int16_t getRawResult(); - /* Skaling of the result to a different range: - * The results in the conversion register are in a range of -32767 to +32767 - * You might want to receive the result in a different scale, e.g. -1023 to 1023. - * For -1023 to 1023, and if you have chosen e.g. ADS1115_RANGE_4096, 0 Volt would - * give 0 as result and 4.096 mV would give 1023. -4.096 mV would give -1023. - */ + /* Skaling of the result to a different range: + * The results in the conversion register are in a range of -32767 to +32767 + * You might want to receive the result in a different scale, e.g. -1023 to 1023. + * For -1023 to 1023, and if you have chosen e.g. ADS1115_RANGE_4096, 0 Volt would + * give 0 as result and 4.096 mV would give 1023. -4.096 mV would give -1023. + */ int16_t getResultWithRange(int16_t min, int16_t max); - /* Scaling of the result to a different range plus scaling to a voltage range: - * You can use this variant if you also want to scale to a voltage range. E.g. in - * in order to get results equivalent to an Arduino UNO (10 bit, 5000 mV range), you - * would choose getResultWithRange(-1023, 1023, 5000). A difference to the Arduino - * UNO is that you can measure negative voltages. - * You have to ensure that the voltage range you scale to is smaller than the - * measuring voltage range. For this example only ADS1115_RANGE_6144 would cover the - * scale up to 5000 mV. - */ + /* Scaling of the result to a different range plus scaling to a voltage range: + * You can use this variant if you also want to scale to a voltage range. E.g. in + * in order to get results equivalent to an Arduino UNO (10 bit, 5000 mV range), you + * would choose getResultWithRange(-1023, 1023, 5000). A difference to the Arduino + * UNO is that you can measure negative voltages. + * You have to ensure that the voltage range you scale to is smaller than the + * measuring voltage range. For this example only ADS1115_RANGE_6144 would cover the + * scale up to 5000 mV. + */ int16_t getResultWithRange(int16_t min, int16_t max, int16_t maxVoltage); - /* This function returns the voltage range ADS1115_RANGE_XXXX in Millivolt */ + /* This function returns the voltage range ADS1115_RANGE_XXXX in Millivolt */ uint16_t getVoltageRange_mV(); - /* With this function the alert pin will be active, when a conversion is ready. + /* With this function the alert pin will be active, when a conversion is ready. * In order to deactivate, use the setAlertLimit_V function - */ + */ void setAlertPinToConversionReady(); void clearAlert(); |