Skip to content

Add Support for One Click Recovery via Boot to PBA/WinRE in MPS #2018

@graikhel-intel

Description

@graikhel-intel

As an ISV using Device Management Toolkit Cloud deployment,
I want to trigger One Click Recovery using Boot to Microsoft WinRE,
so that I can remotely trigger Push-Button Reset and boot the device to the Windows Recovery Environment.

Technical Notes:

  • To determine if Boot to PBA/WinRE is supported:
    • AMT_BootCapabilities.ForceWinREBoot must be true
    • AMT_BootSettingData.WinREBootEnabled must be true
    • CIM_BootSourceSetting.InstanceID should match Intel(r) AMT: Force OCR UEFI Boot Option. There should at least be 1 instance.
  • Return the CIM_BootSourceSetting array in the API response so the user can view available boot sources. Each item should include the CIM_BootSourceSetting.BIOSBootString, which the user can select from.
  • Update the getBootSource logic to set the correct boot source based on the BIOSBootString selected by the user.
  • No changes are needed to AMT_BootSettingData.

Acceptance Criteria:

  • Add new boot options to the existing API power/bootOptions/:guid to support
    • Reset to PBA/WinRE (OCR)
    • Power On to PBA/WinRE (OCR)
  • Update the Features API to include whether Boot to WinRE and Boot to PBA are supported
  • We might need a new API that returns the options available in CIM_BootSourceSetting
  • Update the Sample Web UI to include the new recovery options
    • Reset to PBA/WinRE (OCR)
    • Power On to PBA/WinRE (OCR)
    • Display WinRE support status in General AMT Info tab
    • Once a user selects Reset to PBA/WinRE show the settings available in CIM_BootSourceSetting
  • Update Postman tests
  • Validation

Metadata

Metadata

Labels

No labels
No labels

Projects

Status

In Progress

Status

Q3 2025 (Current)

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions