* [PATCH 1/1] ArmPkg/Include: Add standard SMC and SVC function IDs for MM interface.
@ 2017-09-22 19:25 Supreeth Venkatesh
2017-09-22 21:45 ` Achin Gupta
0 siblings, 1 reply; 4+ messages in thread
From: Supreeth Venkatesh @ 2017-09-22 19:25 UTC (permalink / raw)
To: edk2-devel; +Cc: leif.lindholm, ard.biesheuvel, Supreeth Venkatesh, Achin Gupta
This patch adds a list of function IDs that fall under the standard
SMC range as defined in
http://infocenter.arm.com/help/topic/com.arm.doc.den0060a/DEN0060A_ARM_MM_Interface_Specification.pdf.
SMCs associated with Management Mode are in the range 0xC4000040 -
0xC400005f (64 bit) and 0x84000040 - 0x8400005f (32 bit).
The function(s) available to the normal world:
1. Request services from the secure MM environment using MM_COMMUNICATE.
SVCs are in the range 0xC4000060 - 0xC400007f.
The functions available to the secure MM partition:
1. Signal completion of MM event handling.
2. Set/Get memory attributes for a memory region at runtime.
3. Get version number of secure partition manager.
Also, it defines memory attributes and MM return codes.
Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Achin Gupta <achin.gupta@arm.com>
Signed-off-by: Supreeth Venkatesh <supreeth.venkatesh@arm.com>
---
ArmPkg/Include/IndustryStandard/ArmStdSmc.h | 46 ++++++++++++++++++++++++++++-
1 file changed, 45 insertions(+), 1 deletion(-)
diff --git a/ArmPkg/Include/IndustryStandard/ArmStdSmc.h b/ArmPkg/Include/IndustryStandard/ArmStdSmc.h
index 593a3ce729..a625bc2048 100644
--- a/ArmPkg/Include/IndustryStandard/ArmStdSmc.h
+++ b/ArmPkg/Include/IndustryStandard/ArmStdSmc.h
@@ -1,6 +1,6 @@
/** @file
*
-* Copyright (c) 2012-2014, ARM Limited. All rights reserved.
+* Copyright (c) 2012-2017, ARM Limited. All rights reserved.
*
* This program and the accompanying materials
* are licensed and made available under the terms and conditions of the BSD License
@@ -40,6 +40,50 @@
#define ARM_SMC_STD_REVISION_MAJOR 0x0
#define ARM_SMC_STD_REVISION_MINOR 0x1
+
+/*
+ * Management Mode (MM) calls cover a subset of the Standard Service Call range.
+ * The list below is not exhaustive.
+ */
+#define ARM_SMC_ID_MM_VERSION_AARCH32 0x84000040
+#define ARM_SMC_ID_MM_VERSION_AARCH64 0xC4000040
+
+// Request service from secure standalone MM environment
+#define ARM_SMC_ID_MM_COMMUNICATE_AARCH32 0x84000041
+#define ARM_SMC_ID_MM_COMMUNICATE_AARCH64 0xC4000041
+
+/*
+ * SVC IDs to allow the MM secure partition to initialise itself, handle
+ * delegated events and request the Secure partition manager to perform
+ * privileged operations on its behalf.
+ */
+#define ARM_SVC_ID_SPM_VERSION_AARCH64 0xC4000060
+#define ARM_SVC_ID_SP_EVENT_COMPLETE_AARCH64 0xC4000061
+#define ARM_SVC_ID_SP_GET_MEM_ATTRIBUTES_AARCH64 0xC4000064
+#define ARM_SVC_ID_SP_SET_MEM_ATTRIBUTES_AARCH64 0xC4000065
+
+#define SET_MEM_ATTR_DATA_PERM_MASK 0x3
+#define SET_MEM_ATTR_DATA_PERM_SHIFT 0
+#define SET_MEM_ATTR_DATA_PERM_NO_ACCESS 0
+#define SET_MEM_ATTR_DATA_PERM_RW 1
+#define SET_MEM_ATTR_DATA_PERM_RO 3
+
+#define SET_MEM_ATTR_CODE_PERM_MASK 0x1
+#define SET_MEM_ATTR_CODE_PERM_SHIFT 2
+#define SET_MEM_ATTR_CODE_PERM_X 0
+#define SET_MEM_ATTR_CODE_PERM_XN 1
+
+#define SET_MEM_ATTR_MAKE_PERM_REQUEST(d_perm, c_perm) \
+ ((((c_perm) & SET_MEM_ATTR_CODE_PERM_MASK) << SET_MEM_ATTR_CODE_PERM_SHIFT) | \
+ (( (d_perm) & SET_MEM_ATTR_DATA_PERM_MASK) << SET_MEM_ATTR_DATA_PERM_SHIFT))
+
+/* MM return error codes */
+#define ARM_SMC_MM_RET_SUCCESS 0
+#define ARM_SMC_MM_RET_NOT_SUPPORTED -1
+#define ARM_SMC_MM_RET_INVALID_PARAMS -2
+#define ARM_SMC_MM_RET_DENIED -3
+#define ARM_SMC_MM_RET_NO_MEMORY -4
+
/*
* Power State Coordination Interface (PSCI) calls cover a subset of the
* Standard Service Call range.
--
2.14.1
^ permalink raw reply related [flat|nested] 4+ messages in thread
* Re: [PATCH 1/1] ArmPkg/Include: Add standard SMC and SVC function IDs for MM interface.
2017-09-22 19:25 [PATCH 1/1] ArmPkg/Include: Add standard SMC and SVC function IDs for MM interface Supreeth Venkatesh
@ 2017-09-22 21:45 ` Achin Gupta
2017-09-22 22:12 ` Supreeth Venkatesh
0 siblings, 1 reply; 4+ messages in thread
From: Achin Gupta @ 2017-09-22 21:45 UTC (permalink / raw)
To: Supreeth Venkatesh; +Cc: edk2-devel, leif.lindholm, ard.biesheuvel, nd
Hi Supreeth,
On Fri, Sep 22, 2017 at 08:25:39PM +0100, Supreeth Venkatesh wrote:
> This patch adds a list of function IDs that fall under the standard
> SMC range as defined in
> http://infocenter.arm.com/help/topic/com.arm.doc.den0060a/DEN0060A_ARM_MM_Interface_Specification.pdf.
>
> SMCs associated with Management Mode are in the range 0xC4000040 -
> 0xC400005f (64 bit) and 0x84000040 - 0x8400005f (32 bit).
>
> The function(s) available to the normal world:
> 1. Request services from the secure MM environment using MM_COMMUNICATE.
>
> SVCs are in the range 0xC4000060 - 0xC400007f.
> The functions available to the secure MM partition:
> 1. Signal completion of MM event handling.
> 2. Set/Get memory attributes for a memory region at runtime.
> 3. Get version number of secure partition manager.
>
> Also, it defines memory attributes and MM return codes.
The SVCs in the 0xC4000060 - 0xC400007f range are not a part of the MM interface
specification. At the moment, these are used to implement an interface between
ARM TF in EL3 and S-EL0. These should go into a separate patch that introduces
them as an ARM TF ABI.
cheers,
Achin
>
> Contributed-under: TianoCore Contribution Agreement 1.1
> Signed-off-by: Achin Gupta <achin.gupta@arm.com>
> Signed-off-by: Supreeth Venkatesh <supreeth.venkatesh@arm.com>
> ---
> ArmPkg/Include/IndustryStandard/ArmStdSmc.h | 46 ++++++++++++++++++++++++++++-
> 1 file changed, 45 insertions(+), 1 deletion(-)
>
> diff --git a/ArmPkg/Include/IndustryStandard/ArmStdSmc.h b/ArmPkg/Include/IndustryStandard/ArmStdSmc.h
> index 593a3ce729..a625bc2048 100644
> --- a/ArmPkg/Include/IndustryStandard/ArmStdSmc.h
> +++ b/ArmPkg/Include/IndustryStandard/ArmStdSmc.h
> @@ -1,6 +1,6 @@
> /** @file
> *
> -* Copyright (c) 2012-2014, ARM Limited. All rights reserved.
> +* Copyright (c) 2012-2017, ARM Limited. All rights reserved.
> *
> * This program and the accompanying materials
> * are licensed and made available under the terms and conditions of the BSD License
> @@ -40,6 +40,50 @@
> #define ARM_SMC_STD_REVISION_MAJOR 0x0
> #define ARM_SMC_STD_REVISION_MINOR 0x1
>
> +
> +/*
> + * Management Mode (MM) calls cover a subset of the Standard Service Call range.
> + * The list below is not exhaustive.
> + */
> +#define ARM_SMC_ID_MM_VERSION_AARCH32 0x84000040
> +#define ARM_SMC_ID_MM_VERSION_AARCH64 0xC4000040
> +
> +// Request service from secure standalone MM environment
> +#define ARM_SMC_ID_MM_COMMUNICATE_AARCH32 0x84000041
> +#define ARM_SMC_ID_MM_COMMUNICATE_AARCH64 0xC4000041
> +
> +/*
> + * SVC IDs to allow the MM secure partition to initialise itself, handle
> + * delegated events and request the Secure partition manager to perform
> + * privileged operations on its behalf.
> + */
> +#define ARM_SVC_ID_SPM_VERSION_AARCH64 0xC4000060
> +#define ARM_SVC_ID_SP_EVENT_COMPLETE_AARCH64 0xC4000061
> +#define ARM_SVC_ID_SP_GET_MEM_ATTRIBUTES_AARCH64 0xC4000064
> +#define ARM_SVC_ID_SP_SET_MEM_ATTRIBUTES_AARCH64 0xC4000065
> +
> +#define SET_MEM_ATTR_DATA_PERM_MASK 0x3
> +#define SET_MEM_ATTR_DATA_PERM_SHIFT 0
> +#define SET_MEM_ATTR_DATA_PERM_NO_ACCESS 0
> +#define SET_MEM_ATTR_DATA_PERM_RW 1
> +#define SET_MEM_ATTR_DATA_PERM_RO 3
> +
> +#define SET_MEM_ATTR_CODE_PERM_MASK 0x1
> +#define SET_MEM_ATTR_CODE_PERM_SHIFT 2
> +#define SET_MEM_ATTR_CODE_PERM_X 0
> +#define SET_MEM_ATTR_CODE_PERM_XN 1
> +
> +#define SET_MEM_ATTR_MAKE_PERM_REQUEST(d_perm, c_perm) \
> + ((((c_perm) & SET_MEM_ATTR_CODE_PERM_MASK) << SET_MEM_ATTR_CODE_PERM_SHIFT) | \
> + (( (d_perm) & SET_MEM_ATTR_DATA_PERM_MASK) << SET_MEM_ATTR_DATA_PERM_SHIFT))
> +
> +/* MM return error codes */
> +#define ARM_SMC_MM_RET_SUCCESS 0
> +#define ARM_SMC_MM_RET_NOT_SUPPORTED -1
> +#define ARM_SMC_MM_RET_INVALID_PARAMS -2
> +#define ARM_SMC_MM_RET_DENIED -3
> +#define ARM_SMC_MM_RET_NO_MEMORY -4
> +
> /*
> * Power State Coordination Interface (PSCI) calls cover a subset of the
> * Standard Service Call range.
> --
> 2.14.1
>
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [PATCH 1/1] ArmPkg/Include: Add standard SMC and SVC function IDs for MM interface.
2017-09-22 21:45 ` Achin Gupta
@ 2017-09-22 22:12 ` Supreeth Venkatesh
2017-09-22 22:15 ` Ard Biesheuvel
0 siblings, 1 reply; 4+ messages in thread
From: Supreeth Venkatesh @ 2017-09-22 22:12 UTC (permalink / raw)
To: Achin Gupta; +Cc: edk2-devel, leif.lindholm, ard.biesheuvel, nd
On Fri, 2017-09-22 at 22:45 +0100, Achin Gupta wrote:
> Hi Supreeth,
>
> On Fri, Sep 22, 2017 at 08:25:39PM +0100, Supreeth Venkatesh wrote:
> >
> > This patch adds a list of function IDs that fall under the standard
> > SMC range as defined in
> > http://infocenter.arm.com/help/topic/com.arm.doc.den0060a/DEN0060A_
> > ARM_MM_Interface_Specification.pdf.
> >
> > SMCs associated with Management Mode are in the range 0xC4000040 -
> > 0xC400005f (64 bit) and 0x84000040 - 0x8400005f (32 bit).
> >
> > The function(s) available to the normal world:
> > 1. Request services from the secure MM environment using
> > MM_COMMUNICATE.
> >
> > SVCs are in the range 0xC4000060 - 0xC400007f.
> > The functions available to the secure MM partition:
> > 1. Signal completion of MM event handling.
> > 2. Set/Get memory attributes for a memory region at runtime.
> > 3. Get version number of secure partition manager.
> >
> > Also, it defines memory attributes and MM return codes.
> The SVCs in the 0xC4000060 - 0xC400007f range are not a part of the
> MM interface
> specification. At the moment, these are used to implement an
> interface between
> ARM TF in EL3 and S-EL0. These should go into a separate patch that
> introduces
> them as an ARM TF ABI.
>
> cheers,
> Achin
Thanks for taking a look at it. This was added in ArmStdSmc.h
deliberately to request comments/feedback. I don't think SVC defines
belong in this file at all. It should have its own header file.
Since it is specific to MM (S-EL0) - EL3 communication, I am tempted to
create a new header file named "ArmMmSvc.h" and put in
ArmPkg/Include/IndustryStandard folder.
Comments - Maintainers/Anyone?
>
> >
> >
> > Contributed-under: TianoCore Contribution Agreement 1.1
> > Signed-off-by: Achin Gupta <achin.gupta@arm.com>
> > Signed-off-by: Supreeth Venkatesh <supreeth.venkatesh@arm.com>
> > ---
> > ArmPkg/Include/IndustryStandard/ArmStdSmc.h | 46
> > ++++++++++++++++++++++++++++-
> > 1 file changed, 45 insertions(+), 1 deletion(-)
> >
> > diff --git a/ArmPkg/Include/IndustryStandard/ArmStdSmc.h
> > b/ArmPkg/Include/IndustryStandard/ArmStdSmc.h
> > index 593a3ce729..a625bc2048 100644
> > --- a/ArmPkg/Include/IndustryStandard/ArmStdSmc.h
> > +++ b/ArmPkg/Include/IndustryStandard/ArmStdSmc.h
> > @@ -1,6 +1,6 @@
> > /** @file
> > *
> > -* Copyright (c) 2012-2014, ARM Limited. All rights reserved.
> > +* Copyright (c) 2012-2017, ARM Limited. All rights reserved.
> > *
> > * This program and the accompanying materials
> > * are licensed and made available under the terms and conditions
> > of the BSD License
> > @@ -40,6 +40,50 @@
> > #define ARM_SMC_STD_REVISION_MAJOR 0x0
> > #define ARM_SMC_STD_REVISION_MINOR 0x1
> >
> > +
> > +/*
> > + * Management Mode (MM) calls cover a subset of the Standard
> > Service Call range.
> > + * The list below is not exhaustive.
> > + */
> > +#define ARM_SMC_ID_MM_VERSION_AARCH32 0x84000040
> > +#define ARM_SMC_ID_MM_VERSION_AARCH64 0xC4000040
> > +
> > +// Request service from secure standalone MM environment
> > +#define ARM_SMC_ID_MM_COMMUNICATE_AARCH32 0x84000041
> > +#define ARM_SMC_ID_MM_COMMUNICATE_AARCH64 0xC4000041
> > +
> > +/*
> > + * SVC IDs to allow the MM secure partition to initialise itself,
> > handle
> > + * delegated events and request the Secure partition manager to
> > perform
> > + * privileged operations on its behalf.
> > + */
> > +#define ARM_SVC_ID_SPM_VERSION_AARCH64 0xC4000060
> > +#define ARM_SVC_ID_SP_EVENT_COMPLETE_AARCH64 0xC4000061
> > +#define ARM_SVC_ID_SP_GET_MEM_ATTRIBUTES_AARCH64 0xC4000064
> > +#define ARM_SVC_ID_SP_SET_MEM_ATTRIBUTES_AARCH64 0xC4000065
> > +
> > +#define SET_MEM_ATTR_DATA_PERM_MASK 0x3
> > +#define SET_MEM_ATTR_DATA_PERM_SHIFT 0
> > +#define SET_MEM_ATTR_DATA_PERM_NO_ACCESS 0
> > +#define SET_MEM_ATTR_DATA_PERM_RW 1
> > +#define SET_MEM_ATTR_DATA_PERM_RO 3
> > +
> > +#define SET_MEM_ATTR_CODE_PERM_MASK 0x1
> > +#define SET_MEM_ATTR_CODE_PERM_SHIFT 2
> > +#define SET_MEM_ATTR_CODE_PERM_X 0
> > +#define SET_MEM_ATTR_CODE_PERM_XN 1
> > +
> > +#define SET_MEM_ATTR_MAKE_PERM_REQUEST(d_perm,
> > c_perm) \
> > + ((((c_perm) & SET_MEM_ATTR_CODE_PERM_MASK) <<
> > SET_MEM_ATTR_CODE_PERM_SHIFT) | \
> > + (( (d_perm) & SET_MEM_ATTR_DATA_PERM_MASK) <<
> > SET_MEM_ATTR_DATA_PERM_SHIFT))
> > +
> > +/* MM return error codes */
> > +#define ARM_SMC_MM_RET_SUCCESS 0
> > +#define ARM_SMC_MM_RET_NOT_SUPPORTED -1
> > +#define ARM_SMC_MM_RET_INVALID_PARAMS -2
> > +#define ARM_SMC_MM_RET_DENIED -3
> > +#define ARM_SMC_MM_RET_NO_MEMORY -4
> > +
> > /*
> > * Power State Coordination Interface (PSCI) calls cover a subset
> > of the
> > * Standard Service Call range.
> > --
> > 2.14.1
> >
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [PATCH 1/1] ArmPkg/Include: Add standard SMC and SVC function IDs for MM interface.
2017-09-22 22:12 ` Supreeth Venkatesh
@ 2017-09-22 22:15 ` Ard Biesheuvel
0 siblings, 0 replies; 4+ messages in thread
From: Ard Biesheuvel @ 2017-09-22 22:15 UTC (permalink / raw)
To: Supreeth Venkatesh
Cc: Achin Gupta, edk2-devel@lists.01.org, Leif Lindholm, nd
On 22 September 2017 at 15:12, Supreeth Venkatesh
<supreeth.venkatesh@arm.com> wrote:
> On Fri, 2017-09-22 at 22:45 +0100, Achin Gupta wrote:
>> Hi Supreeth,
>>
>> On Fri, Sep 22, 2017 at 08:25:39PM +0100, Supreeth Venkatesh wrote:
>> >
>> > This patch adds a list of function IDs that fall under the standard
>> > SMC range as defined in
>> > http://infocenter.arm.com/help/topic/com.arm.doc.den0060a/DEN0060A_
>> > ARM_MM_Interface_Specification.pdf.
>> >
>> > SMCs associated with Management Mode are in the range 0xC4000040 -
>> > 0xC400005f (64 bit) and 0x84000040 - 0x8400005f (32 bit).
>> >
>> > The function(s) available to the normal world:
>> > 1. Request services from the secure MM environment using
>> > MM_COMMUNICATE.
>> >
>> > SVCs are in the range 0xC4000060 - 0xC400007f.
>> > The functions available to the secure MM partition:
>> > 1. Signal completion of MM event handling.
>> > 2. Set/Get memory attributes for a memory region at runtime.
>> > 3. Get version number of secure partition manager.
>> >
>> > Also, it defines memory attributes and MM return codes.
>> The SVCs in the 0xC4000060 - 0xC400007f range are not a part of the
>> MM interface
>> specification. At the moment, these are used to implement an
>> interface between
>> ARM TF in EL3 and S-EL0. These should go into a separate patch that
>> introduces
>> them as an ARM TF ABI.
>>
>> cheers,
>> Achin
>
> Thanks for taking a look at it. This was added in ArmStdSmc.h
> deliberately to request comments/feedback. I don't think SVC defines
> belong in this file at all. It should have its own header file.
>
> Since it is specific to MM (S-EL0) - EL3 communication, I am tempted to
> create a new header file named "ArmMmSvc.h" and put in
> ArmPkg/Include/IndustryStandard folder.
>
> Comments - Maintainers/Anyone?
If these are only used for SVC calls from S-EL0, then yes, they should
be in a separate header file.
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2017-09-22 22:12 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2017-09-22 19:25 [PATCH 1/1] ArmPkg/Include: Add standard SMC and SVC function IDs for MM interface Supreeth Venkatesh
2017-09-22 21:45 ` Achin Gupta
2017-09-22 22:12 ` Supreeth Venkatesh
2017-09-22 22:15 ` Ard Biesheuvel
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox