01 · 准备设备

1. 准备一台 Android 8.0 及以上、支持低功耗蓝牙（BLE）的手机作为数据端，保持可用的 Wi-Fi 或移动网络。
2. 准备一块带兼容蓝牙接口的 BMS。当前包含 Ant、JK、JBD、Daly 和蓝猫动力／赛航常见协议的实验适配；具体型号和固件需实测。设备能被搜索到不代表可以读取。
3. 准备随身 iPhone 或 Android 手机作为查看端。数据端与查看端须使用同一服务器、同一账户；两台手机无需处于同一 Wi-Fi。
4. 先用原厂 App 核对电池读数，再断开原厂 App 与 BMS 的蓝牙连接，避免同时占用连接。为数据手机准备适合长期使用的供电和通风放置方式。

02 · 下载与安装

1. 用数据手机的系统浏览器打开支持页，点击“下载 Android 安装包”。若微信等内置浏览器无法下载，请选择“在浏览器中打开”。
2. 近年的 Android 手机优先选择推荐版。较旧的 32 位手机或 x86 设备，在“其他设备版本与文件校验”中选择对应版本；只安装一个 APK。下载完成后，从浏览器下载记录或系统“文件／下载”打开安装包，推荐版文件名为 easy-bms-android-0.1.8-arm64-v8a.apk。
3. 如系统询问安装来源，进入对应浏览器或文件管理器的设置，允许“安装未知应用／允许来自此来源”，返回后继续安装。只需授权本次使用的来源，安装后可关闭该授权。
4. 在系统安装界面确认应用名为 Easy BMS，选择“安装”，完成后点击“打开”。若系统阻止安装，请查看阻止原因；由单位管理的设备可能需要管理员允许。

从旧版本更新

本次是独立发布签名。已安装的旧开发／测试版无法直接覆盖，系统可能提示“签名不一致”或“应用未安装”。请先保持联网，让待上传队列完成上传，导出需要保留的记录，记下账户和服务器地址，停止本机采集；然后卸载旧版、安装新版并重新连接和授权。

卸载会清除本机配置、诊断帧及未上传的数据，不会删除同一云端账户中的已上传记录。今后使用同一发布签名且版本号更高的安装包，可按系统流程覆盖更新。

安装成功：手机桌面出现 Easy BMS，打开后显示登录或注册页面。

03 · 登录同一账户

1. 首次使用点击“创建账户”，填写自己的邮箱和至少 8 位密码；已有账户直接登录。支持邮箱不是默认登录账户。
2. 默认服务地址已预填。通常无需修改；如果使用自己的服务，展开“服务器连接”并填写可访问的 HTTPS 地址。
3. 在查看端登录相同账户，并确认两端的服务器地址一致。若已有电池档案，选择目标电池；首次使用可直接进入下一步连接引导。

两端使用相同账户与服务器后，数据手机上传的电池才会出现在查看端。

04 · 连接并核对读数

1. 在 Android 监控首页选择“设置留车采集”。如果首页已显示电池，可从“留车数据手机 → 查看本机采集状态”进入，再按页面按钮配置连接。
2. 打开手机蓝牙，靠近目标保护板。按提示允许“附近的设备／蓝牙”权限；Android 11 及以下还可能需要位置权限和开启系统位置服务，以便扫描蓝牙。应用不上传车辆坐标。
3. 选择自己的保护板。找不到时开启“显示全部蓝牙设备”，根据名称、地址和信号确认目标，再点击“下一步：验证连接”。
4. 保留默认自动识别，点击“自动识别并读取”。出现读数后，将总压、电流、单体数量和温度与原厂读数核对。不要仅凭设备名称确认兼容。
5. 确认实际读数一致后，勾选“已与原厂 App 对照并确认读数”，点击“继续设置电池”。无法识别时进入问题排查，不要把诊断采集当成真实监控。

没有保护板时可选择“没有保护板？用模拟数据体验”。模拟读数会明确标注，仅用于体验，不代表真实电池状态。

连接成功：页面显示已识别的协议及电池读数，并可进入电池档案设置。

05 · 设置档案并开始采集

1. 确认电池名称、化学体系、单体串数及可选的额定容量。串数需与实物一致；容量单位为 Ah，不确定时可暂留空。使用已有档案时确认选中的是同一块电池。
2. 点击“保存并查看采集准备”进入“留车采集”。在“锁屏前准备”完成后台设置：允许持续后台运行、解除应用电池限制、允许采集通知；系统提供自启动设置时一并检查。
3. Sony 手机还需到“节电优能／节能优化”把 Easy BMS 设为“无限制”，返回后按真实设置勾选确认。其他品牌的菜单名称可能不同，可通过页面提供的设置入口检查。
4. 返回 App 点击“重新检查设置”，再点击“授权并开始采集”。如果系统再次提示权限，请按提示完成；如果要求替换授权，先确认旧数据手机确实需要停止上传。
5. 查看“保护板连接”与“数据上传”。应能读取真实样本，上传状态应出现“最近上传成功”，并且系统持续显示采集通知。

开始采集成功：本机显示采集运行状态，并有近期成功上传时间。仅显示蓝牙连接成功还不够。

06 · 完成锁屏与远程验证

1. 在随身手机打开同一电池，查看总压、电流和读数更新时间，确认与数据手机一致且继续变化。
2. 把查看端切换到移动网络或另一 Wi-Fi，确认仍可更新，以验证远程查看。数据端保持在 BMS 蓝牙范围内并正常联网。
3. 锁定数据手机屏幕至少 15 分钟，再在查看端确认读数更新时间持续推进。更新中断时先处理后台限制、网络与蓝牙连接，然后重新验证。
4. 依据电池厂家规格确认软件告警阈值；在查看端“我的 → 通知自检”检查通知权限、注册和推送服务配置，并发送测试通知。以手机实际显示为准。

本次 Android 包未配置极光推送。数据采集的常驻通知可以使用；Android 系统告警推送需另行配置。iPhone 告警推送需其应用和服务器已正确配置 APNs。远程读数更新不依赖极光推送。

可投入日常使用的检查点：真实读数已核对、近期上传成功、锁屏后仍更新、查看端可通过外网查看。

07 · 日常使用与停止采集

1. 持续确认手机供电、联网和读数更新时间。断网时本机可暂存并重试上传，但缓存有数量、时间及容量限制；不要把缓存当成永久备份。
2. 需要暂停时，在数据端点击“停止本机采集”并确认；重新采集使用“恢复本机采集”或按页面提示重新配置。停止采集不会切断电池供电。
3. 更换数据手机时，到“我的 → 电池与数据手机”查看或解绑旧设备，再在新手机重新连接、核对并授权；替换授权可能使旧队列无法补传。
4. 仅退出查看端账户不会停止独立授权的采集。卸载数据端前先等待上传完成；手动停止、强制停止、关机或撤销权限都可能使数据停止更新。

当查看端提示“当前电池状态未知”，应检查数据端；旧读数不能证明电池目前正常。Easy BMS 只监测状态，不修改 BMS 保护参数，也不执行远程断电。

08 · 问题排查

需要协助时发送邮件至 easy_bms@163.com，说明手机型号、系统及 App 版本、BMS 型号、出现时间和具体步骤。发送前检查截图或诊断材料，勿发送密码、验证码或访问令牌。

01 · Prepare your devices

1. Use an Android 8.0 or later phone with Bluetooth Low Energy (BLE) as the collection phone. Provide Wi-Fi or mobile data.
2. Use a BMS with a compatible Bluetooth interface. Experimental adapters cover common Ant, JK, JBD, Daly and Lanmao/Saihang protocols; verify your exact model and firmware. Discovery alone does not prove compatibility.
3. Use your everyday iPhone or Android as the viewer. Both phones must use the same server and account; they do not need to be on the same Wi-Fi.
4. Check readings in the manufacturer’s app first, then disconnect that app from the BMS to avoid competing Bluetooth connections. Provide suitable continuous power and a ventilated location for the collection phone.

02 · Download & install

1. Open the support page in a browser on the collection phone and tap Download Android APK. If an embedded browser cannot download it, open the page in your regular browser.
2. Use the recommended build for recent Android phones. Choose the matching 32-bit or x86 build under “Other device versions & file verification” if needed. Install only one APK. Open the completed download from browser downloads or Files/Downloads. The recommended file is easy-bms-android-0.1.8-arm64-v8a.apk.
3. If Android asks, enable Install unknown apps / Allow from this source for the browser or file manager you used. Return to the installer. You can turn this permission off after installation.
4. Confirm the app name is Easy BMS, tap Install, then Open. If the system blocks installation, review the reason; managed devices may need administrator authorization.

Updating an earlier version

This build introduces a dedicated release signing key. Earlier development/test builds cannot be updated in place and may show a signature mismatch or “App not installed.” Keep the old app online until pending uploads finish, export records you need, note your account and server, and stop collection. Then uninstall the old app, install this one, reconnect and authorize collection.

Uninstalling clears local settings, diagnostic frames and pending data; uploaded records in the same cloud account remain. Future packages signed with this release key and a higher version code can be installed as updates.

Success: Easy BMS appears on the phone and opens to sign-in or registration.

03 · Sign in to the same account

1. Tap Create account if new, using your own email and a password of at least 8 characters. Otherwise sign in. The support email is not a default login account.
2. The default service URL is prefilled. Usually no change is needed. For your own deployment, expand Server connection and enter its reachable HTTPS URL.
3. Sign in to the same account on the viewer and verify the server matches. Select the intended battery if one already exists; otherwise continue with connection setup.

The viewer displays uploads only for the same server and account.

04 · Connect & verify readings

1. On Android’s dashboard tap Set up collection. If a battery is already shown, use the collection-phone card and View local collection, then follow its setup button.
2. Turn on Bluetooth and move close to the BMS. Allow Nearby devices/Bluetooth permissions when prompted. Android 11 and earlier may also need location permission and location services for scanning; vehicle coordinates are not uploaded.
3. Select your BMS. If missing, enable Show all Bluetooth devices, verify its name/address/signal and tap Next: verify connection.
4. Keep automatic detection and tap Detect & read automatically. Compare pack voltage, current, cell count and temperatures with manufacturer readings; a device name is not evidence of compatibility.
5. Only after checking actual readings, acknowledge that you verified them against the manufacturer’s app, then tap Continue battery setup. If detection fails, use troubleshooting; diagnostic collection does not provide real monitoring.

Without a BMS, choose the simulated-data option. Simulated readings are explicitly labeled and are for demonstration only.

Success: the detected protocol and readings appear, and battery-profile setup becomes available.

05 · Set up the profile & start collection

1. Check battery name, chemistry, cell count and optional rated capacity in Ah. Cell count must match the physical battery. Leave capacity blank if unknown. When reusing a profile, verify it belongs to this battery.
2. Tap Save & prepare collection. On the collection screen, complete Before locking the screen: allow continuous background operation, remove battery restrictions, enable collection notifications and check auto-start where available.
3. On Sony phones, additionally set Easy BMS to Unrestricted in its power-saving settings and confirm the actual setting in the app. Other manufacturers use different menu names; use the provided settings links.
4. Return and tap Check settings again, then Authorize & start collection. Complete any permission prompts. If replacing an authorization, confirm that the previous collection phone should lose upload access.
5. Check BMS connection and Data upload: real samples should be available, a recent successful upload should appear, and the ongoing collection notification should remain visible.

Success: collection is running and a recent successful upload time is shown. Bluetooth connection alone is insufficient.

06 · Verify locked-screen & remote updates

1. Open the same battery on the remote phone and compare voltage, current and the reading timestamp. Verify that readings continue updating.
2. Switch the viewer to mobile data or another Wi-Fi network to check remote access. Keep the collection phone within Bluetooth range and online.
3. Lock the collection phone for at least 15 minutes and confirm that the reading timestamp continues advancing on the viewer. Resolve background, network or Bluetooth issues before repeating the check.
4. Set software alert thresholds using the battery manufacturer’s specifications. On the viewer use Account → Notification checks to review permission, registration and push configuration, and send a test. Confirm actual display on the phone.

This Android package does not configure JPush. The ongoing collection notification is available; Android system alert push needs separate configuration. iPhone alert push needs correctly configured APNs in the iOS app and server. Remote readings do not depend on JPush.

Ready for everyday use: actual readings verified, recent uploads confirmed, updates continue while locked, and the viewer works over an external network.

07 · Everyday use & stopping collection

1. Check power, connectivity and reading timestamps regularly. Offline readings can be cached and retried within time, count and size limits; the cache is not a permanent backup.
2. To pause, tap Stop local collection and confirm. Use Resume local collection or follow setup prompts to restart. Stopping collection does not switch battery power off.
3. When replacing a collection phone, review or unbind it under Account → Batteries & gateways, then connect, verify and authorize the new phone. Replacing authorization may prevent old pending data from uploading.
4. Signing out of the viewer does not stop separately authorized collection. Wait for uploads before uninstalling the collection app. Manual stop, force-stop, shutdown and revoked permissions can interrupt updates.

If the viewer says the current battery state is unknown, inspect the collection phone. Previous readings cannot establish that the battery is currently normal. Easy BMS only monitors; it does not modify BMS protection settings or remotely cut power.

08 · Troubleshooting

For help email easy_bms@163.com with phone model, OS/app version, BMS model, time and steps. Review screenshots and diagnostics before sharing. Do not send passwords, verification codes or access tokens.