summaryrefslogtreecommitdiff
path: root/doc/usage/cmd/armffa.rst
blob: 13fa90c1290dda0362efed3291dda72b6a1e6ac8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
.. 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.