围岩助手

2. 它是什么

这是一款运行在 Android 手机上的徕卡全站仪模拟器。它通过蓝牙 SPP 与「测量员」等采集软件通信，模拟真实全站仪的角度与距离读数、设站、坐标读取，适用于隧道收敛监测、施工放样等场景的仿真测试。

• 测量模拟：Hz / V / HD / SD 实时读数，可选定坐标点作为目标。
• 坐标管理：CSV 导入（UTF-8 / GBK 自动识别），多项目隔离。
• 收敛监测：按里程分组，A/B 收敛点与拱顶点自动推进。
• 协议对接：内置采集软件所需的应答逻辑，连上即可用，无需填写协议参数。
• 蓝牙 SPP：被动（服务器）/ 主动（客户端）双模式。

3. 安装与权限

系统要求 Android 6.0（API 23）及以上。首次打开 App 会自动做三件事：

1. 申请蓝牙权限Android 12 及以上需要「附近设备」（扫描与连接），部分机型还需要定位权限。
2. 请求开启系统蓝牙蓝牙未开启时弹出系统对话框。
3. 启动蓝牙 SPP 服务默认以服务器模式等待采集软件连接。

4. 首次激活

首次使用需要联网。启动后先进入授权检查，没有有效授权时停在激活页，激活页会显示本机设备码（可复制）。有两种进入方式：

方式一：激活码

把设备码发给软件提供方换取激活码，在激活页输入后提交；服务端签发授权，客户端用内置公钥验签并保存，随后进入主界面。

方式二：管理员直接授权

激活页会自动上报设备（大约每 10 秒一次），后台显示为「待激活」。管理员在后台直接授权后，App 会自动进入主界面，不需要激活码。

授权类型与联网要求

• 在允许的离线时间内，打开 App 不会等待网络；超出窗口时启动会做一次约 6 秒的在线校验。
• 在线时前台仍会后台复查，后台吊销会在几秒内生效，并自动退回激活页。
• 设置页底部显示授权状态和精确到秒的剩余时间，到期后各页面会自动退出。

激活相关的报错

5. 连接采集软件

1. 确认手机蓝牙已开启并已授予附近设备权限。
2. 在采集软件里搜索设备蓝牙名称默认「Leica TS09」，可在设置页修改。
3. 连接连接成功后手机通知栏显示「已连接: XXX」，此时采集软件即可发命令。
4. 开始测量采集软件发起测量，App 自动应答。

两种蓝牙模式

设置页可扫描附近蓝牙设备并选为连接目标。

6. 三个主页面

App 分为三个页面，通过底部导航栏切换：测量、收敛、设置。

7. 测量页

导入坐标（CSV）

• 点击右上角文件图标导入，支持 里程,点名,N,E,Z；也支持 点名,N,E,Z 或 点名,N,E。
• 自动识别 UTF-8 / GBK 编码。
• 已有数据时会询问：追加（保留已有）或 覆盖（清空后导入）。
• 长按文件图标可导出 CSV。

里程,点名,N,E,Z
K12+100,G1,1234.5678,5678.9012,100.0000

选择与测量

1. 选择里程在左侧列表点选里程分段。
2. 选择目标点在右侧点坐标点，选中后顶部显示该点的 Hz / V / HD / SD。
3. 自动测量选中目标即触发一次模拟测量；也可由采集软件下发测量命令触发。
4. 自动跳转采集软件读取当前点坐标后，自动选中下一个坐标点，等待下一次测量命令。

长按操作

• 长按左侧里程：删除整个里程。
• 长按右侧坐标点：编辑 N / E / Z。

8. 收敛监测页

用于隧道收敛：每个里程下有多组收敛点（A/B）与若干拱顶点，测量时按 A → B 自动推进。

CSV 导入格式

推荐 4 列格式：

里程,类别,点号,数据
K12+100,收敛,G1,12.345
K12+100,拱顶,SD1,25.678

• 类别为「收敛」：创建一组 A/B 收敛点，第 4 列为收敛距离。
• 类别为「拱顶」：创建一个拱顶点，第 4 列为 Z 高程，X/Y 自动随机生成。
• 兼容旧 3 列格式：里程,点号,距离，按收敛组处理。

交互

收敛测量流程

1. 选组点击某个收敛组（如 G1），进入收敛测量模式。
2. 测 A 点模拟器切到 A 点，采集软件测量并读取坐标。
3. 自动到 B 点响应发出后自动推进到 B 点，等待下一次测量。
4. 完成A/B 都测完，该组标记为完成并自动退出收敛模式。

里程支持 K12+345.678 这类桩号格式，按桩号数值升序排列；DK90+100 等非 K+ 格式排在末尾。

9. 设置页

10. 数据保存

坐标、收敛数据与设置都保存在手机内部存储，退出或重启后自动恢复；卸载应用会一起清除，重要数据请先导出 CSV。

11. 常见问题