ESPresense-companion 项目教程

ESPresense-companion 项目教程

ESPresense-companion HA Add-on / Docker container that solves indoor positions with mqtt data received from multiple ESPresense stations 项目地址: https://gitcode.com/gh_mirrors/es/ESPresense-companion

1、项目介绍

ESPresense-companion 是一个用于室内定位的 HA Add-on 和 Docker 容器项目。它通过接收来自多个 ESPresense 站点的 MQTT 数据，来解决室内位置问题。该项目的主要功能包括：

• 室内定位：通过蓝牙低功耗（BLE）设备在房屋平面图中的位置进行定位。
• 节点管理：允许用户管理 ESPresense 节点。

2、项目快速启动

安装步骤

HAOS 安装

1. 添加仓库：在 HASS 的 Add-ons 商店中添加 ESPresense-companion 仓库。
2. 安装：点击安装，然后启动，并在侧边栏中显示。

Docker 安装

以下是一个示例的 docker-compose 配置文件：

version: '3.7'
services:
  espresense:
    image: espresense/espresense-companion
    ports:
      - 8267:8267
    volumes:
      - /data/espresense:/config/espresense

房间测量指南

1. 起点：从建筑/区域的左下角开始，作为原点 (0,0)。
2. 测量方向：选择顺时针或逆时针方向进行测量。
3. 示例：
   • 房间1：从 (0,0) 开始，向北移动 9 英尺（3 米）到 (3,0)，然后向右移动 12 英尺（4 米）到 (3,4)，最后回到 (0,4)。
   • 房间2：从 (3,0) 开始，宽度为 6 英尺（2 米）到 (5,0)，深度为 10.5 英尺（3.5 米）到 (5,3.5)，最后回到 (3,3.5)。

节点放置

• 最佳位置：在定位区域的角落放置基站节点，并额外放置一个节点（1-3 米内）。
• 精度：更多的节点可以提高定位精度。

节点配置

• 最大距离：将 ESPresense 节点的最大距离设置为零，以获取所有节点的距离读数。
• 示例：

  key: espresense/rooms/*/max_distance/set
  value: 0
  

微调

• 地图校准：通过悬停在地图上的设备来检查圆圈是否与实际位置对齐。
• RSS@1m 调整：如果圆圈过大或过小，可以调整 RSS@1m 值以提高精度。

3、应用案例和最佳实践

应用案例

• 智能家居：通过 ESPresense-companion 定位 BLE 设备，实现智能家居设备的自动化控制。
• 室内导航：在大型建筑物中，如商场或博物馆，提供室内导航服务。

最佳实践

• 节点布局：确保节点均匀分布在定位区域内，以提高定位精度。
• 定期校准：定期检查和校准节点，以确保定位数据的准确性。

4、典型生态项目

• ESPresense：与 ESPresense-companion 配合使用的核心项目，提供 BLE 设备的定位数据。
• Home Assistant：与 ESPresense-companion 集成，实现智能家居的自动化控制。
• MQTT Broker：用于接收和分发 ESPresense 节点的数据。

ESPresense-companion HA Add-on / Docker container that solves indoor positions with mqtt data received from multiple ESPresense stations 项目地址: https://gitcode.com/gh_mirrors/es/ESPresense-companion