Tautan Serial#

Perkenalan #

Kelas serial_link memungkinkan pengiriman aliran byte mentah antar robot. Kelas ini dirancang untuk komunikasi antar robot di mana robot pengirim dan penerima sama-sama memahami isi aliran data tersebut.

Setiap penggunaan send menambahkan data ke antrian V5 Brain yang terhubung, dan antrian dibaca masuk pertama keluar pertama (FIFO). Jika beberapa pesan dikirim sebelum V5 Brain lain menggunakan fungsi terima, pesan-pesan tersebut akan disimpan dan dikembalikan satu per satu sesuai urutan pengirimannya. Karena pesan dapat mengantri, pengiriman status yang sama berulang kali setiap putaran dapat menyebabkan penumpukan; untuk logika yang sensitif terhadap waktu, kirim hanya ketika nilai berubah.

Penting: Kedua robot harus menjalankan proyek yang menggunakan serial_link secara bersamaan, jika tidak, tidak ada data yang akan dikirim/diterima.

Konstruktor Kelas #

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

Destruktor Kelas #

Menghapus objek serial_link dan melepaskan sumber daya terkait.

~serial_link();

Parameter #

Parameter	Jenis	Keterangan
`index`	`int32_t`	Port Pintar yang terhubung dengan tautan pesan, ditulis sebagai `PORTx`, di mana `x` adalah nomor port (misalnya, `PORT1`).
`name`	`const char*`	Nama tautan ini. Disarankan agar string unik ini cukup panjang sehingga ketika di-hash oleh vexos akan menghasilkan ID unik. Nama tautan yang buruk adalah sesuatu yang generik seperti “vexlink” karena mungkin digunakan oleh tim lain.
`type`	`linkType`	Jenis tautan, yaitu `linkType::manager` atau `linkType::worker`Informasi ini digunakan untuk mengkonfigurasi radio dengan benar dan juga menentukan bandwidth yang tersedia untuk transmisi dan penerimaan. Robot manajer memiliki bandwidth dua kali lipat (1040 byte/detik) untuk mengirim informasi ke robot pekerja (520 byte/detik). `linkType::manager` — Objek serial_link adalah manajer `linkType::worker` — Objek serial_link adalah pekerja
`isWired`	`bool`	Apakah objek serial_link terhubung melalui kabel (nilai default `false`): `true` — Objek serial_link terhubung melalui kabel `false` — Objek serial_link nirkabel

Catatan #

VEXlink mendukung komunikasi nirkabel dan kabel, dengan koneksi kabel yang merekomendasikan kabel pintar yang dimodifikasi untuk mencegah masalah perutean daya.
Untuk komunikasi nirkabel, setiap robot membutuhkan Radio Robot V5 yang terhubung ke Smart Port.
Radio VEXlink dapat digunakan bersamaan dengan radio VEXnet pada Controller V5, yang harus dihubungkan ke Smart Port dengan nomor tertinggi untuk menghindari konflik.
Untuk membuat VEXlink, kedua V5 Brain harus terhubung ke V5 Robot Radio.

Contoh #

Kode untuk Robot 1

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

Kode untuk Robot 2

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

Fungsi Keanggotaan #

Kelas serial_link mencakup fungsi anggota berikut:

isLinked — Memeriksa apakah V5 Brains telah dipasangkan dan berkomunikasi pada tautan ini.
send — Mengirim pesan ke Otak yang berpasangan.
receive — Menunggu dan mengembalikan pesan masuk berikutnya.
received — Mendaftarkan fungsi yang akan dipanggil setiap kali pesan baru diterima.

Sebelum memanggil fungsi anggota serial_link apa pun, sebuah instance serial_link harus dibuat, seperti yang ditunjukkan di bawah ini:

Kode untuk Robot 1

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

Kode untuk Robot 2

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

isLinked #

Mengembalikan nilai yang menunjukkan apakah V5 Brain pada tautan serial telah dipasangkan satu sama lain.

Available Functions

bool isLinked();

Parameters

Fungsi ini tidak memiliki parameter apa pun.

Return Values

Mengembalikan nilai Boolean yang menunjukkan apakah V5 Brains terhubung atau tidak:

true — The two V5 Brains are paired and communicating on this link.
false — The two V5 Brains are not paired on this link.

Notes

Sebaiknya selalu periksa untuk memastikan V5 Brains sudah terhubung di awal proyek sebelum menjalankan kode lebih lanjut.

Examples

Kode untuk Robot 1

// Create the link
  serial_link 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");
  Brain.Screen.newLine();
  Brain.Screen.print("Sending message...");

  // Message to send
  const char* message = "Hello Robot 2";

  // Send the message
  link.send((uint8_t*)message, strlen(message));

Kode untuk Robot 2

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

  // Do not run code UNTIL the Brains are linked
  while (!link.isLinked()) {
    wait(0.1, seconds);
  }
  
  Brain.Screen.print("Robot 2 - Worker");
  Brain.Screen.newLine();
  Brain.Screen.print("Waiting...");

  // Buffer to store incoming bytes
  uint8_t buffer[32] = {0};

  int32_t n = link.receive(buffer, sizeof(buffer) - 1);

  // Null-terminate
  if (n > 0) {
    buffer[n] = 0;

    // Display the message that was sent
    Brain.Screen.clearScreen();
    Brain.Screen.setCursor(1, 1);
    Brain.Screen.print("Robot 2 - Worker");
    Brain.Screen.newLine();
    Brain.Screen.print((char*)buffer);
  }
  else {
    Brain.Screen.newLine();
    Brain.Screen.print("No message received");
  }

send #

Mengirim pesan ke Otak yang berpasangan.

Available Functions

1 — Mengirim pesan menggunakan buffer byte.
int32_t send( 
  uint8_t *buffer, 
  int32_t  length );

2 — Mengirim pesan menggunakan buffer karakter.
int32_t send( 
  const char *buffer, 
  int32_t     length );

Parameters

Parameter	Jenis	Keterangan
`buffer`	`uint8_t` or `const char`	Buffer yang akan dikirim ke V5 Brain lain yang terhubung.
`length`	`int32_t`	Panjang buffer yang akan dikirim.

Return Values

Mengembalikan nilai int32_t yang mewakili jumlah byte yang dikirim.

Examples

Kode untuk Robot 1

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

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

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

  // Track last sent state
  uint8_t lastState = 255;  // impossible initial value

 // Tell Robot 2 when the screen is being pressed
  while (true) {
    uint8_t state = Brain.Screen.pressing() ? 1 : 0;

    // Only send if state changed
    if (state != lastState) {
      link.send(&state, 1);
      lastState = state;
    }

    wait(0.02, seconds);
  }

Kode untuk Robot 2

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

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

  Brain.Screen.clearScreen();
  Brain.Screen.setCursor(1, 1);
  Brain.Screen.print("Robot 2 - Worker");
  Brain.Screen.newLine();
  Brain.Screen.print("Waiting...");

  // Track the last state
  uint8_t lastShown = 255;

  while (true) {
    // Variable stores 1 - pressed, 0 - not pressed 
    uint8_t state = 0;
    int32_t n = link.receive(&state, 1, 200);

    // Only update screen if state changes
    if (n == 1 && state != lastShown) {
      Brain.Screen.clearScreen();
      Brain.Screen.setCursor(1, 1);
      Brain.Screen.print("Robot 2 - Worker");
      Brain.Screen.newLine();

      // Display text if Robot 1's screen is being pressed
      if (state == 1) {
        Brain.Screen.print("Manager IS being pressed!");
      } else {
        Brain.Screen.print("Manager is NOT being pressed");
      }

      lastShown = state;
    }
    wait(0.02, seconds);
  }

receive #

Menunggu dan mengembalikan pesan masuk berikutnya.

Available Functions

1 — Menerima pesan ke dalam buffer karakter dengan batas waktu opsional.
int32_t receive( 
  char    *buffer, 
  int32_t  length, 
  int32_t  timeoutMs = 500);

Parameters

Parameter	Jenis	Keterangan
`buffer`	`char*`	Buffer untuk menyimpan pesan yang diterima.
`length`	`int32_t`	Panjang buffer.
`timeoutMs`	`int32_t`	Berapa lama dalam milidetik `receive` akan menunggu pesan baru hanya jika antrean kosong (nilai default 500ms).

Return Values

Mengembalikan nilai int32_t yang mewakili jumlah byte yang diterima.

Notes

receive mengembalikan pesan antrian berikutnya dari V5 Brain lain yang terhubung.
Pesan dibaca berdasarkan urutan FIFO (pesan terlama yang belum dibaca terlebih dahulu).
Jika antrean kosong saat perintah receive dipanggil, maka antrean akan menunggu hingga timeoutMs untuk pesan baru.
Jika tidak ada pesan yang tiba dalam jendela waktu tersebut, receive mengembalikan 0, dan pesan apa pun yang dikirim setelahnya tetap berada dalam antrian untuk dibaca pada saat berikutnya receive digunakan.

Examples

Kode untuk Robot 1

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

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

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

  // Track last sent state
  uint8_t lastState = 255;  // impossible initial value

 // Tell Robot 2 when the screen is being pressed
  while (true) {
    uint8_t state = Brain.Screen.pressing() ? 1 : 0;

    // Only send if state changed
    if (state != lastState) {
      link.send(&state, 1);
      lastState = state;
    }

    wait(0.02, seconds);
  }

Kode untuk Robot 2

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

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

  Brain.Screen.clearScreen();
  Brain.Screen.setCursor(1, 1);
  Brain.Screen.print("Robot 2 - Worker");
  Brain.Screen.newLine();
  Brain.Screen.print("Waiting...");

  // Track the last state
  uint8_t lastShown = 255;

  while (true) {
    // Variable stores 1 - pressed, 0 - not pressed 
    uint8_t state = 0;
    int32_t n = link.receive(&state, 1, 200);

    // Only update screen if state changes
    if (n == 1 && state != lastShown) {
      Brain.Screen.clearScreen();
      Brain.Screen.setCursor(1, 1);
      Brain.Screen.print("Robot 2 - Worker");
      Brain.Screen.newLine();

      // Display text if Robot 1's screen is being pressed
      if (state == 1) {
        Brain.Screen.print("Manager IS being pressed!");
      } else {
        Brain.Screen.print("Manager is NOT being pressed");
      }

      lastShown = state;
    }
    wait(0.02, seconds);
  }

received #

Mendaftarkan fungsi yang akan dipanggil setiap kali V5 Brain menerima data.

Available Functions

1 — Mendaftarkan fungsi callback untuk setiap buffer byte yang diterima.
void received( 
  void (* callback)(uint8_t *, int32_t) );

Parameters

Parameter	Jenis	Keterangan
`callback`	`void ()(uint8_t , int32_t)`	Fungsi yang telah didefinisikan sebelumnya yang dijalankan ketika V5 Brain menerima data.

Return Values

Fungsi ini tidak mengembalikan nilai.

Notes

Fungsi callback received dipanggil dengan dua argumen: buffer byte dan jumlah byte yang diterima.
Data yang diterima mungkin tidak diakhiri dengan karakter null. Jika fungsi callback memperlakukan data sebagai string, salin byte yang diterima ke dalam array karakter dan tambahkan karakter null sebagai terminator.

Callback Signature

callback(buffer, length)

Argumen	Keterangan
`buffer`	Penunjuk ke buffer byte yang diterima.
`length`	Jumlah byte yang diterima.

Examples

Kode untuk Robot 1

// Create the link.
serial_link link(PORT1, "VEXRoboticsLink123456789", linkType::manager, true);

// Send left or right when pressed.
void screen_pressed() {
  if (Brain.Screen.xPosition() < 240) {
    link.send((uint8_t*)"left", 4);
  } else {
    link.send((uint8_t*)"right", 5);
  }
}

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);
  }
}

Kode untuk Robot 2

// Called when message received.
void received_callback(uint8_t *buffer, int32_t length) {
  char msg[32];

  // Copy safely and null terminate.
  int n = (length < 31) ? length : 31;
  memcpy(msg, buffer, n);
  msg[n] = '\0';

  Brain.Screen.clearScreen();
  Brain.Screen.setCursor(1,1);
  Brain.Screen.print("Robot 2 - Worker");
  Brain.Screen.newLine();

  // Display if Robot 1's screen is pressed on left or right
  if (strcmp(msg, "left") == 0) {
    Brain.Screen.print("Manager pressed LEFT");
  }
  else if (strcmp(msg, "right") == 0) {
    Brain.Screen.print("Manager pressed RIGHT");
  }
}

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

  // Create the link.
  serial_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(received_callback);

  Brain.Screen.clearScreen();
  Brain.Screen.setCursor(1,1);
  Brain.Screen.print("Robot 2 - Worker");
  Brain.Screen.newLine();
  Brain.Screen.print("Waiting...");

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