Inercial#

Introducción#

El robot de codificación VEX AIM cuenta con un sensor inercial integrado. Este sensor mide cómo se mueve y gira el robot.

El sensor inercial utiliza dos componentes para lograr esto. El giroscopio mide los giros, como la dirección, la rotación, la guiñada, el balanceo, la inclinación y la velocidad de giro del robot. El acelerómetro mide los cambios en el movimiento, como acelerar, desacelerar o detenerse repentinamente durante una colisión.

Los métodos inerciales pueden utilizarse para rastrear giros, medir la aceleración, detectar colisiones, restablecer los valores de rumbo o rotación y calibrar el sensor.

A continuación se muestra una lista de todos los métodos:

Orientación: Obtenga y restablezca la orientación, el giro o la inclinación del robot.

  • get_rotation — Devuelve cuánto ha girado el robot.

  • get_heading — Devuelve la dirección hacia la que apunta el robot, de 0 a 359,99 grados.

  • get_yaw — Devuelve el ángulo de guiñada del robot.

  • get_roll — Devuelve el ángulo de balanceo del robot.

  • get_pitch — Devuelve el ángulo de cabeceo del robot.

  • reset_rotation — Restablece la rotación actual del robot a 0 grados.

  • reset_heading — Restablece la dirección actual del robot a 0 grados.

  • set_heading — Establece el rumbo actual del robot a un nuevo valor de rumbo.

Choque: Detectar colisiones.

  • crashed — Registra una función para ejecutar cuando se detecta un fallo.

  • set_crash_sensitivity — Establece cuán sensible es la detección de colisiones a los impactos.

Movimiento: Medir la aceleración y la velocidad de giro.

  • get_acceleration — Devuelve la rapidez con la que el robot acelera o desacelera en el eje seleccionado.

  • get_turn_rate — Devuelve la velocidad de rotación del robot en el eje seleccionado.

Calibración: Gestionar la calibración del sensor.

  • calibrate — Calibra el sensor inercial.

  • is_calibrating — Devuelve si el sensor inercial se está calibrando actualmente.

Orientación#

get_rotation#

La rotación indica cuánto ha girado el robot, medida en grados. A diferencia de la orientación, la rotación puede superar los 359,99 grados o disminuir por debajo de 0 grados. Al inicio de un proyecto, el valor de rotación se establece en 0 grados. El comando get_rotation devuelve la rotación actual del robot como un número decimal.

Girar a la derecha aumenta la rotación, y girar a la izquierda la disminuye. Por ejemplo, dos giros completos a la derecha producen una rotación de 720 grados. Un giro completo a la izquierda desde 0 grados produce una rotación de -360 grados.

Usage:
robot.inertial.get_rotation()

Parámetros

Descripción

Este método no tiene parámetros.

# Display the robot's rotation as it rotates
while True:
    robot.screen.clear_screen()
    robot.screen.set_cursor(1, 1)
    robot.screen.print(f"Rotation: {robot.inertial.get_rotation():.2f}")
    wait(50, MSEC)

get_heading#

Un rumbo es la dirección hacia la que apunta el robot, medida en grados de 0 a 359,99. get_heading devuelve el rumbo actual del robot como un número flotante.

La orientación inicial es de 0 grados. Si el robot gira más allá de los 359,99 grados, la orientación vuelve a 0 grados.

Usage:
robot.inertial.get_heading()

Parámetros

Descripción

Este método no tiene parámetros.

# Turn right until the heading reaches 90 degrees
robot.turn(RIGHT)
while robot.inertial.get_heading() < 90:
    wait(50, MSEC)
robot.stop_all_movement()

# Display the robot's heading as it is rotated by hand
while True:
    robot.screen.clear_screen()
    robot.screen.set_cursor(1, 1)
    robot.screen.print(f"Heading: {robot.inertial.get_heading()} degrees")
    wait(50, MSEC)

get_yaw#

El guiñada describe el giro del robot hacia la izquierda o hacia la derecha alrededor de su eje vertical. get_yaw devuelve el ángulo de guiñada del robot en el rango de -180,00 a 180,00 grados como un número flotante.

La imagen a continuación utiliza flechas para mostrar la dirección de rotación positiva para guiñada.

Un robot de codificación VEX AIM con una flecha azul que apunta hacia abajo desde el centro del robot. Alrededor de la flecha azul, una flecha curva negra apunta en el sentido de las agujas del reloj, indicando la dirección positiva del giro.

Usage:
robot.inertial.get_yaw()

Parámetros

Descripción

Este método no tiene parámetros.

# Display the robot's yaw angle as it is rotated by hand
while True:
    robot.screen.clear_screen()
    robot.screen.set_cursor(1, 1)
    robot.screen.print(robot.inertial.get_yaw())
    wait(50, MSEC)

get_roll#

Roll describe la inclinación del robot de lado a lado. get_roll devuelve el ángulo de balanceo del robot en el rango de -180.00 a 180.00 grados como un número flotante.

La imagen a continuación utiliza flechas para mostrar la dirección de rotación positiva del rollo.

Un robot de codificación VEX AIM con una flecha verde que se extiende hacia el frente del robot, en el centro del sensor de visión de IA. Alrededor de la flecha verde, una flecha negra se curva en sentido contrario a las agujas del reloj, indicando la dirección positiva para el balanceo.

Usage:
robot.inertial.get_roll()

Parámetros

Descripción

Este método no tiene parámetros.

# Display the robot's roll angle as it is tilted by hand
while True:
    robot.screen.clear_screen()
    robot.screen.set_cursor(1, 1)
    robot.screen.print(robot.inertial.get_roll())
    wait(50, MSEC)

get_pitch#

El cabeceo describe la inclinación del robot hacia adelante o hacia atrás. get_pitch devuelve el ángulo de cabeceo del robot en el rango de -90,00 a 90,00 grados como un número flotante.

La imagen a continuación utiliza flechas para mostrar la dirección de rotación positiva del paso.

Un robot de codificación VEX AIM con una flecha roja que sobresale del lateral, debajo del logotipo de VEX. Alrededor de la flecha roja, una flecha negra se curva en sentido contrario a las agujas del reloj, indicando la dirección positiva para el cabeceo.

Usage:
robot.inertial.get_pitch()

Parámetros

Descripción

Este método no tiene parámetros.

# Display the robot's pitch angle as it is tilted by hand
while True:
    robot.screen.clear_screen()
    robot.screen.set_cursor(1, 1)
    robot.screen.print(robot.inertial.get_pitch())
    wait(50, MSEC)

reset_rotation#

reset_rotation restablece la rotación actual del robot a 0 grados.

Una vez utilizado este método, el robot realiza el seguimiento de los giros futuros a partir del nuevo valor de rotación de 0 grados.

Usage:
robot.inertial.reset_rotation()

Parámetros

Descripción

Este método no tiene parámetros.

# Reset the robot's rotation if it exceeds 180 degrees
while True:
    if robot.inertial.get_rotation() >= 180:
        robot.inertial.reset_rotation()

    robot.screen.clear_screen()
    robot.screen.set_cursor(1, 1)
    robot.screen.print(f"Rotation: {robot.inertial.get_rotation():.2f}")

    wait(50, MSEC)

reset_heading#

reset_heading restablece la dirección actual del robot a 0 grados.

Tras utilizar este método, la dirección actual del robot se convierte en la nueva dirección de 0 grados.

Usage:
robot.inertial.reset_heading()

Parámetros

Descripción

Este método no tiene parámetros.

# Turn the robot around using a new 90 degree heading
robot.turn_to(90)
wait(1, SECONDS)
robot.inertial.reset_heading()
robot.turn_to(90)

set_heading#

Un rumbo es la dirección hacia la que apunta el robot, medida en grados de 0 a 359,99. set_heading cambia el rumbo actual del robot a un nuevo valor de rumbo.

Por ejemplo, si el robot ha girado para mirar hacia la derecha, al establecer la orientación a 0 grados, esa posición mirando hacia la derecha se convierte en la nueva dirección de 0 grados. A partir de ahí, el robot puede seguir otras direcciones basándose en esa nueva orientación.

Usage:
robot.inertial.set_heading(heading)

Parámetros

Descripción

heading

El valor de rumbo, en grados, que se debe configurar para el robot. Este valor puede estar entre 0 y 359,99.

# Turn the robot to 90 degrees using its new heading
robot.inertial.set_heading(45)
robot.turn_to(90)

Chocar#

crashed#

crashed registra una función que se llamará cuando el robot detecte un impacto o colisión repentina.

Uso:

robot.inertial.crashed(callback, arg)

Parámetros

Descripción

callback

Una función que se define previamente para ejecutarse cuando se detecta una colisión.

arg

Opcional. Una tupla que contiene los argumentos que se pasarán a la función de devolución de llamada. Consulte Uso de funciones con parámetros para obtener más información.

# Define what happens when a crash occurs
def crash_detected():
    # Stop all movement and indicate a crash occurred
    robot.screen.print("Crash detected")
    robot.stop_all_movement()

robot.inertial.crashed(crash_detected)

# Drive forward until crash
robot.move_at(0, 100)

set_crash_sensitivity#

set_crash_sensitivity ajusta cuánta aceleración repentina se necesita para que el robot detecte una colisión.

Usage:
robot.inertial.set_crash_sensitivity(sensitivity)

Parámetros

Descripción

sensitivity

Sensibilidad ante colisiones:

  • HIGH — Máxima sensibilidad; detecta impactos menores y se activa a 1G.
  • NORMAL — Sensibilidad predeterminada; detecta impactos moderados y se activa a 1,5G.
  • LOW — Mínima sensibilidad; detecta impactos más fuertes y se activa a 2G.

def crashed_callback():
    robot.stop_all_movement()
    robot.sound.play(CRASH)

# system event handlers
robot.inertial.crashed(crashed_callback)
# add 15ms delay to make sure events are registered correctly.
wait(15, MSEC)

# Detect a crash at a slow velocity.
robot.set_move_velocity(35, PERCENT)
robot.inertial.set_crash_sensitivity(HIGH)
robot.move_at(0)

Movimiento#

get_acceleration#

La aceleración indica la rapidez con la que el robot acelera o desacelera. get_acceleration devuelve la aceleración del robot en el eje seleccionado, de -4,00 G a 4,00 G, como un valor flotante.

G es una unidad que se utiliza para medir la aceleración. 1 G es aproximadamente la aceleración que sientes debido a la gravedad cuando estás sentado en reposo.

El valor puede ser positivo o negativo dependiendo de la dirección de la aceleración en el eje seleccionado. En AIM, las opciones de eje se nombran según las direcciones del robot: FORWARD, RIGHTWARDy DOWNWARD.

Un robot de codificación VEX AIM con flechas direccionales que se extienden desde el centro del robot. Una flecha verde etiquetada como "adelante" se extiende desde la parte frontal del robot, una flecha azul etiquetada como "abajo" se extiende desde la parte inferior del robot y una flecha roja etiquetada como "a la derecha" se extiende desde el lateral del robot debajo del logotipo de VEX.

Uso:

robot.inertial.get_acceleration(type)

Parámetros

Descripción

type

Eje para medir la aceleración:

  • DOWNWARD — Mide la aceleración en la dirección vertical del robot.
  • FORWARD — Mide la aceleración en la dirección de adelante hacia atrás del robot.
  • RIGHTWARD — Mide la aceleración en la dirección de lado a lado del robot.

# Display the acceleration as the robot begins to move
robot.screen.set_cursor(4,1)
sitting_accel = robot.inertial.get_acceleration(RIGHTWARD)
robot.screen.print(f"Resting: {sitting_accel:.2f}")
wait(0.5, SECONDS)
robot.screen.next_row()

robot.move_at(90, 100)
wait(0.1, SECONDS)

robot.screen.print(f"Startup: {robot.inertial.get_acceleration(RIGHTWARD):.2f}")

get_turn_rate#

La velocidad de giro indica la rapidez con la que gira el robot. get_turn_rate devuelve la velocidad de giro del robot en grados por segundo \(dps\) como un número decimal, desde -1000,00 hasta 1000,00 dps.

El valor puede ser positivo o negativo según la dirección de rotación del robot en el eje seleccionado. La imagen a continuación utiliza flechas para mostrar la dirección de rotación positiva para el balanceo, el cabeceo y la guiñada.

Un robot de codificación VEX AIM con flechas direccionales que se extienden desde el centro del robot. Una flecha verde etiquetada como "roll" se extiende desde la parte frontal del robot con una flecha curva negra que apunta en sentido contrario a las agujas del reloj a su alrededor. Una flecha azul etiquetada como "Yaw" se extiende desde la parte inferior del robot con una flecha curva negra que apunta en el sentido de las agujas del reloj a su alrededor. Y una flecha roja etiquetada como "Pitch" se extiende desde el lateral del robot debajo del logotipo de VEX, con una flecha curva negra que apunta en sentido contrario a las agujas del reloj a su alrededor.

Usage:
robot.inertial.get_turn_rate(axis)

Parámetros

Descripción

axis

¿Qué orientación devolver?:

  • YAW
  • ROLL
  • PITCH
# Display the gyro rate as the robot is rotated by hand
while True:
    robot.screen.clear_screen()
    robot.screen.set_cursor(1, 1)
    robot.screen.print(robot.inertial.get_turn_rate(YAW))
    wait(50, MSEC)

Calibración#

La calibración ayuda al sensor inercial a medir los giros correctamente, compensando el ruido y la deriva del sensor durante un período de 2 segundos. Durante este tiempo, el robot debe permanecer completamente inmóvil sobre una superficie estable. El movimiento durante la calibración puede producir resultados inexactos.

Los robots VEX intentan calibrarse automáticamente al iniciarse, esperando hasta que no detecten movimiento. Sin embargo, si el robot se transporta o se mueve durante el inicio, el sensor podría no calibrarse correctamente o generar una calibración incorrecta.

Si tu proyecto depende en gran medida de una dirección precisa, o si necesitas giros consistentes y repetibles, llamar a calibrate al inicio de tu código puede ser útil. Es recomendable mostrar un mensaje como «Calibrando…» en la pantalla del robot durante la calibración y luego actualizarlo a «Calibración completada» para recordarte (y a cualquier otra persona que use el robot) que este debe permanecer inmóvil durante este proceso.

calibrate#

calibrate calibra el giroscopio. La calibración ayuda al sensor inercial a medir los giros correctamente midiendo y compensando el ruido y la deriva del sensor durante un período de 2 segundos. Durante este tiempo, el robot debe permanecer completamente inmóvil sobre una superficie estable. El movimiento durante la calibración puede producir resultados inexactos.

Los robots VEX intentan calibrarse automáticamente al iniciarse, esperando hasta que no detecten movimiento. Sin embargo, si el robot se transporta o se mueve durante el inicio, el sensor podría no calibrarse correctamente o generar una calibración incorrecta.

Usage:
robot.inertial.calibrate()

Parámetros

Descripción

Este método no tiene parámetros.

# Calibrate the gyro before moving
robot.inertial.calibrate()
robot.screen.show_emoji(THINKING)
wait(2, SECONDS)
robot.screen.show_emoji(PROUD)
robot.move_for(50, 90)

is_calibrating#

is_calibrating devuelve un valor booleano que indica si el sensor inercial se está calibrando.

  • True — El sensor inercial se está calibrando.

  • False — El sensor inercial no se está calibrando.

Usage:
robot.inertial.is_calibrating()

Parámetros

Descripción

Este método no tiene parámetros.

# Move after the calibration is completed
robot.inertial.calibrate()
while robot.inertial.is_calibrating():
    robot.screen.show_emoji(THINKING)
    wait(50, MSEC)
robot.screen.show_emoji(PROUD)
robot.move_for(50, 90)