Differences

This shows you the differences between two versions of the page.

--- en:iot-open:practical:hardware:sut:esp32:emb9b_1 [2024/03/22 07:41] – [Project information] pczekalski
+++ en:iot-open:practical:hardware:sut:esp32:emb9b_1 [2025/04/28 20:34] (current) – [FAQ] pczekalski
@@ Line 50: / Line 50: @@
 === Step 2 ===
-Declare and instantiate TCS controller class and related variables for readings:
+Declare and instantiate the TCS controller class and related variables for readings:
 <code c>
+#define SCL 4
+#define SDA 5
 static Adafruit_TCS34725 tcs = Adafruit_TCS34725(TCS34725_INTEGRATIONTIME_300MS, TCS34725_GAIN_1X);
 uint16_t r, g, b, c, colorTemp, lux;
@@ Line 57: / Line 60: @@
 </code>
 A word of explanation regarding the parameters:
-  * ''TCS34725_INTEGRATIONTIME_300MS'' is time in ms while the TCS sensor is exposed for the light to grab readings,
+  * ''TCS34725_INTEGRATIONTIME_300MS'' is the time in ms while the TCS sensor is exposed for the light to grab readings,
   * ''TCS34725_GAIN_1X'' is the sensor's gain - it helps reading in low light, but that is not true in our lab as our RGB LED light sensor is very bright, even in low duty cycle.
@@ Line 65: / Line 68: @@
 Initialise the sensor (in ''void Setup()'') and check it is OK:
 <code c>
+  Wire.begin(SDA,SCL);
+  delay(100);
+  ...
   isTCSOk = tcs.begin();
 </code>
-You communicate with TCS sensor via I2C interface. In standard and typical configurations there is no need to instantiate ''Wire'' I2C communication stack explicitly, neither provide default I2C address of the TCS sensor (0x29) so ''begin'' is parameterless. Other overloaded functions for the ''begin'' let you provide all technical parameters.
+You communicate with the TCS sensor via the I2C interface. In standard and typical configurations, there is no need to instantiate the ''Wire'' I2C communication stack explicitly, nor provide a default I2C address of the TCS sensor (0x29), so ''begin'' is parameterless. Other overloaded functions for the ''begin'' let you provide all technical parameters.
+<note important>You need to initialise the I2C bus only once. If you're using other I2C devices in parallel, do not call ''Wire.begin(...)'' multiple times.</note>
 === Step 4 ===
-Besides reading raw values for channels R, G, B and C, the ''tcs'' controller class provides additional functions to calculate color temperature (in K) and color intensity in Luxes.
+Besides reading raw values for channels R, G, B and C, the ''tcs'' controller class provides additional functions to calculate colour temperature (in K) and colour intensity in Luxes.
 To read, use the following code:
@@ Line 87: / Line 96: @@
 ===== FAQ =====
-**What is the range of the values for the integration time of the TCS sensor?**:
+**What is the range of the values for the //integration time// of the TCS sensor?**:
 <code c>
 #define TCS34725_INTEGRATIONTIME_2_4MS                                         \
@@ Line 129: / Line 138: @@
 </code>
-**What is the range of the values for the gain of the TCS sensor?**:
+**What is the range of the values for the //gain// of the TCS sensor?**:
 <code c>
 typedef enum {
@@ Line 139: / Line 148: @@
 </code>
-**C channel reading is 0 and R, G or B readings are not reasonable**: It is possibly because overdrive of the sensor with a light source (too bright). Consider lowering the RGB LED's intensity or change sensor's integration time and gain (shorter time, lower gain).
+**C channel reading is 0, and R, G or B readings are unreasonable.** It is possibly because of overdriving the sensor with a light source (too bright). Consider lowering the RGB LED's intensity or changing the sensor's integration time and gain (shorter time, lower gain).
 <WRAP noprint>

en/iot-open/practical/hardware/sut/esp32/emb9b_1.1711093263.txt.gz · Last modified: 2024/03/22 07:41 by pczekalski