diff --git a/doc/sphinx/source/projects/ad-acevsecrdset-sl.rst b/doc/sphinx/source/projects/ad-acevsecrdset-sl.rst new file mode 100644 index 00000000000..51a06c9588c --- /dev/null +++ b/doc/sphinx/source/projects/ad-acevsecrdset-sl.rst @@ -0,0 +1 @@ +.. include:: ../../../../projects/ad-acevsecrdset-sl/README.rst \ No newline at end of file diff --git a/doc/sphinx/source/projects_doc.rst b/doc/sphinx/source/projects_doc.rst index add4ad86d46..480ff57925c 100644 --- a/doc/sphinx/source/projects_doc.rst +++ b/doc/sphinx/source/projects_doc.rst @@ -93,6 +93,10 @@ EVAL BOARDS projects/apard32690 + + + projects/ad-acevsecrdset-sl + DIGITAL-IO ========== .. toctree:: diff --git a/projects/ad-acevsecrdset-sl/README.rst b/projects/ad-acevsecrdset-sl/README.rst new file mode 100644 index 00000000000..65873c89adf --- /dev/null +++ b/projects/ad-acevsecrdset-sl/README.rst @@ -0,0 +1,173 @@ +AD-ACEVSECRDSET-SL no-OS Example Project +======================================== + +.. contents:: + :depth: 3 + +Supported Evaluation Boards +---------------------------- + +- `AD-ACEVSECRDSET-SL `__ + +Overview +-------- + +The AD-ACEVSECRDSET-SL is a Type 2 electric vehicle supply equipment +(EVSE) solution for evaluating and prototyping EV charging systems at a +3.6 kW capacity. It includes components such as the ADE9153 for voltage +and current measurement and the MAX32655 ARM Cortex-M4 microcontroller +for control and communication, equipped with Bluetooth via the MAX32656. +This user guide highlights its open-source software stack designed to +support electrical applications while aligning with safety standards +IEC61851 and IEC62752. The documentation is structured for clear +technical understanding, focusing on the device’s capabilities and +compliance standards. + +Applications +------------- + +- EV Charging + +Hardware Specifications +----------------------- + +Power Supply Requirements +~~~~~~~~~~~~~~~~~~~~~~~~~ + +The AD-ACEVSECRDSET-SL requires an input voltage range of 195V to 264V +for a 230V nominal setup and 102V to 138V for a 120V nominal setup, both +with a ±15% tolerance. It supports a maximum current capacity of 16A, +with 10A available for lower power settings. The system ensures +operational safety by conducting self-tests and monitoring voltage +limits, relay states, and both AC and DC residual current devices +(RCDs). It incorporates overcurrent measurement and temperature +monitoring as part of its compliance with EV charging standards such as +IEC61851 and IEC62752. + +On-board Connections +~~~~~~~~~~~~~~~~~~~~ + ++-----------------+-----------------+-----------------+-----------------+ +| Connector Type | Purpose | Location on | Associated | +| | | Board | Components | ++-----------------+-----------------+-----------------+-----------------+ +| Grid Connector | AC Power Input | Top left of | Neutral (N), | +| | | board | Live (L), | +| | | | Protective | +| | | | Earth (PE) | ++-----------------+-----------------+-----------------+-----------------+ +| EV Connector | Vehicle | Mid-right of | Control Pilot | +| | Connection | board | (CP), Neutral | +| | | | (N), Line (L), | +| | | | PE | ++-----------------+-----------------+-----------------+-----------------+ +| BLE Antenna | Wireless | Part of control | Bluetooth 5.2 | +| | Communication | module | | ++-----------------+-----------------+-----------------+-----------------+ +| Debug/ | System | Near | RS-232, USB | +| Programming | Debugging and | microcontroller | connections | +| Connector | Programming | unit | | ++-----------------+-----------------+-----------------+-----------------+ + +No-OS Build Setup +----------------- + +Please see: `https://wiki.analog.com/resources/no-os/build` + +No-OS Supported Examples +------------------------- + +The initialization data used in the example is taken out from the +`Project Common Data Path `__ + +The macros used in Common Data are defined in platform specific files +found in the `Project Platform Configuration Path `__ + +Example Project for Rev. D board +-------------------------------- + +The no-OS project for the AD-ACEVSECRDSET-SL evaluation board includes +reference firmware that demonstrates how to interface with the +MAX32655PICO microcontroller and Analog Devices peripherals. + +In order to build the example project, make sure you have the following +configuration in the +`Makefile `__ : + +.. code-block:: bash + + # Select the example you want to enable by choosing y for enabling and n for disabling + REV_A = n + REV_D = y + +No-OS Supported Platforms +------------------------- + +Maxim Platform +~~~~~~~~~~~~~~~ + +Hardware Used +^^^^^^^^^^^^^ + +- AD-ACEVSECRDSET-SL board (Rev. D) +- :adi:`MAX32625PICO microcontroller ` + +Connections +^^^^^^^^^^^^ + +- Connect the MAX32625PICO to the AD-ACEVSECRDSET-SL board using a USB + to micro-USB cable. +- Attach a 10-pin SWD Cable for programming and debugging. +- Connect the AD-ACEVSECRDSET-SL board to a power source using a + suitable 3-wire cable for mains electricity (195V to 264V). + +**Software Setup** + +*Install the MAX32655 Firmware* + +To flash the MAX32655 firmware image: + +- Download the latest firmware image for the MAX32655FTHR board: + `https://github.com/analogdevicesinc/max32625pico-firmware-images/raw/master/bin/max32625_max32655fthr_if_crc_swd_v1.0.3.bin` + +- Connect the MAX32625PICO board to your computer. + +- Hold the main button while powering on to mount it as a ``MAINTENANCE`` + drive. + +- Drag and drop the firmware image to the ``MAINTENANCE`` drive. + +- Eject the drive safely and reboot the board. + +**Basic Example Project** + +The AD-ACEVSECRDSET-SL basic example project showcases the +implementation of a Type 2 EVSE solution using the MAX32655 +microcontroller. This setup includes the ADE9153 for voltage and current +measurement and features compliance with IEC61851 and IEC62752 safety +standards. It highlights the use of various hardware interface modules +for effective communication and control, such as SPI, UART, and I2C. +Central to the project is a state machine managing charging states and +interfacing with pilot, relay, and RCD functions, allowing control over +the charging process. + +In order to build the basic example project, make sure you have the +following configuration in the +`Makefile `__ : + +.. code-block:: bash + + # Select the example you want to enable + REV_D = y + +Build Command +^^^^^^^^^^^^^ + +.. code-block:: bash + + # to delete the current build + make reset + # to build the project + make PLATFORM=maxim TARGET=MAX32625 EXAMPLE=basic + # to flash the code + make run