Uploading the first files
This commit is contained in:
carterCE10 committed
commit
eab3a5dd48
356 files changed
+78694
No files matched your search
@@ -0,0 +1,884 @@
|
||||
/**
|
||||
* \file pros/gps.h
|
||||
* \ingroup c-gps
|
||||
*
|
||||
* Contains prototypes for functions related to the VEX GPS.
|
||||
*
|
||||
* This file should not be modified by users, since it gets replaced whenever
|
||||
* a kernel upgrade occurs.
|
||||
*
|
||||
* \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/.
|
||||
*
|
||||
* \defgroup c-gps VEX GPS Sensor C API
|
||||
* \note For a pros-specific usage guide on the GPS, please check out our article [here.](@ref gps)
|
||||
*/
|
||||
|
||||
#ifndef _PROS_GPS_H_
|
||||
#define _PROS_GPS_H_
|
||||
|
||||
#include <stdbool.h>
|
||||
#include <stdint.h>
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
namespace pros {
|
||||
#endif
|
||||
|
||||
/**
|
||||
* \ingroup c-gps
|
||||
*/
|
||||
|
||||
/**
|
||||
* \addtogroup c-gps
|
||||
* @{
|
||||
*/
|
||||
|
||||
/**
|
||||
* \struct gps_position_s_t
|
||||
*/
|
||||
typedef struct __attribute__((__packed__)) gps_position_s {
|
||||
/// X Position (meters)
|
||||
double x;
|
||||
/// Y Position (meters)
|
||||
double y;
|
||||
} gps_position_s_t;
|
||||
|
||||
/**
|
||||
* \struct gps_status_s_t
|
||||
*/
|
||||
typedef struct __attribute__((__packed__)) gps_status_s {
|
||||
/// X Position (meters)
|
||||
double x;
|
||||
/// Y Position (meters)
|
||||
double y;
|
||||
/// Perceived Pitch based on GPS + IMU
|
||||
double pitch;
|
||||
/// Perceived Roll based on GPS + IMU
|
||||
double roll;
|
||||
/// Perceived Yaw based on GPS + IMU
|
||||
double yaw;
|
||||
} gps_status_s_t;
|
||||
|
||||
/**
|
||||
* \struct gps_orientation_s_t
|
||||
*/
|
||||
typedef struct __attribute__((__packed__)) gps_orientation_s {
|
||||
/// Perceived Pitch based on GPS + IMU
|
||||
double pitch;
|
||||
/// Perceived Roll based on GPS + IMU
|
||||
double roll;
|
||||
/// Perceived Yaw based on GPS + IMU
|
||||
double yaw;
|
||||
} gps_orientation_s_t;
|
||||
|
||||
|
||||
/**
|
||||
* \struct gps_raw_s
|
||||
*/
|
||||
struct gps_raw_s {
|
||||
/// Perceived Pitch based on GPS + IMU
|
||||
double x;
|
||||
/// Perceived Roll based on GPS + IMU
|
||||
double y;
|
||||
/// Perceived Yaw based on GPS + IMU
|
||||
double z;
|
||||
};
|
||||
|
||||
/**
|
||||
* \struct gps_accel_s_t
|
||||
*
|
||||
*/
|
||||
typedef struct gps_raw_s gps_accel_s_t;
|
||||
|
||||
/**
|
||||
* \struct gps_gyro_s_t
|
||||
*
|
||||
*/
|
||||
typedef struct gps_raw_s gps_gyro_s_t;
|
||||
|
||||
#ifdef __cplusplus
|
||||
namespace c {
|
||||
#endif
|
||||
|
||||
|
||||
/**
|
||||
* Set the GPS's offset relative to the center of turning in meters,
|
||||
* as well as its initial position.
|
||||
*
|
||||
* 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 a GPS
|
||||
* EAGAIN - The sensor is still calibrating
|
||||
*
|
||||
* \param port
|
||||
* The V5 GPS port number from 1-21
|
||||
* \param xOffset
|
||||
* Cartesian 4-Quadrant X offset from center of turning (meters)
|
||||
* \param yOffset
|
||||
* Cartesian 4-Quadrant Y offset from center of turning (meters)
|
||||
* \param xInitial
|
||||
* Initial 4-Quadrant X Position, with (0,0) being at the center of the field (meters)
|
||||
* \param yInitial
|
||||
* Initial 4-Quadrant Y Position, with (0,0) being at the center of the field (meters)
|
||||
* \param headingInitial
|
||||
* Heading with 0 being north on the field, in degrees [0,360) going clockwise
|
||||
* \return 1 if the operation was successful or PROS_ERR if the operation
|
||||
* failed, setting errno.
|
||||
*
|
||||
* \b Example
|
||||
* \code
|
||||
* #define GPS_PORT 1
|
||||
* #define X_OFFSET .225
|
||||
* #define Y_OFFSET .223
|
||||
* #define X_INITIAL 1.54
|
||||
* #define Y_INITIAL 1.14
|
||||
* #define HEADING_INITIAL 90
|
||||
*
|
||||
* void initialize() {
|
||||
* gps_initialize_full(GPS_PORT, X_OFFSET, Y_OFFSET, X_INITIAL, Y_INITIAL, HEADING_INITIAL);
|
||||
* }
|
||||
* \endcode
|
||||
*/
|
||||
int32_t gps_initialize_full(uint8_t port, double xInitial, double yInitial, double headingInitial, double xOffset,
|
||||
double yOffset);
|
||||
|
||||
/**
|
||||
* Set the GPS's offset relative to the center of turning in meters.
|
||||
*
|
||||
* 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 a GPS
|
||||
* EAGAIN - The sensor is still calibrating
|
||||
*
|
||||
* \param port
|
||||
* The V5 GPS port number from 1-21
|
||||
* \param xOffset
|
||||
* Cartesian 4-Quadrant X offset from center of turning (meters)
|
||||
* \param yOffset
|
||||
* Cartesian 4-Quadrant Y offset from center of turning (meters)
|
||||
* \return 1 if the operation was successful or PROS_ERR if the operation
|
||||
* failed, setting errno.
|
||||
*
|
||||
* \b Example
|
||||
* \code
|
||||
* #define GPS_PORT 1
|
||||
* #define X_OFFSET -.225
|
||||
* #define Y_OFFSET .225
|
||||
*
|
||||
* void initialize() {
|
||||
* gps_set_offset(GPS_PORT, X_OFFSET, Y_OFFSET);
|
||||
* }
|
||||
* \endcode
|
||||
*/
|
||||
int32_t gps_set_offset(uint8_t port, double xOffset, double yOffset);
|
||||
|
||||
/**
|
||||
* Get the GPS's cartesian location relative to the center of turning/origin in meters.
|
||||
*
|
||||
* 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 a GPS
|
||||
* EAGAIN - The sensor is still calibrating
|
||||
*
|
||||
* \param port
|
||||
* The V5 GPS port number from 1-21
|
||||
* \return A struct (gps_position_s_t) containing the X and Y values if the operation
|
||||
* failed, setting errno.
|
||||
*
|
||||
* \b Example
|
||||
* \code
|
||||
* #define GPS_PORT 1
|
||||
*
|
||||
* void opcontrol() {
|
||||
* gps_position_s_t pos;
|
||||
*
|
||||
* while (true) {
|
||||
* pos = gps_get_offset(GPS_PORT);
|
||||
* screen_print(TEXT_MEDIUM, 1, "X Offset: %4d, Y Offset: %4d", pos.x, pos.y);
|
||||
* delay(20);
|
||||
* }
|
||||
* }
|
||||
* \endcode
|
||||
*/
|
||||
gps_position_s_t gps_get_offset(uint8_t port);
|
||||
|
||||
/**
|
||||
* Sets the robot's location relative to the center of the field in meters.
|
||||
*
|
||||
* 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 a GPS
|
||||
* EAGAIN - The sensor is still calibrating
|
||||
*
|
||||
* \param port
|
||||
* The V5 GPS port number from 1-21
|
||||
* \param xInitial
|
||||
* Initial 4-Quadrant X Position, with (0,0) being at the center of the field (meters)
|
||||
* \param yInitial
|
||||
* Initial 4-Quadrant Y Position, with (0,0) being at the center of the field (meters)
|
||||
* \param headingInitial
|
||||
* Heading with 0 being north on the field, in degrees [0,360) going clockwise
|
||||
* \return 1 if the operation was successful or PROS_ERR if the operation
|
||||
* failed, setting errno.
|
||||
*
|
||||
* \b Example
|
||||
* \code
|
||||
* #define GPS_PORT 1
|
||||
* #define X_INITIAL -1.15
|
||||
* #define Y_INITIAL 1.45
|
||||
* #define HEADING_INITIAL 90
|
||||
*
|
||||
* void initialize() {
|
||||
* gps_set_position(GPS_PORT, X_INITIAL, Y_INITIAL, HEADING_INITIAL);
|
||||
* }
|
||||
* \endcode
|
||||
*/
|
||||
int32_t gps_set_position(uint8_t port, double xInitial, double yInitial, double headingInitial);
|
||||
|
||||
/**
|
||||
* Set the GPS sensor's data rate in milliseconds, only applies to IMU on GPS.
|
||||
*
|
||||
* 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 a GPS
|
||||
* EAGAIN - The sensor is still calibrating
|
||||
*
|
||||
* \param port
|
||||
* The V5 GPS port number from 1-21
|
||||
* \param rate
|
||||
* Data rate in milliseconds (Minimum: 5 ms)
|
||||
* \return 1 if the operation was successful or PROS_ERR if the operation
|
||||
* failed, setting errno.
|
||||
*
|
||||
* \b Example
|
||||
* \code
|
||||
* #define GPS_PORT 1
|
||||
* #define GPS_DATA_RATE 5
|
||||
*
|
||||
* void initialize() {
|
||||
* gps_set_data_rate(GPS_PORT, GPS_DATA_RATE);
|
||||
* while (true) {
|
||||
* // Do something
|
||||
* }
|
||||
* }
|
||||
* \endcode
|
||||
*/
|
||||
int32_t gps_set_data_rate(uint8_t port, uint32_t rate);
|
||||
|
||||
/**
|
||||
* Get the possible RMS (Root Mean Squared) error in meters for GPS position.
|
||||
*
|
||||
* 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 a GPS
|
||||
* EAGAIN - The sensor is still calibrating
|
||||
*
|
||||
* \param port
|
||||
* The V5 GPS port number from 1-21
|
||||
*
|
||||
* \return Possible RMS (Root Mean Squared) error in meters for GPS position.
|
||||
* If the operation failed, returns PROS_ERR_F and errno is set.
|
||||
*
|
||||
* \b Example
|
||||
* \code
|
||||
* #define GPS_PORT 1
|
||||
*
|
||||
* void opcontrol() {
|
||||
* double error;
|
||||
* error = gps_get_error(GPS_PORT);
|
||||
* screen_print(TEXT_MEDIUM, 1, "Error: %4d", error);
|
||||
* }
|
||||
* \endcode
|
||||
*/
|
||||
double gps_get_error(uint8_t port);
|
||||
|
||||
/**
|
||||
* Gets the position and roll, yaw, and pitch of the GPS.
|
||||
*
|
||||
* 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 a GPS
|
||||
* EAGAIN - The sensor is still calibrating
|
||||
*
|
||||
* \param port
|
||||
* The V5 GPS port number from 1-21
|
||||
*
|
||||
* \return A struct (gps_status_s_t) containing values mentioned above.
|
||||
* If the operation failed, all the structure's members are filled with
|
||||
* PROS_ERR_F and errno is set.
|
||||
*
|
||||
* \b Example
|
||||
* \code
|
||||
* #define GPS_PORT 1
|
||||
*
|
||||
* void opcontrol() {
|
||||
* gps_status_s_t status;
|
||||
*
|
||||
* while (true) {
|
||||
* status = gps_get_position_and_orientation(GPS_PORT);
|
||||
* printf("X: %f, Y: %f, Pitch: %f, Roll: %f, Yaw: %f\n", status.x, status.y, status.pitch, status.roll, status.yaw);
|
||||
* delay(20);
|
||||
* }
|
||||
* }
|
||||
* \endcode
|
||||
*/
|
||||
gps_status_s_t gps_get_position_and_orientation(uint8_t port);
|
||||
|
||||
/**
|
||||
* Gets the x and y position on the field of the GPS in meters.
|
||||
*
|
||||
* 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 a GPS
|
||||
* EAGAIN - The sensor is still calibrating
|
||||
*
|
||||
* \param port
|
||||
* The V5 GPS port number from 1-21
|
||||
*
|
||||
* \return A struct (gps_position_s_t) containing values mentioned above.
|
||||
* If the operation failed, all the structure's members are filled with
|
||||
* PROS_ERR_F and errno is set.
|
||||
*
|
||||
* \b Example
|
||||
* \code
|
||||
* #define GPS_PORT 1
|
||||
*
|
||||
* void opcontrol() {
|
||||
* gps_position_s_t position;
|
||||
*
|
||||
* while (true) {
|
||||
* position = gps_get_position(GPS_PORT);
|
||||
* printf("X: %f, Y: %f\n", position.x, position.y);
|
||||
* delay(20);
|
||||
* }
|
||||
* }
|
||||
* \endcode
|
||||
*/
|
||||
gps_position_s_t gps_get_position(uint8_t port);
|
||||
|
||||
/**
|
||||
* Gets the X position in meters of the robot relative to the starting position.
|
||||
*
|
||||
* 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 a GPS
|
||||
* EAGAIN - The sensor is still calibrating
|
||||
*
|
||||
* \param port
|
||||
* The V5 GPS port number from 1-21
|
||||
*
|
||||
* \return The X position in meters. If the operation failed,
|
||||
* returns PROS_ERR_F and errno is set.
|
||||
*
|
||||
* \b Example
|
||||
* \code
|
||||
* #define GPS_PORT 1
|
||||
*
|
||||
* void opcontrol() {
|
||||
* double pos_x;
|
||||
*
|
||||
* while (true) {
|
||||
* pos_x = gps_get_position_x(GPS_PORT);
|
||||
* printf("X: %f\n", pos_x);
|
||||
* delay(20);
|
||||
* }
|
||||
* }
|
||||
* \endcode
|
||||
*/
|
||||
double gps_get_position_x(uint8_t port);
|
||||
|
||||
/**
|
||||
* Gets the Y position in meters of the robot relative to the starting position.
|
||||
*
|
||||
* 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 a GPS
|
||||
* EAGAIN - The sensor is still calibrating
|
||||
*
|
||||
* \param port
|
||||
* The V5 GPS port number from 1-21
|
||||
*
|
||||
* \return The Y position in meters. If the operation failed,
|
||||
* returns PROS_ERR_F and errno is set.
|
||||
*
|
||||
* \b Example
|
||||
* \code
|
||||
* #define GPS_PORT 1
|
||||
*
|
||||
* void opcontrol() {
|
||||
* double pos_y;
|
||||
*
|
||||
* while (true) {
|
||||
* pos_y = gps_get_position_y(GPS_PORT);
|
||||
* printf("Y: %f\n", pos_y);
|
||||
* delay(20);
|
||||
* }
|
||||
* }
|
||||
* \endcode
|
||||
*/
|
||||
double gps_get_position_y(uint8_t port);
|
||||
|
||||
/**
|
||||
* Gets the pitch, roll, and yaw of the GPS relative to the starting orientation.
|
||||
*
|
||||
* 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 a GPS
|
||||
* EAGAIN - The sensor is still calibrating
|
||||
*
|
||||
* \param port
|
||||
* The V5 GPS port number from 1-21
|
||||
*
|
||||
* \return A struct (gps_orientation_s_t) containing values mentioned above.
|
||||
* If the operation failed, all the structure's members are filled with
|
||||
* PROS_ERR_F and errno is set.
|
||||
*
|
||||
* \b Example
|
||||
* \code
|
||||
* #define GPS_PORT 1
|
||||
*
|
||||
* void opcontrol() {
|
||||
* gps_orientation_s_t orientation;
|
||||
*
|
||||
* while (true) {
|
||||
* orientation = gps_get_orientation(GPS_PORT);
|
||||
* printf("pitch: %f, roll: %f, yaw: %f\n", orientation.pitch, orientation.roll, orientation.yaw);
|
||||
* delay(20);
|
||||
* }
|
||||
* }
|
||||
* \endcode
|
||||
*/
|
||||
gps_orientation_s_t gps_get_orientation(uint8_t port);
|
||||
|
||||
/**
|
||||
* Gets the pitch of the robot in degrees relative to the starting oreintation.
|
||||
*
|
||||
* 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 a GPS
|
||||
* EAGAIN - The sensor is still calibrating
|
||||
*
|
||||
* \param port
|
||||
* The V5 GPS port number from 1-21
|
||||
*
|
||||
* \return The pitch in [0,360) degree values. If the operation failed,
|
||||
* returns PROS_ERR_F and errno is set.
|
||||
*
|
||||
* \b Example
|
||||
* \code
|
||||
* #define GPS_PORT 1
|
||||
*
|
||||
* void opcontrol() {
|
||||
* double pitch;
|
||||
*
|
||||
* while (true) {
|
||||
* pitch = gps_get_pitch(GPS_PORT);
|
||||
* printf("pitch: %f\n", pitch);
|
||||
* delay(20);
|
||||
* }
|
||||
* }
|
||||
* \endcode
|
||||
*/
|
||||
double gps_get_pitch(uint8_t port);
|
||||
|
||||
/**
|
||||
* Gets the roll of the robot in degrees relative to the starting oreintation.
|
||||
*
|
||||
* 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 a GPS
|
||||
* EAGAIN - The sensor is still calibrating
|
||||
*
|
||||
* \param port
|
||||
* The V5 GPS port number from 1-21
|
||||
*
|
||||
* \return The roll in [0,360) degree values. If the operation failed,
|
||||
* returns PROS_ERR_F and errno is set.
|
||||
*
|
||||
* \b Example
|
||||
* \code
|
||||
* #define GPS_PORT 1
|
||||
*
|
||||
* void opcontrol() {
|
||||
* double roll;
|
||||
*
|
||||
* while (true) {
|
||||
* roll = gps_get_roll(GPS_PORT);
|
||||
* printf("roll: %f\n", roll);
|
||||
* delay(20);
|
||||
* }
|
||||
* }
|
||||
* \endcode
|
||||
*/
|
||||
double gps_get_roll(uint8_t port);
|
||||
|
||||
/**
|
||||
* Gets the yaw of the robot in degrees relative to the starting oreintation.
|
||||
*
|
||||
* 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 a GPS
|
||||
* EAGAIN - The sensor is still calibrating
|
||||
*
|
||||
* \param port
|
||||
* The V5 GPS port number from 1-21
|
||||
*
|
||||
* \return The yaw in [0,360) degree values. If the operation failed,
|
||||
* returns PROS_ERR_F and errno is set.
|
||||
*
|
||||
* \b Example
|
||||
* \code
|
||||
* #define GPS_PORT 1
|
||||
*
|
||||
* void opcontrol() {
|
||||
* double yaw;
|
||||
*
|
||||
* while (true) {
|
||||
* yaw = gps_get_yaw(GPS_PORT);
|
||||
* printf("yaw: %f\n", yaw);
|
||||
* delay(20);
|
||||
* }
|
||||
* }
|
||||
* \endcode
|
||||
*/
|
||||
double gps_get_yaw(uint8_t port);
|
||||
|
||||
/**
|
||||
* Get the heading in [0,360) degree values.
|
||||
*
|
||||
* 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 a GPS
|
||||
* EAGAIN - The sensor is still calibrating
|
||||
*
|
||||
* \param port
|
||||
* The V5 GPS port number from 1-21
|
||||
*
|
||||
* \return The heading in [0,360) degree values. If the operation failed,
|
||||
* returns PROS_ERR_F and errno is set.
|
||||
*
|
||||
* \b Example
|
||||
* \code
|
||||
* #define GPS_PORT 1
|
||||
*
|
||||
* void opcontrol() {
|
||||
* double heading;
|
||||
*
|
||||
* while (true) {
|
||||
* heading = gps_get_heading(GPS_PORT);
|
||||
* printf("heading: %f\n", heading);
|
||||
* delay(20);
|
||||
* }
|
||||
* }
|
||||
* \endcode
|
||||
*/
|
||||
double gps_get_heading(uint8_t port);
|
||||
|
||||
/**
|
||||
* Get the heading in the max double value and min double value scale.
|
||||
*
|
||||
* 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 a GPS
|
||||
* EAGAIN - The sensor is still calibrating
|
||||
*
|
||||
* \param port
|
||||
* The V5 GPS port number from 1-21
|
||||
*
|
||||
* \return The heading in [DOUBLE_MIN, DOUBLE_MAX] values. If the operation
|
||||
* fails, returns PROS_ERR_F and errno is set.
|
||||
*
|
||||
* \b Example
|
||||
* \code
|
||||
* #define GPS_PORT 1
|
||||
*
|
||||
* void opcontrol() {
|
||||
* double heading_raw;
|
||||
*
|
||||
* while (true) {
|
||||
* heading_raw = gps_get_heading_raw(GPS_PORT);
|
||||
* printf("heading_raw: %f\n", heading_raw);
|
||||
* delay(20);
|
||||
* }
|
||||
* }
|
||||
* \endcode
|
||||
*/
|
||||
double gps_get_heading_raw(uint8_t port);
|
||||
|
||||
/**
|
||||
* Get the GPS's raw gyroscope values
|
||||
*
|
||||
* 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 a GPS
|
||||
* EAGAIN - The sensor is still calibrating
|
||||
*
|
||||
* \param port
|
||||
* The V5 GPS port number from 1-21
|
||||
* \return A struct (gps_gyro_s_t) containing values mentioned above.
|
||||
* If the operation failed, all the
|
||||
* structure's members are filled with PROS_ERR_F and errno is set.
|
||||
*
|
||||
* \b Example
|
||||
* \code
|
||||
* #define GPS_PORT 1
|
||||
*
|
||||
* void opcontrol() {
|
||||
* gps_gyro_s_t gyro;
|
||||
*
|
||||
* while (true) {
|
||||
* gyro = gps_get_gyro(GPS_PORT);
|
||||
* printf("Gyro: %f %f %f\n", gyro.x, gyro.y, gyro.z);
|
||||
* delay(20);
|
||||
* }
|
||||
* }
|
||||
* \endcode
|
||||
*/
|
||||
gps_gyro_s_t gps_get_gyro_rate(uint8_t port);
|
||||
|
||||
/**
|
||||
* Get the GPS's raw gyroscope value in x-axis
|
||||
*
|
||||
* 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 a GPS
|
||||
* EAGAIN - The sensor is still calibrating
|
||||
*
|
||||
* \param port
|
||||
* The V5 GPS port number from 1-21
|
||||
* \return The raw gyroscope value in x-axis. If the operation fails, returns
|
||||
* PROS_ERR_F and errno is set.
|
||||
*
|
||||
* \b Example
|
||||
* \code
|
||||
* #define GPS_PORT 1
|
||||
*
|
||||
* void opcontrol() {
|
||||
* double gyro_x;
|
||||
*
|
||||
* while (true) {
|
||||
* gyro_x = gps_get_gyro_x(GPS_PORT);
|
||||
* printf("gyro_x: %f\n", gyro_x);
|
||||
* delay(20);
|
||||
* }
|
||||
* }
|
||||
* \endcode
|
||||
*/
|
||||
double gps_get_gyro_rate_x(uint8_t port);
|
||||
|
||||
/**
|
||||
* Get the GPS's raw gyroscope value in y-axis
|
||||
*
|
||||
* 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 a GPS
|
||||
* EAGAIN - The sensor is still calibrating
|
||||
*
|
||||
* \param port
|
||||
* The V5 GPS port number from 1-21
|
||||
* \return The raw gyroscope value in y-axis. If the operation fails, returns
|
||||
* PROS_ERR_F and errno is set.
|
||||
*
|
||||
* \b Example
|
||||
* \code
|
||||
* #define GPS_PORT 1
|
||||
*
|
||||
* void opcontrol() {
|
||||
* double gyro_y;
|
||||
*
|
||||
* while (true) {
|
||||
* gyro_y = gps_get_gyro_y(GPS_PORT);
|
||||
* printf("gyro_y: %f\n", gyro_y);
|
||||
* delay(20);
|
||||
* }
|
||||
* }
|
||||
* \endcode
|
||||
*/
|
||||
double gps_get_gyro_rate_y(uint8_t port);
|
||||
|
||||
/**
|
||||
* Get the GPS's raw gyroscope value in z-axis
|
||||
*
|
||||
* 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 a GPS
|
||||
* EAGAIN - The sensor is still calibrating
|
||||
*
|
||||
* \param port
|
||||
* The V5 GPS port number from 1-21
|
||||
* \return The raw gyroscope value in z-axis. If the operation fails, returns
|
||||
* PROS_ERR_F and errno is set.
|
||||
*
|
||||
* \b Example
|
||||
* \code
|
||||
* #define GPS_PORT 1
|
||||
*
|
||||
* void opcontrol() {
|
||||
* double gyro_z;
|
||||
*
|
||||
* while (true) {
|
||||
* gyro_z = gps_get_gyro_z(GPS_PORT);
|
||||
* printf("gyro_z: %f\n", gyro_z);
|
||||
* delay(20);
|
||||
* }
|
||||
* }
|
||||
* \endcode
|
||||
*/
|
||||
double gps_get_gyro_rate_z(uint8_t port);
|
||||
|
||||
/**
|
||||
* Get the GPS's raw accelerometer values
|
||||
*
|
||||
* 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 GPS
|
||||
* EAGAIN - The sensor is still calibrating
|
||||
*
|
||||
* \param port
|
||||
* The V5 GPS's port number from 1-21
|
||||
* \return A struct (gps_accel_s_t) containing values mentioned above.
|
||||
* If the operation failed, all the
|
||||
* structure's members are filled with PROS_ERR_F and errno is set.
|
||||
*
|
||||
* \b Example
|
||||
* \code
|
||||
* #define GPS_PORT 1
|
||||
*
|
||||
* void opcontrol() {
|
||||
* gps_accel_s_t accel;
|
||||
*
|
||||
* while (true) {
|
||||
* accel = gps_get_accel(GPS_PORT);
|
||||
* printf("X: %f, Y: %f, Z: %f\n", accel.x, accel.y, accel.z);
|
||||
* delay(20);
|
||||
* }
|
||||
* }
|
||||
* \endcode
|
||||
*/
|
||||
gps_accel_s_t gps_get_accel(uint8_t port);
|
||||
|
||||
/**
|
||||
* Get the GPS's raw accelerometer value in x-axis
|
||||
*
|
||||
* 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 GPS
|
||||
* EAGAIN - The sensor is still calibrating
|
||||
*
|
||||
* \param port
|
||||
* The V5 GPS's port number from 1-21
|
||||
* \return The raw accelerometer value in x-axis. If the operation fails, returns
|
||||
* PROS_ERR_F and errno is set.
|
||||
*
|
||||
* \b Example
|
||||
* \code
|
||||
* #define GPS_PORT 1
|
||||
*
|
||||
* void opcontrol() {
|
||||
* double accel_x;
|
||||
*
|
||||
* while (true) {
|
||||
* accel_x = gps_get_accel_x(GPS_PORT);
|
||||
* printf("accel_x: %f\n", accel_x);
|
||||
* delay(20);
|
||||
* }
|
||||
* }
|
||||
* \endcode
|
||||
*/
|
||||
double gps_get_accel_x(uint8_t port);
|
||||
|
||||
/**
|
||||
* Get the GPS's raw accelerometer value in y-axis
|
||||
*
|
||||
* 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 GPS
|
||||
* EAGAIN - The sensor is still calibrating
|
||||
*
|
||||
* \param port
|
||||
* The V5 GPS's port number from 1-21
|
||||
* \return The raw accelerometer value in y-axis. If the operation fails, returns
|
||||
* PROS_ERR_F and errno is set.
|
||||
*
|
||||
* \b Example
|
||||
* \code
|
||||
* #define GPS_PORT 1
|
||||
*
|
||||
* void opcontrol() {
|
||||
* double accel_y;
|
||||
*
|
||||
* while (true) {
|
||||
* accel_y = gps_get_accel_y(GPS_PORT);
|
||||
* printf("accel_y: %f\n", accel_y);
|
||||
* delay(20);
|
||||
* }
|
||||
* }
|
||||
* \endcode
|
||||
*/
|
||||
double gps_get_accel_y(uint8_t port);
|
||||
|
||||
/**
|
||||
* Get the GPS's raw accelerometer value in z-axis
|
||||
*
|
||||
* 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 GPS
|
||||
* EAGAIN - The sensor is still calibrating
|
||||
*
|
||||
* \param port
|
||||
* The V5 GPS's port number from 1-21
|
||||
* \return The raw accelerometer value in z-axis. If the operation fails, returns
|
||||
* PROS_ERR_F and errno is set.
|
||||
*
|
||||
* \b Example
|
||||
* \code
|
||||
* #define GPS_PORT 1
|
||||
*
|
||||
* void opcontrol() {
|
||||
* double accel_z;
|
||||
*
|
||||
* while (true) {
|
||||
* accel_z = gps_get_accel_z(GPS_PORT);
|
||||
* printf("accel_z: %f\n", accel_z);
|
||||
* delay(20);
|
||||
* }
|
||||
* }
|
||||
* \endcode
|
||||
*/
|
||||
double gps_get_accel_z(uint8_t port);
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
}
|
||||
}
|
||||
#endif
|
||||
|
||||
#endif
|
||||
Reference in new issue
Block a user