ZULU
1 ZULUProjectsRS1Modules › RS1.PRESENCE
Module 13Live

RS1.PRESENCE

Site Presence Detection

Is anyone actually at the site right now?

What it is

The site Pi listens for Bluetooth Low Energy advertisements and keeps a log of what it has seen and when. A phone in a pocket walking past the enclosure is enough to register that somebody is on the property, which is useful context for everything else: a temperature spike during a visit is a door being opened, not a cooling failure.

The log groups by the name a device advertises rather than its address, because modern phones rotate their addresses constantly and a MAC-keyed log of a single visitor looks like a crowd. Names are escaped on the way to the page — a device name is attacker-controlled text, and it is one of the few genuinely untrusted inputs this whole system accepts.

At a glance

Listens forBLE advertisements
Groups byAdvertised device name, not address
WhyRandomised MACs make an address-keyed log useless
HandlingDevice names are escaped before display — untrusted input

Where it runs

  • sitenamepi

Hardware

  • Bluetooth radio on the Pi

Shows up in

  • /admin/presence/

Depends on

Media

Screenshots and video

Nothing here yet. Drop images or video into /projects/rs1/modules/rs1-presence/media/ and they appear on this page at the next build — or list them in module.json with captions to control the order and the wording.

Code

Source

Not published yet. Code for this module will live in /projects/rs1/modules/rs1-presence/ alongside its module.json, and gets listed here once it does.