public inbox for devel@edk2.groups.io
 help / color / mirror / Atom feed
From: "Yao, Jiewen" <jiewen.yao@intel.com>
To: "Kinney, Michael D" <michael.d.kinney@intel.com>,
	"edk2-devel@lists.01.org" <edk2-devel@lists.01.org>
Cc: "Tian, Feng" <feng.tian@intel.com>,
	"Zeng, Star" <star.zeng@intel.com>,
	"Gao, Liming" <liming.gao@intel.com>,
	"Zhang, Chao B" <chao.b.zhang@intel.com>
Subject: Re: [PATCH V7 03/15] MdeModulePkg/MdeModulePkg.dec: Add capsule related definition.
Date: Wed, 2 Nov 2016 00:33:56 +0000	[thread overview]
Message-ID: <74D8A39837DF1E4DA445A8C0B3885C50386BC34C@shsmsx102.ccr.corp.intel.com> (raw)
In-Reply-To: <E92EE9817A31E24EB0585FDF735412F56483ED77@ORSMSX113.amr.corp.intel.com>

No special reason.
I am OK to use {0x0} as initial value.


From: Kinney, Michael D
Sent: Wednesday, November 2, 2016 8:14 AM
To: Yao, Jiewen <jiewen.yao@intel.com>; edk2-devel@lists.01.org; Kinney, Michael D <michael.d.kinney@intel.com>
Cc: Tian, Feng <feng.tian@intel.com>; Zeng, Star <star.zeng@intel.com>; Gao, Liming <liming.gao@intel.com>; Zhang, Chao B <chao.b.zhang@intel.com>
Subject: RE: [PATCH V7 03/15] MdeModulePkg/MdeModulePkg.dec: Add capsule related definition.

Jiewen,

Why does the following PCD have a default value that is a full GUID?
I think it should have a default value of {0x0} because every platform
must create one of more new GUIDs for the set of Capsule Image Type ID
GUIDs the platform supports.

  ## This PCD hold a list GUIDs for the ImageTypeId to indicate the
  #  FMP capsule is a system FMP.
  # @Prompt A list of system FMP ImageTypeId GUIDs
  gEfiMdeModulePkgTokenSpaceGuid.PcdSystemFmpCapsuleImageTypeIdGuid|{0xd3, 0xee, 0x7e, 0x3f, 0x91, 0xf4, 0x1e, 0x40, 0x9e, 0xce, 0x74, 0x31, 0x32, 0x2e, 0xad, 0xf6}|VOID*|0x30001046

Thanks,

Mike

> -----Original Message-----
> From: Yao, Jiewen
> Sent: Tuesday, November 1, 2016 5:05 AM
> To: edk2-devel@lists.01.org<mailto:edk2-devel@lists.01.org>
> Cc: Tian, Feng <feng.tian@intel.com<mailto:feng.tian@intel.com>>; Zeng, Star <star.zeng@intel.com<mailto:star.zeng@intel.com>>; Kinney, Michael
> D <michael.d.kinney@intel.com<mailto:michael.d.kinney@intel.com>>; Gao, Liming <liming.gao@intel.com<mailto:liming.gao@intel.com>>; Zhang, Chao B
> <chao.b.zhang@intel.com<mailto:chao.b.zhang@intel.com>>
> Subject: [PATCH V7 03/15] MdeModulePkg/MdeModulePkg.dec: Add capsule related
> definition.
>
> 1) Add capsule related library.
>    FmpAuthenticationLib
> 2) Add capsule related status code PCD.
>    PcdStatusCodeSubClassCapsule
>    PcdCapsuleStatusCodeProcessCapsulesBegin
>    PcdCapsuleStatusCodeProcessCapsulesEnd
>    PcdCapsuleStatusCodeUpdatingFirmware
>    PcdCapsuleStatusCodeUpdateFirmwareSuccess
>    PcdCapsuleStatusCodeUpdateFirmwareFailed
>    PcdCapsuleStatusCodeResettingSystem
> 3) Add capsule status variable PCD - CapsuleMax value.
>    PcdCapsuleMax
> 4) Add system FMP indicator PCD - used by ESRT.
>    PcdSystemFmpCapsuleImageTypeIdGuid
> 5) Add PcdTestKeyUsed PCD.
> This PCD can be set by platform to indicate if there is any
> test key used in current BIOS, such as recovery key,
> or capsule update key.
> Then the generic UI may consume this PCD to show warning information.
> Other platform driver may also consume this PCD to know such info,
> and report it via platform specific way.
>
> Cc: Feng Tian <feng.tian@intel.com<mailto:feng.tian@intel.com>>
> Cc: Star Zeng <star.zeng@intel.com<mailto:star.zeng@intel.com>>
> Cc: Michael D Kinney <michael.d.kinney@intel.com<mailto:michael.d.kinney@intel.com>>
> Cc: Liming Gao <liming.gao@intel.com<mailto:liming.gao@intel.com>>
> Cc: Chao Zhang <chao.b.zhang@intel.com<mailto:chao.b.zhang@intel.com>>
> Contributed-under: TianoCore Contribution Agreement 1.0
> Signed-off-by: Jiewen Yao <jiewen.yao@intel.com<mailto:jiewen.yao@intel.com>>
> Reviewed-by: Liming Gao <liming.gao@intel.com<mailto:liming.gao@intel.com>>
> ---
>  MdeModulePkg/MdeModulePkg.dec | 73 ++++++++++++++++++++
>  1 file changed, 73 insertions(+)
>
> diff --git a/MdeModulePkg/MdeModulePkg.dec b/MdeModulePkg/MdeModulePkg.dec
> index 74b8700..4ae459f 100644
> --- a/MdeModulePkg/MdeModulePkg.dec
> +++ b/MdeModulePkg/MdeModulePkg.dec
> @@ -157,6 +157,10 @@
>    ##
>    FrameBufferBltLib|Include/Library/FrameBufferBltLib.h
>
> +  ## @libraryclass  Provides services to authenticate a UEFI defined FMP Capsule.
> +  #
> +  FmpAuthenticationLib|Include/Library/FmpAuthenticationLib.h
> +
>  [Guids]
>    ## MdeModule package token space guid
>    # Include/Guid/MdeModulePkgTokenSpace.h
> @@ -1141,6 +1145,66 @@
>    #  The default value is 0 that means infinite.
>    # @Prompt MAX repair count
>    gEfiMdeModulePkgTokenSpaceGuid.PcdMaxRepairCount|0x00|UINT32|0x00010076
> +
> +  ## Status Code for Capsule subclass definitions.<BR><BR>
> +  #  EFI_OEM_SPECIFIC_SUBCLASS_CAPSULE  = 0x00810000<BR>
> +  #  NOTE: The default value of this PCD may collide with other OEM specific status
> codes.
> +  #        Override the value of this PCD in the platform DSC file as needed.
> +  # @Prompt Status Code for Capsule subclass definitions
> +  # @ValidList  0x80000003 | 0x00810000
> +
> gEfiMdeModulePkgTokenSpaceGuid.PcdStatusCodeSubClassCapsule|0x00810000|UINT32|0x0000010
> 0
> +
> +  ## Status Code for Capsule Process Begin.<BR><BR>
> +  #  EFI_CAPSULE_PROCESS_CAPSULES_BEGIN  = (EFI_OEM_SPECIFIC | 0x00000001) =
> 0x00008001<BR>
> +  #  NOTE: The default value of this PCD may collide with other OEM specific status
> codes.
> +  #        Override the value of this PCD in the platform DSC file as needed.
> +  # @Prompt Status Code for Capsule Process Begin
> +  # @ValidList  0x80000003 | 0x00008001
> +
> gEfiMdeModulePkgTokenSpaceGuid.PcdCapsuleStatusCodeProcessCapsulesBegin|0x00008001|UINT
> 32|0x00000101
> +
> +  ## Status Code for Capsule Process End.<BR><BR>
> +  #  EFI_CAPSULE_PROCESS_CAPSULES_END    = (EFI_OEM_SPECIFIC | 0x00000002) =
> 0x00008002<BR>
> +  #  NOTE: The default value of this PCD may collide with other OEM specific status
> codes.
> +  #        Override the value of this PCD in the platform DSC file as needed.
> +  # @Prompt Status Code for Capsule Process End
> +  # @ValidList  0x80000003 | 0x00008002
> +
> gEfiMdeModulePkgTokenSpaceGuid.PcdCapsuleStatusCodeProcessCapsulesEnd|0x00008002|UINT32
> |0x00000102
> +
> +  ## Status Code for Capsule Process Updating Firmware.<BR><BR>
> +  #  EFI_CAPSULE_UPDATING_FIRMWARE       = (EFI_OEM_SPECIFIC | 0x00000003) =
> 0x00008003<BR>
> +  #  NOTE: The default value of this PCD may collide with other OEM specific status
> codes.
> +  #        Override the value of this PCD in the platform DSC file as needed.
> +  # @Prompt Status Code for Capsule Process Updating Firmware
> +  # @ValidList  0x80000003 | 0x00008003
> +
> gEfiMdeModulePkgTokenSpaceGuid.PcdCapsuleStatusCodeUpdatingFirmware|0x00008003|UINT32|0
> x00000103
> +
> +  ## Status Code for Capsule Process Update Firmware Success.<BR><BR>
> +  #  EFI_CAPSULE_UPDATE_FIRMWARE_SUCCESS = (EFI_OEM_SPECIFIC | 0x00000004) =
> 0x00008004<BR>
> +  #  NOTE: The default value of this PCD may collide with other OEM specific status
> codes.
> +  #        Override the value of this PCD in the platform DSC file as needed.
> +  # @Prompt Status Code for Capsule Process Update Firmware Success
> +  # @ValidList  0x80000003 | 0x00008004
> +
> gEfiMdeModulePkgTokenSpaceGuid.PcdCapsuleStatusCodeUpdateFirmwareSuccess|0x00008004|UIN
> T32|0x00000104
> +
> +  ## Status Code for Capsule Process Update Firmware Failed.<BR><BR>
> +  #  EFI_CAPSULE_UPDATE_FIRMWARE_FAILED  = (EFI_OEM_SPECIFIC | 0x00000005) =
> 0x00008005<BR>
> +  #  NOTE: The default value of this PCD may collide with other OEM specific status
> codes.
> +  #        Override the value of this PCD in the platform DSC file as needed.
> +  # @Prompt Status Code for Capsule Process Update Firmware Failed
> +  # @ValidList  0x80000003 | 0x00008005
> +
> gEfiMdeModulePkgTokenSpaceGuid.PcdCapsuleStatusCodeUpdateFirmwareFailed|0x00008005|UINT
> 32|0x00000105
> +
> +  ## Status Code for Capsule Resetting System.<BR><BR>
> +  #  EFI_CAPSULE_RESETTING_SYSTEM        = (EFI_OEM_SPECIFIC | 0x00000006) =
> 0x00008006<BR>
> +  #  NOTE: The default value of this PCD may collide with other OEM specific status
> codes.
> +  #        Override the value of this PCD in the platform DSC file as needed.
> +  # @Prompt Status Code for Capsule Resetting System
> +  # @ValidList  0x80000003 | 0x00008006
> +
> gEfiMdeModulePkgTokenSpaceGuid.PcdCapsuleStatusCodeResettingSystem|0x00008006|UINT32|0x
> 00000106
> +
> +  ## CapsuleMax value in capsule report variable.
> +  # @Prompt CapsuleMax value in capsule report variable.
> +  gEfiMdeModulePkgTokenSpaceGuid.PcdCapsuleMax|0xFFFF|UINT16|0x00000107
>
>  [PcdsPatchableInModule, PcdsDynamic, PcdsDynamicEx]
>    ## This PCD defines the Console output row. The default value is 25 according to
> UEFI spec.
> @@ -1587,6 +1651,11 @@
>    #  The PCD data must be in UNICODE format.
>    gEfiMdeModulePkgTokenSpaceGuid.PcdRecoveryFileName|L"FVMAIN.FV"|VOID*|0x30001045
>
> +  ## This PCD hold a list GUIDs for the ImageTypeId to indicate the
> +  #  FMP capsule is a system FMP.
> +  # @Prompt A list of system FMP ImageTypeId GUIDs
> +  gEfiMdeModulePkgTokenSpaceGuid.PcdSystemFmpCapsuleImageTypeIdGuid|{0xd3, 0xee, 0x7e,
> 0x3f, 0x91, 0xf4, 0x1e, 0x40, 0x9e, 0xce, 0x74, 0x31, 0x32, 0x2e, 0xad,
> 0xf6}|VOID*|0x30001046
> +
>  [PcdsPatchableInModule]
>    ## Specify memory size with page number for PEI code when
>    #  Loading Module at Fixed Address feature is enabled.
> @@ -1639,5 +1708,9 @@
>    # @ValidList  0x80000001 | 0x0
>    gEfiMdeModulePkgTokenSpaceGuid.PcdIdentifyMappingPageTablePtr|0x0|UINT64|0x00030002
>
> +  ## This dynamic PCD holds the information if there is any test key used by the
> platform.
> +  # @Prompt If there is any test key used by the platform.
> +  gEfiMdeModulePkgTokenSpaceGuid.PcdTestKeyUsed|FALSE|BOOLEAN|0x00030003
> +
>  [UserExtensions.TianoCore."ExtraFiles"]
>    MdeModulePkgExtra.uni
> --
> 2.7.4.windows.1


  reply	other threads:[~2016-11-02  0:33 UTC|newest]

Thread overview: 18+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2016-11-01 12:04 [PATCH V7 00/15] Add capsule support lib and app Jiewen Yao
2016-11-01 12:04 ` [PATCH V7 01/15] MdeModulePkg/Include: Add FmpAuthenticationLib header Jiewen Yao
2016-11-01 12:04 ` [PATCH V7 02/15] MdeModulePkg/CapsuleLib: Add ProcessCapsules() API Jiewen Yao
2016-11-01 12:04 ` [PATCH V7 03/15] MdeModulePkg/MdeModulePkg.dec: Add capsule related definition Jiewen Yao
2016-11-02  0:14   ` Kinney, Michael D
2016-11-02  0:33     ` Yao, Jiewen [this message]
2016-11-01 12:04 ` [PATCH V7 04/15] MdeModulePkg/FmpAuthenticationLibNull: Add NULL instance FMP Jiewen Yao
2016-11-01 12:05 ` [PATCH V7 05/15] MdeModulePkg/DxeCapsuleLibNull: Add ProcessCapsules() interface Jiewen Yao
2016-11-01 12:05 ` [PATCH V7 06/15] MdeModulePkg/DxeCapsuleLibFmp: Add DxeCapsuleLibFmp instance Jiewen Yao
2016-11-01 12:05 ` [PATCH V7 07/15] MdeModulePkg/Esrt: Add ESRT_FW_TYPE_SYSTEMFIRMWARE check Jiewen Yao
2016-11-01 12:05 ` [PATCH V7 08/15] MdeModulePkg/CapsuleApp: Add CapsuleApp application Jiewen Yao
2016-11-01 12:05 ` [PATCH V7 09/15] MdeModulePkg/UiApp: Show test key warning info in FrontPage Jiewen Yao
2016-11-01 12:05 ` [PATCH V7 10/15] MdeModulePkg/MdeModulePkg.dsc: Add FMP related component Jiewen Yao
2016-11-01 12:05 ` [PATCH V7 11/15] IntelFrameworkModulePkg/DxeCapsuleLib: Add ProcessCapsules() interface Jiewen Yao
2016-11-01 12:05 ` [PATCH V7 12/15] SecurityPkg/SecurityPkg.dec: Add PcdPkcs7CertBuffer PCD Jiewen Yao
2016-11-01 12:05 ` [PATCH V7 13/15] SecurityPkg/FmpAuthenticationLibPkcs7: Add PKCS7 instance for FMP Jiewen Yao
2016-11-01 12:05 ` [PATCH V7 14/15] SecurityPkg/FmpAuthenticationLibRsa2048Sha256: Add RSA2048 instance Jiewen Yao
2016-11-01 12:05 ` [PATCH V7 15/15] SecurityPkg/SecurityPkg.dsc: Add FmpAuthenticationLib* Jiewen Yao

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-list from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=74D8A39837DF1E4DA445A8C0B3885C50386BC34C@shsmsx102.ccr.corp.intel.com \
    --to=devel@edk2.groups.io \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox