Skip to content

Doc/TestCaseSpec: Update GetNextDevice for dual behavior (Mantis 2359) #355

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
cgjertsen wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Doc/TestCaseSpec: Update GetNextDevice for dual behavior (Mantis 2359) #355

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 14 additions & 3 deletions uefi-sct/Doc/TestCaseSpec/09_Protocols_Bootable_Image_Support_Test.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5577,19 +5577,30 @@ available port and <em>PortMultiplierPort</em> being invalid.</p>
<td><p><strong>EFI_ATA_PASS_THRU_PROTOCOL.GetNextDevice –</strong>
<strong>GetNextDevice()</strong></p>
<p>could iterate all available</p>
<p>devices on one port.</p></td>
<p>devices on one port (accepts dual terminal behavior per Mantis 2359).</p></td>
<td><p>1.<strong>GetNextPort()</strong> with <em>Port</em> as</p>
<p><strong>0xFFFF</strong>to start iterate ports.</p>
<p>2. Call <strong>GetNextPort()</strong> with <em>Port</em></p>
<p>as one available port and</p>
<p><em>PortMultiplierPort</em> as 0xFFFF to</p>
<p>start iterate devicess.</p>
<p>3. The iteration should ended up with a return code
<strong>EFI_NOT_FOUND</strong>.</p></td>
<p>3. The iteration should end with either:</p>
<p>(a) A return code of <strong>EFI_NOT_FOUND</strong>, or</p>
<p>(b) <strong>EFI_SUCCESS</strong> with <em>PortMultiplierPort</em>
set to <strong>0xFFFF</strong> (broadcast address indicating no port
multiplier connected, per Mantis 2359).</p>
<p>Both behaviors are spec-compliant per UEFI 2.10 Errata A.</p></td>
</tr>
</tbody>
</table>

**Note (Mantis 2359):** UEFI 2.10 Errata A clarified that when a port
multiplier is not connected, **GetNextDevice()** may return either
**EFI_NOT_FOUND** or **EFI_SUCCESS** with *PortMultiplierPort* set to
**0xFFFF**. Both behaviors are now accepted. The conformance test
checkpoints 1 and 2 (5.7.8.6.1 and 5.7.8.6.2) record **WARNING** and
skip when no devices are enumerable, rather than hard-failing.

### PassThru()

<table>
Expand Down
Loading