/**
Connect a class of devices using the platform Boot Manager policy.
The ConnectDeviceClass() function allows the caller to request that the Boot
Manager connect a class of devices.
If Class is EFI_BOOT_MANAGER_POLICY_CONSOLE_GUID then the Boot Manager will
use platform policy to connect consoles. Some platforms may restrict the
number of consoles connected as they attempt to fast boot, and calling
ConnectDeviceClass() with a Class value of EFI_BOOT_MANAGER_POLICY_CONSOLE_GUID
must connect the set of consoles that follow the Boot Manager platform policy,
and the EFI_SIMPLE_TEXT_INPUT_PROTOCOL, EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL, and
the EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL are produced on the connected handles.
The Boot Manager may restrict which consoles get connect due to platform policy,
for example a security policy may require that a given console is not connected.
If Class is EFI_BOOT_MANAGER_POLICY_NETWORK_GUID then the Boot Manager will
connect the protocols the platforms supports for UEFI general purpose network
applications on one or more handles. If more than one network controller is
available a platform will connect, one, many, or all of the networks based
on platform policy. Connecting UEFI networking protocols, like EFI_DHCP4_PROTOCOL,
does not establish connections on the network. The UEFI general purpose network
application that called ConnectDeviceClass() may need to use the published
protocols to establish the network connection. The Boot Manager can optionally
have a policy to establish a network connection.
If Class is EFI_BOOT_MANAGER_POLICY_CONNECT_ALL_GUID then the Boot Manager
will connect all UEFI drivers using the UEFI Boot Service
EFI_BOOT_SERVICES.ConnectController(). If the Boot Manager has policy
associated with connect all UEFI drivers this policy will be used.
A platform can also define platform specific Class values as a properly generated
EFI_GUID would never conflict with this specification.
@param[in] This A pointer to the EFI_BOOT_MANAGER_POLICY_PROTOCOL instance.
@param[in] Class A pointer to an EFI_GUID that represents a class of devices
that will be connected using the Boot Mangers platform policy.
@retval EFI_SUCCESS At least one devices of the Class was connected.
@retval EFI_DEVICE_ERROR Devices were not connected due to an error.
@retval EFI_NOT_FOUND The Class is not supported by the platform.
@retval EFI_UNSUPPORTED The current TPL is not TPL_APPLICATION.
**/
EFI_STATUS
EFIAPI
BootManagerPolicyConnectDeviceClass (
IN EFI_BOOT_MANAGER_POLICY_PROTOCOL *This,
IN EFI_GUID *Class
)
{
if (EfiGetCurrentTpl () != TPL_APPLICATION) {
return EFI_UNSUPPORTED;
}
if (CompareGuid (Class, &gEfiBootManagerPolicyConnectAllGuid)) {
ConnectAllAndCreateNetworkDeviceList ();
return EFI_SUCCESS;
}
if (CompareGuid (Class, &gEfiBootManagerPolicyConsoleGuid)) {
return EfiBootManagerConnectAllDefaultConsoles ();
}
if (CompareGuid (Class, &gEfiBootManagerPolicyNetworkGuid)) {
return ConnectNetwork ();
}
return EFI_NOT_FOUND;
}
/**
This function will connect all the system driver to controller
first, and then special connect the default console, this make
sure all the system controller available and the platform default
console connected.
**/
VOID
EFIAPI
EfiBootManagerConnectAll (
VOID
)
{
//
// Connect the platform console first
//
EfiBootManagerConnectAllDefaultConsoles ();
//
// Generic way to connect all the drivers
//
BmConnectAllDriversToAllControllers ();
//
// Here we have the assumption that we have already had
// platform default console
//
EfiBootManagerConnectAllDefaultConsoles ();
}
/**
This function will search every input/output device in current system,
and make every input/output device as potential console device.
**/
VOID
EFIAPI
EfiBootManagerConnectAllConsoles (
VOID
)
{
UINTN Index;
EFI_DEVICE_PATH_PROTOCOL *ConDevicePath;
UINTN HandleCount;
EFI_HANDLE *HandleBuffer;
Index = 0;
HandleCount = 0;
HandleBuffer = NULL;
ConDevicePath = NULL;
//
// Update all the console variables
//
gBS->LocateHandleBuffer (
ByProtocol,
&gEfiSimpleTextInProtocolGuid,
NULL,
&HandleCount,
&HandleBuffer
);
for (Index = 0; Index < HandleCount; Index++) {
gBS->HandleProtocol (
HandleBuffer[Index],
&gEfiDevicePathProtocolGuid,
(VOID **) &ConDevicePath
);
EfiBootManagerUpdateConsoleVariable (ConIn, ConDevicePath, NULL);
}
if (HandleBuffer != NULL) {
FreePool(HandleBuffer);
HandleBuffer = NULL;
}
gBS->LocateHandleBuffer (
ByProtocol,
&gEfiSimpleTextOutProtocolGuid,
NULL,
&HandleCount,
&HandleBuffer
);
for (Index = 0; Index < HandleCount; Index++) {
gBS->HandleProtocol (
HandleBuffer[Index],
&gEfiDevicePathProtocolGuid,
(VOID **) &ConDevicePath
);
EfiBootManagerUpdateConsoleVariable (ConOut, ConDevicePath, NULL);
EfiBootManagerUpdateConsoleVariable (ErrOut, ConDevicePath, NULL);
}
if (HandleBuffer != NULL) {
FreePool(HandleBuffer);
}
//
// Connect all console variables
//
EfiBootManagerConnectAllDefaultConsoles ();
}
