Piu' sotto, al termine della lingua inglese trovi il testo in italiano.
Below English text you'll find the Italian version
This repository contains the C code of a set of functions for an STM32 microcontroller handling a VL53L1X time-of-flight sensor through the ULP APIs provided by STMicroelectronics. It is the source and documentation archive of my YouTube playlist about gesture recognition.
Library can be used as:
- Mode 1 - Directly handle VL53L1X:
library provides functions to initialize and communicate with the device via I2C and STM APIs.
Just setting up configurations parameters you should be able to fully handle the device.
Reference for this usage mode is:
YouTube Video
Guidelines - Mode 2 - Gesture recognition:
library includes function to detect defined gestures through the handling above indicated.
Reference for this usage mode is:
YouTube Video
Guidelines - Mode 3 - Gesture menu handling:
any number of project functions can be assigned to gestures in a structured way.
Reference for this usage mode is:
YouTube Video
Guidelines
Developed software is based on HAL over STM32CubeIDE.
As above indicated the folder you see here are:
- 1 - A guide to setup a project handling VL53L1X with this library
- 2 - A guide to enable gesture detection
- 3 - A guide to setup a gesture menu
plus - the folder containing the source files of the library, of the test functions, and the testing STM32CubeMonitor scripts (see next in the instruction folders)
Each of the three "library modes", mentionned above, requires the preceding configurations completed:
- Mode 2 requires also Mode 1 configuration completed
- Needing Mode 3, you must complete configuration also of Mode 1 and 2
- If you just need using library in Mode 1 you can forget mode 2 and 3
Please Note: The software, schemes and PCB designs in this set of repositories are provided just for illustrative purposes, sharing the personal experience on this project. The software and design artifacts are provided as-is without any mantainence and without warranty of any kind. There is no guarantee of fitness for any particular application, and no guarantee of completeness and correctness. By downloading and using these materials the user accepts all risks associated with the run of the software and construction and use of the circuits and devices described.
---
- 1.0 - Mode 1 available
- 2.0 - Mode 2 and Mode 3 added
Questa repository contiene il codice C di un set di funzioni per un microcontrollore STM32 che gestisce un sensore time-of-flight VL53L1X attraverso le ULP APIs fornite da STMicroelectronics. Rappresenta l'archivio dei programmi e della documentazione relativa alla mia playlist YouTube sulla gesture recognition.
La libreria può essere utilizzata per:
- Mode 1 - Gestire direttamente VL53L1X:
la libreria mette a disposizione le funzioni per inizializzare e comunicare con il sensore via I2c e le API di STM.
Semplicemente impostando i parametri di configurazione dovresti essere in grado di gestire pienamente il sensore.
Il riferimento per usare questo modo è:
Video YouTube
Istruzioni - Mode 2 - Rilevamento gesti:
la libreria contiene le funzioni necessare per rilevare determinati gesti attraverso la gestione indicata sopra
qui, puoi impostare la libreria per gestire l'intero set di Il riferimento per usare questo modo è:
Video YouTube
Istruzioni - Mode 3 - Creare un menù gestuale:
qualunque numero di funzioni del progetto può essere assegnato a gesti
Il riferimento per usare questo modo è:
Video YouTube
Istruzioni
Il software sviluppato, si basa su HAL attraverso STM32CubeIDE.
Come indicato sopra, le tre cartelle che vedi qui sono:
-1 La guida per configurare un progetto basato su VL53L1X
-2 La guida per attivare il rilevamento gesti
-3 La guida per configurare un menù basato su gesti
Ogni "Modo d'uso" della libreria, citato sopra, richiede che vengano completate le configurazioni dei "modi" precedenti:
- Il modo 2 richiede venga completata anche la configurazione del modo 1
- Occorrendo il modo 3, devi completare anche le configurazioni del modo 1 e 2
- Se occorre la libreria solo nel modo 1 puoi tralasciare il modo 2 e 3
Il software e gli schemi di progetto come i layout PCB in questa serie di repository sono messe a disposizione con puro intento illustrativo e di condivisione dell'esperienza fatta Il software and gli elementi del progetto sono messi a disposizione "allo stato in cui sono" senza impegno di manutenzione e senza garanzie di alcun tipo. Piu' esplicitamente, non c'e' garanzia di adeguatezza a soddisfare specifiche esigenze, ne di completezza o correttezza di alcuna parte. Scaricando ed utilizzando questo materiale l'utilizzatore accetta il rischio associato alla realizzazione ed all'utilizzo del circuito, del software e dei componenti descritti in questi file.
- 1.0 - prima release: Modo 1 disponibile
- 2.0 - aggiunti Modo 2 e Modo 3