com.qualcomm.hardware.rev

Class RevColorSensorV3

java.lang.Object

com.qualcomm.robotcore.hardware.I2cDeviceSynchDevice<DEVICE_CLIENT>

com.qualcomm.robotcore.hardware.I2cDeviceSynchDeviceWithParameters<I2cDeviceSynchSimple,BroadcomColorSensor.Parameters>

com.qualcomm.hardware.broadcom.BroadcomColorSensorImpl

com.qualcomm.hardware.rev.RevColorSensorV3

All Implemented Interfaces:

BroadcomColorSensor, ColorRangeSensor, ColorSensor, DistanceSensor, HardwareDevice, I2cAddrConfig, I2cAddressableDevice, Light, LightSensor, NormalizedColorSensor, OpticalDistanceSensor, RobotArmingStateNotifier.Callback

@I2cDeviceType
 @DeviceProperties(name="@string/rev_color_sensor_v3_name",
                  description="@string/rev_color_sensor_v3_description",
                  xmlTag="RevColorSensorV3",
                  compatibleControlSystems=REV_HUB,
                  builtIn=true)
public class RevColorSensorV3
extends BroadcomColorSensorImpl
implements DistanceSensor, OpticalDistanceSensor, ColorRangeSensor

RevColorSensorV3 implements support for the REV Robotics Color Sensor V3.

See Also:

REV Robotics Website

Nested Class Summary

Nested classes/interfaces inherited from interface com.qualcomm.robotcore.hardware.HardwareDevice

HardwareDevice.Manufacturer

Nested classes/interfaces inherited from interface com.qualcomm.hardware.broadcom.BroadcomColorSensor

BroadcomColorSensor.Gain, BroadcomColorSensor.LEDCurrent, BroadcomColorSensor.LEDPulseModulation, BroadcomColorSensor.MainControl, BroadcomColorSensor.MainStatus, BroadcomColorSensor.Parameters, BroadcomColorSensor.PSMeasurementRate, BroadcomColorSensor.PSResolution, BroadcomColorSensor.Register

Field Summary

Fields

Modifier and Type	Field and Description
protected static double	apiLevelMax
protected static double	apiLevelMin

Fields inherited from class com.qualcomm.hardware.broadcom.BroadcomColorSensorImpl

TAG

Fields inherited from class com.qualcomm.robotcore.hardware.I2cDeviceSynchDeviceWithParameters

parameters

Fields inherited from class com.qualcomm.robotcore.hardware.I2cDeviceSynchDevice

deviceClient, deviceClientIsOwned, isInitialized

Fields inherited from interface com.qualcomm.robotcore.hardware.DistanceSensor

distanceOutOfRange

Fields inherited from interface com.qualcomm.hardware.broadcom.BroadcomColorSensor

BROADCOM_APDS9151_ADDRESS, BROADCOM_APDS9151_ID

Constructor Summary

Constructors

Constructor and Description
RevColorSensorV3(I2cDeviceSynchSimple deviceClient)

Method Summary

Modifier and Type	Method and Description
java.lang.String	getDeviceName() Returns a string suitable for display to the user as to the type of device.
double	getDistance(DistanceUnit unit) Returns a calibrated, linear sense of distance as read by the infrared proximity part of the sensor.
double	getLightDetected() Get the amount of light detected by the sensor, scaled and cliped to a range which is a pragmatically useful sensitivity.
HardwareDevice.Manufacturer	getManufacturer() Returns an indication of the manufacturer of this device.
double	getRawLightDetected() Returns a signal whose strength is proportional to the intensity of the light measured.
double	getRawLightDetectedMax() Returns the maximum value that can be returned by LightSensor.getRawLightDetected().
protected double	inFromOptical(int rawOptical) Converts a raw optical inverse-square reading into a fitted, calibrated linear reading in INCHES.
int	rawOptical()
java.lang.String	status() Status of this sensor, in string form

Methods inherited from class com.qualcomm.hardware.broadcom.BroadcomColorSensorImpl

alpha, argb, blue, delay, disable, dumpState, enable, enableLed, getDeviceID, getI2cAddress, getNormalizedColors, green, internalInitialize, isLightOn, read, read8, readMainCtrl, readUnsignedByte, readUnsignedShort, red, setGain, setI2cAddress, setLEDParameters, setPDrive, setProximityPulseCount, setPSRateAndRes, testBits, testBits, write, write8

Methods inherited from class com.qualcomm.robotcore.hardware.I2cDeviceSynchDeviceWithParameters

doInitialize, getParameters, initialize

Methods inherited from class com.qualcomm.robotcore.hardware.I2cDeviceSynchDevice

close, disengage, engage, getConnectionInfo, getDeviceClient, getVersion, initialize, initializeIfNecessary, onModuleStateChange, registerArmingStateCallback, resetDeviceConfigurationForOpMode

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.qualcomm.robotcore.hardware.ColorSensor

alpha, argb, blue, enableLed, getI2cAddress, green, red, setI2cAddress

Methods inherited from interface com.qualcomm.robotcore.hardware.NormalizedColorSensor

getNormalizedColors

Methods inherited from interface com.qualcomm.robotcore.hardware.LightSensor

enableLed

Methods inherited from interface com.qualcomm.robotcore.hardware.HardwareDevice

close, getConnectionInfo, getVersion, resetDeviceConfigurationForOpMode

Methods inherited from interface com.qualcomm.hardware.broadcom.BroadcomColorSensor

getParameters, initialize

Field Detail

apiLevelMin

protected static final double apiLevelMin

See Also:

Constant Field Values

apiLevelMax

protected static final double apiLevelMax

See Also:

Constant Field Values

Constructor Detail

RevColorSensorV3

public RevColorSensorV3(I2cDeviceSynchSimple deviceClient)

Method Detail

getDeviceName

public java.lang.String getDeviceName()

Description copied from interface: HardwareDevice

Returns a string suitable for display to the user as to the type of device. Note that this is a device-type-specific name; it has nothing to do with the name by which a user might have configured the device in a robot configuration.

Specified by:

getDeviceName in interface HardwareDevice

Overrides:

getDeviceName in class BroadcomColorSensorImpl

Returns:

device manufacturer and name

getManufacturer

public HardwareDevice.Manufacturer getManufacturer()

Description copied from interface: HardwareDevice

Returns an indication of the manufacturer of this device.

Specified by:

getManufacturer in interface HardwareDevice

Overrides:

getManufacturer in class BroadcomColorSensorImpl

Returns:

the device's manufacturer

getLightDetected

public double getLightDetected()

Description copied from interface: LightSensor

Get the amount of light detected by the sensor, scaled and cliped to a range which is a pragmatically useful sensitivity. Note that returned values INCREASE as the light energy INCREASES.

Specified by:

getLightDetected in interface LightSensor

Returns:

amount of light, on a scale of 0.0 to 1.0

getRawLightDetected

public double getRawLightDetected()

Description copied from interface: LightSensor

Returns a signal whose strength is proportional to the intensity of the light measured. Note that returned values INCREASE as the light energy INCREASES. The units in which this signal is returned are unspecified.

Specified by:

getRawLightDetected in interface LightSensor

Returns:

a value proportional to the amount of light detected, in unspecified units

getRawLightDetectedMax

public double getRawLightDetectedMax()

Description copied from interface: LightSensor

Returns the maximum value that can be returned by LightSensor.getRawLightDetected().

Specified by:

getRawLightDetectedMax in interface LightSensor

Returns:

the maximum value that can be returned by getRawLightDetected

See Also:

LightSensor.getRawLightDetected()

status

public java.lang.String status()

Description copied from interface: LightSensor

Status of this sensor, in string form

Specified by:

status in interface LightSensor

Returns:

status

getDistance

public double getDistance(DistanceUnit unit)

Returns a calibrated, linear sense of distance as read by the infrared proximity part of the sensor. Distance is measured to the plastic housing at the front of the sensor. Natively, the raw optical signal follows an inverse square law. Here, parameters have been fitted to turn that into a linear measure of distance. The function fitted was of the form: RawOptical = a * distance^b + c The calibration was performed with proximity sensor pulses set to 32, LED driver current set to 125ma, and measurement rate set to 100ms. If the end user chooses to use different settings, the device will need to be recalibrated. Additionally, calibration was performed using card stock measured head on. Actual raw values measured will depend on reflectivity and angle of surface. End user should experimentally verify calibration is appropriate for their own application.

Specified by:

getDistance in interface DistanceSensor

Parameters:

unit - the unit of distance in which the result should be returned

Returns:

the currently measured distance in the indicated units. will always be between 0.25 and 6.0 inches.

inFromOptical

protected double inFromOptical(int rawOptical)

Converts a raw optical inverse-square reading into a fitted, calibrated linear reading in INCHES.

rawOptical

public int rawOptical()