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.