mirror of
https://github.com/AsahiLinux/u-boot
synced 2024-12-21 02:33:07 +00:00
95 lines
1.8 KiB
ReStructuredText
95 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>
|
||
|
|
|
||
|
|
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.
|