User Guide

1. Environment Preparation

1. Ensure your PC has .NET Framework 4.8 installed
2. Connect the BMS to your PC using a USB-to-CAN adapter
3. Open Device Manager and verify there is no yellow exclamation mark next to the corresponding CAN device

2. Software Installation

1. Obtain the installation package (taking V2.0.8 as an example; other versions follow the same process)
2. Right-click → Extract to current folder. The same operation applies to other extraction software. After extraction, you can copy it to your preferred location.

Note

An extraction password is required. You can ask me for it.

3. Open the extracted folder, right-click `HXHVBMSTool.exe` and send it to the desktop as a shortcut. This tool is a portable green version — no registry entries are written. Simply delete the folder to uninstall.

3. Software Uninstallation

Note

Make sure HXHVBMSTool is closed before uninstalling, otherwise the uninstallation may be incomplete.

Simply delete the entire folder.

4. Connecting to the Device

1. Open HXHVBMSTool
2. Select the communication interface CAN (default is fine). You need to install the corresponding drivers in advance based on the hardware type (no yellow exclamation marks in Device Manager)
3. Set the baud rate (default CAN: 500kbps). You also need to confirm the index number and channel

Index Number & Channel Explanation

• Index Number: Which CAN box is recognized by the PC. The 1st is 0, the 2nd is 1, supports up to 7 boxes.
• Channel: Physical interface on the CAN box. CAN1 → Channel 0, CAN2 → Channel 1.

4. Click "Connect" and then "Start CAN" to start receiving data:

Note

1. If a red pop-up appears when opening CAN, please install VC++ 2008. You can download it from the Driver Download page.
2. If no data appears after opening, check the wiring sequence and verify that the index number and channel are correct.

5. Reading Parameters

• When CAN is opened, the host tool will automatically display parameters. The messages are actively pushed by the BMS — the host tool does not actively query.
• Pages that display actively pushed information include: Basic Information, Status Display, and Cell Information.

6. Monitoring

• Enable Storage: Saves the parameters on the interface according to the Storage Interval. The saved data is in CSV format and stored in the local root directory.

7. Message Heartbeat

• The heartbeat indicates received CAN messages. Each message increments the heartbeat counter by one.
• To check whether the host tool is frozen or CAN is disconnected, observe the Message Heartbeat. A paused heartbeat means no messages are being received.

8. Model Selection

• This host tool is used for the company's high-voltage BMS. Since voltage and temperature configurations vary, a model selection option is provided, mainly affecting the Cell Information display.
• Before Log Saving, make sure to select the correct model. Otherwise, the saved cell voltages and temperatures may be incomplete.

9. Log Storage

• Before Log Saving, make sure to select the correct model. Otherwise, the saved cell voltages and temperatures may be incomplete.
• Storage Interval: Default is 1 second. All automatically pushed and parsed data will be saved. Saved to the root directory.
• Log Saving: Saves the parsed data from actively pushed messages according to the storage interval. The saved data is in CSV format and stored in the local root directory.
• Message Saving: Saves raw messages to the root directory. Save as needed.

10. Master Encoding

Primarily used for production. Please consult BMS developers for specific functionality.

11. Write Permission (Password)

• The host tool supports read and write operations on BMS parameters. To prevent accidental or unauthorized modifications, the write function is locked.
• Write operations can only be enabled after entering the correct password.
• Password-protected interfaces include: Parameter Settings and SN. Before login, buttons are disabled by default.

12. Status Bar (StatusStrip)

• The bar displaying information at the bottom is the status bar.
• The status bar shows company information, the current software version number, a progress bar, and the refresh time.
• Generally, the host tool displays the company logo, indicating that both the host tool and BMS are developed in-house.
• The progress bar shows the progress of parameter reading.
• The refresh time displays the timestamp of the current interface data, allowing you to know when the data was obtained.

13. Basic Information

Displays main parameters.

14. Status Display (Extended Basic Information)

Displays version number, detailed alarm protection status, AFE status, etc. This page is also recorded in the log.

15. Cell Information

Displays cell information, including cell voltage, cell temperature, spine temperature, and balancing temperature.

16. Parameter Settings & SN

Allows setting BMS parameters and SN number. Write permission is required.

17. History Data

• History Record Operations: Allows viewing the number of history records, enabling/disabling FIFO, reading, stopping, saving, and clearing the table.
  1. FIFO (First In, First Out): By default, FIFO is unchecked, meaning the newest history records are read first.
  2. Read: Starts reading history records.
  3. Pause: In the current version, clicking "Pause" directly terminates the reading process. The function name does not match its actual behavior. This will be fixed in a future version.
  4. Save: After reading is complete, exports the history records from the table to the root directory.
  5. Clear Table: Clears the read history data from the display (does NOT clear BMS history data). After clearing, memory usage will decrease due to C#'s automatic garbage collection mechanism.
• History Record Display: Can separately display overall history records, cell voltage history records, and cell temperature history records. Cell voltage displays 600 items by default, temperature displays 328 items. Due to control limitations, the number of columns cannot exceed 655, so voltage and temperature are displayed separately, and saved as two separate files.

18. Debug & Other Parameter Settings

This page allows setting CAN-related parameters and displaying board information (not critical).

19. Settings & Instructions

This page covers language switching, checking for updates, and usage instructions.

• Language Switching: When the software starts, it will automatically detect the system language. If the system language is Chinese, it loads Chinese by default. If not, it loads English. Manual switching is also available:
• Check for Updates: The host tool supports automatic online updates. When the software opens, it checks for new versions. If a new version is available, a pop-up will appear. You can also manually check for updates.
• Usage Instructions: The initial version of the user manual. Both versions are online documents.

20. Root Directory File Structure

Here you can find all data recorded by the host tool.

HXHVBMSTool/
├─ DebugLog/                      # Real-time communication messages (receive only, send not saved). Not saved automatically — must be manually enabled
├─ HistoryLog/                    # Historical data export files
├─ SaveLog/                       # Data storage location when continuous refresh + enable storage is active
├─ kerneldlls/                    # CAN driver core files (⚠️ Deleting will cause CAN to fail to open)
├─ LIVOLTEK_HV_BHF_S_Upper.exe    # Parallel unit monitoring host tool (supported in future versions)
├─ HXHVBMS_FirewareUpdate.exe     # Firmware upgrade tool (supported in future versions)
└─ ...                            # Other essential program files, do not delete arbitrarily

21. Frequently Asked Questions

• Unable to connect: Check the driver, baud rate, and wiring sequence
• Abnormal data: Confirm whether the BMS address matches the protocol version
• Host tool cannot open: Verify that the computer has .NET Framework 4.8 and VC++ 2008 installed

---

💬 Having issues?
Please check the Changelog to see if a new version is available, or provide feedback in the discussion group.