From 3d3d38af0488ada31e74f58b3668e0ce3fed8a01 Mon Sep 17 00:00:00 2001 From: Joyce Velasco Date: Wed, 1 Jul 2026 14:00:41 +0800 Subject: [PATCH 1/2] solutions: ref-designs: add AD-BMSE2E3WLC-SL documentation --- .../AD-BMSE2E3WLC-SL_block_diagram.png | 3 + .../AD-BMSE2E3WLC-SL_solution_kit.png | 3 + .../hardware-guide/36-96V-full-setup.png | 3 + .../hardware-guide/48V-connection.png | 3 + .../hardware-guide/baseboard-components.png | 3 + .../hardware-guide/baseboard-led-on.png | 3 + .../hardware-guide/baseboard-shunt-config.png | 3 + .../hardware-guide/baseboard-testpoints.png | 3 + .../hardware-guide/baseboard-to-emulator.png | 3 + .../daughterboard-components.png | 3 + .../daughterboard-shunt-config.png | 3 + .../daughterboard-to-emulator.png | 3 + .../hardware-guide/emulator-led-on.png | 3 + .../hardware-guide/full-integration-setup.png | 3 + .../ad-bmse2e3wlc-sl/hardware-guide/index.rst | 272 ++++++ .../max32666fthr-connection.png | 3 + .../max32666fthr-to-max32625pico.png | 3 + .../ad-bmse2e3wlc-sl/index.rst | 286 ++++++ .../ad-bmse2e3wlc-sl/package-contents.png | 3 + .../software-guide/ACE-homepage.png | 3 + .../software-guide/ACEZIP-file.png | 3 + .../software-guide/AD-BMSE2E3WLC-SL_GUI.png | 3 + .../software-guide/ace-on-start-menu.png | 3 + .../ace-serial-ports-config.png | 3 + .../software-guide/ace-software-download.png | 3 + .../ace-software-installation.png | 3 + .../ad-bmse2e3wlc-48v-plugin.png | 3 + .../software-guide/device-manager-comport.png | 3 + .../software-guide/driving-mode-pd.png | 3 + .../software-guide/firmware-upload.png | 3 + .../ad-bmse2e3wlc-sl/software-guide/index.rst | 851 ++++++++++++++++++ .../software-guide/libiio-check.png | 3 + .../software-guide/libiio-version.png | 3 + .../max32625_pico_bin_upload.png | 3 + .../software-guide/maximum-voltage-test.png | 3 + .../software-guide/minimum-voltage-test.png | 3 + .../software-guide/parked-mode-pd.png | 3 + .../software-guide/parked-mode-setup.png | 3 + .../software-guide/plugin-TOU.png | 3 + .../software-guide/sample-reading-in-CLI.png | 3 + 40 files changed, 1520 insertions(+) create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/AD-BMSE2E3WLC-SL_block_diagram.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/AD-BMSE2E3WLC-SL_solution_kit.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/36-96V-full-setup.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/48V-connection.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/baseboard-components.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/baseboard-led-on.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/baseboard-shunt-config.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/baseboard-testpoints.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/baseboard-to-emulator.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/daughterboard-components.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/daughterboard-shunt-config.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/daughterboard-to-emulator.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/emulator-led-on.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/full-integration-setup.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/index.rst create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/max32666fthr-connection.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/max32666fthr-to-max32625pico.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/index.rst create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/package-contents.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/ACE-homepage.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/ACEZIP-file.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/AD-BMSE2E3WLC-SL_GUI.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/ace-on-start-menu.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/ace-serial-ports-config.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/ace-software-download.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/ace-software-installation.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/ad-bmse2e3wlc-48v-plugin.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/device-manager-comport.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/driving-mode-pd.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/firmware-upload.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/index.rst create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/libiio-check.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/libiio-version.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/max32625_pico_bin_upload.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/maximum-voltage-test.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/minimum-voltage-test.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/parked-mode-pd.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/parked-mode-setup.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/plugin-TOU.png create mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/sample-reading-in-CLI.png diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/AD-BMSE2E3WLC-SL_block_diagram.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/AD-BMSE2E3WLC-SL_block_diagram.png new file mode 100644 index 00000000000..59bb13dbb82 --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/AD-BMSE2E3WLC-SL_block_diagram.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:70ac51c0de4cbb91361c431e852ea307cf85f2f73e2608db790f0692609ef5f8 +size 77820 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/AD-BMSE2E3WLC-SL_solution_kit.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/AD-BMSE2E3WLC-SL_solution_kit.png new file mode 100644 index 00000000000..564d79bfc9c --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/AD-BMSE2E3WLC-SL_solution_kit.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:a0418b7b42d4a1c6047e7af9376f539daa0e75d7d7555809acdcc1490670765a +size 236333 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/36-96V-full-setup.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/36-96V-full-setup.png new file mode 100644 index 00000000000..52924463d54 --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/36-96V-full-setup.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:e13390106e2c0ad50cbc2eb91ac985e0a90fc71a31c8ec8ec204ba9ef80b153c +size 1871547 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/48V-connection.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/48V-connection.png new file mode 100644 index 00000000000..df788bc2931 --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/48V-connection.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:5795711746d85bdaec4660f8c88a6ec439a15d5eb94ecc6f0837490d6ae1e2f9 +size 144090 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/baseboard-components.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/baseboard-components.png new file mode 100644 index 00000000000..679f70db56a --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/baseboard-components.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:f5c0a18bab6e034c17050e9fbfda493278e1713c74183faa9e025bad224429e3 +size 5435641 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/baseboard-led-on.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/baseboard-led-on.png new file mode 100644 index 00000000000..4762be05fd9 --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/baseboard-led-on.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:404b7e7d75b350d68fc708b6a5a34fbec29e643b9378cae03151cc88213a46fc +size 4890457 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/baseboard-shunt-config.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/baseboard-shunt-config.png new file mode 100644 index 00000000000..41fcdaaf1e0 --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/baseboard-shunt-config.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:8328e6b1de5ccd2c283f14977b791e202537b821e867ab93bb6fb8e074ac9201 +size 5554215 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/baseboard-testpoints.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/baseboard-testpoints.png new file mode 100644 index 00000000000..0cca7d0b023 --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/baseboard-testpoints.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:0d853ba581a9daf132a32f98741b1c59d037c2050ba33fda817ab8ffc0c7e738 +size 5416040 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/baseboard-to-emulator.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/baseboard-to-emulator.png new file mode 100644 index 00000000000..a9b67bdb433 --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/baseboard-to-emulator.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:4cd0243de2b276da15c0118e968736ad3b38a2b781a9d896fd3c26bedecc8c0d +size 5416432 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/daughterboard-components.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/daughterboard-components.png new file mode 100644 index 00000000000..86dd4ac9012 --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/daughterboard-components.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:3b3c407b6570fbab59a73ead169fcdc950a8b2308fcce0ad81335f901fa8fbc0 +size 4645646 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/daughterboard-shunt-config.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/daughterboard-shunt-config.png new file mode 100644 index 00000000000..55c298efd52 --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/daughterboard-shunt-config.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:c560b2c12858c32e558c9a780ee9a86163f5617a038d9f7243fe412cc5323202 +size 4718530 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/daughterboard-to-emulator.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/daughterboard-to-emulator.png new file mode 100644 index 00000000000..66b56c44432 --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/daughterboard-to-emulator.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:5c0dd4a08b8a453fe07b08c92f62d5cd7a401d99f6f37209276775b0977630fd +size 3881741 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/emulator-led-on.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/emulator-led-on.png new file mode 100644 index 00000000000..14bb5299c28 --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/emulator-led-on.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:9fa89457a41595f2fc0841dd5a9944450500a859da9060ebea9c19f9f24bae18 +size 1576944 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/full-integration-setup.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/full-integration-setup.png new file mode 100644 index 00000000000..f40f107ba27 --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/full-integration-setup.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:b69b1ccd66eb2462cfeaba78551dbd01233a07cf8ada393bb0775ec5edbdea92 +size 1699581 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/index.rst b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/index.rst new file mode 100644 index 00000000000..c41f3476513 --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/index.rst @@ -0,0 +1,272 @@ +.. _ad-bmse2e3wlc-sl hardware: + +Hardware Guide +============== + +Components and Connections +-------------------------- + +.. figure:: baseboard-components.png + :width: 800 px + + AD-BMSE2E3WLC-48V Baseboard Components + ++-------+---------------+---------------------------------------------+ +| No. | Component | Function | ++=======+===============+=============================================+ +| 1 | Battery Cell | Connector going to battery cells | +| | Connector | | ++-------+---------------+---------------------------------------------+ +| 2 | ADBMS1816W | Battery cell monitoring IC | ++-------+---------------+---------------------------------------------+ +| 3 | LTC7000 | FET Driver IC | ++-------+---------------+---------------------------------------------+ +| 4 | 12V Supply | 12V supply access | ++-------+---------------+---------------------------------------------+ +| 5a | Rsense_N | Resistor sensing for detecting and | +| | | monitoring total current on the baseboard | +| | | negative side | ++-------+---------------+---------------------------------------------+ +| 5b | Rsense_P | Resistor sensing for detecting and | +| | | monitoring total current on the baseboard | +| | | positive side | ++-------+---------------+---------------------------------------------+ +| 6a | Arduino | Arduino header connector left side | +| | Headers | | ++-------+---------------+---------------------------------------------+ +| 6b | Arduino | Arduino header connector right side | +| | Headers | | ++-------+---------------+---------------------------------------------+ +| 7 | Featherwing | Connector for placing Featherwing form- | +| | Connector | factor boards | ++-------+---------------+---------------------------------------------+ +| 8 | VBAT+ | Positive terminal connector for total | +| | Connector | voltage capacity of the battery pack | ++-------+---------------+---------------------------------------------+ +| 9 | isoSPI | Duraclik isoSPI connector terminals | +| | Connectors | | ++-------+---------------+---------------------------------------------+ +| 10 | ADG701 | 5V switch, USB-enabled | ++-------+---------------+---------------------------------------------+ +| 11 | LTC7138 | 5V analog and 5V digital LDO regulator | ++-------+---------------+---------------------------------------------+ +| 12 | V+ Output | Output control connector from V+ going to | +| | Control | Link+ Output | +| | Connector | | ++-------+---------------+---------------------------------------------+ +| 13 | LINK+_OUT | Access going to load side | ++-------+---------------+---------------------------------------------+ +| 14 | Common GND | Access ground going to load side | ++-------+---------------+---------------------------------------------+ + +.. figure:: daughterboard-components.png + :width: 600 px + + AD-BMSE2E3WLC-48V Daughter Board Components + ++-----+----------------------+-----------------------------------------+ +| No. | Component | Function | ++=====+======================+=========================================+ +| 1 | Battery Cell | Connector for Cell Input | +| | Connector | (for example, DC2472A cell emulator) | ++-----+----------------------+-----------------------------------------+ +| 2 | ADBMS1816W (U3) | 16-Cell BMS Monitoring Chip | ++-----+----------------------+-----------------------------------------+ +| 3a | Arduino Headers | Arduino Header Connector left side | ++-----+----------------------+-----------------------------------------+ +| 3b | Arduino Headers | Arduino Header Connector right side | ++-----+----------------------+-----------------------------------------+ +| 4 | isoSPI Connectors | Duraclik isoSPI Connector terminals | ++-----+----------------------+-----------------------------------------+ + +Test Points +----------- + +**AD-BMSE2E3WLC-48V Baseboard** + +.. figure:: baseboard-testpoints.png + :width: 600 px + + AD-BMSE2E3WLC-48V Baseboard Test Points + ++----------------+------------------+-----------------+---------------+ +| Test Point | Name | Typical (V) | Range (V) | ++================+==================+=================+===============+ +| TP6 | PORT | 4.9 | 4.5 to 5.15 | ++----------------+------------------+-----------------+---------------+ +| TP8 | TRANS | 0 | 0 | ++----------------+------------------+-----------------+---------------+ +| TP7 | VREG | 4.9 | 4.7 to 5.15 | ++----------------+------------------+-----------------+---------------+ +| 12V | 12V SUPPLY | 11.9 | 11.5 to 12.5 | ++----------------+------------------+-----------------+---------------+ +| E1 (PIN2) | 5V_ANA | 5 | 4.5 to 5.15 | ++----------------+------------------+-----------------+---------------+ +| E2 (PIN2) | 5V_DIG | 5 | 4.5 to 5.15 | ++----------------+------------------+-----------------+---------------+ + +Hardware Setup +-------------- + +**Requirements** + +Required Hardware +----------------- + +* 1 × :adi:`AD-BMSE2E3WLC-48V` Baseboard +* 1 × :adi:`EVAL-ADBMS1816WLC` Daughter Board +* 2 × :adi:`DC2472A` Battery Emulator +* 1 × :adi:`MAX32666FTHR` Microcontroller +* 1 × :adi:`MAX32625PICO` Programming Board +* 2 × :adi:`isoSPI` twisted-pair cables +* 1 × 10-pin SWD debugger cable +* 3 × Micro-USB to USB cables +* 1 × PC/Laptop +* 2 × Red Alligator-to-Banana Plug Cables (1166-12-0) +* 2 × Black Alligator-to-Banana Plug Cables (1166-12-0) +* 12 × Pin Header Shunts (if not yet installed) +* 1 × Digital Multimeter (DMM) + +Jumper Configuration +~~~~~~~~~~~~~~~~~~~~ + +**AD-BMSE2E3WLC-48V Baseboard** + +From the list of required hardware, select the **AD-BMSE2E3WLC-48V Baseboard**. + +Install the shunt connectors (if not yet installed) and ensure correct +positions, as highlighted in red in the figure below. + +.. important:: + + Header P16 must be configured with the shunt installed between + pin 2 and pin 3. This setting configures the board for 48V operation. + +.. figure:: baseboard-shunt-config.png + :width: 1500 px + + AD-BMSE2E3WLC-48V Baseboard Shunt Configuration + +---- + +**EVAL-ADBMSE2E3WLC Daughter Board** + +Configure the shunt connectors in **P17, P24, +P34, P30, P18, and P35.** Refer to the pin positions in the +figure below for proper shunt configuration. + +.. figure:: daughterboard-shunt-config.png + :width: 700 px + + EVAL-ADBMSE2E3WLC Daughter Board Shunt Configuration + +Battery Emulator Setup +~~~~~~~~~~~~~~~~~~~~~~ + +.. note:: + + The :adi:`DC2472A` Battery Emulator Board is used for cell voltage + input in this setup. + +- Plug the screw-terminal block into the cell voltage connector of the + two :adi:`DC2472A` battery emulators. + +- Connect the first DC2472A battery emulator to the AD-BMSE2E3WLC-48V + Baseboard through the cell connector. + + .. figure:: baseboard-to-emulator.png + :width: 600 px + + AD-BMSE2E3WLC-48V to Battery Emulator Setup + +- Connect the second :adi:`DC2472A` battery emulator to the :adi:`EVAL-ADBMS1816WLC` + Daughter Board through the cell connector. + + .. figure:: daughterboard-to-emulator.png + :width: 600 px + + EVAL-ADBMS1816WLC to Battery Emulator Setup + +- Connect a 5V external power source to the :adi:`DC2472A` (J1) using a USB + cable. External power supply is recommended for adequate power. + +- Alternatively, power it through a PC using a USB cable. + +**Power Verification** + +After powering up: + +- On **DC2472A**: + + - Blue LED (LED1) should turn **ON** + + .. figure:: emulator-led-on.png + :width: 350 px + + DC2472A Emulator Power LED + +- On **AD-BMSE2E3WLC-48V Baseboard**: + + - Red LED (DS3) and Green LED (DS1) should turn **ON** + + .. figure:: baseboard-led-on.png + :width: 600 px + + AD-BMSE2E3WLC-48V Baseboard Power LED + +Microcontroller Connection +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +- Attach the :adi:`MAX32666FTHR` microcontroller to the :adi:`AD-BMSE2E3WLC-48V` + baseboard through the Featherwing connector. + + .. figure:: max32666fthr-connection.png + :width: 600 px + + MAX32666FTHR MCU to AD-BMSE2E3WLC-48V Baseboard + +48V Connection +~~~~~~~~~~~~~~ + +- Connect the red alligator to banana jack cable between **48V** and + **TP11** on the :adi:`AD-BMSE2E3WLC-48V` as shown below. + + .. figure:: 48V-connection.png + + 48V Connection + +Cable and PC Connection +~~~~~~~~~~~~~~~~~~~~~~~ + + (A). Plug the micro-USB cable to the first :adi:`DC2472A` battery emulator + that is connected to the :adi:`AD-BMSE2E3WLC-48V` baseboard. + + (B). Plug the micro-USB cable to the second :adi:`DC2472A` battery emulator + that is connected to the :adi:`EVAL-ADBMS1816WLC` daughterboard. + + (C). Plug the micro-USB cable into the :adi:`MAX32666FTHR` microcontroller. + + (D). Connect the 2-wire isoSPI cable from P10 of the :adi:`AD-BMSE2E3WLC-48V` baseboard. + + (E). Connect the other end of the 2-wire isoSPI cable to P10 of + the :adi:`EVAL-ADBMS1816WLC` daughterboard. + + (F). Connect all USB cables to a USB hub (preferred). + + .. note:: + + If your PC/laptop USB ports can supply ≥1A, you may connect devices + directly without a USB hub. + + Your setup should look like below: + + .. figure:: full-integration-setup.png + :width: 600 px + + Full Hardware Evaluation Setup + +| + +The :adi:`AD-BMSE2E3WLC-SL` comes complete with firmware and easy-to-use application GUI. +Access the software resources and see the setup procedure in the +:ref:`AD-BMSE2E3WLC-SL Software User Guide `. diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/max32666fthr-connection.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/max32666fthr-connection.png new file mode 100644 index 00000000000..d0065421b3f --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/max32666fthr-connection.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:dbcd0bc9c972234ff25ece6b3de4fa5c8dec1200cce684b6ad0d97606d0c6c92 +size 4901570 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/max32666fthr-to-max32625pico.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/max32666fthr-to-max32625pico.png new file mode 100644 index 00000000000..86d7101b077 --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/max32666fthr-to-max32625pico.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:5653849555267e915c87ecc3292f3ac032af412d178ad84e2e53082aeefd7284 +size 319251 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/index.rst b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/index.rst new file mode 100644 index 00000000000..f15c6970fac --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/index.rst @@ -0,0 +1,286 @@ +.. _ad-bmse2e3wlc-sl: + +AD-BMSE2E3WLC-SL +================ + +Low-cost Battery Management System Reference Design for E2W/E3W +Applications + +Overview +-------- + +.. figure:: AD-BMSE2E3WLC-SL_solution_kit.png + :width: 600 px + + AD-BMSE2E3WLC-SL Solution Kit + +The :adi:`AD-BMSE2E3WLC-SL` is a cost-competitive system-level reference design +for medium to high-end Battery Management System (BMS) applications in +Electric 2-Wheeler (E2W) and Electric 3-Wheeler (E3W) markets. Operating +within a voltage range of 36V to 96V and supporting currents up to 100A, +this reference design leverages the automotive-grade :adi:`ADBMS1816W ` +integrated circuit with comprehensive cell and current sensing +capabilities. + +The system features built-in charge/discharge circuitry supporting both +high-side and low-side current sensing. It includes a compatible microcontroller +board that handles computational operations required for BMS functionality and +provides USB-to-SPI communication for GUI interaction. + +The modular, stackable design offers flexibility to utilize +customer-preferred MCUs through standard Arduino/Feather board form +factors. + +The reference design also includes open-source firmware example codes +and a comprehensive GUI, enabling rapid prototyping and +evaluation of BMS solutions. + +Features +-------- + +**Wide Range BMS System** + + - can operate from 36V to 96V, can handle up to 100A + - Simplified E2W/E3W AD-BMSE2E3WLC-SL baseboard + EVAL-ADBMS1816WLC + daughterboard configuration + +**Battery Chemistry Compatibility** + + - Supports multiple battery chemistries: Ni-MH, Li-ion, LiFePO4, + Sodium-ion + +**System Integration** + + - Plug-and-play integration + - MCU-agnostic design for easy integration into existing systems + - Flexible topology support: Centralized, Distributed, and Modular + configurations + +**Monitoring Capabilities** + + - Cell voltage accuracy: ±3.0mV + - Temperature monitoring: Up to 8 sensors + - SoC/SoH Coulomb counting + - High-side and low-side current sensing + +**Vehicle State Management** + + - E2W/E3W vehicle state condition readiness + - Support for Driving, Charging, Parking, and Fault states + +**Connectivity and Software** + + - Daisy-chaining ready for multi-board configurations + - Comprehensive GUI compatible with any PC/laptop + - Integrated firmware and GUI software suite + - Real-time monitoring, diagnostics, and data plotting capabilities + - Open-source BMS example codes provided + +Applications +------------ + + - Medium to High Performance Electric and Hybrid 2-Wheeler and 3-Wheeler Vehicles + - Light Electric Vehicles + - BMS Battery Research and Development + - Adaptive Battery Type System Monitoring + - Portable Energy Storage Systems + +System Architecture +------------------- + +.. figure:: AD-BMSE2E3WLC-SL_block_diagram.png + :width: 600 px + + AD-BMSE2E3WLC-SL System Block Diagram + +Theory of Operation +------------------- + +The :adi:`AD-BMSE2E3WLC-SL` system combines battery cell monitoring, current +sensing, temperature monitoring, charge/discharge control, and host +communication into a scalable platform supporting battery packs from +36V to 96V and up to 32 series-connected cells. + +At the core of the system is the :adi:`ADBMS1816W ` battery monitoring IC, +which continuously measures individual cell voltages and temperature sensor +inputs. Two :adi:`ADBMS1816W ` devices are used in a daisy-chain +configuration to support up to 32 cells while maintaining high measurement accuracy +and reducing communication wiring complexity through the isoSPI +interface. Measured battery parameters are transmitted to the host +microcontroller for processing and display. + +The :adi:`MAX32666FTHR` microcontroller serves as the system controller and +communication gateway. It collects measurement data from the battery +monitor devices, executes battery management functions such as SOC and +SOH calculations, manages system operating states, and communicates with +the PC-based GUI through a USB connection. The MCU-agnostic hardware +architecture allows alternative processor platforms to be integrated +through the Arduino and Feather-compatible interfaces. + +Battery pack current is monitored through precision shunt resistors +located on the baseboard. The measured current information is used for +coulomb counting, charge/discharge monitoring, and battery protection +functions. The system supports both high-side and low-side +current-sensing topologies, enabling flexibility for different battery +pack architectures. + +Charge and discharge path control is implemented using external MOSFETs +driven by the :adi:`LTC7000` gate driver. Based on battery conditions and +operating state, the BMS can enable or disable power delivery to the +load or charger. This allows implementation of vehicle operating modes +such as Driving, Charging, Parking, and Fault conditions while +protecting the battery pack from abnormal operating events. + +For evaluation purposes, the :adi:`AD-BMSE2E3WLC-SL` can be connected to +:adi:`DC2472A` battery emulators, allowing users to safely simulate battery +cell voltages and observe system behavior through the graphical user +interface. The GUI provides real-time monitoring of cell voltages, stack +voltage, current, temperature measurements, and system status, +facilitating rapid development and validation of battery management +algorithms. + +This modular architecture enables rapid prototyping, evaluation, and +customization of battery management solutions while providing a +foundation that can be adapted for E2W, E3W, and other light electric +vehicle applications. + +Specifications +-------------- + ++----------------------+-------+---------+-------+------+------------------+ +| **Parameter** | Min | Typical | Max | Unit | **Notes** | ++======================+=======+=========+=======+======+==================+ +| **System** | | | | | | ++----------------------+-------+---------+-------+------+------------------+ +| Total Vin+ Supply | 30 | - | 100 | V | Input voltage | +| Voltage | | | | | supply from | +| | | | | | battery | ++----------------------+-------+---------+-------+------+------------------+ +| Battery Emulator | 30 | - | 100 | V | Safe output | +| Output | | | | | voltage from | +| | | | | | Battery Emulator | ++----------------------+-------+---------+-------+------+------------------+ +| Discharge Current | - | 40 | 100 | A | Current rating | +| | | | | | at discharge | +| | | | | | mode | ++----------------------+-------+---------+-------+------+------------------+ +| Charge Current | 0.3 | 40 | 70 | A | Current rating | +| | | | | | at charge mode | ++----------------------+-------+---------+-------+------+------------------+ +| Charge Voltage | - | - | 96 | V | | +| Input | | | | | | ++----------------------+-------+---------+-------+------+------------------+ +| Discharge Voltage | - | 36 | 96 | V | Regulated | +| Output | | | | | voltage range | ++----------------------+-------+---------+-------+------+------------------+ +| FET Driver Charge | - | - | 5 | V | From ADBMS1816W | +| Input | | | | | GPIO | ++----------------------+-------+---------+-------+------+------------------+ +| FET Vgs Range | -20 | - | 20 | V | From ADBMS1816W | +| | | | | | GPIO | ++----------------------+-------+---------+-------+------+------------------+ +| FET Rds(on) | - | - | 4.8 | mΩ | From ADBMS1816W | +| | | | | | GPIO | ++----------------------+-------+---------+-------+------+------------------+ +| **ADBMS1816W Cell | | | | | | +| Monitor** | | | | | | ++----------------------+-------+---------+-------+------+------------------+ +| VREG Supply | 4.5 | 5 | 5.5 | V | | ++----------------------+-------+---------+-------+------+------------------+ +| VREF1, VREF2 | 3 | - | 3.3 | V | Supply to | +| | | | | | internal ADCs | ++----------------------+-------+---------+-------+------+------------------+ +| VRES/VDD | 4.5 | 5 | 5.5 | V | | ++----------------------+-------+---------+-------+------+------------------+ +| Operating | -40 | - | 125 | °C | | +| Temperature | | | | | | ++----------------------+-------+---------+-------+------+------------------+ +| CPIN Input Range | -2.5 | - | 5.5 | V | | ++----------------------+-------+---------+-------+------+------------------+ +| Cell Count | 1 | - | 32 | - | Minimum 17 cells | +| | | | | | to initiate | +| | | | | | daisy chain | ++----------------------+-------+---------+-------+------+------------------+ +| Drive Voltage Range | -0.3 | - | 6 | V | Relative to each | +| | | | | | cell monitor V- | ++----------------------+-------+---------+-------+------+------------------+ +| VP Range | 16 | - | 80 | V | | ++----------------------+-------+---------+-------+------+------------------+ +| VREG Pack Monitor | 4.5 | 5 | 5.5 | V | | ++----------------------+-------+---------+-------+------+------------------+ +| **MAX32666 | | | | | | +| Microcontroller** | | | | | | ++----------------------+-------+---------+-------+------+------------------+ +| MCU Supply Voltage | 3.3 | - | 5.5 | V | | +| from BMS | | | | | | ++----------------------+-------+---------+-------+------+------------------+ +| MCU I/O Supply | 1.6 | - | 3 | V | | +| (1.8V) | | | | | | ++----------------------+-------+---------+-------+------+------------------+ +| MCU VDD Supply | 3.3 | - | 5.5 | V | | ++----------------------+-------+---------+-------+------+------------------+ +| MCU Supply (1.2V) | 1.1 | - | 1.35 | V | | ++----------------------+-------+---------+-------+------+------------------+ +| MCU Supply (1.0V) | 0.9 | - | 1.2 | V | | ++----------------------+-------+---------+-------+------+------------------+ + +Package Contents +---------------- + +Upon purchase, the AD-BMSE2E3WLC-SL comes complete with 1 baseboard, 1 daughter +board, and 1 microcontroller. + +**However, customers also have the option to avail of the components individually +as intended for their application development.** + + - 1x :adi:`AD-BMSE2E3WLC-48V` Baseboard + - 1x :adi:`EVAL-ADBMS1816WLC` Daughter Board + - 1x :adi:`MAX32666FTHR` Microcontroller Board + - 2x :adi:`DC2472A` Battery Emulator + - 1x :adi:`MAX32625PICO` Programmer with 10-pin SWD Ribbon Cable + - 2x isoSPI Twisted Pair Cable + - 2x USB Cable for PC Connection + - Stackable Banana Plug to Alligator Clip BU-P1166-12-0 (Black) + - Stackable Banana Plug to Alligator Clip BU-P1166-12-2 (Red) + +.. figure:: package-contents.png + :width: 1000 px + + AD-BMSE2E3WLC-SL Package Contents + +User Guides +----------- + +Proceed to the following pages for detailed information on +how to use the AD-BMSE2E3WLC-SL reference design: + +.. toctree:: + :titlesonly: + :glob: + + */index + +Resources +--------- + + - :adi:`ADBMS1816 Product Page ` + - :adi:`LTC7000 Product Page ` + - :adi:`MAX32666 Product Page ` + - :adi:`DC2472A Product Page ` + +Design & Integration Files +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. admonition:: Download + + AD-BMSE2E3WLC-SL Design Support Package {{ add link to product page download link }} + + * Schematic + * PCB Layout + * Bill of Materials + * Allegro Project + +Help and Support +---------------- + +For questions and more information, please visit the :ez:`EngineerZone Support Community `. diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/package-contents.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/package-contents.png new file mode 100644 index 00000000000..f44e8f47aa1 --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/package-contents.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:965e0a9799233f3f40b06ac79fc2983a09e3b5342f8208691eb3cf0a261b9de3 +size 7706175 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/ACE-homepage.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/ACE-homepage.png new file mode 100644 index 00000000000..dacc23b0f9d --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/ACE-homepage.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:17694d33b2327089bf0faade48a1297093c613864952041c535b5bd08bc83a8f +size 517770 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/ACEZIP-file.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/ACEZIP-file.png new file mode 100644 index 00000000000..f9370b7622c --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/ACEZIP-file.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:4cda2d5d71d9137e4b0fa10ecd94dec56025f6c489b7b2d497af1fa1f5584757 +size 12468 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/AD-BMSE2E3WLC-SL_GUI.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/AD-BMSE2E3WLC-SL_GUI.png new file mode 100644 index 00000000000..5546a0ce463 --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/AD-BMSE2E3WLC-SL_GUI.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:79063aefda00a589b4f046485363f947966311971a5dfb212044b82a25c55097 +size 1608474 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/ace-on-start-menu.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/ace-on-start-menu.png new file mode 100644 index 00000000000..53b984aa89c --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/ace-on-start-menu.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:ce114ff4f29937fd33b9635138e7a4a99558b77d190c9f57448e966c6e18a128 +size 38070 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/ace-serial-ports-config.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/ace-serial-ports-config.png new file mode 100644 index 00000000000..46493cb30b2 --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/ace-serial-ports-config.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:d5f3e2d13eb5f3c50366f1ed1859fecd098b7c269dcf11826295895df63307aa +size 25593 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/ace-software-download.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/ace-software-download.png new file mode 100644 index 00000000000..4d3f66f77f3 --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/ace-software-download.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:7646d23468abfd6f38d91b8bba8ba30174486f56157dc7a450178879820696cc +size 1750827 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/ace-software-installation.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/ace-software-installation.png new file mode 100644 index 00000000000..b9e88c4fb7c --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/ace-software-installation.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:2e510a12d6b849b41c81f709ecad1fee5a1657321ed6f92028dfcf0a20a97105 +size 2996811 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/ad-bmse2e3wlc-48v-plugin.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/ad-bmse2e3wlc-48v-plugin.png new file mode 100644 index 00000000000..9870b5f9a60 --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/ad-bmse2e3wlc-48v-plugin.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:746510236b8b86f6b59b455a1bed2b49ea11f677ceb576345366b6a747ee9f97 +size 59754 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/device-manager-comport.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/device-manager-comport.png new file mode 100644 index 00000000000..464195629aa --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/device-manager-comport.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:6ca2032980030f1a56e4df12aabbe0021284a680961f38a777608675cd205276 +size 54987 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/driving-mode-pd.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/driving-mode-pd.png new file mode 100644 index 00000000000..3cb3c46602d --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/driving-mode-pd.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:6623e3629be085dc5a837cf4769d46e3bb04aeb9e8c32498fe67b10578fae112 +size 366122 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/firmware-upload.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/firmware-upload.png new file mode 100644 index 00000000000..caa41fb96ab --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/firmware-upload.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:2f8569ddc8458292ab33610f0f447c9b1002c788d53c9a5b7c286998c30f0c7a +size 675399 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/index.rst b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/index.rst new file mode 100644 index 00000000000..3a1f7c09b64 --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/index.rst @@ -0,0 +1,851 @@ +.. _ad-bmse2e3wlc-sl software: + +Software Guide +============== + +This guide provides step-by-step instructions for firmware installation, +loading the ACE GUI plugin, and using the AD-BMSE2E3WLC-SL evaluation system. + +Software Resources +------------------ + +.. note:: **A MyAnalog.com account is required to download the software resources.** + + Follow the steps below to create a MyAnalog account: + + #. Go to :adi:`MyAnalog ` and create an account using email. Select the **Register with email** option to get started. + #. Once you have a MyAnalog account, log in using your credentials, then proceed to download the required files listed below. + +.. admonition:: Download + + Required software and files for the AD-BMSE2E3WLC-SL evaluation: + + - :adi:`ACE Software ` + - :adi:`AD-BMSE2E3WLC-SL Firmware 1.0.0 ` + - :adi:`AD-BMSE2E3WLC-SL ACE GUI Plugin Installer ` + - `MAX32625PICO Image `_ + - Code editor (such as Visual Studio Code) + - Terminal application (such as Tera Term) + +---- + +Firmware +-------- + +Prepare the MAX32666FTHR for Firmware Upload +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +- Connect the **10-pin SWD ribbon cable** to the **MAX32666FTHR**. +- Connect the other end to the **MAX32625PICO**. +- Connect the **MAX32625PICO** to your PC using a **micro-USB cable**. +- Download the MAX32625PICO image (see link above). +- Extract the contents of the archive and locate the **MAX32625_PICO.bin** file. +- Copy the **MAX32625_PICO.bin** file into the **MAINTENANCE** folder of the connected MAX32625PICO. +- Wait for the transfer to complete. + + .. figure:: max32625_pico_bin_upload.png + + Uploading the MAX32625_PICO.bin file + + **Successful installation indicators:** + + - The device renames to **DAPLINK**. + - A **MAX32666.HTM** file appears in the folder. + +Pre-built Binaries +~~~~~~~~~~~~~~~~~~ + +Pre-built ``.hex`` files are provided in the ``bin/`` folder for supported +boards. No additional toolchain or build setup is required. Copy the +appropriate file onto the MAX32625PICO DAPLINK debugger drive. + ++---------------------------------------------------+------------------+ +| File Name | Target Board | ++===================================================+==================+ +| bms_measurement-max32666fthr-iio-2x-adbms1816.hex | MAX32666FTHR | ++---------------------------------------------------+------------------+ +| bms_measurement-max32690fthr-iio-2x-adbms1816.hex | MAX32690FTHR | ++---------------------------------------------------+------------------+ +| bms_measurement-max32690apard-iio-2x-adbms1816.hex| AD-APARD32690-SL | ++---------------------------------------------------+------------------+ + +These binaries are built with:: + + IIO_EXAMPLE = y + NUM_DEV = 2 + +The number of active devices is determined at runtime by the VSEL jumper: + + * LOW = 1 device / 48V + * HIGH = 2 devices / 96V + +If a different example or configuration is required, build the firmware +binaries from source. + +Flash the Pre-built Binary File into the MAX32666FTHR +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +- Download the ``AD-BMSE2E3WLC-SL Firmware 1.0.0`` package. +- Copy the matching ``.hex`` file (select based on the MCU board used) from the ``bin/`` folder to the DAPLINK drive. +- The MAX32625PICO debugger flashes the MCU and remounts the drive when complete. + + **Verification:** + + - A successful upload is indicated by the absence of a **FAIL.TXT** file + in the DAPLINK folder. + +Command Line Interface +~~~~~~~~~~~~~~~~~~~~~~ + +The AD-BMSE2E3WLC-SL firmware allows device monitoring and diagnostics through a command-line interface (CLI). +For this purpose, a terminal emulator such as Tera Term is recommended. + +- Open the Tera Term application (other terminals can also be used, but Tera Term is recommended). +- Select ``Serial``, then choose the correct COM port number associated with the microcontroller. +- Click the ``Setup`` tab, then ``Serial Port``. + + - Set the speed to **115200**. + - Then, click the ``New setting`` button. + +- Click the ``Setup`` tab, then ``Terminal``. + +- Under the New-line setting, set Receive to ``AUTO``. + +- Click the hardware ``RESET`` button on the microcontroller board. +- The BMS data will be printed on the Tera Term terminal. + + Sample reading: + + .. figure:: sample-reading-in-CLI.png + + Sample BMS Data Output + +Building the Firmware from Source +--------------------------------- + +**Since the AD-BMSE2E3WLC-48V baseboard is MCU-agnostic, users can swap the MAX32666FTHR MCU with any supported Maxim MCU. +The firmware can be built from scratch by following the instructions below:** + +Requirements +~~~~~~~~~~~~ + +Extract the contents of the downloaded ``AD-BMSE2E3WLC-SL Firmware 1.0.0`` zip file. The package already includes no-OS and all +required sources. No git cloning or submodule initialization is required. + +Directory structure:: + + ad-bmse2e3wlc-sl-firmware-1.0.0/ + ├── bin/ + ├── no-OS/ + ├── no-OS-BMS-Examples-Rel1.0.0/ + │ ├── adbms/ + │ └── examples/ + └── README.md + +Install `make `_ for your operating system. + +Then, install Git Bash. The following instructions are provided for each operating system: + +Windows +^^^^^^^ + +Install Git Bash: + + https://git-scm.com/downloads + +Then run:: + + ./no-OS/tools/scripts/git-bash.sh + +Linux (Debian/Ubuntu) +^^^^^^^^^^^^^^^^^^^^^ + +:: + + sudo apt install make + +macOS +^^^^^^ + +:: + + xcode-select --install + +Build Requirements +~~~~~~~~~~~~~~~~~~ + +For Maxim Platform +^^^^^^^^^^^^^^^^^^ + +* Download and install MaximSDK: + + https://www.maximintegrated.com/en/design/software-description.html/swpart=SFW0010820A + +Recommended installation locations: + ++----------+--------------------------------------------+ +| OS | Recommended Install Path | ++==========+============================================+ +| Windows | ``C:\MaximSDK`` | ++----------+--------------------------------------------+ +| Linux | ``$HOME/msdk`` | ++----------+--------------------------------------------+ +| macOS | ``$HOME/msdk`` | ++----------+--------------------------------------------+ + +For more information on setting up and building no-OS projects: +https://developer.analog.com/docs/no-os/latest/build_guides/build_maxim.html + + +Build Instructions +~~~~~~~~~~~~~~~~~~ + +For Maxim Build +^^^^^^^^^^^^^^^ + +1. Open a terminal. + ++---------------+---------------------------------------------+ +| OS | Terminal | ++===============+=============================================+ +| Windows | Git Bash or MSYS2 | ++---------------+---------------------------------------------+ +| Linux/macOS | Any standard terminal (bash, zsh, etc.) | ++---------------+---------------------------------------------+ + +2. Set the ``MAXIM_LIBRARIES`` environment variable. + + Windows (Git Bash / MSYS2):: + + export MAXIM_LIBRARIES=/c/MaximSDK/Libraries + + Linux / macOS:: + + export MAXIM_LIBRARIES=$HOME/msdk/Libraries + + +3. Change to the examples directory:: + + cd no-OS-BMS-Examples-Rel1.0.0/examples + + Select the desired example by editing the Makefile: + + .. code-block:: makefile + + # Select the example measurement (Note: Select 1 example at a time) + + ADBMS1816_BASIC = n + ADBMS1816_BALANCING = n + ADBMS1816_DCC_BALANCING = n + ADBMS1816_FUEL_GAUGE = n + IIO_EXAMPLE = y + +.. note:: + + Only one example should be set to ``y`` at a time. + +Board Auto-Detection +^^^^^^^^^^^^^^^^^^^^ + +Supported TARGET suffixes: + + * ``max32665fthr`` - MAX32665/MAX32666FTHR + * ``max32690apard`` - APARD32690 + * ``max32690fthr`` - MAX32690FTHR + * ``max32690`` - defaults to APARD32690 + +.. note:: + + The Maxim toolchain uses ``max32665`` for both MAX32665 and MAX32666. + Use ``max32665fthr`` when building for MAX32666FTHR. + +Example:: + + make TARGET=max32665fthr + +Build:: + + make TARGET=max32665fthr + +Use a different no-OS path:: + + make TARGET=max32665fthr NO-OS= + +Run:: + + make TARGET=max32665fthr NO-OS= run + +Clean:: + + make TARGET=max32665fthr NO-OS= clean + +Reset:: + + make TARGET=max32665fthr NO-OS= reset + +Open VS Code project:: + + make TARGET=max32665fthr NO-OS= maxim_sdkopen + +Currently Supported MCUs +^^^^^^^^^^^^^^^^^^^^^^^^ + + * MAX32666FTHR + * MAX32690FTHR + * AD-APARD32690-SL + +Refer to:: + + examples/src/platform/maxim/parameters.h + +for pinouts. + +---- + +General Configuration Options +----------------------------- + +.. code-block:: makefile + + # Total Number of ADBMS devices in the chain + NUM_DEV = 2 + + # Delay in milliseconds + MEASUREMENTS_FREQ_MS = 1000 + + # Set to 0 for continuous measurements + NUM_MEAS_LOOP = 1 + + # Set to y when measuring execution time + TIME_PROFILING ?= n + + # Use a separate serial port + NO_OS_USB_UART = y + +.. note:: + + ``NUM_DEV`` is a compile-time setting. The actual number of active devices + is determined at runtime by the VSEL jumper. + + * Jumper LOW -> 48V stack / 1 device + * Jumper HIGH -> 96V stack / 2 devices + + Ensure that the jumper position matches the hardware configuration. + +Example Measurements +~~~~~~~~~~~~~~~~~~~~~ + +Available example flags: + +.. code-block:: makefile + + ADBMS1816_BASIC = n + ADBMS1816_BALANCING = n + ADBMS1816_DCC_BALANCING = n + ADBMS1816_FUEL_GAUGE = n + IIO_EXAMPLE = n + +.. note:: + + Each example prints the device ID register values. + +ADBMS1816_BASIC +^^^^^^^^^^^^^^^ + +Performs basic daisy-chain measurements using N x ADBMS1816 devices. + +Measures: + + * Cell voltages + * VSTACK + * Pack current + * Auxiliary voltages + * Temperature + +Example:: + + ADBMS1816 (1) Unique ID: 0xXX 0xXX 0xXX 0xXX 0xXX 0xXX + ADBMS1816 (2) Unique ID: 0xXX 0xXX 0xXX 0xXX 0xXX 0xXX + + Cell 1 = X.XXXX V + ... + Cell 16 = X.XXXX V + + VSTACK = XX.XXXX V + Current = X.XXXX A + Temperature = XX.XX deg C + +ADBMS1816_BALANCING +^^^^^^^^^^^^^^^^^^^ + +Performs PWM (Pulse Width Modulation) balancing. + +Key parameters: + + * ``BAL_THRESHOLD_RAW`` + * ``BAL_DCTO`` + * ``WDG_TIMEOUT_MS`` + +Example:: + + PWM Balancing Round 1 + ^^^^^^^^^^^^^^^^^^^^^ + + Cell 1 = X.XXXX V + ... + Cell 16 = X.XXXX V + + Min cell voltage = X.XXXX V + + Cells above threshold (10 mV): + Dev 1 Cell 3: delta = XX counts, PWM duty = X/15 + + Entering extended balancing (DCTO = 5 min)... + + Balancing complete. All cells within threshold. + +ADBMS1816_DCC_BALANCING +^^^^^^^^^^^^^^^^^^^^^^^^ + +Performs DCC (Direct Cell Control) balancing. + +Key parameters: + + * ``BAL_THRESHOLD_RAW`` + * ``DCC_PHASE_DURATION_MS`` + * ``KEEPALIVE_INTERVAL_MS`` + +Example:: + + DCC Balancing Round 1 + ^^^^^^^^^^^^^^^^^^^^^ + + Min cell voltage = X.XXXX V + + --- Odd Phase (60s) --- + Discharging cells: Dev 1 [1,3,5,7,9,11,13,15] + + --- Even Phase (60s) --- + Discharging cells: Dev 1 [2,4,6,8,10,12,14,16] + + Balancing complete. All cells within threshold. + +ADBMS1816_FUEL_GAUGE +^^^^^^^^^^^^^^^^^^^^ + +Estimates: + + * State of Charge (SoC) + * State of Health (SoH) + +Features: + + * Coulomb counter support + * OCV re-anchoring + * Fixed-point arithmetic + * Automatic channel detection + +Example:: + + --- Device 0 --- + + CellV=X.XXXX V SoC=NN.nn % SoH=NN.nn % + ... + + CellV=0.0000 V (unconnected) + + Pack SoC (weakest cell): NN.nn % + Pack SoH (weakest cell): NN.nn % + + Equivalent full cycles: N + +---- + +Graphical User Interface (GUI) +------------------------------ + +Setup +~~~~~ + +**Step 1: Download Required Files** + + - Download the plugin package: **Board.ADBMSE2E3WLC ACEZIP.zip** (save locally) + - Download the latest :adi:`ACE software ` from Analog Devices. + + .. figure:: ace-software-download.png + + ACE Software Download + +**Step 2: Install ACE Software** + + - Run the installer. + - Follow the on-screen installation steps shown in the following figures: + + .. figure:: ace-software-installation.png + + ACE Software Installation Steps + + - Verify the installation via the Start Menu. + + .. figure:: ace-on-start-menu.png + :align: center + + ACE Software Start Menu Verification + +**Step 3: Load Plugin** + + - Run the downloaded ``ACEZIP`` file. + + - Accept the prompt warning about the unapproved EULA plugin. + + .. figure:: plugin-TOU.png + :width: 500 px + + - Continue to load the plugin. + + .. figure:: ACEZIP-file.png + + BMSE2E3WLC-SL Plugin + +Launching and Configuring the GUI +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + - Power up the hardware setup again (connect all USB cables to the PC or to a USB hub). + + - Launch ACE and **double-click** the plugin. + + - Open **Settings** (highlighted in the GUI). + + .. figure:: ACE-homepage.png + + ACE GUI Homepage + +**Configure Serial Communication** + + - Open **Device Manager** and note the **COM port number**. + + .. figure:: device-manager-comport.png + + Device Manager COM Port Detection + +In ACE: + +1. Go to **Settings → Serial Ports** and add the detected COM port. + +2. Set **Protocol = IIO**, then ``Enable`` the port. + +3. Click ``OK``. + + .. figure:: ace-serial-ports-config.png + + ACE Serial Port Settings + +4. Restart ACE. + + Expected result: The plugin **AD-BMSE2E3WLC-48V** appears. + + .. figure:: ad-bmse2e3wlc-48v-plugin.png + + ACE Plugin Detection + +.. note:: + + If the plugin does not appear or load in the ACE GUI, verify the installed libiio version on your PC. + + | + + To check the installed version: + + 1. Open ``Control Panel`` → ``Programs and Features`` (or ``Settings`` → ``Apps`` → ``Installed Apps``). + + .. figure:: libiio-check.png + + Control Panel - Programs and Features + + 2. Locate ``libiio`` in the list of installed programs. + 3. Verify that the installed version is **0.26**. + + .. figure:: libiio-version.png + + Installed libiio Version Check + + The ACE plugin requires **libiio v0.26** to function correctly. + If an earlier version is installed (for example, v0.25), upgrade to v0.26 using the following link: + + https://github.com/analogdevicesinc/libiio/releases/download/v0.26/libiio-0.26.ga0eca0d2-setup.exe + + +---- + +GUI Parts Overview +------------------ + +The AD-BMSE2E3WLC-SL GUI provides real-time monitoring of +battery-pack parameters, cell voltages, current measurements, +operating state, and temperature information. The dashboard is +designed to provide a quick overview of battery health and +system status during evaluation and testing. + +.. figure:: AD-BMSE2E3WLC-SL_GUI.png + + AD-BMSE2E3WLC-SL GUI + +Main Dashboard Layout +~~~~~~~~~~~~~~~~~~~~~ + +The GUI is divided into three primary sections: + +1. System Status Indicators (Top Middle Section) +2. Vehicle State and Temperature Monitoring (Top Right Section) +3. Individual Cell Voltage Monitoring (Bottom Section) + +Stack Voltage Gauge +~~~~~~~~~~~~~~~~~~~ + +The **Stack Voltage** gauge displays the total voltage of the +battery pack. + + Purpose + + * Monitors overall pack voltage. + * Confirms proper connectivity of all battery cells. + * Verifies battery charging and discharging behavior. + + Displayed Information: + + * Real-time pack voltage value. + * Green indicator showing normal operation. + * Gauge range covering the supported battery stack voltage. + + Example + + * Displayed value: **86.70V** + +**Module Current Gauge** + +The **Module Current** gauge displays the instantaneous battery +current. + + Purpose + + * Indicates whether the battery is charging or discharging. + * Monitors load current and charging current. + + Current Direction + + * Positive (+) current: charging + * Negative (-) current: discharging + + Example + + * Displayed value: **-1.95A** + * Indicates that the battery is supplying current to a load. + +**Max Charge Current Gauge** + +The **Max Charge Current** gauge displays the allowable charging +current configured by the BMS. + + Purpose + + * Indicates the maximum current permitted during charging. + * May be limited by battery conditions, temperature, or safety + requirements. + + Monitoring Use + + * Verify charging limits before connecting a charger. + * Validate BMS protection settings. + + Example + + * Displayed value: **0A** + +**Max Discharge Current Gauge** + +The **Max Discharge Current** gauge displays the allowable +discharge current. + + Purpose + + * Indicates the maximum current available to the load. + * Helps validate discharge protection behavior. + + Monitoring Use + + * Verify discharge capability during driving conditions. + * Observe current-limit changes caused by faults or temperature + restrictions. + + Example + + * Displayed value: **1.95A** + +Vehicle State Selection +~~~~~~~~~~~~~~~~~~~~~~~ + +The **Vehicle State** panel allows the user to select and +monitor the current operating mode. + +Available States: + ++----------+--------------------------------------------------+ +| State | Description | ++==========+==================================================+ +| Parked | Low-activity mode; output path disabled or | +| | limited. | ++----------+--------------------------------------------------+ +| Driving | Vehicle is actively supplying power to the load. | ++----------+--------------------------------------------------+ +| Charging | Battery is connected to a charging source. | ++----------+--------------------------------------------------+ +| Fault | System enters protection mode due to an | +| | abnormal condition. | ++----------+--------------------------------------------------+ + +Purpose + +Vehicle states control the behavior of the BMS and allow users +to evaluate operating-state transitions during system testing. + +Temperature Sensors +~~~~~~~~~~~~~~~~~~~ + +The **Temperature Sensors** section displays temperature +measurements from connected thermistors. + + Displayed Information + + * BMS 1 temperature channels + * BMS 2 temperature channels + + Purpose + + * Monitor battery-pack temperature. + * Verify thermistor operation. + * Evaluate thermal protection functionality. + + Typical Applications + + * Overtemperature testing + * Thermal characterization + +Cell Voltage Monitoring +~~~~~~~~~~~~~~~~~~~~~~~ + +The lower section of the GUI displays individual cell voltages +for each monitored battery cell. + + **BMS 1 Cell Monitor** + + * Cells 1 to 16 + * Individual voltage readings + * Battery charge indicators + + **BMS 2 Cell Monitor** + + * Cells 1 to 16 + * Individual voltage readings + * Battery charge indicators + +Visual Indicators +~~~~~~~~~~~~~~~~~ + ++------------------------+--------------------------------------+ +| Indicator | Meaning | ++========================+======================================+ +| Green Check Mark | Parameter or cell voltage is within | +| | the normal operating range. | ++------------------------+--------------------------------------+ +| Battery Icon | Visual representation of the cell | +| | level or status. | ++------------------------+--------------------------------------+ +| Green Battery Level | Cell voltage is present and measured | +| | successfully. | ++------------------------+--------------------------------------+ +| Voltage Reading | Actual measured cell voltage value. | ++------------------------+--------------------------------------+ +| Gauge Pointer in Green | Measurement is within expected | +| Region | operating limits. | ++------------------------+--------------------------------------+ +| Fault State Selected | Protective action is active or a | +| | fault condition has been detected. | ++------------------------+--------------------------------------+ + +The dashboard serves as the primary real-time monitoring +interface for validating pack voltage, current flow, cell +voltages, temperatures, and operating-state transitions during +AD-BMSE2E3WLC-SL evaluation. + +Functional Testing Using GUI +---------------------------- + +Voltage Adjustment Test +~~~~~~~~~~~~~~~~~~~~~~~ + +**Minimum Voltage Test** + +1. Rotate both DC2472A knobs **clockwise** (for the minimum setting). + +2. Expected readings: + + - Cell voltage: **1.3V to 1.7V** + + - Stack voltage: decreases + + .. figure:: minimum-voltage-test.png + + AD-BMSE2E3WLC-SL Minimum Voltage Test + +**Maximum Voltage Test** + +1. Rotate both DC2472A knobs **counterclockwise** (for the maximum setting). +2. Expected readings: + + - Cell voltage: **4.0V to 5.0V** + + - Stack voltage: increases + + .. figure:: maximum-voltage-test.png + + AD-BMSE2E3WLC-SL Maximum Voltage Test + + You may adjust one emulator at a time to observe the changes clearly. + +---- + +Output Power Delivery Test +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Measure using a **Digital Multimeter (DMM)**: + + - Connect **DMM (–)** to **Ground**. + - Connect **DMM (+)** to **TP23**. + + Expected reading: **4.0V to 4.7V** + +In GUI: + + - Set **Vehicle State = Driving**. + - Verify the voltage again. + + .. figure:: driving-mode-pd.png + + AD-BMSE2E3WLC-SL Power Delivery Test - "Driving" Mode + + **Vehicle State = Parked** + + .. figure:: parked-mode-pd.png + + AD-BMSE2E3WLC-SL Power Delivery Test - "Parked" Mode + +| + +**Shutdown Procedure** + +Follow this sequence to safely power down: + +1. Disconnect power from the MAX32666FTHR microcontroller. +2. Disconnect power from both DC2472A battery cell emulators. +3. Remove all cables. +4. Return the hardware to proper storage. diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/libiio-check.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/libiio-check.png new file mode 100644 index 00000000000..091ee1eac0d --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/libiio-check.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:13ab7c7e279b87fba0fdf94e62cb01a685e83048a410ad9b33101b32fa281a0f +size 47505 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/libiio-version.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/libiio-version.png new file mode 100644 index 00000000000..595ac6b6673 --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/libiio-version.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:d8372e8888204e6b922e9cd0c18d274d58ae349153233976fef6e7bcc54c6e0a +size 18608 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/max32625_pico_bin_upload.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/max32625_pico_bin_upload.png new file mode 100644 index 00000000000..ee2f60e9252 --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/max32625_pico_bin_upload.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:2e17687f7b4cbe1dc541b3b7ce74875910dd0e68ef1a7efe02a8bfab8cf35df4 +size 195811 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/maximum-voltage-test.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/maximum-voltage-test.png new file mode 100644 index 00000000000..3ef19b00eeb --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/maximum-voltage-test.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:c0d646fa5233a13add26aaf42fa74b9863c326a8e16e4052876b5570794d1c85 +size 199770 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/minimum-voltage-test.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/minimum-voltage-test.png new file mode 100644 index 00000000000..ce2add0d2f9 --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/minimum-voltage-test.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:af113edd29b160f1e1869296a59f8be35b9c7661f531c56e2684a7c5bd12301d +size 336850 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/parked-mode-pd.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/parked-mode-pd.png new file mode 100644 index 00000000000..f222a530da2 --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/parked-mode-pd.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:15626fa3a6548365868b8f88e84f2ceb228ed535b239cb51a4988b064aba065f +size 50140 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/parked-mode-setup.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/parked-mode-setup.png new file mode 100644 index 00000000000..cb66b158b98 --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/parked-mode-setup.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:127bb3fe41392f15117596ff1b1fa205327e9a8de726f025cffb49965359b814 +size 246785 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/plugin-TOU.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/plugin-TOU.png new file mode 100644 index 00000000000..d0e9cb648cf --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/plugin-TOU.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:09ce99041e2d1dbb2e3a255972f7c3164bce6f8dc23648a7e9a98f458bb0680f +size 39060 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/sample-reading-in-CLI.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/sample-reading-in-CLI.png new file mode 100644 index 00000000000..35910216073 --- /dev/null +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/sample-reading-in-CLI.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:6d084f4b2141133e9341ee57c1ab2d856c046b6ec6090fd5f372532040da7244 +size 24957 From 55144e87adc241565cf97b37e724d2066a84e017 Mon Sep 17 00:00:00 2001 From: Joyce Velasco Date: Mon, 10 Aug 2026 16:26:25 +0800 Subject: [PATCH 2/2] address llm review comments --- .../hardware-guide/36-96V-full-setup.png | 3 --- .../ad-bmse2e3wlc-sl/hardware-guide/index.rst | 7 ++----- .../hardware-guide/max32666fthr-to-max32625pico.png | 3 --- .../reference-designs/ad-bmse2e3wlc-sl/index.rst | 6 +++--- .../software-guide/firmware-upload.png | 3 --- .../ad-bmse2e3wlc-sl/software-guide/index.rst | 12 ++++++------ .../software-guide/parked-mode-setup.png | 3 --- 7 files changed, 11 insertions(+), 26 deletions(-) delete mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/36-96V-full-setup.png delete mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/max32666fthr-to-max32625pico.png delete mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/firmware-upload.png delete mode 100644 docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/parked-mode-setup.png diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/36-96V-full-setup.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/36-96V-full-setup.png deleted file mode 100644 index 52924463d54..00000000000 --- a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/36-96V-full-setup.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:e13390106e2c0ad50cbc2eb91ac985e0a90fc71a31c8ec8ec204ba9ef80b153c -size 1871547 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/index.rst b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/index.rst index c41f3476513..42e2f0c4f97 100644 --- a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/index.rst +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/index.rst @@ -108,10 +108,7 @@ Test Points Hardware Setup -------------- -**Requirements** - -Required Hardware ------------------ +**Required Hardware** * 1 × :adi:`AD-BMSE2E3WLC-48V` Baseboard * 1 × :adi:`EVAL-ADBMS1816WLC` Daughter Board @@ -231,7 +228,7 @@ Microcontroller Connection - Connect the red alligator to banana jack cable between **48V** and **TP11** on the :adi:`AD-BMSE2E3WLC-48V` as shown below. - .. figure:: 48V-connection.png + .. figure:: 48v-connection.png 48V Connection diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/max32666fthr-to-max32625pico.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/max32666fthr-to-max32625pico.png deleted file mode 100644 index 86d7101b077..00000000000 --- a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/hardware-guide/max32666fthr-to-max32625pico.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:5653849555267e915c87ecc3292f3ac032af412d178ad84e2e53082aeefd7284 -size 319251 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/index.rst b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/index.rst index f15c6970fac..5baf5d9bbc3 100644 --- a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/index.rst +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/index.rst @@ -9,7 +9,7 @@ Applications Overview -------- -.. figure:: AD-BMSE2E3WLC-SL_solution_kit.png +.. figure:: ad-bmse2e3wlc-sl_solution_kit.png :width: 600 px AD-BMSE2E3WLC-SL Solution Kit @@ -88,7 +88,7 @@ Applications System Architecture ------------------- -.. figure:: AD-BMSE2E3WLC-SL_block_diagram.png +.. figure:: ad-bmse2e3wlc-sl_block_diagram.png :width: 600 px AD-BMSE2E3WLC-SL System Block Diagram @@ -273,7 +273,7 @@ Design & Integration Files .. admonition:: Download - AD-BMSE2E3WLC-SL Design Support Package {{ add link to product page download link }} + :adi:`AD-BMSE2E3WLC-SL Design Support Package ` * Schematic * PCB Layout diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/firmware-upload.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/firmware-upload.png deleted file mode 100644 index caa41fb96ab..00000000000 --- a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/firmware-upload.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:2f8569ddc8458292ab33610f0f447c9b1002c788d53c9a5b7c286998c30f0c7a -size 675399 diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/index.rst b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/index.rst index 3a1f7c09b64..088dde28cac 100644 --- a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/index.rst +++ b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/index.rst @@ -55,7 +55,7 @@ Prepare the MAX32666FTHR for Firmware Upload Pre-built Binaries ~~~~~~~~~~~~~~~~~~ -Pre-built ``.hex`` files are provided in the ``bin/`` folder for supported +Pre-built ``HEX`` files are provided in the ``bin/`` folder for supported boards. No additional toolchain or build setup is required. Copy the appropriate file onto the MAX32625PICO DAPLINK debugger drive. @@ -86,7 +86,7 @@ Flash the Pre-built Binary File into the MAX32666FTHR ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - Download the ``AD-BMSE2E3WLC-SL Firmware 1.0.0`` package. -- Copy the matching ``.hex`` file (select based on the MCU board used) from the ``bin/`` folder to the DAPLINK drive. +- Copy the matching ``HEX`` file (select based on the MCU board used) from the ``bin/`` folder to the DAPLINK drive. - The MAX32625PICO debugger flashes the MCU and remounts the drive when complete. **Verification:** @@ -116,7 +116,7 @@ For this purpose, a terminal emulator such as Tera Term is recommended. Sample reading: - .. figure:: sample-reading-in-CLI.png + .. figure:: sample-reading-in-cli.png Sample BMS Data Output @@ -498,12 +498,12 @@ Setup - Accept the prompt warning about the unapproved EULA plugin. - .. figure:: plugin-TOU.png + .. figure:: plugin-tou.png :width: 500 px - Continue to load the plugin. - .. figure:: ACEZIP-file.png + .. figure:: acezip-file.png BMSE2E3WLC-SL Plugin @@ -586,7 +586,7 @@ operating state, and temperature information. The dashboard is designed to provide a quick overview of battery health and system status during evaluation and testing. -.. figure:: AD-BMSE2E3WLC-SL_GUI.png +.. figure:: ad-bmse2e3wlc-sl_gui.png AD-BMSE2E3WLC-SL GUI diff --git a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/parked-mode-setup.png b/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/parked-mode-setup.png deleted file mode 100644 index cb66b158b98..00000000000 --- a/docs/solutions/reference-designs/ad-bmse2e3wlc-sl/software-guide/parked-mode-setup.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:127bb3fe41392f15117596ff1b1fa205327e9a8de726f025cffb49965359b814 -size 246785