Changes between Initial Version and Version 1 of TSL2561

Timestamp:

Dec 25, 2015 3:18:21 PM (8 years ago)

Author:

kishida

Comment:

--

TSL2561

@@ +1 @@
+現在こちらのページで販売中の[https://www.switch-science.com/catalog/2498/ TSL2561デジタル光センサボード]の説明ページです。
+TSL2561はデジタル出力の光センサーです。
+
+取得したデータを元に計算することで、Cdsセルなどに比べて正確な照度を求めることができます。
+メーカー公開のデータシートへのリンクはこちらです。([http://www.adafruit.com/datasheets/TSL256x.pdf pdf])
+
+デーシートに記載されている詳細説明を意訳したものを載せます。※内容の正確さについては保証いたしかねます。
+"
+TSL2560とTSL2561は次世代型の光センサデバイスです。どちらの製品も2つのアナログ・デジタルコンバーター(ADC)を搭載し、2つのフォトダイオードからの電流を積分します。両チャンネルの積分は同時に行われます。A/D変換サイクルが終わると、変換結果はChannel0とChannel1レジスタにそれぞれ送られます。送信はデータが完全なままであるのを保証するためにダブルバッファリングされています。この送信の後、デバイスは自動的に次の積分(測定)サイクルに入ります。
+
+デバイスとの通信はI^2^CまたはSMBus通信によって独立して成し遂げられます。よって、TSL256xデバイスはマイクロコントローラや組み込みのコントーローラと簡単に接続できます。
+
+信号品質のために外部回路を必要としないので、基板面積を大幅に節約できます。
+
+TSL256xはデジタル出力であるため、出力はアナログ信号と比較してノイズに耐性があります。
+
+TSL256xは割り込み機能にも対応し、センサが光強度測定をするのを待つ必要性を排除することでシステムを簡便化できます。割り込み機能の主要な使い方は光強度の有意な変化を検知することです。検知する変化量はユーザーが光強度と時間で指定したり、光強度の不変さによって指定したりできます。
+TSL2561は現在の光量からの強弱方向への変化量に対して閾値を設定することができます。
+割り込みは測定値がこれらの閾値を超えた時に生成されます。"
+
+また、Adafruitからライブラリが公開されています。リンク([https://github.com/adafruit/TSL2561-Arduino-Library github])
+こちらも参考にしてください。[[BR]]
+また、上記ライブラリのサンプルスケッチのコメントを意訳したものもページ下部にて公開していますので、ご覧ください。
+
+----
+
+== 通信方法 ==
+
+I^2^CまたはSMBusで通信を行います。電子工作で利用する際はI^2^Cになるとおもいますので、
+このページではI^2^C通信での利用を前提に解説を進めます。
+
+=== 送信方法 ===
+
+データシートの一部を抜粋します。
+脚注にあるように、I^2^C通信では簡略化して行われます。[[BR]]
+結果として一般的なI^2^C通信と大きな違いはありません。
+[[Image(tsl2561_fig16.png)]]
+
+下はArduinoでの1byte分を書き込む実装例の一つです。
+{{{
+int _addr = 0x39;
+void TSL2561::write8 (uint8_t reg, uint8_t value)
+{
+  Wire.beginTransmission(_addr);
+  Wire.write(reg);
+  Wire.write(value);
+  Wire.endTransmission();
+}
+}}}
+
+=== 受信方法 ===
+
+データシートの一部を抜粋します。
+脚注にあるように、I^2^C通信では簡略化して行われます。[[BR]]
+結果として一般的なI^2^C通信と大きな違いはありません。
+[[Image(tsl2561_fig17.png)]]
+
+下はArduinoで2byte分を読みだす実装例の一つです。
+
+{{{
+int _addr = 0x39;
+uint16_t TSL2561::read16(uint8_t reg)
+{
+  uint16_t x; 
+  uint16_t t;
+
+  Wire.beginTransmission(_addr);
+  Wire.write(reg);
+  Wire.endTransmission();
+
+  Wire.requestFrom(_addr, 2);
+  t = Wire.read();
+  x = Wire.read();
+  x <<= 8;
+  x |= t;
+  return x;
+}
+}}}
+
+=== 接続 ===
+
+下図のように配線してください。(実体配線図)
+
+また、Arduinoのanalogピンの部分に次のように設置することもできます。
+この場合、ピンの入出力設定を書く必要があります。
+Setup(){}内部の、初期化のはじめの方にに以下の文を追加してください。
+
+== 計算方法 ==
+
+取得した測定値を指揮に代入することで、照度(単位:lux(ルクス))を正確に求めることができます。
+データシートに記載されている式を抜粋します。
+
+== 動作サンプル ==
+
+サンプルスケッチ(コメント意訳版)※コメントの正確性については保証いたしかねます
+{{{
+#include <Wire.h>
+#include "TSL2561.h"
+
+// TSL2561 サンプルプログラム 2015/12
+
+// SCL は analog 5 に接続してください
+// SDA は analog 4 に接続してください
+// VDD は 3.3V DC に接続してください
+// GROUND は common ground に接続してください
+// ADDR を未接続/GND/VDDのどれに接続するかによってi2cアドレスを変更します
+// Adruinoで利用する際の7bit表記では以下のとおり
+// 接続状況によって適宜変更してください
+// 未接続: TSL2561_ADDR_FLOAT (0x39)
+// GND: TSL2561_ADDR_LOW  (0x29)
+// VDD: TSL2561_ADDR_HIGH (0x49)
+TSL2561 tsl(TSL2561_ADDR_FLOAT);
+
+void setup(void) {
+  Serial.begin(9600);
+  //while (!Serial);
+  if (tsl.begin()) {
+    Serial.println("Found sensor");
+  } else {
+    Serial.println("No sensor?");
+    while (1);
+  }
+
+  // 周囲の明暗状況に合わせて適切にゲインを変更してください
+  //tsl.setGain(TSL2561_GAIN_0X);         // ゲインなし:周囲が明るい場合
+  tsl.setGain(TSL2561_GAIN_16X);      // ゲインx16:周囲が暗い場合
+
+  // 積算時間を変更することで、光の測定時間を変更することができます
+  // 長時間測定すると、データの取得は遅くなりますが、低光度環境での測定性能が向上します
+  tsl.setTiming(TSL2561_INTEGRATIONTIME_13MS);  // 短時間測定:明るい環境
+  //tsl.setTiming(TSL2561_INTEGRATIONTIME_101MS);  // 中時間測定:中程度の明るさ
+  //tsl.setTiming(TSL2561_INTEGRATIONTIME_402MS);  // 最長時間測定:暗い環境
+
+  // 設定は以上です
+}
+
+void loop(void) {
+  // データを取得する簡単なサンプルです
+  //単純に、赤外線か全波長域のダイオードの値か
+  // "可視光"(ダイオードからの値とは違います)のチャンネルの測定値を読みます
+
+  // 13-402 millisecondsかかります
+  // 取得したいデータに応じてコメントアウトを外してください
+  uint16_t x = tsl.getLuminosity(TSL2561_VISIBLE);
+  //uint16_t x = tsl.getLuminosity(TSL2561_FULLSPECTRUM);
+  //uint16_t x = tsl.getLuminosity(TSL2561_INFRARED);
+
+  Serial.println(x, DEC);
+
+  // 詳細な値をよみとるサンプルです
+  // MSB 16bitが赤外線、LSB 16bitが全波長域チャンネルの値で構成された32bitのデータを読みます
+  // 値を自由に加工や比較して利用してください
+  uint32_t lum = tsl.getFullLuminosity();
+  uint16_t ir, full;
+  ir = lum >> 16;
+  full = lum & 0xFFFF;
+  Serial.print("IR: "); Serial.print(ir);   Serial.print("\t\t");
+  Serial.print("Full: "); Serial.print(full);   Serial.print("\t");
+  Serial.print("Visible: "); Serial.print(full - ir);   Serial.print("\t");
+
+  Serial.print("Lux: "); Serial.println(tsl.calculateLux(full, ir));
+
+  delay(100);
+}
+}}}