Release Notes for X-CUBE-TOF1
Copyright © 2025 STMicroelectronics
Purpose
The X-CUBE-TOF1 software pack is an expansion for STM32Cube. This software is gathering ranging sensor drivers for VL53L1CB, VL53L3CX, VL53L4CX, VL53L4CD, VL53L4ED, VL53L5CX, VL53L7CX and VL53L8CX running on STM32. It is built on top of STM32Cube software technology that eases portability across different STM32 microcontrollers.
X-CUBE-TOF1 software features:
- Complete software to build applications using VL53L1CB, VL53L3CX, VL53L4CX, VL53L4CD, VL53L4ED, VL53L5CX, VL53L7CX or VL53L8CX
- Easy portability across different MCU families thanks to STM32Cube
- Example implementation available on the board X-NUCLEO-53L1A2, X-NUCLEO-53L3A2, X-NUCLEO-53L4A2, X-NUCLEO-53L4A3, X-NUCLEO-53L4A1, X-NUCLEO-53L5A1, X-NUCLEO-53L7A1 , X-NUCLEO-53L8A1 STM32 expansion boards plugged on top of one NUCLEO-F401RE or NUCLEO-L476RG
Here is the list of references to user documents:
Update history
Main Changes
- Update component drivers VL53L3CX, VL43L4CX, VL53L4CD, VL53L4ED
- Prevent usage of the pack with STM32WB0xx and STM32WL3xx families which are not supported
Product Update
| Headline |
|---|
| components updates |
Contents
The components flagged by “” have changed since the previous release. “” are new.
Drivers
| Name | Version | Release note |
|---|---|---|
| ST32F4xx CMSIS | V2.6.10 | release note URL |
| ST32F4xx HAL | V1.8.3 | release note URL |
| ST32L4xx CMSIS | V1.7.3 | release note URL |
| ST32L4xx HAL | V1.13.4 | release note URL |
| BSP X-NUCLEO-53L1A2 | V1.0.4 | release note URL |
| BSP X-NUCLEO-53L3A2 | V2.0.5 | release note URL |
| BSP X-NUCLEO-53L4A1 | V1.0.4 | release note URL |
| BSP X-NUCLEO-53L4A2 | V1.0.4 | release note URL |
| BSP X-NUCLEO-53L4A3 | V1.0.1 | release note URL |
| BSP X-NUCLEO-53L5A1 | V1.0.7 | release note URL |
| BSP X-NUCLEO-53L7A1 | V1.0.3 | release note URL |
| BSP X-NUCLEO-53L8A1 | V1.0.2 | release note URL |
| BSP Common | V7.3.0 | release note URL |
| BSP Component VL53L1CB | V1.0.5 | release note URL |
| BSP Component VL53L3CX | V2.0.7 | release note URL |
| BSP Component VL53L4CD | V1.0.4 | release note URL |
| BSP Component VL53L4CX | V1.0.5 | release note URL |
| BSP Component VL53L4ED | V1.0.2 | release note URL |
| BSP Component VL53L5CX | V1.0.8 | release note URL |
| BSP Component VL53L7CX | V1.1.0 | release note URL |
| BSP Component VL53L8CX | V1.1.0 | release note URL |
Known Limitations
| Headline |
|---|
| The STM32WB0xx and STM32WL3xx families are not supported in projects generation with the TOF1 pack. |
| The 53L3A2_MultiSensorRanging, 53L4A2_MultiSensorRanging and 53L1A2_MultiSensorRanging sample applications don’t support multi target detection |
| When generating projects for STM32U5, user may encounter compilation errors related to missing BUS_I2C1_SDA_GPIO_PORT and BUS_I2C1_SDA_GPIO_PIN symbols in custom_bus.h. When manually adding BUS_I2C1_SDA_GPIO_PORT and BUS_I2C1_SDA_GPIO_PIN the application compiles without errors. |
Development toolchains and compilers
- IAR System Workbench V9.20.1
- ARM Keil V5.37
- STM32CubeIDE v1.17.0
Supported devices and boards
- NUCLEO-F401RE MB1136 rev.C
- NUCLEO-L476RG MB1136 rev.C
- VL53L1CB / X-NUCLEO-53L1A2 / VL53L1-SATEL
- VL53L3CX / X-NUCLEO-53L3A2 / VL53L3CX-SATEL
- VL53L4CD / X-NUCLEO-53L4A1 / SATEL-VL53L4CD
- VL53L4CX / X-NUCLEO-53L4A2 / SATEL-VL53L4CX
- VL53L4ED / X-NUCLEO-53L4A3 / SATEL-VL53L4ED
- VL53L5CX / X-NUCLEO-53L5A1 / VL53L5CX-SATEL
- VL53L7CX / X-NUCLEO-53L7A1 / SATEL-VL53L7CX
- VL53L8CX / X-NUCLEO-53L8A1 / SATEL-VL53L8
Backward compatibility
N/A
Dependencies
This software release is compatible with:
- STM32CubeHAL F4 V1.8.3
- STM32CubeHAL L4 V1.13.4
Main Changes
- Clean up in BSP X-NUCLEO-53Lxxx and components release notes
- Fixed issue with I2C SetAddress function for VL53L4CD and VL53L4ED (need for in it again after shutdown cycle)
- Added 3 VL53L8CX sensors example (for X-NUCLEO-53L8A1B expansion board only)
Product Update
| Headline |
|---|
| BSP X-NUCLEO-53Lxxx and components updates |
Contents
The components flagged by “” have changed since the previous release. “” are new.
Drivers
| Name | Version | Release note |
|---|---|---|
| ST32F4xx CMSIS | V2.6.9 | release note URL |
| ST32F4xx HAL | V1.8.2 | release note URL |
| ST32L4xx CMSIS | V1.7.3 | release note URL |
| ST32L4xx HAL | V1.13.4 | release note URL |
| BSP X-NUCLEO-53L1A2 | V1.0.4 | release note URL |
| BSP X-NUCLEO-53L3A2 | V2.0.5 | release note URL |
| BSP X-NUCLEO-53L4A1 | V1.0.4 | release note URL |
| BSP X-NUCLEO-53L4A2 | V1.0.4 | release note URL |
| BSP X-NUCLEO-53L4A3 | V1.0.1 | release note URL |
| BSP X-NUCLEO-53L5A1 | V1.0.7 | release note URL |
| BSP X-NUCLEO-53L7A1 | V1.0.3 | release note URL |
| BSP X-NUCLEO-53L8A1 | V1.0.2 | release note URL |
| BSP Common | V7.3.0 | release note URL |
| BSP Component VL53L1CB | V1.0.5 | release note URL |
| BSP Component VL53L3CX | V2.0.6 | release note URL |
| BSP Component VL53L4CD | V1.0.3 | release note URL |
| BSP Component VL53L4CX | V1.0.4 | release note URL |
| BSP Component VL53L4ED | V1.0.1 | release note URL |
| BSP Component VL53L5CX | V1.0.8 | release note URL |
| BSP Component VL53L7CX | V1.1.0 | release note URL |
| BSP Component VL53L8CX | V1.1.0 | release note URL |
Known Limitations
| Headline |
|---|
| The 53L3A2_MultiSensorRanging, 53L4A2_MultiSensorRanging and 53L1A2_MultiSensorRanging sample applications don’t support multi target detection |
| When generating projects for STM32U5, user may encounter compilation errors related to missing BUS_I2C1_SDA_GPIO_PORT and BUS_I2C1_SDA_GPIO_PIN symbols in custom_bus.h. When manually adding BUS_I2C1_SDA_GPIO_PORT and BUS_I2C1_SDA_GPIO_PIN the application compiles without errors. |
Development toolchains and compilers
- IAR System Workbench V9.20.1
- ARM Keil V5.37
- STM32CubeIDE v1.15.1
Supported devices and boards
- NUCLEO-F401RE MB1136 rev.C
- NUCLEO-L476RG MB1136 rev.C
- VL53L1CB / X-NUCLEO-53L1A2 / VL53L1-SATEL
- VL53L3CX / X-NUCLEO-53L3A2 / VL53L3CX-SATEL
- VL53L4CD / X-NUCLEO-53L4A1 / SATEL-VL53L4CD
- VL53L4CX / X-NUCLEO-53L4A2 / SATEL-VL53L4CX
- VL53L4ED / X-NUCLEO-53L4A3 / SATEL-VL53L4ED
- VL53L5CX / X-NUCLEO-53L5A1 / VL53L5CX-SATEL
- VL53L7CX / X-NUCLEO-53L7A1 / SATEL-VL53L7CX
- VL53L8CX / X-NUCLEO-53L8A1 / SATEL-VL53L8
Backward compatibility
N/A
Dependencies
This software release is compatible with:
- STM32CubeHAL F4 V1.8.2
- STM32CubeHAL L4 V1.13.4
Main Changes
- Clean up release versions in documents
- Fix issues in examples (RTC enabled but useless, non existing pin assignement for VL53L8)
Product Update
| Headline |
|---|
| Reworked examples to remove RTC (badly enabled but no use) |
| Removed erroneous I2C_RST pin assignment in VL53L8 examples |
Contents
The components flagged by “” have changed since the previous release. “” are new.
Components
| Name | Version | Release note |
|---|---|---|
| X-NUCLEO-53L4A3 BSP Driver | V1.0.0 | release note URL |
| VL53L4ED BSP Component | V1.0.0 | release note URL |
| X-NUCLEO-53L8A1 BSP Driver | V1.0.1 | release note URL |
| VL53L8CX BSP Component | V1.0.2 | release note URL |
| X-NUCLEO-53L7A1 BSP Driver | V1.0.2 | release note URL |
| VL53L7CX BSP Component | V1.0.2 | release note URL |
| X-NUCLEO-53L4A1 BSP Driver | V1.0.3 | release note URL |
| VL53L4CD BSP Component | V1.0.2 | release note URL |
| X-NUCLEO-53L4A2 BSP Driver | V1.0.3 | release note URL |
| VL53L4CX BSP Component | V1.0.3 | release note URL |
| X-NUCLEO-53L1A2 BSP Driver | V1.0.3 | release note URL |
| VL53L1CB BSP Component | V1.0.4 | release note URL |
| X-NUCLEO-53L3A2 BSP Driver | V2.0.4 | release note URL |
| VL53L3CX BSP Component | V2.0.5 | release note URL |
| X-NUCLEO-53L5A1 BSP Driver | V1.0.6 | release note URL |
| VL53L5CX BSP Component | V1.0.7 | release note URL |
Note: in the table above, components highlighted have changed since previous release.
Known Limitations
| Headline |
|---|
| The 53L3A2_MultiSensorRanging, 53L4A2_MultiSensorRanging and 53L1A2_MultiSensorRanging sample applications don’t support multi target detection |
| When generating projects for STM32U5, user may encounter compilation errors related to missing BUS_I2C1_SDA_GPIO_PORT and BUS_I2C1_SDA_GPIO_PIN symbols in custom_bus.h. When manually adding BUS_I2C1_SDA_GPIO_PORT and BUS_I2C1_SDA_GPIO_PIN the application compiles without errors. |
Development toolchains and compilers
- IAR System Workbench V9.20.1
- ARM Keil V5.37
- STM32CubeIDE v1.14.0
Supported devices and boards
- NUCLEO-F401RE MB1136 rev.C
- NUCLEO-L476RG MB1136 rev.C
- VL53L1CB / X-NUCLEO-53L1A2 / VL53L1-SATEL
- VL53L3CX / X-NUCLEO-53L3A2 / VL53L3CX-SATEL
- VL53L4CD / X-NUCLEO-53L4A1 / SATEL-VL53L4CD
- VL53L4CX / X-NUCLEO-53L4A2 / SATEL-VL53L4CX
- VL53L4ED / X-NUCLEO-53L4A3 / SATEL-VL53L4ED
- VL53L5CX / X-NUCLEO-53L5A1 / VL53L5CX-SATEL
- VL53L7CX / X-NUCLEO-53L7A1 / SATEL-VL53L7CX
- VL53L8CX / X-NUCLEO-53L8A1 / SATEL-VL53L8
Backward compatibility
N/A
Dependencies
This software release is compatible with:
- STM32CubeHAL F4 V1.8.2
- STM32CubeHAL L4 V1.13.4
Main Changes
- Added VL53L4ED and X-NUCLEO-53L4A3 support
- BSP drivers update
Product Update
| Headline |
|---|
| Add X-NUCLEO-53L4A3 BSP Driver V1.0.0 |
| Add VL53L4ED BSP Component V1.0.0 |
| Update VL53L1CB BSP Component to v1.0.4 |
| Update VL53L3CX BSP Component to v2.0.5 |
| Update VL53L4CX BSP Component to v1.0.3 |
| Update X-NUCLEO-53L1A2 BSP Driver to v1.0.3 |
| Update X-NUCLEO-53L3A2 BSP Driver to v2.0.4 |
| Update X-NUCLEO-53L4A1 BSP Driver to v1.0.3 |
| Update X-NUCLEO-53L4A2 BSP Driver to v1.0.3 |
| Update X-NUCLEO-53L5A1 BSP Driver to v1.0.6 |
| Update X-NUCLEO-53L7A1 BSP Driver to v1.0.2 |
| Update X-NUCLEO-53L8A1 BSP Driver to v1.0.1 |
Contents
The components flagged by “” have changed since the previous release. “” are new.
Components
| Name | Version | Release note |
|---|---|---|
| X-NUCLEO-53L4A3 BSP Driver | V1.0.0 | release note URL |
| VL53L4ED BSP Component | V1.0.0 | release note URL |
| X-NUCLEO-53L8A1 BSP Driver | V1.0.1 | release note URL |
| VL53L8CX BSP Component | V1.0.2 | release note URL |
| X-NUCLEO-53L7A1 BSP Driver | V1.0.2 | release note URL |
| VL53L7CX BSP Component | V1.0.2 | release note URL |
| X-NUCLEO-53L4A1 BSP Driver | V1.0.3 | release note URL |
| VL53L4CD BSP Component | V1.0.2 | release note URL |
| X-NUCLEO-53L4A2 BSP Driver | V1.0.3 | release note URL |
| VL53L4CX BSP Component | V1.0.3 | release note URL |
| X-NUCLEO-53L1A2 BSP Driver | V1.0.3 | release note URL |
| VL53L1CB BSP Component | V1.0.4 | release note URL |
| X-NUCLEO-53L3A2 BSP Driver | V2.0.4 | release note URL |
| VL53L3CX BSP Component | V2.0.5 | release note URL |
| X-NUCLEO-53L5A1 BSP Driver | V1.0.6 | release note URL |
| VL53L5CX BSP Component | V1.0.7 | release note URL |
Note: in the table above, components highlighted have changed since previous release.
Known Limitations
| Headline |
|---|
| The 53L3A2_MultiSensorRanging, 53L4A2_MultiSensorRanging and 53L1A2_MultiSensorRanging sample applications don’t support multi target detection |
| When generating projects for STM32U5, user may encounter compilation errors related to missing BUS_I2C1_SDA_GPIO_PORT and BUS_I2C1_SDA_GPIO_PIN symbols in custom_bus.h. When manually adding BUS_I2C1_SDA_GPIO_PORT and BUS_I2C1_SDA_GPIO_PIN the application compiles without errors. |
Development toolchains and compilers
- IAR System Workbench V9.20.1
- ARM Keil V5.37
- STM32CubeIDE v1.13.0
Supported devices and boards
- NUCLEO-F401RE MB1136 rev.C
- NUCLEO-L476RG MB1136 rev.C
- VL53L1CB / X-NUCLEO-53L1A2 / VL53L1-SATEL
- VL53L3CX / X-NUCLEO-53L3A2 / VL53L3CX-SATEL
- VL53L4CD / X-NUCLEO-53L4A1 / SATEL-VL53L4CD
- VL53L4CX / X-NUCLEO-53L4A2 / SATEL-VL53L4CX
- VL53L4ED / X-NUCLEO-53L4A3 / SATEL-VL53L4ED
- VL53L5CX / X-NUCLEO-53L5A1 / VL53L5CX-SATEL
- VL53L7CX / X-NUCLEO-53L7A1 / SATEL-VL53L7CX
- VL53L8CX / X-NUCLEO-53L8A1 / SATEL-VL53L8
Backward compatibility
N/A
Dependencies
This software release is compatible with:
- STM32CubeHAL F4 V1.8.0
- STM32CubeHAL L4 V1.13.4
Main Changes
- Added example selector
- components drivers update
Product Update
| Headline |
|---|
| Update VL53L1CB BSP Component to v1.0.3 |
| Update VL53L3CX BSP Component to v2.0.4 |
| Update VL53L4CD BSP Component to v1.0.2 |
| Update VL53L4CX BSP Component to v1.0.2 |
| Update VL53L5CX BSP Component to v1.0.7 |
| Update VL53L7CX BSP Component to v1.0.2 |
| Update VL53L8CX BSP Component to v1.0.2 |
Contents
The components flagged by “” have changed since the previous release. “” are new.
Components
| Name | Version | Release note |
|---|---|---|
| X-NUCLEO-53L8A1 BSP Driver | V1.0.0 | release note URL |
| VL53L8CX BSP Component | V1.0.2 | release note URL |
| X-NUCLEO-53L7A1 BSP Driver | V1.0.1 | release note URL |
| VL53L7CX BSP Component | V1.0.2 | release note URL |
| X-NUCLEO-53L4A1 BSP Driver | V1.0.2 | release note URL |
| VL53L4CD BSP Component | V1.0.2 | release note URL |
| X-NUCLEO-53L4A2 BSP Driver | V1.0.2 | release note URL |
| VL53L4CX BSP Component | V1.0.2 | release note URL |
| X-NUCLEO-53L1A2 BSP Driver | V1.0.2 | release note URL |
| VL53L1CB BSP Component | V1.0.3 | release note URL |
| X-NUCLEO-53L3A2 BSP Driver | V2.0.3 | release note URL |
| VL53L3CX BSP Component | V2.0.4 | release note URL |
| X-NUCLEO-53L5A1 BSP Driver | V1.0.5 | release note URL |
| VL53L5CX BSP Component | V1.0.7 | release note URL |
Note: in the table above, components highlighted have changed since previous release.
Known Limitations
| Headline |
|---|
| The 53L3A2_MultiSensorRanging, 53L4A2_MultiSensorRanging and 53L1A2_MultiSensorRanging sample applications don’t support multi target detection |
| When generating projects for STM32U5 it is possible that you will encounter compilation errors related to missing BUS_I2C1_SDA_GPIO_PORT and BUS_I2C1_SDA_GPIO_PIN symbols in custom_bus.h. When manually adding BUS_I2C1_SDA_GPIO_PORT and BUS_I2C1_SDA_GPIO_PIN the application compiles without errors. |
Development toolchains and compilers
- IAR System Workbench V9.20.1
- ARM Keil V5.37
- STM32CubeIDE v1.12.0
Supported devices and boards
- NUCLEO-F401RE MB1136 rev.C
- NUCLEO-L476RG MB1136 rev.C
- VL53L1CB / X-NUCLEO-53L1A2 / VL53L1-SATEL
- VL53L3CX / X-NUCLEO-53L3A2 / VL53L3CX-SATEL
- VL53L4CD / X-NUCLEO-53L4A1 / SATEL-VL53L4CD
- VL53L4CX / X-NUCLEO-53L4A2 / SATEL-VL53L4CX
- VL53L5CX / X-NUCLEO-53L5A1 / VL53L5CX-SATEL
- VL53L7CX / X-NUCLEO-53L7A1 / VL53L7CX-SATEL
- VL53L8CX / X-NUCLEO-53L8A1 / VL53L8CX-SATEL
Backward compatibility
N/A
Dependencies
This software release is compatible with:
- STM32CubeHAL F4 V1.8.0
- STM32CubeHAL L4 V1.13.2
Main Changes
Product Update
| Headline |
|---|
| Add X-NUCLEO-53L8A1 BSP Driver V1.0.0 |
| Add VL53L8CX BSP Component V1.0.0 |
| Update VL53L1CB BSP Component to v1.0.2 |
| Update VL53L3CX BSP Component to v2.0.3 |
| Update VL53L4CD BSP Component to v1.0.1 |
| Update VL53L4CX BSP Component to v1.0.1 |
| Update VL53L5CX BSP Component to v1.0.4 |
| Update VL53L7CX BSP Component to v1.0.1 |
Contents
The components flagged by “” have changed since the previous release. “” are new.
Components
| Name | Version | Release note |
|---|---|---|
| X-NUCLEO-53L8A1 BSP Driver | V1.0.0 | release note URL |
| VL53L8CX BSP Component | V1.0.0 | release note URL |
| X-NUCLEO-53L7A1 BSP Driver | V1.0.1 | release note URL |
| VL53L7CX BSP Component | V1.0.1 | release note URL |
| X-NUCLEO-53L4A1 BSP Driver | V1.0.2 | release note URL |
| VL53L4CD BSP Component | V1.0.1 | release note URL |
| X-NUCLEO-53L4A2 BSP Driver | V1.0.2 | release note URL |
| VL53L4CX BSP Component | V1.0.1 | release note URL |
| X-NUCLEO-53L1A2 BSP Driver | V1.0.2 | release note URL |
| VL53L1CB BSP Component | V1.0.2 | release note URL |
| X-NUCLEO-53L3A2 BSP Driver | V2.0.3 | release note URL |
| VL53L3CX BSP Component | V2.0.3 | release note URL |
| X-NUCLEO-53L5A1 BSP Driver | V1.0.5 | release note URL |
| VL53L5CX BSP Component | V1.0.4 | release note URL |
Note: in the table above, components highlighted have changed since previous release.
Known Limitations
| Headline |
|---|
| The 53L3A2_MultiSensorRanging, 53L4A2_MultiSensorRanging and 53L1A2_MultiSensorRanging sample applications don’t support multi target detection |
| When generating projects for STM32U5 it is possible that you will encounter compilation errors related to missing BUS_I2C1_SDA_GPIO_PORT and BUS_I2C1_SDA_GPIO_PIN symbols in custom_bus.h. When manually adding BUS_I2C1_SDA_GPIO_PORT and BUS_I2C1_SDA_GPIO_PIN the application compiles without errors. |
Development toolchains and compilers
- IAR System Workbench V9.20.1
- ARM Keil V5.37
- STM32CubeIDE v1.11.0
Supported devices and boards
- NUCLEO-F401RE MB1136 rev.C
- NUCLEO-L476RG MB1136 rev.C
- VL53L1CB / X-NUCLEO-53L1A2 / VL53L1-SATEL
- VL53L3CX / X-NUCLEO-53L3A2 / VL53L3CX-SATEL
- VL53L4CD / X-NUCLEO-53L4A1 / SATEL-VL53L4CD
- VL53L4CX / X-NUCLEO-53L4A2 / SATEL-VL53L4CX
- VL53L5CX / X-NUCLEO-53L5A1 / VL53L5CX-SATEL
- VL53L7CX / X-NUCLEO-53L7A1 / VL53L7CX-SATEL
- VL53L8CX / X-NUCLEO-53L8A1 / VL53L8CX-SATEL
Backward compatibility
N/A
Dependencies
This software release is compatible with:
- STM32CubeHAL F4 V1.8.0
- STM32CubeHAL L4 V1.13.2
Main Changes
Product Update
| Headline |
|---|
| Add X-NUCLEO-53L7A1 BSP Driver V1.0.0 |
| Add VL53L7CX BSP Component V1.0.0 |
| Update X-NUCLEO-53L5A1 BSP to v1.0.4 |
| Update VL53L5CX BSP Component to v1.0.3 |
Contents
The components flagged by “” have changed since the previous release. “” are new.
Components
| Name | Version | Release note |
|---|---|---|
| X-NUCLEO-53L7A1 BSP Driver | V1.0.0 | release note URL |
| VL53L7CX BSP Component | V1.0.0 | release note URL |
| X-NUCLEO-53L4A1 BSP Driver | V1.0.1 | release note URL |
| VL53L4CD BSP Component | V1.0.0 | release note URL |
| X-NUCLEO-53L4A2 BSP Driver | V1.0.1 | release note URL |
| VL53L4CX BSP Component | V1.0.0 | release note URL |
| X-NUCLEO-53L1A2 BSP Driver | V1.0.1 | release note URL |
| VL53L1CB BSP Component | V1.0.1 | release note URL |
| X-NUCLEO-53L3A2 BSP Driver | V2.0.2 | release note URL |
| VL53L3CX BSP Component | V2.0.2 | release note URL |
| X-NUCLEO-53L5A1 BSP Driver | V1.0.4 | release note URL |
| VL53L5CX BSP Component | V1.0.3 | release note URL |
Note: in the table above, components highlighted have changed since previous release.
Known Limitations
| Headline |
|---|
| The pack doesn’t prevent multiple devices selection in Custom ranging examples generation. This will be fixed in a next release. |
| The combination Custom / RANGING SENSOR + Board Part Ranging without Application selected shall not be used even if the pack doesn’t prevent it. This will be fixed in a next release |
| The 53L3A2_MultiSensorRanging, 53L4A2_MultiSensorRanging and 53L1A2_MultiSensorRanging sample applications don’t support multi target detection |
| When generating projects for STM32U5 it is possible that you will encounter compilation errors related to missing BUS_I2C1_SDA_GPIO_PORT and BUS_I2C1_SDA_GPIO_PIN symbols in custom_bus.h. When manually adding BUS_I2C1_SDA_GPIO_PORT and BUS_I2C1_SDA_GPIO_PIN the application compiles without errors. |
Development toolchains and compilers
- IAR System Workbench V9.20.1
- ARM Keil V5.37
- STM32CubeIDE v1.10.1
Supported devices and boards
- NUCLEO-F401RE MB1136 rev.C
- NUCLEO-L476RG MB1136 rev.C
- VL53L1CB / X-NUCLEO-53L1A2 / VL53L1-SATEL
- VL53L3CX / X-NUCLEO-53L3A2 / VL53L3CX-SATEL
- VL53L4CD / X-NUCLEO-53L4A1 / SATEL-VL53L4CD
- VL53L4CX / X-NUCLEO-53L4A2 / SATEL-VL53L4CX
- VL53L5CX / X-NUCLEO-53L5A1 / VL53L5CX-SATEL
- VL53L7CX / X-NUCLEO-53L7A1 / VL53L7CX-SATEL
Backward compatibility
N/A
Dependencies
This software release is compatible with:
- STM32CubeHAL F4 V1.8.0
- STM32CubeHAL L4 V1.13.2
Main Changes
Product Update
| Headline |
|---|
| Add X-NUCLEO-53L4A1 BSP Driver V1.0.1 |
| Add VL53L4CD BSP Component V1.0.0 |
| Add X-NUCLEO-53L4A2 BSP Driver V1.0.1 |
| Add VL53L4CX BSP Component V1.0.0 |
| Update X-NUCLEO-53L1A2 BSP v1.0.1 |
| Update VL53L1CB BSP Component v1.0.1 |
| Update X-NUCLEO-53L3A2 BSP to v2.0.2 |
| Update VL53L3CX BSP Component to v2.0.2 |
| Update X-NUCLEO-53L5A1 BSP to v1.0.3 |
| Update VL53L5CX BSP Component to v1.0.2 |
Contents
The components flagged by “” have changed since the previous release. “” are new.
Components
| Name | Version | Release note |
|---|---|---|
| X-NUCLEO-53L4A1 BSP Driver | V1.0.1 | release note URL |
| VL53L4CD BSP Component | V1.0.0 | release note URL |
| X-NUCLEO-53L4A2 BSP Driver | V1.0.1 | release note URL |
| VL53L4CX BSP Component | V1.0.0 | release note URL |
| X-NUCLEO-53L1A2 BSP Driver | V1.0.1 | release note URL |
| VL53L1CB BSP Component | V1.0.1 | release note URL |
| X-NUCLEO-53L3A2 BSP Driver | V2.0.2 | release note URL |
| VL53L3CX BSP Component | V2.0.2 | release note URL |
| X-NUCLEO-53L5A1 BSP Driver | V1.0.3 | release note URL |
| VL53L5CX BSP Component | V1.0.2 | release note URL |
Note: in the table above, components highlighted have changed since previous release.
Known Limitations
| Headline |
|---|
| The pack doesn’t prevent multiple devices selection in Custom ranging examples generation. This will be fixed in a next release. |
| The combination Custom / RANGING SENSOR + Board Part Ranging without Application selected shall not be used even if the pack doesn’t prevent it. This will be fixed in a next release |
| The 53L3A2_MultiSensorRanging, 53L4A2_MultiSensorRanging and 53L1A2_MultiSensorRanging sample applications don’t support multi target detection |
| When generating projects for STM32U5 it is possible that you will encounter compilation errors related to missing BUS_I2C1_SDA_GPIO_PORT and BUS_I2C1_SDA_GPIO_PIN symbols in custom_bus.h. When manually adding BUS_I2C1_SDA_GPIO_PORT and BUS_I2C1_SDA_GPIO_PIN the application compiles without errors. |
Development toolchains and compilers
- IAR System Workbench V9.20.1
- ARM Keil V5.32
- STM32CubeIDE v1.9.0
Supported devices and boards
- NUCLEO-F401RE MB1136 rev.C
- NUCLEO-L476RG MB1136 rev.C
- VL53L1CB / X-NUCLEO-53L1A2 / VL53L1-SATEL
- VL53L3CX / X-NUCLEO-53L3A2 / VL53L3CX-SATEL
- VL53L4CD / X-NUCLEO-53L4A1 / SATEL-VL53L4CD
- VL53L4CX / X-NUCLEO-53L4A2 / SATEL-VL53L4CX
- VL53L5CX / X-NUCLEO-53L5A1 / VL53L5CX-SATEL
Backward compatibility
N/A
Dependencies
This software release is compatible with:
- STM32CubeHAL F4 V1.7.12
- STM32CubeHAL L4 V1.13.0
Main Changes
Product Update
| Headline |
|---|
| Add X-NUCLEO-53L1A2 BSP v1.0.0 |
| Add VL53L1CB BSP Component v1.0.0 |
| Update X-NUCLEO-53L3A2 BSP to v2.0.1 |
| Update VL53L3CX BSP Component to v2.0.1 |
| Update X-NUCLEO-53L5A1 BSP to v1.0.1 |
| Update VL53L5CX BSP Component to v1.0.1 |
Contents
The components flagged by “” have changed since the previous release. “” are new.
Components
| Name | Version | Release note |
|---|---|---|
| X-NUCLEO-53L1A2 BSP Driver | V1.0.0 | release note URL |
| VL53L1CB BSP Component | V1.0.0 | release note URL |
| X-NUCLEO-53L3A2 BSP Driver | V2.0.1 | release note URL |
| VL53L3CX BSP Component | V2.0.1 | release note URL |
| X-NUCLEO-53L5A1 BSP Driver | V1.0.1 | release note URL |
| VL53L5CX BSP Component | V1.0.1 | release note URL |
Note: in the table above, components highlighted have changed since previous release.
Known Limitations
| Headline |
|---|
| The 53L3A2_MultiSensorRanging and 53L1A2_MultiSensorRanging sample applications don’t support multi target detection |
| When generating projects for STM32U5 it is possible that you will encounter compilation errors related to missing BUS_I2C1_SDA_GPIO_PORT and BUS_I2C1_SDA_GPIO_PIN symbols in custom_bus.h. When manually adding BUS_I2C1_SDA_GPIO_PORT and BUS_I2C1_SDA_GPIO_PIN the application compiles without errors. |
Development toolchains and compilers
- IAR System Workbench V8.50.9
- ARM Keil V5.32
- STM32CubeIDE v1.8.0
Supported devices and boards
- NUCLEO-F401RE MB1136 rev.C
- NUCLEO-L476RG MB1136 rev.C
- VL53L1CB / X-NUCLEO-53L1A2 / VL53L1-SATEL
- VL53L3CX / X-NUCLEO-53L3A2 / VL53L3CX-SATEL
- VL53L5CX / X-NUCLEO-53L5A1 / VL53L5CX-SATEL
Backward compatibility
N/A
Dependencies
This software release is compatible with:
- STM32CubeHAL F4 V1.7.12
- STM32CubeHAL L4 V1.13.0
Main Changes
Product Update
- Add X-NUCLEO-53L5A1 BSP v1.0.0
- Add VL53L5CX BSP Component v1.0.0
Add 53L5A1_MultiSensorRanging, 53L5A1_SimpleRanging and 53L5A1_ThresholdDetection sample applications
- Update X-NUCLEO-53L3A2 BSP to v2.0.0
Update VL53L3CX BSP Component to v2.0.0
Contents
The components flagged by “” have changed since the previous release. “” are new.
Components
| Name | Version | Release note |
|---|---|---|
| X-NUCLEO-53L3A2 BSP Driver | V2.0.0 | release note URL |
| VL53L3CX BSP Component | V2.0.0 | release note URL |
| X-NUCLEO-53L5A1 BSP Driver | V1.0.0 | release note URL |
| VL53L5CX BSP Component | V1.0.0 | release note URL |
| 53L3A2_MultiSensorRanging Example | V1.0.0 | release note URL |
| 53L3A2_SimpleRanging Example | V1.0.0 | release note URL |
| 53L5A1_MultiSensorRanging Example | V1.0.0 | release note URL |
| 53L5A1_SimpleRanging Example | V1.0.0 | release note URL |
| 53L5A1_ThresholdDetection Example | V1.0.0 | release note URL |
| VL53L3CX_SimpleRanging Example | V1.0.0 | release note URL |
| VL53L5CX_SimpleRanging Example | V1.0.0 | release note URL |
Note: in the table above, components highlighted have changed since previous release.
Known Limitations
| Headline |
|---|
| The 53L3A2_MultiSensorRanging sample application doesn’t support multi target detection |
Development toolchains and compilers
- IAR System Workbench V8.50.9
- ARM Keil V5.32
- STM32CubeIDE v1.6.1
Supported devices and boards
- NUCLEO-F401RE MB1136 rev.C
- NUCLEO-L476RG MB1136 rev.C
- VL53L3CX / X-NUCLEO-53L3A2 / VL53L3CX-SATEL
- VL53L5CX / X-NUCLEO-53L5A1 / VL53L5CX-SATEL
Backward compatibility
N/A
Dependencies
This software release is compatible with:
- STM32CubeHAL F4 V1.7.12
- STM32CubeHAL L4 V1.13.0
Main Changes
First release
This is the first release of the X-CUBE-TOF1. This release supports the X-NUCLEO-53L3A2 and the VL53L3CX sensors embedded on it through the BSP ranging sensor class. The VL53L3CX-SATEL board part is also supported through the custom ranging sensor class.
Contents
The components flagged by “” have changed since the previous release. “” are new.
Components
| Name | Version | Release note |
|---|---|---|
| X-NUCLEO-53L3A2 BSP Driver | V1.0.0 | release note URL |
| VL53L3CX BSP Component | V1.0.0 | release note URL |
| VL53LX Driver | V1.2.3 | release note URL |
Note: in the table above, components highlighted have changed since previous release.
Known Limitations
| Headline |
|---|
| No known limitations |
Development toolchains and compilers
- IAR System Workbench V8.50.5
- ARM Keil V5.31
- STM32CubeIDE v1.6.0
Supported devices and boards
- NUCLEO-F401RE MB1136 rev.C
- NUCLEO-L476RG MB1136 rev.C
- X-NUCLEO-53L3A2
- VL53L3CX-SATEL
Backward compatibility
N/A
Dependencies
This software release is compatible with:
- STM32CubeHAL F4 V1.7.11
- STM32CubeHAL L4 V1.13.0