second batch files for ad-bmse2e3w-sl

docs/solutions/reference-designs/ad-bmse2e3w-sl/Components.csv

@@ -0,0 +1,16 @@
+#,Part,Function
+1,Battery Cell Connector,Connector going to battery cells
+2,ADBMS6830 (U1),BMS 1 Cell Monitoring Chip with LPCM capability
+3,ADBMS6830 (U3),BMS 2 Cell Monitoring Chip with LPCM capability
+4,NTC Provision (U1),Connector for Negative Temperature Coefficient (NTC) Thermistor in ADBMS6830 (U1)
+5,NTC Provision (U3),Connector for Negative Temperature Coefficient (NTC) Thermistor in ADBMS6830 (U3)
+6,ADBMS2950 (U5),Voltage Pack and Current Pack Monitor Chip
+7,ADBMS6822 (U10),Dual isoSPI chip
+8,VBAT+ Connector,Positive Terminal Connector for total voltage capacity of the battery pack
+9,Rsense Pack Monitor,Resistor Sensing for detecting and monitoring total current in the pack
+10,72V to 96V LINK+_OUT Load Connector,Connector going to the load side of the system
+11,72V to 96V LINK+_IN Charger Connector,Connector going to the charging side of the system
+12,CAN Connector,"Three terminal connector provision for CAN_H, CAN_L, and GND communication"
+13,Micro USB Supply Provision,5V DC USB supply provision
+14,UART/SWDIO Connector,Connector for UART/SWDIO communication. Can be used to download program and debugging
+15,MAX32690 MCU Chip,Low power/high power MCU chip used as controller for the system

docs/solutions/reference-designs/ad-bmse2e3w-sl/Specifications.csv

@@ -0,0 +1,37 @@
+SYSTEM,,,,,
+Parameter,Min,Typical,Max,Unit,Notes
+System Vin+ Supply Voltage from Battery,60,,100,V,Input voltage supply from battery
+Battery Emulator System Output Voltage,~66,,92,V,Safe output voltage from Battery Emulator
+Current Discharge,,50,100,A,Current rating that the BMS can deliver at discharge mode
+Current Charge,0.3,50,100,A,Current rating that the BMS can deliver at pre-charge/charge mode
+Pre-Charge Resistor,,3×33,,Ω,
+Charge Voltage Input,,,100,V,
+Discharge Voltage Output,,65,92,V,Regulated voltage range
+FET Discharge Rise Time,,,42,mS,
+FET Driver Discharge Input,,,5,V,Coming from GPIO of ADBMS2950
+FET Pre-Charge/Charge Rise Time,,,88,mS,
+FET Driver Pre-Charge/Charge Input,,,5,V,Coming from GPIO of ADBMS2950
+FET V(gs) range,-20,,20,V,Coming from GPIO of ADBMS2950
+FET Rds(on) range,,,4.8,mΩ,Coming from GPIO of ADBMS2950
+ADBMS6830 Cell Monitor,,,,,
+"Total Supply Voltage, V+ to V−",-0.3,,85,V,
+VREG Supply,4.5,5,5.5,V,
+"VREF1, VREF2",3,,3.3,,Supply to internal ADCs
+VRES/VDD,4.5,5,5.5,V,
+Temp,-40,,125,°C,
+CPIN Input Range,-2.5,,5.5,V,
+Cell Count,17,,32,,Min of 17 cells for the system to initiate daisy chain
+Drive,-0.3,,7,V,Drive voltage range with respect to each cell monitoring V-
+ADBMS2950 Pack Monitor,,,,,
+Main Supply Voltage In,14,,,V,
+VREG Pack Monitor,4.5,5,5.5,V,
+"Current Input S1A, I1A, I1B",-4,,4,V,
+"Current Input S1A, I1A, I1B",-4,,4,V,
+"Current Input S2A, I2A, I2B",-4,,4,V,
+"Current Input I3A, I3B",-4,,4,V,
+MAX32690 Microcontroller,,,,,
+MCU Supply Voltage from BMS,3.3,,5.5,V,
+MCU IO Supply for 1.8 V,1.6,,3,V,
+MCU VDD Supply,3.3,,5.5,V,
+MCU Supply at 1.2 V,1.1,,1.35,V,
+MCU Supply at 1.0 V,0.9,,1.2,V,

docs/solutions/reference-designs/ad-bmse2e3w-sl/sample_application/index.rst

@@ -0,0 +1,52 @@
+Application
+==============
+
+72V to 96V Light EV Basic System Application
+----------------------------------------------
+
+Below diagram depicts the essential components needed when using this BMS reference design for basic electric 2-wheeler or 3-wheeler applications. Each block represents a component. Use the diagram as a guide to understand the system operation.
+
+.. image:: 72v-96v_vehicle_system.png
+
+
+1. **Battery Cell/Pack Block** - This block is where your battery supply or source is located. There are two configurations on how to connect the battery cells to the BMS:   
+
+
+  **Single Side Cell Depopulation** 
+
+ .. image:: single_side_cell_depopulation.png
+
+
+  **Dual Side Cell Depopulation** 
+
+ .. image:: dual_side_cell_depopulation.png
+
+
+ .. note:: The setup shown in this User Guide uses the single side depopulation method only in connecting/aligning the cell to the BMS. The dual side depopulation is not yet supported by the software.
+
+
+
+2. **BMS Block** - This block is where the BMS Cell and Pack Monitoring and MCU control happens. This block is also responsible for the control of the **Charging** (if the battery needs to be charged) and **Discharging** (when the battery needs to deliver voltage output going to the load side).
+
+
+3. **User Interface Display** - This block is where the measurement, diagnosis, and status of the BMS are displayed. The Display can have two options (or you can use both):
+
+   **UART Communication** 
+
+   .. image:: uart_comm.png
+
+   **CAN-BASIC Communication** 
+
+   .. image:: basic_can_comm.png
+
+
+   .. note:: For the BASIC CAN setup, we use the `PCAN-USB connector <https://www.peak-system.com/PCAN-USB.199.0.html?&L=1>`_` as our CAN interpreter. This product is __not included__ in the AD-BMSE2E3W-SL Kit and needs to be purchased separately.
+
+
+4. **Load** - This block is where you can place your external load. The voltage output at this level can vary from 72V to 96V with 50A to 100A range current capacity. The system implements a low side current sensing using Rshunt (sense resistor) where the VBAT- of the battery is connected to the upper end of the Rshunt bar and Shunt- is connected to the lower end of the Rshunt. The Shunt- will then be connected to the end of the load or the negative supply of the load.
+
+   .. image:: load_diagram.png
+
+
+
+After the set up for vehicle and load connection is done, you can now load the sample firmware for vehicle application. 

docs/solutions/reference-designs/ad-bmse2e3w-sl/software_guide/index.rst

@@ -0,0 +1,179 @@
+AD-BMSE2E3W-SL 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 <https://www.analog.com/en/index.html>`_`  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 <https://www.analog.com/en/index.html>`_` using your credentials.
+
+
+
+
+Request for Software Access
+------------------------------
+
+.. note:: Send the following details to this email address: 
+
+    **[email protected]**
+
+     * MyAnalog email address
+     * Company
+     * Country
+     * Purpose/Projects
+
+
+
+Software Download
+--------------------
+
+1. Click this link: `AD-BMSE2E3W-SL Version 1.0.0 <https://download.analog.com/secure/bms-cse-solutions/e2e3w-00/1-0-0/ad-bmse2e3w-sl-rel1.0.0.exe>`_`
+
+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. 
+
+ .. image:: gui_executable_file.png
+
+
+2. Accept the license terms and click *Next* to proceed with the installation. The default installation directory is in ``C:\Analog Devices\``
+
+  .. image:: gui_installation.png
+
+
+3. 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``
+
+ .. image:: firmware_location.png
+
+
+4. Drag and drop the .hex file into the DAPLink drive to flash the program on the MCU.
+
+  .. image:: hex_file_to_daplink.png
+
+
+5. 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``
+
+  .. image:: gui_executable_file_location.png
+
+
+6. 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.
+
+  .. image:: background_script.png
+
+  .. image:: home_landing_page.png
+
+
+
+
+Interface Setup
+-------------------
+
+ .. image:: home_landing_details.png
+
+ .. csv-table:: Details Available on the Landing Page
+   :file: landing-page.csv
+   :widths: 10, 20, 70
+   :header-rows: 1
+
+
+
+1. Set the jumper configuration based on the communication mode being used: UART or CAN.
+
+ .. image:: communication_jumper_selection.png
+
+ 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.
+
+ .. image:: communication_mode.png
+
+
+ Press the ``RESET`` button every time the hardware set up is changed.
+
+ .. image:: reset_button_hardware.png
+
+
+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. 
+
+ .. image:: setting_defaults.png
+
+
+3. Click the ``Start`` button to begin the measurements.
+
+ .. image:: start_button.png
+
+
+
+
+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".
+
+.. image:: update_overview_page.png
+
+
+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.
+
+.. image:: update_graph_page.png
+
+
+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.
+
+.. image:: update_console_page.png
+
+
+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
+
+ .. image:: update_diagnsotic_page.png
+
+
+
+Help and Support
+----------------
+
+For questions and more information, please visit the `EngineerZone Support Community <https://ez.analog.com/reference-designs>`_.

docs/solutions/reference-designs/ad-bmse2e3w-sl/software_guide/landing-page.csv

@@ -0,0 +1,8 @@
+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

docs/solutions/reference-designs/ad-bmse2e3w-sl/test-points.csv

@@ -0,0 +1,9 @@
+TP Name,Description,Function,Voltage Range
+TP2,U1 ADBMS6830 BMS1_VREG,U1 Input Voltage BMS1_VREG for ADBMS6830,Low voltage: 15 V to 20 V
+,,,High voltage: (50 V to 58 V)
+TP4,U3 ADBMS6830 BMS2_VREG,U3 Input Voltage BMS2_VREG input for ADBMS6830,0 V to 5 V
+TP7,U6 LTC3639 Output,U6 LTC3639 Regulator Voltage Output,4.5 V to 5.5 V
+TP8,U9 LT8303 Output,U9 LT8303 Switch Down Regulator Output,3.2 V to 3.5 V
+R346,U15 MAX25301A Output,U15 MAX25301A Output 3.3 V going to MCU,3.2 V to 3.5V
+(Left Pin),,,
+TP16,VBAT+,Total Voltage Supply from battery,72 V to 92 V (regulated)