ST VL53L3CX පියාසැරි පරාසයක සංවේදක පරිශීලක අත්පොත වේලාව

VL53L3CX යනු ගුවන් ගමන් කාලය (ToF) පරාසයක සංවේදක මොඩියුලයකි.
මෙම පරිශීලක අත්පොතෙහි අරමුණ වන්නේ VL53L3CX හිස් ධාවක භාවිතයෙන් පරාසයක දත්ත ලබා ගැනීම සඳහා ඒකාබද්ධ කිරීමේ ආකෘතිය සහ ඇමතීමට අවශ්‍ය කාර්යයන් සමූහය විස්තර කිරීමයි.

VL53L3CX පද්ධතිය අවසන්view

VL53L3CX පද්ධතිය VL53L3CX මොඩියුලයෙන් සහ ධාරකය මත ධාවනය වන ධාවකයකින් සමන්විත වේ.
මෙම ලේඛනය මඟින් ධාරකයට ප්‍රවේශ විය හැකි ධාවක ක්‍රියාකාරකම් විස්තර කරයි, උපාංගය පාලනය කිරීමට සහ ලිනක්ස් නොවන ධාරක සමඟ ඒකාබද්ධ කිරීම සඳහා පරාසයක දත්ත ලබා ගනී.

රූපය 1. VL53L3CX පද්ධතිය

සටහන:
වත්මන් ලේඛනය ක්රියාත්මක කරන ලද සහ වලංගු කාර්යයන් විස්තර කරයි. මෙම ලේඛනයේ විස්තර කර නොමැති නම් ධාවකවල ඇති වෙනත් කාර්යයක් භාවිතා නොකළ යුතුය.
හිස් ධාවකය යනු VL53L3CX උපාංගය භාවිතා කිරීමට අවශ්‍ය ශ්‍රිත සමූහයක් ක්‍රියාත්මක කිරීමකි. එය OS ඒකාබද්ධ කිරීම සහ සේවාවන් පිළිබඳ අවම උපකල්පන කරයි. එනිසා, ක්‍රියා අනුපිළිවෙල, ක්‍රියාත්මක කිරීම/නූල් දැමීමේ ආකෘතිය, වේදිකා අනුවර්තනය සහ උපාංග ව්‍යුහයන් වෙන් කිරීම හිස් ධාවක ක්‍රියාත්මක කිරීමේ කොටසක් නොවන නමුත් අනුකලනය වෙත විවෘතව පවතී.
හිස් ධාවක ඇමතුම් අනුපිළිවෙල මෙම ලේඛනයේ අර්ථ දක්වා ඇති නීති මාලාවක් අනුගමනය කළ යුතුය.

පරාසයක ක්රියාකාරී විස්තරය

මෙම කොටස VL53L3CX පරාසයක උපාංගයේ ක්‍රියාකාරී හැකියාවන් කෙටියෙන් විස්තර කරයි.

පරාසයක අනුපිළිවෙල

උපාංගය සම්මත බාධා කළමණාකරණ යෝජනා ක්‍රමයක් මත පදනම්ව, අතට අත දීමේ යාන්ත්‍රණයක් සමඟින් ක්‍රියාත්මක වේ.
එක් එක් පරාසයෙන් පසුව, ධාරකය පරාස දත්ත ලබා ගන්නා අතර බාධා ඉවත් කිරීමෙන් ඊළඟ පරාසය සක්‍රීය කරයි. මෙම ක්‍රියාවලිය හෑන්ඩ්ෂේක් යාන්ත්‍රණය ලෙස හැඳින්වේ. වත්මන් එක අවසන් නම් සහ ධාරකය පෙර පොරොත්තු බාධා ඉවත් කර ඇත්නම් ඊළඟ පරාසය ක්‍රියාරම්භක වේ.
බාධා කිරීම් යාන්ත්‍රණය සන්නිවේදනය හෝ අසමමුහුර්තතා ගැටළු හේතුවෙන් කිසිදු පරාසයක අගයක් අහිමි නොවී වේගවත් දත්ත හුවමාරුවකට ඉඩ සලසයි. අතට අත දීමේ අදියරේදී, ධාරකය යම් දත්ත සැකසුම් සිදු කරයි. පරාස අනුපිළිවෙල පහත රූපයේ ක්රියාකාරී ලෙස විස්තර කර ඇත.

අතට අත දීමේ අනුපිළිවෙල අභ්‍යන්තර පරාමිතීන් ගණනය කිරීමට සහ ඊළඟ පරාසය සඳහා ඒවා යෙදීමට ඉඩ සලසයි.
හිස් ධාවකය භාවිතා කරන්නා විසින් අතට අත දීම සිදු කළ යුතුය. නව මිණුමක් ලැබුණු පසු නව පරාසයක් සක්‍රීය කිරීමට ප්‍රමාද වීම සමස්ත පද්ධති මිනුම් අනුපාතයට ප්‍රධාන වේ.

කාල ගණනය කිරීම්

කාලසටහන් ඉදිරිපත් කර ඇත රූප සටහන 3 හි. අනුපිළිවෙල සහ කාල ඉලක්ක පරාසය.
වත්මන් පරාසයේ කාලසීමාව (කාල අයවැය පරාසය) තුළ ධාරකයට ලබා ගත හැකි නවතම පරාසය ලබා ගත හැක.
ධාරකය විසින් බාධා ඉවත් කිරීමට ප්‍රමාදයක් හඳුන්වා දෙන්නේ නම්, අපේක්ෂිත බාධාව ඉවත් කරන තෙක් ඊළඟ පරාසය ඇණහිට ඇත.

සටහන: කාල සටහන් පෙන්වා ඇත රූප සටහන 3 හි. පරාසයක අනුක්‍රමය සහ කාල ඉලක්ක සාමාන්‍ය වේලාවන් වේ. 5.1 කොටසේ කාල අයවැයේ විස්තර කර ඇති කැපවූ ධාවක ශ්‍රිතයක් භාවිතා කිරීමෙන් සත්කාරකයාට පෙරනිමි කාල අයවැය වෙනස් කළ හැක. යෙදුමේ සමමුහුර්ත කිරීමට හෝ පරාසයේ නිරවද්‍යතාවය වැඩි කිරීමට කාල අයවැය වෙනස් කිරීමට සත්කාරක සමාගමට තීරණය කළ හැක.
පහත රූපයේ, "Boot", "SW standby" සහ "Init" ms 40 ක් පවතී. උපාංගයේ නිවැරදි ආරම්භයක් සිදු කිරීම සඳහා මෙම කාලය අවශ්ය වන අතර, එය වේදිකාවෙන් හෝ භාවිතා කරන ලද කාල අයවැයෙන් ස්වාධීන වේ. පළමු පරාසය, "Range1", වලංගු නොවේ, එතීමේ චෙක්පත කළ නොහැක. මෙයින් අදහස් වන්නේ පළමු වලංගු පරාස අගය "Range2" වන අතර, ms 40 ට පසුව සහ කාල අයවැය කාලසීමාව මෙන් දෙගුණයකින් පසුව ලබා ගත හැකි බවයි.

රූපය 3. අනුපිළිවෙල සහ කාල ඉලක්ක පරාසය

හිස් රියදුරු මූලික කාර්යයන් විස්තරය

මෙම කොටස පරාසයක මිනුමක් සිදු කිරීම සඳහා අනුගමනය කළ යුතු ධාවක ශ්‍රිත ඇමතුම් ප්‍රවාහය විස්තර කරයි
VL53L3CX භාවිතා කරමින්.
VL53L3CX ධාවකය යෙදුම් පන්ති දෙකක භාවිතා වේ:

උපාංග ක්‍රමාංකනය සඳහා භාවිතා කරන කර්මාන්තශාලා යෙදුම්, සාමාන්‍යයෙන් අවසාන නිෂ්පාදන නිෂ්පාදන පරීක්ෂණයේදී (කර්මාන්තශාලා ප්‍රවාහය)

ක්ෂේත්‍ර යෙදුම්, VL53L3CX උපාංගය (පරාසගත ප්‍රවාහය) භාවිතයෙන් සියලුම අවසාන පරිශීලක යෙදුම් එකතු කරයි

හිස් රියදුරු

හිස් රියදුරු කර්මාන්තශාලා ප්රවාහය පහත රූපයේ දැක්වේ.

රූපය 4. VL53L3CX API පරාසයක ගලායාම (කර්මාන්තශාලාව)

සටහන: ක්රමාංකන ප්රවාහය දුර ප්රකාරය වෙනස් කරයි. ඔබට ක්‍රමාංකනය කිරීමෙන් පසුව සංවේදකය භාවිතා කිරීමට අවශ්‍ය නම් SetDistanceMode() ශ්‍රිතය ඇමතීම අනිවාර්ය වේ.
හිස් ධාවක පරාසයේ ගලායාම පහත රූපයේ දැක්වේ.

රූපය 5. VL53L3CX API පරාසයක ගලායාම (ක්ෂේත්‍රය)

පද්ධතිය ආරම්භ කිරීම

මිනුම් ආරම්භ කිරීමට පෙර, පද්ධතිය ආරම්භ කිරීම සිදු කිරීමට අවශ්‍ය API ශ්‍රිත ඇමතුම් පහත කොටස පෙන්වයි.

ආරම්භය සඳහා රැඳී සිටින්න

VL53LX_WaitDeviceBooted() ශ්‍රිතය මඟින් උපාංගය ආරම්භ කර සූදානම් බව සහතික කරයි. මෙම කාර්යය ඇමතීම අනිවාර්ය නොවේ.

සටහන: මෙම ශ්‍රිතය ධාරක ක්‍රියාත්මක කිරීම අවහිර කරයි. උපකල්පනය කරමින් මෙම ශ්‍රිතය 4 ms ට වඩා අවහිර නොවිය යුතුය:

400 kHz I2C සංඛ්‍යාතය
ගනුදෙනුවකට 2 ms ප්‍රමාදය

දත්ත ආරම්භය

VL53LX_DataInit() ශ්‍රිතය උපාංගය "ආරම්භක ඇරඹුම්" තත්වයෙන් පිටවන සෑම අවස්ථාවකම ඇමතීමට සිදුවේ. එය උපාංගය ආරම්භ කිරීම සිදු කරයි. VL53LX_DataInit() ශ්‍රිතය ඇමතීමෙන් පසු VL53LX_SetCalibrationData() ශ්‍රිතය භාවිතයෙන් ක්‍රමාංකන දත්ත පූරණය කළ යුතුය.

VL53L3CX සමඟ පරාසයක පවතී

Linux නොවන ධාරක වලදී, හිස් ධාවක අනුපිළිවෙල භාවිතා කරන්නා යෙදුම් අවශ්‍යතා, වේදිකා හැකියාවන් සහ හිස් ධාවක ඇමතුම් අනුපිළිවෙල නීති වලට ගැලපෙන ආකාරයෙන් රියදුරුට ඇමතුම් ලබා දෙයි.

මිනුම් ආරම්භ කරන්න

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-bit නිඛිල අගය.

ඵලදායී Spad Rtn ගණන: වත්මන් පරාසය සඳහා ඵලදායි තනි ෆෝටෝන avalanche diode (SPAD) ගණන ආපසු ලබා දෙන 16-bit පූර්ණ සංඛ්‍යාව. සැබෑ අගය ලබා ගැනීම සඳහා එය 256 න් බෙදිය යුතුය.

අනාවරණය කරගත් එක් එක් ඉලක්කය සඳහා පහත සඳහන් නිශ්චිත ප්‍රතිඵල අඩංගු VL4LX_TargetRangeData_t ලෙස හඳුන්වන ඉලක්කයකට එක් ව්‍යුහයක් (පෙරනිමියෙන් 53 දක්වා) අනාවරණය කර ඇත.

RangeMaxMillimeter: 16-bit නිඛිලයක් වන අතර, විශාල අනාවරණය කරගත් දුර පෙන්නුම් කරයි.
RangeMinMilliMeter: 16-බිට් නිඛිලයක් වන අතර එය කුඩා අනාවරණය වූ දුර පෙන්නුම් කරයි.
SignalRateRtnMegaCps: මෙම අගය MegaCountPer Second (MCPS) හි ප්‍රතිලාභ සංඥා අනුපාතය වේ, මෙය 16.16 fix point අගයකි. සැබෑ අගය ලබා ගැනීමට එය 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 වෙත බල කෙරේ.
RangeMilliMeter: 8191 වෙත බලකෙරිණි.
පරාස තත්ත්‍වය: 255ට බල කෙරේ.
විස්තීරණ පරාසය: 0 ට බල කෙරේ.

වගුව 1. පරාසයේ තත්ත්වය

වටිනාකම	RangeStatus String	අදහස් දක්වන්න
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 වෙත සැකසීමට: තත්ත්වය = 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. එක්කෝ මේකේ tuning parameter value එකක් වෙනස් කරන්න 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 ට වඩා වැඩි නම්), නව හරස්කඩ අගයක් ගණනය කෙරේ.
smudge නිවැරදි කිරීම සකසා ඇත්නම්, crosstalk අගය නිවැරදි කර HasXtalkValueChanged ධජය සකසා ඇත. මෙම ධජය ඊළඟ පරාසයේදී ස්වයංක්‍රීයව නිෂ්කාශනය වේ.

සටහන: මඩ නිවැරදි කිරීම සීමා වන්නේ:

කෙටි දුර මාදිලිය භාවිතා කරමින් මීටර් 1.2 කි
මධ්යම දුර මාදිලිය භාවිතා කරමින් 1.7 m
දිගු දුර මාදිලිය භාවිතා කරමින් මීටර් 3.8 කි.

I2C ලිපිනය

VL2L53CX හි පෙරනිමි I3C ලිපිනය 0x52 වේ. සමහර යෙදුම් වලට වෙනස් I2C උපාංග ලිපිනයක් සැකසීමට අවශ්‍ය වේ. උදාහරණයක් ලෙස, මෙය මෙයයිample, VL53L3CX කොටස් කිහිපයක් එකම I2C බසය බෙදා ගන්නා විට.

පාරිභෝගිකයා පහත ක්‍රියා පටිපාටිය යෙදිය යුතුය:

VL53L3CX සවිකරන පුවරුව ප්රවේශමෙන් සැලසුම් කළ යුතුය. එක් එක් VL1L53CX සඳහා Xshut සහ GPIO3 (බාධා කිරීම්) කටු තනි තනිව පාලනය කළ යුතුය.
ධාරකයට HW Standby තුළ තැබිය යුතු අතර, Xshut පින් එක අඩුවෙන් සකසා, සියලුම VL53L3CX.

ධාරකය VL1L53CX හි 3 හි Xshut පින් එක ඔසවයි
ධාරක ශ්‍රිතය VL53LX_SetDeviceAddress() ලෙස හඳුන්වයි
සියලුම VL53L3CX ලිපින නිවැරදිව සකසා ඇති බැවින් ධාරකය අවසාන කරුණු තුන නැවත සිදු කරයි.

උදාහරණයක් ලෙසample, ශ්‍රිතය ඇමතීමෙන්: තත්වය = VL53LX_SetDeviceAddress(&VL53L3Dev, WantedAddress) WantedAddress හි අගය නව I2C ලිපිනය ලෙස සකසා ඇත.

පාරිභෝගික කර්මාන්තශාලා ක්රමාංකන කාර්යයන්

උපාංගයේ සම්පූර්ණ ක්‍රියාකාරීත්වයේ ප්‍රයෝජනය සඳහා, VL53L3CX ධාවකය පාරිභෝගික නිෂ්පාදන රේඛාවේදී එක් වරක් ක්‍රමාංකනය කළ යුතු ක්‍රමාංකන කාර්යයන් ඇතුළත් කරයි.
උපාංග ක්‍රියාකාරීත්වයට බලපෑ හැකි කොටසින් කොටස පරාමිතිවලට වන්දි ගෙවීමට ක්‍රමාංකන ක්‍රියා පටිපාටි ක්‍රියාත්මක කළ යුතුය. ධාරකයේ ගබඩා කර ඇති ක්‍රමාංකන දත්ත එක් එක් ආරම්භයේදීම කැපවූ ධාවක ශ්‍රිතයක් භාවිතයෙන් VL53L3CX හි පැටවිය යුතුය. ක්රමාංකන තුනක් අවශ්ය වේ: refSPAD, crosstalk සහ offset.

ක්රමාංකන කාර්යයන් අනුපිළිවෙල පහත පරිදි හැඳින්වේ:

refSPAD
හරස් කතා
ඕෆ්සෙට්

ක්රමාංකන කාර්යයන් තුන අනුක්රමික ආකාරයෙන් හෝ තනි තනිව සිදු කළ හැක. තනි තනිව ධාවනය කරන විට, ක්‍රමාංකනය ධාවනය කිරීමට පෙර පෙර පියවර දත්ත පූරණය කළ යුතුය.

RefSPAD ක්රමාංකනය

ST හි අවසාන මොඩියුල පරීක්ෂණයේදී තනි ෆෝටෝන අවලාන්ච් ඩයෝඩ (SPAD) ගණන ක්‍රමාංකනය කෙරේ. මෙම කොටසින් කොටස අගය NVM හි ගබඩා කර ඇති අතර ආරම්භයේදී ස්වයංක්‍රීයව උපාංගය තුළ පටවනු ලැබේ.
මෙම ක්‍රමාංකනය මඟින් උපාංග ගතිකත්වය ප්‍රශස්ත කිරීම සඳහා SPAD ගණන සීරුමාරු කිරීමට ඉඩ ලබා දේ.
කෙසේ වෙතත්, මොඩියුලයට ඉහලින් ආවරණ වීදුරුවක් එකතු කිරීම මෙම ක්රමාංකනයට බලපෑ හැකිය. අවසාන නිෂ්පාදන යෙදුමේදී පාරිභෝගිකයා මෙම ක්‍රමාංකනය නැවත සිදු කරන ලෙස ST නිර්දේශ කරයි. FMT හි ධාවනය වන ඇල්ගොරිතම මෙම ශ්‍රිතය හැඳින්වූ විට යෙදේ: ඇල්ගොරිතම ස්ථාන තුනක් හරහා සෙවුම් කරයි: 1 (1x දුර්වල වූ SPADs), 2 (5 x දුර්වල වූ SPADs) සහ 3 (10 x දුර්වල වූ SPADs). තෝරාගත් SPAD ගණන සංඥා සන්තෘප්තිය වළක්වා ගැනීමට සිදු කෙරේ.

RefSPAD ක්රමාංකන කාර්යය

SPAD ක්‍රමාංකනය සඳහා පහත ශ්‍රිතය පවතී: VL53LX_PerformRefSpadManagement(VL53LX_DEV Dev)

සටහන: ක්රමාංකන ක්රියාපටිපාටිය තුළ මෙම කාර්යය මුලින්ම හැඳින්විය යුතුය.

ශ්‍රිතයට පහත අනතුරු ඇඟවීමේ පණිවිඩ තුනක් ප්‍රතිදානය කළ හැක:

VL53LX_WARNING_REF_SPAD_CHAR_NOT_ENOUGH_SPA S හොඳ SPAD 5කට වඩා අඩුවෙන් ඇත, ප්‍රතිදානය වලංගු නොවේ
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 වල පිහිටීම ලබා දෙයි.
අමතර පරාමිති හයක් තෝරාගත් ස්ථානය සඳහා නිවැරදි ස්පෑඩ් සිතියම් ලබා දෙයි:
- ගෝලීය_config__spad_enables_ref_0
- ගෝලීය_config__spad_enables_ref_1
- ගෝලීය_config__spad_enables_ref_2
- ගෝලීය_config__spad_enables_ref_3
- ගෝලීය_config__spad_enables_ref_4
- ගෝලීය_config__spad_enables_ref_5

refSPAD ක්රමාංකන දත්ත සැකසීම

සෑම ආරම්භයේදීම, ආරම්භක ඇරඹුමකින් පසුව, පාරිභෝගික ක්ෂේත්‍ර යෙදුමට VL53LX_SetCalibrationData() භාවිතා කිරීමෙන් VL53LX_DataInit() ශ්‍රිතය ඇමතීමෙන් පසුව refSPAD ක්‍රමාංකන දත්ත පූරණය කළ හැක.
VL53LX_GetCalibrationData() ඇමතීමෙන් සම්පූර්ණ ක්‍රමාංකන ව්‍යුහය ලබා ගැනීම නිර්දේශ කෙරේ. refSPAD ක්‍රමාංකන ප්‍රතිඵල ලබා ගැනීම 6.1.3 වගන්තියේ විස්තර කර ඇති පරාමිති අට වෙනස් කර VL53LX_SetCalibrationData() අමතන්න.

Crosstalk ක්රමාංකනය

Crosstalk (XTalk) යනු සෞන්දර්යාත්මක හේතූන් මත මොඩියුලයට ඉහළින් එකතු කරන ලද ආරක්ෂිත කවුළුව (ආවරණ වීදුරු) ඇතුළත VCSEL ආලෝක පරාවර්තනය හේතුවෙන් ආපසු එන අරාව මත ලැබෙන සංඥා ප්‍රමාණය ලෙස අර්ථ දැක්වේ.
ආවරණ වීදුරුවේ ගුණාත්මක භාවය අනුව, මෙම පරපෝෂිත සංඥා උපාංගයේ කාර්ය සාධනයට බලපෑ හැකිය. VL53L3CX හි මෙම ගැටලුවට වන්දි ලබා දෙන නිවැරදි කිරීමක් ඇත.
මොඩියුලයට ඉහලින් එකතු කරන ලද ආවරණ වීදුරුවක බලපෑමට වන්දි ගෙවීමට අවශ්‍ය නිවැරදි කිරීම් ප්‍රමාණය තක්සේරු කිරීමට Crosstalk ක්රමාංකනය භාවිතා කරයි.
6.2.3 වගන්තියේ විස්තර කර ඇති පරිදි ක්‍රොස්ටෝක් ක්‍රමාංකනයේ ප්‍රතිදානයේ ක්‍රොස්ටෝක් ක්‍රමාංකන ප්‍රතිඵල ලබා ගැනීමේ ක්‍රොස්ටෝක් ආකෘතිය නිර්වචනය කරන බොහෝ පරාමිති අඩංගු වේ.

Crosstalk ක්රමාංකන කාර්යය

Crosstalk ක්‍රමාංකනය සඳහා පහත කැපවූ ශ්‍රිතය පවතී: VL53LX_PerformXTalkCalibration(&VL53L3Dev);

සටහන: මෙම ශ්‍රිතය refSPAD ක්‍රමාංකනය සිදු කිරීමෙන් පසුව සහ ඕෆ්සෙට් ක්‍රමාංකනයට පෙර ක්‍රමාංකන ක්‍රියාපටිපාටියේ දෙවන ස්ථානයෙන් හැඳින්විය යුතුය.

Crosstalk ක්රමාංකන ක්රියා පටිපාටිය

ක්‍රොස්ටෝක් ක්‍රමාංකනය සිදු කිරීම සඳහා, උපාංගයෙන් 600mm දුරින් ඉලක්කයක් තැබිය යුතුය. Crosstalk ක්රමාංකනය IR දායකත්වයක් නොමැතිව අඳුරු පරිසරයක සිදු කළ යුතුය. VL53LX_DataInit() සහ VL53LX_PerformRefSpadManagement() ශ්‍රිතයන් ඇමතීමෙන් පසුව, කැපවූ ක්‍රමාංකන ශ්‍රිතය ඇමතීමට සිදුවේ, භාවිතා කරමින්: VL53LX_PerformXTalkCalibration(&VL53L3Dev). මෙම කාර්යයන් හැඳින්වූ විට, ක්‍රොස්ටෝක් ක්‍රමාංකනය සිදු කරනු ලබන අතර පෙරනිමියෙන් ක්‍රොස්ටෝක් නිවැරදි කිරීම යොදනු ලැබේ.

Crosstalk ක්රමාංකන ප්රතිඵල ලබා ගැනීම

ක්රමාංකන ප්රතිඵල අනෙකුත් අතර, හිස්ටෝග්රෑම් සහ "ප්ලේන් ඕෆ්සෙට්" යනුවෙන් හැඳින්වෙන පරාමිතියකින් සමන්විත වේ. ප්ලේන් ඕෆ්සෙට් මගින් යොදන ලද නිවැරදි කිරීම් ප්‍රමාණය නියෝජනය වන අතර හිස්ටෝග්‍රෑම් යනු එක් එක් බඳුනේ නිවැරදි කිරීම් නැවත බෙදා හැරීමයි. 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. ඒවා ගබඩා කිරීම අනිවාර්ය වේ.

Crosstalk ක්රමාංකන දත්ත සැකසීම

VL53LX_DataInit() ශ්‍රිතය හැඳින්වූ පසු, පාරිභෝගිකයාට හරස් ටෝක් ක්‍රමාංකන දත්ත පූරණය කළ හැක: VL53LX_SetCalibrationData()
VL53LX_GetCalibrationData() ඇමතීමට වඩා හොඳය, පෙර කොටසේ විස්තර කර ඇති පරාමිති වෙනස් කරන්න, xtalk_histogram ව්‍යුහය ඇතුළත් කර VL53LX_SetCalibrationData() ඇමතීමට.

Crosstalk වන්දි ගෙවීම සබල/අබල කරන්න

VL53LX_SetXTalkCompensationEnable() ශ්‍රිතය හරස්කඩ වන්දිය සක්‍රීය කරයි හෝ අක්‍රීය කරයි.

සටහන: Crosstalk වන්දි ගෙවීම පෙරනිමියෙන් අබල කර ඇත. Crosstalk වන්දිය සබල කිරීමට V53LX_SetXTalkCompensationEnable&VL53L3Dev අමතන්න, 1);
Crosstalk වන්දි අක්‍රිය කිරීමට VL53LX_SetXTalkCompensationEnable&VL53L3Dev, 0) අමතන්න;
සටහන: මෙම ශ්‍රිතය කිසිදු ක්‍රමාංකනයක් හෝ ක්‍රොස්ටෝක් දත්ත පැටවීමක් සිදු නොකරයි, එය සක්‍රීය කරන්නේ වන්දි ගෙවීම පමණි.
සටහන: ක්‍රමාංකනය, හෝ ක්‍රමාංකන දත්ත ශ්‍රිතය පූරණය කිරීම, මෙම සක්‍රීය/අබල කිරීමේ ශ්‍රිතයෙන් වෙන වෙනම ඇමතීමට සිදුවේ (ඉහත කොටස් බලන්න).

ඕෆ්සෙට් ක්රමාංකනය

පාරිභෝගික මණ්ඩලයේ උපාංගය පෑස්සුම් කිරීම හෝ ආවරණ වීදුරුවක් එකතු කිරීම පරාසයක දුරින් ඕෆ්සෙට් එකක් හඳුන්වා දිය හැකිය. මෙම කොටසින් කොටස ඕෆ්සෙට් ක්‍රමාංකනය කිරීමේදී මැනිය යුතුය. ඕෆ්සෙට් ක්‍රමාංකනය මඟින් dmax අගය ක්‍රමාංකනය කිරීමට ඉඩ සලසයි, ඕෆ්සෙට් ක්‍රමාංකනයට වඩා එකම ක්‍රමාංකන කොන්දේසි භාවිතා කරයි.

ඕෆ්සෙට් ක්රමාංකන කාර්යයන්

ඕෆ්සෙට් ක්‍රමාංකනය සඳහා පහත ශ්‍රිත දෙක ඇත:

VL53LX_PerformOffsetSimpleCalibration(Dev, CalDistanceMilliMeter)
VL53LX_PerformOffsetPerVCSELCalibration(Dev, CalDistanceMilliMeter)

ශ්රිතවල තර්කය මිලිමීටර වලින් ඉලක්කගත දුර වේ. ක්‍රොස්ටෝක් නිවැරදි කිරීමෙන් පසු ඕෆ්සෙට් ක්‍රමාංකනය සිදු කළ යුතුය.
VL53LX_PerformOffsetPerVCSELCalibration යනු වඩාත් නිවැරදි කාර්යය වේ, නමුත් එය ක්‍රමාංකනය සිදු කිරීමට වැඩි කාලයක් ගතවේ (කාලය 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

උපාංගයට යොදන සමස්ත ඕෆ්සෙට් අවසාන අගයන් දෙකේ සාමාන්‍යය වේ. perVCSELCalibration එකක් තෝරාගෙන තිබේ නම්, ශ්‍රිතයේ ප්‍රතිදානයට පහත දත්ත ඇතුළත් වේ:

කෙටි_අ_ඕෆ්සෙට්_මි.මී
short_b_offset_mm
මධ්‍යම_අ_ඕෆ්සෙට්_මි.මී
මධ්‍යම_b_offset_mm
දිගු_අ_ඕෆ්සෙට්_මි.මී
දිගු_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() ඇමතීමට වඩා හොඳය.

පාරිභෝගික අලුත්වැඩියා සාප්පු ක්රමාංකන

අළුත්වැඩියා කිරීමේ වෙළඳසැලක සංරචක වෙනස් වීම හේතුවෙන් ක්‍රමාංකන අගයන් නැති වුවහොත්, පාරිභෝගිකයාට විශේෂිත සැකසුම (ඉලක්ක) අවශ්‍ය නොවන විශේෂිත ක්‍රියා පටිපාටියක් යෙදිය හැක.

ක්රමාංකනය පියවර තුනකින් සමන්විත වේ:

RefSpad
Crosstalk
ඕෆ්සෙට් ක්රමාංකන

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 වෙත සම්පූර්ණ අරාව භාවිතා කරන විට lesample the crosstalk. මෙම අවස්ථාවෙහිදී නව හරස්කඩ අගය උත්පාදනය කිරීමට ප්රමාණවත් තොරතුරු නොමැත. ශ්‍රිතය පිටවී වත්මන් හරස්කඩ පරාමිති වෙනස් නොකර තබයි
-23	VL53LX_ERROR_XTALK_EXTRACTION_SIGMA_L IMIT_FAIL	Crosstalk හි සාමාන්‍ය සිග්මා ඇස්තමේන්තුව sample යනු > අවසර දී ඇති උපරිම සීමාවට වඩා. මෙම නඩුවේ හරස්කඩ එස්ample මැනීමට ඝෝෂාකාරී ය. ශ්‍රිතය පිටවී වත්මන් හරස්කඩ පරාමිති වෙනස් නොකර තබයි
-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	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_ 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 STMmicroelectronics – සියලුම හිමිකම් ඇවිරිණි

ලේඛන / සම්පත්

ST VL53L3CX පියාසැරි පරාසයක සංවේදකයේ වේලාව [pdf] පරිශීලක අත්පොත
VL53L3CX පියාසැරි පරාසයක සංවේදකයේ වේලාව, VL53L3CX, පියාසර පරාසයක සංවේදකයේ වේලාව, පියාසර පරාසයක සංවේදකය, පරාසයක සංවේදකය

යොමු කිරීම්

පරිශීලක අත්පොත

හැඳින්වීම