Comórtas#

Réamhrá#

Cabhraíonn an rang comórtas competition leat tionscadal V5 a struchtúrú le haghaidh rialú oifigiúil comórtais. Ligeann sé duit feidhmeanna a chlárú le rith le linn Rialú Uathrialach agus Rialú Tiománaí, agus soláthraíonn sé seiceálacha stádais simplí ionas gur féidir le do chód freagairt do staid mheaitseála (cumasaithe/díchumasaithe, uathrialach/tiománaí, rialú allamuigh, srl.).

Tógálaithe Ranga#

competition();

Scriostóir Ranga#

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

~competition();

Paraiméadair#

Ní ghlacann an tógálaí seo le haon pharaiméadair.

Samplaí#

// Create the competition instance
competition Competition = competition();

Feidhmeanna na mBall#

Áirítear leis an rang comórtas competition na feidhmeanna ball seo a leanas:

  • autonomous — Cláraíonn sé feidhm le glaoch uirthi nuair a thosaíonn an tréimhse Uathrialach.

  • drivercontrol — Cláraíonn sé feidhm le glaoch uirthi nuair a thosaíonn an tréimhse Rialaithe Tiománaí.

  • isEnabled — Tugann sé seo stádas do róbait ar ais nuair a bhíonn sé faoi smacht iomaíochta.

  • isDriverControl — Tugann sé seo ar ais an bhfuil riocht rialaithe an tiománaí ag an róbat.

  • isAutonomous — Tugann sé seo ar ais an bhfuil staid an róbait uathrialach.

  • isCompetitionSwitch — Tugann sé seo ar ais an bhfuil an lasc iomaíochta ceangailte.

  • isFieldControl — Tugann sé seo ar ais an bhfuil an rialú réimse ceangailte.

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

// Create the competition instance
competition Competition = competition();

autonomous#

Cláraíonn sé feidhm le glaoch uirthi nuair a thosaíonn an tréimhse Uathrialach.

Available Functions
void autonomous( void (* callback)(void) );

Parameters

Ainm

Cineál

Cur síos

callback

void (*)(void)

Pointeoir chuig feidhm nach nglacann aon pharaiméadair agus nach dtugann aon luach ar ais. Rithfidh an fheidhm seo nuair a thosaíonn an tréimhse Uathrialach.

Return Values

Ní thugann an fheidhm seo luach ar ais.

Examples
void autonomousControl(void) {
  // Place automonous code here.
  Brain.Screen.clearScreen();
  Brain.Screen.print("autonomous");
}

int main(){
    // Create competition instance.
    competition Competition;

    // Set up callback for the autonomous control period.
    Competition.autonomous(autonomousControl);

    // Prevent main from exiting with an infinite loop.
    while (true) {
        wait(100, msec);
    }
}

drivercontrol#

Cláraíonn sé feidhm le glaoch uirthi nuair a thosaíonn an tréimhse Rialaithe Tiománaí.

Available Functions
void drivercontrol( void (* callback)(void) );

Parameters

Paraiméadar

Cineál

Cur síos

callback

void (*)(void)

Pointeoir chuig feidhm nach nglacann aon pharaiméadair agus nach dtugann aon luach ar ais. Rithfidh an fheidhm seo nuair a thosaíonn an tréimhse Rialaithe Tiománaí.

Return Values

Ní thugann an fheidhm seo luach ar ais.

Examples
void userControl(void) {
  Brain.Screen.clearScreen();
  // place driver control in this while loop
  while (true) {
    wait(20, msec);
  }
}

int main(){
    // Create competition instance.
    competition Competition;

    // Set up callback for the driver control period.
    Competition.drivercontrol(userControl);

    // Prevent main from exiting with an infinite loop.
    while (true) {
        wait(100, msec);
    }
}

isEnabled#

Tugann sé seo stádas do róbait ar ais nuair a bhíonn sé faoi smacht iomaíochta.

Available Functions
bool isEnabled();

Parameters

Ní ghlacann an fheidhm seo le haon pharaiméadair.

Return Values

Tugann sé seo luach Booleach ar ais a léiríonn an bhfuil an tréimhse rialaithe uathrialach nó tiománaí gníomhach:

  • true – Tá an tréimhse uathrialach nó rialaithe tiománaí gníomhach.

  • false – Níl ceachtar tréimhse rialaithe gníomhach.

isDriverControl#

Tugann sé seo luach Boolean ar ais a léiríonn an bhfuil an róbat i mód rialaithe tiománaí.

Available Functions
bool isDriverControl();

Parameters

Ní ghlacann an fheidhm seo le haon pharaiméadair.

Return Values

Tugann sé seo luach Boolean ar ais a léiríonn an bhfuil an róbat i mód rialaithe tiománaí:

  • true – Tá an róbat i mód rialaithe tiománaí.

  • false – Níl an róbat i mód rialaithe tiománaí.

isAutonomous#

Tugann sé seo luach Booleach ar ais a léiríonn an bhfuil an róbat i mód uathrialach.

Available Functions
bool isAutonomous();

Parameters

Ní ghlacann an fheidhm seo le haon pharaiméadair.

Return Values

Tugann sé seo luach Boolean ar ais a léiríonn an bhfuil an róbat i mód uathrialach:

  • true – Tá an róbat i mód uathrialach.

  • false – Níl an róbat i mód uathrialach.

isCompetitionSwitch#

Tugann sé seo luach Booleach ar ais a léiríonn an bhfuil an Lasc Rialaithe Iomaíochta ceangailte:

Available Functions
bool isCompetitionSwitch();

Parameters

Ní ghlacann an fheidhm seo le haon pharaiméadair.

Notes
  • Seiceálann an fheidhm seo an bhfuil an Lasc Rialaithe Iomaíochta ceangailte. Úsáidtear an Lasc Rialaithe Iomaíochta sula gcuirtear Córas Rialaithe Allamuigh V5 i bhfeidhm.

Return Values

Tugann sé seo luach Booleach ar ais a léiríonn an bhfuil an Lasc Rialaithe Iomaíochta ceangailte:

  • true – Tá an Lasc Rialaithe Iomaíochta ceangailte.

  • false – Níl an Lasc Rialaithe Iomaíochta ceangailte.

isFieldControl#

Tugann sé seo luach Booleach ar ais a léiríonn an bhfuil an Rialaitheoir Réimse ceangailte.

Available Functions
bool isFieldControl();

Parameters

Ní ghlacann an fheidhm seo le haon pharaiméadair.

Return Values

Tugann sé seo luach Boolean ar ais a léiríonn an bhfuil an Rialaitheoir Réimse ceangailte:

  • true – Tá an Rialaitheoir Réimse ceangailte.

  • false – Níl an Rialaitheoir Réimse ceangailte.