ads1x15: extend examples for both ads1015 and ads1115 and clarify which one is used where

Signed-off-by: Mihai Tudor Panu <mihai.tudor.panu@intel.com>

examples/java/Ads1015Sample.java

@@ -22,9 +22,10 @@
  * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  */
 
-/* This example demonstrates how to use one of the ADS1015 ADCs on the
- * DFRobot Joule Shield with devices that output a small differential
- * voltage (e.g. geophones, piezoelectric bands or pads, thermocouples).
+/* This example demonstrates how to use one the ADS1015 ADC on the Grove Joule
+ * Shield or the Sparkfun ADC Block for Edison with devices that output a small
+ * differential voltage (e.g. geophones, piezoelectric bands or pads,
+ * thermocouples).
  */
 import java.io.*;
 import java.util.concurrent.*;
@@ -35,7 +36,7 @@ public class Ads1015Sample
     static boolean running = true;
     static int id = 0; // Sample number
     static String fileName = "./ads1015.data"; // Output filename
-    
+
     public static void main(String[] args) throws InterruptedException
     {
         // Open the output file
@@ -48,22 +49,18 @@ public class Ads1015Sample
             System.out.println("Failed to open output file for writing: " + e.toString());
             System.exit(1);
         }
-        
-        // Initialize and configure the ADS1015 for the SM-24 Geophone
-        // There are two ADS1015 chips on the DFRobot Joule Shield on the same I2C bus
-        //     - 0x48 gives access to pins A0 - A3
-        //     - 0x49 gives access to pins A4 - A7
+
+        // Initialize and configure the ADS1015
         ADS1015 ads1015 = new ADS1015(0, (short)0x48);
-        
-        // Put the ADC into differential mode for pins A0 and A1,
-        // the SM-24 Geophone is connected to these pins
+
+        // Put the ADC into differential mode for pins A0 and A1
         ads1015.getSample(ADS1X15.ADSMUXMODE.DIFF_0_1);
 
         // Set the gain based on expected VIN range to -/+ 2.048 V
         // Can be adjusted based on application to as low as -/+ 0.256 V, see API
-        // documentation for details        
+        // documentation for details
         ads1015.setGain(ADS1X15.ADSGAIN.GAIN_TWO);
-        
+
         // Set the sample rate to 3300 samples per second (max) and turn on continuous
         // sampling
         ads1015.setSPS(ADS1015.ADSSAMPLERATE.SPS_3300);
@@ -71,24 +68,24 @@ public class Ads1015Sample
 
         // Schedule a task to stop logging after 10 seconds
         Executors.newSingleThreadScheduledExecutor().schedule(new Runnable() {
-            @Override 
+            @Override
             public void run() {
                 running = false;
             }
         }, 10, TimeUnit.SECONDS);
-        
+
         // Read from sensor and write to file every ms
         while(running){
             try {
                 bw.write(id + " " + String.format("%.7f", ads1015.getLastSample()) + "\n");
             } catch (IOException e) {
                 System.out.println("Failed to write sample " + id + " to file: "+ e.toString());
-                System.exit(1);                
+                System.exit(1);
             }
             id++;
             Thread.sleep(1);
         }
-        
+
         // Close and exit
         try {
             bw.close();

examples/java/Ads1115Sample.java

@@ -0,0 +1,103 @@
+/*
+ * Author: Mihai Tudor Panu <mihai.tudor.panu@intel.com>
+ * Copyright (c) 2016 Intel Corporation.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files (the
+ * "Software"), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sublicense, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+ * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+ * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+ * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+/* This example demonstrates how to use one of the ADS1115 ADCs on the
+ * DFRobot Joule Shield with devices that output a small differential
+ * voltage (e.g. geophones, piezoelectric bands or pads, thermocouples).
+ */
+import java.io.*;
+import java.util.concurrent.*;
+import upm_ads1x15.*;
+
+public class Ads1115Sample
+{
+    static boolean running = true;
+    static int id = 0; // Sample number
+    static String fileName = "./ads1115.data"; // Output filename
+
+    public static void main(String[] args) throws InterruptedException
+    {
+        // Open the output file
+        FileWriter fw = null;
+        BufferedWriter bw = null;
+        try {
+            fw = new FileWriter(fileName);
+            bw = new BufferedWriter(fw);
+        } catch (IOException e) {
+            System.out.println("Failed to open output file for writing: " + e.toString());
+            System.exit(1);
+        }
+
+        // Initialize and configure the ADS1115 for the SM-24 Geophone
+        // There are two ADS1115 chips on the DFRobot Joule Shield on the same I2C bus
+        //     - 0x48 gives access to pins A0 - A3
+        //     - 0x49 gives access to pins A4 - A7
+        ADS1115 ads1115 = new ADS1115(0, (short)0x48);
+
+        // Put the ADC into differential mode for pins A0 and A1,
+        // the SM-24 Geophone is connected to these pins
+        ads1115.getSample(ADS1X15.ADSMUXMODE.DIFF_0_1);
+
+        // Set the gain based on expected VIN range to -/+ 2.048 V
+        // Can be adjusted based on application to as low as -/+ 0.256 V, see API
+        // documentation for details
+        ads1115.setGain(ADS1X15.ADSGAIN.GAIN_TWO);
+
+        // Set the sample rate to 860 samples per second (max) and turn on continuous
+        // sampling
+        ads1115.setSPS(ADS1115.ADSDATARATE.SPS_860);
+        ads1115.setContinuous(true);
+
+        // Schedule a task to stop logging after 10 seconds
+        Executors.newSingleThreadScheduledExecutor().schedule(new Runnable() {
+            @Override
+            public void run() {
+                running = false;
+            }
+        }, 10, TimeUnit.SECONDS);
+
+        // Read from sensor and write to file every ms
+        while(running){
+            try {
+                bw.write(id + " " + String.format("%.7f", ads1115.getLastSample()) + "\n");
+            } catch (IOException e) {
+                System.out.println("Failed to write sample " + id + " to file: "+ e.toString());
+                System.exit(1);
+            }
+            id++;
+            Thread.sleep(1);
+        }
+
+        // Close and exit
+        try {
+            bw.close();
+            fw.close();
+        } catch (IOException e) {
+            System.out.println("Failed to close output file cleanly: " + e.toString());
+            System.exit(1);
+        }
+        System.out.println("Wrote " + id + " samples to file: " + fileName);
+        System.exit(0);
+    }
+}

examples/java/CMakeLists.txt

@@ -163,6 +163,7 @@ add_example(MB704X_Example mb704x)
 add_example(MCP2515_Example mcp2515)
 add_example(Ads1015Sample ads1x15)
 add_example(MAX30100_Example max30100)
+add_example(Ads1115Sample ads1x15)
 
 add_example_with_path(Jhd1313m1_lcdSample lcd i2clcd)
 add_example_with_path(Jhd1313m1Sample lcd i2clcd)