智能门禁红外检测系统 - 社区安防解决方案一、实际应用场景描述某老旧小区改造项目原门禁系统仅支持刷卡/密码开门存在以下问题- 外卖员/访客长时间在门口逗留易引发盗窃或纠纷- 物业无法实时获知异常停留情况- 传统系统无智能提醒功能依赖人工监控本系统目标在门禁区域安装红外热释电传感器当检测到人体持续停留超过10秒时通过声光报警LED屏提示请勿逗留同时记录事件日志供物业追溯。二、引入痛点痛点类型 具体表现 本方案解决方式安全隐患 陌生人在门口长时间徘徊可能踩点或实施犯罪 实时检测自动预警形成威慑管理滞后 物业需24小时人工监控人力成本高 系统自动触发提示减少人工依赖证据缺失 发生事件后无数据记录难以追溯 自动记录时间戳事件类型生成日志三、核心逻辑讲解graph TDA[红外传感器初始化] -- B[持续监测人体信号]B -- C{是否检测到人体?}C -- 否 -- BC -- 是 -- D[记录开始时间T0]D -- E[持续检测是否保持存在]E -- F{是否持续超过10秒?}F -- 否 -- EF -- 是 -- G[触发声光报警LED显示请勿逗留]G -- H[记录事件日志]H -- I[持续检测是否离开]I -- J{是否离开?}J -- 是 -- K[停止报警恢复待机]J -- 否 -- G关键逻辑点1. 防误触机制采用存在确认模式需连续3次采样间隔200ms均检测到信号才判定为有效进入2. 时间计算使用time.monotonic()确保计时精度避免系统时间调整影响3. 状态机设计定义4种状态IDLE/DETECTED/TIMING/ALERT确保流程清晰4. 资源释放程序退出时自动关闭GPIO和串口连接防止硬件损坏四、代码模块化实现项目结构smart_access_control/├── main.py # 主程序入口├── config.py # 配置文件├── sensors/ # 传感器模块│ ├── __init__.py│ └── ir_sensor.py # 红外传感器驱动├── alerts/ # 报警模块│ ├── __init__.py│ └── notifier.py # 声光报警LED控制├── logger/ # 日志模块│ ├── __init__.py│ └── event_logger.py # 事件记录└── utils/ # 工具函数├── __init__.py└── time_utils.py # 时间处理工具1. 配置文件 (config.py)智能门禁系统配置文件包含传感器参数、报警设置、日志配置等# 传感器配置SENSOR_PIN 17 # 红外传感器连接的GPIO引脚 (BCM编号)SAMPLE_INTERVAL 0.2 # 采样间隔(秒)CONFIRM_SAMPLES 3 # 确认存在的连续采样次数# 时间阈值(秒)STAY_THRESHOLD 10 # 触发警告的停留时间CLEANUP_DELAY 2 # 报警后持续检测离开的延迟# 报警配置ALERT_DURATION 5 # 单次报警持续时间(秒)BUZZER_PIN 18 # 蜂鸣器GPIO引脚LED_PIN 23 # 状态LED GPIO引脚LED_MESSAGE 请勿逗留 # LED显示屏提示文字# 日志配置LOG_FILE access_events.logLOG_FORMAT %(asctime)s - %(levelname)s - %(message)sMAX_LOG_SIZE 1024 * 1024 # 日志最大1MB循环覆盖2. 红外传感器模块 (sensors/ir_sensor.py)红外热释电传感器驱动模块负责读取人体检测信号并进行有效性验证import RPi.GPIO as GPIOimport timefrom config import SENSOR_PIN, SAMPLE_INTERVAL, CONFIRM_SAMPLESclass IRSensor:def __init__(self):初始化传感器GPIO设置self.pin SENSOR_PINself.last_state Falseself._setup_gpio()def _setup_gpio(self):配置GPIO为输入模式启用上拉电阻GPIO.setmode(GPIO.BCM) # 使用BCM编号GPIO.setup(self.pin, GPIO.IN, pull_up_downGPIO.PUD_UP)def read_raw(self) - bool:读取原始传感器信号返回: True-检测到人体, False-未检测到return GPIO.input(self.pin) GPIO.LOW # 低电平表示检测到人体def is_person_present(self) - bool:带防误触的存在检测通过连续多次采样确认避免瞬间干扰返回: 确认存在为Trueconfirm_count 0for _ in range(CONFIRM_SAMPLES):if self.read_raw():confirm_count 1else:confirm_count 0 # 一旦失败重置计数time.sleep(SAMPLE_INTERVAL)return confirm_count CONFIRM_SAMPLESdef cleanup(self):清理GPIO资源GPIO.cleanup(self.pin)3. 报警通知模块 (alerts/notifier.py)声光报警与LED显示模块控制蜂鸣器、状态灯和LED屏幕import RPi.GPIO as GPIOimport timeimport serialfrom config import BUZZER_PIN, LED_PIN, ALERT_DURATION, LED_MESSAGEclass AlertNotifier:def __init__(self):初始化报警设备self.buzzer_pin BUZZER_PINself.led_pin LED_PINself.serial_port Noneself._setup_devices()def _setup_devices(self):配置蜂鸣器和LED的GPIO初始化串口连接LED屏GPIO.setmode(GPIO.BCM)GPIO.setup(self.buzzer_pin, GPIO.OUT)GPIO.setup(self.led_pin, GPIO.OUT)# 初始化LED串口连接 (假设使用9600波特率)try:self.serial_port serial.Serial(/dev/ttyUSB0, 9600, timeout1)time.sleep(2) # 等待串口稳定except serial.SerialException as e:print(fLED串口连接失败: {e})def trigger_alert(self):触发声光报警蜂鸣器响LED闪烁屏幕显示提示start_time time.time()while time.time() - start_time ALERT_DURATION:# 蜂鸣器响GPIO.output(self.buzzer_pin, GPIO.HIGH)# LED亮GPIO.output(self.led_pin, GPIO.HIGH)# 更新LED屏幕self._update_led_display(LED_MESSAGE)time.sleep(0.5)# 蜂鸣器停GPIO.output(self.buzzer_pin, GPIO.LOW)# LED灭GPIO.output(self.led_pin, GPIO.LOW)time.sleep(0.5)def _update_led_display(self, text: str):发送文本到LED显示屏if self.serial_port and self.serial_port.is_open:try:self.serial_port.write(fDISP:{text}\n.encode(utf-8))except Exception as e:print(fLED更新失败: {e})def stop_alert(self):停止所有报警设备GPIO.output(self.buzzer_pin, GPIO.LOW)GPIO.output(self.led_pin, GPIO.LOW)if self.serial_port and self.serial_port.is_open:self.serial_port.close()def cleanup(self):清理所有设备资源self.stop_alert()GPIO.cleanup([self.buzzer_pin, self.led_pin])4. 事件日志模块 (logger/event_logger.py)事件日志记录模块记录所有检测事件用于事后追溯和分析import loggingimport osfrom logging.handlers import RotatingFileHandlerfrom config import LOG_FILE, LOG_FORMAT, MAX_LOG_SIZEclass EventLogger:def __init__(self):初始化日志系统使用滚动文件处理self.logger logging.getLogger(AccessControl)self.logger.setLevel(logging.INFO)# 创建日志目录如果不存在log_dir os.path.dirname(LOG_FILE)if log_dir and not os.path.exists(log_dir):os.makedirs(log_dir)# 配置滚动日志处理器达到MAX_LOG_SIZE后自动备份handler RotatingFileHandler(LOG_FILE,maxBytesMAX_LOG_SIZE,backupCount5,encodingutf-8)formatter logging.Formatter(LOG_FORMAT)handler.setFormatter(formatter)self.logger.addHandler(handler)def log_entry(self, event_type: str, details: str):记录一条事件日志event_type: 事件类型 (ENTRY/EXIT/ALERT/NORMAL)details: 详细描述信息self.logger.info(f{event_type}: {details})def get_recent_logs(self, lines: int 10) - list:获取最近的日志条目try:with open(LOG_FILE, r, encodingutf-8) as f:return f.readlines()[-lines:]except FileNotFoundError:return []5. 工具函数模块 (utils/time_utils.py)时间处理工具模块提供高精度计时和时间格式化功能import timedef get_monotonic_time() - float:获取单调递增的时钟时间不受系统时间调整影响适用于精确计时场景return time.monotonic()def format_duration(seconds: float) - str:将秒数转换为可读的时间字符串if seconds 60:return f{seconds:.1f}秒elif seconds 3600:minutes int(seconds // 60)secs int(seconds % 60)return f{minutes}分{secs}秒else:hours int(seconds // 3600)minutes int((seconds % 3600) // 60)return f{hours}小时{minutes}分class Timer:简易计时器类def __init__(self):self.start_time Noneself.elapsed 0.0def start(self):开始计时self.start_time get_monotonic_time()def stop(self):停止计时并计算耗时if self.start_time:self.elapsed get_monotonic_time() - self.start_timeself.start_time Nonereturn self.elapseddef reset(self):重置计时器self.start_time Noneself.elapsed 0.06. 主程序入口 (main.py)#!/usr/bin/env python3智能门禁红外检测系统主程序实现人体停留检测、超时预警、日志记录全流程import sysimport signalfrom sensors.ir_sensor import IRSensorfrom alerts.notifier import AlertNotifierfrom logger.event_logger import EventLoggerfrom utils.time_utils import get_monotonic_time, Timerfrom config import STAY_THRESHOLD, CLEANUP_DELAYclass AccessControlSystem:智能门禁控制系统主类# 系统状态枚举STATE_IDLE IDLE # 空闲状态无人检测STATE_DETECTED DETECTED # 检测到有人进入STATE_TIMING TIMING # 计时中等待超时判断STATE_ALERT ALERT # 触发警报状态def __init__(self):初始化所有子系统print(正在初始化智能门禁系统...)self.sensor IRSensor()self.notifier AlertNotifier()self.logger EventLogger()self.current_state self.STATE_IDLEself.timer Timer()self.alert_active False# 注册信号处理确保优雅退出signal.signal(signal.SIGINT, self._signal_handler)signal.signal(signal.SIGTERM, self._signal_handler)print(系统初始化完成开始运行...)self.logger.log_entry(SYSTEM, 智能门禁系统启动)def _signal_handler(self, signum, frame):处理终止信号确保资源正确释放print(\n接收到终止信号正在清理资源...)self.shutdown()sys.exit(0)def run(self):主运行循环try:while True:current_time get_monotonic_time()# 状态机处理if self.current_state self.STATE_IDLE:self._handle_idle_state(current_time)elif self.current_state self.STATE_DETECTED:self._handle_detected_state(current_time)elif self.current_state self.STATE_TIMING:self._handle_timing_state(current_time)elif self.current_state self.STATE_ALERT:self._handle_alert_state(current_time)# 短暂休眠降低CPU占用time.sleep(0.05)except Exception as e:print(f运行时错误: {e})self.logger.log_entry(ERROR, f运行时异常: {str(e)})self.shutdown()def _handle_idle_state(self, current_time):空闲状态处理检测是否有人体进入if self.sensor.is_person_present():self.current_state self.STATE_DETECTEDself.timer.reset()print(检测到人体进入...)self.logger.log_entry(ENTRY, 检测到人员进入检测区域)def _handle_detected_state(self, current_time):检测到人体后的状态处理# 再次确认人体仍然存在if self.sensor.is_person_present():# 开始计时self.timer.start()self.current_state self.STATE_TIMINGprint(开始计时停留时间...)else:# 误检返回空闲状态self.current_state self.STATE_IDLEprint(误检返回空闲状态)def _handle_timing_state(self, current_time):计时状态处理判断是否超过阈值elapsed self.timer.stop()if not self.sensor.is_person_present():# 人员已离开记录正常停留if elapsed 0:self.logger.log_entry(NORMAL, f人员短暂停留 {elapsed:.1f}秒后离开)self.current_state self.STATE_IDLEself.timer.reset()print(人员已离开计时结束)elif elapsed STAY_THRESHOLD:# 超过阈值触发警报self.current_state self.STATE_ALERTself.alert_active Trueprint(f⚠️ 警告人员停留超过{STAY_THRESHOLD}秒)self.logger.log_entry(ALERT, f检测到人员异常停留 {elapsed:.1f}秒触发警报)self.notifier.trigger_alert()def _handle_alert_state(self, current_time):警报状态处理持续检测人员是否离开if not self.sensor.is_person_present():# 人员离开停止警报self.notifier.stop_alert()self.alert_active Falseself.current_state self.STATE_IDLEself.timer.reset()print(人员已离开警报解除)self.logger.log_entry(EXIT, 警报解除人员离开)else:# 人员仍在持续报警print(持续报警中... 请尽快处理)time.sleep(0.5) # 降低报警频率def shutdown(self):系统关闭释放所有资源print(正在关闭系统...)if self.alert_active:self.notifier.stop_alert()self.sensor.cleanup()self.notifier.cleanup()self.logger.log_entry(SYSTEM, 智能门禁系统正常关闭)print(系统已安全关闭)if __name__ __main__:system AccessControlSystem()system.run()五、README文件# 智能门禁红外检测系统## 项目简介基于Python的智能门禁安防系统通过红外热释电传感器检测人体停留超过设定时间自动触发声光报警适用于小区、办公楼等场所的安全防护。## 功能特性- ✅ 人体存在检测带防误触机制- ✅ 10秒停留阈值判断- ✅ 声光报警 LED屏提示- ✅ 事件日志记录与追溯- ✅ 优雅的资源管理## 硬件要求| 组件 | 型号/规格 | 数量 ||------|----------|------|| 树莓派 | 3B/4B | 1 || 红外传感器 | HC-SR501 | 1 || 蜂鸣器 | 有源蜂鸣器 | 1 || LED指示灯 | 红色LED | 1 || LED显示屏 | 串口LCD1602 | 1 || 杜邦线 | - | 若干 |## 接线示意图红外传感器 VCC → 树莓派 5V红外传感器 GND → 树莓派 GND红外传感器 OUT → 树莓派 GPIO17蜂鸣器 VCC → 树莓派 5V蜂鸣器 GND → 树莓派 GND蜂鸣器 IN → 树莓派 GPIO18LED指示灯 正极 → 树莓派 GPIO23LED指示灯 负极 → 220Ω电阻 → GNDLED显示屏 RX → 树莓派 TX (GPIO14)LED显示屏 GND → 树莓派 GND## 软件依赖bashpip install RPi.GPIO pyserial## 安装与使用### 1. 克隆仓库bashgit clone https://github.com/yourusername/smart-access-control.git (https://github.com/yourusername/smart-access-control.git)cd smart-access-control### 2. 配置修改根据实际接线修改 config.py 中的GPIO引脚定义### 3. 运行程序bashsudo python3 main.py## 日志查看事件日志保存在 access_events.log可通过以下命令查看bashtail -f access_events.log## 注意事项1. 必须使用sudo运行以获取GPIO访问权限2. 首次运行前确保传感器处于稳定环境预热30秒3. 如需修改停留阈值编辑config.py中的STAY_THRESHOLD## 贡献指南欢迎提交Issue和Pull Request请遵循PEP8编码规范。## 许可证MIT License六、核心知识点卡片卡片1GPIO输入模式配置GPIO.setmode(GPIO.BCM) # 使用BCM引脚编号而非物理引脚GPIO.setup(pin, GPIO.IN, pull_up_downGPIO.PUD_UP) # 上拉电阻配置关键点HC-SR501传感器输出低电平表示检测到人体因此需配置上拉电阻使默认状态为高电平。卡片2防误触采样算法def is_person_present(self):confirm_count 0for _ in range(CONFIRM_SAMPLES): # 连续3次采样if self.read_raw():confirm_count 1else:confirm_count 0 # 失败则重置time.sleep(SAMPLE_INTERVAL) # 200ms间隔return confirm_count CONFIRM_SAMPLES作用消除环境干扰如宠物、飘动物体导致的误判提高系统可靠性。卡片3状态机设计模式STATE_IDLE IDLESTATE_DETECTED DETECTEDSTATE_TIMING TIMINGSTATE_ALERT ALERT# 根据条件转换状态if self.current_state self.STATE_IDLE:if person_detected:self.current_state self.STATE_DETECTED优势将复杂逻辑分解为离散状态使代码更易维护和理解避免深层嵌套if-else。卡片4单调时钟计时import timestart time.monotonic() # 单调递增时钟# ... 执行操作 ...elapsed time.monotonic() - start # 精确计时区别time.time()受系统时间调整影响time.monotonic()保证单调递增适合精确计时场景。卡片5优雅的资源管理def shutdown(self):if self.alert_active:self.notifier.stop_alert()self.sensor.cleanup() # 清理GPIOself.notifier.cleanup() # 关闭串口重要性确保程序异常退出时仍能正确释放硬件资源避免GPIO锁死或串口占用。七、总结本系统通过红外传感状态机声光报警的组合实现了智能门禁的异常停留检测功能核心价值在于1. 安全性提升10秒阈值可配置及时预警潜在安全风险2. 管理效率优化自动化检测减少人工监控成本3. 可扩展性模块化设计便于添加人脸识别、手机APP通知等功能4. 可靠性保障防误触机制资源清理确保系统稳定运行技术亮点- 采用状态机模式管理复杂流程- 使用单调时钟保证计时精度- 实现完整的资源生命周期管理- 模块化设计支持功能扩展未来优化方向- 增加WiFi模块实现远程通知- 添加数据库存储历史数据- 集成机器学习算法识别行为模式- 开发Web管理界面本方案不仅适用于小区门禁还可扩展至银行、实验室等需要人员管控的场所具有广泛的应用前景。利用AI解决实际问题如果你觉得这个工具好用欢迎关注长安牧笛