Data Sheet

Ranging API function descriptions UM2356
16/28 DocID031478 Rev 1
2.5.9 VDDIO configuration
As described in the datasheet, the user can select two modes for a VDDIO value of 1V8 or
2V8 modes.
The selection of the mode is made directly in the code though a compilation key called
USE_I2C_2V8k.
If this compilation key is defined, the system will go into 2V8 mode, otherwise, it will be kept
in the default 1V8 mode.
2.6 RangingMeasurementData structure
The VL53L1_RangingMeasurementData_t structure is composed of:
• TimeStamp: not implemented, please ignore it.
• StreamCount: this 8-bit integer counter increments at each range. The value starts at
0, increments to 255, and then increments from 128 to 255.
• RangingQualityLevel: not implemented, please ignore it.
• SignalRateRtnMegaCps: this value is the return signal rate in MegaCountPer Second
(MCPS). It is a 16.16 fix point value.To obtain a real value it should be divided by
65536.
• AmbientRateRtnMegaCps: this value is the return ambient rate (in MCPS). It is a
16.16 fix point value, which is effectively a measure of the infrared light. To obtain a real
value it should be divided by 65536.
• EffectiveSpadRtnCount: this 16 bit integer returns the effective SPAD count for the
current ranging. To obtain a real value it should be divided by 256.
• SigmaMilliMeter: this 16.16 fix point value is an estimation of the standard deviation of
the current ranging, expressed in millimeters. To obtain a real value it should be divided
by 65536.
• RangeMilliMeter: this 16 bit integer give the range distance in millimeters.
• RangeFractionalPart: not implemented, please ignore it.
• RangeStatus: this 8 bit integer gives the range status for the current measurement. A
value of 0 means the ranging is valid (refer to Table 4).