VL53L8CX సెన్సార్ మాడ్యూల్
వినియోగదారు మాన్యువల్

పరిచయం

అల్ట్రా లైట్ డ్రైవర్ (ULD) APIని ఉపయోగించి VL53L8X టైమ్-ఆఫ్-ఫ్లైట్ (ToF) సెన్సార్‌ను ఎలా హ్యాండిల్ చేయాలో వివరించడం ఈ యూజర్ మాన్యువల్ యొక్క ఉద్దేశ్యం. ఇది పరికరాన్ని ప్రోగ్రామ్ చేయడానికి ప్రధాన విధులు, అమరికలు మరియు అవుట్‌పుట్ ఫలితాలను వివరిస్తుంది.
ST యొక్క ఫ్లైట్‌సెన్స్ సాంకేతికత ఆధారంగా, VL53L8CX ఒక సమర్ధవంతమైన మెటాసర్‌ఫేస్ లెన్స్ (DOE)ని లేజర్ ఉద్గారిణిపై ఉంచి, దృశ్యంలోకి 45° x 45° చదరపు FoV ప్రొజెక్షన్‌ని అనుమతిస్తుంది.
దీని మల్టీజోన్ సామర్ధ్యం 8×8 జోన్‌ల (64 జోన్‌లు) మాతృకను అందిస్తుంది మరియు 60 సెం.మీ వరకు వేగవంతమైన వేగంతో (400 Hz) పని చేయగలదు.
ప్రోగ్రామబుల్ డిస్టెన్స్ థ్రెషోల్డ్‌తో అటానమస్ మోడ్‌కు ధన్యవాదాలు, VL53L8CX తక్కువ-పవర్ యూజర్ డిటెక్షన్ అవసరమయ్యే ఏ అప్లికేషన్‌కైనా సరైనది. ST యొక్క పేటెంట్ పొందిన అల్గారిథమ్‌లు మరియు వినూత్న మాడ్యూల్ నిర్మాణం VL53L8CXని ప్రతి జోన్‌లో, లోతు అవగాహనతో FoVలోని బహుళ వస్తువులను గుర్తించడానికి అనుమతిస్తాయి. ST హిస్టోగ్రాం అల్గారిథమ్‌లు 60 సెం.మీ కంటే ఎక్కువ కవర్ గ్లాస్ క్రాస్‌స్టాక్ రోగనిరోధక శక్తిని నిర్ధారిస్తాయి.
ST యొక్క ఫ్లైట్‌సెన్స్ సాంకేతికతపై ఆధారపడిన అన్ని టైమ్-ఆఫ్-ఫ్లైట్ (ToF) సెన్సార్‌ల వలె, VL53L8CX ప్రతి జోన్‌లో, లక్ష్య రంగు మరియు ప్రతిబింబంతో సంబంధం లేకుండా సంపూర్ణ దూరాన్ని రికార్డ్ చేస్తుంది.
SPAD శ్రేణిని అనుసంధానించే సూక్ష్మ రీఫ్లోబుల్ ప్యాకేజీలో ఉంచబడిన VL53L8CX వివిధ పరిసర లైటింగ్ పరిస్థితులలో మరియు విస్తృత శ్రేణి కవర్ గ్లాస్ మెటీరియల్‌ల కోసం అత్యుత్తమ శ్రేణి పనితీరును సాధిస్తుంది.
అన్ని ST యొక్క ToF సెన్సార్‌లు VCSELను ఏకీకృతం చేస్తాయి, ఇది పూర్తిగా కనిపించని 940 nm IR కాంతిని విడుదల చేస్తుంది, ఇది కళ్ళకు పూర్తిగా సురక్షితమైనది (క్లాస్ 1 సర్టిఫికేషన్).

ఎక్రోనింస్ మరియు సంక్షిప్తాలు

ఎక్రోనిం/సంక్షిప్తీకరణ	నిర్వచనం
చేయండి	డిఫ్రాక్టివ్ ఆప్టికల్ మూలకం
FoV	రంగంలో view
I2C	ఇంటర్-ఇంటిగ్రేటెడ్ సర్క్యూట్ (సీరియల్ బస్)
Kcps/SPAD	స్పాడ్‌కి సెకనుకు కిలో-కౌంట్ (యూనిట్ పరిమాణాన్ని లెక్కించడానికి ఉపయోగించబడుతుంది SPAD శ్రేణిలోకి ఫోటాన్ల సంఖ్య)
RAM	యాదృచ్ఛిక యాక్సెస్ మెమరీ
SCL	సీరియల్ క్లాక్ లైన్
SDA	సీరియల్ డేటా
SPAD	ఒకే ఫోటాన్ అవలాంచ్ డయోడ్
ToF	విమాన సమయం
ULD	అల్ట్రా లైట్ డ్రైవర్
VCSEL	నిలువు కుహరం ఉపరితల ఉద్గార డయోడ్
Xtalk	క్రాస్‌స్టాక్

ఫంక్షనల్ వివరణ

2.1 సిస్టమ్ ముగిసిందిview
VL53L8CX సిస్టమ్ హార్డ్‌వేర్ మాడ్యూల్‌తో కూడి ఉంటుంది మరియు హోస్ట్‌పై నడుస్తున్న అల్ట్రా లైట్ డ్రైవర్ సాఫ్ట్‌వేర్ (VL53L8CX ULD) (క్రింద ఉన్న బొమ్మను చూడండి). హార్డ్‌వేర్ మాడ్యూల్ ToF సెన్సార్‌ను కలిగి ఉంది. STMicroelectronics సాఫ్ట్‌వేర్ డ్రైవర్‌ను బట్వాడా చేస్తుంది, ఈ పత్రంలో "డ్రైవర్"గా సూచించబడుతుంది. ఈ పత్రం డ్రైవర్ యొక్క విధులను వివరిస్తుంది, ఇది హోస్ట్‌కు అందుబాటులో ఉంటుంది. ఈ విధులు సెన్సార్‌ను నియంత్రిస్తాయి మరియు శ్రేణి డేటాను పొందుతాయి.

2.2 ప్రభావవంతమైన ధోరణి
మాడ్యూల్ RX ఎపర్చరుపై లెన్స్‌ను కలిగి ఉంటుంది, ఇది లక్ష్యం యొక్క సంగ్రహించబడిన చిత్రాన్ని (అడ్డంగా మరియు నిలువుగా) తిప్పుతుంది. పర్యవసానంగా, SPAD శ్రేణికి దిగువ ఎడమవైపున జోన్ 0గా గుర్తించబడిన జోన్, దృశ్యం యొక్క కుడివైపు ఎగువన ఉన్న లక్ష్యం ద్వారా ప్రకాశిస్తుంది.

2.3 స్కీమాటిక్స్ మరియు I2C/SPI కాన్ఫిగరేషన్
డ్రైవర్ మరియు ఫర్మ్‌వేర్ మధ్య కమ్యూనికేషన్ I2C లేదా SPI ద్వారా నిర్వహించబడుతుంది. I2C యొక్క గరిష్ట సామర్ధ్యం 1 MHz, మరియు SPI యొక్క గరిష్ట సామర్థ్యం 20 MHz. ప్రతి కమ్యూనికేషన్ ప్రోటోకాల్ అమలుకు VL53L8CX డేటాషీట్‌లో వివరించిన విధంగా పుల్ అప్‌లు అవసరం.
VL53L8CX పరికరం 2x0 యొక్క డిఫాల్ట్ I52C చిరునామాను కలిగి ఉంది. అయినప్పటికీ, ఇతర పరికరాలతో వైరుధ్యాలను నివారించడానికి డిఫాల్ట్ చిరునామాను మార్చడం లేదా ఎక్కువ సిస్టమ్ FoV కోసం సిస్టమ్‌కు బహుళ VL53L8CX మాడ్యూల్‌లను జోడించడాన్ని సులభతరం చేయడం సాధ్యపడుతుంది. I2C చిరునామాను vl53l8cx_set_i2c_address() ఫంక్షన్‌ని ఉపయోగించి మార్చవచ్చు. SPIని ఉపయోగించడానికి, మల్టీసెన్సర్ స్వతంత్ర స్లేవ్ కాన్ఫిగరేషన్ (NCS పిన్) ఉపయోగించి వైర్ చేయబడుతుంది.

I2C బస్సులో ఇతరులను ప్రభావితం చేయకుండా దాని I2C చిరునామాను మార్చడానికి పరికరాన్ని అనుమతించడం చాలా ముఖ్యం
మార్చబడని పరికరాల I2C కమ్యూనికేషన్‌ను నిలిపివేయండి. విధానం క్రింది విధంగా ఉంది:

1. సిస్టమ్‌ను మామూలుగా పవర్ అప్ చేయండి.
2. పరికరం యొక్క చిరునామా మార్చబడని LPn పిన్‌ను క్రిందికి లాగండి.
3. I2C చిరునామా మార్చబడిన పరికరం యొక్క LPn పిన్‌ను పైకి లాగండి.
4. ఫంక్షన్ set_i2c_address() ఫంక్షన్‌ని ఉపయోగించి పరికరానికి I2C చిరునామాను ప్రోగ్రామ్ చేయండి.
5. రీప్రోగ్రామ్ చేయని పరికరం యొక్క LPn పిన్‌ను పైకి లాగండి.
   అన్ని పరికరాలు ఇప్పుడు I2C బస్సులో అందుబాటులో ఉండాలి. కొత్త I2C చిరునామా అవసరమయ్యే సిస్టమ్‌లోని అన్ని పరికరాల కోసం పై దశలను పునరావృతం చేయండి.

ప్యాకేజీ కంటెంట్ మరియు డేటా ఫ్లో

3.1 డ్రైవర్ ఆర్కిటెక్చర్ మరియు కంటెంట్
VL53L8CX ULD ప్యాకేజీ నాలుగు ఫోల్డర్‌లతో కూడి ఉంటుంది. డ్రైవర్ /VL53L8CX_ULD_API ఫోల్డర్‌లో ఉంది.
డ్రైవర్ తప్పనిసరి మరియు ఐచ్ఛికంతో కూడి ఉంటుంది fileలు. ఐచ్ఛికం fileలు ఉన్నాయి plugins ULD లక్షణాలను విస్తరించడానికి ఉపయోగిస్తారు.
ప్రతి ప్లగ్ఇన్ “vl53l8cx_plugin” (ఉదా vl53l8cx_plugin_xtalk.h) అనే పదంతో ప్రారంభమవుతుంది. వినియోగదారు ప్రతిపాదించినది కోరుకోకపోతే plugins, ఇతర డ్రైవర్ లక్షణాలను ప్రభావితం చేయకుండా వాటిని తీసివేయవచ్చు. కింది బొమ్మ తప్పనిసరిని సూచిస్తుంది fileలు మరియు ఐచ్ఛికం plugins.

గమనిక:
వినియోగదారు కూడా రెండింటిని అమలు చేయాలి fileలు /ప్లాట్‌ఫారమ్ ఫోల్డర్‌లో ఉన్నాయి. ప్రతిపాదిత ప్లాట్‌ఫారమ్ ఖాళీ షెల్, మరియు తప్పనిసరిగా ప్రత్యేక ఫంక్షన్‌లతో నింపాలి.
Platform.h file ULDని ఉపయోగించడానికి తప్పనిసరి మాక్రోలను కలిగి ఉంటుంది. అన్నీ file ULDని సరిగ్గా ఉపయోగించడానికి కంటెంట్ తప్పనిసరి.

3.2 అమరిక ప్రవాహం
Crosstalk (Xtalk) అనేది SPAD శ్రేణిలో అందుకున్న సిగ్నల్ మొత్తంగా నిర్వచించబడింది, ఇది మాడ్యూల్ పైన జోడించబడిన రక్షిత విండో (కవర్ గ్లాస్) లోపల VCSEL కాంతి ప్రతిబింబం కారణంగా వస్తుంది. VL53L8CX మాడ్యూల్ స్వీయ-కాలిబ్రేట్ చేయబడింది మరియు అదనపు క్రమాంకనం లేకుండా ఉపయోగించవచ్చు.
మాడ్యూల్ కవర్ గ్లాస్ ద్వారా రక్షించబడినట్లయితే Xtalk క్రమాంకనం అవసరం కావచ్చు. VL53L8CX ఒక హిస్టోగ్రాం అల్గారిథమ్‌కు ధన్యవాదాలు, Xtalk నుండి 60 సెం.మీ. అయితే, 60 సెం.మీ కంటే తక్కువ దూరం వద్ద, Xtalk వాస్తవ రిటర్న్ సిగ్నల్ కంటే పెద్దదిగా ఉంటుంది. ఇది తప్పుడు లక్ష్య పఠనాన్ని ఇస్తుంది లేదా లక్ష్యాలు నిజంగా ఉన్నదానికంటే దగ్గరగా కనిపించేలా చేస్తుంది. అన్ని Xtalk అమరిక విధులు Xtalk ప్లగిన్‌లో చేర్చబడ్డాయి (ఐచ్ఛికం). వినియోగదారు ఉపయోగించాలి file 'vl53l8cx_plugin_xtalk'.
Xtalk ఒకసారి క్రమాంకనం చేయబడుతుంది మరియు డేటాను సేవ్ చేయవచ్చు కాబట్టి దానిని తర్వాత మళ్లీ ఉపయోగించుకోవచ్చు. తెలిసిన ప్రతిబింబంతో నిర్ణీత దూరం వద్ద లక్ష్యం అవసరం. అవసరమైన కనీస దూరం 600 మిమీ, మరియు లక్ష్యం మొత్తం FoVని కవర్ చేయాలి. సెటప్‌పై ఆధారపడి, కింది పట్టికలో ప్రతిపాదించిన విధంగా Xtalk అమరికను స్వీకరించడానికి వినియోగదారు సెట్టింగ్‌లను సవరించవచ్చు.

పట్టిక 1. అమరిక కోసం అందుబాటులో ఉన్న సెట్టింగ్‌లు

సెట్టింగ్	కనిష్ట	ద్వారా ప్రతిపాదించబడింది STMమైక్రోఎలక్ట్రానిక్స్	గరిష్టంగా
దూరం [మిమీ]	600	600	3000
ల సంఖ్యampలెస్	1	4	16
ప్రతిబింబం [%]	1	3	99

గమనిక:
ల సంఖ్యను పెంచడంamples ఖచ్చితత్వాన్ని పెంచుతుంది, అయితే ఇది క్రమాంకనం కోసం సమయాన్ని కూడా పెంచుతుంది. s సంఖ్యకు సంబంధించి సమయంamples రేఖీయంగా ఉంటుంది మరియు విలువలు సుమారు సమయం ముగిసింది:

• 1 సెample ≈ 1 సెకను
• 4 సెampతక్కువ ≈ 2.5 సెకన్లు
• 16 సెampతక్కువ ≈ 8.5 సెకన్లు
  అమరిక vl53l8cx_calibrate_xtalk() ఫంక్షన్‌ని ఉపయోగించి నిర్వహించబడుతుంది. ఈ ఫంక్షన్ ఎప్పుడైనా ఉపయోగించవచ్చు.
  అయితే, సెన్సార్ మొదట ప్రారంభించబడాలి. కింది బొమ్మ xtalk అమరిక ప్రవాహాన్ని సూచిస్తుంది.

మూర్తి 7. Xtalk అమరిక ప్రవాహం

3.3 శ్రేణి ప్రవాహం
కింది బొమ్మ కొలతలను పొందడానికి ఉపయోగించే శ్రేణి ప్రవాహాన్ని సూచిస్తుంది. శ్రేణి సెషన్‌ను ప్రారంభించడానికి ముందు Xtalk క్రమాంకనం మరియు ఐచ్ఛిక ఫంక్షన్ కాల్‌లను తప్పనిసరిగా ఉపయోగించాలి. గెట్/సెట్ ఫంక్షన్‌లు రేంజింగ్ సెషన్‌లో ఉపయోగించబడవు మరియు 'ఆన్-ది-ఫ్లై' ప్రోగ్రామింగ్‌కు మద్దతు లేదు.

అందుబాటులో ఉన్న లక్షణాలు

VL53L8CX ULD API అనేక ఫంక్షన్‌లను కలిగి ఉంటుంది, ఇది వినియోగదారుని వినియోగ సందర్భాన్ని బట్టి సెన్సార్‌ను ట్యూన్ చేయడానికి అనుమతిస్తుంది. డ్రైవర్ కోసం అందుబాటులో ఉన్న అన్ని విధులు క్రింది విభాగాలలో వివరించబడ్డాయి.
4.1 ప్రారంభించడం
VL53L8CX సెన్సార్‌ని ఉపయోగించే ముందు తప్పనిసరిగా ప్రారంభించాలి. ఈ ఆపరేషన్‌కు వినియోగదారు వీటిని చేయాలి:

1. సెన్సార్‌పై పవర్ ఆన్ చేయండి (VDDIO, AVDD, CORE_1V8 మరియు LPn పిన్‌లు హైకి సెట్ చేయబడ్డాయి
2. ఫంక్షన్ vl53l8cx_init()కి కాల్ చేయండి. ఫంక్షన్ ఫర్మ్‌వేర్ (~84 Kbytes)ని మాడ్యూల్‌కి కాపీ చేస్తుంది. ఇది I2C/SPI ఇంటర్‌ఫేస్‌పై కోడ్‌ను లోడ్ చేయడం ద్వారా మరియు ప్రారంభాన్ని పూర్తి చేయడానికి బూట్ రొటీన్ చేయడం ద్వారా జరుగుతుంది.

4.2 సెన్సార్ రీసెట్ నిర్వహణ
పరికరాన్ని రీసెట్ చేయడానికి, కింది పిన్‌లను టోగుల్ చేయాలి:

1. పిన్స్ VDDIO, AVDD మరియు CORE_1V8 పిన్‌లను తక్కువకు సెట్ చేయండి.
2. 10 ms వేచి ఉండండి.
3. పిన్స్ VDDIO, AVDD మరియు CORE_1V8 పిన్‌లను ఎత్తుకు సెట్ చేయండి.

గమనిక:
I2C_RST పిన్‌ను మాత్రమే టోగుల్ చేయడం I2C కమ్యూనికేషన్‌ను రీసెట్ చేస్తుంది.
4.3 రిజల్యూషన్
రిజల్యూషన్ అందుబాటులో ఉన్న జోన్‌ల సంఖ్యకు అనుగుణంగా ఉంటుంది. VL53L8CX సెన్సార్‌లో రెండు సాధ్యమైన రిజల్యూషన్‌లు ఉన్నాయి: 4×4 (16 జోన్‌లు) మరియు 8×8 (64 జోన్‌లు). డిఫాల్ట్‌గా సెన్సార్ 4×4లో ప్రోగ్రామ్ చేయబడింది.
vl53l8cx_set_resolution() ఫంక్షన్ రిజల్యూషన్‌ని మార్చడానికి వినియోగదారుని అనుమతిస్తుంది. రేంజింగ్ ఫ్రీక్వెన్సీ రిజల్యూషన్‌పై ఆధారపడి ఉంటుంది కాబట్టి, శ్రేణి ఫ్రీక్వెన్సీని అప్‌డేట్ చేయడానికి ముందు ఈ ఫంక్షన్ తప్పనిసరిగా ఉపయోగించాలి. అంతేకాకుండా, రిజల్యూషన్‌ని మార్చడం వలన ఫలితాలు చదివినప్పుడు I2C/SPI బస్సులో ట్రాఫిక్ పరిమాణాన్ని కూడా పెంచుతుంది.
4.4 రేంజ్ ఫ్రీక్వెన్సీ
కొలత ఫ్రీక్వెన్సీని మార్చడానికి రేంజింగ్ ఫ్రీక్వెన్సీని ఉపయోగించవచ్చు. గరిష్ట పౌనఃపున్యం 4×4 మరియు 8×8 రిజల్యూషన్‌ల మధ్య భిన్నంగా ఉన్నందున, రిజల్యూషన్‌ని ఎంచుకున్న తర్వాత ఈ ఫంక్షన్‌ని ఉపయోగించాల్సి ఉంటుంది. అనుమతించబడిన కనీస మరియు గరిష్ట విలువలు క్రింది పట్టికలో ఇవ్వబడ్డాయి.

పట్టిక 2. కనిష్ట మరియు గరిష్ట శ్రేణి పౌనఃపున్యాలు

రిజల్యూషన్	కనిష్ట శ్రేణి ఫ్రీక్వెన్సీ [Hz]	గరిష్ట శ్రేణి ఫ్రీక్వెన్సీ [Hz]
4×4	1	60
8×8	1	15

ఫంక్షన్ vl53l8cx_set_ranging_frequency_hz()ని ఉపయోగించి రేంజింగ్ ఫ్రీక్వెన్సీని అప్‌డేట్ చేయవచ్చు. డిఫాల్ట్‌గా, శ్రేణి ఫ్రీక్వెన్సీ 1 Hzకి సెట్ చేయబడింది.

4.5 రేంజింగ్ మోడ్
ర్యాంజింగ్ మోడ్ వినియోగదారుని అధిక పనితీరు లేదా తక్కువ విద్యుత్ వినియోగం మధ్య ఎంచుకోవడానికి అనుమతిస్తుంది.
ప్రతిపాదించబడిన రెండు మోడ్‌లు ఉన్నాయి:

• నిరంతర: పరికరం వినియోగదారు నిర్వచించిన శ్రేణి ఫ్రీక్వెన్సీతో ఫ్రేమ్‌లను నిరంతరం పట్టుకుంటుంది. VCSEL అన్ని శ్రేణుల సమయంలో ప్రారంభించబడింది, కాబట్టి గరిష్ట పరిధి దూరం మరియు పరిసర రోగనిరోధక శక్తి మెరుగ్గా ఉంటాయి. వేగవంతమైన కొలతలు లేదా అధిక పనితీరు కోసం ఈ మోడ్ సూచించబడింది.
• స్వయంప్రతిపత్తి: ఇది డిఫాల్ట్ మోడ్. పరికరం వినియోగదారు నిర్వచించిన శ్రేణి ఫ్రీక్వెన్సీతో ఫ్రేమ్‌లను నిరంతరం పట్టుకుంటుంది. vl53l8cx_set_integration_time_ms() ఫంక్షన్‌ని ఉపయోగించి వినియోగదారు నిర్వచించిన వ్యవధిలో VCSEL ప్రారంభించబడింది. VCSEL ఎల్లప్పుడూ ప్రారంభించబడనందున, విద్యుత్ వినియోగం తగ్గుతుంది. తగ్గిన శ్రేణి ఫ్రీక్వెన్సీతో ప్రయోజనాలు మరింత స్పష్టంగా కనిపిస్తాయి. ఈ మోడ్ తక్కువ పవర్ అప్లికేషన్ల కోసం సూచించబడింది.
  vl53l8cx_set_ranging_mode() ఫంక్షన్‌ని ఉపయోగించి శ్రేణి మోడ్‌ని మార్చవచ్చు.

4.6 ఇంటిగ్రేషన్ సమయం
ఇంటిగ్రేషన్ సమయం అనేది స్వయంప్రతిపత్త శ్రేణి మోడ్‌ను ఉపయోగించి మాత్రమే అందుబాటులో ఉండే లక్షణం (విభాగం 4.5 ర్యాంజింగ్ మోడ్‌ని చూడండి).
ఇది VCSEL ప్రారంభించబడినప్పుడు సమయాన్ని మార్చడానికి వినియోగదారుని అనుమతిస్తుంది. రేంజింగ్ మోడ్ నిరంతరాయంగా సెట్ చేయబడితే ఏకీకరణ సమయాన్ని మార్చడం వల్ల ఎటువంటి ప్రభావం ఉండదు. డిఫాల్ట్ ఇంటిగ్రేషన్ సమయం 5 msకి సెట్ చేయబడింది.
ఏకీకరణ సమయం యొక్క ప్రభావం 4×4 మరియు 8×8 రిజల్యూషన్‌లకు భిన్నంగా ఉంటుంది. రిజల్యూషన్ 4×4 ఒక ఇంటిగ్రేషన్ సమయంతో కూడి ఉంటుంది మరియు 8×8 రిజల్యూషన్ నాలుగు ఏకీకరణ సమయాలతో కూడి ఉంటుంది. కింది గణాంకాలు రెండు రిజల్యూషన్‌ల కోసం VCSEL ఉద్గారాలను సూచిస్తాయి.

అన్ని ఏకీకరణ సమయాల మొత్తం + 1 ms ఓవర్‌హెడ్ తప్పనిసరిగా కొలత వ్యవధి కంటే తక్కువగా ఉండాలి. లేదంటే రేంజింగ్ పీరియడ్ ఆటోమేటిక్‌గా పెరుగుతుంది.

4.7 పవర్ మోడ్‌లు
పరికరం ఉపయోగించనప్పుడు విద్యుత్ వినియోగాన్ని తగ్గించడానికి పవర్ మోడ్‌లను ఉపయోగించవచ్చు. VL53L8CX కింది పవర్ మోడ్‌లలో ఒకదానిలో పనిచేయగలదు:

• వేక్-అప్: పరికరం HP నిష్క్రియ (హై పవర్)లో సెట్ చేయబడింది, సూచనల కోసం వేచి ఉంది.
• స్లీప్: పరికరం LP నిష్క్రియ (తక్కువ పవర్), తక్కువ పవర్ స్టేట్‌లో సెట్ చేయబడింది. వేక్-అప్ మోడ్‌లో సెట్ చేసే వరకు పరికరాన్ని ఉపయోగించలేరు. ఈ మోడ్ ఫర్మ్‌వేర్ మరియు కాన్ఫిగరేషన్‌ను కలిగి ఉంటుంది.
  ఫంక్షన్ vl53l8cx_set_power_mode()ని ఉపయోగించి పవర్ మోడ్‌ని మార్చవచ్చు. డిఫాల్ట్ మోడ్ మేల్కొలుపు.
  గమనిక:
  వినియోగదారు పవర్ మోడ్‌ను మార్చాలనుకుంటే, పరికరం తప్పనిసరిగా శ్రేణి స్థితిలో ఉండకూడదు.

4.8 షార్పెనర్
లక్ష్యం నుండి తిరిగి వచ్చే సంకేతం పదునైన అంచులతో శుభ్రమైన పల్స్ కాదు. అంచులు దూరంగా ఉంటాయి మరియు ప్రక్కనే ఉన్న జోన్‌లలో నివేదించబడిన దూరాలను ప్రభావితం చేయవచ్చు. వెయిలింగ్ గ్లేర్ వల్ల కలిగే సిగ్నల్‌లో కొంత లేదా అన్నింటినీ తొలగించడానికి షార్పనర్ ఉపయోగించబడుతుంది.
మాజీampక్రింది చిత్రంలో చూపిన le అనేది FoVలో కేంద్రీకృతమై ఉన్న 100 mm వద్ద ఒక దగ్గరి లక్ష్యాన్ని సూచిస్తుంది మరియు మరొక లక్ష్యం, 500 mm వద్ద మరింత వెనుకబడి ఉంటుంది. షార్ప్‌నర్ విలువపై ఆధారపడి, క్లోజ్ టార్గెట్ నిజమైన దాని కంటే ఎక్కువ జోన్‌లలో కనిపించవచ్చు.

చిత్రం 11. Exampఅనేక పదునుపెట్టే విలువలను ఉపయోగించి సన్నివేశం యొక్క le

vl53l8cx_set_sharpener_percent() ఫంక్షన్‌ని ఉపయోగించి షార్పెనర్‌ని మార్చవచ్చు. అనుమతించబడిన విలువలు 0 % మరియు 99 % మధ్య ఉన్నాయి. డిఫాల్ట్ విలువ 5%.

4.9 టార్గెట్ ఆర్డర్
VL53L8CX ఒక్కో జోన్‌కి అనేక లక్ష్యాలను కొలవగలదు. హిస్టోగ్రాం ప్రాసెసింగ్‌కు ధన్యవాదాలు, హోస్ట్ నివేదించబడిన లక్ష్యాల క్రమాన్ని ఎంచుకోగలుగుతుంది. రెండు ఎంపికలు ఉన్నాయి:

• దగ్గరి: ముందుగా నివేదించబడిన లక్ష్యం దగ్గరి లక్ష్యం
• బలమైనది: బలమైన లక్ష్యం మొదట నివేదించబడింది
  ఫంక్షన్ vl53l8cx_set_target_order()ని ఉపయోగించి లక్ష్య క్రమాన్ని మార్చవచ్చు. డిఫాల్ట్ ఆర్డర్ బలమైనది.
  మాజీampకింది చిత్రంలో le రెండు లక్ష్యాలను గుర్తించడాన్ని సూచిస్తుంది. తక్కువ పరావర్తనంతో 100 మిమీ వద్ద ఒకటి మరియు అధిక పరావర్తనంతో 700 మిమీ వద్ద ఒకటి.

4.10 ఒక్కో జోన్‌కి బహుళ లక్ష్యాలు
VL53L8CX ఒక్కో జోన్‌కు నాలుగు లక్ష్యాలను కొలవగలదు. సెన్సార్ ద్వారా అందించబడిన లక్ష్యాల సంఖ్యను వినియోగదారు కాన్ఫిగర్ చేయవచ్చు.
గమనిక:
గుర్తించవలసిన రెండు లక్ష్యాల మధ్య కనీస దూరం 600 మిమీ.
డ్రైవర్ నుండి ఎంపిక సాధ్యం కాదు; అది 'platform.h'లో చేయాలి file. స్థూల
VL53L8CX_NB_ TARGET_PER_ZONEని 1 మరియు 4 మధ్య విలువకు సెట్ చేయాలి. సెక్షన్ 4.9 టార్గెట్ ఆర్డర్‌లో వివరించిన లక్ష్య క్రమం గుర్తించబడిన లక్ష్యం క్రమాన్ని నేరుగా ప్రభావితం చేస్తుంది. డిఫాల్ట్‌గా, సెన్సార్ ఒక్కో జోన్‌కు గరిష్టంగా ఒక లక్ష్యాన్ని మాత్రమే అందిస్తుంది.
గమనిక:
ప్రతి జోన్‌కు పెరిగిన లక్ష్యాల సంఖ్య అవసరమైన RAM పరిమాణాన్ని పెంచుతుంది.
4.11 Xtalk మార్జిన్
Xtalk మార్జిన్ అనేది ప్లగ్ఇన్ Xtalkని ఉపయోగించి మాత్రమే అందుబాటులో ఉండే అదనపు ఫీచర్. ది .సి మరియు .ఎఫ్ files 'vl53l8cx_plugin_xtalk'ని ఉపయోగించాలి.
సెన్సార్ పైభాగంలో కవర్ గ్లాస్ ఉన్నప్పుడు గుర్తించే థ్రెషోల్డ్‌ని మార్చడానికి మార్జిన్ ఉపయోగించబడుతుంది. Xtalk కాలిబ్రేషన్ డేటాను సెట్ చేసిన తర్వాత, కవర్ గ్లాస్ ఎప్పటికీ గుర్తించబడదని నిర్ధారించుకోవడానికి థ్రెషోల్డ్‌ని పెంచవచ్చు.
ఉదాహరణకుampఅలాగే, వినియోగదారు ఒకే పరికరంలో Xtalk అమరికను అమలు చేయగలరు మరియు అన్ని ఇతర పరికరాల కోసం అదే అమరిక డేటాను మళ్లీ ఉపయోగించవచ్చు. Xtalk దిద్దుబాటును ట్యూన్ చేయడానికి Xtalk మార్జిన్ ఉపయోగించవచ్చు. దిగువన ఉన్న బొమ్మ Xtalk మార్జిన్‌ను సూచిస్తుంది.

మూర్తి 13. Xtalk మార్జిన్

4.12 డిటెక్షన్ థ్రెషోల్డ్‌లు
సాధారణ శ్రేణి సామర్థ్యాలతో పాటు, సెన్సార్‌ను నిర్దిష్ట ముందే నిర్వచించిన ప్రమాణాల ప్రకారం వస్తువును గుర్తించడానికి ప్రోగ్రామ్ చేయవచ్చు. ఈ ఫీచర్ ప్లగ్ఇన్ "డిటెక్షన్ థ్రెషోల్డ్స్"ని ఉపయోగించి అందుబాటులో ఉంది, ఇది APIలో డిఫాల్ట్‌గా చేర్చబడని ఎంపిక. ది file'vl53l8cx_plugin_detection_thresholds' అని పిలవబడే లు ఉపయోగించాలి.
వినియోగదారు నిర్వచించిన షరతులు నెరవేరినప్పుడు A1 (INT)ని పిన్ చేయడానికి అంతరాయాన్ని ట్రిగ్గర్ చేయడానికి ఈ ఫీచర్ ఉపయోగించబడుతుంది. మూడు సాధ్యమైన కాన్ఫిగరేషన్‌లు ఉన్నాయి:

• రిజల్యూషన్ 4×4: ఒక్కో జోన్‌కు 1 థ్రెషోల్డ్‌ని ఉపయోగించడం (మొత్తం 16 థ్రెషోల్డ్‌లు)
• రిజల్యూషన్ 4×4: ఒక్కో జోన్‌కు 2 థ్రెషోల్డ్‌లను ఉపయోగించడం (మొత్తం 32 థ్రెషోల్డ్‌లు)
• రిజల్యూషన్ 8×8: ఒక్కో జోన్‌కు 1 థ్రెషోల్డ్‌ని ఉపయోగించడం (మొత్తం 64 థ్రెషోల్డ్‌లు)
  ఉపయోగించిన కాన్ఫిగరేషన్ ఏమైనప్పటికీ, థ్రెషోల్డ్‌లను సృష్టించే విధానం మరియు RAM పరిమాణం ఒకే విధంగా ఉంటాయి. ప్రతి థ్రెషోల్డ్ కలయిక కోసం, అనేక ఫీల్డ్‌లను పూరించాలి:
• జోన్ ఐడి: ఎంచుకున్న జోన్ ఐడి (సెక్షన్ 2.2 ఎఫెక్టివ్ ఓరియంటేషన్‌ని చూడండి)
• కొలత: పట్టుకోవడానికి కొలత (దూరం, సిగ్నల్, SPADల సంఖ్య, …)
• రకం: కొలతల విండోలు (కిటికీలలో, కిటికీల వెలుపల, తక్కువ థ్రెషోల్డ్ క్రింద, ...)
• తక్కువ థ్రెషోల్డ్: ట్రిగ్గర్ కోసం తక్కువ థ్రెషోల్డ్ యూజర్. వినియోగదారు ఆకృతిని సెట్ చేయవలసిన అవసరం లేదు, ఇది API ద్వారా స్వయంచాలకంగా నిర్వహించబడుతుంది.
• అధిక థ్రెషోల్డ్: ట్రిగ్గర్ కోసం అధిక థ్రెషోల్డ్ యూజర్. వినియోగదారు ఆకృతిని సెట్ చేయవలసిన అవసరం లేదు, ఇది API ద్వారా స్వయంచాలకంగా నిర్వహించబడుతుంది.
• గణిత ఆపరేషన్: ఒక్కో జోన్‌కు 4×4 - 2 థ్రెషోల్డ్ కాంబినేషన్‌లకు మాత్రమే ఉపయోగించబడుతుంది. వినియోగదారు ఒక జోన్‌లో అనేక థ్రెషోల్డ్‌లను ఉపయోగించి కలయికను సెట్ చేయవచ్చు.

4.13 ఆటోస్టాప్ అంతరాయం
కొలత సమయంలో శ్రేణి సెషన్‌ను నిలిపివేయడానికి అంతరాయ ఆటోస్టాప్ ఫీచర్ ఉపయోగించబడుతుంది. డిఫాల్ట్‌గా, కొలత సమయంలో సెన్సార్ నిలిపివేయబడదు, ఎందుకంటే ఫ్రేమ్ కొలతలు పూర్తి కావాలి. అయినప్పటికీ, ఆటోస్టాప్‌ని ఉపయోగించడం ద్వారా, అంతరాయాన్ని ప్రేరేపించినప్పుడు ఫ్రేమ్ కొలతలు నిలిపివేయబడతాయి.
ఆటోస్టాప్ ఫీచర్ డిటెక్షన్ థ్రెషోల్డ్‌తో కలిపి ఉన్నప్పుడు ఉపయోగకరంగా ఉంటుంది. లక్ష్యాన్ని గుర్తించినప్పుడు, ప్రస్తుత కొలత స్వయంచాలకంగా నిలిపివేయబడుతుంది. ఆటోస్టాప్ మరొక సెన్సార్ కాన్ఫిగరేషన్‌కు త్వరగా మారడానికి కస్టమర్ స్టేట్ మెషీన్‌లో ఉపయోగించవచ్చు.
vl53l8cx_set_detection_threshold_auto_stop() ఫంక్షన్‌ని ఉపయోగించడం ద్వారా అంతరాయ ఆటోస్టాప్ ఫీచర్‌ని ప్రారంభించవచ్చు.
కొలత నిలిపివేయబడిన తర్వాత, vl53l8cx_stop_ranging() ఫంక్షన్‌ని ఉపయోగించడం ద్వారా సెన్సార్‌ను ఆపివేయమని సిఫార్సు చేయబడింది.
4.14 చలన సూచిక
VL53L8CX సెన్సార్ ఒక సన్నివేశంలో చలన గుర్తింపును అనుమతించే ఎంబెడెడ్ ఫర్మ్‌వేర్ ఫీచర్‌ను కలిగి ఉంది. చలన సూచిక సీక్వెన్షియల్ ఫ్రేమ్‌ల మధ్య గణించబడుతుంది. 'vl53l8cx_plugin_motion_indicator' ప్లగిన్‌ని ఉపయోగించి ఈ ఎంపిక అందుబాటులో ఉంది.
చలన సూచిక vl53l8cx_motion_indicator_init() ఫంక్షన్‌ని ఉపయోగించి ప్రారంభించబడింది. వినియోగదారు సెన్సార్ రిజల్యూషన్‌ని మార్చాలనుకుంటే, అతను తప్పనిసరిగా డెడికేటెడ్ ఫంక్షన్‌ని ఉపయోగించి మోషన్ ఇండికేటర్ రిజల్యూషన్‌ని అప్‌డేట్ చేయాలి: vl53l8cx_motion_indicator_set_resolution().
వినియోగదారు చలనాన్ని గుర్తించడం కోసం కనిష్ట మరియు గరిష్ట దూరాలను కూడా మార్చవచ్చు. కనిష్ట మరియు గరిష్ట దూరాల మధ్య వ్యత్యాసం 1500 మిమీ కంటే ఎక్కువ ఉండకూడదు. డిఫాల్ట్‌గా, దూరాలు 400 mm మరియు 1500 mm మధ్య విలువలతో ప్రారంభించబడతాయి.
ఫలితాలు 'motion_indicator' ఫీల్డ్‌లో నిల్వ చేయబడతాయి. ఈ ఫీల్డ్‌లో, శ్రేణి 'మోషన్' ప్రతి జోన్‌కు చలన తీవ్రతను కలిగి ఉన్న విలువను ఇస్తుంది. అధిక విలువ ఫ్రేమ్‌ల మధ్య అధిక చలన వైవిధ్యాన్ని సూచిస్తుంది. ఒక సాధారణ కదలిక 100 మరియు 500 మధ్య విలువను ఇస్తుంది. ఈ సున్నితత్వం ఏకీకరణ సమయం, లక్ష్య దూరం మరియు లక్ష్య ప్రతిబింబంపై ఆధారపడి ఉంటుంది.
స్వయంప్రతిపత్త శ్రేణి మోడ్‌తో మోషన్ ఇండికేటర్‌ని ఉపయోగించడం మరియు మోషన్‌పై ప్రోగ్రామ్ చేయబడిన డిటెక్షన్ థ్రెషోల్డ్‌లు తక్కువ పవర్ అప్లికేషన్‌లకు ఆదర్శవంతమైన కలయిక. ఇది కనీస విద్యుత్ వినియోగంతో FoVలో కదలిక వైవిధ్యాలను గుర్తించడానికి అనుమతిస్తుంది.

4.15 బాహ్య సమకాలీకరణ పిన్
సముపార్జనలను సమకాలీకరించడానికి బాహ్య ట్రిగ్గర్ మూలాన్ని ఉపయోగించవచ్చు. బాహ్య సమకాలీకరణ ప్రారంభించబడినప్పుడు, తదుపరి సముపార్జనను ప్రారంభించడానికి VL53L8CX SYNC పిన్‌పై అంతరాయం కోసం వేచి ఉంటుంది. ఈ లక్షణాన్ని ఉపయోగించడానికి, ఉత్పత్తి డేటాషీట్‌లో వివరించిన విధంగా SYNC పిన్ (B1) కనెక్ట్ చేయబడాలి.
బాహ్య సమకాలీకరణను ఉపయోగించడానికి నిర్దిష్ట అవసరాలు లేవు. అయితే, VL53L8CX శ్రేణి ఫ్రీక్వెన్సీ బాహ్య సిగ్నల్ ఫ్రీక్వెన్సీ కంటే ఎక్కువగా ఉండాలి.
vl53l8cx_set_external_sync_pin_enable() ఫంక్షన్‌ని ఉపయోగించడం ద్వారా బాహ్య సమకాలీకరణను ప్రారంభించవచ్చు లేదా నిలిపివేయవచ్చు. vl53l8cx_start_ranging() ఫంక్షన్‌ని ఉపయోగించడం ద్వారా ర్యాంజింగ్‌ని యధావిధిగా ప్రారంభించవచ్చు. వినియోగదారు సెన్సార్‌ను ఆపాలనుకున్నప్పుడు, VL53L8CX ఫర్మ్‌వేర్‌ను అన్‌పాజ్ చేయడానికి SYNC పిన్‌ను టోగుల్ చేయాలని సిఫార్సు చేయబడింది.
బాహ్య సమకాలీకరణ పిన్‌ను ఉపయోగించడం కోసం సమయోచిత ప్రవాహం విభాగం 4.15లో క్రింద చూపబడింది.

మూర్తి 14. బాహ్య సమకాలీకరణ ప్రవాహం

రేంజింగ్ ఫలితాలు

5.1 అందుబాటులో ఉన్న డేటా
శ్రేణి కార్యకలాపాల సమయంలో లక్ష్యం మరియు పర్యావరణ డేటా యొక్క విస్తృతమైన జాబితా అవుట్‌పుట్ కావచ్చు. కింది పట్టిక వినియోగదారుకు అందుబాటులో ఉన్న పారామితులను వివరిస్తుంది.
పట్టిక 3. VL53L8CX సెన్సార్‌ని ఉపయోగించి అందుబాటులో ఉన్న అవుట్‌పుట్

మూలకం	Nb బైట్‌లు (RAM)	యూనిట్	వివరణ
SPADకి యాంబియంట్	256	Kcps/SPAD	శబ్దం కారణంగా యాంబియంట్ సిగ్నల్ రేట్‌ను కొలవడానికి, యాక్టివ్ ఫోటాన్ ఉద్గారాలు లేకుండా, SPAD శ్రేణిపై యాంబియంట్ రేట్ కొలత ప్రదర్శించబడుతుంది.
గుర్తించబడిన లక్ష్యాల సంఖ్య	64	ఏదీ లేదు	ప్రస్తుత జోన్‌లో గుర్తించబడిన లక్ష్యాల సంఖ్య. కొలత చెల్లుబాటును తెలుసుకోవడం కోసం తనిఖీ చేసే మొదటి విలువ ఈ విలువ అయి ఉండాలి.
ప్రారంభించబడిన SPADల సంఖ్య	256	ఏదీ లేదు	ప్రస్తుత కొలత కోసం ప్రారంభించబడిన SPADల సంఖ్య. చాలా లేదా తక్కువ ప్రతిబింబ లక్ష్యం మరిన్ని SPADలను సక్రియం చేస్తుంది.
SPADకి సిగ్నల్	256 x nb లక్ష్యాలు ప్రోగ్రామ్ చేయబడ్డాయి	Kcps/SPAD	VCSEL సమయంలో కొలవబడిన ఫోటాన్‌ల పరిమాణం పల్స్.
రేంజ్ సిగ్మా	128 x nb లక్ష్యాలు ప్రోగ్రామ్ చేయబడ్డాయి	మిల్లిమీటర్	నివేదించబడిన లక్ష్య దూరంలో శబ్దం కోసం సిగ్మా అంచనా.
దూరం	128 x nb లక్ష్యాలు ప్రోగ్రామ్ చేయబడ్డాయి	మిల్లిమీటర్	లక్ష్య దూరం
లక్ష్య స్థితి	64 x nb లక్ష్యాలు ప్రోగ్రామ్ చేయబడ్డాయి	ఏదీ లేదు	కొలతల చెల్లుబాటు. మరింత సమాచారం కోసం విభాగం 5.5 ఫలితాల వివరణను చూడండి.
ప్రతిబింబం	64 x సంఖ్య లక్ష్యాలు ప్రోగ్రామ్ చేయబడ్డాయి	శాతం	శాతంలో అంచనా వేసిన లక్ష్య ప్రతిబింబం
చలన సూచిక	140	ఏదీ లేదు	చలన సూచిక ఫలితాలను కలిగి ఉన్న నిర్మాణం. ఫీల్డ్ 'మోషన్' చలన తీవ్రతను కలిగి ఉంటుంది.

గమనిక:
వినియోగదారు ఒక్కో జోన్‌కు 1 కంటే ఎక్కువ లక్ష్యాన్ని ప్రోగ్రామ్ చేసి ఉంటే అనేక మూలకాల కోసం (సిగ్నల్ పర్ స్పాడ్, సిగ్మా, …) డేటా యాక్సెస్ భిన్నంగా ఉంటుంది (విభాగం 4.10 ప్రతి జోన్‌కు బహుళ లక్ష్యాలను చూడండి). మాజీ చూడండిampమరింత సమాచారం కోసం le కోడ్‌లను చూడండి.

5.2 అవుట్‌పుట్ ఎంపికను అనుకూలీకరించండి
డిఫాల్ట్‌గా, అన్ని VL53L8CX అవుట్‌పుట్‌లు ప్రారంభించబడ్డాయి. అవసరమైతే, వినియోగదారు కొంత సెన్సార్ అవుట్‌పుట్‌ను నిలిపివేయవచ్చు.
డ్రైవర్‌లో కొలతలను నిలిపివేయడం అందుబాటులో లేదు; ఇది తప్పనిసరిగా 'platform.h'లో ప్రదర్శించబడాలి file. అవుట్‌పుట్‌లను నిలిపివేయడానికి వినియోగదారు కింది మాక్రోలను ప్రకటించవచ్చు:
#VL53L8CX _DISABLE_AMBIENT_PER_SPADని నిర్వచించండి
#VL53L8CX _DISABLE_NB_SPADS_ENABLEDని నిర్వచించండి
#VL53L8CXని నిర్వచించండి _DISABLE_NB_TARGET_DETECTED
#VL53L8CX _DISABLE_SIGNAL_PER_SPADని నిర్వచించండి
#VL53L8CX _DISABLE_RANGE_SIGMA_MMని నిర్వచించండి
#VL53L8CX _DISABLE_DISTANCE_MMని నిర్వచించండి
#VL53L8CX _DISABLE_TARGET_STATUSని నిర్వచించండి
#VL53L8CXని నిర్వచించండి _DISABLE_REFLECTANCE_PERCENT
#VL53L8CX _DISABLE_MOTION_INDICATORని నిర్వచించండి
పర్యవసానంగా, ఫలితాల నిర్మాణంలో ఫీల్డ్‌లు ప్రకటించబడవు మరియు డేటా హోస్ట్‌కు బదిలీ చేయబడదు.
RAM పరిమాణం మరియు I2C/SPI పరిమాణం తగ్గించబడ్డాయి.
డేటా అనుగుణ్యతను నిర్ధారించడానికి, ST ఎల్లప్పుడూ 'గుర్తించబడిన లక్ష్య సంఖ్య' మరియు 'లక్ష్య స్థితి' ప్రారంభించబడాలని సిఫార్సు చేస్తుంది. ఇది లక్ష్య స్థితిని బట్టి కొలతలను ఫిల్టర్ చేయడానికి అనుమతిస్తుంది (విభాగం 5.5 ఫలితాల వివరణను చూడండి).

5.3 శ్రేణి ఫలితాలను పొందడం
రేంజింగ్ సెషన్‌లో, కొత్త శ్రేణి డేటా అందుబాటులో ఉందో లేదో తెలుసుకోవడానికి రెండు మార్గాలు ఉన్నాయి:

• పోలింగ్ మోడ్: vl53l8cx_check_data_ready() ఫంక్షన్‌ని నిరంతరం ఉపయోగిస్తుంది. ఇది సెన్సార్ ద్వారా అందించబడిన కొత్త స్ట్రీమ్ కౌంట్‌ను గుర్తిస్తుంది.
• అంతరాయ మోడ్: పిన్ A1 (INT)లో పెరిగిన అంతరాయానికి వేచి ఉంది. ~100 μs తర్వాత అంతరాయం స్వయంచాలకంగా క్లియర్ చేయబడుతుంది.
  కొత్త డేటా సిద్ధంగా ఉన్నప్పుడు, vl53l8cx_get_ranging_data() ఫంక్షన్‌ని ఉపయోగించి ఫలితాలను చదవవచ్చు. ఇది ఎంచుకున్న మొత్తం అవుట్‌పుట్‌ను కలిగి ఉన్న నవీకరించబడిన నిర్మాణాన్ని అందిస్తుంది. పరికరం అసమకాలికంగా ఉన్నందున, రేంజింగ్ సెషన్‌ను కొనసాగించడానికి క్లియర్ చేయడానికి అంతరాయం లేదు.
  ఈ ఫీచర్ నిరంతర మరియు స్వయంప్రతిపత్త శ్రేణి మోడ్‌లకు అందుబాటులో ఉంది.

5.4 ముడి ఫర్మ్‌వేర్ ఆకృతిని ఉపయోగించడం
I2C/SPI ద్వారా శ్రేణి డేటాను బదిలీ చేసిన తర్వాత, ఫర్మ్‌వేర్ ఫార్మాట్ మరియు హోస్ట్ ఫార్మాట్ మధ్య మార్పిడి జరుగుతుంది. సెన్సార్ యొక్క డిఫాల్ట్ అవుట్‌పుట్‌గా మిల్లీమీటర్‌లలో దూరాన్ని కలిగి ఉండేలా ఈ ఆపరేషన్ సాధారణంగా నిర్వహించబడుతుంది. వినియోగదారు ఫర్మ్‌వేర్ ఆకృతిని ఉపయోగించాలనుకుంటే, ప్లాట్‌ఫారమ్‌లో క్రింది మాక్రో తప్పనిసరిగా నిర్వచించబడాలి file:
VL53L8CX#VL53L8CX_USE_RAW_FORMATని నిర్వచించండి
5.5 ఫలితాల వివరణ
లక్ష్య స్థితిని పరిగణనలోకి తీసుకోవడానికి VL53L8CX ద్వారా అందించబడిన డేటాను ఫిల్టర్ చేయవచ్చు. స్థితి కొలత చెల్లుబాటును సూచిస్తుంది. పూర్తి స్థితి జాబితా క్రింది పట్టికలో వివరించబడింది.

పట్టిక 4. అందుబాటులో ఉన్న లక్ష్య స్థితి జాబితా

లక్ష్య స్థితి	వివరణ
0	రేంజింగ్ డేటా నవీకరించబడలేదు
1	SPAD శ్రేణిలో సిగ్నల్ రేట్ చాలా తక్కువగా ఉంది
2	లక్ష్య దశ
3	సిగ్మా అంచనాదారు చాలా ఎక్కువ
4	లక్ష్య స్థిరత్వం విఫలమైంది
5	పరిధి చెల్లుతుంది
6	పూర్తి చేయబడలేదు (సాధారణంగా మొదటి పరిధి)
7	రేటు స్థిరత్వం విఫలమైంది
8	ప్రస్తుత లక్ష్యానికి సిగ్నల్ రేటు చాలా తక్కువగా ఉంది
9	పెద్ద పల్స్‌తో చెల్లుబాటు అయ్యే పరిధి (విలీన లక్ష్యం వల్ల కావచ్చు)
10	పరిధి చెల్లుబాటు అవుతుంది, కానీ మునుపటి పరిధిలో లక్ష్యం కనుగొనబడలేదు
11	కొలత స్థిరత్వం విఫలమైంది
12	షార్పనర్ కారణంగా లక్ష్యం మరొకటి ద్వారా అస్పష్టంగా ఉంది
13	లక్ష్యం గుర్తించబడింది కానీ అస్థిరమైన డేటా. ద్వితీయ లక్ష్యాల కోసం తరచుగా జరుగుతుంది.
255	లక్ష్యం కనుగొనబడలేదు (గుర్తించబడిన లక్ష్యం యొక్క సంఖ్య ప్రారంభించబడితే మాత్రమే)

స్థిరమైన డేటాను కలిగి ఉండటానికి, వినియోగదారు చెల్లని లక్ష్య స్థితిని ఫిల్టర్ చేయాలి. విశ్వాస రేటింగ్ ఇవ్వడానికి, స్థితి 5తో లక్ష్యం 100 % చెల్లుబాటు అయ్యేదిగా పరిగణించబడుతుంది. 6 లేదా 9 స్థితిని 50 % విశ్వాస విలువతో పరిగణించవచ్చు. అన్ని ఇతర స్థితిగతులు 50% విశ్వాస స్థాయి కంటే తక్కువగా ఉన్నాయి.

5.6 డ్రైవర్ లోపాలు
VL53L8CX సెన్సార్ ఉపయోగించి లోపం సంభవించినప్పుడు, డ్రైవర్ నిర్దిష్ట లోపాన్ని అందిస్తుంది. కింది పట్టిక సాధ్యమయ్యే లోపాలను జాబితా చేస్తుంది.

టేబుల్ 5. డ్రైవర్ ఉపయోగించి అందుబాటులో ఉన్న లోపాల జాబితా

లక్ష్య స్థితి	వివరణ
0	లోపం లేదు
127	వినియోగదారు తప్పు సెట్టింగ్‌ని ప్రోగ్రామ్ చేసారు (తెలియని రిజల్యూషన్, ఫ్రీక్వెన్సీ చాలా ఎక్కువ, …)
255	ప్రధాన లోపం. సాధారణంగా I2C/SPI లోపం కారణంగా గడువు ముగిసింది.
ఇతర	పైన వివరించిన బహుళ లోపాల కలయిక

గమనిక:
ప్లాట్‌ఫారమ్‌ని ఉపయోగించి హోస్ట్ ద్వారా మరిన్ని ఎర్రర్ కోడ్‌లను అమలు చేయవచ్చు files.

పట్టిక 6. డాక్యుమెంట్ పునర్విమర్శ చరిత్ర

తేదీ	వెర్షన్	మార్పులు
13-జనవరి-23	1	ప్రారంభ విడుదల

ముఖ్యమైన నోటీసు - జాగ్రత్తగా చదవండి
STMicroelectronics NV మరియు దాని అనుబంధ సంస్థలు ("ST") నోటీసు లేకుండా ఎప్పుడైనా ST ఉత్పత్తులు మరియు/లేదా ఈ పత్రంలో మార్పులు, దిద్దుబాట్లు, మెరుగుదలలు, సవరణలు మరియు మెరుగుదలలు చేసే హక్కును కలిగి ఉన్నాయి. కొనుగోలుదారులు ఆర్డర్లు చేయడానికి ముందు ST ఉత్పత్తులపై తాజా సంబంధిత సమాచారాన్ని పొందాలి. ST ఉత్పత్తులు ఆర్డర్ రసీదు సమయంలో స్థానంలో ST యొక్క నిబంధనలు మరియు విక్రయ నిబంధనలకు అనుగుణంగా విక్రయించబడతాయి.
ST ఉత్పత్తుల ఎంపిక, ఎంపిక మరియు వినియోగానికి కొనుగోలుదారులు మాత్రమే బాధ్యత వహిస్తారు మరియు అప్లికేషన్ సహాయం లేదా కొనుగోలుదారుల ఉత్పత్తుల రూపకల్పనకు ST ఎటువంటి బాధ్యత వహించదు.
ఇక్కడ ST ద్వారా ఏ మేధో సంపత్తి హక్కుకు ఎలాంటి లైసెన్స్, ఎక్స్‌ప్రెస్ లేదా సూచించబడదు.
ఇక్కడ పేర్కొన్న సమాచారానికి భిన్నమైన నిబంధనలతో ST ఉత్పత్తుల పునఃవిక్రయం అటువంటి ఉత్పత్తికి ST ద్వారా మంజూరు చేయబడిన ఏదైనా వారంటీని రద్దు చేస్తుంది.
ST మరియు ST లోగో ST యొక్క ట్రేడ్‌మార్క్‌లు. ST ట్రేడ్‌మార్క్‌ల గురించి అదనపు సమాచారం కోసం, చూడండి www.st.com/trademarks. అన్ని ఇతర ఉత్పత్తి లేదా సేవా పేర్లు వాటి సంబంధిత యజమానుల ఆస్తి.
ఈ పత్రంలోని సమాచారం ఈ పత్రం యొక్క ఏదైనా మునుపటి సంస్కరణల్లో గతంలో అందించిన సమాచారాన్ని భర్తీ చేస్తుంది మరియు భర్తీ చేస్తుంది.

© 2023 STMmicroelectronics – అన్ని హక్కులు ప్రత్యేకించబడ్డాయి

పత్రాలు / వనరులు

ST VL53L8CX సెన్సార్ మాడ్యూల్ [pdf] యూజర్ మాన్యువల్ UM3109, VL53L8CX సెన్సార్ మాడ్యూల్, VL53L8CX, సెన్సార్ మాడ్యూల్, మాడ్యూల్

సూచనలు

• వినియోగదారు మాన్యువల్