zephyr/samples/subsys/sip_svc
Benjamin Cabé 0d25e30de6 samples: subsys: use zephyr:code-sample directive
Adds missing code-sample directive to the remaining samples in
`samples/subsys` that didn't use it yet in preparation for upcoming
changes to the Zephyr documentation that will be leveraging the provided
description and metadata.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2024-09-05 17:13:17 -04:00
..
boards
src sample: sip_svc: fix filter and printk formatting 2024-09-04 21:27:37 +02:00
CMakeLists.txt
README.rst samples: subsys: use zephyr:code-sample directive 2024-09-05 17:13:17 -04:00
prj.conf
sample.yaml sample: sip_svc: fix filter and printk formatting 2024-09-04 21:27:37 +02:00

README.rst

.. zephyr:code-sample:: sip_svc
   :name: Arm SiP Services on Intel Agilex SoC FPGA

   Use the SiP SVC subsystem to interact with the Secure Device Manager on Intel Agilex SoC FPGA.

Overview
********

This sample demonstrates the usage of SiP SVC subsystem.This sample
performs a voltage value query from Secure Device Manager in Intel Agilex
SoC FPGA.

Caveats
*******

* SiP SVC subsystem relies on the firmware running in EL3 layer to be in compatible
  with protocol defined inside the SiP SVC subsystem used by the project.
* The sample application relies on the Trusted Firmware ARM firmware in
  intel Agilex SoC FPGA query the voltage levels in Secure Device Manager.

Building and Running
********************
For building the application:

.. zephyr-app-commands::
   :zephyr-app: samples/subsys/sip_svc
   :board: intel_socfpga_agilex_socdk
   :goals: build

For running the application the Zephyr image can be loaded in DDR memory
at address 0x00100000 and ATF BL31 at 0x00001000 from SD Card or QSPI Flash
in ATF BL2.

Sample Output
*************
.. code-block:: console

  *** Booting Zephyr OS build zephyr-v3.3.0-2963-gb5ba49ae300e ***
  Got response of transaction id 0x00 and voltage is 0.846878v
  Got response of transaction id 0x01 and voltage is 0.858170v
  Got response of transaction id 0x02 and voltage is 0.860168v
  Got response of transaction id 0x03 and voltage is 0.846832v
  Got response of transaction id 0x04 and voltage is 0.858337v
  Got response of transaction id 0x05 and voltage is 0.871704v
  Got response of transaction id 0x06 and voltage is 0.859421v
  Got response of transaction id 0x07 and voltage is 0.857254v
  Got response of transaction id 0x08 and voltage is 0.858429v
  Got response of transaction id 0x09 and voltage is 0.859879v
  Got response of transaction id 0x0a and voltage is 0.845139v
  Got response of transaction id 0x0b and voltage is 0.858459v
  Got response of transaction id 0x0c and voltage is 0.859283v
  Got response of transaction id 0x0d and voltage is 0.846207v
  Got response of transaction id 0x0e and voltage is 0.855850v
  Got response of transaction id 0x0f and voltage is 0.859283v
  Got response of transaction id 0x00 and voltage is 0.846832v
  Got response of transaction id 0x01 and voltage is 0.856049v
  Got response of transaction id 0x02 and voltage is 0.859879v