Link da mensagem#

Introdução #

A classe message_link permite que dois V5 Brain comuniquem enviando mensagens de texto curtas com dados opcionais. Foi concebida para a coordenação entre robôs — como iniciar rotinas, partilhar resultados de sensores ou desencadear comportamentos noutro robô.

Cada utilização de send adiciona uma mensagem à fila do V5 Brain ligado, e a fila é lida pela ordem de chegada (FIFO). Se forem enviadas várias mensagens antes de o outro V5 Brain utilizar receive, estas serão armazenadas e devolvidas uma de cada vez, pela ordem em que foram enviadas. Como as mensagens podem ser colocadas em fila, enviar repetidamente o mesmo estado a cada iteração do ciclo pode criar uma acumulação; para lógica crítica em termos de tempo, envie apenas quando os valores se alteram.

Importante: Ambos os robots devem estar a executar projetos que utilizem message_link em simultâneo, caso contrário, não será enviada/recebida qualquer mensagem.

Construtores de Classes #

message_link( 
  int32_t     index, 
  const char  *name, 
  linkType    type, 
  bool        isWired = false );

Destrutor de classes #

Destrói o objeto message_link ) e liberta os recursos associados.

virtual ~message_link();

Parâmetros #

Parâmetro	Tipo	Descrição
`index`	`int32_t`	A porta inteligente à qual o rádio V5 ou o cabo inteligente está ligado é escrita como `PORTx`, em que `x` é o número da porta (por exemplo, `PORT1`).
`name`	`char`	O nome do link da mensagem.
`type`	`linkType`	O tipo de ligação, seja `linkType::manager` ou `linkType::worker`Esta informação é utilizada para configurar correctamente o rádio e determina também a largura de banda disponível para transmissão e recepção. Um robô gestor tem o dobro da largura de banda disponível (1040 bytes/segundo) para enviar informação ao robô trabalhador (520 bytes/segundo). `linkType::manager` - O objeto message_link é um gestor. `linkType::worker` - O objeto message_link é um trabalhador.
`isWired`	`bool`	Indica se o objeto message_link é cablado. `true` - O objeto message_link é cablado. `false` - O objeto message_link é sem fios.

Exemplo #

Código para o Robot 1

// Create a wireless link in Port 1
message_link link = message_link(
  PORT1, // index
  "VEXRoboticsLink123456789", // name
  linkType::manager, // type
  true); // isWired

Código para o Robot 2

// Create a wireless link in Port 1
message_link link = message_link(
  PORT1, // index
  "VEXRoboticsLink123456789", // name
  linkType::worker, // type
  true); // isWired

Funções de membro #

A classe message_link inclui as seguintes funções membro:

isLinked — Retorna se este Cérebro está ativamente ligado ao seu Cérebro emparelhado.
send — Envia uma mensagem para o Brain emparelhado.
receive — Aguarda e devolve a próxima mensagem recebida.
received — Regista uma função a chamar sempre que uma nova mensagem é recebida.

Antes de chamar qualquer função membro de message_link , deve ser criada uma instância de message_link ), como se mostra abaixo:

Código para o Robot 1

// Create a wireless link in Port 1
message_link link = message_link(
  PORT1, // index
  "VEXRoboticsLink123456789", // name
  linkType::manager, // type
  true); // isWired

Código para o Robot 2

// Create a wireless link in Port 1
message_link link = message_link(
  PORT1, // index
  "VEXRoboticsLink123456789", // name
  linkType::worker, // type
  true); // isWired

isLinked #

O método isLinked retorna se os V5 Brains num MessageLink estão emparelhados entre si.

Available Functions

bool isLinked();

Parameters

Esta função não tem parâmetros.

Return Values

Esta função retorna um valor booleano.

true – Os dois V5 Brains estão emparelhados e a comunicar neste link.
false – Os dois V5 Brains não estão emparelhados nesta ligação.

Notes

É uma boa prática verificar sempre se os módulos V5 estão ligados no início de um projeto, antes de executar qualquer outro código.

Examples

Código para o Robot 1

// Tell the other robot when the screen is being pressed
  // Create the link
  message_link link = message_link(PORT1, "VEXRoboticsLink123456789", linkType::manager, true);

  // Do not run code UNTIL the Brains are linked
  while (!link.isLinked()){
    wait(0.1, seconds);
  }

  Brain.Screen.print("Robot 1 - Manager");

  // Continuously send if the screen is being pressed
  while (true){
    if (Brain.Screen.pressing()){
      link.send("pressed");
    } else {
      link.send("released");
    }
    wait(0.05, seconds);
  }

Código para o Robot 2

// Display if the other robot's screen is being pressed

  // Create the link
  message_link link = message_link(PORT1, "VEXRoboticsLink123456789", linkType::worker, true);
  
  // Do not run code UNTIL the Brains are linked
  while (!link.isLinked()){
   wait(0.1, seconds);
  }

  // Continuously check if Robot 1 has sent "pressed"
  while (true){
    Brain.Screen.clearScreen();
    Brain.Screen.setCursor(1, 1);
    Brain.Screen.print("Robot 2 - Worker");
    Brain.Screen.newLine();
    char msg[32] = {0};                         // buffer for incoming message
    int32_t n = link.receive(msg, sizeof(msg), 100);  // wait up to 100ms
    if (n > 0 && strcmp(msg, "pressed") == 0) {
      Brain.Screen.newLine();
      Brain.Screen.print("Manager is being pressed!");
    }
    wait(0.05, seconds);
  }

send #

Envia uma mensagem através da ligação de ligação.

Available Functions

1 — Envia uma sequência de mensagens.
int32_t send( 
  const char *message );
2 — Envia uma string de mensagem com um double.
int32_t send( 
  const char *message, 
  double      value );
3 — Envia uma string de mensagem com um int32_t e um double.
int32_t send(
  const char *message, 
  int32_t     index, 
  double      value );

Parameters

Parâmetro	Tipo	Descrição
`message`	`const char*`	A mensagem a enviar para o outro V5 Brain ligado.
`index`	`int32_t`	Um número inteiro para enviar ao outro V5 Brain ligado.
`value`	`double`	Um número de ponto flutuante (double) para enviar para o outro V5 Brain ligado. Os números de ponto flutuante são formatados com 4 casas decimais; se forem fornecidas menos casas decimais, são adicionados zeros à direita até que sejam apresentados 4.

Return Values

Esta função não devolve qualquer valor.

Notes

Se apenas a mensagem message for enviada, o outro V5 Brain ligado receberá exatamente essa mensagem.

Se o valor value (e o índice index , se fornecido), o receptor Brain receberá uma única mensagem codificada que combina todos os campos por esta ordem: .message_index_value

Examples

A utilização de link.send(“string”, 1, 2.55) é recebido como .string_1_2.5500.

Código para o Robot 1

// Tell the other robot when the screen is being pressed

// Create the link
message_link link = message_link(PORT1, "VEXRoboticsLink123456789", linkType::manager, true);

// Do not run code UNTIL the Brains are linked
while (!link.isLinked()){
  wait(0.1, seconds);
}

Brain.Screen.print("Robot 1 - Manager");

// Continuously send if the screen is being pressed
while (true){
  if (Brain.Screen.pressing()){
    link.send("pressed");
  } else {
    link.send("released");
  }
  wait(0.05, seconds);
}

Código para o Robot 2

// Display if the other robot's screen is being pressed

// Create the link
message_link link = message_link(PORT1, "VEXRoboticsLink123456789", linkType::worker, true);

// Do not run code UNTIL the Brains are linked
while (!link.isLinked()){
  wait(0.1, seconds);
}
// Continuously check if Robot 1 has sent "pressed"
while (true){
  Brain.Screen.clearScreen();
  Brain.Screen.setCursor(1, 1);
  Brain.Screen.print("Robot 2 - Worker");
  Brain.Screen.newLine();
  char msg[32] = {0};  // buffer for incoming message
  int32_t n = link.receive(msg, sizeof(msg), 100);  // wait up to 100ms
  if (n > 0 && strcmp(msg, "pressed") == 0) {
    Brain.Screen.newLine();
    Brain.Screen.print("Manager is being pressed!");
  }
  wait(0.05, seconds);
}

receive #

Recebe uma mensagem da ligação de ligação.

Available Functions

int32_t receive(
  char     *buffer,
  int32_t   length, 
  int32_t   timeoutMs = 500 );

Parameters

Parâmetro	Tipo	Descrição
`buffer`	`char*`	O buffer para armazenar a mensagem recebida.
`length`	`int32_t`	O comprimento do buffer.
`timeoutMs`	`int32_t`	Em milissegundos, o tempo de espera é de `receive` milissegundos para receber uma nova mensagem. O valor predefinido é 300.000 (300 segundos).

Return Values

Esta função devolve o número de bytes recebidos.

Notes

receive returns the next queued message from the other linked V5 Brain. Messages are read in FIFO order (oldest unread first). If the queue is empty when receive is called, it waits up to the specified timeout for a new message. If no message arrives in that window, receive returns 0, and any message sent afterward remains in the queue to be read the next time receive is used.
Se o outro V5 Brain ligado enviar apenas uma string string, receive e devolverá exactamente essa string.
Se o outro V5 Brain ligado enviar um número inteiro e/ou de ponto flutuante, receive e devolve uma única string codificada que combina todos os campos por esta ordem: .string_integer_float
- Por exemplo, se o outro V5 Brain ligado utilizar link.send(“string”, 1, 2.55), então a utilização de link.receive() devolve uma string codificada como .string_1_2.5500. Pode dividir esta string codificada (ver exemplos abaixo) para extrair o nome da mensagem, valores inteiros e de ponto flutuante.
- Se preferir evitar a divisão/análise manual, utilize received para registar um manipulador para um nome de mensagem específico; o manipulador recebe os valores enviados como argumentos.

Examples

A utilização de link.send(“string”, 1, 2.55) é recebido como .string_1_2.5500.

Código para o Robot 1

// Tell the other robot when the screen is being pressed

// Create the link
message_link link = message_link(PORT1, "VEXRoboticsLink123456789", linkType::manager, true);

// Do not run code UNTIL the Brains are linked
while (!link.isLinked()){
  wait(0.1, seconds);
}

Brain.Screen.print("Robot 1 - Manager");

// Continuously send if the screen is being pressed
while (true){
  if (Brain.Screen.pressing()){
    link.send("pressed");
  } else {
    link.send("released");
  }
  wait(0.05, seconds);
}

Código para o Robot 2

// Display if the other robot's screen is being pressed

// Create the link
message_link link = message_link(PORT1, "VEXRoboticsLink123456789", linkType::worker, true);

// Do not run code UNTIL the Brains are linked
while (!link.isLinked()){
  wait(0.1, seconds);
}
// Continuously check if Robot 1 has sent "pressed"
while (true){
  Brain.Screen.clearScreen();
  Brain.Screen.setCursor(1, 1);
  Brain.Screen.print("Robot 2 - Worker");
  Brain.Screen.newLine();
  char msg[32] = {0};   // buffer for incoming message
  int32_t n = link.receive(msg, sizeof(msg), 100);  // wait up to 100ms
  if (n > 0 && strcmp(msg, "pressed") == 0) {
    Brain.Screen.newLine();
    Brain.Screen.print("Manager is being pressed!");
  }
  wait(0.05, seconds);
}

received #

Regista uma função a ser chamada sempre que o V5 Brain receber uma mensagem enviada.

Available Functions

1 Regista um retorno de chamada para todas as mensagens recebidas (mensagem + valor).
void received(
    void (* callback)(const char *, const char *, double)
);
2 Regista um callback para todas as mensagens recebidas (mensagem + índice + valor).
void received(
    void (* callback)(const char *, const char *, int32_t, double)
);
3 Regista uma função de callback para uma mensagem específica (mensagem + valor).
void received(
    const char *message,
    void      (* callback)(const char *, const char *, double)
);
4 Regista uma função de callback para uma mensagem específica (mensagem + índice + valor).
void received(
    const char *message,
    void      (* callback)(const char *, const char *, int32_t, double)
);

Parameters

Parâmetro	Tipo	Descrição
`message`	`const char *`	O nome da mensagem a monitorizar. Se for omitido, o retorno de chamada será executado para todas as mensagens recebidas.
`callback`	`void ()(const char , const char , double)` or `void (``)(const char , const char , int32_t, double)`	Uma função que é executada quando uma mensagem é recebida.

Return Values

Esta função não devolve qualquer valor.

Callback Signature

1 Recebe o nome do remetente, o nome da mensagem e o valor.
void callback(const char *, const char *, double)
2 Recebe o nome do remetente, o nome da mensagem, o índice e o valor.
void callback(const char *, const char *, int32_t, double)

Tipo	Descrição
1st `const char *`	O nome do link do remetente.
2nd `const char *`	Nome da mensagem recebida.
`int32_t`	O índice associado à mensagem.
`double`	O valor associado à mensagem.

Examples

Código para o Robot 1

// Create the link.
message_link link(PORT1, "LeftRightLink", linkType::manager, true);

// Send whether screen is pressed on left or right.
void screen_pressed() {
  if (Brain.Screen.xPosition() < 240) {
    link.send("left");
  } else {
    link.send("right");
  }
}

int main() {
  /* vexcodeInit() is only required when using VEXcode.
  Remove vexcodeInit() if compiling in VS Code. */
  vexcodeInit();
  
  // Do not run code UNTIL the Brains are linked.
  while (!link.isLinked()) {
    wait(0.1, seconds);
  }

  Brain.Screen.print("Robot 1 - Manager");

  Brain.Screen.pressed(screen_pressed);

  while (true) {
    wait(10, msec);
  }
}

Código para o Robot 2

// Create variable to track where screen is pressed.
int lastPress = 0;

// Update the variable whenever a new message is received.
void message_received(const char* message, const char* linkname, double timestamp) {
  if (strcmp(message, "left") == 0)  lastPress = 1;
  if (strcmp(message, "right") == 0) lastPress = 2;
}

int main() {
  /* vexcodeInit() is only required when using VEXcode.
  Remove vexcodeInit() if compiling in VS Code. */
  vexcodeInit();

  // Create the link.
  message_link link(PORT1, "VEXRoboticsLink123456789", linkType::worker, true);

  // Do not run code UNTIL the Brains are linked.
  while (!link.isLinked()) {
    wait(0.1, seconds);
  }

  link.received(message_received);

  // Display if Robot 1's screen was pressed on the left or right
  while (true) {
    Brain.Screen.clearScreen();
    Brain.Screen.setCursor(1, 1);
    Brain.Screen.print("Robot 2 - Worker");
    Brain.Screen.newLine();

    if (lastPress == 1) {
      Brain.Screen.print("Manager pressed LEFT");
    } else if (lastPress == 2) {
      Brain.Screen.print("Manager pressed RIGHT");
    } else {
      Brain.Screen.print("Waiting...");
    }

    wait(0.1, seconds);
  }
}