Documentation
About FAQ Projects GitHub Troubleshoot EV3 Manager Bluetooth Forum LEGO Support FIRST LEGO League
Reference
show string show number show value show mood show image clear screen show ports on event is pressed was pressed pause until set light battery level
run stop reset set brake set inverted set regulated tank steer angle speed clear counts stop all motors
Sensors
on event pause until is pressed was pressed
angle rate reset
on event distance pause until
on event distance pause until
on event pause until is pressed was pressed set remote channel
Color
on color detected pause until color detected on light detected pause until light condition detected color light
play sound effect play sound effect until done play tone ring tone stop all sounds rest change tempo by set tempo note frequency beat set volume
seconds millis reset pause until
log log value send to screen
Blocks
On Start
repeat for while for of
if Boolean
assign change var var
Math JavaScript blocks Custom blocks
Python
Calling Sequencing Variables Operators Statements Functions Classes
JavaScript
Calling Sequencing Variables Operators Statements Functions Types Classes Interfaces Generics
Types
Number String Boolean Array Function
Developers
Command Line Interface Visual Studio Code support Blocks Embed
Getting Started
Try Use
Tutorials
Wake Up! Make An Animation What Animal Am I? Music Brick Run Motors Tank ZigZag Touch to Run Touch Sensor Values What Color? Line Following Red Light, Green Light Reflected Light Measure Reflected Light Calibration Object Near? Security Alert
Coding
Autonomous Parking Object Detection Line Detection
Design Engineering
Make It Move Without Wheels Make It Smarter and Faster Make a System that Communicates
Maker
Make a Sound Machine Make a Security Gadget
Documentation
About FAQ Projects GitHub Troubleshoot EV3 Manager Bluetooth Forum LEGO Support FIRST LEGO League
Reference
show string show number show value show mood show image clear screen show ports on event is pressed was pressed pause until set light battery level
run stop reset set brake set inverted set regulated tank steer angle speed clear counts stop all motors
Sensors
on event pause until is pressed was pressed
angle rate reset
on event distance pause until
on event distance pause until
on event pause until is pressed was pressed set remote channel
Color
on color detected pause until color detected on light detected pause until light condition detected color light
play sound effect play sound effect until done play tone ring tone stop all sounds rest change tempo by set tempo note frequency beat set volume
seconds millis reset pause until
log log value send to screen
Blocks
On Start
repeat for while for of
if Boolean
assign change var var
Math JavaScript blocks Custom blocks
Python
Calling Sequencing Variables Operators Statements Functions Classes
JavaScript
Calling Sequencing Variables Operators Statements Functions Types Classes Interfaces Generics
Types
Number String Boolean Array Function
Developers
Command Line Interface Visual Studio Code support Blocks Embed
Getting Started
Try Use
Tutorials
Wake Up! Make An Animation What Animal Am I? Music Brick Run Motors Tank ZigZag Touch to Run Touch Sensor Values What Color? Line Following Red Light, Green Light Reflected Light Measure Reflected Light Calibration Object Near? Security Alert
Coding
Autonomous Parking Object Detection Line Detection
Design Engineering
Make It Move Without Wheels Make It Smarter and Faster Make a System that Communicates
Maker
Make a Sound Machine Make a Security Gadget

calibrate Light

Calibrate the thresholds for dark and bright in current lighting conditions.

sensors.color1.calibrateLight(LightIntensityMode.Ambient, 0)

Sometimes when external lighting conditions change, the light sensor measures light intensty differently than when its thresholds were set before. You can calibrate the light sensor to adjust the thresholds slightly for current conditions. This is so that both the dark and bright threshold conditions happen with a similar amount of light to what you set the thresholds before.

Parameters

  • mode: the type of light threshold to calibrate. This is either ambient or reflected light.
  • deviation: a number that is the amount of light level change to adjust in a measurement.

Calibration states

Calibration happens in the following phases and each phase is tracked by the brick status light.

  • orange: sensor initialization. This phase ensures that the sensor is in the desired mode and ready to collect data.
  • orange pulse: data collection. Light information is being collected, move the sensor over the various light sources to detect.
  • green: calibration success. The calibration data has been saved.
  • red flash: sensor failure. We were unable to connect to the sensor.

Example

Calibrate the dark and light thresholds for the color 2 sensor using reflected light.

sensors.color2.calibrateLight(LightIntensityMode.Reflected)

See also

set threshold

Edit this page on GitHub
Edit template of this page on GitHub
Edit template of this page on GitHub