u-boot/doc/usage/cmd/armffa.rst
Heinrich Schuchardt 60971e63e6 doc: create index entries for commands
Add the description of CLI commands to the generated index.

Signed-off-by: Heinrich Schuchardt <heinrich.schuchardt@canonical.com>
2024-01-17 08:40:19 +01:00

97 lines
1.8 KiB
ReStructuredText

.. SPDX-License-Identifier: GPL-2.0+
.. Copyright 2022-2023 Arm Limited and/or its affiliates <open-source-office@arm.com>
.. index::
single: armffa (command)
armffa command
==============
Synopsis
--------
::
armffa [sub-command] [arguments]
sub-commands:
getpart [partition UUID]
lists the partition(s) info
ping [partition ID]
sends a data pattern to the specified partition
devlist
displays information about the FF-A device/driver
Description
-----------
armffa is a command showcasing how to use the FF-A bus and how to invoke its operations.
This provides a guidance to the client developers on how to call the FF-A bus interfaces.
The command also allows to gather secure partitions information and ping these partitions.
The command is also helpful in testing the communication with secure partitions.
Example
-------
The following examples are run on Corstone-1000 platform.
* ping
::
corstone1000# armffa ping 0x8003
SP response:
[LSB]
fffffffe
0
0
0
0
* ping (failure case)
::
corstone1000# armffa ping 0
Sending direct request error (-22)
* getpart
::
corstone1000# armffa getpart 33d532ed-e699-0942-c09c-a798d9cd722d
Partition: id = 8003 , exec_ctxt 1 , properties 3
* getpart (failure case)
::
corstone1000# armffa getpart 33d532ed-e699-0942-c09c-a798d9cd7221
INVALID_PARAMETERS: Unrecognized UUID
Failure in querying partitions count (error code: -22)
* devlist
::
corstone1000# armffa devlist
device name arm_ffa, dev 00000000fdf41c30, driver name arm_ffa, ops 00000000fffc0e98
Configuration
-------------
The command is available if CONFIG_CMD_ARMFFA=y and CONFIG_ARM_FFA_TRANSPORT=y.
Return value
------------
The return value $? is 0 (true) on success, 1 (false) on failure.