Jump to content

Component: Colour Sensor V3 (Grove 101021133) (101021133) (Light)

From Flowcode Help
Revision as of 14:36, 13 July 2026 by SteveT (talk | contribs) (Text replacement - "style="background-color:#EAE1EA; color:#4B008D;"" to "class="mtx-class-propfolder"")
Author Matrix TSL
Version 1.0
Category Light


Colour Sensor V3 (Grove 101021133) component

Based on the color sensor VEML6040 with digital output I2C. senses red, green, blue, and white light and incorporates photodiodes, amplifiers, and analog / digital circuits into a single chip. Provides a spectrum matching real human eye responses.

Detailed description

No detailed description exists yet for this component

Examples

No additional examples






Macro reference

CalculateLux

CalculateLux
Uses the RGB values stored in RAM from the last Sample to calculate the luminance in lux. 
- UINT Return


CalculateTemp

CalculateTemp
Uses the RGB values stored in RAM from the last Sample to calculate the colour temperature in degrees Kelvin. 
- UINT Return


DisableSensor

DisableSensor
Powers down the device to save power. 
- VOID Return


EnableSensor

EnableSensor
Powers up the device ready for taking colour readings. 
- VOID Return


Initialise

Initialise
Initialise the sensor configuration as set by the component properties. Sets the default intigration time and gain as well as enable the sensor. Returns 1 if the sensor is detected and responding to commands. 
- BOOL Return


ReadDataChannel

ReadDataChannel
Returns the value of the selected colour channel from the last sample. The Red, Green and Blue channels have a colour filter to remove light of other colours. The Clear channel has no filter allowing the ambient light level to be easily collected. 
- BYTE ColourChannel
Range: 0 to 3 - 0=Red, 1=Green, 2=Blue, 3=Clear 
- UINT Return


SampleSensor

SampleSensor
Reads the raw colour channels from the sensor and stores the readings into RAM to be collected by the ReadDataChannel macro. 
- VOID Return


SetIntegrationTime

SetIntegrationTime
Controls the integration time. 0 = 40mS / 1 = 80mS / 2 = 160mS / 3 = 320mS / 4 = 640mS / 5 = 1280mS 
- BYTE Setting
Range: 0 to 5 
- VOID Return


Property reference

Properties
Sensor Settings
Integration Time
Length of time period used to sample the sensor frequency (longer is more accurate) 
I2C Settings
Channel
Channel selection 
Baud Select
Baud rate option selector 
Baud Rate
Baud rate to be used 
Stop Delay
On older microcontroller devices there is a potential for the I2C hardware channel to lock up if there is not a 10ms delay between an I2C stop event and the next I2C start event. Most modern microcontrollers will not have a problem so this property can be disabled to speed up the I2C communications.  
SDA
Pin used for SDA (data signal) 
SCL
Pin used for SCL (clock signal) 
Simulation
Simulation Type
Selects the simulation type for the component. Component GUI - Interacts with the panel to sense the colour of a object in close proximity to the sensor. I2C Injector - Performs the I2C commands allowing you to connect an injector component or view and debug the I2C communications. 

Component Source Code

Please click here to download the component source project: FC_Comp_Source_Colour_Sensor_V3_I2C_Grove.fcfx

Please click here to view the component source code (Beta): FC_Comp_Source_Colour_Sensor_V3_I2C_Grove.fcfx