Skip to content

使用指南

1. 环境准备

  1. 确保 PC 已安装 .NET Framework 4.8
  2. 使用 USB 转 485 / CAN 适配器连接 BMS 与 PC
  3. 打开设备管理器,确认对应串口 / CAN 设备无黄色感叹号

2. 软件安装

  1. 拿到安装包(这里以V3.0.22举例,其他版本一致) HXLVBMSTool 界面预览
  2. 双击安装包,选择安装语言(支持简体中文繁體中文English),点击「确定」。 HXLVBMSTool 界面预览
  3. 选择自己喜欢的位置安装(默认路径为D:\HXLVBMSTool,不推荐安装到C盘,因为记录日志需要申请管理员权限),并点击下一步。 HXLVBMSTool 界面预览
  4. 根据自己喜好选择是否添加至桌面快捷方式(推荐添加),然后点击下一步。 HXLVBMSTool 界面预览
  5. 然后点击安装(这里不做任何设置,仅确认安装设置)。
  6. 安装后点击完成即可完成安装。

3. 软件卸载

提示

卸载前请确保已关闭 HXLVBMSTool,否则可能导致卸载不完整。

  1. 打开 Windows 控制面板 → 程序和功能
  2. 在列表中找到 HXLVBMSTool
  3. 右键点击,选择 卸载 / Uninstall
  4. 按照卸载向导提示完成操作 HXLVBMSTool 界面预览

4. 连接设备

  1. 打开 HXLVBMSTool
  2. 选择通信接口(485 / CAN),这里需要提前根据硬件类型安装各驱动(设备管理器中没有黄色感叹号)
  3. 设置波特率(默认 485为9600kbps / CAN为500kbps),如果是CAN,还需要确认索引号和通道
  4. 点击「连接」:
    • 按钮变为 绿色:连接成功
    • 按钮变为 红色:连接失败,并弹出错误提示 HXLVBMSTool 界面预览

默认加载

  1. 在打开软件时,会默认加载上一次关闭时的配置;如果没有配置,则会选择搜索到的第一个设备进行选择。
  2. 设备名称会在窗体加载或点击设备名称下拉框时,自动搜索当前电脑所有设备,默认选择第一个。

5. 读取参数

  • 点击「单次读取」可以显示基本信息并机汇总信息。
  • 点击「连续刷新」可以循环刷新显示基本信息并机汇总信息,下面进度条会实时显示每一次读取的进度以及是否读取成功。 HXLVBMSTool 界面预览HXLVBMSTool 界面预览
  • 当读取失败时,会显示N/A,表示读取失败; HXLVBMSTool 界面预览
  • 当连续读取失败 ≥ 100次时,会弹窗提示读取失败次数过多,会自动停止当前连续刷新,以释放系统资源。 HXLVBMSTool 界面预览
  • 当连续刷新时,为了保证报文不冲突,不允许读取其他参数,在读取其他参数时,请停止连续刷新。

6. 监控及日志

  • 主控选择:默认一个BMS时,主控默认为01;当有多个BMS时,可以手动切换主控来对其他BMS进行读取。目前最多支持16个BMS,如有需要,可以进行扩充!
  • 启动存储:只有在连续刷新时才有效,否则不会对数据进行记录。每刷新完一次,记录一次

协议限制说明

由于协议存在较多断点报文,单次刷新需读取约 8 帧数据,耗时接近 1 秒。
为保证日志准确性,当前采用“每读取一次,记录一次”的策略,而非定时保存。

7. 写入权限(密码)

  • 上位机支持对 BMS 参数进行读写操作,为避免误操作或未经授权的修改,写入功能被锁定。
  • 仅在输入正确密码后,才可启用写入操作。
  • 密码涉及的界面有:主控配置和告警保护参数配置,登录前,按钮默认隐藏; HXLVBMSTool 界面预览

8. 轮询个数、轮询与搜索BMS

  • 这里主要是针对多并机使用,当只有一个BMS时,默认ID为1;当有多个BMS时,ID依次递增;
  • 多并机时,首先需要点击搜索BMS,将系统中所有BMS让上位机检测到以进行轮询操作,这里最多为16个BMS,如果需要可以进行扩充至64个: HXLVBMSTool 界面预览
  • 当这里搜索完成后,会将当前在线的ID添加到轮询个数中,在这里你可以查看刚刚扫描到的BMS ID。假设使用拨码方式编码,拨码为ID1、ID4、和ID12,那么会将01、04和12添加到轮询个数中。如果启动软件后没有进行搜索操作,则默认显示01到16;
  • 如果在连续刷新时,会读取主控选择中的ID,此时,如果点击开始轮询按钮,那么会主控选择中的的ID将随轮询个数的ID依次递增,实现的效果就为ID1刷新一次、ID4刷新一次、ID12刷新一次,后面再继续跳转到ID1、ID4、ID12继续刷新。
  • 如果每刷新完一次后,发现启动存储被打开,则存储一条记录到本地日志,ID及通讯配置都将存储到本地日志。

并机汇总信息

当这里搜索完成后,并机汇总信息将读取最小ID的信息,而不是默认的ID1!

9. 基本信息

  • 红框里面的为基本信息; HXLVBMSTool 界面预览

10. 状态栏(StatusStrip)

  • 最下面展示信息的一栏为状态栏
  • 状态栏会显示公司信息,当前软件版本号,一个进度条以及刷新时间
  • 一般上位机会显示公司logo,表示此上位机和BMS由公司自研。
  • 进度条可以显示实时刷新时的进度以及读取参数告警保护的进度。
  • 刷新时间可以显示当前界面数据的刷新时间,以知道这些数据是什么时候的。 HXLVBMSTool 界面预览

11. 主控配置

  • 主控配置:主要设置BMS相关的参数。具体参数,请询问BMS研发人员,与本业务无关。
  • 需要修改主控配置,请进行密码登录。
  • 这个页面在读取时,需要点击全部读取,点击写入可以写入对应参数。
  • 清空:点击清空按钮,可以将主控配置页面的参数进行清空,以进行下一次读取。 HXLVBMSTool 界面预览HXLVBMSTool 界面预览HXLVBMSTool 界面预览HXLVBMSTool 界面预览HXLVBMSTool 界面预览HXLVBMSTool 界面预览

输入小提示

本上位机在写入参数时,会自动过滤非数字,所以请务必确保输入的数字是准确的,输入符号等其他字符没有影响。
比如在输入25℃时,可以直接输入25,其他情况比如25℃25mV25CC,只会认识25这个数字。

12. 告警保护参数配置

  • 这里是对BMS的一、二和三级告警进行读写操作。
  • 同样需要密码权限。
  • 这个页面的内容支持全部读取全部写入HXLVBMSTool 界面预览HXLVBMSTool 界面预览HXLVBMSTool 界面预览HXLVBMSTool 界面预览HXLVBMSTool 界面预览HXLVBMSTool 界面预览
  • 导出导入参数:可以对本页面的告警保护参数进行导出与导入操作,以进行恢复或者存储,以xml文件进行存储。 HXLVBMSTool 界面预览HXLVBMSTool 界面预览HXLVBMSTool 界面预览
  • 点击清空按钮,可以将此页面的内容进行清空操作。

13. 历史记录

  • 这里可以对BMS的存储信息进行操作,包括配置和读取及显示。
  • 点击读取可以对BMS进行读取,读取的内容将显示到历史记录展示中,点击停止可以中止读取,点击保存可以将展示的信息保存至根目录,点击清空可以对展示的历史记录进行清空操作。
  • 由于读取的信息会占用一部分内存,建议在读取完后进行清空操作,由于C#机制,在清空后会自动进行GC机制以降低内存使用。
  • 先进先出:默认不勾选,此时读取的历史记录从最新的开始展示;如果勾选,那么将从最早一条开始读取并显示。 HXLVBMSTool 界面预览HXLVBMSTool 界面预览

14. 固件烧录及证书导入

  • 这里可以对BMS进行升降级操作,具体是否可升级性,可以咨询BMS开发人员。
  • 可以进行证书导入操作,此证书主要是用于BMS远程连接,仅485连接时可用,具体操作步骤请询问BMS开发人员。
  • 按照步骤1、2、3、4即可进行升级,步骤1不可用。
  • 当只有是CAN连接时,才可以进行广播升级,485只能升级单个,升级ID为主控选择的ID。
  • 烧录用时:升级的传包时间。 HXLVBMSTool 界面预览
  • 升级时,如果传包错误,连续发送10次还是不行的话,将显示Fail,即升级失败。如果没问题,则显示PASS,表示升级成功,升级成功后,上位机自己会发送重启指令,无需手动重启。 HXLVBMSTool 界面预览
  • 证书写入,支持拖拽文件到透明框中,也可以选择文件,也可以手动输入,总之,发送的数据取自透明框。 HXLVBMSTool 界面预览

15. 设置Debug说明 - CAN板卡信息及0x351

此页面主要是对上位机进行设置。包括CAN板卡信息、0x351、检查更新、语言切换、驱动下载、小工具和使用说明。

  • CAN板卡信息:当连接CAN盒时,可以显示CAN盒的信息,这些信息来源于CAN盒。
  • 0x351:这里时针对于连接CAN盒以及发送派能协议时,解析的0x351报文将显示在这里,只是作为上位机搭建框架的测试模块,后续不提供开发。

16. 设置Debug说明 - 检查更新(上位机在线OTA升级)

  • 在点击检查或者在软件启动时,会自动检查更新,如果有更新的版本,将会以弹窗提示,自行选择是否在线下载更新,由于安装包体积较小,下载速度很快,所以更新几乎是在10秒以内操作完成。
  • 更新不是必须的,但每次更新必有原因,要么修复BUG,要么添加新功能,总之推荐更新。后续可能会强制更新。
  • 当更新失败时(由于Git抽风),可以前往群聊下载最新版上位机或此网站下载。

17. 设置Debug说明 - 驱动下载

当打开上位机,找好工具后,发送搜索不到CAN设备时,可以前往此页面下载驱动,这里准备了USBCANIICANalyst-II和软件运行环境,单击即可下载。

18. 设置Debug说明 - 语言切换

  • 由于此上位机售后需要面向海外用户,所以加入了英语的选项。
  • 在打开本软件时,会识别当前系统语言,如果系统为中文,则语言自动切换为中文,如果系统语言为非中文,则自动切换为English,当然也可以手动进行切换! HXLVBMSTool 界面预览

19. 设置Debug说明 - 小工具

可以对半人开发的上位机保存的数据进行作图操作。可以支持鼠标缩放,导出为图片等。 HXLVBMSTool 界面预览HXLVBMSTool 界面预览

20. 设置Debug说明 - 此页面其他操作

  • 上位机使用说明:早期写的html文件,现在不太能用了,因为开发了新的网站,新的网站更强大!
  • 关于:早期写的html文件,用于介绍自己及开发背景,现已不需要。
  • 更新日志:此网站记录了从V3.0.21及以下的更新日志,新的更新日志以本网站为主,旧网站虽好,但不再维护。 HXLVBMSTool 界面预览
  • 打开根目录:可以打开软件的安装目录,可以方便查看保存的文件等!

21. 通讯日志

  • 这个页面可以查看上位机收发的报文,会实时自动保存到本地跟目录,根目录会有介绍。
  • 默认保存近15天的报文,需要的报文及时拷贝保存,超过15天则自动删除。 HXLVBMSTool 界面预览

22. 根目录文件介绍

在这里,你可以找到上位机记录的所有数据。

HXLVBMSTool/
├─ CommuLog/        # 实时通信报文(每帧+操作步骤),默认保留 15 天,过期自动删除
├─ Config/          # 上位机配置文件(⚠️ 不可随意修改)
├─ HistoryLog/      # 历史数据导出文件
├─ kerneldlls/      # CAN 驱动核心文件(⚠️ 删除将导致 CAN 无法打开)
├─ SaveLog/         # 连续刷新 + 启动存储时的数据保存位置
└─ ...              # 其他为程序运行必需文件,请勿随意删除
HXLVBMSTool 界面预览

23. 常见问题

  • 无法连接:检查驱动、波特率、接线顺序
  • 数据异常:确认 BMS 地址与协议版本是否匹配
  • 上位机无法打开:确认电脑已经安装dotnet4.8环境和VC++2008

💬 遇到问题?
请前往 更新日志 查看是否有新版本,或在交流群中反馈。

本工具不可替代专业检测设备,关键场景请以官方认证工具为准。本网站及配套工具由个人学习开发,非海兴 / Livoltek 官方网站