Skip to content

GUI Software Specifics

Jump to bottom
Pooja-2204 edited this page Sep 15, 2023 · 28 revisions

Running ADI BMS UI Application EXE:

  • On the host computer, download BMCU Board GUI Executable(see the Reference Section).
  • Open the extracted BMCU Board GUI Executable folder navigate to Executable\BMS Application\BMS-GUI
  • Open the application named BMS-GUI.exe
  • Determine the COM port of the BMCU Board Unit by going to windows Device Manager.
  • After opening in the PC/Host configuration Tab set the required configuration data like OV, UV thresholds, COM port, number of boards.
  • Set the baud rate to 115200
  • Check the GUI user guide for detailed information, check References for link

Figure 5. BMCU Board GUI
Figure 5. BMCU Board GUI

1. GUI FlOW

The following figure shows the top-level GUI communication flow.

GUI Measurement Flow
GUI Measurement Flow

  1.1 PC/Host Configuration Tab

This is the first tab, use this tab for setting the required configuration data and then click connect button. NOTE: This UI works for atmost 3 boards, hence select boards is limited to 3 and and after disconnecting if different configuration data needs to be filled(specific to boards) then restart GUI.

Configuration Tab
Configuration Tab

After Connect button is pressed the system tabs and board tabs will be created and Connect button name will change to Disconnect.

 1.1.1 Configuration

  1.1.1.1 COM Port

Use this field for setting the COM port which is created after hardware setup is done.

  1.1.1.2 Baud Rate

Baud rate (115200) is available for now and it will work fine.

  1.1.1.3 No of Boards

Use this drop down for selecting the number of ADBMS boards you wish to connect and monitor.

  1.1.1.4 Sample Rate

This field is for frequency of at which the readings need to be updated in GUI.

  1.1.1.5 Under Voltage

Use this field for setting under voltage threshold that should be given in units V, with respect to this UV faults will occur.

  1.1.1.6 Over Voltage

Use this field for setting over voltage threshold that should be given in units V, with respect to this OV faults will occur.

  1.1.1.7 Connect/Disconnect

  • For connect operation fill in the required configuration details and click on Connect button.
  • After clicking on Connect button, it will change to Disconnect button and board tabs, BMS-CTRL tabs will be created.
  • For disconnect operation click on Disconnect button.
  • After clicking on Disconnect button, it will change to Connect button.

Configuration Tab After Connect
Configuration Tab After Connect

  1.1.1.8 Start/Stop

  • Click on the Start button for starting the measurement
  • After clicking on Start button, it will change to Stop button and Stack graph in Host configuration starts plotting with respect to the board’s stack voltage, readings and graph in the board tabs will be updated as per its value.
  • For stop operation click on Stop button.
  • After clicking on Stop button, it will change to Start button.

Configuration Tab After Start
Configuration Tab After Start

 1.1.2 System Status

This field indicates the whole system status with the following 2 sub fields.


  1.2 ADBMS Board Tab

  • Maximum boards supported by this GUI is 3
  • Depending on the board count specified in configuration data, that number of board tabs are created having one board selected for each tab.
  • For monitoring a particular board, click on that numbered board tab.

Board Tab with Graph
Board Tab with Graph

  1.2.1 Faults

  • These faults are board specific faults.





  1.2.2 Cell Voltages

  • The fields under this section displays the cell voltages of each cell from cell-1(C1V) to cell- 18(C18V).

  1.2.3 GPIO Voltages

  • The fields under this section displays the gpio voltages of each gpio from gpio-1(G1V) to gpio- 9(G9V).

  1.2.4 Stat Value

  1.2.4.1 Stack(voltage)

  • This field indicates the current board’s total cell voltage.

  1.2.4.2 ITMP

  • This field indicates the current board’s Internal Die Temperature value.

  1.2.4.3 VregA

  • This field indicates the current board’s analog power supply voltage value.

  1.2.4.4 VregD

  • This field indicates the current board’s digital power supply voltage value.

  1.2.4.5 REV

  • This field indicates the current board’s revision number.

  1.2.4.6 MUXFAIL

  • This field indicates the current board’s mux fail status after having self-test.

  1.2.4.7 THSD

  • This field indicates the current board’s thermal shutdown status.

  1.2.5 Cell/Stack Voltage measurement

  • Time[s] vs Voltage[V] is present on right side of the tab, to check the graph of a particular cell first click on the Start Graph button and check the required cell’s field.
  • For cell voltage within the range the cells color will be in white color and for UV and OV the cell will be filled with the respective fault’s color.

  1.3 BMS Control Unit

  • This tab consists of the block diagram of all the ADI parts used in this project.
  • Each ADI part block is connected to it’s respective webpage.
  • Click on a particular ADI part block takes to the product page.
  • At left bottom corner a button with name “Click here for Schematics” is available

NOTE: Schematics link need to be updated for this button.(From source code need to assign link to variable “link_of_Schematics_str“ from constant.py file)

BMS Control Unit Reference
BMS Control Unit Reference

2. KNOWN ISSUES AND LIMITATIONS

  1. The GUI works for a maximum of 3 boards.
  2. For the first time, opening GUI application will take some time to load.
  3. Once UI is started with specific configuration then to load a different configuration (COM port, no. of boards so on), restart the UI.
  4. After hitting “Connect” button on the “PC Configuration Tab”, GUI takes few seconds to update status and may be unresponsive for few seconds.
  5. Cell Open Wire detection algorithm does not give expected results.

GUI Software Development

Clone this wiki locally