Hello !
Trace: • STM_9B: Reading colour sensor • Harjutusülesanded

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
en:iot-open:practical:hardware:sut:stm32:emb9b_1 [2024/03/29 16:28] – removed ktokarzen:iot-open:practical:hardware:sut:stm32:emb9b_1 [2024/05/02 12:02] (current) – created ktokarz
Line 1: Line 1:
 +====== STM_9B: Reading colour sensor =====
 +A colour sensor (TCS 34725) can detect the brightness and colour of the light emitted. It works with the I2C bus. In our laboratory, the sensor has a fixed 0x29 address. The sensor is in the black enclosure, ensuring no ambient light impacts readings. The only light source is an RGB LED, controlled as described in the scenario [[en:iot-open:practical:hardware:sut:stm32:emb9a_1|]]. This is another LED connected parallel to the one you can observe in the camera.
  
 +===== Prerequisites =====
 +To implement this scenario, it is necessary to get familiar with at least one of the following scenarios first:
 +  * [[en:iot-open:practical:hardware:sut:stm32:emb5_1|]],
 +  * [[en:iot-open:practical:hardware:sut:stm32:emb6_1|]],
 +  * [[en:iot-open:practical:hardware:sut:stm32:emb7_1|]],
 +and obligatory:
 +  * [[en:iot-open:practical:hardware:sut:stm32:emb9a_1|]].
 +
 +To simplify TCS sensor use, we will use a dedicated library:
 +<code bash>
 +lib_deps = adafruit/Adafruit TCS34725@^1.4.4
 +</code>
 +<note important>Also, remember to add the LCD handling library, as present in the EMB9 scenario, unless you decide to use another output device.</note>
 +===== Suggested Readings and Knowledge Resources =====
 +  * [[en:iot-open:introductiontoembeddedprogramming2:cppfundamentals]]
 +  * [[en:iot-open:hardware2:stm32|]]
 +  * [[en:iot-open:practical:hardware:sut:stm32|]]
 +  * [[en:iot-open:embeddedcommunicationprotocols2:twi|]]
 +  * [[en:iot-open:hardware2:sensors_optical|]]
 +  * [[https://cdn-shop.adafruit.com/datasheets/TCS34725.pdf|TCS sensor documentation]]
 +===== Hands-on Lab Scenario =====
 +
 +==== Task to be implemented ====
 +Create a solution where you control an RGB LED and read its colour and brightness using a TCS sensor. Present results on the LCD, e.g. in the form of "Colour: <value>" where "value" refers to the colour intensity. You should change LED brightness at least 10 times (10 different brightness) for each colour while continuously reading the TCS sensor and presenting data in the LCD. Experiment with mixing colours and check either the sensor can distinguish brightness separately, when i.e. both RGD LED's colours are on: Red+Green or Red+Blue (or any other combination you wish).
 +
 +<note tip>There are at least two ways to handle this task:
 +  * simple: a dummy loop where you set RGB LED values, read from TCS and display on LCD,
 +  * advanced: where the data is read and presented on the LCD in one or two asynchronous routines run by timers.
 +</note> 
 +
 +==== Start ====
 +Check if you can see the LCD and RGB LED in the camera view. 
 +<note important>Remember not to use the full brightness of the RGB LED because you won't be able to observe other elements due to the camera's low dynamics. Assuming you express duty cycle in percents, we suggest a range between 0 and 50.</note>
 +
 +==== Steps ====
 +In the steps below, we present only the part for reading from the TCS sensor. Control of RGB LED with PWM and handling LCD is presented in the other lab scenarios that you need to follow accordingly and merge with the code below.
 +
 +=== Step 1 ===
 +Included necessary libraries:
 +<code c>
 +#include <Wire.h>
 +#include "Adafruit_TCS34725.h"
 +</code>
 +
 +=== Step 2 ===
 +Declare and instantiate TCS controller class and related variables for readings:
 +<code c>
 +static Adafruit_TCS34725 tcs = Adafruit_TCS34725(TCS34725_INTEGRATIONTIME_300MS, TCS34725_GAIN_1X);
 +uint16_t r, g, b, c, colorTemp, lux;
 +static bool isTCSOk = false;
 +</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_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.
 +
 +Refer to the Q&A section for the ranges. 
 +
 +=== Step 3 ===
 +Initialise the sensor (in ''void Setup()'') and check it is OK:
 +<code c>
 +  isTCSOk = tcs.begin();
 +</code>
 +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 the default I2C address of the TCS sensor (0x29) so ''begin'' is parameterless. Other overloaded functions for the ''begin'' let you provide all technical parameters.
 +
 +=== Step 4 ===
 +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:
 +<code c>
 +  if(isTCSOk)
 +  {
 +    tcs.getRawData(&r, &g, &b, &c);
 +    colorTemp = tcs.calculateColorTemperature_dn40(r, g, b, c);
 +    lux = tcs.calculateLux(r, g, b);
 +  }
 +</code>
 +R, G, and B reflect filtered values for Red, Green and Blue, respectively, while C (clear) is a non-filtered read that reflects brightness. Please be aware that there is no straightforward relation between R, G, B and C channels. 
 +
 +==== Result validation ====
 +Driving R, G and B channels for RGB LED that lights the sensors, you should be able to observe changes in the readings, accordingly.
 +
 +===== FAQ =====
 +**What is the range of the values for the integration time of the TCS sensor?**:
 +<code c>
 +#define TCS34725_INTEGRATIONTIME_2_4MS                                         \
 +  (0xFF) /**< 2.4ms - 1 cycle - Max Count: 1024 */
 +#define TCS34725_INTEGRATIONTIME_24MS                                          \
 +  (0xF6) /**< 24.0ms - 10 cycles - Max Count: 10240 */
 +#define TCS34725_INTEGRATIONTIME_50MS                                          \
 +  (0xEB) /**< 50.4ms - 21 cycles - Max Count: 21504 */
 +#define TCS34725_INTEGRATIONTIME_60MS                                          \
 +  (0xE7) /**< 60.0ms - 25 cycles - Max Count: 25700 */
 +#define TCS34725_INTEGRATIONTIME_101MS                                         \
 +  (0xD6) /**< 100.8ms - 42 cycles - Max Count: 43008 */
 +#define TCS34725_INTEGRATIONTIME_120MS                                         \
 +  (0xCE) /**< 120.0ms - 50 cycles - Max Count: 51200 */
 +#define TCS34725_INTEGRATIONTIME_154MS                                         \
 +  (0xC0) /**< 153.6ms - 64 cycles - Max Count: 65535 */
 +#define TCS34725_INTEGRATIONTIME_180MS                                         \
 +  (0xB5) /**< 180.0ms - 75 cycles - Max Count: 65535 */
 +#define TCS34725_INTEGRATIONTIME_199MS                                         \
 +  (0xAD) /**< 199.2ms - 83 cycles - Max Count: 65535 */
 +#define TCS34725_INTEGRATIONTIME_240MS                                         \
 +  (0x9C) /**< 240.0ms - 100 cycles - Max Count: 65535 */
 +#define TCS34725_INTEGRATIONTIME_300MS                                         \
 +  (0x83) /**< 300.0ms - 125 cycles - Max Count: 65535 */
 +#define TCS34725_INTEGRATIONTIME_360MS                                         \
 +  (0x6A) /**< 360.0ms - 150 cycles - Max Count: 65535 */
 +#define TCS34725_INTEGRATIONTIME_401MS                                         \
 +  (0x59) /**< 400.8ms - 167 cycles - Max Count: 65535 */
 +#define TCS34725_INTEGRATIONTIME_420MS                                         \
 +  (0x51) /**< 420.0ms - 175 cycles - Max Count: 65535 */
 +#define TCS34725_INTEGRATIONTIME_480MS                                         \
 +  (0x38) /**< 480.0ms - 200 cycles - Max Count: 65535 */
 +#define TCS34725_INTEGRATIONTIME_499MS                                         \
 +  (0x30) /**< 499.2ms - 208 cycles - Max Count: 65535 */
 +#define TCS34725_INTEGRATIONTIME_540MS                                         \
 +  (0x1F) /**< 540.0ms - 225 cycles - Max Count: 65535 */
 +#define TCS34725_INTEGRATIONTIME_600MS                                         \
 +  (0x06) /**< 600.0ms - 250 cycles - Max Count: 65535 */
 +#define TCS34725_INTEGRATIONTIME_614MS                                         \
 +  (0x00) /**< 614.4ms - 256 cycles - Max Count: 65535 */
 +</code>
 +
 +**What is the range of the values for the gain of the TCS sensor?**:
 +<code c>
 +typedef enum {
 +  TCS34725_GAIN_1X = 0x00,  /*  No gain  */
 +  TCS34725_GAIN_4X = 0x01,  /*  4x gain  */
 +  TCS34725_GAIN_16X = 0x02, /*  16x gain */
 +  TCS34725_GAIN_60X = 0x03  /*  60x gain */
 +} tcs34725Gain_t;
 +</code>
 +
 +**C channel reading is 0 and R, G or B readings are not reasonable**: It is possibly because of overdrive of 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>
 +===== Project information =====
 +{{:en:iot-open:logo_iot_200_px.png?200|}}\\
 +This Intellectual Output was implemented under the Erasmus+ KA2.\\
 +Project IOT-OPEN.EU Reloaded – Education-based strengthening of the European universities, companies and labour force in the global IoT market.\\
 +Project number: 2022-1-PL01-KA220-HED-000085090.
 +
 +**__Erasmus+ Disclaimer__**\\
 +This project has been funded with support from the European Commission. \\
 +This publication reflects the views of only the author, and the Commission cannot be held responsible for any use that may be made of the information contained therein.
 +
 +**__Copyright Notice__**\\
 +This content was created by the IOT-OPEN.EU Reloaded consortium, 2022,2024.\\
 +The content is Copyrighted and distributed under CC BY-NC [[https://en.wikipedia.org/wiki/Creative_Commons_license|Creative Commons Licence]], free for Non-Commercial use. 
 +<figure label>
 +{{:en:iot-open:ccbync.png?100|}}
 +</figure>
 +</WRAP>
en/iot-open/practical/hardware/sut/stm32/emb9b_1.1711729734.txt.gz · Last modified: 2024/03/29 16:28 by ktokarz
CC Attribution-Share Alike 4.0 International
www.chimeric.de Valid CSS Driven by DokuWiki do yourself a favour and use a real browser - get firefox!! Recent changes RSS feed Valid XHTML 1.0