树莓派4BPythonTF-Luna打造高灵敏度室内安防距离报警系统智能家居安防系统正逐渐从专业领域走向普通家庭而距离传感器作为核心组件之一其应用场景越来越广泛。TF-Luna这款低成本、高性能的激光雷达模块配合树莓派4B的强大处理能力可以快速搭建一套可靠的室内安防报警系统。本文将手把手教你如何用Python实现一个能监测门窗、走廊等关键区域的智能报警装置。1. 硬件准备与环境配置在开始编码前我们需要确保所有硬件组件正确连接并配置好开发环境。这套系统主要由三部分组成树莓派4B作为控制中心TF-Luna雷达作为距离传感器以及一些简单的报警输出设备如LED或蜂鸣器。1.1 所需材料清单核心设备树莓派4B任何型号均可建议2GB内存以上版本TF-Luna雷达模块出厂默认UART通信协议5V/3A电源适配器为树莓派供电MicroSD卡16GB以上安装Raspberry Pi OS连接线材USB转TTL串口模块如CH340G杜邦线母对母若干可选LED灯和220Ω电阻用于视觉报警软件准备Raspberry Pi OS64位Lite版即可Python 3.7通常系统已预装pip工具用于安装Python依赖库1.2 硬件连接示意图将TF-Luna与树莓派通过USB转TTL模块连接TF-Luna USB转TTL模块 树莓派 VCC(红) → 5V/VCC → 不连接单独供电 GND(黑) → GND → GND TX(绿) → RX → 不连接 RX(蓝) → TX → 不连接注意TF-Luna的工作电压为5V但通信电平是3.3V确保使用兼容的USB转TTL模块。错误的电压可能损坏设备。1.3 树莓派串口配置树莓派默认将硬件串口分配给蓝牙模块我们需要先释放出来供TF-Luna使用sudo raspi-config依次选择Interface Options → Serial Port当询问Would you like a login shell...时选择No当询问Would you like the serial port hardware...时选择Yes完成后退并重启树莓派验证串口是否启用ls /dev/serial*应该看到类似/dev/serial0 - ttyAMA0的输出。接下来安装必要的Python库sudo apt update sudo apt install python3-pip pip3 install pyserial RPi.GPIO2. TF-Luna数据读取与处理TF-Luna通过串口以特定协议发送距离数据我们需要理解其通信协议并编写Python代码来解析这些数据。2.1 TF-Luna通信协议解析TF-Luna的默认输出帧格式为9字节字节位置内容说明00x59帧头110x59帧头22-3Dist_L, Dist_H距离值厘米低字节在前4-5Strength_L, Strength_H信号强度低字节在前6-7Temp_L, Temp_H芯片温度低字节在前8Checksum校验和前面8字节的和2.2 Python串口通信实现创建一个名为tf_luna_reader.py的文件写入以下基础代码import serial import struct import time class TFLuna: def __init__(self, port/dev/serial0, baudrate115200): self.ser serial.Serial(port, baudrate, timeout1) def get_distance(self): while True: # 等待帧头 if self.ser.read() b\x59 and self.ser.read() b\x59: # 读取剩余7字节 data self.ser.read(7) if len(data) 7: # 解析数据 distance data[0] data[1] * 256 strength data[2] data[3] * 256 temperature (data[4] data[5] * 256) / 8 - 256 checksum data[6] # 校验 if (0x59 0x59 sum(data[:6])) 0xff checksum: return distance, strength, temperature def close(self): self.ser.close() if __name__ __main__: tfluna TFLuna() try: while True: dist, strength, temp tfluna.get_distance() print(f距离: {dist}cm, 强度: {strength}, 温度: {temp:.1f}℃) time.sleep(0.1) except KeyboardInterrupt: tfluna.close()运行此脚本(python3 tf_luna_reader.py)你应该能看到实时距离数据输出。如果遇到问题检查以下几点串口设备权限问题sudo usermod -a -G dialout pi波特率设置确保与TF-Luna配置一致默认115200硬件连接特别是TX/RX交叉连接是否正确2.3 数据滤波与优化原始传感器数据可能存在噪声我们可以通过软件滤波提高稳定性from collections import deque import numpy as np class EnhancedTFLuna(TFLuna): def __init__(self, window_size5, *args, **kwargs): super().__init__(*args, **kwargs) self.distance_window deque(maxlenwindow_size) self.strength_threshold 100 # 最小有效信号强度 def get_filtered_distance(self): while True: dist, strength, temp self.get_distance() if strength self.strength_threshold: self.distance_window.append(dist) if len(self.distance_window) self.distance_window.maxlen: # 使用中值滤波消除异常值 filtered_dist np.median(self.distance_window) return int(filtered_dist), strength, temp这种滤波方式能有效消除瞬时干扰特别适合监测门窗等可能偶尔有干扰如小虫飞过的场景。3. 报警逻辑设计与实现有了可靠的距离数据后我们需要设计报警触发机制和多种报警方式。3.1 基础阈值报警系统创建一个新的Python文件alarm_system.pyimport RPi.GPIO as GPIO from enhanced_tfluna import EnhancedTFLuna import time class DistanceAlarm: def __init__(self, threshold_cm100): self.tf EnhancedTFLuna() self.threshold threshold_cm self.alarm_pin 17 # 使用GPIO17控制报警LED # GPIO设置 GPIO.setmode(GPIO.BCM) GPIO.setup(self.alarm_pin, GPIO.OUT) GPIO.output(self.alarm_pin, GPIO.LOW) def run(self): try: while True: dist, strength, _ self.tf.get_filtered_distance() if dist self.threshold: self.trigger_alarm() else: GPIO.output(self.alarm_pin, GPIO.LOW) time.sleep(0.05) finally: GPIO.cleanup() self.tf.close() def trigger_alarm(self): 基础报警点亮LED GPIO.output(self.alarm_pin, GPIO.HIGH) if __name__ __main__: alarm DistanceAlarm(threshold_cm150) alarm.run()3.2 多模式报警扩展基础LED报警可以扩展为多种形式声音报警连接蜂鸣器或通过音频接口播放警报音网络通知通过SMTP发送邮件或使用Pushbullet发送手机通知本地记录将入侵事件记录到CSV文件或SQLite数据库以下是集成邮件通知的扩展版本import smtplib from email.mime.text import MIMEText from datetime import datetime class EnhancedAlarm(DistanceAlarm): def __init__(self, email_configNone, *args, **kwargs): super().__init__(*args, **kwargs) self.email_config email_config self.last_alert_time 0 self.alert_cooldown 300 # 5分钟内不重复发送 def trigger_alarm(self): super().trigger_alarm() # 保持基础LED报警 # 邮件报警 if (self.email_config and time.time() - self.last_alert_time self.alert_cooldown): msg MIMEText(f警报检测到物体接近当前距离{self.last_distance}cm) msg[Subject] 家庭安防系统警报 msg[From] self.email_config[from] msg[To] self.email_config[to] try: with smtplib.SMTP(self.email_config[smtp_server], self.email_config[smtp_port]) as server: server.starttls() server.login(self.email_config[username], self.email_config[password]) server.send_message(msg) self.last_alert_time time.time() except Exception as e: print(f邮件发送失败: {e})3.3 报警逻辑优化简单的阈值报警可能产生误报我们可以实现更智能的检测逻辑class SmartAlarm(EnhancedAlarm): def __init__(self, *args, **kwargs): super().__init__(*args, **kwargs) self.movement_history [] self.trigger_duration 2 # 持续2秒超阈值才触发 def check_movement(self, current_dist): self.movement_history.append(current_dist self.threshold) self.movement_history self.movement_history[-self.trigger_duration*20:] # 只有当超过阈值的比例大于90%时才触发 if sum(self.movement_history) / len(self.movement_history) 0.9: self.trigger_alarm() self.movement_history.clear() # 触发后重置这种基于持续时间的检测能有效过滤瞬时干扰如窗帘飘动或宠物短暂经过等情况。4. 系统部署与优化建议完成代码开发后我们需要考虑如何将系统部署到实际环境中并优化其性能。4.1 安装位置选择TF-Luna的安装位置直接影响监测效果安装位置优点缺点适用场景门框上方隐蔽性好监测范围广安装需要打孔大门、阳台门墙角覆盖面积大不易被发现可能有盲区走廊、过道窗台直接监测窗户开启暴露在外可能被破坏低层窗户安装时需注意保持传感器与监测平面垂直避免正对镜面或高反射率表面距离监测区域1-3米为最佳工作范围4.2 树莓派性能优化长期运行的树莓派需要适当优化# 禁用不必要的服务 sudo systemctl disable bluetooth.service sudo systemctl disable hciuart.service # 设置CPU governor为performance echo GOVERNORperformance | sudo tee /etc/default/cpufrequtils sudo systemctl restart cpufrequtils # 增加USB缓冲区减少串口数据丢失 echo net.core.rmem_max4194304 | sudo tee -a /etc/sysctl.conf echo net.core.wmem_max1048576 | sudo tee -a /etc/sysctl.conf sudo sysctl -p4.3 系统自启动配置创建systemd服务实现开机自启创建服务文件/etc/systemd/system/tfluna_alarm.service[Unit] DescriptionTF-Luna Alarm System Afternetwork.target [Service] ExecStart/usr/bin/python3 /home/pi/alarm_system.py WorkingDirectory/home/pi StandardOutputinherit StandardErrorinherit Restartalways Userpi [Install] WantedBymulti-user.target启用并启动服务sudo systemctl daemon-reload sudo systemctl enable tfluna_alarm.service sudo systemctl start tfluna_alarm.service4.4 实际使用中的调整建议距离阈值根据季节变化调整如冬天门窗可能结霜影响测量信号强度检查定期检查TF-Luna的强度值低于100可能表示传感器脏污或偏移多传感器协同对于大区域可部署多个TF-Luna并通过MQTT协议统一管理电源管理户外部署考虑使用PoE供电或太阳能电池板这套系统在我家后院门部署已稳定运行6个月成功检测到3次异常接近事件。最实用的是邮件通知功能即使不在家也能及时获知潜在风险。对于有编程基础的智能家居爱好者这个项目提供了很好的安防解决方案基础后续可以根据需要扩展更多功能如与家庭自动化系统联动或添加视频录制功能。
树莓派4B+Python+TF-Luna：三步搞定一个简易室内安防距离报警器
发布时间：2026/7/11 20:24:34
树莓派4BPythonTF-Luna打造高灵敏度室内安防距离报警系统智能家居安防系统正逐渐从专业领域走向普通家庭而距离传感器作为核心组件之一其应用场景越来越广泛。TF-Luna这款低成本、高性能的激光雷达模块配合树莓派4B的强大处理能力可以快速搭建一套可靠的室内安防报警系统。本文将手把手教你如何用Python实现一个能监测门窗、走廊等关键区域的智能报警装置。1. 硬件准备与环境配置在开始编码前我们需要确保所有硬件组件正确连接并配置好开发环境。这套系统主要由三部分组成树莓派4B作为控制中心TF-Luna雷达作为距离传感器以及一些简单的报警输出设备如LED或蜂鸣器。1.1 所需材料清单核心设备树莓派4B任何型号均可建议2GB内存以上版本TF-Luna雷达模块出厂默认UART通信协议5V/3A电源适配器为树莓派供电MicroSD卡16GB以上安装Raspberry Pi OS连接线材USB转TTL串口模块如CH340G杜邦线母对母若干可选LED灯和220Ω电阻用于视觉报警软件准备Raspberry Pi OS64位Lite版即可Python 3.7通常系统已预装pip工具用于安装Python依赖库1.2 硬件连接示意图将TF-Luna与树莓派通过USB转TTL模块连接TF-Luna USB转TTL模块 树莓派 VCC(红) → 5V/VCC → 不连接单独供电 GND(黑) → GND → GND TX(绿) → RX → 不连接 RX(蓝) → TX → 不连接注意TF-Luna的工作电压为5V但通信电平是3.3V确保使用兼容的USB转TTL模块。错误的电压可能损坏设备。1.3 树莓派串口配置树莓派默认将硬件串口分配给蓝牙模块我们需要先释放出来供TF-Luna使用sudo raspi-config依次选择Interface Options → Serial Port当询问Would you like a login shell...时选择No当询问Would you like the serial port hardware...时选择Yes完成后退并重启树莓派验证串口是否启用ls /dev/serial*应该看到类似/dev/serial0 - ttyAMA0的输出。接下来安装必要的Python库sudo apt update sudo apt install python3-pip pip3 install pyserial RPi.GPIO2. TF-Luna数据读取与处理TF-Luna通过串口以特定协议发送距离数据我们需要理解其通信协议并编写Python代码来解析这些数据。2.1 TF-Luna通信协议解析TF-Luna的默认输出帧格式为9字节字节位置内容说明00x59帧头110x59帧头22-3Dist_L, Dist_H距离值厘米低字节在前4-5Strength_L, Strength_H信号强度低字节在前6-7Temp_L, Temp_H芯片温度低字节在前8Checksum校验和前面8字节的和2.2 Python串口通信实现创建一个名为tf_luna_reader.py的文件写入以下基础代码import serial import struct import time class TFLuna: def __init__(self, port/dev/serial0, baudrate115200): self.ser serial.Serial(port, baudrate, timeout1) def get_distance(self): while True: # 等待帧头 if self.ser.read() b\x59 and self.ser.read() b\x59: # 读取剩余7字节 data self.ser.read(7) if len(data) 7: # 解析数据 distance data[0] data[1] * 256 strength data[2] data[3] * 256 temperature (data[4] data[5] * 256) / 8 - 256 checksum data[6] # 校验 if (0x59 0x59 sum(data[:6])) 0xff checksum: return distance, strength, temperature def close(self): self.ser.close() if __name__ __main__: tfluna TFLuna() try: while True: dist, strength, temp tfluna.get_distance() print(f距离: {dist}cm, 强度: {strength}, 温度: {temp:.1f}℃) time.sleep(0.1) except KeyboardInterrupt: tfluna.close()运行此脚本(python3 tf_luna_reader.py)你应该能看到实时距离数据输出。如果遇到问题检查以下几点串口设备权限问题sudo usermod -a -G dialout pi波特率设置确保与TF-Luna配置一致默认115200硬件连接特别是TX/RX交叉连接是否正确2.3 数据滤波与优化原始传感器数据可能存在噪声我们可以通过软件滤波提高稳定性from collections import deque import numpy as np class EnhancedTFLuna(TFLuna): def __init__(self, window_size5, *args, **kwargs): super().__init__(*args, **kwargs) self.distance_window deque(maxlenwindow_size) self.strength_threshold 100 # 最小有效信号强度 def get_filtered_distance(self): while True: dist, strength, temp self.get_distance() if strength self.strength_threshold: self.distance_window.append(dist) if len(self.distance_window) self.distance_window.maxlen: # 使用中值滤波消除异常值 filtered_dist np.median(self.distance_window) return int(filtered_dist), strength, temp这种滤波方式能有效消除瞬时干扰特别适合监测门窗等可能偶尔有干扰如小虫飞过的场景。3. 报警逻辑设计与实现有了可靠的距离数据后我们需要设计报警触发机制和多种报警方式。3.1 基础阈值报警系统创建一个新的Python文件alarm_system.pyimport RPi.GPIO as GPIO from enhanced_tfluna import EnhancedTFLuna import time class DistanceAlarm: def __init__(self, threshold_cm100): self.tf EnhancedTFLuna() self.threshold threshold_cm self.alarm_pin 17 # 使用GPIO17控制报警LED # GPIO设置 GPIO.setmode(GPIO.BCM) GPIO.setup(self.alarm_pin, GPIO.OUT) GPIO.output(self.alarm_pin, GPIO.LOW) def run(self): try: while True: dist, strength, _ self.tf.get_filtered_distance() if dist self.threshold: self.trigger_alarm() else: GPIO.output(self.alarm_pin, GPIO.LOW) time.sleep(0.05) finally: GPIO.cleanup() self.tf.close() def trigger_alarm(self): 基础报警点亮LED GPIO.output(self.alarm_pin, GPIO.HIGH) if __name__ __main__: alarm DistanceAlarm(threshold_cm150) alarm.run()3.2 多模式报警扩展基础LED报警可以扩展为多种形式声音报警连接蜂鸣器或通过音频接口播放警报音网络通知通过SMTP发送邮件或使用Pushbullet发送手机通知本地记录将入侵事件记录到CSV文件或SQLite数据库以下是集成邮件通知的扩展版本import smtplib from email.mime.text import MIMEText from datetime import datetime class EnhancedAlarm(DistanceAlarm): def __init__(self, email_configNone, *args, **kwargs): super().__init__(*args, **kwargs) self.email_config email_config self.last_alert_time 0 self.alert_cooldown 300 # 5分钟内不重复发送 def trigger_alarm(self): super().trigger_alarm() # 保持基础LED报警 # 邮件报警 if (self.email_config and time.time() - self.last_alert_time self.alert_cooldown): msg MIMEText(f警报检测到物体接近当前距离{self.last_distance}cm) msg[Subject] 家庭安防系统警报 msg[From] self.email_config[from] msg[To] self.email_config[to] try: with smtplib.SMTP(self.email_config[smtp_server], self.email_config[smtp_port]) as server: server.starttls() server.login(self.email_config[username], self.email_config[password]) server.send_message(msg) self.last_alert_time time.time() except Exception as e: print(f邮件发送失败: {e})3.3 报警逻辑优化简单的阈值报警可能产生误报我们可以实现更智能的检测逻辑class SmartAlarm(EnhancedAlarm): def __init__(self, *args, **kwargs): super().__init__(*args, **kwargs) self.movement_history [] self.trigger_duration 2 # 持续2秒超阈值才触发 def check_movement(self, current_dist): self.movement_history.append(current_dist self.threshold) self.movement_history self.movement_history[-self.trigger_duration*20:] # 只有当超过阈值的比例大于90%时才触发 if sum(self.movement_history) / len(self.movement_history) 0.9: self.trigger_alarm() self.movement_history.clear() # 触发后重置这种基于持续时间的检测能有效过滤瞬时干扰如窗帘飘动或宠物短暂经过等情况。4. 系统部署与优化建议完成代码开发后我们需要考虑如何将系统部署到实际环境中并优化其性能。4.1 安装位置选择TF-Luna的安装位置直接影响监测效果安装位置优点缺点适用场景门框上方隐蔽性好监测范围广安装需要打孔大门、阳台门墙角覆盖面积大不易被发现可能有盲区走廊、过道窗台直接监测窗户开启暴露在外可能被破坏低层窗户安装时需注意保持传感器与监测平面垂直避免正对镜面或高反射率表面距离监测区域1-3米为最佳工作范围4.2 树莓派性能优化长期运行的树莓派需要适当优化# 禁用不必要的服务 sudo systemctl disable bluetooth.service sudo systemctl disable hciuart.service # 设置CPU governor为performance echo GOVERNORperformance | sudo tee /etc/default/cpufrequtils sudo systemctl restart cpufrequtils # 增加USB缓冲区减少串口数据丢失 echo net.core.rmem_max4194304 | sudo tee -a /etc/sysctl.conf echo net.core.wmem_max1048576 | sudo tee -a /etc/sysctl.conf sudo sysctl -p4.3 系统自启动配置创建systemd服务实现开机自启创建服务文件/etc/systemd/system/tfluna_alarm.service[Unit] DescriptionTF-Luna Alarm System Afternetwork.target [Service] ExecStart/usr/bin/python3 /home/pi/alarm_system.py WorkingDirectory/home/pi StandardOutputinherit StandardErrorinherit Restartalways Userpi [Install] WantedBymulti-user.target启用并启动服务sudo systemctl daemon-reload sudo systemctl enable tfluna_alarm.service sudo systemctl start tfluna_alarm.service4.4 实际使用中的调整建议距离阈值根据季节变化调整如冬天门窗可能结霜影响测量信号强度检查定期检查TF-Luna的强度值低于100可能表示传感器脏污或偏移多传感器协同对于大区域可部署多个TF-Luna并通过MQTT协议统一管理电源管理户外部署考虑使用PoE供电或太阳能电池板这套系统在我家后院门部署已稳定运行6个月成功检测到3次异常接近事件。最实用的是邮件通知功能即使不在家也能及时获知潜在风险。对于有编程基础的智能家居爱好者这个项目提供了很好的安防解决方案基础后续可以根据需要扩展更多功能如与家庭自动化系统联动或添加视频录制功能。
