水准助手

2. 它是什么

水准助手是一款运行在 Android 手机上的电子水准仪模拟器。它不连接真实水准仪，而是在手机里模拟天宝（Trimble）DiNi 与徕卡（Leica）DNA / LS 系列电子水准仪的蓝牙应答与测量数据，供水准测量采集软件做通讯联调、教学研究和观测演练。

3. 安装与系统要求

• 系统要求：Android 8.0（API 26）及以上。
• 安装包为 APK，需要允许「安装未知来源应用」。
• 首次启动会自动进入授权检查；未授权时停留在激活页，无法进入主界面。
• 建议从桌面图标启动，而不是安装完成弹窗里的「打开」。

4. 首次激活

没有试用期，未激活会阻断进入主界面。激活页会显示本机 16 位设备码，并支持两种进入方式：

方式一：输入激活码

1. 复制设备码点击设备码右侧的复制按钮，把 16 位设备码发给软件提供方换取激活码。
2. 输入 16 位激活码激活码会自动分组显示，输入完成后点「激活软件」。
3. 联网校验首次激活必须联网（校验超时约 6 秒），服务端签发授权后本地验签保存，随后自动进入主界面。

方式二：等待管理员授权

在激活页点上报（页面会显示「已上报设备，等待管理员授权」），管理员在后台授权后，点「刷新授权状态」或稍候重试即可自动进入，无需激活码。

授权类型与离线宽限

• 授权状态分为待授权、已激活、已过期、已吊销；被吊销后即使本地有授权也会被清退。
• 主页会常显「授权剩余：X 天 X 小时 X 分 X 秒」，便于提前安排续期。
• 蓝牙服务、测量、导入、导出等关键操作前都会再做一次本地授权复验。

5. 主界面

主页从上到下是仪器图片、软件名「水准助手」、版本号与授权剩余时间；底部是三个入口：

• 外观提供三套主题：浅色极简、柔和现代、深色工程。切换后立即生效，主页与各页面同步变化。
• 关于页与帮助页可查看软件声明与内置帮助文档。

6. 设置项

设置页分为若干分组，修改后需点「保存设置」写入本地。默认值如下：

选择天宝时会显示 M5 / Rec500，选择徕卡时会显示型号与 GSI 格式，其余项自动隐藏。

7. 蓝牙连接

从机模式（默认，推荐）

1. 点亮设备并打开蓝牙进入测量页，点底部「设备状态」的仪器图标与蓝牙图标。
2. 在采集软件里搜索搜索蓝牙名称（默认 BtSPP），连接即可。
3. 收发数据采集软件发命令，手机按当前品牌/型号回数据。

主机模式（采集软件搜不到本机时用）

1. 先在系统蓝牙里配对打开手机系统蓝牙，配对要连接的那个蓝牙模块（或采集端的蓝牙设备）。
2. 设置里改成「主机」填写「蓝牙模块地址」，或点扫描选择附近已配对的模块。
3. 点亮蓝牙图标回到测量页点蓝牙图标，由手机主动发起连接。
4. 让采集软件连另一端采集软件连接其对侧的蓝牙链路，即可开始收发测量数据。

软件内置天宝与徕卡两套应答逻辑，可直接对接常见的水准测量采集软件，不需要填写任何协议参数。

8. 准备数据：导入与线路

先把要测的数据备好，再连机测量。整体顺序是：设置 → 连蓝牙 → 打开数据 → 逐站测量 → 导出。

导入现成数据

• 测量页顶部有「导入」入口，支持天宝 M5 .dat 与徕卡 GSI8 / GSI16 .gsi 原始观测文件，也兼容原有的文本数据导入。
• 导入后会自动解析测站、点名、视距与闭合差，不需要手工整理表格。
• 已有数据时会提示选择保留或替换，导入前先确认当前数据是否还要用。

线路与多期数据

主页「线路」用于把真实的 M5 / GSI 观测文件改造成多期沉降（或复测）数据，直接给采集软件观测。

1. 导入原始文件选择 .dat（天宝 M5）或 .gsi（徕卡 GSI8/GSI16），App 会解析测站、点名、视距与闭合差。
2. 核对线路信息第 1 步显示站数、观测点数、转点数与已知高差；可长按起点/终点修改点号与高程（总高差必须保持不变）。
3. 设置生成参数单次变化、累计变化、转点高程变化、闭合差上限、视距浮动与限差、尺读数范围等。
4. 生成并保存生成多期数据后进入期列表，每期可单独进入测量。

多期与折线

• 期列表显示「第 N 期 + 日期」，长按可重置本期进度、重命名、删除。
• 生成前会按视距比例对原始数据平差，以平差后的基准高程逐期变化。
• 单点累计变化折线可直接拖动编辑：只改当前顶点，其他顶点不动；第 1 期为基准，锁定为 0。
• 折线页顶部显示该点总累计变化量，竖轴按当前最大值自动取整，支持横屏精细拖动。
• 用采集软件实际观测并平差后，观测点变化量会严格等于折线设定值（误差 < 0.5 mm）。

测量页的数据集模式

从线路的某一期进入测量页时，顶栏显示「线路名 · 第 N 期」，隐藏导入按钮，每期测量进度独立保存。

9. 测量操作

测量页顶部是页面标题与「导入」入口；上方是测站表（站数 / 后视点 / 前视点），下方是观测数据表（前后视 / 点名 / 视距 / 尺读数）；底部左侧是「设备状态」，中间是圆形「测量」按钮，右下齿轮进入设置。

1. 点亮设备点底部「设备状态」里的仪器图标，设备由灰变亮。
2. 打开蓝牙点旁边的蓝牙图标：从机模式等待采集软件连接，主机模式主动连对端模块。
3. 开始测量点「测量」，按 BFFB 顺序逐条生成：后视 → 前视（异向）→ 前视（同向）→ 后视（异向）。
4. 采集软件联动采集软件下发测量命令时，App 也会推送一条符合当前格式的数据；测错可在数据列表里点回上一条重测。

• 每条读数在基础数据上叠加小幅随机波动，读数精度 0.00001 m，视距精度 0.001 m。
• 开启「控制时间」后，测量会按搬站/异向/同向参数模拟真实仪器的等待时间；关闭后约 1 秒即可返回。
• 开启「自动下一条」「自动测量」可让整个测站连续跑完。

10. 导出与备份

导出

在线路列表长按某条线路，选择「导出数据」，可选择天宝、徕卡或 CSV 格式：

<选择的目录>/
└─ 线路名/
   ├─ 第1期_2025-08-07.dat
   ├─ 第2期_2025-09-06.dat
   └─ ...

• 天宝 / 徕卡格式可直接用采集软件或平差软件打开，重新导入本软件也能恢复。
• CSV 适合用表格软件查看，包含期号、日期、站号、点名、前后视、尺读数与视距。

11. 常见问题