On Fri, 16 Jun 2023 at 16:28, Abdellatif El Khlifi abdellatif.elkhlifi@arm.com wrote:

Provide armffa command showcasing the use of the U-Boot FF-A support

armffa is a command showcasing how to invoke FF-A 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.

For more details please refer to the command documentation [1].

Signed-off-by: Abdellatif El Khlifi abdellatif.elkhlifi@arm.com Reviewed-by: Simon Glass sjg@chromium.org Cc: Tom Rini trini@konsulko.com Cc: Simon Glass sjg@chromium.org Cc: Ilias Apalodimas ilias.apalodimas@linaro.org Cc: Jens Wiklander jens.wiklander@linaro.org Cc: Heinrich Schuchardt xypron.glpk@gmx.de

---

Changelog:

v12:

• add subcommands argument checks
• usage documentation: update command return codes
• remove calloc when querying SPs
• address nits

v11:

• use U_BOOT_CMD_WITH_SUBCMDS
• address nits

v10:

• use the FF-A driver Uclass operations
• use uclass_first_device()
• address nits

v9:

• remove manual FF-A discovery and use DM
• use DM class APIs to probe and interact with the FF-A bus
• add doc/usage/cmd/armffa.rst

v8:

• update partition_info_get() second argument to be an SP count
• pass NULL device pointer to the FF-A bus discovery and operations

v7:

• adapt do_ffa_dev_list() following the recent update on uclass_first_device/uclass_next_device functions (they return void now)
• set armffa command to use 64-bit direct messaging

v4:

• remove pattern data in do_ffa_msg_send_direct_req

v3:

• use the new driver interfaces (partition_info_get, sync_send_receive) in armffa command

v2:

• replace use of ffa_helper_init_device function by

ffa_helper_bus_discover

v1:

• introduce armffa command

MAINTAINERS | 2 + cmd/Kconfig | 10 ++ cmd/Makefile | 1 + cmd/armffa.c | 196 +++++++++++++++++++++++++++++++ doc/arch/arm64.ffa.rst | 7 ++ doc/usage/cmd/armffa.rst | 93 +++++++++++++++ doc/usage/index.rst | 1 + drivers/firmware/arm-ffa/Kconfig | 1 + 8 files changed, 311 insertions(+) create mode 100644 cmd/armffa.c create mode 100644 doc/usage/cmd/armffa.rst

Reviewed-by: Simon Glass sjg@chromium.org