Required changes to KnobService and XML Schema to enable per-library header definitions and XML merging

[mario-posso-escobar]

Preface

Please ensure you have read the contribution docs prior to submitting the pull request. In particular, pull request guidelines.

Description

Add a header reference field to the XML definitions to allow flexible build inclusion patterns.

For each item, place an "x" in between [ and ] if true. Example: [x]. (you can also check items in the GitHub UI)

• [ ] Impacts functionality?
• Functionality - Does the change ultimately impact how firmware functions?
• Examples: Add a new library, publish a new PPI, update an algorithm, ...
• [ ] Impacts security?
• Security - Does the change have a direct security impact on an application, flow, or firmware?
  • Examples: Crypto algorithm change, buffer overflow fix, parameter validation improvement, ...
• [ ] Breaking change?
• Breaking change - Will anyone consuming this change experience a break in build or boot behavior?
• Examples: Add a new library class, move a module to a different repo, call a function in a new library class in a pre-existing module, ...
• [ ] Includes tests?
  • Tests - Does the change include any explicit test code?
  • Examples: Unit tests, integration tests, robot tests, ...
• [ ] Includes documentation?
• Documentation - Does the change contain explicit documentation additions outside direct code modifications (and comments)?
• Examples: Update readme file, add feature readme file, link to documentation on an a separate Web page, ...

How This Was Tested

Tested with locally updated sampleschema.xml. Tested end-to-end with SCP firmware.

Integration Instructions

'headerRef' is an optional attribute that, when used, is consumed by KnobService to reference headers instead of generating the 'Enum' and 'Struct' type definitions in-place. This attribute will not breaking existing XMLs.

[mario-posso-escobar]

@microsoft-github-policy-service agree company="Microsoft"

[codecov-commenter]

Codecov Report

Attention: Patch coverage is 1.37931% with 143 lines in your changes missing coverage. Please review.

Project coverage is 35.92%. Comparing base (e21d89d) to head (2ace030).

:exclamation: Current head 2ace030 differs from pull request most recent head 6278031

Please upload reports for the commit 6278031 to get more accurate results.

Files	Patch %	Lines
SetupDataPkg/Tools/KnobService.py	0.00%	143 Missing :warning:

Additional details and impacted files

```diff @@ Coverage Diff @@ ## main #357 +/- ## ========================================== - Coverage 36.18% 35.92% -0.27% ========================================== Files 31 31 Lines 6268 6319 +51 Branches 669 669 ========================================== + Hits 2268 2270 +2 - Misses 3994 4043 +49 Partials 6 6 ``` | [Flag](https://app.codecov.io/gh/microsoft/mu_feature_config/pull/357/flags?src=pr&el=flags&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=microsoft) | Coverage Δ | | |---|---|---| | [Linux](https://app.codecov.io/gh/microsoft/mu_feature_config/pull/357/flags?src=pr&el=flag&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=microsoft) | `27.24% <1.37%> (-0.26%)` | :arrow_down: | Flags with carried forward coverage won't be shown. [Click here](https://docs.codecov.io/docs/carryforward-flags?utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=microsoft#carryforward-flags-in-the-pull-request-comment) to find out more.

:umbrella: View full report in Codecov by Sentry.
:loudspeaker: Have feedback on the report? Share it here.

[apop5]

I guess we need the documentation updated as well to show an example of how to utilize this new functionality.