Calibrating a beacon¶
Calibration tells beacbeac how strong this specific beacon's signal is at one metre. Without that reference, the visitor app has to guess the distance — and guesses produce false triggers (wrong story appears) or missed triggers (nothing appears).
When calibration happens¶
Calibration is a step inside the pairing flow (see Pairing a beacon). beacbeac handles it for you the first time you pair a beacon — you don't open it from a separate menu.
During calibration:
- Stand one metre from the beacon, in its final mounted position.
- Hold your phone at chest height.
- beacbeac samples the signal for about three seconds and averages the readings.
- The averaged value is saved as the beacon's measured power.
When to recalibrate¶
The original calibration is usually fine for the life of the beacon. Recalibrate if:
- You moved the beacon to a different spot.
- You changed how it's mounted (e.g. behind glass, into a metal frame).
- Visitors are reporting the wrong story triggering, or no story triggering, and other causes (see Troubleshooting signal) are ruled out.
To recalibrate, withdraw the beacon from service, then pair it again.
- On Manage Beacons, withdraw the beacon (see Withdrawing a beacon).
- Tap Add New Beacon, then start a scan: tap the radar icon at the top right of Pair New Beacons (Start Scanning).
- Find the beacon. Because it was withdrawn, it shows Withdrawn: <name> (its name in beacbeac) with a Re-pair button instead of Pair. On an iPhone or iPad it shows Pair at first: tap it, and once beacbeac has read the beacon (Identifying Beacon) it opens Re-pair for you.
- Tap Re-pair, then Re-pair again in the window that opens, and follow the prompts, including the calibration step.
Re-pairing keeps the beacon's Major/Minor, story links and Detection range, replaces the saved measured power with a fresh reading, and returns the beacon to service. The name is filled in for you and you can change it. If the beacon had been switched off from broadcasting, re-pairing turns broadcasting back on. If you skip the calibration step, the stored measured power is kept. A beacon that is already in service shows Paired with no button, so it can't be paired again until it has been withdrawn.
Choosing a detection range¶
The beacon edit screen has a Detection range control with four meter-labeled presets:
- Touch · ~1 m — the story appears only when a visitor is right at the beacon.
- Close · ~3 m — the story appears within arm's reach or so.
- Room · ~8 m — the default. The story appears from most of the way across a typical room.
- Wide · ~15 m — the story appears from across a large room or hall.
The metre figures are approximate targets, not guarantees: beacbeac computes each beacon's actual trigger floor from its own calibration (the measured power saved during pairing — see above), so two beacons set to the same preset can trigger at slightly different real-world distances if they were calibrated differently. Real range also varies with mounting, walls, and crowds, which is why the edit screen's helper text says to test on site. If a beacon consistently triggers too early or too late for its preset, recalibrate it before changing the preset.
Existing beacons that haven't had this set default to Room. Beacons written by an older app version that still use the old Near/Medium/Far names keep working: Near reads as Touch, Medium reads as Room, and Far reads as Wide.
Changes take effect within about a minute for visitors already standing at the beacon, and immediately for everyone else.
Testing your calibration¶
After calibrating:
- Walk away from the beacon until the story disappears from the visitor app.
- Walk back slowly — the story should reappear at the distance you'd expect a visitor to naturally stop and look.
- If it's triggering too early or too late, recalibrate (or move the beacon).