robotpy-rev-color install¶
Setup (tests)¶
If you intend to use the color sensor with your tests or with the simulator, you’ll need to install this package:
pip3 install -U robotpy-rev-color
Or on Windows:
py -3 -m pip install -U robotpy-rev-color
Setup (RoboRIO)¶
You must install this package on your robo if you intend to use it.
Python package¶
So you don’t have to compile this yourself, you can download a pre-packaged version of this from our opkg repository. Use the robotpy-installer and run the following when connected to the internet:
py -3 -m robotpy_installer download-opkg robotpy-rev-color
Then, when connected to the roborio’s network, run:
py -3 -m robotpy_installer install-opkg robotpy-rev-color
For additional details about running robotpy-installer on your computer, see the robotpy-installer documentation.
Usage¶
Using the color sensor is simple. The following code shows how to get the Red, Green, Blue, and the IR (infrared) values from the sensor, as well as the proximity:
import wpilib
from rev.color import ColorSensorV3
class MyRobot(wpilib.TimedRobot):
def robotInit(self):
self.colorSensor = ColorSensorV3(wpilib.I2C.Port.kOnboard)
def robotPeriodic(self):
# Get the sensor attributes
color = self.colorSensor.getColor()
ir = self.colorSensor.getIR()
# Get the individual components of the color
red = color.red
blue = color.blue
green = color.green
# Get the approximate proximity of an object
proximity = self.colorSensor.getProximity()
if __name__ == "__main__":
wpilib.run(MyRobot)
There’s also a more in depth example found at the example folder for the library