mirror of
https://github.com/processing/processing4.git
synced 2026-01-28 02:41:08 +01:00
IO: Add TSL2561 environmental sensor example
Donated by @OlivierLD, minor cleanups by @gohai
This commit is contained in:
Olivier LeDiouris
committed by
Gottfried Haider
Gottfried Haider
parent
2e05386994
commit
5db3ec9227
@@ -0,0 +1,27 @@
|
||||
import processing.io.*;
|
||||
TSL2561 sensor;
|
||||
|
||||
// see setup.png in the sketch folder for wiring details
|
||||
|
||||
// this variable will contain the measured brightness
|
||||
// Lux (lx) is the unit of illuminance
|
||||
float lux;
|
||||
|
||||
void setup() {
|
||||
size(700, 100);
|
||||
textSize(72);
|
||||
//printArray(I2C.list());
|
||||
sensor = new TSL2561("i2c-1", 0x39);
|
||||
}
|
||||
|
||||
void draw() {
|
||||
background(0);
|
||||
stroke(255);
|
||||
lux = sensor.lux();
|
||||
text(String.format("Light: %.02f Lux", lux), 10, 75);
|
||||
}
|
||||
|
||||
void dispose() {
|
||||
// turn the sensor off
|
||||
sensor.stop();
|
||||
}
|
||||
187
java/libraries/io/examples/Light_I2C_TSL2561/TSL2561.pde
Normal file
187
java/libraries/io/examples/Light_I2C_TSL2561/TSL2561.pde
Normal file
@@ -0,0 +1,187 @@
|
||||
import processing.io.I2C;
|
||||
|
||||
// TSL2561 is light sensor using I2C
|
||||
// datasheet: https://cdn-shop.adafruit.com/datasheets/TSL2561.pdf
|
||||
// code contributed by @OlivierLD
|
||||
|
||||
public class TSL2561 extends I2C {
|
||||
|
||||
public final static int TSL2561_ADDRESS = 0x39;
|
||||
|
||||
public final static int TSL2561_ADDRESS_LOW = 0x29;
|
||||
public final static int TSL2561_ADDRESS_FLOAT = 0x39;
|
||||
public final static int TSL2561_ADDRESS_HIGH = 0x49;
|
||||
|
||||
public final static int TSL2561_COMMAND_BIT = 0x80;
|
||||
public final static int TSL2561_WORD_BIT = 0x20;
|
||||
public final static int TSL2561_CONTROL_POWERON = 0x03;
|
||||
public final static int TSL2561_CONTROL_POWEROFF = 0x00;
|
||||
|
||||
public final static int TSL2561_REGISTER_CONTROL = 0x00;
|
||||
public final static int TSL2561_REGISTER_TIMING = 0x01;
|
||||
public final static int TSL2561_REGISTER_CHAN0_LOW = 0x0C;
|
||||
public final static int TSL2561_REGISTER_CHAN0_HIGH = 0x0D;
|
||||
public final static int TSL2561_REGISTER_CHAN1_LOW = 0x0E;
|
||||
public final static int TSL2561_REGISTER_CHAN1_HIGH = 0x0F;
|
||||
public final static int TSL2561_REGISTER_ID = 0x0A;
|
||||
|
||||
public final static int TSL2561_GAIN_1X = 0x00;
|
||||
public final static int TSL2561_GAIN_16X = 0x10;
|
||||
|
||||
public final static int TSL2561_INTEGRATIONTIME_13MS = 0x00; // rather 13.7ms
|
||||
public final static int TSL2561_INTEGRATIONTIME_101MS = 0x01;
|
||||
public final static int TSL2561_INTEGRATIONTIME_402MS = 0x02;
|
||||
|
||||
public final static double TSL2561_LUX_K1C = 0.130; // (0x0043) // 0.130 * 2^RATIO_SCALE
|
||||
public final static double TSL2561_LUX_B1C = 0.0315; // (0x0204) // 0.0315 * 2^LUX_SCALE
|
||||
public final static double TSL2561_LUX_M1C = 0.0262; // (0x01ad) // 0.0262 * 2^LUX_SCALE
|
||||
public final static double TSL2561_LUX_K2C = 0.260; // (0x0085) // 0.260 * 2^RATIO_SCALE
|
||||
public final static double TSL2561_LUX_B2C = 0.0337; // (0x0228) // 0.0337 * 2^LUX_SCALE
|
||||
public final static double TSL2561_LUX_M2C = 0.0430; // (0x02c1) // 0.0430 * 2^LUX_SCALE
|
||||
public final static double TSL2561_LUX_K3C = 0.390; // (0x00c8) // 0.390 * 2^RATIO_SCALE
|
||||
public final static double TSL2561_LUX_B3C = 0.0363; // (0x0253) // 0.0363 * 2^LUX_SCALE
|
||||
public final static double TSL2561_LUX_M3C = 0.0529; // (0x0363) // 0.0529 * 2^LUX_SCALE
|
||||
public final static double TSL2561_LUX_K4C = 0.520; // (0x010a) // 0.520 * 2^RATIO_SCALE
|
||||
public final static double TSL2561_LUX_B4C = 0.0392; // (0x0282) // 0.0392 * 2^LUX_SCALE
|
||||
public final static double TSL2561_LUX_M4C = 0.0605; // (0x03df) // 0.0605 * 2^LUX_SCALE
|
||||
public final static double TSL2561_LUX_K5C = 0.65; // (0x014d) // 0.65 * 2^RATIO_SCALE
|
||||
public final static double TSL2561_LUX_B5C = 0.0229; // (0x0177) // 0.0229 * 2^LUX_SCALE
|
||||
public final static double TSL2561_LUX_M5C = 0.0291; // (0x01dd) // 0.0291 * 2^LUX_SCALE
|
||||
public final static double TSL2561_LUX_K6C = 0.80; // (0x019a) // 0.80 * 2^RATIO_SCALE
|
||||
public final static double TSL2561_LUX_B6C = 0.0157; // (0x0101) // 0.0157 * 2^LUX_SCALE
|
||||
public final static double TSL2561_LUX_M6C = 0.0180; // (0x0127) // 0.0180 * 2^LUX_SCALE
|
||||
public final static double TSL2561_LUX_K7C = 1.3; // (0x029a) // 1.3 * 2^RATIO_SCALE
|
||||
public final static double TSL2561_LUX_B7C = 0.00338; // (0x0037) // 0.00338 * 2^LUX_SCALE
|
||||
public final static double TSL2561_LUX_M7C = 0.00260; // (0x002b) // 0.00260 * 2^LUX_SCALE
|
||||
public final static double TSL2561_LUX_K8C = 1.3; // (0x029a) // 1.3 * 2^RATIO_SCALE
|
||||
public final static double TSL2561_LUX_B8C = 0.000; // (0x0000) // 0.000 * 2^LUX_SCALE
|
||||
public final static double TSL2561_LUX_M8C = 0.000; // (0x0000) // 0.000 * 2^LUX_SCALE
|
||||
|
||||
private int gain = TSL2561_GAIN_1X;
|
||||
private int integration = TSL2561_INTEGRATIONTIME_402MS;
|
||||
private int pause = 800;
|
||||
|
||||
private int address;
|
||||
|
||||
|
||||
public TSL2561(String dev) {
|
||||
this(dev, TSL2561_ADDRESS);
|
||||
}
|
||||
|
||||
public TSL2561(String dev, int address) {
|
||||
super(dev);
|
||||
this.address = address;
|
||||
start();
|
||||
}
|
||||
|
||||
public void start() {
|
||||
command(TSL2561_COMMAND_BIT, (byte) TSL2561_CONTROL_POWERON);
|
||||
}
|
||||
|
||||
public void stop() {
|
||||
command(TSL2561_COMMAND_BIT, (byte) TSL2561_CONTROL_POWEROFF);
|
||||
}
|
||||
|
||||
public void setGain() {
|
||||
setGain(TSL2561_GAIN_1X);
|
||||
}
|
||||
|
||||
public void setGain(int gain) {
|
||||
setGain(gain, TSL2561_INTEGRATIONTIME_402MS);
|
||||
}
|
||||
|
||||
public void setGain(int gain, int integration) {
|
||||
if (gain != TSL2561_GAIN_1X && gain != TSL2561_GAIN_16X) {
|
||||
throw new IllegalArgumentException("Invalid gain value");
|
||||
}
|
||||
if (gain != this.gain || integration != this.integration) {
|
||||
command(TSL2561_COMMAND_BIT | TSL2561_REGISTER_TIMING, (byte) (gain | integration));
|
||||
//println("Setting low gain");
|
||||
this.gain = gain;
|
||||
this.integration = integration;
|
||||
delay(pause); // pause for integration (pause must be bigger than integration time)
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Read visible+IR diode from the I2C device
|
||||
*/
|
||||
public int readFull() {
|
||||
int reg = TSL2561_COMMAND_BIT | TSL2561_REGISTER_CHAN0_LOW;
|
||||
return readU16(reg);
|
||||
}
|
||||
|
||||
/**
|
||||
* Read IR only diode from the I2C device
|
||||
*/
|
||||
public int readIR() {
|
||||
int reg = TSL2561_COMMAND_BIT | TSL2561_REGISTER_CHAN1_LOW;
|
||||
return readU16(reg);
|
||||
}
|
||||
|
||||
/**
|
||||
* Device lux range 0.1 - 40,000+
|
||||
* see https://learn.adafruit.com/tsl2561/overview
|
||||
*/
|
||||
public float lux() {
|
||||
int ambient = this.readFull();
|
||||
int ir = this.readIR();
|
||||
|
||||
//println("IR Result: " + ir);
|
||||
//println("Ambient Result: " + ambient);
|
||||
|
||||
if (ambient >= 0xffff || ir >= 0xffff) {
|
||||
throw new RuntimeException("Gain too high, values exceed range");
|
||||
}
|
||||
double ratio = (ir / (float) ambient);
|
||||
|
||||
/*
|
||||
* For the values below, see https://github.com/adafruit/_TSL2561/blob/master/_TSL2561_U.h
|
||||
*/
|
||||
float lux = 0.0f;
|
||||
if ((ratio >= 0) && (ratio <= TSL2561_LUX_K4C)) {
|
||||
lux = (float)((TSL2561_LUX_B1C * ambient) - (0.0593 * ambient * (Math.pow(ratio, 1.4))));
|
||||
} else if (ratio <= TSL2561_LUX_K5C) {
|
||||
lux = (float)((TSL2561_LUX_B5C * ambient) - (TSL2561_LUX_M5C * ir));
|
||||
} else if (ratio <= TSL2561_LUX_K6C) {
|
||||
lux = (float)((TSL2561_LUX_B6C * ambient) - (TSL2561_LUX_M6C * ir));
|
||||
} else if (ratio <= TSL2561_LUX_K7C) {
|
||||
lux = (float)((TSL2561_LUX_B7C * ambient) - (TSL2561_LUX_M7C * ir));
|
||||
} else if (ratio > TSL2561_LUX_K8C) {
|
||||
lux = 0.0f;
|
||||
}
|
||||
return lux;
|
||||
}
|
||||
|
||||
|
||||
private void command(int register, byte value) {
|
||||
beginTransmission(address);
|
||||
write(register);
|
||||
write(value);
|
||||
endTransmission();
|
||||
}
|
||||
|
||||
private int readU8(int register) {
|
||||
beginTransmission(this.address);
|
||||
write(register);
|
||||
byte[] ba = read(1);
|
||||
endTransmission();
|
||||
return (int)(ba[0] & 0xFF);
|
||||
}
|
||||
|
||||
private int readU16(int register) {
|
||||
int lo = readU8(register);
|
||||
int hi = readU8(register + 1);
|
||||
int result = (hi << 8) + lo; // Big Endian
|
||||
//println("(U16) I2C: Device " + toHex(TSL2561_ADDRESS) + " returned " + toHex(result) + " from reg " + toHex(register));
|
||||
return result;
|
||||
}
|
||||
|
||||
private String toHex(int i) {
|
||||
String s = Integer.toString(i, 16).toUpperCase();
|
||||
while (s.length() % 2 != 0) {
|
||||
s = "0" + s;
|
||||
}
|
||||
return "0x" + s;
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user