xref: /linux/drivers/firmware/arm_scmi/Kconfig (revision 2c4b97fee94acd4a4eb2a6943584055a14e14830)
1e8419c24SCristian Marussi# SPDX-License-Identifier: GPL-2.0-only
2e8419c24SCristian Marussimenu "ARM System Control and Management Interface Protocol"
3e8419c24SCristian Marussi
4e8419c24SCristian Marussiconfig ARM_SCMI_PROTOCOL
5e8419c24SCristian Marussi	tristate "ARM System Control and Management Interface (SCMI) Message Protocol"
6e8419c24SCristian Marussi	depends on ARM || ARM64 || COMPILE_TEST
7e8419c24SCristian Marussi	help
8e8419c24SCristian Marussi	  ARM System Control and Management Interface (SCMI) protocol is a
9e8419c24SCristian Marussi	  set of operating system-independent software interfaces that are
10e8419c24SCristian Marussi	  used in system management. SCMI is extensible and currently provides
11e8419c24SCristian Marussi	  interfaces for: Discovery and self-description of the interfaces
12e8419c24SCristian Marussi	  it supports, Power domain management which is the ability to place
13e8419c24SCristian Marussi	  a given device or domain into the various power-saving states that
14e8419c24SCristian Marussi	  it supports, Performance management which is the ability to control
15e8419c24SCristian Marussi	  the performance of a domain that is composed of compute engines
16e8419c24SCristian Marussi	  such as application processors and other accelerators, Clock
17e8419c24SCristian Marussi	  management which is the ability to set and inquire rates on platform
18e8419c24SCristian Marussi	  managed clocks and Sensor management which is the ability to read
19e8419c24SCristian Marussi	  sensor data, and be notified of sensor value.
20e8419c24SCristian Marussi
21e8419c24SCristian Marussi	  This protocol library provides interface for all the client drivers
22e8419c24SCristian Marussi	  making use of the features offered by the SCMI.
23e8419c24SCristian Marussi
24e8419c24SCristian Marussiif ARM_SCMI_PROTOCOL
25e8419c24SCristian Marussi
26e8419c24SCristian Marussiconfig ARM_SCMI_HAVE_TRANSPORT
27e8419c24SCristian Marussi	bool
28e8419c24SCristian Marussi	help
29e8419c24SCristian Marussi	  This declares whether at least one SCMI transport has been configured.
30e8419c24SCristian Marussi	  Used to trigger a build bug when trying to build SCMI without any
31e8419c24SCristian Marussi	  configured transport.
32e8419c24SCristian Marussi
33a7b1138bSIgor Skalkinconfig ARM_SCMI_HAVE_SHMEM
34a7b1138bSIgor Skalkin	bool
35a7b1138bSIgor Skalkin	help
36a7b1138bSIgor Skalkin	  This declares whether a shared memory based transport for SCMI is
37a7b1138bSIgor Skalkin	  available.
38a7b1138bSIgor Skalkin
39f301bba0SPeter Hilberconfig ARM_SCMI_HAVE_MSG
40f301bba0SPeter Hilber	bool
41f301bba0SPeter Hilber	help
42f301bba0SPeter Hilber	  This declares whether a message passing based transport for SCMI is
43f301bba0SPeter Hilber	  available.
44f301bba0SPeter Hilber
45e8419c24SCristian Marussiconfig ARM_SCMI_TRANSPORT_MAILBOX
46e8419c24SCristian Marussi	bool "SCMI transport based on Mailbox"
47e8419c24SCristian Marussi	depends on MAILBOX
48e8419c24SCristian Marussi	select ARM_SCMI_HAVE_TRANSPORT
49a7b1138bSIgor Skalkin	select ARM_SCMI_HAVE_SHMEM
50e8419c24SCristian Marussi	default y
51e8419c24SCristian Marussi	help
52e8419c24SCristian Marussi	  Enable mailbox based transport for SCMI.
53e8419c24SCristian Marussi
54e8419c24SCristian Marussi	  If you want the ARM SCMI PROTOCOL stack to include support for a
55e8419c24SCristian Marussi	  transport based on mailboxes, answer Y.
56e8419c24SCristian Marussi
575f90f189SEtienne Carriereconfig ARM_SCMI_TRANSPORT_OPTEE
585f90f189SEtienne Carriere	bool "SCMI transport based on OP-TEE service"
595f90f189SEtienne Carriere	depends on OPTEE=y || OPTEE=ARM_SCMI_PROTOCOL
605f90f189SEtienne Carriere	select ARM_SCMI_HAVE_TRANSPORT
615f90f189SEtienne Carriere	select ARM_SCMI_HAVE_SHMEM
625e114ad9SEtienne Carriere	select ARM_SCMI_HAVE_MSG
635f90f189SEtienne Carriere	default y
645f90f189SEtienne Carriere	help
655f90f189SEtienne Carriere	  This enables the OP-TEE service based transport for SCMI.
665f90f189SEtienne Carriere
675f90f189SEtienne Carriere	  If you want the ARM SCMI PROTOCOL stack to include support for a
685f90f189SEtienne Carriere	  transport based on OP-TEE SCMI service, answer Y.
695f90f189SEtienne Carriere
70e8419c24SCristian Marussiconfig ARM_SCMI_TRANSPORT_SMC
71e8419c24SCristian Marussi	bool "SCMI transport based on SMC"
72e8419c24SCristian Marussi	depends on HAVE_ARM_SMCCC_DISCOVERY
73e8419c24SCristian Marussi	select ARM_SCMI_HAVE_TRANSPORT
74a7b1138bSIgor Skalkin	select ARM_SCMI_HAVE_SHMEM
75e8419c24SCristian Marussi	default y
76e8419c24SCristian Marussi	help
77e8419c24SCristian Marussi	  Enable SMC based transport for SCMI.
78e8419c24SCristian Marussi
79e8419c24SCristian Marussi	  If you want the ARM SCMI PROTOCOL stack to include support for a
80e8419c24SCristian Marussi	  transport based on SMC, answer Y.
81e8419c24SCristian Marussi
820bfdca8aSCristian Marussiconfig ARM_SCMI_TRANSPORT_SMC_ATOMIC_ENABLE
830bfdca8aSCristian Marussi	bool "Enable atomic mode support for SCMI SMC transport"
840bfdca8aSCristian Marussi	depends on ARM_SCMI_TRANSPORT_SMC
850bfdca8aSCristian Marussi	help
860bfdca8aSCristian Marussi	  Enable support of atomic operation for SCMI SMC based transport.
870bfdca8aSCristian Marussi
880bfdca8aSCristian Marussi	  If you want the SCMI SMC based transport to operate in atomic
890bfdca8aSCristian Marussi	  mode, avoiding any kind of sleeping behaviour for selected
900bfdca8aSCristian Marussi	  transactions on the TX path, answer Y.
910bfdca8aSCristian Marussi	  Enabling atomic mode operations allows any SCMI driver using this
920bfdca8aSCristian Marussi	  transport to optionally ask for atomic SCMI transactions and operate
930bfdca8aSCristian Marussi	  in atomic context too, at the price of using a number of busy-waiting
940bfdca8aSCristian Marussi	  primitives all over instead. If unsure say N.
950bfdca8aSCristian Marussi
9646abe13bSIgor Skalkinconfig ARM_SCMI_TRANSPORT_VIRTIO
9746abe13bSIgor Skalkin	bool "SCMI transport based on VirtIO"
98c90521a0SCristian Marussi	depends on VIRTIO=y || VIRTIO=ARM_SCMI_PROTOCOL
9946abe13bSIgor Skalkin	select ARM_SCMI_HAVE_TRANSPORT
10046abe13bSIgor Skalkin	select ARM_SCMI_HAVE_MSG
10146abe13bSIgor Skalkin	help
10246abe13bSIgor Skalkin	  This enables the virtio based transport for SCMI.
10346abe13bSIgor Skalkin
10446abe13bSIgor Skalkin	  If you want the ARM SCMI PROTOCOL stack to include support for a
10546abe13bSIgor Skalkin	  transport based on VirtIO, answer Y.
10646abe13bSIgor Skalkin
107530897ecSCristian Marussiconfig ARM_SCMI_TRANSPORT_VIRTIO_VERSION1_COMPLIANCE
108530897ecSCristian Marussi	bool "SCMI VirtIO transport Version 1 compliance"
109530897ecSCristian Marussi	depends on ARM_SCMI_TRANSPORT_VIRTIO
110530897ecSCristian Marussi	default y
111530897ecSCristian Marussi	help
112530897ecSCristian Marussi	  This enforces strict compliance with VirtIO Version 1 specification.
113530897ecSCristian Marussi
114530897ecSCristian Marussi	  If you want the ARM SCMI VirtIO transport layer to refuse to work
115530897ecSCristian Marussi	  with Legacy VirtIO backends and instead support only VirtIO Version 1
116530897ecSCristian Marussi	  devices (or above), answer Y.
117530897ecSCristian Marussi
118530897ecSCristian Marussi	  If you want instead to support also old Legacy VirtIO backends (like
119530897ecSCristian Marussi	  the ones implemented by kvmtool) and let the core Kernel VirtIO layer
120530897ecSCristian Marussi	  take care of the needed conversions, say N.
121530897ecSCristian Marussi
1225a3b7185SCristian Marussiconfig ARM_SCMI_TRANSPORT_VIRTIO_ATOMIC_ENABLE
1235a3b7185SCristian Marussi	bool "Enable atomic mode for SCMI VirtIO transport"
1245a3b7185SCristian Marussi	depends on ARM_SCMI_TRANSPORT_VIRTIO
1255a3b7185SCristian Marussi	help
1265a3b7185SCristian Marussi	  Enable support of atomic operation for SCMI VirtIO based transport.
1275a3b7185SCristian Marussi
1285a3b7185SCristian Marussi	  If you want the SCMI VirtIO based transport to operate in atomic
1295a3b7185SCristian Marussi	  mode, avoiding any kind of sleeping behaviour for selected
1305a3b7185SCristian Marussi	  transactions on the TX path, answer Y.
1315a3b7185SCristian Marussi
1325a3b7185SCristian Marussi	  Enabling atomic mode operations allows any SCMI driver using this
1335a3b7185SCristian Marussi	  transport to optionally ask for atomic SCMI transactions and operate
1345a3b7185SCristian Marussi	  in atomic context too, at the price of using a number of busy-waiting
1355a3b7185SCristian Marussi	  primitives all over instead. If unsure say N.
1365a3b7185SCristian Marussi
137e8419c24SCristian Marussiendif #ARM_SCMI_PROTOCOL
138e8419c24SCristian Marussi
139e8419c24SCristian Marussiconfig ARM_SCMI_POWER_DOMAIN
140e8419c24SCristian Marussi	tristate "SCMI power domain driver"
141e8419c24SCristian Marussi	depends on ARM_SCMI_PROTOCOL || (COMPILE_TEST && OF)
142e8419c24SCristian Marussi	default y
143e8419c24SCristian Marussi	select PM_GENERIC_DOMAINS if PM
144e8419c24SCristian Marussi	help
145e8419c24SCristian Marussi	  This enables support for the SCMI power domains which can be
146e8419c24SCristian Marussi	  enabled or disabled via the SCP firmware
147e8419c24SCristian Marussi
148e8419c24SCristian Marussi	  This driver can also be built as a module.  If so, the module
149e8419c24SCristian Marussi	  will be called scmi_pm_domain. Note this may needed early in boot
150e8419c24SCristian Marussi	  before rootfs may be available.
151e8419c24SCristian Marussi
152*2c4b97feSCristian Marussiconfig ARM_SCMI_POWER_CONTROL
153*2c4b97feSCristian Marussi	tristate "SCMI system power control driver"
154*2c4b97feSCristian Marussi	depends on ARM_SCMI_PROTOCOL || (COMPILE_TEST && OF)
155*2c4b97feSCristian Marussi	help
156*2c4b97feSCristian Marussi	  This enables System Power control logic which binds system shutdown or
157*2c4b97feSCristian Marussi	  reboot actions to SCMI System Power notifications generated by SCP
158*2c4b97feSCristian Marussi	  firmware.
159*2c4b97feSCristian Marussi
160*2c4b97feSCristian Marussi	  This driver can also be built as a module.  If so, the module will be
161*2c4b97feSCristian Marussi	  called scmi_power_control. Note this may needed early in boot to catch
162*2c4b97feSCristian Marussi	  early shutdown/reboot SCMI requests.
163*2c4b97feSCristian Marussi
164e8419c24SCristian Marussiendmenu
165