Skip to content

Commit 493927a

Browse files
committed
projects: ad-acevsecrdset-sl: Added readme doc
Added the readme document for the AD-ACEVSECRDSET-SL project Also modified the projects_doc.rst file to add the corresponding source for this new readme. Signed-off-by: Joyce Velasco <[email protected]>
1 parent 42dfdcc commit 493927a

File tree

3 files changed

+176
-0
lines changed

3 files changed

+176
-0
lines changed
Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
.. include:: ../../../../projects/ad-acevsecrdset-sl/README.rst

doc/sphinx/source/projects_doc.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -91,6 +91,8 @@ EVAL BOARDS
9191

9292
projects/apard32690
9393

94+
projects/ad-acevsecrdset-sl
95+
9496
DIGITAL-IO
9597
==========
9698
.. toctree::
Lines changed: 173 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,173 @@
1+
AD-ACEVSECRDSET-SL no-OS Example Project
2+
========================================
3+
4+
.. contents::
5+
:depth: 3
6+
7+
Supported Evaluation Boards
8+
----------------------------
9+
10+
- `AD-ACEVSECRDSET-SL <https://www.analog.com/ad-bct2ade9113-sl.html>`__
11+
12+
Overview
13+
--------
14+
15+
The AD-ACEVSECRDSET-SL is a Type 2 electric vehicle supply equipment
16+
(EVSE) solution for evaluating and prototyping EV charging systems at a
17+
3.6 kW capacity. It includes components such as the ADE9153 for voltage
18+
and current measurement and the MAX32655 ARM Cortex-M4 microcontroller
19+
for control and communication, equipped with Bluetooth via the MAX32656.
20+
This user guide highlights its open-source software stack designed to
21+
support electrical applications while aligning with safety standards
22+
IEC61851 and IEC62752. The documentation is structured for clear
23+
technical understanding, focusing on the device’s capabilities and
24+
compliance standards.
25+
26+
Applications
27+
-------------
28+
29+
- EV Charging
30+
31+
Hardware Specifications
32+
-----------------------
33+
34+
Power Supply Requirements
35+
~~~~~~~~~~~~~~~~~~~~~~~~~
36+
37+
The AD-ACEVSECRDSET-SL requires an input voltage range of 195V to 264V
38+
for a 230V nominal setup and 102V to 138V for a 120V nominal setup, both
39+
with a ±15% tolerance. It supports a maximum current capacity of 16A,
40+
with 10A available for lower power settings. The system ensures
41+
operational safety by conducting self-tests and monitoring voltage
42+
limits, relay states, and both AC and DC residual current devices
43+
(RCDs). It incorporates overcurrent measurement and temperature
44+
monitoring as part of its compliance with EV charging standards such as
45+
IEC61851 and IEC62752.
46+
47+
On-board Connections
48+
~~~~~~~~~~~~~~~~~~~~
49+
50+
+-----------------+-----------------+-----------------+-----------------+
51+
| Connector Type | Purpose | Location on | Associated |
52+
| | | Board | Components |
53+
+-----------------+-----------------+-----------------+-----------------+
54+
| Grid Connector | AC Power Input | Top left of | Neutral (N), |
55+
| | | board | Live (L), |
56+
| | | | Protective |
57+
| | | | Earth (PE) |
58+
+-----------------+-----------------+-----------------+-----------------+
59+
| EV Connector | Vehicle | Mid-right of | Control Pilot |
60+
| | Connection | board | (CP), Neutral |
61+
| | | | (N), Line (L), |
62+
| | | | PE |
63+
+-----------------+-----------------+-----------------+-----------------+
64+
| BLE Antenna | Wireless | Part of control | Bluetooth 5.2 |
65+
| | Communication | module | |
66+
+-----------------+-----------------+-----------------+-----------------+
67+
| Debug/ | System | Near | RS-232, USB |
68+
| Programming | Debugging and | microcontroller | connections |
69+
| Connector | Programming | unit | |
70+
+-----------------+-----------------+-----------------+-----------------+
71+
72+
No-OS Build Setup
73+
-----------------
74+
75+
Please see: `https://wiki.analog.com/resources/no-os/build`__.
76+
77+
No-OS Supported Examples
78+
-------------------------
79+
80+
The initialization data used in the example is taken out from the
81+
`Project Common Data Path <https://github.com/analogdevicesinc/no-OS/tree/main/projects/ad-acevsecrdset-sl/src/common>`__.
82+
83+
The macros used in Common Data are defined in platform specific files
84+
found in the `Project Platform Configuration Path <https://github.com/analogdevicesinc/no-OS/tree/main/projects/ad-acevsecrdset-sl/src/platform>`__.
85+
86+
Example Project for Rev. D board
87+
--------------------------------
88+
89+
The no-OS project for the AD-ACEVSECRDSET-SL evaluation board includes
90+
reference firmware that demonstrates how to interface with the
91+
MAX32655PICO microcontroller and Analog Devices peripherals.
92+
93+
In order to build the example project, make sure you have the following
94+
configuration in the
95+
`Makefile <https://github.com/analogdevicesinc/no-OS/blob/main/projects/ad-acevsecrdset-sl/Makefile>`__ :
96+
97+
.. code-block:: bash
98+
99+
# Select the example you want to enable by choosing y for enabling and n for disabling
100+
REV_A = n
101+
REV_D = y
102+
103+
No-OS Supported Platforms
104+
-------------------------
105+
106+
Maxim Platform
107+
~~~~~~~~~~~~~~~
108+
109+
Hardware Used
110+
^^^^^^^^^^^^^
111+
112+
- AD-ACEVSECRDSET-SL board (Rev. D)
113+
- :adi:`MAX32625PICO microcontroller <MAX32625PICO>`
114+
115+
Connections
116+
^^^^^^^^^^^^
117+
118+
- Connect the MAX32625PICO to the AD-ACEVSECRDSET-SL board using a USB
119+
to micro-USB cable.
120+
- Attach a 10-pin SWD Cable for programming and debugging.
121+
- Connect the AD-ACEVSECRDSET-SL board to a power source using a
122+
suitable 3-wire cable for mains electricity (195V to 264V).
123+
124+
**Software Setup**
125+
126+
*Install the MAX32655 Firmware*
127+
128+
To flash the MAX32655 firmware image:
129+
130+
- Download the latest firmware image for the MAX32655FTHR board:
131+
`https://github.com/analogdevicesinc/max32625pico-firmware-images/raw/master/bin/max32625_max32655fthr_if_crc_swd_v1.0.3.bin`__
132+
133+
- Connect the MAX32625PICO board to your computer.
134+
135+
- Hold the main button while powering on to mount it as a ``MAINTENANCE``
136+
drive.
137+
138+
- Drag and drop the firmware image to the ``MAINTENANCE`` drive.
139+
140+
- Eject the drive safely and reboot the board.
141+
142+
**Basic Example Project**
143+
144+
The AD-ACEVSECRDSET-SL basic example project showcases the
145+
implementation of a Type 2 EVSE solution using the MAX32655
146+
microcontroller. This setup includes the ADE9153 for voltage and current
147+
measurement and features compliance with IEC61851 and IEC62752 safety
148+
standards. It highlights the use of various hardware interface modules
149+
for effective communication and control, such as SPI, UART, and I2C.
150+
Central to the project is a state machine managing charging states and
151+
interfacing with pilot, relay, and RCD functions, allowing control over
152+
the charging process.
153+
154+
In order to build the basic example project, make sure you have the
155+
following configuration in the
156+
`Makefile <https://github.com/analogdevicesinc/no-OS/blob/main/projects/ad-acevsecrdset-sl/Makefile>`__ :
157+
158+
.. code-block:: bash
159+
160+
# Select the example you want to enable
161+
REV_D = y
162+
163+
Build Command
164+
^^^^^^^^^^^^^
165+
166+
.. code-block:: bash
167+
168+
# to delete the current build
169+
make reset
170+
# to build the project
171+
make PLATFORM=maxim TARGET=MAX32625 EXAMPLE=basic
172+
# to flash the code
173+
make run

0 commit comments

Comments
 (0)