Braiteoir Fad#

Réamhrá#

Úsáidtear an rang achar distance chun sonraí ó Braiteoir Achair a rialú agus rochtain a fháil orthu.

Is féidir leis an Braiteoir Faid a bhrath an bhfuil réad os comhair an braiteora agus a thabhairt ar ais cé chomh fada is atá an réad sin ar shiúl. Is féidir leis luas coibhneasta an réada braite a thabhairt ar ais freisin agus meastachán a dhéanamh ar cibé an bhfuil an réad beag, meánach nó mór.

Oibríonn an Braiteoir Faid thar raon ó 20 mm go 2000 mm.

Faoi bhun 200mm, is é ±15mm an cruinneas. Os cionn 200mm, feabhsaíonn an cruinneas go dtí thart ar 5%.

Úsáideann an Braiteoir Faid léasar den Aicme 1. Dírítear an bhrath díreach ar aghaidh agus tá sé sábháilte le húsáid sa seomra ranga.

Tógálaithe Ranga#

distance( int32_t  index );

Scriostóir Ranga#

Scriosann sé an réad atá distance agus scaoileann sé acmhainní gaolmhara.

~distance();

Paraiméadair#

Paraiméadar

Cineál

Cur síos

index

int32_t

An Port Cliste a bhfuil an Braiteoir Faid ceangailte leis, scríofa mar PORTx, áit a seasann x don uimhir phoirt (mar shampla, PORT1).

Samplaí#

// Create a Distance Sensor instance in Port 1
distance Distance1 = distance(PORT1);

Feidhmeanna na mBall#

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

  • objectDistance — Tugann sé seo an fad idir an Braiteoir Fad agus an réad braite is gaire ar ais.

  • objectSize — Tugann sé seo méid measta an réada braite ar ais.

  • objectVelocity — Tugann sé seo ar ais cé chomh tapa agus atá an réad braite ag bogadh i dtreo nó ar shiúl ón Braiteoir Fad.

  • isObjectDetected — Tugann sé seo ar ais an bhfuil réad á bhrath ag an Braiteoir Fad faoi láthair.

  • changed — Cláraíonn sé feidhm athghlaoite a ritheann nuair a athraíonn luach an achair a braitheadh.

  • installed — Tugann sé seo ar ais an bhfuil an Braiteoir Fad suiteáilte agus ceangailte.

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

/* This constructor is required when using VS Code.
Distance Sensor configuration is generated automatically
in VEXcode using the Device Menu. Replace the values
as needed. */

// Create a Distance Sensor instance in Port 1
distance Distance1 = distance(PORT1);

objectDistance#

Tugann sé seo an fad idir an Braiteoir Fad agus an réad braite is gaire ar ais.

Available Functions 
double objectDistance( distanceUnits units );
Parameters

Paraiméadar

Cineál

Cur síos

units

distanceUnits

An t-aonad achair:

  • mm - milliméadair (20 mm go 2000 mm)
  • cm - ceintiméadair (2 cm go 200 cm)
  • inches - orlach (0.78 orlach go 78.74 orlach)
Return Values

Tugann sé double ar ais a léiríonn an t-achar idir an Braiteoir Faid agus an réad braite is gaire sna haonaid shonraithe.

objectSize#

Tugann sé seo méid measta an réada a bhraith an Braiteoir Fad ar ais.

Meastar ag an Braiteoir Fad méid an réada bunaithe ar an méid de radharc an braiteora atá tógtha suas ag an réad braite.

Available Functions 
sizeType objectSize();
Parameters

Ní ghlacann an fheidhm seo aon pharaiméadair.

Return Values

Tugann sé seo sizeType ar ais a léiríonn méid measta an réada braite:

  • none — No object is detected.
  • small — A small object is detected.
  • medium — A medium object is detected.
  • large — A large object is detected.

objectVelocity#

Tugann sé seo luas coibhneasta an réada braite ar ais.

Léiríonn luas cé chomh tapa agus atá an réad ag bogadh i dtreo nó ar shiúl ón Braiteoir Fad. Ciallaíonn luach gar do 0 nach bhfuil an réad ag bogadh mórán i gcoibhneas leis an braiteoir.

Available Functions 
double objectVelocity();
Parameters

Ní ghlacann an fheidhm seo aon pharaiméadair.

Return Values

Tugann sé double ar ais a léiríonn luas coibhneasta an réada braite i m/s (méadair in aghaidh an tsoicind).

isObjectDetected#

Tugann sé seo ar ais an bhfuil réad á bhrath ag an Braiteoir Fad faoi láthair.

Available Functions 
bool isObjectDetected();
Parameters

Ní ghlacann an fheidhm seo aon pharaiméadair.

Return Values

Tugann sé seo luach Booleach ar ais a léiríonn an bhfuil réad á bhrath ag an Braiteoir Fad:

  • true — The Distance Sensor detects an object.
  • false — The Distance Sensor does not detect an object.

changed#

Cláraíonn sé feidhm athghlaoite a ritheann nuair a athraíonn luach an achair braite.

Available Functions 
void changed( void (* callback)(void) );
Parameters

Paraiméadar

Cineál

Cur síos

callback

void (*)(void)

Pointeoir chuig feidhm a ghlaofar nuair a athraíonn luach an achair braite. Ní mór don fheidhm aon pharaiméadair a ghlacadh agus void a thabhairt ar ais.
Return Values

Ní thugann an fheidhm seo luach ar ais.

installed#

Tugann sé seo ar ais cibé an bhfuil an Braiteoir Fad suiteáilte agus ceangailte.

Available Functions 
bool installed();
Parameters

Ní ghlacann an fheidhm seo aon pharaiméadair.

Return Values

Tugann sé seo luach Booleach ar ais a léiríonn an bhfuil an Braiteoir Fad suiteáilte agus ceangailte:

  • true — The Distance Sensor is installed and connected.
  • false — The Distance Sensor is not installed or not connected.
On this page