Nasc Teachtaireachta

Réamhrá

Ligeann an rang message_link do dhá Inchinn V5 cumarsáid a dhéanamh trí theachtaireachtaí gearra teaghrán a sheoladh le sonraí beaga roghnacha. Tá sé deartha le haghaidh comhordú róbat go róbat — amhail gnáthaimh a thosú, torthaí braiteoirí a roinnt, nó iompraíochtaí a spreagadh ar róbat eile.

Cuireann gach úsáid a bhaintear as send teachtaireacht le scuaine an V5 Brain nasctha, agus léitear an scuaine isteach ar dtús, amach ar dtús (FIFO). Má sheoltar il-theachtaireachtaí sula n-úsáideann an V5 Brain eile receive, stórálfar agus cuirfear ar ais iad ceann ar cheann san ord inar seoladh iad. Ós rud é gur féidir le teachtaireachtaí scuaine a dhéanamh, d’fhéadfadh sé go gcruthófaí riaráiste má sheoltar an stádas céanna arís agus arís eile i ngach lúb; i gcás loighic ríthábhachtach ó thaobh ama de, seoltar ach amháin nuair a athraíonn luachanna.

Tábhachtach: Caithfidh an dá róbat tionscadail a úsáideann message_link a bheith ag rith ag an am céanna, nó ní sheolfar/nasc_teachtaireachta ar bith.

Tógálaithe Ranga

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

Scriostóir Ranga

Scriosann sé an réad message_link agus scaoileann sé acmhainní gaolmhara.

virtual ~message_link();

Paraiméadair

Paraiméadar	Cineál	Cur síos
index	int32_t	An Port Cliste a bhfuil an Raidió V5, nó an Cábla Cliste, ceangailte leis, scríofa mar PORTx, áit a seasann x don uimhir phoirt (mar shampla, PORT1).
name	char	Ainm an Nasc Teachtaireachta.
type	linkType	An cineál nasc, bíodh sé linkType::manager nó linkType::workerÚsáidtear an fhaisnéis seo chun an raidió a chumrú i gceart agus cinneann sé an bandaleithead atá ar fáil le haghaidh tarchuir agus glactha freisin. Tá dhá oiread an bandaleithead atá ar fáil ag róbat bainisteora (1040 beart/soicind) chun faisnéis a sheoladh chuig an róbat oibrí (520 beart/soicind). linkType::manager - Is bainisteoir an réad message_link. linkType::worker - Is oibrí an réad message_link.
isWired	bool	Cibé an bhfuil an réad message_link sreangaithe. true - Tá an réad message_link sreangaithe. false - Tá an réad message_link gan sreang.

Sampla

Cód do Róbat 1

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

Cód do Róbat 2

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

Feidhmeanna na mBall

Áirítear leis an rang message_link na feidhmeanna ball seo a leanas:

• isLinked — Tugann sé seo ar ais an bhfuil an Inchinn seo ceangailte go gníomhach lena Inchinn phéireáilte.

• send — Seolann sé teachtaireacht chuig an Inchinn phéireáilte.

• receive — Fanann sé leis an gcéad teachtaireacht isteach eile agus seolann sé ar ais í.

• received — Cláraíonn sé feidhm le glaoch uirthi aon uair a fhaightear teachtaireacht nua.

Sula nglaotar ar aon fheidhmeanna ball message_link , ní mór sampla message_link a chruthú, mar a thaispeántar thíos:

Cód do Róbat 1

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

Cód do Róbat 2

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

isLinked

Tugann an modh isLinked ar ais cibé an bhfuil na V5 Brains ar MessageLink péireáilte le chéile.

Available Functions

bool isLinked();

Parameters

Níl aon pharaiméadair ag an bhfeidhm seo.

Return Values

Tugann an fheidhm seo luach booléanach ar ais.

• true – Tá an dá inchinn V5 péireáilte agus ag cumarsáid ar an nasc seo.

• false – Níl an dá Inchinn V5 péireáilte ar an nasc seo.

Notes

Is dea-chleachtas é a sheiceáil i gcónaí go bhfuil na V5 Brains nasctha ag tús tionscadail sula ritheann tú aon chód eile.

Examples

Cód do Róbat 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ód do Róbat 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

Seolann sé teachtaireacht thar an nasc nasc.

Available Functions

1 — Seolann sé teaghrán teachtaireachta.

int32_t send( 
  const char *message );

2 — Seolann teaghrán teachtaireachta le double.

int32_t send( 
  const char *message, 
  double      value );

3 — Seolann teaghrán teachtaireachta le int32_t agus double.

int32_t send(
  const char *message, 
  int32_t     index, 
  double      value );

Parameters

Paraiméadar	Cineál	Cur síos
message	const char*	An teachtaireacht le seoladh chuig an inchinn V5 nasctha eile.
index	int32_t	Slánuimhir le seoladh chuig an V5 Brain nasctha eile.
value	double	Dúbailt le seoladh chuig an V5 Brain nasctha eile. Déantar dúbailtí a fhormáidiú go 4 dheachúlacha; má sholáthraítear níos lú deachúlacha, cuirtear nialais ina ndiaidh leis go dtí go dtaispeántar 4.

Return Values

Ní thugann an fheidhm seo aon luachanna ar ais.

Notes

Mura seoltar ach message , faigheann an V5 Brain nasctha eile an teachtaireacht chruinn sin.

Má chuirtear luach value (agus innéacs index más soláthraítear) san áireamh, faigheann an Inchinn a fhaigheann teachtaireacht ionchódaithe aonair a chomhcheanglaíonn na réimsí go léir san ord seo: .message_index_value

Examples

Ag baint úsáide as link.send(“string”, 1, 2.55) mar .string_1_2.5500.

Cód do Róbat 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ód do Róbat 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

Faigheann sé teachtaireacht ón nasc nasc.

Available Functions

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

Parameters

Paraiméadar	Cineál	Cur síos
buffer	char*	An maolán chun an teachtaireacht a fuarthas a stóráil.
length	int32_t	Fad an mhaoláin.
timeoutMs	int32_t	Cé chomh fada i milleasoicindí a fhanfaidh receive le haghaidh teachtaireacht nua ach amháin má tá an scuaine folamh. Is é 300,000 (300 soicind) an réamhshocrú.

Return Values

Tugann an fheidhm seo líon na mbeart a fuarthas ar ais.

Notes

• Seolann receive an chéad teachtaireacht eile sa scuaine ón V5 Brain nasctha eile. Léitear teachtaireachtaí in ord FIFO (an ceann is sine gan léamh ar dtús). Má tá an scuaine folamh nuair a ghlaotar receive , fanann sé go dtí an t-am críochnaithe receive le haghaidh teachtaireacht nua. Mura dtagann aon teachtaireacht isteach sa fhuinneog sin, seolann receive 0ar ais, agus fanann aon teachtaireacht a sheoltar ina dhiaidh sin sa scuaine le léamh an chéad uair eile a úsáidtear timeout.

• Más rud é nár sheol an V5 Brain nasctha eile ach teaghrán string, receive seolann sé an teaghrán beacht sin ar ais.

• Má sheol an V5 Brain nasctha eile slánuimhir agus/nó snámhphointe, tugann receive teaghrán ionchódaithe aonair ar ais a chomhcheanglaíonn na réimsí go léir san ord seo: .string_integer_float

  • Mar shampla, má úsáideann an V5 Brain nasctha eile link.send(“string”, 1, 2.55), ansin má úsáideann tú link.receive() , cuirtear teaghrán ionchódaithe ar ais amhail .string_1_2.5500. Is féidir leat an teaghrán ionchódaithe seo a roinnt (féach na samplaí thíos) chun ainm an teachtaireachta, an tslánuimhir, agus na luachanna snámhphointe a bhaint amach.

  • Más fearr leat scoilt/parsáil láimhe a sheachaint, bain úsáid as received chun láimhseálaí a chlárú le haghaidh ainm teachtaireachta ar leith; faigheann an láimhseálaí na luachanna seolta mar argóintí.

Examples

Ag baint úsáide as link.send(“string”, 1, 2.55) mar .string_1_2.5500.

Cód do Róbat 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ód do Róbat 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

Cláraíonn sé feidhm le glaoch uirthi aon uair a fhaigheann an V5 Brain teachtaireacht sheolta.

Available Functions

1 Cláraíonn sé seo glao ar ais do gach teachtaireacht a fhaightear (teachtaireacht + luach).

void received(
    void (* callback)(const char *, const char *, double)
);

2 Cláraíonn sé seo glao ar ais do gach teachtaireacht a fhaightear (teachtaireacht + innéacs + luach).

void received(
    void (* callback)(const char *, const char *, int32_t, double)
);

3 Cláraíonn sé seo glao ar ais le haghaidh teachtaireacht shonrach (teachtaireacht + luach).

void received(
    const char *message,
    void      (* callback)(const char *, const char *, double)
);

4 Cláraíonn sé seo glao ar ais le haghaidh teachtaireacht shonrach (teachtaireacht + innéacs + luach).

void received(
    const char *message,
    void      (* callback)(const char *, const char *, int32_t, double)
);

Parameters

Paraiméadar	Cineál	Cur síos
message	const char *	Ainm an teachtaireachta le héisteacht leis. Mura ndéantar é, ritheann an glao ar ais do gach teachtaireacht a fhaightear.
callback	void (*)(const char *, const char , double) or void ()(const char *, const char *, int32_t, double)	Feidhm a fhorghníomhaítear nuair a fhaightear teachtaireacht.

Return Values

Ní thugann an fheidhm seo aon luachanna ar ais.

Callback Signature

1 Faigheann sé ainm an tseoltóra, ainm an teachtaireachta, agus luach.

void callback(const char *, const char *, double)

2 Faigheann sé ainm an tseoltóra, ainm an teachtaireachta, innéacs agus luach.

void callback(const char *, const char *, int32_t, double)

Cineál	Cur síos
1st const char *	Ainm nasc an tseoltóra.
2nd const char *	Ainm an teachtaireachta a fuarthas.
int32_t	An t-innéacs a bhaineann leis an teachtaireacht.
double	An luach a bhaineann leis an teachtaireacht.

Examples

Cód do Róbat 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ód do Róbat 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);
  }
}