267 lines
8.4 KiB
C++
267 lines
8.4 KiB
C++
/**
|
|
* \file pros/optical.hpp
|
|
*
|
|
* Contains prototypes for functions related to the VEX Optical sensor.
|
|
*
|
|
* Visit https://pros.cs.purdue.edu/v5/tutorials/topical/imu.html to learn
|
|
* more.
|
|
*
|
|
* This file should not be modified by users, since it gets replaced whenever
|
|
* a kernel upgrade occurs.
|
|
*
|
|
* \copyright Copyright (c) 2017-2023, Purdue University ACM SIGBots.
|
|
*
|
|
* This Source Code Form is subject to the terms of the Mozilla Public
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
|
|
*/
|
|
|
|
#ifndef _PROS_OPTICAL_HPP_
|
|
#define _PROS_OPTICAL_HPP_
|
|
|
|
#include <stdbool.h>
|
|
|
|
#include <cstdint>
|
|
|
|
#include "pros/optical.h"
|
|
|
|
namespace pros {
|
|
class Optical {
|
|
public:
|
|
/**
|
|
* Creates an Optical Sensor object for the given port.
|
|
*
|
|
* This function uses the following values of errno when an error state is
|
|
* reached:
|
|
* ENXIO - The given value is not within the range of V5 ports (1-21).
|
|
* ENODEV - The port cannot be configured as an Optical Sensor
|
|
*
|
|
* \param port
|
|
* The V5 port number from 1-21
|
|
*/
|
|
explicit Optical(const std::uint8_t port);
|
|
|
|
explicit Optical(std::uint8_t port, double time);
|
|
|
|
/**
|
|
* Get the detected color hue
|
|
*
|
|
* This is not available if gestures are being detected. Hue has a
|
|
* range of 0 to 359.999
|
|
*
|
|
* This function uses the following values of errno when an error state is
|
|
* reached:
|
|
* ENXIO - The given value is not within the range of V5 ports (1-21).
|
|
* ENODEV - The port cannot be configured as an Optical Sensor
|
|
*
|
|
* \return hue value if the operation was successful or PROS_ERR_F if the operation
|
|
* failed, setting errno.
|
|
*/
|
|
virtual double get_hue();
|
|
|
|
/**
|
|
* Get the detected color saturation
|
|
*
|
|
* This is not available if gestures are being detected. Saturation has a
|
|
* range of 0 to 1.0
|
|
*
|
|
* This function uses the following values of errno when an error state is
|
|
* reached:
|
|
* ENXIO - The given value is not within the range of V5 ports (1-21).
|
|
* ENODEV - The port cannot be configured as an Optical Sensor
|
|
*
|
|
* \return saturation value if the operation was successful or PROS_ERR_F if
|
|
* the operation failed, setting errno.
|
|
*/
|
|
virtual double get_saturation();
|
|
|
|
/**
|
|
* Get the detected color brightness
|
|
*
|
|
* This is not available if gestures are being detected. Brightness has a
|
|
* range of 0 to 1.0
|
|
*
|
|
* This function uses the following values of errno when an error state is
|
|
* reached:
|
|
* ENXIO - The given value is not within the range of V5 ports (1-21).
|
|
* ENODEV - The port cannot be configured as an Optical Sensor
|
|
*
|
|
* \return brightness value if the operation was successful or PROS_ERR_F if
|
|
* the operation failed, setting errno.
|
|
*/
|
|
virtual double get_brightness();
|
|
|
|
/**
|
|
* Get the detected proximity value
|
|
*
|
|
* This is not available if gestures are being detected. proximity has
|
|
* a range of 0 to 255.
|
|
*
|
|
* This function uses the following values of errno when an error state is
|
|
* reached:
|
|
* ENXIO - The given value is not within the range of V5 ports (1-21).
|
|
* ENODEV - The port cannot be configured as an Optical Sensor
|
|
*
|
|
* \return poximity value if the operation was successful or PROS_ERR if
|
|
* the operation failed, setting errno.
|
|
*/
|
|
virtual std::int32_t get_proximity();
|
|
|
|
/**
|
|
* Set the pwm value of the White LED on the sensor
|
|
*
|
|
* value that ranges from 0 to 100
|
|
*
|
|
* This function uses the following values of errno when an error state is
|
|
* reached:
|
|
* ENXIO - The given value is not within the range of V5 ports (1-21).
|
|
* ENODEV - The port cannot be configured as an Optical Sensor
|
|
*
|
|
* \return The Error code encountered
|
|
*/
|
|
virtual std::int32_t set_led_pwm(uint8_t value);
|
|
|
|
/**
|
|
* Get the pwm value of the White LED on the sensor
|
|
*
|
|
* value that ranges from 0 to 100
|
|
*
|
|
* This function uses the following values of errno when an error state is
|
|
* reached:
|
|
* ENXIO - The given value is not within the range of V5 ports (1-21).
|
|
* ENODEV - The port cannot be configured as an Optical Sensor
|
|
*
|
|
* \return LED pwm value if the operation was successful or PROS_ERR if
|
|
* the operation failed, setting errno.
|
|
*/
|
|
virtual std::int32_t get_led_pwm();
|
|
|
|
/**
|
|
* Get the processed RGBC data from the sensor
|
|
*
|
|
* This function uses the following values of errno when an error state is
|
|
* reached:
|
|
* ENXIO - The given value is not within the range of V5 ports (1-21).
|
|
* ENODEV - The port cannot be configured as an Optical Sensor
|
|
*
|
|
* \return rgb value if the operation was successful or an optical_rgb_s_t
|
|
* with all fields set to PROS_ERR if the operation failed, setting errno.
|
|
*/
|
|
virtual pros::c::optical_rgb_s_t get_rgb();
|
|
|
|
/**
|
|
* Get the raw un-processed RGBC data from the sensor
|
|
*
|
|
* This function uses the following values of errno when an error state is
|
|
* reached:
|
|
* ENXIO - The given value is not within the range of V5 ports (1-21).
|
|
* ENODEV - The port cannot be configured as an Optical Sensor
|
|
*
|
|
* \return raw rgb value if the operation was successful or an optical_raw_s_t
|
|
* with all fields set to PROS_ERR if the operation failed, setting errno.
|
|
*/
|
|
virtual pros::c::optical_raw_s_t get_raw();
|
|
|
|
/**
|
|
* Get the most recent gesture data from the sensor
|
|
*
|
|
* Gestures will be cleared after 500mS
|
|
* 0 = no gesture
|
|
* 1 = up (towards cable)
|
|
* 2 = down
|
|
* 3 = right
|
|
* 4 = left
|
|
*
|
|
* This function uses the following values of errno when an error state is
|
|
* reached:
|
|
* ENXIO - The given value is not within the range of V5 ports (1-21).
|
|
* ENODEV - The port cannot be configured as an Optical Sensor
|
|
*
|
|
* \return gesture value if the operation was successful or PROS_ERR if
|
|
* the operation failed, setting errno.
|
|
*/
|
|
virtual pros::c::optical_direction_e_t get_gesture();
|
|
|
|
/**
|
|
* Get the most recent raw gesture data from the sensor
|
|
*
|
|
* This function uses the following values of errno when an error state is
|
|
* reached:
|
|
* ENXIO - The given value is not within the range of V5 ports (1-21).
|
|
* ENODEV - The port cannot be configured as an Optical Sensor
|
|
*
|
|
* \return gesture value if the operation was successful or an optical_gesture_s_t
|
|
* with all fields set to PROS_ERR if the operation failed, setting errno.
|
|
*/
|
|
virtual pros::c::optical_gesture_s_t get_gesture_raw();
|
|
|
|
/**
|
|
* Enable gesture detection on the sensor
|
|
*
|
|
* This function uses the following values of errno when an error state is
|
|
* reached:
|
|
* ENXIO - The given value is not within the range of V5 ports (1-21).
|
|
* ENODEV - The port cannot be configured as an Optical Sensor
|
|
*
|
|
* \return 1 if the operation is successful or PROS_ERR if the operation failed,
|
|
* setting errno.
|
|
*/
|
|
virtual std::int32_t enable_gesture();
|
|
|
|
/**
|
|
* Disable gesture detection on the sensor
|
|
*
|
|
* This function uses the following values of errno when an error state is
|
|
* reached:
|
|
* ENXIO - The given value is not within the range of V5 ports (1-21).
|
|
* ENODEV - The port cannot be configured as an Optical Sensor
|
|
*
|
|
* \return 1 if the operation is successful or PROS_ERR if the operation failed,
|
|
* setting errno.
|
|
*/
|
|
virtual std::int32_t disable_gesture();
|
|
|
|
/**
|
|
* Set integration time (update rate) of the optical sensor in milliseconds, with
|
|
* minimum time being 3 ms and maximum time being 712 ms. Default is 100 ms, with the
|
|
* optical sensor communciating with the V5 brain every 20 ms.
|
|
*
|
|
* This function uses the following values of errno when an error state is
|
|
* reached:
|
|
* ENXIO - The given value is not within the range of V5 ports (1-21).
|
|
* ENODEV - The port cannot be configured as an Optical Sensor
|
|
*
|
|
* \return 1 if the operation is successful or PROS_ERR_F if the operation failed,
|
|
* setting errno.
|
|
*/
|
|
double get_integration_time();
|
|
|
|
/**
|
|
* Get integration time (update rate) of the optical sensor in milliseconds.
|
|
*
|
|
* This function uses the following values of errno when an error state is
|
|
* reached:
|
|
* ENXIO - The given value is not within the range of V5 ports (1-21).
|
|
* ENODEV - The port cannot be configured as an Optical Sensor
|
|
*
|
|
* \param time
|
|
* The desired integration time in milliseconds
|
|
* \return Integration time in milliseconds if the operation is successful
|
|
* or PROS_ERR if the operation failed, setting errno.
|
|
*/
|
|
std::int32_t set_integration_time(double time);
|
|
|
|
/**
|
|
* Gets the port number of the Optical Sensor.
|
|
*
|
|
* \return The Optical Sensor's port number.
|
|
*/
|
|
virtual std::uint8_t get_port();
|
|
|
|
private:
|
|
const std::uint8_t _port;
|
|
};
|
|
} // namespace pros
|
|
|
|
#endif
|