com.qualcomm.hardware.broadcom

Class BroadcomColorSensorImpl

java.lang.Object

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

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

com.qualcomm.hardware.broadcom.BroadcomColorSensorImpl

All Implemented Interfaces:

BroadcomColorSensor, ColorSensor, HardwareDevice, I2cAddrConfig, I2cAddressableDevice, Light, NormalizedColorSensor, RobotArmingStateNotifier.Callback

Direct Known Subclasses:

RevColorSensorV3

public abstract class BroadcomColorSensorImpl
extends I2cDeviceSynchDeviceWithParameters<I2cDeviceSynchSimple,BroadcomColorSensor.Parameters>
implements BroadcomColorSensor, I2cAddrConfig, Light

BroadcomColorSensorImpl is used to support the Rev Robotics V3 color sensor

Nested Class Summary

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

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

HardwareDevice.Manufacturer

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	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.hardware.broadcom.BroadcomColorSensor

BROADCOM_APDS9151_ADDRESS, BROADCOM_APDS9151_ID

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	BroadcomColorSensorImpl(BroadcomColorSensor.Parameters params, I2cDeviceSynchSimple deviceClient, boolean isOwned)

Method Summary

Modifier and Type	Method and Description
int	alpha() Get the amount of light detected by the sensor as an int.
int	argb() Get the sensed ARGB color value from the sensor.
int	blue() Get the Blue values detected by the sensor as an int.
protected void	delay(int ms)
protected void	disable()
protected void	dumpState()
protected void	enable()
void	enableLed(boolean enable) Enable the LED light
byte	getDeviceID() Returns the flavor of the Broadcom color sensor as reported by the chip itself
java.lang.String	getDeviceName() Returns a string suitable for display to the user as to the type of device.
I2cAddr	getI2cAddress() Get the current I2C Address of this object.
HardwareDevice.Manufacturer	getManufacturer() Returns an indication of the manufacturer of this device.
NormalizedRGBA	getNormalizedColors() Reads the colors from the sensor
int	green() Get the Green values detected by the sensor as an int.
protected boolean	internalInitialize(BroadcomColorSensor.Parameters parameters) Actually attempts to carry out initialization with the indicated parameter block.
boolean	isLightOn() Answers whether the light is on or off
byte[]	read(BroadcomColorSensor.Register reg, int cb) Low level: read data starting at the indicated register
byte	read8(BroadcomColorSensor.Register reg) Low level: read the byte starting at the indicated register
protected byte	readMainCtrl()
protected int	readUnsignedByte(BroadcomColorSensor.Register reg)
protected int	readUnsignedShort(BroadcomColorSensor.Register reg, java.nio.ByteOrder byteOrder)
int	red() In this implementation, the Color methods return 16 bit unsigned values.
protected void	setGain(BroadcomColorSensor.Gain gain)
void	setI2cAddress(I2cAddr i2cAddr) Set the I2C address to a new value.
protected void	setLEDParameters(BroadcomColorSensor.LEDPulseModulation pulseMod, BroadcomColorSensor.LEDCurrent curr)
protected void	setPDrive(BroadcomColorSensor.LEDCurrent ledDrive)
protected void	setProximityPulseCount(int proximityPulseCount)
protected void	setPSRateAndRes(BroadcomColorSensor.PSResolution res, BroadcomColorSensor.PSMeasurementRate rate)
protected boolean	testBits(byte value, byte desired)
protected boolean	testBits(byte value, byte mask, byte desired)
void	write(BroadcomColorSensor.Register reg, byte[] data) Low level: write data starting at the indicated register
void	write8(BroadcomColorSensor.Register reg, int data) Low level: write a byte to the indicated register

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.hardware.broadcom.BroadcomColorSensor

getParameters, initialize

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

close, getConnectionInfo, getVersion, resetDeviceConfigurationForOpMode

Field Detail

TAG

public static final java.lang.String TAG

See Also:

Constant Field Values

Constructor Detail

BroadcomColorSensorImpl

protected BroadcomColorSensorImpl(BroadcomColorSensor.Parameters params,
                                  I2cDeviceSynchSimple deviceClient,
                                  boolean isOwned)

Method Detail

internalInitialize

protected boolean internalInitialize(BroadcomColorSensor.Parameters parameters)

Description copied from class: I2cDeviceSynchDeviceWithParameters

Actually attempts to carry out initialization with the indicated parameter block. If successful, said parameter block should be stored in the I2cDeviceSynchDeviceWithParameters.parameters member variable.

Specified by:

internalInitialize in class I2cDeviceSynchDeviceWithParameters<I2cDeviceSynchSimple,BroadcomColorSensor.Parameters>

Parameters:

parameters - the parameter block with which to initialize

Returns:

whether initialization was successful or not

dumpState

protected void dumpState()

enable

protected void enable()

disable

protected void disable()

testBits

protected boolean testBits(byte value,
                           byte desired)

testBits

protected boolean testBits(byte value,
                           byte mask,
                           byte desired)

readMainCtrl

protected byte readMainCtrl()

setProximityPulseCount

protected void setProximityPulseCount(int proximityPulseCount)

setGain

protected void setGain(BroadcomColorSensor.Gain gain)

setPDrive

protected void setPDrive(BroadcomColorSensor.LEDCurrent ledDrive)

getDeviceID

public byte getDeviceID()

Description copied from interface: BroadcomColorSensor

Returns the flavor of the Broadcom color sensor as reported by the chip itself

Specified by:

getDeviceID in interface BroadcomColorSensor

Returns:

the flavor of the Broadcom color sensor as reported by the chip itself

setLEDParameters

protected void setLEDParameters(BroadcomColorSensor.LEDPulseModulation pulseMod,
                                BroadcomColorSensor.LEDCurrent curr)

setPSRateAndRes

protected void setPSRateAndRes(BroadcomColorSensor.PSResolution res,
                               BroadcomColorSensor.PSMeasurementRate rate)

red

public int red()

In this implementation, the Color methods return 16 bit unsigned values.

Specified by:

red in interface ColorSensor

Returns:

reading, unscaled.

green

public int green()

Description copied from interface: ColorSensor

Get the Green values detected by the sensor as an int.

Specified by:

green in interface ColorSensor

Returns:

reading, unscaled.

blue

public int blue()

Description copied from interface: ColorSensor

Get the Blue values detected by the sensor as an int.

Specified by:

blue in interface ColorSensor

Returns:

reading, unscaled.

alpha

public int alpha()

Description copied from interface: ColorSensor

Get the amount of light detected by the sensor as an int.

Specified by:

alpha in interface ColorSensor

Returns:

reading, unscaled.

argb

public int argb()

Description copied from interface: ColorSensor

Get the sensed ARGB color value from the sensor.

Specified by:

argb in interface ColorSensor

Returns:

a packed 32-bit integer (to be interpreted as unsigned) containing all 4 color channels. To extract a specific channel, you can either manually bitshift and bitmask, (e.g. to extract red, (color >> 16) & 0xFF) or you can use the Android color class' red() green() and blue() methods.

getNormalizedColors

public NormalizedRGBA getNormalizedColors()

Description copied from interface: NormalizedColorSensor

Reads the colors from the sensor

Specified by:

getNormalizedColors in interface NormalizedColorSensor

Returns:

the current set of colors from the sensor

enableLed

public void enableLed(boolean enable)

Description copied from interface: ColorSensor

Enable the LED light

Specified by:

enableLed in interface ColorSensor

Parameters:

enable - true to enable; false to disable

isLightOn

public boolean isLightOn()

Description copied from interface: Light

Answers whether the light is on or off

Specified by:

isLightOn in interface Light

Returns:

whether the light is on or off

getI2cAddress

public I2cAddr getI2cAddress()

Description copied from interface: ColorSensor

Get the current I2C Address of this object. Not necessarily the same as the I2C address of the actual device. Return the current I2C address.

Specified by:

getI2cAddress in interface ColorSensor

Specified by:

getI2cAddress in interface I2cAddressableDevice

Returns:

current I2C address

setI2cAddress

public void setI2cAddress(I2cAddr i2cAddr)

Description copied from interface: ColorSensor

Set the I2C address to a new value.

Specified by:

setI2cAddress in interface ColorSensor

Specified by:

setI2cAddress in interface I2cAddrConfig

Parameters:

i2cAddr - the new I2C address to use

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

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

Returns:

the device's manufacturer

readUnsignedByte

protected int readUnsignedByte(BroadcomColorSensor.Register reg)

readUnsignedShort

protected int readUnsignedShort(BroadcomColorSensor.Register reg,
                                java.nio.ByteOrder byteOrder)

read8

public byte read8(BroadcomColorSensor.Register reg)

Description copied from interface: BroadcomColorSensor

Low level: read the byte starting at the indicated register

Specified by:

read8 in interface BroadcomColorSensor

Parameters:

reg - the location from which to read the data

Returns:

the data that was read

read

public byte[] read(BroadcomColorSensor.Register reg,
                   int cb)

Description copied from interface: BroadcomColorSensor

Low level: read data starting at the indicated register

Specified by:

read in interface BroadcomColorSensor

Parameters:

reg - the location from which to read the data

cb - the number of bytes to read

Returns:

the data that was read

write8

public void write8(BroadcomColorSensor.Register reg,
                   int data)

Description copied from interface: BroadcomColorSensor

Low level: write a byte to the indicated register

Specified by:

write8 in interface BroadcomColorSensor

Parameters:

reg - the location at which to write the data

data - the data to write

write

public void write(BroadcomColorSensor.Register reg,
                  byte[] data)

Description copied from interface: BroadcomColorSensor

Low level: write data starting at the indicated register

Specified by:

write in interface BroadcomColorSensor

delay

protected void delay(int ms)