ST VL53L3CX צייט פון פלי ריינדזשינג סענסאָר באַניצער מאַנואַל
הקדמה
VL53L3CX איז אַ צייט-פון-פלי (ToF) ריינדזשינג סענסער מאָדולע.
דער ציל פון דעם באַניצער מאַנואַל איז צו באַשרייַבן די ינטאַגריישאַן מאָדעל און די גאַנג פון פאַנגקשאַנז צו רופן צו באַקומען ריינדזשינג דאַטן מיט די VL53L3CX נאַקעט שאָפער.
VL53L3CX סיסטעם איבערview
VL53L3CX סיסטעם איז קאַמפּאָוזד פון די VL53L3CX מאָדולע און אַ שאָפער פליסנדיק אויף דער באַלעבאָס.
דער דאָקומענט באשרייבט די שאָפער פאַנגקשאַנז צוטריטלעך צו די האָסט, צו קאָנטראָלירן די מיטל און באַקומען די ריינדזשינג דאַטן פֿאַר ינאַגריישאַן מיט ניט-לינוקס מחנות.
פיגורע 1. VL53L3CX סיסטעם
באַמערקונג:
דער פאָרשטעלן דאָקומענט באשרייבט די ימפּלאַמענאַד און וואַלאַדייטאַד פאַנגקשאַנז. קיין אנדערע פאַנגקשאַנז בנימצא אין די דריווערס זאָל ניט זיין געוויינט אויב ניט דיסקרייבד אין דעם דאָקומענט.
די נאַקעט שאָפער איז אַ ימפּלאַמענטיישאַן פון אַ סכום פון פאַנגקשאַנז פארלאנגט צו נוצן די VL53L3CX מיטל. עס מאכט מינימאַל אַסאַמפּשאַנז אויף די אַס ינאַגריישאַן און באַדינונגס. ווי אַזאַ, סיקוואַנסינג פון אַקשאַנז, דורכפירונג / טרעדינג מאָדעל, פּלאַטפאָרמע אַדאַפּטיישאַן און אַלאַקיישאַן פון מיטל סטראַקטשערז זענען נישט טייל פון די נאַקעט דרייווער ימפּלאַמענטיישאַן, אָבער לינקס אָופּאַנד צו די ינטעגראַטאָר.
די סיקוואַנסינג פון נאַקעט דרייווער רופט מוזן נאָכפאָלגן אַ סכום פון כּללים, דיפיינד אין דעם דאָקומענט.
ריינדזשינג פאַנגקשאַנאַל באַשרייַבונג
דער אָפּטיילונג בעקיצער באשרייבט די פאַנגקשאַנאַל קייפּאַבילאַטיז פון די VL53L3CX ריינדזשינג מיטל.
ריינדזשינג סיקוואַנס
דער מיטל איז פליסנדיק מיט אַ כאַנדשייק מעקאַניזאַם, באזירט אויף אַ נאָרמאַל יבעררייַס פאַרוואַלטונג סכעמע.
נאָך יעדער ריינדזשינג, דער באַלעבאָס אַקווייערז די ריינדזשינג דאַטן און ינייבאַלז די ווייַטער ריינדזשינג דורך קלאָר די יבעררייַס. דער פּראָצעס איז ריפערד צו ווי די האַנדשייק מעקאַניזאַם. דערנאָך ריינדזשינג איז טריגערד אויב די קראַנט איז פאַרטיק און אויב דער באַלעבאָס האט קלירד די פריערדיקע פּענדינג יבעררייַס.
די יבעררייַס מעקאַניזאַם אַלאַוז פאַסטער דאַטן אַריבערפירן, אָן לוזינג קיין ריינדזשינג ווערט רעכט צו קאָמוניקאַציע אָדער ייסינכרוניסם ישוז. בעשאַס די כאַנדשייק פאַסע, דער באַלעבאָס פּערפאָרמז עטלעכע דאַטן פּראַסעסינג. די ריינדזשינג סיקוואַנס איז פאַנגקשאַנאַלי דיסקרייבד אין די פיגור אונטן.
האַנדשייק סיקוואַנס אַלאַוז די קאַמפּיאַטיישאַן פון ינערלעך פּאַראַמעטערס און צולייגן זיי פֿאַר די ווייַטער קייט.
די האַנדשייק מוזן זיין דורכגעקאָכט דורך די באַניצער פון די נאַקעט שאָפער. די פאַרהאַלטן צו געבן אַ נייַ ריינדזשינג נאָך אַ נייַע מעזשערמאַנט איז דער שליסל צו די קוילעלדיק סיסטעם מעזשערמאַנט קורס.
טיימינג קאַנסידעריישאַנז
טיימינגז זענען דערלאנגט אין פיגורע 3. ריינדזשינג סיקוואַנס און טיימינג טאַרגאַץ.
דער באַלעבאָס קענען באַקומען די לעצט בנימצא ריינדזשינג בעשאַס די געדויער (ריינדזשינג טיימינג בודזשעט) פון די קראַנט קייט.
אויב אַ פאַרהאַלטן צו ויסמעקן די יבעררייַס איז באַקענענ דורך דער באַלעבאָס, דער ווייַטער ריינדזשינג וועט זיין סטאָלד ביז די פּענדינג יבעררייַס איז קלירד.
באַמערקונג: טיימינגז אנגעוויזן אין פיגורע 3. ריינדזשינג סיקוואַנס און טיימינג טאַרגאַץ זענען טיפּיש טיימינגז. דער באַלעבאָס קענען טוישן די פעליקייַט טיימינג בודזשעט דורך ניצן אַ דעדאַקייטאַד שאָפער פונקציע דיסקרייבד אין אָפּטיילונג 5.1 טיימינג בודזשעט. האָסט קענען באַשליסן צו טוישן טיימינג בודזשעט אָדער צו סינגקראַנייז אויף די אַפּלאַקיישאַן אָדער צו פאַרגרעסערן ריינדזשינג אַקיעראַסי.
אין די פאלגענדע פיגור, די "שטיוול", "SW סטאַנדביי" און "Init" לאַסץ 40 מיז. די צייט איז דארף צו דורכפירן אַ ריכטיק יניטיאַליזיישאַן פון די מיטל, און עס איז פרייַ פון די פּלאַטפאָרמע אָדער די געוויינט טיימינג בודזשעט. דער ערשטער קייט, "Range1", איז נישט גילטיק, ווייַל די ראַפּ-אַרום טשעק איז ניט מעגלעך. דעם מיטל אַז דער ערשטער גילטיק ריינדזשינג ווערט איז "ראַנגע 2", בנימצא נאָך 40 מיז פּלוס צוויי מאָל די טיימינג בודזשעט געדויער.
פיגורע 3. ריינדזשינג סיקוואַנס און טיימינג טאַרגאַץ
נאַקעט שאָפער יקערדיק פאַנגקשאַנז באַשרייַבונג
דער אָפּטיילונג באשרייבט די שאָפער פאַנגקשאַנז קאַללס לויפן וואָס זאָל זיין נאכגעגאנגען צו דורכפירן אַ ריינדזשינג מעזשערמאַנט
ניצן די VL53L3CX.
די VL53L3CX שאָפער זענען געניצט אין צוויי קלאסן פון אַפּלאַקיישאַנז:
- פאַבריק פּראָגראַמען געניצט פֿאַר קאַלאַבריישאַן פון די מיטל, טיפּיקלי אין די פּראָבע פון די פּראָדוקציע פון פּראָדוקציע (פאַבריק לויפן)
- פעלד אַפּלאַקיישאַנז, וואָס קלייַבן אַלע סוף-באַניצער אַפּלאַקיישאַנז מיט די VL53L3CX מיטל (ריינדזשינג לויפן)
נאַקעט שאָפער
נאַקעט שאָפער פאַבריק לויפן איז ילאַסטרייטיד אין די פאלגענדע פיגור.
פיגורע 4. VL53L3CX API ריינדזשינג לויפן (פאַבריק)
באַמערקונג: די קאַלאַבריישאַן לויפן ענדערונגען די דיסטאַנסע מאָדע. עס איז מאַנדאַטאָרי צו רופן די SetDistanceMode () פֿונקציע אויב איר ווילן צו נוצן די סענסער נאָר נאָך אַ קאַלאַבריישאַן.
נאַקעט שאָפער ריינדזשינג לויפן איז ילאַסטרייטיד אין די פאלגענדע פיגור.
פיגורע 5. VL53L3CX API ריינדזשינג לויפן (פעלד)
סיסטעם יניטיאַליזאַטיאָן
די פאלגענדע אָפּטיילונג ווייזט די אַפּי פאַנגקשאַנז רופט פארלאנגט צו דורכפירן די סיסטעם יניטיאַליזיישאַן, איידער איר אָנהייבן אַ מעזשערמאַנט.
וואַרטן פֿאַר שטיוול
VL53LX_WaitDeviceBooted () פֿונקציע ינשורז אַז די מיטל איז בוטיד און גרייט. עס איז ניט מאַנדאַטאָרי צו רופן דעם פֿונקציע.
באַמערקונג: דעם פֿונקציע בלאַקס דער באַלעבאָס דורכפירונג. די פֿונקציע זאָל נישט פאַרשפּאַרן פֿאַר מער ווי 4 מיז, אַסומינג:
- 400 כז I2C אָפטקייַט
- 2 מס לייטאַנסי פּער טראַנסאַקטיאָן
דאַטאַ יניט
די VL53LX_DataInit () פֿונקציע מוזן זיין גערופֿן יעדער מאָל ווען די מיטל גייט אַרויס פון די "ערשט שטיוול" שטאַט. עס פּערפאָרמז יניטיאַליזיישאַן פון די מיטל. נאָך רופן די VL53LX_DataInit () פֿונקציע, די קאַלאַבריישאַן דאַטן מוזן זיין לאָודיד מיט די פֿונקציע VL53LX_SetCalibrationData ().
ריינדזשינג מיט VL53L3CX
אויף ניט-לינוקס מחנות, דער באַניצער פון די נאַקעט דרייווער סיקוואַנסיז רופט צו די שאָפער אין אַ וועג וואָס איז צונעמען צו די אַפּלאַקיישאַן דאַרף, די פּלאַטפאָרמע קייפּאַבילאַטיז און די נאַקעט דרייווער רופן סיקוואַנס כּללים.
אָנהייבן אַ מעזשערמאַנט
VL53LX_StartMeasurement () פֿונקציע מוזן זיין גערופֿן צו אָנהייבן אַ מעזשערמאַנט.
וואַרטן פֿאַר אַ רעזולטאַט: פּאָללינג אָדער יבעררייַסן
עס זענען 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-ביסל ינטאַדזשער ווערט וואָס ינדיקייץ אויב די קראָססטאַלק ווערט איז פארענדערט.
- ווירקעוודיק ספּאַד Rtn Count: 16-ביסל ינטאַדזשער וואָס קערט די עפעקטיוו איין פאָטאָן לאַווינע דייאָוד (SPAD) ציילן פֿאַר די קראַנט ריינדזשינג. צו באַקומען פאַקטיש ווערט עס זאָל זיין צעטיילט דורך 256.
איין סטרוקטור פּער ציל דיטעקטאַד (אַרויף צו 4 דורך פעליקייַט) גערופן VL53LX_TargetRangeData_t וואָס כּולל די פאלגענדע ספּעציפיש רעזולטאַטן פֿאַר יעדער ציל דיטעקטאַד.
- ראַנגעמאַקס מילימעטער: איז אַ 16-ביסל ינטאַדזשער, ינדאַקייטינג די גרעסערע דיטעקטאַד ווייַטקייט.
- RangeMinMilliMeter: איז אַ 16-ביסל ינטאַדזשער, ינדאַקייטינג די קלענערער דיטעקטאַד ווייַטקייט.
- SignalRateRtnMegaCps: דער ווערט איז דער צוריקקער סיגנאַל קורס אין MegaCountPer Second (MCPS), דאָס איז אַ 16.16 פאַרריכטן פונט ווערט. צו באַקומען די פאַקטיש ווערט עס זאָל זיין צעטיילט דורך 65536.
- AmbientRateRtnMegaCps: דער ווערט איז דער צוריקקער אַמביאַנט קורס (אין MCPS), דאָס איז אַ 16.16 פאַרריכטן פונט ווערט, וואָס איז יפעקטיוולי אַ מאָס פון די סומע פון אַמביאַנט ליכט געמאסטן דורך די סענסער. צו באַקומען די פאַקטיש ווערט עס זאָל זיין צעטיילט דורך 65536.
- SigmaMillimeter: דעם 16.16 פאַרריכטן פונט ווערט איז אַן אָפּשאַצונג פון די נאָרמאַל דיווייישאַן פון די קראַנט ריינדזשינג, אויסגעדריקט אין מילאַמיטער. צו באַקומען די פאַקטיש ווערט עס זאָל זיין צעטיילט דורך 65536.
- ראַנגעמילימעטער: איז אַ 16-ביסל גאַנץ נומער וואָס ינדיקייץ די קייט דיסטאַנסע אין מילאַמיטערז.
- קייט סטאַטוס: דאָס איז אַן 8-ביסל ינטאַדזשער וואָס ינדיקייץ די קייט סטאַטוס פֿאַר די קראַנט מעזשערמאַנט. ווערט = 0 מיטל ריינדזשינג איז גילטיק. זען טאַבלע 1. קייט סטאַטוס.
- עקסטענדעד קייט: דאָס איז אַן 8-ביסל ינטאַדזשער וואָס ינדיקייץ אויב די קייט איז געווען אַנרואַפּט (בלויז פֿאַר לאַנג דיסטאַנסאַז)
א באַזונדער נאַטור איז ימפּלאַמענאַד ווען דער ציל איז נישט דיטעקטאַד. אויב דער ציל איז נישט דיטעקטאַד און די מעזשערמאַנט איז גילטיק, די פאלגענדע וואַלועס זענען רעפּאָרטעד אין די VL53LX_TargetRangeData_t סטרוקטור:
- RangeMaxMilliMeter: געצווונגען צו 8191.
- RangeMinMilliMeter: געצווונגען צו 8191.
- SignalRateRtnMegaCps: געצווונגען צו 0.
- AmbientRateRtnMegaCps: די אַמביאַנט קורס ווערט איז נאָרמאַלי קאַמפּיוטאַד.
- SigmaMilliMeter: געצווונגען צו 0.
- RangeMilliMeter: געצווונגען צו 8191.
- ראַנגעסטאַטוס: געצווונגען צו 255.
- עקסטענדעד ראַנגע: געצווונגען צו 0.
טיש 1. קייט סטאַטוס
| ווערט | RangeStatus שטריקל | באַמערקונג |
| 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 | אויפשטיין איין מאָל נאָך יניט, ריינדזשינג ווערט מוזן זיין איגנאָרירט |
| 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 מיז. מינימום איז 8 מיז, מאַקסימום איז 500 מיז.
פֿאַר עקסample, צו שטעלן די טיימינג בודזשעט צו 66 מיז: סטאַטוס = 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 רעקאַמענדז צו שטעלן די וואַלועס פון קאַלאַבריישאַן און ריינדזשינג פלאָוז צו 2 נאָך static_init. אין דעם פאַל, די צייט צו דורכפירן די רעפֿערענץ סיגנאַל מעזשערמאַנט איז געוואקסן און אַלאַוז בעסער אַקיעראַסי. באַשטעטיקן דעם פּאַראַמעטער צו 2 ינקריסיז די געדויער צו באַקומען די ערשטער מעזשערמאַנט מיט 240 מיז.
פֿאַרבעסערן לייטאַנסי און מאַקסימום ריינדזשינג דיסטאַנסע
ווען דער ציל איז מאָווינג, די VL53L3CX קען דאַרפֿן עטלעכע ריינדזשאַז צו רעאַגירן, דיפּענדינג אויף די סצענע. א וועג צו פֿאַרבעסערן די לייטאַנסי איז צו סטרויערן די VL53LX_TUNINGPARM_RESET_MERGE_THRESHOLD פּאַראַמעטער. פעליקייַט ווערט איז 15000. עס קענען זיין לאָוערד צו פֿאַרבעסערן לייטאַנסי, אָבער מאַקסימום ריינדזשינג דיסטאַנסע וועט זיין ימפּאַקטיד.
אויב דער באַניצער ינקריסיז די ווערט, די מאַקסימום ריינדזשינג דיסטאַנסע קענען זיין ימפּרוווד, אָבער לייטאַנסי איז ימפּאַקטיד.
דעקן גלאז שמיר דיטעקשאַן
די קראָססטאַלק קענען זיין אַפעקטאַד דורך שמיר אויף די דעקל גלאז. VL53L3CX ימבעד אַ פונקציע וואָס קענען דעטעקט שמיר אויף די פליען און צולייגן אַ נייַ קראָסטאַלק קערעקשאַן ווערט. דער באַניצער קענען געבן / דיסייבאַל דעם פֿונקציע דורך רופן VL53LX_SmudgeCorrectionEnable ().
די פאלגענדע דריי אָפּציעס קענען זיין באַשטימט מיט דעם פֿונקציע:
- VL53LX_SMUDGE_CORRECTION_NONE צו דיסייבאַל די קערעקשאַן
- VL53LX_SMUDGE_CORRECTION_CONTINUOUS צו געבן אַ קעסיידערדיק קערעקשאַן
- VL53LX_SMUDGE_CORRECTION_SINGLE צו געבן אַ איין קערעקשאַן נאָך באקומען אַ אָנהייב באַפֿעל.
שמיר דיטעקשאַן איז פליסנדיק אין יעדער ריינדזשינג. אויב עטלעכע באדינגונגען זענען באגעגנט (קיין כייפעץ אונטער 80 סענטימעטער, אַמביאַנט ליכט מדרגה אונטער אַ שוועל, און קראָססטאַלק ווערט העכער 1 קפּס), אַ נייַ קראָסטאַלק ווערט איז קאַמפּיוטאַד.
אויב די שמיר קערעקשאַן איז באַשטימט, די קראָסטאַלק ווערט איז קערעקטאַד און די פאָן HasXtalkValueChanged איז באַשטימט. דעם פאָן איז אויטאָמאַטיש קלירד אין דער ווייַטער קייט.
באַמערקונג: די שמיר קערעקשאַן איז לימיטעד צו:
- 1.2 עם ניצן קורץ דיסטאַנסע מאָדע
- 1.7 עם מיט מיטל דיסטאַנסע מאָדע
- 3.8 עם ניצן לאַנג דיסטאַנסע מאָדע.
I2C אַדרעס
די פעליקייַט I2C אַדרעס פון די VL53L3CX איז 0x52. עטלעכע אַפּלאַקיישאַנז דאַרפֿן צו שטעלן אַ אַנדערש I2C מיטל אַדרעס. דאָס איז דער פאַל, למשלample, ווען עטלעכע VL53L3CX פּאַרץ טיילן די זעלבע I2C ויטאָבוס.
דער קונה זאָל צולייגן די פאלגענדע פּראָצעדור:
- די ברעט מאַונטינג די VL53L3CX מוזן זיין דיזיינד קערפאַלי. די Xshut און די GPIO1 (יבעררייַסן) פּינס מוזן זיין קאַנטראָולד ינדיווידזשואַלי פֿאַר יעדער VL53L3CX
- דער באַלעבאָס האט צו שטעלן אין HW סטאַנדביי, באַשטעטיקן די Xshut שטיפט נידעריק, אַלע די VL53L3CX.
- דער באַלעבאָס רייזאַז די Xshut שטיפט פון 1 פון די VL53L3CX
- דער באַלעבאָס רופט די פֿונקציע VL53LX_SetDeviceAddress ()
- דער באַלעבאָס ריפּיץ די לעצטע דריי פונקטן זינט אַלע די VL53L3CX אַדרעסעס זענען ריכטיק באַשטימט.
פֿאַר עקסampדורך רופן די פֿונקציע: סטאַטוס = VL53LX_SetDeviceAddress (&VL53L3Dev, WantedAddress) די ווערט פון WantedAddress איז באַשטימט ווי די נייַע I2C אַדרעס.
קונה פאַבריק קאַלאַבריישאַן פאַנגקשאַנז
אין סדר צו נוץ פון די פול פאָרשטעלונג פון די מיטל, די VL53L3CX שאָפער כולל קאַלאַבריישאַן פאַנגקשאַנז צו לויפן אַמאָל ביי דער קונה פּראָדוקציע שורה.
קאַלאַבריישאַן פּראָוסידזשערז מוזן זיין דורכגעקאָכט צו פאַרגיטיקן טייל-צו-טייל פּאַראַמעטערס וואָס קען ווירקן די פאָרשטעלונג פון די מיטל. קאַלאַבריישאַן דאַטן סטאָרד אין דער באַלעבאָס מוזן זיין לאָודיד אין VL53L3CX ביי יעדער סטאַרטאַפּ מיט אַ דעדאַקייטאַד שאָפער פונקציע. דריי קאַלאַבריישאַנז זענען דארף: refSPAD, קראָססטאַלק און פאָטאָ.
די סדר די קאַלאַבריישאַן פאַנגקשאַנז זענען גערופֿן ווי גייט:
- refSPAD
- קראָססטאַלק
- אָפסעט
די דריי קאַלאַבריישאַן פאַנגקשאַנז קענען זיין געטאן אין סאַקווענטשאַל מאָדע אָדער ינדיווידזשואַלי. ווען לויפן ינדיווידזשואַלי, די פריערדיקע שריט דאַטן מוזן זיין לאָודיד איידער פליסנדיק קאַלאַבריישאַן.
רעפספּאַד קאַלאַבריישאַן
די נומער פון איין פאָטאָן לאַווינע דייאָוד (SPAD) איז קאַלאַברייטיד בעשאַס די לעצט מאָדולע פּרובירן אין ST. דער טייל-צו-טייל ווערט איז סטאָרד אין NVM און אויטאָמאַטיש לאָודיד אין די מיטל בעשאַס שטיוול.
די קאַלאַבריישאַן אַלאַוז צו סטרויערן די נומער פון SPADs צו אַפּטאַמייז די דינאַמיש פון די מיטל.
אָבער, אַדינג אַ דעקן גלאז אויף שפּיץ פון די מאָדולע קען ווירקן דעם קאַלאַבריישאַן. ST רעקאַמענדז אַז דער קונה פּערפאָרמז דעם קאַלאַבריישאַן ווידער אין די לעצט פּראָדוקט אַפּלאַקיישאַן. דער זעלביקער אַלגערידאַם פליסנדיק ביי FMT איז געווענדט ווען דעם פֿונקציע איז גערופֿן: דער אַלגערידאַם זוכן דורך דריי לאָוקיישאַנז: 1 (1 קס אַטטענואַטעד ספּאַדס), 2 (5 קס אַטטענואַטעד ספּאַדס) און 3 (10 קס אַטטענואַטעד ספּאַדס). נומער פון SPADs אויסדערוויילט איז געטאן צו ויסמיידן סיגנאַל זעטיקונג.
רעפספּאַד קאַלאַבריישאַן פֿונקציע
די פאלגענדע פֿונקציע איז בארעכטיגט פֿאַר 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 מקפּס אָפסעט פעסטקייַט קען זיין דיגריידיד.
- VL53LX_WARNING_REF_SPAD_CHAR_RATE_TOO_LOW אין די סוף פון זוכן רעפֿערענץ קורס <10.0 מקפּס. אָפסעט פעסטקייַט קען זיין דיגריידיד.
רעפספּאַד קאַלאַבריישאַן פּראָצעדור
ניט קיין באַזונדער טנאָים האָבן צו זיין נאכגעגאנגען פֿאַר דעם קאַלאַבריישאַן, אַחוץ אַז קיין ציל זאָל זיין געשטעלט אויף שפּיץ פון די מיטל.
צייט צו דורכפירן דעם קאַלאַבריישאַן איז בלויז אַ ביסל מיליסעקאַנדז.
די פֿונקציע זאָל זיין גערופֿן נאָך VL53LX_DataInit () פֿונקציע איז גערופֿן.
באַקומען רעפספּאַד קאַלאַבריישאַן רעזולטאַטן
די פֿונקציע VL53LX_GetCalibrationData() קערט אַלע קאַלאַבריישאַן דאַטן. די אומגעקערט סטרוקטור VL53LX_CalibrationData_t כּולל אן אנדער סטרוקטור גערופן VL53LX_customer_nvm_managed_t, וואָס כּולל די אַכט refSPAD קאַלאַבריישאַן פּאַראַמעטערס:
- ref_spad_man__num_requested_ref_spads: די ווערט איז צווישן 5 און 44. עס גיט די נומער פון ספּאַדס אויסגעקליבן
- ref_spad_man__ref_location: דעם ווערט קענען זיין 1, 2 אָדער 3. עס גיט די אָרט פון די SPADs אין דער רעפֿערענץ געגנט.
- זעקס נאָך פּאַראַמעטערס געבן די ריכטיק ספּאַד מאַפּס פֿאַר די אויסגעקליבן אָרט:
- 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 קאַלאַבריישאַן דאַטן
ביי יעדער סטאַרטאַפּ, נאָך אַן ערשט שטיוול, דער קונה פעלד אַפּלאַקיישאַן קענען לאָדן די refSPAD קאַלאַבריישאַן דאַטן נאָך די VL53LX_DataInit () פֿונקציע איז גערופן, דורך ניצן VL53LX_SetCalibrationData ().
עס איז רעקאַמענדיד צו באַקומען די גאנצע קאַלאַבריישאַן סטרוקטור דורך רופן VL53LX_GetCalibrationData (). מאָדיפיצירן די אַכט פּאַראַמעטערס דיסקרייבד אין אָפּטיילונג 6.1.3 באַקומען רעפספּאַד קאַלאַבריישאַן רעזולטאַטן און רופן VL53LX_SetCalibrationData ().
קראָססטאַלק קאַלאַבריישאַן
קראָסטאַלק (קסטאַלק) איז דיפיינד ווי די סומע פון סיגנאַל באקומען אויף די צוריקקער מענגע, וואָס איז רעכט צו VCSEL ליכט אָפּשפּיגלונג אין די פּראַטעקטיוו פֿענצטער (דעק גלאז) צוגעגעבן אויף שפּיץ פון די מאָדולע פֿאַר עסטעטיש סיבות.
דעפּענדינג אויף די דעקל גלאז קוואַליטעט, דעם פּעראַסיטיק סיגנאַל קענען ווירקן די פאָרשטעלונג פון די מיטל. VL53L3CX האט אַ געבויט-אין קערעקשאַן וואָס קאַמפּאַנסייץ דעם פּראָבלעם.
קראָססטאַלק קאַלאַבריישאַן איז געניצט צו אָפּשאַצן די סומע פון קערעקשאַן דארף צו פאַרגיטיקן די ווירקונג פון אַ דעקן גלאז צוגעגעבן אויף שפּיץ פון די מאָדולע.
דער רעזולטאַט פון די קראָססטאַלק קאַלאַבריישאַן כּולל פילע פּאַראַמעטערס וואָס דעפינירן די קראָססטאַלק מאָדעל, ווי דיסקרייבד אין אָפּטיילונג 6.2.3 באַקומען רעזולטאַטן פון קראָססטאַלק קאַלאַבריישאַן.
קראָססטאַלק קאַלאַבריישאַן פֿונקציע
די פאלגענדע דעדאַקייטאַד פֿונקציע איז בנימצא פֿאַר קראָססטאַלק קאַלאַבריישאַן: VL53LX_PerformXTalkCalibration(&VL53L3Dev);
באַמערקונג: די פֿונקציע מוזן זיין גערופֿן אין די רגע שטעלע אין די קאַלאַבריישאַן פּראָצעדור, נאָך רעפספּאַד קאַלאַבריישאַן איז דורכגעקאָכט, און איידער אָפסעט קאַלאַבריישאַן.
קראָסטאַלק קאַלאַבריישאַן פּראָצעדור
צו דורכפירן די קראָססטאַלק קאַלאַבריישאַן, אַ ציל זאָל זיין געשטעלט אין אַ ווייַטקייט פון 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 קאָדעד ווערט. עס מוזן זיין צעטיילט דורך 512 צו באַקומען די פאַקטיש נומער.
צוויי אנדערע באַטייַטיק סטראַקטשערז זענען אומגעקערט: 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);
באַמערקונג: די פֿונקציע טוט נישט דורכפירן קיין קאַלאַבריישאַן אָדער קראָססטאַלק דאַטן לאָודינג, עס נאָר ינייבאַלז די פאַרגיטיקונג.
באַמערקונג: קאַלאַבריישאַן, אָדער לאָודינג פון קאַלאַבריישאַן דאַטן פונקציע, מוזן זיין גערופֿן סעפּעראַטלי פֿון דעם געבן / דיסייבאַל פונקציע (זען סעקשאַנז אויבן).
אָפסעט קאַלאַבריישאַן
סאַדערינג די מיטל אויף די קונה ברעט אָדער אַדינג אַ דעקן גלאז קענען באַקענען אַ פאָטאָ אין די ריינדזשינג ווייַטקייט. דעם טייל-צו-טייל פאָטאָ מוזן זיין געמאסטן בעשאַס די פאָטאָ קאַלאַבריישאַן. אָפסעט קאַלאַבריישאַן אויך אַלאַוז צו קאַלאַברירן די דמאַקס ווערט, ניצן די זעלבע קאַלאַבריישאַן טנאָים ווי די אָפסעט קאַלאַבריישאַן.
אָפסעט קאַלאַבריישאַן פאַנגקשאַנז
די פאלגענדע צוויי פאַנגקשאַנז זענען בארעכטיגט פֿאַר די אָפסעט קאַלאַבריישאַן:
- VL53LX_PerformOffsetSimpleCalibration (דעוו, קאַלדיסטאַנסע מיללימעטער)
- VL53LX_PerformOffsetPerVCSEL קאַליבראַטיאָן (דעוו, קאַלדיסטאַנסע מיללימעטער)
דער אַרגומענט פון די פאַנגקשאַנז איז די ציל דיסטאַנסע אין מילאַמיטערז. אָפסעט קאַלאַבריישאַן מוזן זיין דורכגעקאָכט נאָך קראָססטאַלק קערעקשאַן.
VL53LX_PerformOffsetPerVCSELCalibration איז די מערסט פּינטלעך פֿונקציע, אָבער עס נעמט מער צו דורכפירן די קאַלאַבריישאַן (צייט געמערט מיט 3).
אָפסעט קאַלאַבריישאַן פּראָצעדור
קוסטאָמערס קענען אויסקלייַבן קיין טשאַרט רעפלעקטיוואַנס געשטעלט אין קיין דיסטאַנסע (ניצן די זעלבע סעטאַפּ ווי די קראָססטאַלק קאַלאַבריישאַן). דער בלויז פונט צו קאָנטראָלירן איז צו ענשור אַז די סיגנאַל קורס איז געמאסטן צווישן 2 און 80 מקפּס מיט די אויסדערוויילטע סעטאַפּ.
טיש 3. פאָטאָ קאַלאַבריישאַן סעטאַפּ
| טשאַרט | דיסטאַנסע | אַמביאַנט טנאָים | סיגנאַל קורס |
| קיין | קיין | טונקל (קיין IR צושטייַער) | 2 מקפּס < סיגנאַל קורס <80 מקפּס |
צוויי ווארענונג אַרטיקלען זענען אומגעקערט דורך די פאַנגקשאַנז:
- VL53LX_WARNING_OFFSET_CAL_INSUFFICIENT_MM1_SP DS דער סיגנאַל איז צו נידעריק, די אַקיעראַסי פון פאָטאָ קאַלאַבריישאַן קען זיין דיגריידיד.
- VL53LX_WARNING_OFFSET_CAL_PRE_RANGE_RATE_TOO_H גה סיגנאַל איז צו הויך. די אַקיעראַסי פון אָפסעט קאַלאַבריישאַן קען זיין דיגריידיד.
באַקומען אָפסעט קאַלאַבריישאַן רעזולטאַטן
די פֿונקציע 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
די קוילעלדיק אָפסעט געווענדט צו די מיטל איז די דורכשניטלעך פון די צוויי לעצטע וואַלועס. אויב אַ פּערVCSELCalibration איז אויסגעקליבן, דער רעזולטאַט פון די פֿונקציע כולל די פאלגענדע דאַטן:
- short_a_offset_mm
- short_b_offset_mm
- מיטל_אַ_אָפסעט_מם
- מיטל_ב_אָפסעט_מם
- long_a_offset_mm
- long_bb_offset_mm
דעפּענדינג אויף די דיסטאַנסע מאָדע (VCSEL פּעריאָד) אויסדערוויילט, איינער פון די אָפסעץ איז אויטאָמאַטיש געווענדט.
סעלעקטינג די פאָטאָ קערעקשאַן מאָדע
די פאָטאָ קערעקשאַן מאָדע קענען זיין באַשטימט מיט צוויי אָפּציעס, ניצן די VL53LX_SetOffsetCorrectionMode פונקציע.
באַמערקונג: VL53LX_OFFSETCORRECTIONMODE_PERVCSEL זאָל זיין געוויינט דורך פעליקייַט. עס אַלאַוז צו פאַרגרעסערן די אָפסעט אַקיעראַסי פּער VCSEL פּעריאָד.
טיש 4. פאָטאָ קערעקשאַן אָפּציעס
| פאָטאָ קאַלאַבריישאַן פֿונקציע גערופן | קערעקשאַן מאָדע אָפּציע צו זיין געוויינט |
| PerformSimpleOffsetCalibration | VL53LX_OFFSETCORRECTIONMODE_STANDARD |
| PerformPerVCSELOffsetCalibration | VL53LX_OFFSETCORRECTIONMODE_PERVCSEL |
באַמערקונג: אויב בלויז איין אָפסעט קאַלאַבריישאַן טיפּ איז בנימצא, עס איז מאַנדאַטאָרי צו שטעלן די אָפסעט קערעקשאַן מאָדע צו די קאָראַספּאַנדינג אָפּציע. דאָס איז נישט אויטאָמאַטיש געטאן.
באַשטעטיקן פאָטאָ קאַלאַבריישאַן דאַטן
דער קונה קענען לאָדן די פאָטאָ קאַלאַבריישאַן דאַטן נאָך די VL53LX_DataInit () פֿונקציע איז גערופֿן, מיט VL53LX_SetCalibrationData ().
עס איז בעסער צו רופן VL53LX_GetCalibrationData (), מאָדיפיצירן די פּאַראַמעטערס דיסקרייבד אין די פריערדיקע סעקשאַנז, און רופן VL53LX_SetCalibrationData ()
קונה פאַרריכטן קראָם קאַלאַבריישאַנז
אין פאַל די קאַלאַבריישאַן וואַלועס זענען פאַרפאַלן, רעכט צו קאָמפּאָנענט ענדערונג אין אַ פאַרריכטן קראָם, דער קונה קענען צולייגן אַ דעדאַקייטאַד פּראָצעדור, ווו קיין ספּעציפיש סעטאַפּ (טאַרגאַץ) זענען דארף.
די קאַלאַבריישאַן איז קאַמפּאָוזד פון דרייַ סטעפּס:
- RefSpad
- קראָססטאַלק
- אָפסעט קאַלאַבריישאַנז
RefSpad און Xtalk זענען די זעלבע ווי דיסקרייבד אין אָפּטיילונג 6.1 רעפספּאַד קאַלאַבריישאַן און אָפּטיילונג 6.2 קראָסטאַלק קאַלאַבריישאַן.
א דעדאַקייטאַד פונקציע איז בארעכטיגט צו דורכפירן פאָטאָ קאַלאַבריישאַן: VL53LX_PerformOffsetZeroDistanceCalibration.
א ציל האט צו זיין שטעלן אין פראָנט פון די מיטל, רירנדיק די דעקן גלאז. דער ציל קענען זיין אַ פּשוט בלאַט פון פּאַפּיר (מיט קיין באַזונדער נויט פֿאַר די פּאַפּיר רעפלעקטאַנס).
די אויבן פונקציע מוזן זיין גערופֿן און די רעזולטאַטן קענען זיין ריטריווד ענלעך צו דעם פּראָצעס דיסקרייבד אין די פריערדיקע סעקשאַנז.
בלויז שאָפער ערראָרס און וואָרנינגז
א שאָפער טעות איז געמאלדן ווען קיין שאָפער פֿונקציע איז גערופן. מעגלעך וואַלועס פֿאַר שאָפער ערראָרס זענען דיסקרייבד אין די פאלגענדע טיש. וואָרנינגז זענען דאָרט צו מיטטיילן די באַניצער אַז עטלעכע פּאַראַמעטערס זענען נישט אָפּטימיזעד. די וואָרנינגז זענען נישט בלאַקינג פֿאַר דער באַלעבאָס.
טיש 5. נאַקעט שאָפער ערראָרס און וואָרנינגז באַשרייַבונג
| טעות ווערט | אַפּי טעות שטריקל | פּאַסירונג |
| 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 | קיין מצליח סamples ווען ניצן די פול מענגע צו sampדי קראָססטאַלק. אין דעם פאַל עס איז נישט גענוג אינפֿאָרמאַציע צו דזשענערייט נייַ קראָסטאַלק ווערט. די פֿונקציע וועט אַרויסגאַנג און לאָזן די קראַנט קראָססטאַלק פּאַראַמעטערס אַנאָלטערד |
| -23 | VL53LX_ERROR_XTALK_EXTRACTION_SIGMA_L IMIT_FAIL | די דורכשניטלעך סיגמאַ אָפּשאַצונג פון די קראָססטאַלק סample איז > ווי די מאַקסימום ערלויבט. אין דעם פאַל, די קראָססטאַלק סampעס איז אויך טומלדיק פֿאַר מעזשערמאַנט. די פֿונקציע וועט אַרויסגאַנג און לאָזן די קראַנט קראָססטאַלק פּאַראַמעטערס אַנאָלטערד |
| -24 | VL53LX_ERROR_OFFSET_CAL_NO_SAMPLE_FA IL | א טעות איז פארגעקומען בעשאַס אָפסעט קאַלאַבריישאַן. קאָנטראָלירן די סעטאַפּ איז אין לויט מיט ST רעקאַמאַנדיישאַנז. |
| -25 | VL53LX_ERROR_OFFSET_CAL_NO_SPADS_ENA BLED_FAIL | |
| -28 | VL53LX_WARNING_REF_SPAD_CHAR_NOT_EN OUGH_SPADS | ווארענונג: נומער פון ספּאַדס געפֿונען איז צו נידעריק צו באַקומען פּינטלעך קאַלאַבריישאַן פון refSpadManagement. פאַרזיכערן די סעטאַפּ איז אין לויט מיט ST רעקאַמאַנדיישאַנז. |
| -29 | וול53LX_WARNING_REF_SPAD_CHAR_RATE_TO O_HIGH | ווארענונג: סיגנאַל קורס איז געפֿונען צו נידעריק צו באַקומען פּינטלעך קאַלאַבריישאַן פון רעפספּאַדמאַנאַגעמענט. פאַרזיכערן די סעטאַפּ איז אין לויט מיט ST רעקאַמאַנדיישאַנז. |
| -30 | וול53LX_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_ HIGH | |
| -33 | VL53LX_WARNING_OFFSET_CAL_RATE_TOO_HI GH | |
| -34 | VL53LX_WARNING_OFFSET_CAL_SPAD_COUNT_TOO_LOW | |
| -38 | VL53LX_WARNING_XTALK_MISSING_SAMPLES | ווארענונג פארגעקומען בעשאַס קראָססטאַלק קאַלאַבריישאַן. פאַרזיכערן די סעטאַפּ איז אין לויט מיט 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 פּראָדוקטן און / אָדער דעם דאָקומענט אין קיין צייט אָן באַמערקן. פּערטשאַסערז זאָל באַקומען די לעצטע באַטייַטיק אינפֿאָרמאַציע אויף ST פּראָדוקטן איידער פּלייסינג אָרדערס. ST פּראָדוקטן זענען סאָלד לויט צו ST ס טערמינען און באדינגונגען פון פאַרקויף אין דער צייט פון דער דערקענטעניש פון סדר.
פּערטשאַסערז זענען בלויז פאַראַנטוואָרטלעך פֿאַר די ברירה, סעלעקציע און נוצן פון ST פּראָדוקטן און ST אַסומז קיין אַכרייַעס פֿאַר אַפּלאַקיישאַן הילף אָדער די פּלאַן פון פּערטשאַסערז פּראָדוקטן.
קיין דערלויבעניש, אויסדריקן אָדער ימפּלייד, צו קיין אינטעלעקטואַל פאַרמאָג רעכט איז דערלויבט דורך ST.
ריסייל פון ST פּראָדוקטן מיט פּראַוויזשאַנז אַנדערש פון די אינפֿאָרמאַציע געשטעלט דאָ וועט פּאָסל קיין וואָראַנטי געגעבן דורך ST פֿאַר אַזאַ פּראָדוקט. ST און די ST לאָגאָ זענען טריידמאַרקס פון ST. פֿאַר נאָך אינפֿאָרמאַציע וועגן ST טריידמאַרקס, אָפּשיקן צו www.st.com/trademarks. אַלע אנדערע פּראָדוקט אָדער דינסט נעמען זענען די פאַרמאָג פון זייער ריספּעקטיוו אָונערז.
אינפֿאָרמאַציע אין דעם דאָקומענט סאַפערז און ריפּלייסיז אינפֿאָרמאַציע ביז אַהער סאַפּלייד אין קיין פריערדיקע ווערסיעס פון דעם דאָקומענט. © 2022 STMicroelectronics - כל רעכט רעזערווירט
דאָקומענטן / רעסאָורסעס
 |
ST VL53L3CX צייט פון פלי ריינדזשינג סענסאָר [pdfבאַניצער מאַנואַל VL53L3CX צייט פון פלי ריינדזשינג סענסאָר, VL53L3CX, צייט פון פלי ריינדזשינג סענסאָר, פלי ריינדזשינג סענסאָר, ריינדזשינג סענסאָר |
