Add new RAK12020

RAKWireless · Sep 18, 2023 · 4d5e565 · 4d5e565
1 parent 2d5fc4e
commit 4d5e565
Show file tree

Hide file tree

Showing 3 changed files with 282 additions and 0 deletions.
diff --git a/README.md b/README.md
@@ -61,6 +61,8 @@ To buy WisBlock modules please visit our [online store](https://store.rakwireles
             - [RAK12008_CO2](/examples/common/sensors/RAK12008/)
             - [RAK12011_MEMS_Pressure_LPS33HW](/examples/common/sensors/RAK12011_MEMS_Pressure_LPS33HW/)
             - [RAK12019_UVlight_LTR390](/examples/common/sensors/RAK12019_UVlight_LTR390/)
+            - [RAK12020_Light_TSL_INT_TSL2591](/examples/common/sensors/RAK12020_Light_TSL_INT_TSL2591/)
+            - [RAK12020_Light_TSL_Read_TSL2591](/examples/common/sensors/RAK12020_Light_TSL_Read_TSL2591/)
             - [RAK12025_Gyroscope](/examples/common/sensors/RAK12025_Gyroscope/)
             - [RAK12027_Earthquake](/examples/common/sensors/RAK12027_Earthquake/)
             - [RAK12032_3_Axis_ADXL313](/examples/common/sensors/RAK12032_3_Axis_ADXL313/)

diff --git a/examples/common/sensors/RAK12020_Light_TSL_INT_TSL2591/RAK12020_Light_TSL_INT_TSL2591.ino b/examples/common/sensors/RAK12020_Light_TSL_INT_TSL2591/RAK12020_Light_TSL_INT_TSL2591.ino
@@ -0,0 +1,163 @@
+ /**
+   @file RAK12020_Light_TSL_INT_TSL2591.ino
+   @author rakwireless.com
+   @brief   This example shows how the interrupt system on the TLS2591.
+						Can be used to detect a meaningful change in light levels.
+   @version 0.1
+   @date 2022-03-15
+   @copyright Copyright (c) 2022
+**/
+#include <Wire.h>
+#include <Adafruit_Sensor.h>
+#include "Adafruit_TSL2591.h" // Click to install library: http://librarymanager/All#Adafruit_TSL2591
+
+#define THRESHOLD_LOWER               (100)                 // Interrupt thresholds.
+#define THRESHOLD_UPPER               (1500)
+
+#define TLS2591_INT_PERSIST           (TSL2591_PERSIST_ANY) // Fire on any valid change.
+
+#define INT_PIN                       WB_IO1                // Mount in SLOT A.
+//#define INT_PIN                       WB_IO3                // Mount in SLOT C.
+//#define INT_PIN                       WB_IO5                // Mount in SLOT D.
+
+Adafruit_TSL2591 TSL2591 = Adafruit_TSL2591(2591);
+
+volatile uint8_t g_intFlag = 0;
+
+void INT_call_back()
+{
+  g_intFlag = 1;
+}
+
+void setup(void)
+{
+	// Sensor power on.
+  pinMode(WB_IO2, OUTPUT);
+  digitalWrite(WB_IO2, HIGH); 
+
+  // Initialize Serial for debug output.
+  time_t timeout = millis();
+  Serial.begin(115200);
+  while (!Serial)
+  {
+    if ((millis() - timeout) < 5000)
+    {
+      delay(100);
+    }
+    else
+    {
+      break;
+    }
+  }
+
+  Serial.println("Starting RAK12020 TSL2591 interrupt Test!");
+
+  if (TSL2591.begin())
+  {
+    Serial.println("Found a TSL2591 sensor");
+  }
+  else
+  {
+    while (1)
+    {
+      Serial.println("No sensor found ... check your wiring?");
+      delay(1000);
+    }
+  }
+
+  // Display some basic information on this sensor.
+  sensor_t sensor;
+  TSL2591.getSensor(&sensor);
+  Serial.println("------------------------------------");
+  Serial.print  ("Sensor:       "); 
+  Serial.println(sensor.name);
+  Serial.print  ("Driver Ver:   "); 
+  Serial.println(sensor.version);
+  Serial.print  ("Unique ID:    "); 
+  Serial.println(sensor.sensor_id);
+  Serial.print  ("Max Value:    "); 
+  Serial.print  (sensor.max_value); 
+  Serial.println(" lux");
+  Serial.print  ("Min Value:    "); 
+  Serial.print  (sensor.min_value); 
+  Serial.println(" lux");
+  Serial.print  ("Resolution:   "); 
+  Serial.print  (sensor.resolution, 4); 
+  Serial.println(" lux");
+  Serial.println("------------------------------------");
+  Serial.println("");
+  delay(500);
+
+  /*
+   * @brief You can change the gain on the fly, to adapt to brighter/dimmer light situations.
+   * @param
+   *    TSL2591_GAIN_LOW    1x    gain
+   *    TSL2591_GAIN_MED    25x   gain
+   *    TSL2591_GAIN_HIGH   428x  gain
+   *    TSL2591_GAIN_MAX    9876x gain
+   */
+  TSL2591.setGain(TSL2591_GAIN_MED);  // 25x gain.
+
+  /*
+   * @brief Changing the integration time gives you a longer time over which to sense light
+   *        longer timelines are slower, but are good in very low light situtations!
+   * @param
+   *    TSL2591_INTEGRATIONTIME_100MS     shortest integration time (bright light)
+   *    TSL2591_INTEGRATIONTIME_200MS     
+   *    TSL2591_INTEGRATIONTIME_300MS     
+   *    TSL2591_INTEGRATIONTIME_400MS     
+   *    TSL2591_INTEGRATIONTIME_500MS     
+   *    TSL2591_INTEGRATIONTIME_600MS     longest integration time (dim light)
+   */
+  TSL2591.setTiming(TSL2591_INTEGRATIONTIME_100MS);  // shortest integration time (bright light)
+
+  /*
+   * @brief Setup the SW interrupt to trigger between 100 and 1500 lux.
+   *        Threshold values are defined at the top of this sketch.
+   */
+  TSL2591.clearInterrupt();
+  TSL2591.registerInterrupt(THRESHOLD_LOWER,THRESHOLD_UPPER,TLS2591_INT_PERSIST);
+
+  pinMode(INT_PIN,INPUT);  // Connect with INT pin.
+  attachInterrupt(digitalPinToInterrupt(INT_PIN) ,INT_call_back ,FALLING);  // Enable interrupts.
+
+  Serial.print("Interrupt Threshold Window: ");
+  Serial.print(THRESHOLD_LOWER, DEC);
+  Serial.print(" to ");
+  Serial.println(THRESHOLD_UPPER, DEC);  
+}
+
+void loop(void)
+{
+  uint32_t lum = TSL2591.getFullLuminosity();
+  uint16_t ir, full;
+  ir = lum >> 16;
+  full = lum & 0xFFFF;
+  Serial.print("IR: "); 
+  Serial.print(ir);  
+  Serial.print("  ");
+  Serial.print("Full: "); 
+  Serial.print(full); 
+  Serial.print("  ");
+  Serial.print("Visible: "); 
+  Serial.print(full - ir); 
+  Serial.print("  ");
+  Serial.print("Lux: "); 
+  Serial.println(TSL2591.calculateLux(full, ir));
+
+  if( g_intFlag == 1)
+  {
+    g_intFlag = 0;
+    uint8_t status = TSL2591.getStatus();
+
+    if (status & 0x10) 
+    {
+      Serial.println("ALS Interrupt occured.");
+      Serial.print("Status: ");
+      Serial.println(status, BIN);
+    }
+    TSL2591.clearInterrupt();
+  }
+
+  delay(500);
+}
diff --git a/examples/common/sensors/RAK12020_Light_TSL_Read_TSL2591/RAK12020_Light_TSL_Read_TSL2591.ino b/examples/common/sensors/RAK12020_Light_TSL_Read_TSL2591/RAK12020_Light_TSL_Read_TSL2591.ino
@@ -0,0 +1,117 @@
+ /**
+   @file RAK12020_Light_TSL_Read_TSL2591.ino
+   @author rakwireless.com
+   @brief  Read TSL2591 data and output through serial port.
+   @version 0.1
+   @date 2022-02-25
+   @copyright Copyright (c) 2022
+**/
+#include <Wire.h>
+#include <Adafruit_Sensor.h>
+#include "Adafruit_TSL2591.h" // Click to install library: http://librarymanager/All#Adafruit_TSL2591
+
+Adafruit_TSL2591 TSL2591 = Adafruit_TSL2591(2591);
+
+void setup(void) 
+{
+  // Sensor power on.
+  pinMode(WB_IO2, OUTPUT);
+  digitalWrite(WB_IO2, HIGH); 
+
+  // Initialize Serial for debug output.
+  time_t timeout = millis();
+  Serial.begin(115200);
+  while (!Serial)
+  {
+    if ((millis() - timeout) < 5000)
+    {
+      delay(100);
+    }
+    else
+    {
+      break;
+    }
+  }
+
+  Serial.println("Starting RAK12020 TSL2591 Read Test!");
+
+  if (TSL2591.begin())
+  {
+    Serial.println("Found a TSL2591 sensor.");
+  }
+  else
+  {
+    while (1)
+    {
+      Serial.println("No sensor found ... check your wiring?");
+      delay(1000);
+    }
+  }
+
+  // Display some basic information on this sensor.
+  sensor_t sensor;
+  TSL2591.getSensor(&sensor);
+  Serial.println("------------------------------------");
+  Serial.print  ("Sensor:       "); 
+  Serial.println(sensor.name);
+  Serial.print  ("Driver Ver:   "); 
+  Serial.println(sensor.version);
+  Serial.print  ("Unique ID:    "); 
+  Serial.println(sensor.sensor_id);
+  Serial.print  ("Max Value:    "); 
+  Serial.print  (sensor.max_value); 
+  Serial.println(" lux");
+  Serial.print  ("Min Value:    "); 
+  Serial.print  (sensor.min_value); 
+  Serial.println(" lux");
+  Serial.print  ("Resolution:   "); 
+  Serial.print  (sensor.resolution, 4); 
+  Serial.println(" lux");
+  Serial.println("------------------------------------");
+  Serial.println("");
+  delay(500);
+
+  /*
+   * @brief You can change the gain on the fly, to adapt to brighter/dimmer light situations.
+   * @param
+   *    TSL2591_GAIN_LOW    1x    gain
+   *    TSL2591_GAIN_MED    25x   gain
+   *    TSL2591_GAIN_HIGH   428x  gain
+   *    TSL2591_GAIN_MAX    9876x gain
+   */
+  TSL2591.setGain(TSL2591_GAIN_MED);
+
+  /*
+   * @brief Changing the integration time gives you a longer time over which to sense light
+   *        longer timelines are slower, but are good in very low light situtations!
+   * @param
+   *    TSL2591_INTEGRATIONTIME_100MS     shortest integration time (bright light)
+   *    TSL2591_INTEGRATIONTIME_200MS     
+   *    TSL2591_INTEGRATIONTIME_300MS     
+   *    TSL2591_INTEGRATIONTIME_400MS     
+   *    TSL2591_INTEGRATIONTIME_500MS     
+   *    TSL2591_INTEGRATIONTIME_600MS     longest integration time (dim light)
+   */
+  TSL2591.setTiming(TSL2591_INTEGRATIONTIME_100MS);
+}
+
+void loop(void) 
+{ 
+  uint32_t lum = TSL2591.getFullLuminosity();
+  uint16_t ir, full;
+  ir = lum >> 16;
+  full = lum & 0xFFFF;
+  Serial.print("IR: "); 
+  Serial.print(ir);  
+  Serial.print("  ");
+  Serial.print("Full: "); 
+  Serial.print(full); 
+  Serial.print("  ");
+  Serial.print("Visible: "); 
+  Serial.print(full - ir); 
+  Serial.print("  ");
+  Serial.print("Lux: "); 
+  Serial.println(TSL2591.calculateLux(full, ir));
+
+  delay(500);
+}