From cba26693929ae4a266d94cfc6333c863ad7da898 Mon Sep 17 00:00:00 2001 From: Joyce Velasco Date: Thu, 9 Jul 2026 09:03:27 +0800 Subject: [PATCH] solutions: ref-designs: add eval-adbms1816wlc documentation --- .../EVAL-ADBMS1816WLC-block_diagram.png | 3 + .../EVAL-ADBMS1816WLC_board.png | 3 + .../hardware-guide/48v-connection.png | 3 + .../hardware-guide/baseboard-led-on.png | 3 + .../baseboard-main-components.png | 3 + .../baseboard-shunt-configuration.png | 3 + .../hardware-guide/baseboard-test-points.png | 3 + .../hardware-guide/baseboard-to-emulator.png | 3 + .../baseboard-to-max32666fthr.png | 3 + .../daughterboard-shunt-config.png | 3 + .../hardware-guide/emulator-led-on.png | 3 + .../hardware-guide/emulator-potentiometer.png | 3 + .../emulator-to-daughterboard.png | 3 + .../eval-adbms1816wlc-components.png | 3 + .../eval-adbms1816wlc-shunt.png | 3 + .../hardware-guide/full-integration-setup.png | 3 + .../hardware-guide/index.rst | 225 +++++ .../eval-adbms1816wlc/index.rst | 149 +++ .../software-guide/AD-BMSE2E3WLC-SL_GUI.png | 3 + .../software-guide/MAX32666.HTM.png | 3 + .../software-guide/ace-download.png | 3 + .../software-guide/ace-homepage.png | 3 + .../software-guide/ace-installation.png | 3 + .../ace-serial-ports-config.png | 3 + .../software-guide/ace-start-menu.png | 3 + .../ad-bmse2e3wlc-48v-plugin.png | 3 + .../ad-bmse2e3wlc-sl-ace-plugin.png | 3 + .../software-guide/device-manager-comport.png | 3 + .../software-guide/driving-mode-pd.png | 3 + .../software-guide/firmware-upload.png | 3 + .../software-guide/index.rst | 888 ++++++++++++++++++ .../software-guide/libiio-check.png | 3 + .../software-guide/libiio-version.png | 3 + .../software-guide/max-voltage-test.png | 3 + .../max32625_pico_bin_upload.png | 3 + .../software-guide/min-voltage-test.png | 3 + .../software-guide/output-pd-driving-mode.png | 3 + .../software-guide/output-pd-parked-mode.png | 3 + .../software-guide/parked-mode-pd.png | 3 + .../software-guide/plugin-TOU.png | 3 + .../software-guide/plugin.png | 3 + .../software-guide/sample-reading-in-CLI.png | 3 + .../software-guide/shunt-connection-mode.png | 3 + .../software-guide/test-plugin.png | 3 + .../software-guide/with-BMS2-output.png | 3 + .../software-guide/without-BMS2-output.png | 3 + 46 files changed, 1391 insertions(+) create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/EVAL-ADBMS1816WLC-block_diagram.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/EVAL-ADBMS1816WLC_board.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/48v-connection.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/baseboard-led-on.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/baseboard-main-components.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/baseboard-shunt-configuration.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/baseboard-test-points.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/baseboard-to-emulator.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/baseboard-to-max32666fthr.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/daughterboard-shunt-config.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/emulator-led-on.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/emulator-potentiometer.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/emulator-to-daughterboard.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/eval-adbms1816wlc-components.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/eval-adbms1816wlc-shunt.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/full-integration-setup.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/index.rst create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/index.rst create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/AD-BMSE2E3WLC-SL_GUI.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/MAX32666.HTM.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/ace-download.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/ace-homepage.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/ace-installation.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/ace-serial-ports-config.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/ace-start-menu.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/ad-bmse2e3wlc-48v-plugin.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/ad-bmse2e3wlc-sl-ace-plugin.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/device-manager-comport.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/driving-mode-pd.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/firmware-upload.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/index.rst create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/libiio-check.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/libiio-version.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/max-voltage-test.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/max32625_pico_bin_upload.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/min-voltage-test.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/output-pd-driving-mode.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/output-pd-parked-mode.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/parked-mode-pd.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/plugin-TOU.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/plugin.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/sample-reading-in-CLI.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/shunt-connection-mode.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/test-plugin.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/with-BMS2-output.png create mode 100644 docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/without-BMS2-output.png diff --git a/docs/solutions/reference-designs/eval-adbms1816wlc/EVAL-ADBMS1816WLC-block_diagram.png b/docs/solutions/reference-designs/eval-adbms1816wlc/EVAL-ADBMS1816WLC-block_diagram.png new file mode 100644 index 00000000000..5292c9bd879 --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/EVAL-ADBMS1816WLC-block_diagram.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:5bd0d1728a2feed2c8288d410aa2a0da2c42d204579d205a1240e0adb0abc592 +size 39915 diff --git a/docs/solutions/reference-designs/eval-adbms1816wlc/EVAL-ADBMS1816WLC_board.png b/docs/solutions/reference-designs/eval-adbms1816wlc/EVAL-ADBMS1816WLC_board.png new file mode 100644 index 00000000000..67890c97e3c --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/EVAL-ADBMS1816WLC_board.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:36e837bb9d21520ece6f6fbf37f1cefe6b0bfb10efa9254c1fe91047d68d6c9f +size 12384754 diff --git a/docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/48v-connection.png b/docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/48v-connection.png new file mode 100644 index 00000000000..df788bc2931 --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/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/eval-adbms1816wlc/hardware-guide/baseboard-led-on.png b/docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/baseboard-led-on.png new file mode 100644 index 00000000000..4762be05fd9 --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/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/eval-adbms1816wlc/hardware-guide/baseboard-main-components.png b/docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/baseboard-main-components.png new file mode 100644 index 00000000000..679f70db56a --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/baseboard-main-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/eval-adbms1816wlc/hardware-guide/baseboard-shunt-configuration.png b/docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/baseboard-shunt-configuration.png new file mode 100644 index 00000000000..41fcdaaf1e0 --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/baseboard-shunt-configuration.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/eval-adbms1816wlc/hardware-guide/baseboard-test-points.png b/docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/baseboard-test-points.png new file mode 100644 index 00000000000..0cca7d0b023 --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/baseboard-test-points.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/eval-adbms1816wlc/hardware-guide/baseboard-to-emulator.png b/docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/baseboard-to-emulator.png new file mode 100644 index 00000000000..6757b755794 --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/baseboard-to-emulator.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:d938548e9aa17b086319518fdbf452d78303db265a537f8a25fd4a756e21e263 +size 5419570 diff --git a/docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/baseboard-to-max32666fthr.png b/docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/baseboard-to-max32666fthr.png new file mode 100644 index 00000000000..d0065421b3f --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/baseboard-to-max32666fthr.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/eval-adbms1816wlc/hardware-guide/daughterboard-shunt-config.png b/docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/daughterboard-shunt-config.png new file mode 100644 index 00000000000..55c298efd52 --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/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/eval-adbms1816wlc/hardware-guide/emulator-led-on.png b/docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/emulator-led-on.png new file mode 100644 index 00000000000..14bb5299c28 --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/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/eval-adbms1816wlc/hardware-guide/emulator-potentiometer.png b/docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/emulator-potentiometer.png new file mode 100644 index 00000000000..c3c4729fe04 --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/emulator-potentiometer.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:0e3177663daafe2526c20294e73955b688657d35eecd867039300257dd39a0d1 +size 3371606 diff --git a/docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/emulator-to-daughterboard.png b/docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/emulator-to-daughterboard.png new file mode 100644 index 00000000000..b78ddb67650 --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/emulator-to-daughterboard.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:5d776a95dc4a39a0a18239dc62df6cf6b80a9b7e8ae0c6ad7cae2d99b7f02e1a +size 3863937 diff --git a/docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/eval-adbms1816wlc-components.png b/docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/eval-adbms1816wlc-components.png new file mode 100644 index 00000000000..86dd4ac9012 --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/eval-adbms1816wlc-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/eval-adbms1816wlc/hardware-guide/eval-adbms1816wlc-shunt.png b/docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/eval-adbms1816wlc-shunt.png new file mode 100644 index 00000000000..55c298efd52 --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/eval-adbms1816wlc-shunt.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/eval-adbms1816wlc/hardware-guide/full-integration-setup.png b/docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/full-integration-setup.png new file mode 100644 index 00000000000..f40f107ba27 --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/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/eval-adbms1816wlc/hardware-guide/index.rst b/docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/index.rst new file mode 100644 index 00000000000..b1239c72f54 --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/hardware-guide/index.rst @@ -0,0 +1,225 @@ +.. _ad-bmse2e3wlc-48v hardware: + +Hardware Guide +============== + +Components and Connections +-------------------------- + +.. figure:: eval-adbms1816wlc-components.png + :width: 800 px + + EVAL-ADBMS1816WLC 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 | ++-----+----------------------+-----------------------------------------+ + +Hardware Setup +-------------- + +**Requirements** + + * 1 × :adi:`EVAL-ADBMS1816WLC` Board + * 1 × :adi:`DC2472A` Battery Emulator + * 1 × Digital Multimeter (DMM) + +Jumper Configuration +~~~~~~~~~~~~~~~~~~~~ + +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-ADBMS1816WLC 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 + :adi:`DC2472A` battery emulator. + +- Connect the :adi:`DC2472A` battery emulator to the :adi:`EVAL-ADBMS1816WLC` + daughterboard through the cell connector. + + .. figure:: emulator-to-daughterboard.png + :width: 600 px + + EVAL-ADBMS1816WLC to Battery Emulator Setup + +- Connect a 5V external power source to the :adi:`DC2472A` battery emulator (J1) + using a USB cable. An 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 + +Cell Voltage Measurement Using DMM +---------------------------------- + +Using a **Digital Multimeter (DMM)**: + +Rotate the knob of the DC2472A clockwise to set it to the lowest +voltage. Record the measurement for each cell voltage (C1 to C16). + + - Set the DMM to voltage mode + - Place the probes (+) and (–) between adjacent cells to measure voltage + - The reading should fall within the specified range to be considered + “good”; otherwise, mark it as “bad” + - Do not remove the supply during measurement + - Clockwise → lowest voltage (1.3V to 1.7V) + - Counterclockwise → highest voltage (4.0V to 4.5V) + + .. figure:: emulator-potentiometer.png + :width: 1000 px + + DC2472A Battery Emulator Potentiometer + +**Expected Reading between Cells for EVAL-ADBMS1816WLC** + ++------------+-------+-------+-------+-------+-------+-------+-------+-------+-------+-------+-------+-------+------+------+------+------+------------+ +| RANGE (V) | C1 | C2 | C3 | C4 | C5 | C6 | C7 | C8 | C9 | C10 | C11 | C12 | C13 | C14 | C15 | C16 | ASSESSMENT | ++============+=======+=======+=======+=======+=======+=======+=======+=======+=======+=======+=======+=======+======+======+======+======+============+ +| 4.0 to 5.0 | 4 | 4 | 4 | 4 | 4 | 4 | 4 | 4 | 4 | 4 | 4 | 4 | 4 | 4 | 4 | 4 | GOOD | ++------------+-------+-------+-------+-------+-------+-------+-------+-------+-------+-------+-------+-------+------+------+------+------+------------+ +| 1.3 to 1.7 | 1.431 | 1.431 | 1.431 | 1.431 | 1.431 | 1.431 | 1.431 | 1.431 | 1.431 | 1.431 | 1.431 | 1.431 | 1.43 | 1.43 | 1.43 | 1.43 | GOOD | ++------------+-------+-------+-------+-------+-------+-------+-------+-------+-------+-------+-------+-------+------+------+------+------+------------+ + +---- + +Full System Integration Setup +----------------------------- + +**Requirements** + +* 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) + + +AD-BMSE2E3WLC-48V Baseboard Setup +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +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-configuration.png + :width: 1500 px + + AD-BMSE2E3WLC-48V Baseboard Shunt Configuration + +- Connect the second :adi:`DC2472A` battery emulator to the :adi:`EVAL-ADBMS1816WLC` Daughter Board + through the cell connector. + + .. figure:: baseboard-to-emulator.png + :width: 600 px + + AD-BMSE2E3WLC-48V to Battery Emulator Setup + +Microcontroller Connection +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +- Attach the :adi:`MAX32666FTHR` microcontroller to the :adi:`AD-BMSE2E3WLC-48V` + Baseboard through the Featherwing connector. + + .. figure:: baseboard-to-max32666fthr.png + :width: 600 px + + MAX32666FTHR Mounted to the 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 :adi:`AD-BMSE2E3WLC-48V`. + + (B). Plug the micro-USB cable to the second :adi:`DC2472A` battery emulator + that is connected to :adi:`EVAL-ADBMS1816WLC`. + + (C). Plug the micro-USB cable into the :adi:`MAX32666FTHR`. + + (D). Connect the 2-wire isoSPI cable from P10 of :adi:`AD-BMSE2E3WLC-48V`. + + (E). Connect the other end of the 2-wire isoSPI cable to P10 of + :adi:`EVAL-ADBMS1816WLC`. + + (F). Connect all USB cables to a USB hub (preferred). + + .. note:: + + If your PC/laptop USB ports can supply ≥1 A, 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:`EVAL-ADBMS1816WLC` can be evaluated through the ACE GUI by running the AD-BMSE2E3WLC software package. + +Access the software resources and see the setup procedure in the +:ref:`Software User Guide `. diff --git a/docs/solutions/reference-designs/eval-adbms1816wlc/index.rst b/docs/solutions/reference-designs/eval-adbms1816wlc/index.rst new file mode 100644 index 00000000000..9fb5420955a --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/index.rst @@ -0,0 +1,149 @@ +.. _eval-adbms1816wlc: + +EVAL-ADBMS1816WLC +================= + +E2/E3W BMS Extension Board + +Overview +-------- + +.. figure:: EVAL-ADBMS1816WLC_board.png + :width: 600 px + + EVAL-ADBMS1816WLC Board + +The :adi:`EVAL-ADBMS1816WLC` is an expansion and evaluation platform +designed to work in conjunction with the :adi:`AD-BMSE2E3WLC-48V` Baseboard, +providing additional cell-monitoring capability for battery packs used +in Electric 2-Wheeler (E2W), Electric 3-Wheeler (E3W), +and Light Electric Vehicle (LEV) applications. + +The board is built around the :adi:`ADBMS1816W ` battery-monitoring IC, +which enables precise measurement of battery cell voltages +as part of the :adi:`AD-BMSE2E3WLC-SL` reference design. + +Designed for seamless integration, the EVAL-ADBMS1816WLC Daughter Board +connects to the AD-BMSE2E3WLC-48V Baseboard through isoSPI communication, +supporting scalable and daisy-chain-ready battery management architectures. + +The board includes Arduino-compatible headers and dedicated cell connectors, +that simplify hardware setup and system expansion. + +When combined with the AD-BMSE2E3WLC software ecosystem, firmware examples, +and GUI tools, the daughter board enables real-time cell-voltage monitoring, +diagnostics, data visualization, and rapid evaluation of battery management algorithms +for a wide range of rechargeable battery chemistries and energy-storage applications. + +Features +-------- + +**Wide Range BMS System** + + - can handle from 36V to 48V, can operate up to 100A + +**Battery Chemistry Compatibility** + + - Supports multiple battery chemistries: Ni-MH, Li-ion, LiFePO4, Sodium-ion + +**System Integration** + + - Can be used with Arduino-based microcontroller board + - Plug-and-play integration + +**Monitoring Capabilities** + + - Cell voltage accuracy: ±3.0mV + - Temperature monitoring: Up to 8 sensors + - SOC/SOH Coulomb counting + - High-side and low-side current sensing + +**Connectivity and Software** + + - Daisy-chaining ready for multi-board configurations + - With comprehensive GUI that is compatible with any PC/laptop + and enables real-time battery monitoring and diagnostics + +Applications +------------ + + - Medium to High Performance Electric and Hybrid 2-and 3-Wheeler Vehicles + - Light Electric Vehicles + - BMS Battery Research and Development + - Adaptive Battery Type System Monitoring + - Portable Energy Storage Systems + +System Architecture +------------------- + +.. figure:: EVAL-ADBMS1816WLC-block_diagram.png + :width: 800 px + + EVAL-ADBMS1816WLC Simplified Block Diagram + +Specifications +-------------- + ++----------------------+-------+---------+-------+------+------------------+ +| **Parameter** | Min | Typical | Max | Unit | **Notes** | ++======================+=======+=========+=======+======+==================+ +| **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 | | ++----------------------+-------+---------+-------+------+------------------+ + +User Guides +----------- + +Proceed to the following pages for detailed information on +how to use the EVAL-ADBMS1816WLC reference design: + + .. toctree:: + :titlesonly: + :glob: + + */index + +Resources +--------- + + - :adi:`ADBMS1816 Data Sheet ` + +Design & Integration Files +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. admonition:: Download + + :adi:`EVAL-ADBMS1816WLC Design Support Package ` + + * 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/eval-adbms1816wlc/software-guide/AD-BMSE2E3WLC-SL_GUI.png b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/AD-BMSE2E3WLC-SL_GUI.png new file mode 100644 index 00000000000..0789f8d56d2 --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/AD-BMSE2E3WLC-SL_GUI.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:ff8bdadf4cdc481db04174510fb535f8a2bbfb32f3e1655a46250b991558961c +size 1518663 diff --git a/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/MAX32666.HTM.png b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/MAX32666.HTM.png new file mode 100644 index 00000000000..98205b777cd --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/MAX32666.HTM.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:1c6f857f9675b2ea893478e93000b812a1279e5314691bb4f5cb73609a474291 +size 541547 diff --git a/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/ace-download.png b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/ace-download.png new file mode 100644 index 00000000000..4d3f66f77f3 --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/ace-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/eval-adbms1816wlc/software-guide/ace-homepage.png b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/ace-homepage.png new file mode 100644 index 00000000000..dacc23b0f9d --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/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/eval-adbms1816wlc/software-guide/ace-installation.png b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/ace-installation.png new file mode 100644 index 00000000000..2a301d020ff --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/ace-installation.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:dea76307655a0aabc918c8672c6ae6fea8deee8b26f61c3e2c84e5b72649f7ea +size 2998380 diff --git a/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/ace-serial-ports-config.png b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/ace-serial-ports-config.png new file mode 100644 index 00000000000..46493cb30b2 --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/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/eval-adbms1816wlc/software-guide/ace-start-menu.png b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/ace-start-menu.png new file mode 100644 index 00000000000..40af1be8168 --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/ace-start-menu.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:b2b1dae32acef8d4a7808ba3d2f9567ee97a876d43286031de7a1fbe3201053e +size 9811 diff --git a/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/ad-bmse2e3wlc-48v-plugin.png b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/ad-bmse2e3wlc-48v-plugin.png new file mode 100644 index 00000000000..9870b5f9a60 --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/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/eval-adbms1816wlc/software-guide/ad-bmse2e3wlc-sl-ace-plugin.png b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/ad-bmse2e3wlc-sl-ace-plugin.png new file mode 100644 index 00000000000..9870b5f9a60 --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/ad-bmse2e3wlc-sl-ace-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/eval-adbms1816wlc/software-guide/device-manager-comport.png b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/device-manager-comport.png new file mode 100644 index 00000000000..464195629aa --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/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/eval-adbms1816wlc/software-guide/driving-mode-pd.png b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/driving-mode-pd.png new file mode 100644 index 00000000000..3cb3c46602d --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/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/eval-adbms1816wlc/software-guide/firmware-upload.png b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/firmware-upload.png new file mode 100644 index 00000000000..eed72a93185 --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/firmware-upload.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:4f3c59e85297b4a697a76b7aa41f9ccbb8cb2ca0844b69bf451720722c5fa1a0 +size 2323857 diff --git a/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/index.rst b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/index.rst new file mode 100644 index 00000000000..71af13bea10 --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/index.rst @@ -0,0 +1,888 @@ +.. _eval-adbms1816wlc software: + +Software Guide +============== + +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 ` + - AD-BMSE2E3WLC-SL ACE GUI Plugin Installer (link to follow) + - `MAX32625PICO Image `_ + - Code editor (such as Visual Studio Code) + - Terminal application (such as Tera Term) + +Firmware Upload +--------------- + +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 + +---- + +GUI Setup +--------- + +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-download.png + + ACE Software Download + +**Step 2: Install ACE Software** + + - Run the installer. + - Follow on-screen installation steps, as shown in the following figures: + + .. figure:: ace-installation.png + :width: 800 px + + ACE Software Installation Steps + + - Verify installation via the Start Menu. + + .. figure:: ace-start-menu.png + :align: center + + ACE Software Start Menu Verification + +**Step 3: Load Plugin** + + - Run the downloaded ``ACEZIP file``. + + - Accept the prompt warning about unapproved EULA plugins. + + .. figure:: plugin-TOU.png + :width: 500 px + + - Continue to load the plugin. + + .. figure:: test-plugin.png + + AD-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** (as in the figure below). + + .. 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 enter the detected COM port. + +2. Set **Protocol = IIO**, then ``Enable`` the port. + +3. Click ``OK`` to apply the settings. + + .. figure:: ace-serial-ports-config.png + + ACE Serial Port Settings + +4. Restart ACE. + + Expected Result: 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 + :width: 500 px + + Installed libiio Version Check + + The ACE plugin requires **libiio v0.26** to function correctly. + If an earlier version is installed (for example, v0.25), please upgrade to v0.26 using the following link: + + https://github.com/analogdevicesinc/libiio/releases/download/v0.26/libiio-0.26.ga0eca0d2-setup.exe + +---- + +GUI Overview +~~~~~~~~~~~~ + +The AD-BMSE2E3WLC 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 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 evaluation. + +---- + +Functional Testing Using GUI +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Hardware Connectivity Verification Test +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + + - Change the pin header setting for the EVAL-ADBMS1816WLC from pin 2→3 to pin 1→2 + + .. figure:: shunt-connection-mode.png + :width: 300 px + + EVAL-ADBMS1816WLC Connection Mode P17 (from 2->3 to 1→2) + + - Open the ACE GUI and run the plugin. + + - Expected: No output on BMS2 + + .. figure:: without-BMS2-output.png + :width: 800 px + + EVAL-ADBMS1816WLC P17 (from 2->3 to 1→2) should reflect no output on BMS2 + + - Restore P17 to its original setting (pin 2→3): + + - Output on BMS2 should now be present. + + .. figure:: with-BMS2-output.png + :width: 800 px + + EVAL-ADBMS1816WLC P17 (return to 2→3) should show output on BMS2 + +Voltage Adjustment Test +^^^^^^^^^^^^^^^^^^^^^^^ + +**Minimum Voltage Test** + + - Rotate both DC2472A knobs **clockwise (for minimum setting)** + + Expected readings: + + - Cell voltage: **1.3V to 1.7V** + + - Stack voltage: decreases + + .. figure:: min-voltage-test.png + + AD-BMSE2E3WLC-SL Minimum Voltage Test + +**Maximum Voltage Test** + + - Rotate both DC2472A knobs **counterclockwise (for maximum setting)** + + Expected readings: + + - Cell voltage: **4.0V to 5.0V** + + - Stack voltage: increases + + .. figure:: max-voltage-test.png + + AD-BMSE2E3WLC-SL Maximum Voltage Test + + You may adjust one emulator at a time to observe changes clearly. + +---- + +Output Power Delivery Test +^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Measure using a **Digital Multimeter (DMM)**: + + - Connect **DMM (–)** to AD-BMSE2E3WLC-48V Baseboard's **Ground**. + - Connect **DMM (+)** to AD-BMSE2E3WLC-48V Baseboard's **TP23**. + +In GUI: + +Parked Mode: + + Expected reading: **4.0V to 4.7V** + + .. figure:: parked-mode-pd.png + + AD-BMSE2E3WLC-SL Power Delivery Test "Parked" Mode + +Driving Mode: + + - Set **Vehicle State = Driving**. + - Verify voltage again in DMM. + + .. figure:: driving-mode-pd.png + :width: 600 px + + AD-BMSE2E3WLC-SL Power Delivery Test "Driving" Mode + + - Once done, set the Vehicle State again to **Parked**, then close the GUI. + +| + +**Shutdown Procedure** + +Follow this sequence to safely power down: + +1. Disconnect power from MAX32666FTHR microcontroller. +2. Disconnect power from both DC2472A battery cell emulators. +3. Remove all cables. +4. Return hardware to proper storage. diff --git a/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/libiio-check.png b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/libiio-check.png new file mode 100644 index 00000000000..b400fa9f67f --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/libiio-check.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:c0bf60e67aba453a418db661b085f5dc44087a159751bed6f0c23636a2e8a018 +size 192583 diff --git a/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/libiio-version.png b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/libiio-version.png new file mode 100644 index 00000000000..9fce10e22d1 --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/libiio-version.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:419f1f8423c472d42bb62b718bae742a9e4da69cf52f942cd32ea07c5373500a +size 157898 diff --git a/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/max-voltage-test.png b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/max-voltage-test.png new file mode 100644 index 00000000000..e4aee2b695c --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/max-voltage-test.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:f4c34c34876829381aa640ea4468c31c636e357a39e46c0f2ff4a4c3e4b3a270 +size 220778 diff --git a/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/max32625_pico_bin_upload.png b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/max32625_pico_bin_upload.png new file mode 100644 index 00000000000..ee2f60e9252 --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/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/eval-adbms1816wlc/software-guide/min-voltage-test.png b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/min-voltage-test.png new file mode 100644 index 00000000000..ce2add0d2f9 --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/min-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/eval-adbms1816wlc/software-guide/output-pd-driving-mode.png b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/output-pd-driving-mode.png new file mode 100644 index 00000000000..b7c268afa3c --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/output-pd-driving-mode.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:8e401d007d31dc0fcb38a6444eac7d57b6467dc095c82a8a65ab072b02fd6aed +size 3532384 diff --git a/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/output-pd-parked-mode.png b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/output-pd-parked-mode.png new file mode 100644 index 00000000000..36c90eb9031 --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/output-pd-parked-mode.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:c22b1c77a84de8857a3dd33adeb7988cf64b406f85c817077e3624b831eda470 +size 4018419 diff --git a/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/parked-mode-pd.png b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/parked-mode-pd.png new file mode 100644 index 00000000000..f222a530da2 --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/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/eval-adbms1816wlc/software-guide/plugin-TOU.png b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/plugin-TOU.png new file mode 100644 index 00000000000..d0e9cb648cf --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/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/eval-adbms1816wlc/software-guide/plugin.png b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/plugin.png new file mode 100644 index 00000000000..9870b5f9a60 --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/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/eval-adbms1816wlc/software-guide/sample-reading-in-CLI.png b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/sample-reading-in-CLI.png new file mode 100644 index 00000000000..35910216073 --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/sample-reading-in-CLI.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:6d084f4b2141133e9341ee57c1ab2d856c046b6ec6090fd5f372532040da7244 +size 24957 diff --git a/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/shunt-connection-mode.png b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/shunt-connection-mode.png new file mode 100644 index 00000000000..e8234f4798f --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/shunt-connection-mode.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:987b3d92dd109a68511990fad96c252dbe3f37355507bae2483d15b7a6c18e51 +size 19732 diff --git a/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/test-plugin.png b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/test-plugin.png new file mode 100644 index 00000000000..f9370b7622c --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/test-plugin.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/eval-adbms1816wlc/software-guide/with-BMS2-output.png b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/with-BMS2-output.png new file mode 100644 index 00000000000..419962598bb --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/with-BMS2-output.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:ef50e5b8fa6b0da0ccf3b189c757c400c3a80dd45b99084729fb7a877fc60988 +size 222623 diff --git a/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/without-BMS2-output.png b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/without-BMS2-output.png new file mode 100644 index 00000000000..6163bbdbb98 --- /dev/null +++ b/docs/solutions/reference-designs/eval-adbms1816wlc/software-guide/without-BMS2-output.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:dfa8c0142055bdff657587a1b28fa2f24c1955aa3bc6cd76ddede0b3c115537b +size 211812