ST VL53L3CX फ्लाइट रेंजिंग सेन्सर वापरकर्ता मॅन्युअलची वेळ
ST VL53L3CX फ्लाइट रेंजिंग सेन्सरची वेळ

परिचय

VL53L3CX हे टाइम-ऑफ-फ्लाइट (ToF) श्रेणीचे सेन्सर मॉड्यूल आहे.
VL53L3CX बेअर ड्रायव्हर वापरून रेंजिंग डेटा मिळविण्यासाठी कॉल करण्यासाठी इंटिग्रेशन मॉडेल आणि फंक्शन्सच्या संचाचे वर्णन करणे हा या वापरकर्ता मॅन्युअलचा उद्देश आहे.

VL53L3CX प्रणाली संपलीview

VL53L3CX सिस्टम VL53L3CX मॉड्यूल आणि होस्टवर चालणारा ड्रायव्हर बनलेला आहे.
हा दस्तऐवज होस्टसाठी प्रवेशयोग्य ड्रायव्हर फंक्शन्सचे वर्णन करतो, डिव्हाइस नियंत्रित करण्यासाठी आणि नॉन-लिनक्स होस्टसह एकत्रीकरणासाठी श्रेणी डेटा मिळवण्यासाठी.
प्रणाली संपलीview
आकृती 1. VL53L3CX प्रणाली

टीप:
सध्याचा दस्तऐवज अंमलात आणलेल्या आणि प्रमाणित फंक्शन्सचे वर्णन करतो. या दस्तऐवजात वर्णन केलेले नसल्यास ड्रायव्हर्समध्ये उपलब्ध असलेले इतर कोणतेही कार्य वापरले जाऊ नये.
बेअर ड्रायव्हर हे VL53L3CX उपकरण वापरण्यासाठी आवश्यक असलेल्या फंक्शन्सच्या संचाची अंमलबजावणी आहे. हे OS एकत्रीकरण आणि सेवांवर किमान गृहीतके करते. जसे की, क्रियांचा क्रम, अंमलबजावणी/थ्रेडिंग मॉडेल, प्लॅटफॉर्म अनुकूलन, आणि डिव्हाइस संरचना वाटप हे बेअर ड्रायव्हर अंमलबजावणीचा भाग नसून इंटिग्रेटरसाठी खुले ठेवले आहे.
बेअर ड्रायव्हर कॉल्सच्या अनुक्रमाने या दस्तऐवजात परिभाषित केलेल्या नियमांचे पालन करणे आवश्यक आहे.

श्रेणीबद्ध कार्यात्मक वर्णन

हा विभाग VL53L3CX श्रेणीतील उपकरणाच्या कार्यात्मक क्षमतांचे थोडक्यात वर्णन करतो.

श्रेणीबद्ध क्रम

मानक व्यत्यय व्यवस्थापन योजनेवर आधारित, उपकरण हँडशेक यंत्रणेसह चालत आहे.
प्रत्येक श्रेणीनंतर, होस्ट श्रेणी डेटा प्राप्त करतो आणि व्यत्यय साफ करून पुढील श्रेणी सक्षम करतो. या प्रक्रियेला हँडशेक यंत्रणा असे म्हणतात. जर वर्तमान पूर्ण झाले असेल आणि होस्टने मागील प्रलंबित व्यत्यय साफ केला असेल तर पुढील श्रेणी नंतर ट्रिगर केली जाईल.
इंटरप्ट मेकॅनिझम संप्रेषण किंवा असिंक्रोनिझम समस्यांमुळे कोणतेही श्रेणी मूल्य न गमावता, जलद डेटा हस्तांतरणास अनुमती देते. हँडशेक टप्प्यात, होस्ट काही डेटा प्रक्रिया करतो. खालील आकृतीमध्ये श्रेणी क्रम कार्यात्मकपणे वर्णन केले आहे.
श्रेणी क्रम

हँडशेक अनुक्रम अंतर्गत पॅरामीटर्सची गणना करण्यास आणि त्यांना पुढील श्रेणीसाठी लागू करण्यास अनुमती देतो.
बेअर ड्रायव्हरच्या वापरकर्त्याने हँडशेक करणे आवश्यक आहे. नवीन मापन प्राप्त झाल्यानंतर नवीन श्रेणी सक्षम करण्यासाठी होणारा विलंब संपूर्ण प्रणाली मापन दरासाठी महत्त्वाचा आहे.

वेळेचा विचार

वेळा सादर केल्या आहेत आकृती 3 मध्ये. श्रेणीबद्ध क्रम आणि वेळेचे लक्ष्य.
यजमान वर्तमान श्रेणीच्या कालावधी दरम्यान (टाईमिंग बजेट श्रेणी) नवीनतम उपलब्ध श्रेणी मिळवू शकतो.
यजमानाद्वारे व्यत्यय साफ करण्यास विलंब झाल्यास, प्रलंबित व्यत्यय साफ होईपर्यंत पुढील श्रेणी थांबविली जाईल.

टीप: वेळा दर्शविल्या आकृती 3 मध्ये. श्रेणी क्रम आणि वेळेचे लक्ष्य हे ठराविक वेळा आहेत. विभाग 5.1 टाईमिंग बजेटमध्ये वर्णन केलेले समर्पित ड्रायव्हर फंक्शन वापरून होस्ट डीफॉल्ट वेळेचे बजेट बदलू शकतो. होस्ट एकतर अनुप्रयोगावर समक्रमित करण्यासाठी किंवा श्रेणी अचूकता वाढवण्यासाठी वेळेचे बजेट बदलण्याचा निर्णय घेऊ शकतो.
खालील आकृतीमध्ये, “बूट”, “एसडब्ल्यू स्टँडबाय” आणि “इनिट” 40 ms टिकते. डिव्हाइसचे योग्य प्रारंभ करण्यासाठी हा वेळ आवश्यक आहे आणि तो प्लॅटफॉर्म किंवा वापरलेल्या वेळेच्या बजेटपासून स्वतंत्र आहे. पहिली श्रेणी, “श्रेणी1”, वैध नाही, कारण रॅप-अराउंड चेक शक्य नाही. याचा अर्थ असा की पहिले वैध श्रेणी मूल्य "श्रेणी2" आहे, 40 ms नंतर आणि वेळेच्या बजेट कालावधीच्या दुप्पट नंतर उपलब्ध आहे.
वेळेचा विचार
आकृती 3. श्रेणीबद्ध क्रम आणि वेळेचे लक्ष्य

बेअर ड्रायव्हर मूलभूत कार्यांचे वर्णन

हा विभाग ड्रायव्हर फंक्शन्स कॉल फ्लोचे वर्णन करतो जे श्रेणी मोजमाप करण्यासाठी अनुसरण केले पाहिजे
VL53L3CX वापरून.
VL53L3CX ड्रायव्हर दोन प्रकारच्या ऍप्लिकेशन्समध्ये वापरला जातो:

  • डिव्हाइस कॅलिब्रेशनसाठी वापरलेले फॅक्टरी अॅप्लिकेशन्स, विशेषत: अंतिम उत्पादन उत्पादन चाचणी (फॅक्टरी प्रवाह)
  • फील्ड अॅप्लिकेशन्स, जे VL53L3CX डिव्हाइस (श्रेणीचा प्रवाह) वापरून सर्व अंतिम-वापरकर्ता अनुप्रयोग एकत्र करतात

बेअर ड्रायव्हर

बेअर ड्रायव्हरचा कारखाना प्रवाह खालील आकृतीमध्ये दर्शविला आहे.
बेअर ड्रायव्हर
आकृती 4. VL53L3CX API श्रेणीचा प्रवाह (फॅक्टरी)

टीप: कॅलिब्रेशन प्रवाह अंतर मोड बदलतो. जर तुम्हाला कॅलिब्रेशन नंतर सेन्सर वापरायचा असेल तर SetDistanceMode() फंक्शनला कॉल करणे अनिवार्य आहे.
बेअर ड्रायव्हर श्रेणीचा प्रवाह खालील आकृतीमध्ये दर्शविला आहे.
API श्रेणी प्रवाह

आकृती 5. VL53L3CX API श्रेणी प्रवाह (फील्ड)

सिस्टम आरंभीकरण

खालील विभाग मापन सुरू करण्यापूर्वी, सिस्टम इनिशिएलायझेशन करण्यासाठी आवश्यक API फंक्शन्स कॉल दर्शवितो.

बूट होण्याची प्रतीक्षा करा

VL53LX_WaitDeviceBooted() फंक्शन डिव्हाइस बूट आणि तयार असल्याची खात्री करते. या फंक्शनला कॉल करणे अनिवार्य नाही.

टीप: हे फंक्शन होस्ट एक्झिक्यूशन ब्लॉक करते. हे कार्य 4 ms पेक्षा जास्त ब्लॉक करू नये, असे गृहीत धरून:

  • 400 kHz I2C वारंवारता
  • प्रति व्यवहार 2 एमएस विलंब

डेटा इनिट

VL53LX_DataInit() फंक्शनला प्रत्येक वेळी डिव्हाइस "प्रारंभिक बूट" स्थितीतून बाहेर पडल्यावर कॉल करणे आवश्यक आहे. हे उपकरण आरंभ करते. VL53LX_DataInit() फंक्शन कॉल केल्यानंतर कॅलिब्रेशन डेटा फंक्शन VL53LX_SetCalibrationData() वापरून लोड करावा लागतो.

VL53L3CX सह श्रेणी

लिनक्स नसलेल्या होस्टवर, बेअर ड्रायव्हर सीक्वेन्सचा वापरकर्ता ड्रायव्हरला अॅप्लिकेशनच्या गरजा, प्लॅटफॉर्म क्षमता आणि बेअर ड्रायव्हर कॉल सीक्वेन्स नियमांना योग्य अशा प्रकारे कॉल करतो.

मोजमाप सुरू करा

मापन सुरू करण्यासाठी VL53LX_StartMeasurement() फंक्शन कॉल करणे आवश्यक आहे.

निकालाची प्रतीक्षा करा: मतदान किंवा व्यत्यय

मोजमाप उपलब्ध आहे हे जाणून घेण्याचे 3 मार्ग आहेत. होस्ट करू शकतो:

  1. मतदान कार्य कॉल करा
  2. ड्रायव्हर फंक्शनवर मतदान
  3. शारीरिक व्यत्ययाची प्रतीक्षा करा

परिणाम स्थिती प्राप्त करण्यासाठी ड्रायव्हर मतदान
VL53LX_WaitMeasurementDataReady() हे कार्य मापन तयार होईपर्यंत अंतर्गत स्थितीवर मतदान करत आहे.

टीप: अंतर्गत मतदान केले जात असल्याने हे कार्य अवरोधित करत आहे.

निकालाची स्थिती मिळविण्यासाठी मतदान आयोजित करा
नवीन मापन केव्हा तयार आहे हे जाणून घेण्यासाठी होस्ट VL53LX_GetMeasurementDataReady() फंक्शनवर मतदान करू शकतो. हे कार्य अवरोधित करत नाही.

भौतिक व्यत्यय वापरणे

श्रेणीचा दर्जा मिळविण्याचा पर्यायी आणि प्राधान्याचा मार्ग म्हणजे भौतिक व्यत्यय आउटपुट वापरणे. डीफॉल्टनुसार, नवीन मापन तयार झाल्यावर GPIO1 कमी होतो.
हा पिन फक्त आउटपुट पिन आहे, या डिव्हाइसवर कोणतेही इनपुट इंटरप्ट पिन नाही. ड्रायव्हर फंक्शन VL53LX_ClearInterruptAndStartMeasurement() ला कॉल करून व्यत्यय साफ करणे आवश्यक आहे.

मोजमाप मिळवा

अनेक ऑब्जेक्ट्स प्रति श्रेणी शोधल्या जाऊ शकतात आणि मापन डेटा प्रति ऑब्जेक्ट VL53LX_GetMultiRangingData() वापरला जातो जेव्हा एकाधिक ऑब्जेक्ट्स फील्डमध्ये असतात तेव्हा श्रेणी डेटा मिळविण्यासाठी वापरला जाऊ शकतो view. डिव्हाइसला एकाधिक श्रेणीचे परिणाम मिळविण्यासाठी या फंक्शनला कॉल करताना, VL53LX_MultiRangingData_t नावाची रचना दिली जाते.

मोजमाप थांबवा

सतत मोडमध्ये, होस्ट VL53LX_StopMeasurement() फंक्शनला कॉल करून मापन थांबवू शकतो. श्रेणी मापन दरम्यान थांबण्याची विनंती आढळल्यास, मापन त्वरित रद्द केले जाते.

रेंजिंग डेटा स्ट्रक्चर्स

VL53LX_MultiRangingData_t नावाच्या संरचनेत आढळलेल्या सर्व लक्ष्यांना लागू होणारा खालील डेटा आहे:

  • वेळ सेंटamp: अंमलात नाही आणले.
  • प्रवाह संख्या: हा 8-बिट पूर्णांक प्रत्येक श्रेणीत एक काउंटर वाढवतो. मूल्य 0 पासून सुरू होते, 1 बाय 1 वाढवून 255 पर्यंत. जेव्हा ते 255 पर्यंत पोहोचते, ते पुन्हा 128 ते 255 पर्यंत सुरू होते.
  • सापडलेल्या वस्तूंची संख्या: 8-बिट पूर्णांक मूल्य जे सापडलेल्या वस्तूंची संख्या देते.
  • श्रेणी डेटा [VL53LX_MAX_RANGE_RESULTS]: VL53LX_TargetRangeData_t प्रकाराच्या संरचनेची सारणी. लक्ष्यांची कमाल संख्या VL53LX_MAX_RANGE_RESULTS द्वारे दिलेली आहे, आणि मुलभूतरित्या 4 च्या समान आहे.
  • X चर्चा मूल्य बदलले आहे: 8-बिट पूर्णांक मूल्य जे क्रॉसस्टॉक मूल्य बदलले आहे का ते दर्शवते.
  • प्रभावी स्पॅड आरटीएन संख्या: 16-बिट पूर्णांक जो वर्तमान श्रेणीसाठी प्रभावी सिंगल फोटॉन अवलाँच डायोड (SPAD) गणना देतो. वास्तविक मूल्य प्राप्त करण्यासाठी ते 256 ने भागले पाहिजे.

VL4LX_TargetRangeData_t नावाची प्रत्येक लक्ष्य शोधलेली एक रचना (डिफॉल्टनुसार 53 पर्यंत) ज्यामध्ये आढळलेल्या प्रत्येक लक्ष्यासाठी खालील विशिष्ट परिणाम असतात.

  • रेंजमॅक्समिलीमीटर: एक 16-बिट पूर्णांक आहे, जे मोठे आढळलेले अंतर दर्शवते.
  • रेंजमिनमिलीमीटर: एक 16-बिट पूर्णांक आहे, लहान शोधलेले अंतर दर्शविते.
  • SignalRateRtnMegaCps: हे मूल्य MegaCountPer Second (MCPS) मधील रिटर्न सिग्नल दर आहे, हे 16.16 फिक्स पॉइंट मूल्य आहे. वास्तविक मूल्य प्राप्त करण्यासाठी ते 65536 ने भागले पाहिजे.
  • AmbientRateRtnMegaCps: हे मूल्य रिटर्न अॅम्बियंट रेट आहे (MCPS मध्ये), हे 16.16 फिक्स पॉइंट व्हॅल्यू आहे, जे सेन्सरद्वारे मोजलेल्या सभोवतालच्या प्रकाशाच्या प्रमाणाचे प्रभावीपणे मोजमाप आहे. वास्तविक मूल्य प्राप्त करण्यासाठी ते 65536 ने भागले पाहिजे.
  • सिग्मामिलीमीटर: हे 16.16 फिक्स पॉइंट व्हॅल्यू मिलिमीटरमध्ये व्यक्त केलेल्या वर्तमान श्रेणीच्या मानक विचलनाचा अंदाज आहे. वास्तविक मूल्य प्राप्त करण्यासाठी ते 65536 ने भागले पाहिजे.
  • रेंजमिलीमीटर: मिलिमीटरमध्ये श्रेणी अंतर दर्शविणारा 16-बिट पूर्णांक आहे.
  • श्रेणी स्थिती: हा एक 8-बिट पूर्णांक आहे जो वर्तमान मापनासाठी श्रेणी स्थिती दर्शवतो. मूल्य = 0 म्हणजे श्रेणी वैध आहे. तक्ता 1 पहा. श्रेणी स्थिती.
  • विस्तारित श्रेणी: हे 8-बिट पूर्णांक आहे जे दर्शविते की श्रेणी अनरॅप केली गेली आहे का (फक्त लांब अंतरासाठी)

जेव्हा लक्ष्य सापडत नाही तेव्हा विशिष्ट वर्तन लागू केले जाते. लक्ष्य आढळले नाही, आणि मापन वैध असल्यास, खालील मूल्ये VL53LX_TargetRangeData_t संरचनेत नोंदवली जातात:

  • RangeMaxMilliMeter: 8191 ला सक्ती केली.
  • RangeMinMilliMeter: 8191 ला सक्ती केली.
  • SignalRateRtnMegaCps: सक्तीने 0.
  • AmbientRateRtnMegaCps: सभोवतालचे दर मूल्य साधारणपणे मोजले जाते.
  • SigmaMilliMeter: सक्तीने 0.
  • रेंजमिलीमीटर: 8191 ला सक्ती केली.
  • श्रेणी स्थिती: 255 ला सक्ती केली.
  • विस्तारित श्रेणी: सक्तीने 0.

तक्ता 1. श्रेणी स्थिती

मूल्य श्रेणीस्थिती स्ट्रिंग टिप्पणी द्या
0 VL53LX_RANGESTATUS_RANGE_VALID श्रेणी मोजमाप वैध आहे
 1  VL53LX_RANGESTATUS_SIGMA_FAIL सिग्मा एस्टिमेटर चेक अंतर्गत परिभाषित थ्रेशोल्डच्या वर असल्यास वाढविले जाते. सिग्मा अंदाजकर्ता सिग्नलबद्दल गुणात्मक माहिती देतो.
2 VL53LX_RANGESTATUS_SIGNAL_FAIL लक्ष्य शोधण्यासाठी सिग्नल खूप कमी असताना वाढवले ​​जाते.
4 VL53LX_RANGESTATUS_OUTOFBOUNDS_FAIL जेव्हा श्रेणी परिणाम मर्यादेबाहेर असतो तेव्हा वाढवले ​​जाते
5 VL53LX_RANGESTATUS_HARDWARE_FAIL HW किंवा VCSEL अयशस्वी झाल्यास वाढविले जाते
6 VL53LX_RANGESTATUS_RANGE_VALID_NO_WR AP_CHECK_FAIL कोणतीही रॅपराउंड तपासणी केली गेली नाही (ही पहिली श्रेणी आहे)
7 VL53LX_RANGESTATUS_WRAP_TARGET_FAIL रॅपराऊंड झाला
8 VL53LX_RANGESTATUS_PROCESSING_FAIL अंतर्गत प्रक्रिया त्रुटी
10 VL53LX_RANGESTATUS_SYNCRONISATION_INT init नंतर एकदा वाढवलेले, श्रेणी मूल्याकडे दुर्लक्ष करावे लागेल
11 VL53LX_RANGESTATUS_RANGE_VALID_MERGE D_PULSE रेंजिंग ठीक आहे, परंतु नोंदवलेले अंतर हे एकाधिक लक्ष्य विलीन झाल्याचा परिणाम आहे.
12 VL53LX_RANGESTATUS_TARGET_PRESENT_LA CK_OF_SIGNAL एक लक्ष्य असल्याचे सूचित करा, परंतु श्रेणीचा अहवाल देण्यासाठी सिग्नल खूप कमी आहे
14 VL53LX_RANGESTATUS_RANGE_INVALID रेंजिंग डेटा नकारात्मक आहे आणि त्याकडे दुर्लक्ष केले पाहिजे
255 VL53LX_RANGESTATUS_NONE चेतावणी न देता किंवा त्रुटी काढल्याशिवाय लक्ष्य आढळले नाही

पहिल्याच मोजमापात रॅपराउंड चेकचा समावेश नाही. हे श्रेणी मोजमाप टाकून दिले जाऊ शकते.
टीप: श्रेणी स्थिती 1 अनेकदा गोंगाटाच्या मोजमापांमुळे होते. उपचारित सिग्नलच्या SNR द्वारे सिग्मा अंदाजक प्रभावित होतो.
टीप: मापन संदर्भातील काही त्रुटी आढळल्यास श्रेणी स्थिती 4 वाढवली जाते. यामुळे नकारात्मक मोजमाप किंवा अत्यंत उच्च श्रेणी मूल्ये म्हणून आउटलियर होऊ शकतात.

अतिरिक्त ड्रायव्हर कार्यांचे वर्णन

वेळेचे बजेट

टाइमिंग बजेट म्हणजे वापरकर्त्याने एक श्रेणी मोजमाप करण्यासाठी वाटप केलेला वेळ. VL53LX_SetMeasurementTimingBudgetMicroSeconds() हे वेळेचे बजेट सेट करण्यासाठी वापरले जाणारे कार्य आहे. डीफॉल्ट टाइमिंग बजेट मूल्य 33 ms आहे. किमान 8 ms, कमाल 500 ms आहे.
उदाample, वेळेचे बजेट 66 ms वर सेट करण्यासाठी: status = VL53LX_SetMeasurementTimingBudgetMicroSeconds(&VL53L3Dev, 66000);
फंक्शन VL53LX_GetMeasurementTimingBudgetMicroSeconds() प्रोग्राम केलेले वेळेचे बजेट परत करते.

अंतर मोड

वापरकर्त्याने विनंती केलेल्या रेंजिंग अंतरावर अवलंबून अंतर्गत सेटिंग्ज ऑप्टिमाइझ करण्यासाठी फंक्शन जोडले गेले आहे. अंतर मोड बदलण्याचे फायदे खालील तक्त्यामध्ये तपशीलवार दिले आहेत.

तक्ता 2. अंतर मोड

संभाव्य अंतर मोड लाभ / टिप्पण्या
लहान उत्तम सभोवतालची प्रतिकारशक्ती
मध्यम (डीफॉल्ट) जास्तीत जास्त अंतर
लांब कमी वीज वापर

वापरण्यासाठी कार्याला VL53LX_SetDistanceMode() म्हणतात.
ड्रायव्हर होस्टला इष्टतम अंतर मोड निवडण्यात मदत करू शकतो. सभोवतालच्या परिस्थितीनुसार सर्वोत्तम निवड दर्शवण्यासाठी प्रत्येक श्रेणीवर एक विशिष्ट मूल्य दिले जाते.
संभाव्य मूल्ये आहेत:

  • VL53LX_DISTANCE_SHORT
  • VL53LX_DISTANCE_MEDIUM
  • VL53LX_DISTANCE_LONG

ट्यूनिंग पॅरामीटर्स

ट्यूनिंग पॅरामीटर्स सेन्सर आणि होस्ट वापर केस दरम्यान सर्वोत्तम फिट शोधण्याची परवानगी देतात. प्रत्येक वापर केससाठी, ट्यूनिंग पॅरामीटर्सचा संच ड्रायव्हरमध्ये परिभाषित आणि लोड केला जाऊ शकतो.
बहुतेक ट्यूनिंग पॅरामीटर्स ट्यून करण्यायोग्य थ्रेशोल्ड आहेत, जे सिग्नल उपचार अल्गोरिदममध्ये वापरले जातात. या पॅरामीटर्समध्ये बदल केल्याने अल्गोरिदमला विशिष्ट ग्राहक वापर प्रकरणात तांत्रिक व्यापार बंद करण्याची अनुमती मिळते.

ट्यूनिंग पॅरामीटर सेट करा

ट्यूनिंग पॅरामीटर्स लोड करण्यासाठी अतिरिक्त कार्य अस्तित्वात आहे. विशिष्ट वापराच्या प्रकरणांसाठी, ST काही विशिष्ट मापदंडांची शिफारस करू शकते ज्यामध्ये की आणि मूल्य असते.
ट्यूनिंग पॅरामीटर्सची सूची आणि त्यांची डीफॉल्ट मूल्ये vl53lx_tuning_parm_defaults.h मध्ये दिली आहेत. file. एकतर यामध्ये ट्यूनिंग पॅरामीटर मूल्य बदला file आणि कोड पुन्हा कंपाइल करा, किंवा हे ट्युनिंग पॅरामीटर लोड करण्यासाठी VL53LX_SetTuningParameter() फंक्शन वापरा.
ट्यूनिंग पॅरामीटर बदलल्याने डिव्हाइस कार्यप्रदर्शन सुधारू शकते. ST चांगल्या परिणामांसाठी डीफॉल्ट मूल्ये वापरण्याची शिफारस करते.

अचूकता सुधारित करा

डिव्हाइस अचूकता सुधारण्यासाठी, VL53LX_TUNINGPARM_PHASECAL_PATCH_POWER नावाचे ट्यूनिंग पॅरामीटर वापरा. डीफॉल्टनुसार हे ट्यूनिंग पॅरामीटर लागू केले जात नाही (मूल्य 0 वर सेट केले आहे).
ST static_init नंतर कॅलिब्रेशन आणि रेंजिंग फ्लोची मूल्ये 2 वर सेट करण्याची शिफारस करते. या प्रकरणात, संदर्भ सिग्नल मोजमाप करण्याची वेळ वाढविली जाते आणि अधिक अचूकतेस अनुमती देते. हे पॅरामीटर 2 वर सेट केल्याने प्रथम मापन मिळविण्याचा कालावधी 240 ms ने वाढतो.

विलंबता आणि कमाल श्रेणीतील अंतर सुधारा

जेव्हा लक्ष्य हलत असते, तेव्हा दृश्यावर अवलंबून, VL53L3CX ला प्रतिक्रिया देण्यासाठी अनेक श्रेणींची आवश्यकता असू शकते. विलंबता सुधारण्याचा एक मार्ग म्हणजे VL53LX_TUNINGPARM_RESET_MERGE_THRESHOLD पॅरामीटर ट्यून करणे. डीफॉल्ट मूल्य 15000 आहे. विलंबता सुधारण्यासाठी ते कमी केले जाऊ शकते, परंतु कमाल श्रेणी अंतर प्रभावित होईल.
वापरकर्त्याने मूल्य वाढविल्यास, कमाल श्रेणीचे अंतर सुधारले जाऊ शकते, परंतु विलंबतेवर परिणाम होतो.

कव्हर काचेच्या धुराचा शोध

कव्हर ग्लासवरील धुरामुळे क्रॉसस्टॉकवर परिणाम होऊ शकतो. VL53L3CX एक फंक्शन एम्बेड करते जे फ्लायवर स्मूज शोधण्यात सक्षम आहे आणि नवीन क्रॉसस्टॉक सुधारणा मूल्य लागू करते. वापरकर्ता VL53LX_SmudgeCorrectionEnable() वर कॉल करून हे कार्य सक्षम/अक्षम करू शकतो.

या फंक्शनसह खालील तीन पर्याय सेट केले जाऊ शकतात:

  • सुधारणा अक्षम करण्यासाठी VL53LX_SMUDGE_CORRECTION_NONE
  • सतत सुधारणा सक्षम करण्यासाठी VL53LX_SMUDGE_CORRECTION_CONTINUOUS
  • प्रारंभ आदेश प्राप्त झाल्यानंतर एकच सुधारणा सक्षम करण्यासाठी VL53LX_SMUDGE_CORRECTION_SINGLE.

प्रत्येक श्रेणीवर स्मज डिटेक्शन चालू आहे. काही अटींची पूर्तता झाल्यास (80 से.मी.च्या खाली कोणतीही वस्तू, थ्रेशोल्डच्या खाली सभोवतालची प्रकाश पातळी आणि 1kcps वरील क्रॉसस्टॉक मूल्य) नवीन क्रॉसस्टॉक मूल्याची गणना केली जाते.
धुराची दुरुस्ती सेट केली असल्यास, क्रॉसस्टॉक मूल्य दुरुस्त केले जाते आणि ध्वज HasXtalkValueChanged सेट केला जातो. पुढील श्रेणीवर हा ध्वज स्वयंचलितपणे साफ केला जातो.

टीप: धुसफूस दुरुस्त करणे इतकेच मर्यादित आहे:

  • लहान अंतर मोड वापरून 1.2 मी
  • मध्यम अंतर मोड वापरून 1.7 मी
  • लांब अंतर मोड वापरून 3.8 मी.

I2C पत्ता

VL2L53CX चा डीफॉल्ट I3C पत्ता 0x52 आहे. काही अनुप्रयोगांना वेगळा I2C डिव्हाइस पत्ता सेट करणे आवश्यक आहे. हे प्रकरण आहे, माजीample, जेव्हा अनेक VL53L3CX भाग समान I2C बस सामायिक करतात.

ग्राहकाने खालील प्रक्रिया लागू करावी:

  • VL53L3CX बसवणारा बोर्ड काळजीपूर्वक डिझाइन केला पाहिजे. Xshut आणि GPIO1 (इंटरप्ट) पिन प्रत्येक VL53L3CX साठी स्वतंत्रपणे नियंत्रित केल्या पाहिजेत
  • Xshut पिन कमी सेट करून, सर्व VL53L3CX होस्टला HW स्टँडबाय ठेवावे लागेल.
  • होस्ट VL1L53CX पैकी 3 चा Xshut पिन वाढवतो
  • होस्ट VL53LX_SetDeviceAddress() फंक्शनला कॉल करतो
  • सर्व VL53L3CX पत्ते योग्यरित्या सेट केल्यामुळे यजमान नंतरचे तीन बिंदू पुनरावृत्ती करतो.

उदाample, फंक्शनला कॉल करून: status = VL53LX_SetDeviceAddress(&VL53L3Dev, WantedAddress) WantedAddress चे मूल्य नवीन I2C पत्ता म्हणून सेट केले आहे.

ग्राहक कारखाना कॅलिब्रेशन कार्ये

डिव्हाइसच्या पूर्ण कार्यक्षमतेचा लाभ घेण्यासाठी, VL53L3CX ड्रायव्हरमध्ये ग्राहक उत्पादन लाइनवर एकदा चालवल्या जाणार्‍या कॅलिब्रेशन फंक्शन्सचा समावेश आहे.
अंश-टू-पार्ट पॅरामीटर्सची भरपाई करण्यासाठी कॅलिब्रेशन प्रक्रिया चालवाव्या लागतात ज्यामुळे डिव्हाइस कार्यप्रदर्शन प्रभावित होऊ शकते. होस्टमध्ये संचयित केलेला कॅलिब्रेशन डेटा प्रत्येक स्टार्टअपवर समर्पित ड्रायव्हर फंक्शन वापरून VL53L3CX मध्ये लोड करणे आवश्यक आहे. तीन कॅलिब्रेशन आवश्यक आहेत: refSPAD, क्रॉसस्टॉक आणि ऑफसेट.

कॅलिब्रेशन फंक्शन्सचा क्रम खालीलप्रमाणे म्हणतात:

  1. refSPAD
  2. क्रॉसस्टॉक
  3. ऑफसेट

तीन कॅलिब्रेशन कार्ये अनुक्रमिक मोडमध्ये किंवा वैयक्तिकरित्या केली जाऊ शकतात. वैयक्तिकरित्या चालवताना, कॅलिब्रेशन चालवण्यापूर्वी मागील चरण डेटा लोड करणे आवश्यक आहे.

RefSPAD कॅलिब्रेशन

एसटीमध्ये अंतिम मॉड्यूल चाचणी दरम्यान सिंगल फोटॉन अव्हॅलांच डायोड (SPAD) ची संख्या कॅलिब्रेट केली जाते. हे पार्ट-टू-पार्ट व्हॅल्यू NVM मध्‍ये साठवले जाते आणि बूट करताना आपोआप डिव्‍हाइसमध्‍ये लोड होते.
हे कॅलिब्रेशन डिव्हाइस डायनॅमिक ऑप्टिमाइझ करण्यासाठी SPAD ची संख्या समायोजित करण्यास अनुमती देते.
तथापि, मॉड्यूलच्या वर एक कव्हर ग्लास जोडल्याने या कॅलिब्रेशनवर परिणाम होऊ शकतो. एसटी शिफारस करते की ग्राहकाने अंतिम उत्पादन अनुप्रयोगामध्ये हे कॅलिब्रेशन पुन्हा करावे. जेव्हा हे फंक्शन कॉल केले जाते तेव्हा FMT वर चालणारे समान अल्गोरिदम लागू केले जाते: अल्गोरिदम तीन ठिकाणी शोधतो: 1 (1x कमी SPADs), 2 (5 x attenuated SPADs) आणि 3 (10 x attenuated SPADs). सिग्नल संपृक्तता टाळण्यासाठी निवडलेल्या SPAD ची संख्या केली जाते.

RefSPAD कॅलिब्रेशन फंक्शन

SPAD कॅलिब्रेशनसाठी खालील फंक्शन उपलब्ध आहे: VL53LX_PerformRefSpadManagement(VL53LX_DEV Dev)

टीप: कॅलिब्रेशन प्रक्रियेमध्ये हे कार्य प्रथम कॉल करणे आवश्यक आहे.

फंक्शन खालील तीन चेतावणी संदेश आउटपुट करू शकते:

  • VL53LX_WARNING_REF_SPAD_CHAR_NOT_ENOUGH_SPA S 5 पेक्षा कमी चांगले SPAD उपलब्ध, आउटपुट वैध नाही
  • VL53LX_WARNING_REF_SPAD_CHAR_RATE_TOO_HIGH शोध संदर्भ दराच्या शेवटी > 40.0 Mcps ऑफसेट स्थिरता खालावली जाऊ शकते.
  • VL53LX_WARNING_REF_SPAD_CHAR_RATE_TOO_LOW शोध संदर्भ दराच्या शेवटी < 10.0 Mcps. ऑफसेट स्थिरता खराब होऊ शकते.

RefSPAD कॅलिब्रेशन प्रक्रिया

या कॅलिब्रेशनसाठी कोणत्याही विशिष्ट अटींचे पालन करावे लागणार नाही, त्याशिवाय डिव्हाइसच्या शीर्षस्थानी कोणतेही लक्ष्य ठेवले जाऊ नये.
हे कॅलिब्रेशन करण्यासाठी वेळ फक्त काही मिलिसेकंद आहे.
VL53LX_DataInit() फंक्शन कॉल केल्यानंतर हे फंक्शन कॉल करावे लागेल.

refSPAD कॅलिब्रेशन परिणाम मिळवत आहे

VL53LX_GetCalibrationData() फंक्शन सर्व कॅलिब्रेशन डेटा मिळवते. परत केलेल्या स्ट्रक्चर VL53LX_CalibrationData_t मध्ये VL53LX_customer_nvm_managed_t नावाची दुसरी रचना आहे, ज्यामध्ये आठ refSPAD कॅलिब्रेशन पॅरामीटर्स आहेत:

  • ref_spad_man__num_requested_ref_spads: हे मूल्य 5 आणि 44 च्या दरम्यान आहे. हे निवडलेल्या SPAD ची संख्या देते
  • ref_spad_man__ref_location: हे मूल्य 1, 2 किंवा 3 असू शकते. ते संदर्भ क्षेत्रातील SPAD चे स्थान देते.
  • सहा अतिरिक्त पॅरामीटर्स निवडलेल्या स्थानासाठी योग्य स्पॅड नकाशे देतात:
    • global_config__spad_enables_ref_0
    • global_config__spad_enables_ref_1
    • global_config__spad_enables_ref_2
    • global_config__spad_enables_ref_3
    • global_config__spad_enables_ref_4
    • global_config__spad_enables_ref_5

refSPAD कॅलिब्रेशन डेटा सेट करत आहे

प्रत्येक स्टार्टअपवर, प्रारंभिक बूट झाल्यानंतर, VL53LX_DataInit() फंक्शन कॉल केल्यानंतर, VL53LX_SetCalibrationData() वापरून ग्राहक फील्ड अनुप्रयोग refSPAD कॅलिब्रेशन डेटा लोड करू शकतो.
VL53LX_GetCalibrationData() वर कॉल करून संपूर्ण कॅलिब्रेशन रचना मिळवण्याची शिफारस केली जाते. विभाग 6.1.3 मध्ये वर्णन केलेल्या आठ पॅरामीटर्समध्ये सुधारणा करा refSPAD कॅलिब्रेशन परिणाम मिळवा आणि VL53LX_SetCalibrationData() वर कॉल करा.

क्रॉसस्टॉक कॅलिब्रेशन

Crosstalk (XTalk) हे रिटर्न अॅरेवर मिळालेल्या सिग्नलचे प्रमाण म्हणून परिभाषित केले आहे जे सौंदर्याच्या कारणास्तव मॉड्यूलच्या वर जोडलेल्या संरक्षणात्मक विंडो (कव्हर ग्लास) मध्ये VCSEL प्रकाश परावर्तनामुळे होते.
कव्हर ग्लासच्या गुणवत्तेवर अवलंबून, हा परजीवी सिग्नल डिव्हाइसच्या कार्यप्रदर्शनावर परिणाम करू शकतो. VL53L3CX मध्ये बिल्ट इन करेक्शन आहे जे या समस्येची भरपाई करते.
मॉड्युलच्या वर जोडलेल्या कव्हर ग्लासच्या प्रभावाची पूर्तता करण्यासाठी आवश्यक दुरुस्तीच्या प्रमाणाचा अंदाज घेण्यासाठी क्रॉसस्टॉक कॅलिब्रेशन वापरले जाते.
क्रॉसस्टॉक कॅलिब्रेशनच्या आउटपुटमध्ये अनेक पॅरामीटर्स असतात जे क्रॉसस्टॉक मॉडेल परिभाषित करतात, जसे की विभाग 6.2.3 क्रॉसस्टॉक कॅलिब्रेशन परिणाम मिळवणे.

क्रॉसस्टॉक कॅलिब्रेशन फंक्शन

क्रॉसस्टॉक कॅलिब्रेशनसाठी खालील समर्पित फंक्शन उपलब्ध आहे: VL53LX_PerformXTalkCalibration(&VL53L3Dev);

टीप: हे फंक्शन कॅलिब्रेशन प्रक्रियेमध्ये दुसऱ्या स्थानावर, refSPAD कॅलिब्रेशन झाल्यानंतर आणि ऑफसेट कॅलिब्रेशनपूर्वी कॉल करणे आवश्यक आहे.

क्रॉसस्टॉक कॅलिब्रेशन प्रक्रिया

क्रॉसस्टॉक कॅलिब्रेशन करण्यासाठी, डिव्हाइसपासून 600 मिमी अंतरावर लक्ष्य ठेवावे लागेल. क्रॉसस्टॉक कॅलिब्रेशन गडद वातावरणात आयआर योगदान न देता आयोजित केले पाहिजे. VL53LX_DataInit() आणि VL53LX_PerformRefSpadManagement() फंक्शन कॉल केल्यानंतर, समर्पित कॅलिब्रेशन फंक्शन कॉल करावे लागेल, वापरून: VL53LX_PerformXTalkCalibration(&VL53L3Dev). जेव्हा ही फंक्शन्स कॉल केली जातात, तेव्हा क्रॉसस्टॉक कॅलिब्रेशन केले जाते आणि क्रॉसस्टॉक सुधारणा डीफॉल्टनुसार लागू केली जाते.

क्रॉसस्टॉक कॅलिब्रेशन परिणाम मिळवत आहे

कॅलिब्रेशन परिणामांमध्ये, इतरांसह, हिस्टोग्राम आणि "प्लेन ऑफसेट" नावाचा पॅरामीटर असतो. प्लेन ऑफसेट लागू केलेल्या दुरुस्तीचे प्रमाण दर्शवते आणि हिस्टोग्राम प्रत्येक बिनवरील दुरुस्तीचे पुनर्विभाजन आहे. VL53LX_GetCalibrationData() फंक्शन सर्व कॅलिब्रेशन डेटा मिळवते. परत केलेल्या स्ट्रक्चर VL53LX_CalibrationData_t मध्ये इतर स्ट्रक्चर्स आहेत. प्लेन ऑफसेट VL53LX_customer_nvm_managed_t मध्ये समाविष्ट आहे: algo_crosstalk_compensation_plane_offset_kcps हे निश्चित बिंदू 7.9 कोड केलेले मूल्य आहे. खरी संख्या मिळविण्यासाठी त्यास ५१२ ने भागावे लागेल.
दोन इतर संबंधित संरचना परत केल्या आहेत: VL53LX_xtalk_histogram_data_t आणि algo__xtalk_cpo_HistoMerge_kcps. ते साठवणे बंधनकारक आहे.

क्रॉसस्टॉक कॅलिब्रेशन डेटा सेट करत आहे

VL53LX_DataInit() फंक्शन कॉल केल्यावर, ग्राहक क्रॉसस्टॉक कॅलिब्रेशन डेटा वापरून लोड करू शकतो: VL53LX_SetCalibrationData()
VL53LX_GetCalibrationData() वर कॉल करणे, मागील विभागात वर्णन केलेल्या पॅरामीटर्समध्ये बदल करणे, xtalk_histogram रचना समाविष्ट करणे आणि VL53LX_SetCalibrationData() वर कॉल करणे चांगले आहे.

क्रॉसस्टॉक भरपाई सक्षम/अक्षम करा

VL53LX_SetXTalkCompensationEnable() फंक्शन क्रॉसस्टॉक भरपाई सक्षम किंवा अक्षम करते.

टीप: क्रॉसस्टॉक भरपाई डीफॉल्टनुसार अक्षम केली जाते. क्रॉसस्टॉक भरपाई सक्षम करण्यासाठी कॉल करा V53LX_SetXTalkCompensationEnable&VL53L3Dev, 1);
क्रॉसस्टॉक भरपाई अक्षम करण्यासाठी कॉल करा VL53LX_SetXTalkCompensationEnable&VL53L3Dev, 0);
टीप: हे फंक्शन कोणतेही कॅलिब्रेशन किंवा क्रॉसस्टॉक डेटा लोड करत नाही, ते फक्त नुकसान भरपाई सक्षम करते.
टीप: कॅलिब्रेशन, किंवा कॅलिब्रेशन डेटा फंक्शनचे लोडिंग, या सक्षम/अक्षम फंक्शनमधून स्वतंत्रपणे कॉल करणे आवश्यक आहे (वरील विभाग पहा).

ऑफसेट कॅलिब्रेशन

ग्राहक बोर्डवर डिव्हाइस सोल्डर करणे किंवा कव्हर ग्लास जोडणे श्रेणीतील अंतरामध्ये ऑफसेट सादर करू शकते. हे पार्ट-टू-पार्ट ऑफसेट ऑफसेट कॅलिब्रेशन दरम्यान मोजले जाणे आवश्यक आहे. ऑफसेट कॅलिब्रेशन देखील ऑफसेट कॅलिब्रेशन पेक्षा समान कॅलिब्रेशन परिस्थिती वापरून dmax मूल्य कॅलिब्रेट करण्यास अनुमती देते.

ऑफसेट कॅलिब्रेशन कार्ये

ऑफसेट कॅलिब्रेशनसाठी खालील दोन कार्ये उपलब्ध आहेत:

  • VL53LX_PerformOffsetSimpleCalibration(Dev, CalDistanceMilliMeter)
  • VL53LX_PerformOffsetPerVCSECalibration(Dev, CalDistanceMilliMeter)

फंक्शन्सचा युक्तिवाद मिलिमीटरमधील लक्ष्य अंतर आहे. क्रॉसस्टॉक दुरुस्त केल्यानंतर ऑफसेट कॅलिब्रेशन करावे लागेल.
VL53LX_PerformOffsetPerVCSECalibration हे सर्वात अचूक फंक्शन आहे, परंतु कॅलिब्रेशन करण्यासाठी जास्त वेळ लागतो (वेळ 3 ने गुणाकार केला).

ऑफसेट कॅलिब्रेशन प्रक्रिया
ग्राहक कोणत्याही अंतरावर ठेवलेला कोणताही चार्ट रिफ्लेक्शन निवडू शकतात (क्रॉस्टॉक कॅलिब्रेशन प्रमाणेच सेटअप वापरून). निवडलेल्या सेटअपसह सिग्नलचा दर 2 आणि 80 MCps दरम्यान मोजला गेला आहे याची खात्री करणे हे तपासण्यासाठी एकमेव मुद्दा आहे.

तक्ता 3. कॅलिब्रेशन सेटअप ऑफसेट

तक्ता अंतर सभोवतालची परिस्थिती सिग्नल दर
कोणतीही कोणतीही गडद (कोणतेही IR योगदान नाही) 2MCps < सिग्नल दर <80Mcps

या फंक्शन्सद्वारे दोन चेतावणी संदेश परत केले जातात:

  • VL53LX_WARNING_OFFSET_CAL_INSUFFICIENT_MM1_SP DS सिग्नल खूप कमी आहे, ऑफसेट कॅलिब्रेशनची अचूकता कमी होऊ शकते.
  • VL53LX_WARNING_OFFSET_CAL_PRE_RANGE_RATE_TOO_H GH सिग्नल खूप जास्त आहे. ऑफसेट कॅलिब्रेशनची अचूकता कमी होऊ शकते.

ऑफसेट कॅलिब्रेशन परिणाम मिळवणे

VL53LX_GetCalibrationData() फंक्शन सर्व कॅलिब्रेशन डेटा मिळवते. परत केलेल्या स्ट्रक्चर VL53LX_CalibrationData_t मध्ये VL53LX_customer_nvm_managed_t नावाची दुसरी रचना आहे ज्यामध्ये तीन ऑफसेट कॅलिब्रेशन परिणाम आहेत:

  • algo__part_to_part_range_offset_mm
  • mm_config__inner_offset_mm
  • mm_config__outer_offset_mm

डिव्हाइसवर लागू केलेला एकूण ऑफसेट दोन शेवटच्या मूल्यांची सरासरी आहे. perVCSECalibration निवडल्यास, फंक्शनच्या आउटपुटमध्ये खालील डेटा समाविष्ट असतो:

  • short_a_offset_mm
  • short_b_offset_mm
  • मध्यम_a_offset_mm
  • मध्यम_बी_ऑफसेट_मिमी
  • long_a_offset_mm
  • long_bb_offset_mm

निवडलेल्या अंतर मोडवर (VCSEL कालावधी) अवलंबून, यापैकी एक ऑफसेट आपोआप लागू होतो.

ऑफसेट सुधारणा मोड निवडत आहे

VL53LX_SetOffsetCorrectionMode फंक्शन वापरून ऑफसेट सुधारणा मोड दोन पर्यायांसह सेट केला जाऊ शकतो.

टीप: डीफॉल्टनुसार VL53LX_OFFSETCORRECTIONMODE_PERVCSEL वापरले जावे. हे VCSEL कालावधीसाठी ऑफसेट अचूकता वाढविण्यास अनुमती देते.

तक्ता 4. ऑफसेट सुधारणा पर्याय

ऑफसेट कॅलिब्रेशन फंक्शन म्हणतात सुधारणे मोड पर्याय वापरला जाईल
सिंपलऑफसेट कॅलिब्रेशन करा VL53LX_OFFSETCORRECTIONMODE_STANDARD
PerformPerVCSELOoffset कॅलिब्रेशन VL53LX_OFFSETCORRECTIONMODE_PERVCSEL

टीप: फक्त एक ऑफसेट कॅलिब्रेशन प्रकार उपलब्ध असल्यास, संबंधित पर्यायावर ऑफसेट सुधारणा मोड सेट करणे अनिवार्य आहे. हे आपोआप होत नाही.

ऑफसेट कॅलिब्रेशन डेटा सेट करणे
VL53LX_DataInit() फंक्शन कॉल केल्यानंतर, VL53LX_SetCalibrationData() वापरून ग्राहक ऑफसेट कॅलिब्रेशन डेटा लोड करू शकतो.
VL53LX_GetCalibrationData() वर कॉल करणे, मागील विभागांमध्ये वर्णन केलेल्या पॅरामीटर्समध्ये बदल करणे आणि VL53LX_SetCalibrationData() वर कॉल करणे चांगले आहे.

ग्राहक दुरुस्ती दुकान कॅलिब्रेशन

दुरुस्तीच्या दुकानातील घटक बदलामुळे कॅलिब्रेशन मूल्ये गमावल्यास, ग्राहक एक समर्पित प्रक्रिया लागू करू शकतो, जेथे विशिष्ट सेटअप (लक्ष्य) आवश्यक नसते.

कॅलिब्रेशन तीन चरणांनी बनलेले आहे:

  1. RefSpad
  2. क्रॉसस्टॉक
  3. ऑफसेट कॅलिब्रेशन

RefSpad आणि Xtalk हे विभाग 6.1 RefSPAD कॅलिब्रेशन आणि विभाग 6.2 Crosstalk कॅलिब्रेशनमध्ये वर्णन केल्याप्रमाणे समान आहेत.
ऑफसेट कॅलिब्रेशन करण्यासाठी एक समर्पित फंक्शन उपलब्ध आहे: VL53LX_PerformOffsetZeroDistanceCalibration.
कव्हर ग्लासला स्पर्श करून उपकरणासमोर लक्ष्य सेट करावे लागेल. लक्ष्य कागदाची एक साधी शीट असू शकते (कागदाच्या प्रतिबिंबाची विशेष आवश्यकता नसलेली).
वरील फंक्शनला कॉल करणे आवश्यक आहे आणि मागील विभागांमध्ये वर्णन केलेल्या प्रक्रियेप्रमाणेच परिणाम पुनर्प्राप्त केले जाऊ शकतात.

बेअर ड्रायव्हर चुका आणि इशारे

जेव्हा कोणतेही ड्रायव्हर फंक्शन कॉल केले जाते तेव्हा ड्रायव्हर त्रुटी नोंदवली जाते. ड्रायव्हर त्रुटींसाठी संभाव्य मूल्ये खालील तक्त्यामध्ये वर्णन केल्या आहेत. काही पॅरामीटर्स ऑप्टिमाइझ केलेले नाहीत हे वापरकर्त्याला सूचित करण्यासाठी चेतावणी आहेत. चेतावणी होस्टसाठी अवरोधित होत नाहीत.

तक्ता 5. बेअर ड्रायव्हर त्रुटी आणि चेतावणी वर्णन

त्रुटी मूल्य API त्रुटी स्ट्रिंग घटना
0 VL53LX_ERROR_NONE कोणतीही त्रुटी नाही
-1 VL53LX_ERROR_CALIBRATION_WARNING अवैध कॅलिब्रेशन डेटा
-4 VL53LX_ERROR_INVALID_PARAMS फंक्शनमध्ये अवैध पॅरामीटर सेट केले आहे
-5 VL53LX_ERROR_NOT_SUPPORTED प्रोग्राम केलेल्या कॉन्फिगरेशनमध्ये विनंती केलेले पॅरामीटर समर्थित नाही
-6 VL53LX_ERROR_RANGE_ERROR व्यत्यय स्थिती चुकीची आहे
-7 VL53LX_ERROR_TIME_OUT कालबाह्य झाल्यामुळे श्रेणी रद्द केली आहे
-8 VL53LX_ERROR_MODE_NOT_SUPPORTED विनंती केलेला मोड समर्थित नाही
-10 VL53LX_ERROR_COMMS_BUFFER_TOO_SMALL पुरवठा केलेला बफर I2C सपोर्टपेक्षा मोठा आहे
-13 VL53LX_ERROR_CONTROL_INTERFACE IO फंक्शनमधून त्रुटी नोंदवली गेली
-14 VL53LX_ERROR_INVALID_COMMAND आदेश अवैध आहे
-16 VL53LX_ERROR_REF_SPAD_INIT संदर्भ SPAD कॅलिब्रेशन दरम्यान एक त्रुटी आली
-17 VL53LX_ERROR_GPH_SYNC_CHECK_FAIL ड्राइव्हर डिव्हाइससह समक्रमित नाही. स्टॉप/स्टार्ट किंवा रीबूट आवश्यक असू शकते
-18 VL53LX_ERROR_STREAM_COUNT_CHECK_FAIL
-19 VL53LX_ERROR_GPH_ID_CHECK_FAIL
-20 VL53LX_ERROR_ZONE_STREAM_COUNT_CHEC K_FAIL
-21 VL53LX_ERROR_ZONE_GPH_ID_CHECK_FAIL
-22 VL53LX_ERROR_XTALK_EXTRACTION_FAIL नाही यशस्वी एसamps मध्ये पूर्ण अॅरे वापरताना lesampले द क्रॉसस्टॉक. या प्रकरणात नवीन क्रॉसस्टॉक मूल्य व्युत्पन्न करण्यासाठी पुरेशी माहिती नाही. फंक्शन बाहेर पडेल आणि वर्तमान क्रॉसस्टॉक पॅरामीटर्स अपरिवर्तित सोडेल
-23 VL53LX_ERROR_XTALK_EXTRACTION_SIGMA_L IMIT_FAIL क्रॉसस्टॉकचा सरासरी सिग्मा अंदाजample आहे > अनुमत कमाल मर्यादेपेक्षा. या प्रकरणात क्रॉसस्टॉक एसampमापनासाठी खूप गोंगाट आहे. फंक्शन बाहेर पडेल आणि वर्तमान क्रॉसस्टॉक पॅरामीटर्स अपरिवर्तित सोडेल
-24 VL53LX_ERROR_OFFSET_CAL_NO_S बद्दलAMPLE_FA IL ऑफसेट कॅलिब्रेशन दरम्यान एक त्रुटी आली. चेक सेटअप एसटीच्या शिफारशींनुसार आहे.
-25 VL53LX_ERROR_OFFSET_CAL_NO_SPADS_ENA BLED_FAIL
-28 VL53LX_WARNING_REF_SPAD_CHAR_NOT_EN OUGH_SPADS चेतावणी: अचूक refSpadManagement कॅलिब्रेशन मिळविण्यासाठी सापडलेल्या स्पॅडची संख्या खूप कमी आहे. सेटअप ST शिफारशींनुसार असल्याची खात्री करा.
-29 VL53LX_WARNING_REF_SPAD_CHAR_RATE_TO O_HIGH चेतावणी: अचूक refSpadManagement कॅलिब्रेशन मिळविण्यासाठी सिग्नल दर खूपच कमी आढळला. सेटअप ST शिफारशींनुसार असल्याची खात्री करा.
 -30 VL53LX_WARNING_REF_SPAD_CHAR_RATE_TO O_LOW चेतावणी: अचूक ऑफसेट कॅलिब्रेशन मिळविण्यासाठी स्पॅडची संख्या खूप कमी आढळली. सेटअप ST शिफारशींनुसार असल्याची खात्री करा.
-31 VL53LX_WARNING_OFFSET_CAL_MISSING_SA MPLES ऑफसेट कॅलिब्रेशन दरम्यान चेतावणी आली. सेटअप ST शिफारशींनुसार असल्याची खात्री करा.
-32 VL53LX_WARNING_OFFSET_CAL_SIGMA_TOO_ उच्च
-33 VL53LX_WARNING_OFFSET_CAL_RATE_TOO_HI GH
-34 VL53LX_WARNING_OFFSET_CAL_SPAD_COUNT_TOO_LOW
-38 VL53LX_चेतावणी_XTALK_मिसिंग_एसAMPLES क्रॉसस्टॉक कॅलिब्रेशन दरम्यान चेतावणी आली. सेटअप ST शिफारशींनुसार असल्याची खात्री करा.
-41 VL53LX_ERROR_NOT_IMPLEMENTED नावाचे कार्य अंमलात आणलेले नाही

पुनरावृत्ती इतिहास

तारीख आवृत्ती बदल
28-सप्टे-2020 1 प्रारंभिक प्रकाशन
02-डिसेंबर-2021 2 क्रॉसस्टॉक कॅलिब्रेशन परिणाम मिळवणे विभाग 6.2.3 मध्ये परत आलेल्या संरचना अद्यतनित केल्या
 03-जून-2022 3 विभाग 3.1 बेअर ड्रायव्हर: कॅलिब्रेशन संदर्भात एक टीप जोडली कलम 5.4 कव्हर ग्लास स्मज डिटेक्शन: स्मूज दुरुस्त्यासंबंधी एक टीप जोडली

महत्वाची सूचना – काळजीपूर्वक वाचा

STMicroelectronics NV आणि त्याच्या उपकंपन्या (“ST”) ST उत्पादनांमध्ये आणि/किंवा या दस्तऐवजात कोणत्याही वेळी सूचना न देता बदल, सुधारणा, सुधारणा, सुधारणा आणि सुधारणा करण्याचा अधिकार राखून ठेवतात. खरेदीदारांनी ऑर्डर देण्यापूर्वी एसटी उत्पादनांची नवीनतम माहिती मिळवावी. ऑर्डर पावतीच्या वेळी एसटी उत्पादनांची विक्री एसटीच्या अटी आणि नियमांनुसार केली जाते.

एसटी उत्पादनांची निवड, निवड आणि वापर यासाठी खरेदीदार पूर्णपणे जबाबदार आहेत आणि एसटी अर्ज सहाय्यासाठी किंवा खरेदीदारांच्या उत्पादनांच्या डिझाइनसाठी कोणतेही दायित्व गृहीत धरत नाही.

कोणताही बौद्धिक संपदा अधिकाराचा कोणताही परवाना, व्यक्त किंवा निहित, येथे एसटीकडून मंजूर नाही.

येथे नमूद केलेल्या माहितीपेक्षा वेगळ्या तरतुदींसह एसटी उत्पादनांची पुनर्विक्री अशा उत्पादनासाठी एसटीने दिलेली कोणतीही हमी रद्द करेल. एसटी आणि एसटी लोगो हे एसटीचे ट्रेडमार्क आहेत. एसटी ट्रेडमार्कबद्दल अतिरिक्त माहितीसाठी, पहा www.st.com/trademarks. इतर सर्व उत्पादन किंवा सेवा नावे त्यांच्या संबंधित मालकांची मालमत्ता आहेत.
या दस्तऐवजातील माहिती या दस्तऐवजाच्या कोणत्याही आधीच्या आवृत्त्यांमध्ये पूर्वी पुरवलेल्या माहितीची जागा घेते आणि पुनर्स्थित करते. © 2022 STMicroelectronics – सर्व हक्क राखीव

 

कागदपत्रे / संसाधने

ST VL53L3CX फ्लाइट रेंजिंग सेन्सरची वेळ [pdf] वापरकर्ता मॅन्युअल
VL53L3CX फ्लाइट रेंजिंग सेन्सरची वेळ, VL53L3CX, फ्लाइट रेंजिंग सेन्सरची वेळ, फ्लाइट रेंजिंग सेन्सर, रेंजिंग सेन्सर

संदर्भ

एक टिप्पणी द्या

तुमचा ईमेल पत्ता प्रकाशित केला जाणार नाही. आवश्यक फील्ड चिन्हांकित आहेत *