From 864673b9ea9d93e72b5fb051127f96444d5a956a Mon Sep 17 00:00:00 2001 From: Dragan Spiridonov Date: Thu, 30 Jul 2026 13:46:19 +0200 Subject: [PATCH] docs(esp32): note the retired 'presence' cog, point at presence-field The legacy 'presence' cog never consumed ESP32 CSI and always reported present:false on real hardware; it is delisted and (from seed v0.23.4) rejected at install. Documents the replacement flow: presence-field + esp32-udp + stop/start + empty-room calibration. Companion to cognitum-one/seed#287 (seed#286). Co-Authored-By: Ruflo & AQE --- docs/esp32-onboarding.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/esp32-onboarding.md b/docs/esp32-onboarding.md index 876a489..6fdb1ec 100644 --- a/docs/esp32-onboarding.md +++ b/docs/esp32-onboarding.md @@ -225,6 +225,14 @@ cog "uses ruview" is how it interprets the payload — for the feature packet The node is cog‑agnostic — capability is decided by which cog you deploy and where. +> **Retired: the `presence` cog.** Older docs and cached store pages referenced a +> cog with id `presence`. It never consumed ESP32 CSI (it read the Seed's onboard +> sensors) and always reported `present:false` on real hardware, so it has been +> removed from the store; current firmware rejects installing it by id. Use +> **`presence-field`** instead: install it, set its data source to `esp32-udp`, +> stop/start it (see Known gaps below), then run its calibration with the room +> empty (~120 s) before trusting its output. + ## Known gaps - **Changing a cog's data source does not restart the cog.** Until this is fixed