Skip to content
 
 

Repository files navigation

FindMe - True Presence Detection

FindMe bedside-lamp prototype and sensor enclosure

Version 1.0.0 GitHub stars Contributors Forks Open issues Repository size Last commit License

ICT Innovation VDA Telkonet partner

A privacy-preserving, multi-sensor occupancy prototype for hospitality rooms and care environments. FindMe detects real guest presence, including quiet activities such as sleeping or reading, without cameras or microphones.

Cover: FindMe's final lamp-integrated prototype concept, created by the project team.

Table of Contents 📖

The problem

Traditional hotel room-management systems commonly rely on keycards and PIR motion sensors. They can classify a still guest as absent, causing false negatives that affect comfort, energy management, and safety.

FindMe addresses this gap for luxury hospitality, assisted living, and rehabilitation scenarios, where true presence matters even when a person is not moving.

The solution

FindMe is designed as a plug-and-play bedside-lamp concept with sensing integrated in a discrete enclosure. It combines:

  • 24 GHz mmWave radar for micro-movements such as breathing
  • PIR sensing for motion events
  • CO2 / TVOC context from an SGP30 environmental sensor
  • BLE badges for staff and janitor context
  • ESP-NOW communication between nodes and MQTT integration with the room-management mockup
  • DOWA and Dempster-Shafer Theory fusion to combine evidence and represent uncertainty

No camera or microphone is used.

System architecture

PIR node + BLE badge ------ ESP-NOW ------+
                                             \
mmWave radar + CO2 / TVOC --- UART / I2C ---- ESP32-S3 master --- MQTT --- Room-control mockup
                                              /
                              DOWA / DST evidence fusion

The fusion model produces Occupied, Empty, or Unknown evidence states. Sensor weights can be reduced when a sensor is inactive or reports an error, preventing one weak input from dominating the decision.

Evaluation

The final prototype evaluation used 250 samples. It reported zero false negatives, 100% recall, 71.6% precision, 83.5% F1 score, and 76.4% accuracy. These results prioritise reliable presence detection, which is the core safety requirement of the concept.

The project was discussed with VDA Telkonet and demonstrated with hospitality stakeholders at Best Western Hotel Adige.

Repository guide

src/                         # ESP32-S3 firmware and sensor integration
src/tests/                   # Isolated tests for mmWave, PIR, BLE, MQTT, ESP-NOW, and fusion
mockup/                      # Vite + React room-control interface
Slides/                      # Project presentation material
MOD_DOWA_Fusion_Model.pdf    # Fusion-model reference
sessione_completa.csv        # Evaluation-session data
platformio.ini               # ESP32-S3 PlatformIO configuration

Run the prototypes

Firmware

Install PlatformIO, then create a local configuration file before connecting to any network:

cp src/config.example.h src/config.h
# Edit src/config.h with your isolated demo Wi-Fi and MQTT values.
pio run -e esp32s3_n16r8
pio run -e esp32s3_n16r8 -t upload
pio device monitor -b 115200

src/config.h is ignored by Git. Never commit a Wi-Fi password, MQTT credential, room identifier, or production endpoint.

Room-control mockup

cd mockup
cp .env.example .env
npm install
npm run dev

The mockup is a demonstrator: its technician password must be configured locally, and production authentication belongs on a server rather than in browser code.

Media and documentation

Privacy and security

  • The design avoids cameras and microphones.
  • Network and mockup credentials are intentionally local-only and ignored by Git.
  • The prototype's client-side UI guard is demo-only; real deployments require server-side authentication, TLS, access control, and credential rotation.

Acknowledgments

FindMe was developed for the ICT Innovation course at the University of Trento under the guidance of Prof. Marco Formentini. We thank him for the innovation-method guidance and feedback provided throughout the project.

We also thank VDA Telkonet for presenting the true-presence-detection challenge, sharing hospitality-domain insight, and providing feedback during the project. FindMe is an academic proof of concept and is not presented as an official commercial VDA Telkonet product.

VDA Telkonet

Team

Team 7

Member GitHub LinkedIn Email
Andrea Lo Iacono ADreLOI Andrea Lo Iacono andrea.loiacono@studenti.unitn.it
Jago Revrenna jagorev Jago Revrenna jago.revrenna@studenti.unitn.it
Matthew De Marco MattDema Matthew De Marco matthew.demarco@studenti.unitn.it
Sophia Sau Not publicly available Sophia Sau sophia.sau@studenti.unitn.it
Alessio Leonardi Not publicly available Alessio Leonardi alessio.leonardi@studenti.unitn.it

License

Distributed under the GNU General Public License v3.0 (GPL-3.0). See LICENSE for the complete terms.

Back to Top
Back to Top

About

A privacy-preserving, multi-sensor true-presence prototype for hospitality rooms, combining ESP32-S3, mmWave, PIR, BLE, MQTT, and sensor fusion with VDA Telkonet.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages