Software User Guide

Requirements

  • Host PC (Windows 10 or later)

    • with administrator and internet access

    • 1920 by 1080 or greater screen resolution, recommended

The AD-BMSE2E3W-SL GUI also referred as the Light EV BMS GUI is a PC-based Graphical User Interface (GUI) tool designed to work in conjunction with the AD-BMSE2E3W-SL board.

MyAnalog.com account is required to download the software.

Follow the steps below to create a MyAnalog account:

  1. Go to MyAnalog and create an account using email. Select the Register with email option to get started.

  2. Once you have a MyAnalog account, log in to MyAnalog using your credentials.

Request for Software Access

Note

Send the following details to this email address to request for software access:

LEV_CSESupport@analog.com

  • MyAnalog email address

  • Company

  • Country

  • Purpose/Projects

Software Download

  1. Download from: AD-BMSE2E3W-SL Version 1.0.0

  2. You will be directed to the Software Package Download page. Tick the checkbox and click the I Accept button to indicate acceptance of the license agreement.

  3. Click the Download button to download the installer.

Note

When software updates or new versions of the software are available, Analog Devices sends a notification to the email address associated with the MyAnalog account used to download the original software package.

GUI Installation

  1. Double-click on ad-bmse2e3w-sl-rel1.0.0.exe to install the program to your computer.

    ../../../../_images/gui_executable_file.png

    Figure 1 AD-BMSE2E3W-SL-Rel1.0.0 Installer File

  2. Accept the license terms and click Next to proceed with the installation. The default installation directory is in C:\Analog Devices\

../../../../_images/gui_installation.png

Figure 2 License Terms and Agreement

  1. Locate the light_ev_bmsv1.0.0.hex file inside the AD-BMSE2E3W-SL installer files folder.

    C:\Analog Devices\AD-BMSE2E3W-SL-Rel1.0.0\Software\Firmware

    ../../../../_images/firmware_location.png

    Figure 3 Firmware Location inside the Installer Files Folder

  2. Drag and drop the .hex file into the DAPLink drive to flash the program on the MCU.

    ../../../../_images/hex_file_to_daplink.png

    Figure 4 Drag-and-drop HEX to DAPLink Drive

  3. Find the Light_EV_BMS_GUI.exe file inside the AD-BMSE2E3W-SL installer files folder.

    C:\Analog Devices\AD-BMSE2E3W-SL-Rel1.0.0\Software\GUI\Light_EV_BMS_GUI_v1.0.0

    ../../../../_images/gui_executable_file_location.png

    Figure 5 Installer File Location

  4. Double-click the Light_EV_BMS_GUI.exe file to open the program. You should see a script running in the background separately and the landing page running in the browser.

    ../../../../_images/background_script.png

    Figure 6 Background Script

    ../../../../_images/home_landing_page.png

    Figure 7 GUI Landing Page

Interface Setup

../../../../_images/home_landing_details.png

Figure 8 Landing Page Menu

Table 1 Details Available on the Landing Page

No.

Function

Definition

1

Connection Indicator

Shows if UART or CAN is connected

2

Communication Mode Drop Down

Allows selection of the communication mode

3

Vehicle System Mode

Contains a dropdown list for vehicle system states such as parked, driving, charging, and fault

4

Refresh Button

Updates the list of available communication ports

5

Battery Specifications

Input boxes for battery specifications which are used for SoC and SoH

6

Load Defaults Button

Sets the battery specification values to the predefined default program entries

7

Start Button

Initiates battery monitoring and directs users to the Overview page

  1. Set the jumper configuration based on the communication mode being used: UART or CAN.

    ../../../../_images/communication_jumper_selection.png

    Figure 9 Selecting the Communication Mode

    On the GUI landing page, hover to the Communication Mode dropdown menu. Select UART COM followed by the specific port number if using UART, or CAN if using CAN.

    ../../../../_images/communication_mode.png

    Figure 10 Communication Mode Menu

    Press the RESET button every time the hardware set up is changed.

    ../../../../_images/reset_button_hardware.png

    Figure 11 RESET Button

  2. Click the Load Defaults button to set the initial entry values for the different parameters needed for the State of Charge (SoC) and State of Health (SoH) calculations.

    ../../../../_images/setting_defaults.png

    Figure 12 Loading Default Settings

  3. Click the Start button to begin the measurements.

    ../../../../_images/start_button.png

    Figure 13 Start Button

Tabs

Overview

The Overview tab features plots for stack voltage, module current, max charge current, max discharge current, cell voltages, cell temperatures, and state of the battery. This tab also allows setting of the vehicle state, which by default is set to “PARKED”.

../../../../_images/update_overview_page.png

Figure 14 Overview Tab

Graph

The Graph tab enables checking the progression of the readings for different parameters such as the cell voltage, temperature, SoC, SoH, and pack voltage and current.

../../../../_images/update_graph_page.png

Figure 15 Graph Tab

Console

Presents the actual numerical data being fetched by the UI in a tabular form. This tab allows the user to study or qualify the data, if needed.

../../../../_images/update_console_page.png

Figure 16 Console Tab

Diagnostic

This tab enables the user to check any anomaly detected by the BMS devices. Some of these diagnostic functions are cell overvoltage and undervoltage, open wire detection, and others.

Indicators:

  • Green color = passed (or no issue detected)

  • Red color = failed

../../../../_images/update_diagnsotic_page.png

Figure 17 Diagnostics Tab