-
Notifications
You must be signed in to change notification settings - Fork 1.7k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
projects: ltc7841: Add README documentation for project
Add README.rst documentation file for project alongside other documentation related files. Signed-off-by: Marvin Neil Cabuenas <[email protected]>
- Loading branch information
Showing
3 changed files
with
130 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
.. include:: ../../../../projects/ltc7841/README.rst |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,128 @@ | ||
Evaluating the LTC7841 | ||
====================== | ||
|
||
.. contents:: | ||
:depth: 3 | ||
|
||
Supported Evaluation Boards | ||
--------------------------- | ||
|
||
* `DC2798A <https://www.analog.com/en/resources/evaluation-hardware-and-software/evaluation-boards-kits/DC2798A.html>`_ | ||
|
||
Overview | ||
-------- | ||
|
||
The evaluation board includes 2 LTC7841 to be powered up with writing to the MFR_VOUT_COMMAND a non-zero value. | ||
To turn-on the evaluation board, write 0x80 to the OPERATION register and ensure that the MFR_VOUT_COMMAND is actually | ||
non-zero value. | ||
|
||
Full performance details are provided in the LTC7841 data sheet, which should | ||
be consulted in conjunction with user guide. | ||
|
||
Hardware Specifications | ||
----------------------- | ||
|
||
Power Supply Requirements | ||
^^^^^^^^^^^^^^^^^^^^^^^^^ | ||
|
||
For this specific project an external power supply with a variable output of 10-16 Volts | ||
must be used to power up the demo board. | ||
|
||
**Hardware Bringup** | ||
|
||
For reference, follow the Quick Start Procedure section of the corresponding | ||
demo board. | ||
`user guide <https://www.analog.com/media/en/technical-documentation/user-guides/dc2798a.pdf>`_. | ||
|
||
No-OS Build Setup | ||
----------------- | ||
|
||
Please see: https://wiki.analog.com/resources/no-os/build | ||
|
||
No-OS Supported Examples | ||
------------------------ | ||
|
||
The initialization data used in the examples is taken out from: | ||
`Project Common Data Path <https://github.com/analogdevicesinc/no-OS/tree/main/projects/ltc7841/src/common>`_ | ||
|
||
The macros used in Common Data are defined in platform specific files found in: | ||
`Project Platform Configuration Path <https://github.com/analogdevicesinc/no-OS/tree/main/projects/ltc7841/src/platform>`_ | ||
|
||
Basic example | ||
^^^^^^^^^^^^^ | ||
|
||
This is a simple example that initializes the LTC7841, and performs telemetry | ||
readings of the voltage, current and temperature of each output channel. Status | ||
bytes/words are also monitored in the example. | ||
|
||
In order to build the basic example make sure you have the following configuration in the Makefile | ||
`Makefile <https://github.com/analogdevicesinc/no-OS/tree/main/projects/ltc7841/Makefile>`_ | ||
|
||
.. code-block:: bash | ||
# Select the example you want to enable by choosing y for enabling and n for disabling | ||
BASIC_EXAMPLE = y | ||
IIO_EXAMPLE = n | ||
IIO example | ||
^^^^^^^^^^^ | ||
|
||
This project is actually a IIOD demo for DC2798-A evaluation board. | ||
The project launches a IIOD server on the board so that the user may connect | ||
to it via an IIO client. | ||
|
||
If you are not familiar with ADI IIO Application, please take a look at: | ||
`IIO No-OS <https://wiki.analog.com/resources/tools-software/no-os-software/iio>`_ | ||
|
||
If you are not familiar with ADI IIO-Oscilloscope Client, please take a look at: | ||
`IIO Oscilloscope <https://wiki.analog.com/resources/tools-software/linux-software/iio_oscilloscope>`_ | ||
|
||
The No-OS IIO Application together with the No-OS IIO LTC2798 driver take care of | ||
all the back-end logic needed to setup the IIO server. | ||
|
||
This example initializes the IIO device and calls the IIO app as shown in: | ||
`IIO Example <https://github.com/analogdevicesinc/no-OS/tree/main/projects/ltc2798/src/examples/iio_example>`_ | ||
|
||
In order to build the IIO project make sure you have the following configuration in the | ||
`Makefile <https://github.com/analogdevicesinc/no-OS/tree/main/projects/ltc7841/Makefile>`_ | ||
|
||
.. code-block:: bash | ||
# Select the example you want to enable by choosing y for enabling and n for disabling | ||
BASIC_EXAMPLE = n | ||
IIO__EXAMPLE = y | ||
No-OS Supported Platforms | ||
------------------------- | ||
|
||
Maxim Platform | ||
^^^^^^^^^^^^^^ | ||
|
||
**Used hardware** | ||
|
||
* `DC2798A <https://www.analog.com/en/resources/evaluation-hardware-and-software/evaluation-boards-kits/DC2798A.html>`_ | ||
* `MAX3290EVKit <https://www.analog.com/en/resources/evaluation-hardware-and-software/evaluation-boards-kits/max32690evkit.html>`_ | ||
|
||
**Connections**: | ||
|
||
+---------------------+---------------------+-----------------------------+ | ||
| Max42500 test point | Function | MAX32690 EVKIT Pin Number | | ||
+=====================+=====================+=============================+ | ||
| GND (J31) | Ground | GND | | ||
+---------------------+---------------------+-----------------------------+ | ||
| SDA | Serial Data Line | P2_7 | | ||
+---------------------+---------------------+-----------------------------+ | ||
| SCL | Serial Clock Line | P2_8 | | ||
+---------------------+---------------------+-----------------------------+ | ||
|
||
|
||
**Build Command** | ||
|
||
.. code-block:: bash | ||
# to delete current build | ||
make reset | ||
# to build the project | ||
make PLATFORM=maxim TARGET=max32690 | ||
# to flash the code | ||
make run |