Skip to content

Commit 3c8a7e0

Browse files
jvelasc2jvelasc2
committed
projects: eval-pqmon: Updated the readme file
Updated the README file to add the product User Guide link, changed file type to rst. Signed-off-by: Joyce Velasco <[email protected]>
1 parent 8171b9f commit 3c8a7e0

File tree

2 files changed

+93
-49
lines changed

2 files changed

+93
-49
lines changed

‎doc/sphinx/source/projects/eval/eval-pqmon.rst‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
.. include:: ../../../../../projects/eval-pqmon/README.rst

‎projects/eval-pqmon/README.md‎ renamed to ‎projects/eval-pqmon/README.rst‎

Lines changed: 92 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -1,75 +1,113 @@
1-
AD-PQMON-SL kit no-OS Example Project
1+
AD-PQMON-SL Kit no-OS Example Project
22
=====================================
33

4-
## Overview
4+
Overview
5+
--------
56

6-
The [AD-PQMON-SL](https://www.analog.com/en/resources/evaluation-hardware-and-software/evaluation-boards-kits/ad-pqmon-sl.html) provides a complete software and hardware platform for prototyping and evaluating high performance class S polyphase energy quality monitors. The design incorporates the ADE9430 high performance, polyphase energy monitoring IC that has an advanced metrology feature set (total and fundamental active power, volt amperes reactive (VAR), volt amperes (VA), watthour, VAR hour, VA hour, total and fundamental IRMS and VRMS, power factor) and the MAX32650 ultralow power ARM cortex-M4 with FPU-based microcontroller with 3 MB flash and 1 MB SRAM. The ADE9430 enables accurate energy monitoring over a wide dynamic range through its superior analog performance and digital signal processing (DSP) core. The ADE9430 simplifies the implementation and certification of energy and power quality monitoring systems by providing tight integration of acquisition and calculation engines. This solution can be used on a 3-phase system or up to three single-phase systems.
7+
The :adi:`AD-PQMON-SL` provides a complete software and hardware platform for
8+
prototyping and evaluating high performance class S polyphase energy quality
9+
monitors. The design incorporates the ADE9430 high performance, polyphase
10+
energy monitoring IC that has an advanced metrology feature set (total and
11+
fundamental active power, volt amperes reactive (VAR), volt amperes (VA),
12+
watthour, VAR hour, VA hour, total and fundamental IRMS and VRMS, power
13+
factor) and the MAX32650 ultralow power ARM cortex-M4 with FPU-based
14+
microcontroller with 3 MB flash and 1 MB SRAM. The ADE9430 enables accurate
15+
energy monitoring over a wide dynamic range through its superior analog
16+
performance and digital signal processing (DSP) core. The ADE9430 simplifies
17+
the implementation and certification of energy and power quality monitoring
18+
systems by providing tight integration of acquisition and calculation engines.
19+
This solution can be used on a 3-phase system or up to three single-phase
20+
systems.
721

22+
Preliminary requirements
23+
-------------------------
824

9-
## Preliminary requirements
25+
The licensed software library that works in conjunction with the ADE9430 IC
26+
can be obtained from `here <https://form.analog.com/form_pages/softwaremodules/SRF.aspx>`__.
1027

11-
The licensed software library that works in conjunction with the ADE9430 IC can be obtained from [here](https://form.analog.com/form_pages/softwaremodules/SRF.aspx).
28+
After obtaining the libraries, the following files need to be added to the
29+
project:
1230

13-
After obtaining the libraries, the following files need to be added to the project:
31+
.. code-block:: console
1432
15-
```console
16-
pqlib_dir
17-
| libadi_pqlib_cm4_gcc.a
18-
└───include
19-
| ade9430.h
20-
| adi_pqlib_debug.h
21-
| adi_pqlib_error.h
22-
| adi_pqlib_memory.h
23-
| adi_pqlib_profile.h
24-
| adi_pqlib_version.h
25-
| adi_pqlib.h
26-
└───config
27-
└───adi_pqlib_cfg.h
28-
```
33+
pqlib_dir
34+
| libadi_pqlib_cm4_gcc.a
35+
└───include
36+
| ade9430.h
37+
| adi_pqlib_debug.h
38+
| adi_pqlib_error.h
39+
| adi_pqlib_memory.h
40+
| adi_pqlib_profile.h
41+
| adi_pqlib_version.h
42+
| adi_pqlib.h
43+
└───config
44+
└───adi_pqlib_cfg.h
2945
30-
It can be integrated into the project by defining the `PQLIB_PATH` to point to the `pqlib_dir` path.
46+
It can be integrated into the project by defining the ``PQLIB_PATH`` to point
47+
to the ``pqlib_dir`` path.
3148

49+
Choose interface
50+
----------------
3251

33-
## Choose interface
52+
The firmware application can communicate with clients via several interfaces.
53+
In order to use the preferred connection type, set ``INTERFACE`` to the
54+
desired value:
3455

35-
The firmware application can communicate with clients via several interfaces. In order to use the preferred connection type, set `INTERFACE` to the desired value:
56+
* ``INTERFACE=usb`` (Default value)
57+
* ``INTERFACE=serial`` (Used for 485 communication. Half-duplex communication
58+
must be handled by user)
59+
* ``INTERFACE=ethernet_t1l`` (Used for communication over T1L)
60+
* ``INTERFACE=ethernet`` (Used for standard Ethernet communication via W5500
61+
controller)
3662

37-
* ```INTERFACE=usb``` (Default value)
38-
* ```INTERFACE=serial``` (Used for 485 communication. Half-duplex communication must be handled by user)
39-
* ```INTERFACE=ethernet_t1l``` (Used for communication over T1L)
40-
* ```INTERFACE=ethernet``` (Used for standard Ethernet communication via W5500 controller)
63+
.. note::
4164

42-
NOTE: In case one builds firmware multiple times with different interfaces, make sure to delete the `build` directory before the new compilation.
65+
In case one builds firmware multiple times with different interfaces, make
66+
sure to delete the ``build`` directory before the new compilation.
4367

44-
NOTE 2: For T1L connection the deffault ip for the device is `192.168.97.40`. For network configuration on client side, use the following steps: [network configuration steps](https://wiki.analog.com/resources/no-os/misc_guides/static_ip_setting?rev=1715173602).
68+
.. note::
4569

46-
NOTE 3: For standard Ethernet connection, the default IP for the device is `192.168.1.110`. Make sure your network environment is configured appropriately to communicate with this IP address.
70+
For T1L connection the default ip for the device is ``192.168.97.40``. For
71+
network configuration on client side, use the following steps: `network
72+
configuration steps
73+
<https://wiki.analog.com/resources/no-os/misc_guides/static_ip_setting?rev=1715173602>`__.
4774

48-
## Build and run
75+
.. note::
4976

50-
The project is based on a [MAX32650](https://www.analog.com/en/products/max32650.html) microcontroller. It can be built and run by running the following script:
77+
For standard Ethernet connection, the default IP for the device is
78+
``192.168.1.110``. Make sure your network environment is configured
79+
appropriately to communicate with this IP address.
5180

52-
```bash
53-
# remove build directory
54-
make reset
55-
# select platform
56-
export PLATFORM=maxim
57-
# select controller type
58-
export TARGET=max32650
59-
# select interface
60-
export INTERFACE=usb
61-
# build and flash the code
62-
make PQLIB_PATH=<path_to_library> run
63-
```
81+
Build and run
82+
-------------
6483

65-
The `iio_info` of the device should look like the following:
84+
The project is based on a :adi:`MAX32650` microcontroller. It can
85+
be built and run by running the following script:
6686

67-
```console
68-
IIO context has 3 attributes:
87+
# remove build directory
88+
make reset
89+
# select platform
90+
export PLATFORM=maxim
91+
# select controller type
92+
export TARGET=max32650
93+
# select interface
94+
export INTERFACE=usb
95+
# build and flash the code
96+
make PQLIB_PATH=<path_to_library> run
97+
98+
The ``iio_info`` of the device should look like the following:
99+
100+
.. code-block:: console
101+
102+
IIO context has 3 attributes:
69103
uri: serial:/dev/ttyACM0,115200,8n1n
70104
serial,port: /dev/ttyACM0
71105
serial,description: MAX32650 CDC-ACM
72-
IIO context has 1 devices:
106+
107+
IIO context has 1 device:
108+
109+
.. code-block:: console
110+
73111
iio:device0: pqm (buffer capable)
74112
11 channels found:
75113
current0: ia (input, index: 1, format: be:U16/16>>0)
@@ -229,4 +267,9 @@ IIO context has 1 devices:
229267
No trigger on this device
230268
231269
232-
```
270+
Additional Resources
271+
---------------------
272+
273+
The complete User Guide for the AD-PQMON-SL solution is available at
274+
`AD-PQMON-SL GitHub Page
275+
<https://analogdevicesinc.github.io/documentation/solutions/reference-designs/ad-pqmon-sl/index.html>`__.

0 commit comments

Comments
 (0)