enlace serial

¿Qué es un enlace serial?

VEXlink permite la comunicación entre dos cerebros EXP, lo que permite conexiones punto a punto y la creación de redes de comunicación entre varios robots. Admite comunicación inalámbrica y por cable; en estas últimas, se recomienda un cable inteligente modificado para evitar problemas de enrutamiento de energía. Para la comunicación inalámbrica, cada robot necesita una radio robótica V5 conectada a un puerto inteligente. La radio VEXlink puede usarse junto con la radio VEXnet de un controlador V5, que debe conectarse al puerto inteligente con el número más alto para evitar conflictos.

La clase SerialLink dentro de VEXlink permite enviar un flujo de datos entre robots; el contenido del flujo debe ser comprendido tanto por el robot transmisor como por el receptor; esta clase generalmente se utiliza como parte de una capa superior de software que codifica y decodifica paquetes según sea necesario.

Para crear un VEXlink, ambos cerebros EXP deben estar conectados a una radio robótica V5.

Inicializando la clase SerialLink

Un VEXlink se crea utilizando el siguiente constructor:

The serial_link constructor creates a serial_link object.

Parámetro	Descripción
port	Un Puerto inteligente válido al que está conectada la radio VEXlink.
name	El nombre de este enlace. Se recomienda que esta cadena única sea lo suficientemente larga como para que, al ser procesada por vexos, genere un ID único. Un nombre de enlace incorrecto sería algo genérico como “vexlink”, ya que podría ser utilizado por otro equipo.
linktype	The type of link, either linkType::manager or linkType::worker. This information is used to correctly configure the radio and also determines available bandwidth for transmission and reception. A manager robot has double the available bandwidth (1040 bytes/second) to send information to the worker robot (520 bytes/second).
wired	Whether or not it is a wired link. Set to true if wired.

// Construct a VEXlink "seriallink" with the serial_link class.
serial_link seriallink = serial_link(PORT1, "Link", linkType::manager);

This seriallink object will be used in all subsequent examples throughout this API documentation when referring to serial_link class methods.

Métodos de clase

send()

The send(buffer) method sends a buffer through the serial link.

Parámetros	Descripción
buffer	Una cadena o un conjunto de bytes. El mensaje a enviar.

Devuelve: Un entero que representa la longitud del mensaje enviado.

// Send the string 'test'.
seriallink.send('test');

receive()

The receive(length, timeout) method receives data from the serial link.

Parámetros	Descripción
longitud	La cantidad máxima de datos a esperar.
se acabó el tiempo	El valor de tiempo de espera en milisegundos antes de que la función regrese.

Devuelve: Un entero con la longitud de los datos recibidos.

// Wait for 128 bytes of data for 1000mS.
int buffer = seriallink.receive(128, 1000);

recibió()

The received(callback) method registers a callback function for when data is received.

Parámetros	Descripción
llamar de vuelta	La función de devolución de llamada que se llamará cuando se reciban datos.

Devoluciones: Ninguna.