| Abdellatif El Khlifi | 5ad079f | 2023-08-04 14:33:43 +0100 | [diff] [blame] | 1 | .. SPDX-License-Identifier: GPL-2.0+ |
| 2 | .. Copyright 2022-2023 Arm Limited and/or its affiliates <open-source-office@arm.com> |
| 3 | |
| Heinrich Schuchardt | 1b0c316 | 2024-01-14 14:53:13 +0100 | [diff] [blame] | 4 | .. index:: |
| 5 | single: armffa (command) |
| 6 | |
| Abdellatif El Khlifi | 5ad079f | 2023-08-04 14:33:43 +0100 | [diff] [blame] | 7 | armffa command |
| 8 | ============== |
| 9 | |
| 10 | Synopsis |
| 11 | -------- |
| 12 | |
| 13 | :: |
| 14 | |
| 15 | armffa [sub-command] [arguments] |
| 16 | |
| 17 | sub-commands: |
| 18 | |
| 19 | getpart [partition UUID] |
| 20 | |
| 21 | lists the partition(s) info |
| 22 | |
| 23 | ping [partition ID] |
| 24 | |
| 25 | sends a data pattern to the specified partition |
| 26 | |
| 27 | devlist |
| 28 | |
| 29 | displays information about the FF-A device/driver |
| 30 | |
| 31 | Description |
| 32 | ----------- |
| 33 | |
| 34 | armffa is a command showcasing how to use the FF-A bus and how to invoke its operations. |
| 35 | |
| 36 | This provides a guidance to the client developers on how to call the FF-A bus interfaces. |
| 37 | |
| 38 | The command also allows to gather secure partitions information and ping these partitions. |
| 39 | |
| 40 | The command is also helpful in testing the communication with secure partitions. |
| 41 | |
| 42 | Example |
| 43 | ------- |
| 44 | |
| 45 | The following examples are run on Corstone-1000 platform. |
| 46 | |
| 47 | * ping |
| 48 | |
| 49 | :: |
| 50 | |
| 51 | corstone1000# armffa ping 0x8003 |
| 52 | SP response: |
| 53 | [LSB] |
| 54 | fffffffe |
| 55 | 0 |
| 56 | 0 |
| 57 | 0 |
| 58 | 0 |
| 59 | |
| 60 | * ping (failure case) |
| 61 | |
| 62 | :: |
| 63 | |
| 64 | corstone1000# armffa ping 0 |
| 65 | Sending direct request error (-22) |
| 66 | |
| 67 | * getpart |
| 68 | |
| 69 | :: |
| 70 | |
| 71 | corstone1000# armffa getpart 33d532ed-e699-0942-c09c-a798d9cd722d |
| 72 | Partition: id = 8003 , exec_ctxt 1 , properties 3 |
| 73 | |
| 74 | * getpart (failure case) |
| 75 | |
| 76 | :: |
| 77 | |
| 78 | corstone1000# armffa getpart 33d532ed-e699-0942-c09c-a798d9cd7221 |
| 79 | INVALID_PARAMETERS: Unrecognized UUID |
| 80 | Failure in querying partitions count (error code: -22) |
| 81 | |
| 82 | * devlist |
| 83 | |
| 84 | :: |
| 85 | |
| 86 | corstone1000# armffa devlist |
| 87 | device name arm_ffa, dev 00000000fdf41c30, driver name arm_ffa, ops 00000000fffc0e98 |
| 88 | |
| 89 | Configuration |
| 90 | ------------- |
| 91 | |
| 92 | The command is available if CONFIG_CMD_ARMFFA=y and CONFIG_ARM_FFA_TRANSPORT=y. |
| 93 | |
| 94 | Return value |
| 95 | ------------ |
| 96 | |
| 97 | The return value $? is 0 (true) on success, 1 (false) on failure. |