README 未说明具体依赖版本与默认配置,搭建前需查阅官方文档站 paxcounter.org;LoRaWAN 上传需自备网络(如 TheThingsNetwork 或 Helium)

README 未给出安装或编译命令,仅指向文档站 https://paxcounter.org基于 ESP32 MCU,推荐使用带 LoRa 的廉价 ESP32 LoRa IoT 开发板(如 LILYGO Paxcounter LoRa);README 未说明具体内存或存储要求。
用廉价 ESP32 板通过 WiFi 和 BLE 信号估算人流量的开源固件
用廉价 ESP32 板通过 WiFi 和 BLE 信号统计人流密度,支持 LoRaWAN、GPS 等扩展,适合低成本客流监测部署。
核心能力
- 扫描空中 WiFi 与蓝牙信号,按 MAC 地址估算周边设备数
- 不持久化存储 MAC 地址,也不做设备指纹识别
- 支持将数据存 SD 卡或经 LoRaWAN、MQTT 上传
- 可并行读取并存储多个外接环境传感器数据
- 支持 ESP32 深度睡眠,用 18650 电池长时间运行
容易踩的坑
- v3.8.0最新正式版2026-08-07 · 2026-08-07 17:58 UTC
What's Changed
- Added support for CYD (Cheap Yellow Display) by @Tomas-Kuchta-FPV in https://github.com/cyberman54/ESP32-Paxcounter/pull/1035
- Randomize power-on delay to avoid boot/join congestion on mass restarts by @cyberman54 with @Copilot in https://github.com/cyberman54/ESP32-Paxcounter/pull/1041
- fix: resolve IRAM overflow for m5core build by @cyberman54 with @Copilot in https://github.com/cyberman54/ESP32-Paxcounter/pull/1042
- Change scheduled CI build from weekly to every 3 weeks on Tuesday by @cyberman54 with @Copilot in https://github.com/cyberman54/ESP32-Paxcounter/pull/1043
- Fix IRAM0 overflow in generic.h build by conditionally applying IRAM_ATTR to doIRQ() by @cyberman54 with @Copilot in https://github.com/cyberman54/ESP32-Paxcounter/pull/1044
- Reduce Windows/macOS CI matrix to a single board by @cyberman54 with @Copilot in https://github.com/cyberman54/ESP32-Paxcounter/pull/1045
- Fix IRAM0 overflow for m5core build (overflowed by 24 bytes) by @cyberman54 with @Copilot in https://github.com/cyberman54/ESP32-Paxcounter/pull/1046
- Development by @cyberman54 in https://github.com/cyberman54/ESP32-Paxcounter/pull/1047
- Fix build failure: replace removed XPowersLib fuelGaugeControl() API for AXP2101 by @cyberman54 with @Copilot in https://github.com/cyberman54/ESP32-Paxcounter/pull/1048
- Libpax lib upgraded to latest development stage, see https://github.com/cyberman54/libpax/tree/development
New Contributors
- @Tomas-Kuchta-FPV made their first contribution in https://github.com/cyberman54/ESP32-Paxcounter/pull/1035
- @cyberman54 with @Copilot made their first contribution in https://github.com/cyberman54/ESP32-Paxcounter/pull/1041
Full Changelog: https://github.com/cyberman54/ESP32-Paxcounter/compare/v3.6.3...v3.8.0
- v3.6.32024-06-15 · 2024-06-15 12:29 UTC
查看更新说明
Maintenance Release with bugfixes
What's Changed
- [Power] Add extra display page showing power consumption by @TD-er in https://github.com/cyberman54/ESP32-Paxcounter/pull/1012
- [GPS] Only send valid GPS coordinates (#1009) by @TD-er in https://github.com/cyberman54/ESP32-Paxcounter/pull/1011
- [Docs] Fix image links + clarify comments by @TD-er in https://github.com/cyberman54/ESP32-Paxcounter/pull/1013
Full Changelog: https://github.com/cyberman54/ESP32-Paxcounter/compare/v3.6.2...v3.6.3
- v3.6.22024-04-29 · 2024-04-29 09:12 UTC
查看更新说明
Maintenance Release
What's Changed
- Add support for BMP280 Sensor by @cyberman54 in https://github.com/cyberman54/ESP32-Paxcounter/pull/996
- Add BMP280 sensor (PR #996 by Lemocin) by @cyberman54 in https://github.com/cyberman54/ESP32-Paxcounter/pull/997
Full Changelog: https://github.com/cyberman54/ESP32-Paxcounter/compare/v3.6.1...v3.6.2
- v3.6.12023-07-29 · 2023-07-29 17:45 UTC
查看更新说明
Maintenance Release
What's Changed
- sync dev to master by @cyberman54 in https://github.com/cyberman54/ESP32-Paxcounter/pull/976
- sync dev to master by @cyberman54 in https://github.com/cyberman54/ESP32-Paxcounter/pull/983
- Using the device specific h files instead of RtcDateTime.h directly as mentioned by Makuna by @TomRottler in https://github.com/cyberman54/ESP32-Paxcounter/pull/982
- Development by @cyberman54 in https://github.com/cyberman54/ESP32-Paxcounter/pull/984
New Contributors
- @TomRottler made their first contribution in https://github.com/cyberman54/ESP32-Paxcounter/pull/982
Full Changelog: https://github.com/cyberman54/ESP32-Paxcounter/compare/v3.6.0...v3.6.1
- v3.6.02023-05-20 · 2023-05-20 16:11 UTC
查看更新说明
Maintenance Release
What's Changed
- update Bosch BSEC lib 1.8.1492 by @cyberman54 in https://github.com/cyberman54/ESP32-Paxcounter/pull/953
- add wifi channel map configuration option by @cyberman54 in https://github.com/cyberman54/ESP32-Paxcounter/pull/960
- Feature/support and hint for ttgo v2 board by @sauttefk in https://github.com/cyberman54/ESP32-Paxcounter/pull/944
New Contributors
- @sauttefk made their first contribution in https://github.com/cyberman54/ESP32-Paxcounter/pull/945
Full Changelog: https://github.com/cyberman54/ESP32-Paxcounter/compare/v3.4.7...v3.6.0
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
ESP32-Paxcounter

Wifi & Bluetooth driven, LoRaWAN enabled, Paxcounter and multi-sensor appliance, built on cheap ESP32 LoRa IoT boards
Tutorial (in german language): heise.de
Ready-to-go Hardware: LILYGO® Paxcounter LoRa
Documentation: https://paxcounter.org
Source Code: https://github.com/cyberman54/ESP32-Paxcounter
Use case
Paxcounter is an ESP32 MCU based device for metering passenger flows and multi-sensor data in realtime. It counts how many mobile devices are around. This gives an estimation how many people are around. Paxcounter detects Wifi and Bluetooth signals in the air, focusing on mobile devices by evaluating their MAC adresses. In parallel, it reads and stores data from multiple connected environment sensors.
Intention of this project is to do this without intrusion in privacy: You don't need to track people owned devices, if you just want to count them. Therefore, Paxcounter does not persistenly store MAC adresses and does no kind of fingerprinting the scanned devices.
Data can either be stored on a local SD-card, transferred to cloud using LoRaWAN network (e.g. TheThingsNetwork or Helium) or MQTT over TCP/IP, or transmitted to a local host using serial (SPI) interface.
You can build this project battery powered using ESP32 deep sleep mode and reach long uptimes with a single 18650 Li-Ion cell.
License
Copyright 2018-2022 Oliver Brandmueller [email protected]
Copyright 2018-2022 Klaus Wilting [email protected]
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
NOTICE: Parts of the source files in this repository are made available under different licenses, see file LICENSE.txt in this repository. Refer to each individual source file for more details.
Credits
Thanks to
- Oliver Brandmüller for idea and initial setup of this project
- Charles Hallard for major code contributions to this project
- robbi5 for the payload converter
- Caspar Armster for the The Things Stack V3 payload converter
- terrillmoore for maintaining the LMIC for arduino LoRaWAN stack
- sbamueller for writing the tutorial in Make Magazine
- Stefan for paxcounter opensensebox integration
- August Quint for adding SD card data logger and SDS011 support
- t-huyeng for adding a CI workflow and rework documentation
- TD-er for bugfixings and T-Beam documentation