.. highlight:: csharp

Color Sensor
============
Similiar to :doc:`ambient light sensors <light_sensor_ltr329>`, color sensors are responsive to light, however they are typically manufactured to only 
capture red, green, and blue light though some models are responsive to all visible light.  MetaEnvironment boards come equipped with a 
`TCS34725 <http://ams.com/eng/content/download/319364/1117183/287875>`_ color sensor, accessed through the 
`IColorTcs34725 <http://mbientlab.com/docs/metawear/csharp/1.0.0/interfaceMbientLab_1_1MetaWear_1_1Sensor_1_1IColorTcs34725.html>`_ interface.  

::

    using MbientLab.MetaWear.Sensor;

    IColorTcs34725 color = metawear.GetModule<IColorTcs34725>();

Configuration
-------------
The color sensor has 2 configurable parameters that affect the data range, resultion, and sensitivity.

================  ============================================
Parameter         Description
================  ============================================
Gain              Analog signal scale
Integration Time  Amount of time spent to aggregate adc values
================  ============================================

There is also a white illuminator LED next to the sensor that can be used to provide additional light if the surrounding area is too dark.

::

    import com.mbientlab.metawear.module.ColorSensorTcs34725.Gain;

    // set gain to 4x, integration time to 4.8ms, 
    // keep illuminator led off
    color.Configure(gain: Gain._4x, integationTime: 4.8f);

ADC Values
----------
The red, green, blue, and clear ADC values measured by the TCS3472 device are represented by the 
`Adc <http://mbientlab.com/docs/metawear/csharp/1/classMbientLab_1_1MetaWear_1_1Sensor_1_1ColorTcs34725_1_1Adc.html>`_ class and is classified as a 
forced data producer.

::

    using MbientLab.MetaWear.Sensor.ColorTcs34725;

    await color.Adc.AddRouteAsync(source => 
        source.Stream(data => Console.WriteLine("color adc = " + data.Value<ADC>()))
    );