2 DevicePathFromText protocol as defined in the UEFI 2.0 specification.
4 Copyright (c) 2013 - 2014, Intel Corporation. All rights reserved.<BR>
5 This program and the accompanying materials
6 are licensed and made available under the terms and conditions of the BSD License
7 which accompanies this distribution. The full text of the license may be found at
8 http://opensource.org/licenses/bsd-license.php
10 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
11 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
15 #include "UefiDevicePathLib.h"
21 @param Src Source string.
23 @return The duplicated string.
27 UefiDevicePathLibStrDuplicate (
31 return AllocateCopyPool (StrSize (Src
), Src
);
36 Get parameter in a pair of parentheses follow the given node name.
37 For example, given the "Pci(0,1)" and NodeName "Pci", it returns "0,1".
39 @param Str Device Path Text.
40 @param NodeName Name of the node.
42 @return Parameter text for the node.
54 UINTN ParameterLength
;
57 // Check whether the node name matchs
59 NodeNameLength
= StrLen (NodeName
);
60 if (StrnCmp (Str
, NodeName
, NodeNameLength
) != 0) {
64 ParamStr
= Str
+ NodeNameLength
;
65 if (!IS_LEFT_PARENTH (*ParamStr
)) {
70 // Skip the found '(' and find first occurrence of ')'
74 StrPointer
= ParamStr
;
75 while (!IS_NULL (*StrPointer
)) {
76 if (IS_RIGHT_PARENTH (*StrPointer
)) {
82 if (IS_NULL (*StrPointer
)) {
89 ParamStr
= AllocateCopyPool ((ParameterLength
+ 1) * sizeof (CHAR16
), ParamStr
);
90 if (ParamStr
== NULL
) {
94 // Terminate the parameter string
96 ParamStr
[ParameterLength
] = L
'\0';
102 Gets current sub-string from a string list, before return
103 the list header is moved to next sub-string. The sub-string is separated
104 by the specified character. For example, the separator is ',', the string
105 list is "2,0,3", it returns "2", the remain list move to "0,3"
107 @param List A string list separated by the specified separator
108 @param Separator The separator character
110 @return A pointer to the current sub-string
115 IN OUT CHAR16
**List
,
125 if (IS_NULL (*Str
)) {
130 // Find first occurrence of the separator
132 while (!IS_NULL (*Str
)) {
133 if (*Str
== Separator
) {
139 if (*Str
== Separator
) {
141 // Find a sub-string, terminate it
148 // Move to next sub-string
156 Gets the next parameter string from the list.
158 @param List A string list separated by the specified separator
160 @return A pointer to the current sub-string
169 // The separator is comma
171 return SplitStr (List
, L
',');
175 Get one device node from entire device path text.
177 @param DevicePath On input, the current Device Path node; on output, the next device path node
178 @param IsInstanceEnd This node is the end of a device path instance
180 @return A device node text or NULL if no more device node available
184 GetNextDeviceNodeStr (
185 IN OUT CHAR16
**DevicePath
,
186 OUT BOOLEAN
*IsInstanceEnd
191 UINTN ParenthesesStack
;
194 if (IS_NULL (*Str
)) {
199 // Skip the leading '/', '(', ')' and ','
201 while (!IS_NULL (*Str
)) {
202 if (!IS_SLASH (*Str
) &&
204 !IS_LEFT_PARENTH (*Str
) &&
205 !IS_RIGHT_PARENTH (*Str
)) {
214 // Scan for the separator of this device node, '/' or ','
216 ParenthesesStack
= 0;
217 while (!IS_NULL (*Str
)) {
218 if ((IS_COMMA (*Str
) || IS_SLASH (*Str
)) && (ParenthesesStack
== 0)) {
222 if (IS_LEFT_PARENTH (*Str
)) {
224 } else if (IS_RIGHT_PARENTH (*Str
)) {
231 if (ParenthesesStack
!= 0) {
233 // The '(' doesn't pair with ')', invalid device path text
238 if (IS_COMMA (*Str
)) {
239 *IsInstanceEnd
= TRUE
;
243 *IsInstanceEnd
= FALSE
;
244 if (!IS_NULL (*Str
)) {
257 Return whether the integer string is a hex string.
259 @param Str The integer string
261 @retval TRUE Hex string
262 @retval FALSE Decimal string
271 // skip preceeding white space
273 while ((*Str
!= 0) && *Str
== L
' ') {
277 // skip preceeding zeros
279 while ((*Str
!= 0) && *Str
== L
'0') {
283 return (BOOLEAN
) (*Str
== L
'x' || *Str
== L
'X');
288 Convert integer string to uint.
290 @param Str The integer string. If leading with "0x" or "0X", it's hexadecimal.
292 @return A UINTN value represented by Str
300 if (IsHexStr (Str
)) {
301 return StrHexToUintn (Str
);
303 return StrDecimalToUintn (Str
);
309 Convert integer string to 64 bit data.
311 @param Str The integer string. If leading with "0x" or "0X", it's hexadecimal.
312 @param Data A pointer to the UINT64 value represented by Str
321 if (IsHexStr (Str
)) {
322 *Data
= StrHexToUint64 (Str
);
324 *Data
= StrDecimalToUint64 (Str
);
329 Converts a list of string to a specified buffer.
331 @param Buf The output buffer that contains the string.
332 @param BufferLength The length of the buffer
333 @param Str The input string that contains the hex number
335 @retval EFI_SUCCESS The string was successfully converted to the buffer.
341 IN UINTN BufferLength
,
353 // Two hex char make up one byte
355 StrLength
= BufferLength
* sizeof (CHAR16
);
357 for(Index
= 0; Index
< StrLength
; Index
++, Str
++) {
359 if ((*Str
>= L
'a') && (*Str
<= L
'f')) {
360 Digit
= (UINT8
) (*Str
- L
'a' + 0x0A);
361 } else if ((*Str
>= L
'A') && (*Str
<= L
'F')) {
362 Digit
= (UINT8
) (*Str
- L
'A' + 0x0A);
363 } else if ((*Str
>= L
'0') && (*Str
<= L
'9')) {
364 Digit
= (UINT8
) (*Str
- L
'0');
366 return EFI_INVALID_PARAMETER
;
370 // For odd characters, write the upper nibble for each buffer byte,
371 // and for even characters, the lower nibble.
373 if ((Index
& 1) == 0) {
374 Byte
= (UINT8
) (Digit
<< 4);
376 Byte
= Buf
[Index
/ 2];
378 Byte
= (UINT8
) (Byte
| Digit
);
381 Buf
[Index
/ 2] = Byte
;
388 Converts a string to GUID value.
389 Guid Format is xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
391 @param Str The registry format GUID string that contains the GUID value.
392 @param Guid A pointer to the converted GUID value.
394 @retval EFI_SUCCESS The GUID string was successfully converted to the GUID value.
395 @retval EFI_UNSUPPORTED The input string is not in registry format.
396 @return others Some error occurred when converting part of GUID value.
406 // Get the first UINT32 data
408 Guid
->Data1
= (UINT32
) StrHexToUint64 (Str
);
409 while (!IS_HYPHEN (*Str
) && !IS_NULL (*Str
)) {
413 if (IS_HYPHEN (*Str
)) {
416 return EFI_UNSUPPORTED
;
420 // Get the second UINT16 data
422 Guid
->Data2
= (UINT16
) StrHexToUint64 (Str
);
423 while (!IS_HYPHEN (*Str
) && !IS_NULL (*Str
)) {
427 if (IS_HYPHEN (*Str
)) {
430 return EFI_UNSUPPORTED
;
434 // Get the third UINT16 data
436 Guid
->Data3
= (UINT16
) StrHexToUint64 (Str
);
437 while (!IS_HYPHEN (*Str
) && !IS_NULL (*Str
)) {
441 if (IS_HYPHEN (*Str
)) {
444 return EFI_UNSUPPORTED
;
448 // Get the following 8 bytes data
450 StrToBuf (&Guid
->Data4
[0], 2, Str
);
452 // Skip 2 byte hex chars
456 if (IS_HYPHEN (*Str
)) {
459 return EFI_UNSUPPORTED
;
461 StrToBuf (&Guid
->Data4
[2], 6, Str
);
467 Converts a string to IPv4 address
469 @param Str A string representation of IPv4 address.
470 @param IPv4Addr A pointer to the converted IPv4 address.
476 OUT EFI_IPv4_ADDRESS
*IPv4Addr
481 for (Index
= 0; Index
< 4; Index
++) {
482 IPv4Addr
->Addr
[Index
] = (UINT8
) Strtoi (SplitStr (Str
, L
'.'));
487 Converts a string to IPv4 address
489 @param Str A string representation of IPv6 address.
490 @param IPv6Addr A pointer to the converted IPv6 address.
496 OUT EFI_IPv6_ADDRESS
*IPv6Addr
502 for (Index
= 0; Index
< 8; Index
++) {
503 Data
= (UINT16
) StrHexToUintn (SplitStr (Str
, L
':'));
504 IPv6Addr
->Addr
[Index
* 2] = (UINT8
) (Data
>> 8);
505 IPv6Addr
->Addr
[Index
* 2 + 1] = (UINT8
) (Data
& 0xff);
510 Converts a Unicode string to ASCII string.
512 @param Str The equivalent Unicode string
513 @param AsciiStr On input, it points to destination ASCII string buffer; on output, it points
514 to the next ASCII string next to it
520 IN OUT CHAR8
**AsciiStr
526 while (!IS_NULL (*Str
)) {
527 *(Dest
++) = (CHAR8
) *(Str
++);
532 // Return the string next to it
534 *AsciiStr
= Dest
+ 1;
538 Converts a generic text device path node to device path structure.
540 @param Type The type of the device path node.
541 @param TextDeviceNode The input text device path node.
543 @return A pointer to device path structure.
545 EFI_DEVICE_PATH_PROTOCOL
*
546 DevPathFromTextGenericPath (
548 IN CHAR16
*TextDeviceNode
551 EFI_DEVICE_PATH_PROTOCOL
*Node
;
556 SubtypeStr
= GetNextParamStr (&TextDeviceNode
);
557 DataStr
= GetNextParamStr (&TextDeviceNode
);
559 if (DataStr
== NULL
) {
562 DataLength
= StrLen (DataStr
) / 2;
564 Node
= CreateDeviceNode (
566 (UINT8
) Strtoi (SubtypeStr
),
567 (UINT16
) (sizeof (EFI_DEVICE_PATH_PROTOCOL
) + DataLength
)
570 if (DataLength
!= 0) {
571 StrToBuf ((UINT8
*) (Node
+ 1), DataLength
, DataStr
);
577 Converts a generic text device path node to device path structure.
579 @param TextDeviceNode The input Text device path node.
581 @return A pointer to device path structure.
584 EFI_DEVICE_PATH_PROTOCOL
*
585 DevPathFromTextPath (
586 IN CHAR16
*TextDeviceNode
591 TypeStr
= GetNextParamStr (&TextDeviceNode
);
593 return DevPathFromTextGenericPath ((UINT8
) Strtoi (TypeStr
), TextDeviceNode
);
597 Converts a generic hardware text device path node to Hardware device path structure.
599 @param TextDeviceNode The input Text device path node.
601 @return A pointer to Hardware device path structure.
604 EFI_DEVICE_PATH_PROTOCOL
*
605 DevPathFromTextHardwarePath (
606 IN CHAR16
*TextDeviceNode
609 return DevPathFromTextGenericPath (HARDWARE_DEVICE_PATH
, TextDeviceNode
);
613 Converts a text device path node to Hardware PCI device path structure.
615 @param TextDeviceNode The input Text device path node.
617 @return A pointer to Hardware PCI device path structure.
620 EFI_DEVICE_PATH_PROTOCOL
*
622 IN CHAR16
*TextDeviceNode
627 PCI_DEVICE_PATH
*Pci
;
629 DeviceStr
= GetNextParamStr (&TextDeviceNode
);
630 FunctionStr
= GetNextParamStr (&TextDeviceNode
);
631 Pci
= (PCI_DEVICE_PATH
*) CreateDeviceNode (
632 HARDWARE_DEVICE_PATH
,
634 (UINT16
) sizeof (PCI_DEVICE_PATH
)
637 Pci
->Function
= (UINT8
) Strtoi (FunctionStr
);
638 Pci
->Device
= (UINT8
) Strtoi (DeviceStr
);
640 return (EFI_DEVICE_PATH_PROTOCOL
*) Pci
;
644 Converts a text device path node to Hardware PC card device path structure.
646 @param TextDeviceNode The input Text device path node.
648 @return A pointer to Hardware PC card device path structure.
651 EFI_DEVICE_PATH_PROTOCOL
*
652 DevPathFromTextPcCard (
653 IN CHAR16
*TextDeviceNode
656 CHAR16
*FunctionNumberStr
;
657 PCCARD_DEVICE_PATH
*Pccard
;
659 FunctionNumberStr
= GetNextParamStr (&TextDeviceNode
);
660 Pccard
= (PCCARD_DEVICE_PATH
*) CreateDeviceNode (
661 HARDWARE_DEVICE_PATH
,
663 (UINT16
) sizeof (PCCARD_DEVICE_PATH
)
666 Pccard
->FunctionNumber
= (UINT8
) Strtoi (FunctionNumberStr
);
668 return (EFI_DEVICE_PATH_PROTOCOL
*) Pccard
;
672 Converts a text device path node to Hardware memory map device path structure.
674 @param TextDeviceNode The input Text device path node.
676 @return A pointer to Hardware memory map device path structure.
679 EFI_DEVICE_PATH_PROTOCOL
*
680 DevPathFromTextMemoryMapped (
681 IN CHAR16
*TextDeviceNode
684 CHAR16
*MemoryTypeStr
;
685 CHAR16
*StartingAddressStr
;
686 CHAR16
*EndingAddressStr
;
687 MEMMAP_DEVICE_PATH
*MemMap
;
689 MemoryTypeStr
= GetNextParamStr (&TextDeviceNode
);
690 StartingAddressStr
= GetNextParamStr (&TextDeviceNode
);
691 EndingAddressStr
= GetNextParamStr (&TextDeviceNode
);
692 MemMap
= (MEMMAP_DEVICE_PATH
*) CreateDeviceNode (
693 HARDWARE_DEVICE_PATH
,
695 (UINT16
) sizeof (MEMMAP_DEVICE_PATH
)
698 MemMap
->MemoryType
= (UINT32
) Strtoi (MemoryTypeStr
);
699 Strtoi64 (StartingAddressStr
, &MemMap
->StartingAddress
);
700 Strtoi64 (EndingAddressStr
, &MemMap
->EndingAddress
);
702 return (EFI_DEVICE_PATH_PROTOCOL
*) MemMap
;
706 Converts a text device path node to Vendor device path structure based on the input Type
709 @param TextDeviceNode The input Text device path node.
710 @param Type The type of device path node.
711 @param SubType The subtype of device path node.
713 @return A pointer to the newly-created Vendor device path structure.
716 EFI_DEVICE_PATH_PROTOCOL
*
717 ConvertFromTextVendor (
718 IN CHAR16
*TextDeviceNode
,
726 VENDOR_DEVICE_PATH
*Vendor
;
728 GuidStr
= GetNextParamStr (&TextDeviceNode
);
730 DataStr
= GetNextParamStr (&TextDeviceNode
);
731 Length
= StrLen (DataStr
);
733 // Two hex characters make up 1 buffer byte
735 Length
= (Length
+ 1) / 2;
737 Vendor
= (VENDOR_DEVICE_PATH
*) CreateDeviceNode (
740 (UINT16
) (sizeof (VENDOR_DEVICE_PATH
) + Length
)
743 StrToGuid (GuidStr
, &Vendor
->Guid
);
744 StrToBuf (((UINT8
*) Vendor
) + sizeof (VENDOR_DEVICE_PATH
), Length
, DataStr
);
746 return (EFI_DEVICE_PATH_PROTOCOL
*) Vendor
;
750 Converts a text device path node to Vendor Hardware device path structure.
752 @param TextDeviceNode The input Text device path node.
754 @return A pointer to the newly-created Vendor Hardware device path structure.
757 EFI_DEVICE_PATH_PROTOCOL
*
758 DevPathFromTextVenHw (
759 IN CHAR16
*TextDeviceNode
762 return ConvertFromTextVendor (
764 HARDWARE_DEVICE_PATH
,
770 Converts a text device path node to Hardware Controller device path structure.
772 @param TextDeviceNode The input Text device path node.
774 @return A pointer to the newly-created Hardware Controller device path structure.
777 EFI_DEVICE_PATH_PROTOCOL
*
778 DevPathFromTextCtrl (
779 IN CHAR16
*TextDeviceNode
782 CHAR16
*ControllerStr
;
783 CONTROLLER_DEVICE_PATH
*Controller
;
785 ControllerStr
= GetNextParamStr (&TextDeviceNode
);
786 Controller
= (CONTROLLER_DEVICE_PATH
*) CreateDeviceNode (
787 HARDWARE_DEVICE_PATH
,
789 (UINT16
) sizeof (CONTROLLER_DEVICE_PATH
)
791 Controller
->ControllerNumber
= (UINT32
) Strtoi (ControllerStr
);
793 return (EFI_DEVICE_PATH_PROTOCOL
*) Controller
;
797 Converts a generic ACPI text device path node to ACPI device path structure.
799 @param TextDeviceNode The input Text device path node.
801 @return A pointer to ACPI device path structure.
804 EFI_DEVICE_PATH_PROTOCOL
*
805 DevPathFromTextAcpiPath (
806 IN CHAR16
*TextDeviceNode
809 return DevPathFromTextGenericPath (ACPI_DEVICE_PATH
, TextDeviceNode
);
813 Converts a string to EisaId.
815 @param Text The input string.
817 @return UINT32 EISA ID.
824 return (((Text
[0] - 'A' + 1) & 0x1f) << 10)
825 + (((Text
[1] - 'A' + 1) & 0x1f) << 5)
826 + (((Text
[2] - 'A' + 1) & 0x1f) << 0)
827 + (UINT32
) (StrHexToUintn (&Text
[3]) << 16)
832 Converts a text device path node to ACPI HID device path structure.
834 @param TextDeviceNode The input Text device path node.
836 @return A pointer to the newly-created ACPI HID device path structure.
839 EFI_DEVICE_PATH_PROTOCOL
*
840 DevPathFromTextAcpi (
841 IN CHAR16
*TextDeviceNode
846 ACPI_HID_DEVICE_PATH
*Acpi
;
848 HIDStr
= GetNextParamStr (&TextDeviceNode
);
849 UIDStr
= GetNextParamStr (&TextDeviceNode
);
850 Acpi
= (ACPI_HID_DEVICE_PATH
*) CreateDeviceNode (
853 (UINT16
) sizeof (ACPI_HID_DEVICE_PATH
)
856 Acpi
->HID
= EisaIdFromText (HIDStr
);
857 Acpi
->UID
= (UINT32
) Strtoi (UIDStr
);
859 return (EFI_DEVICE_PATH_PROTOCOL
*) Acpi
;
863 Converts a text device path node to ACPI HID device path structure.
865 @param TextDeviceNode The input Text device path node.
866 @param PnPId The input plug and play identification.
868 @return A pointer to the newly-created ACPI HID device path structure.
871 EFI_DEVICE_PATH_PROTOCOL
*
872 ConvertFromTextAcpi (
873 IN CHAR16
*TextDeviceNode
,
878 ACPI_HID_DEVICE_PATH
*Acpi
;
880 UIDStr
= GetNextParamStr (&TextDeviceNode
);
881 Acpi
= (ACPI_HID_DEVICE_PATH
*) CreateDeviceNode (
884 (UINT16
) sizeof (ACPI_HID_DEVICE_PATH
)
887 Acpi
->HID
= EFI_PNP_ID (PnPId
);
888 Acpi
->UID
= (UINT32
) Strtoi (UIDStr
);
890 return (EFI_DEVICE_PATH_PROTOCOL
*) Acpi
;
894 Converts a text device path node to PCI root device path structure.
896 @param TextDeviceNode The input Text device path node.
898 @return A pointer to the newly-created PCI root device path structure.
901 EFI_DEVICE_PATH_PROTOCOL
*
902 DevPathFromTextPciRoot (
903 IN CHAR16
*TextDeviceNode
906 return ConvertFromTextAcpi (TextDeviceNode
, 0x0a03);
910 Converts a text device path node to PCIE root device path structure.
912 @param TextDeviceNode The input Text device path node.
914 @return A pointer to the newly-created PCIE root device path structure.
917 EFI_DEVICE_PATH_PROTOCOL
*
918 DevPathFromTextPcieRoot (
919 IN CHAR16
*TextDeviceNode
922 return ConvertFromTextAcpi (TextDeviceNode
, 0x0a08);
926 Converts a text device path node to Floppy device path structure.
928 @param TextDeviceNode The input Text device path node.
930 @return A pointer to the newly-created Floppy device path structure.
933 EFI_DEVICE_PATH_PROTOCOL
*
934 DevPathFromTextFloppy (
935 IN CHAR16
*TextDeviceNode
938 return ConvertFromTextAcpi (TextDeviceNode
, 0x0604);
942 Converts a text device path node to Keyboard device path structure.
944 @param TextDeviceNode The input Text device path node.
946 @return A pointer to the newly-created Keyboard device path structure.
949 EFI_DEVICE_PATH_PROTOCOL
*
950 DevPathFromTextKeyboard (
951 IN CHAR16
*TextDeviceNode
954 return ConvertFromTextAcpi (TextDeviceNode
, 0x0301);
958 Converts a text device path node to Serial device path structure.
960 @param TextDeviceNode The input Text device path node.
962 @return A pointer to the newly-created Serial device path structure.
965 EFI_DEVICE_PATH_PROTOCOL
*
966 DevPathFromTextSerial (
967 IN CHAR16
*TextDeviceNode
970 return ConvertFromTextAcpi (TextDeviceNode
, 0x0501);
974 Converts a text device path node to Parallel Port device path structure.
976 @param TextDeviceNode The input Text device path node.
978 @return A pointer to the newly-created Parallel Port device path structure.
981 EFI_DEVICE_PATH_PROTOCOL
*
982 DevPathFromTextParallelPort (
983 IN CHAR16
*TextDeviceNode
986 return ConvertFromTextAcpi (TextDeviceNode
, 0x0401);
990 Converts a text device path node to ACPI extension device path structure.
992 @param TextDeviceNode The input Text device path node.
994 @return A pointer to the newly-created ACPI extension device path structure.
997 EFI_DEVICE_PATH_PROTOCOL
*
998 DevPathFromTextAcpiEx (
999 IN CHAR16
*TextDeviceNode
1010 ACPI_EXTENDED_HID_DEVICE_PATH
*AcpiEx
;
1012 HIDStr
= GetNextParamStr (&TextDeviceNode
);
1013 CIDStr
= GetNextParamStr (&TextDeviceNode
);
1014 UIDStr
= GetNextParamStr (&TextDeviceNode
);
1015 HIDSTRStr
= GetNextParamStr (&TextDeviceNode
);
1016 CIDSTRStr
= GetNextParamStr (&TextDeviceNode
);
1017 UIDSTRStr
= GetNextParamStr (&TextDeviceNode
);
1019 Length
= (UINT16
) (sizeof (ACPI_EXTENDED_HID_DEVICE_PATH
) + StrLen (HIDSTRStr
) + 1);
1020 Length
= (UINT16
) (Length
+ StrLen (UIDSTRStr
) + 1);
1021 Length
= (UINT16
) (Length
+ StrLen (CIDSTRStr
) + 1);
1022 AcpiEx
= (ACPI_EXTENDED_HID_DEVICE_PATH
*) CreateDeviceNode (
1028 AcpiEx
->HID
= EisaIdFromText (HIDStr
);
1029 AcpiEx
->CID
= EisaIdFromText (CIDStr
);
1030 AcpiEx
->UID
= (UINT32
) Strtoi (UIDStr
);
1032 AsciiStr
= (CHAR8
*) ((UINT8
*)AcpiEx
+ sizeof (ACPI_EXTENDED_HID_DEVICE_PATH
));
1033 StrToAscii (HIDSTRStr
, &AsciiStr
);
1034 StrToAscii (UIDSTRStr
, &AsciiStr
);
1035 StrToAscii (CIDSTRStr
, &AsciiStr
);
1037 return (EFI_DEVICE_PATH_PROTOCOL
*) AcpiEx
;
1041 Converts a text device path node to ACPI extension device path structure.
1043 @param TextDeviceNode The input Text device path node.
1045 @return A pointer to the newly-created ACPI extension device path structure.
1048 EFI_DEVICE_PATH_PROTOCOL
*
1049 DevPathFromTextAcpiExp (
1050 IN CHAR16
*TextDeviceNode
1058 ACPI_EXTENDED_HID_DEVICE_PATH
*AcpiEx
;
1060 HIDStr
= GetNextParamStr (&TextDeviceNode
);
1061 CIDStr
= GetNextParamStr (&TextDeviceNode
);
1062 UIDSTRStr
= GetNextParamStr (&TextDeviceNode
);
1063 Length
= (UINT16
) (sizeof (ACPI_EXTENDED_HID_DEVICE_PATH
) + StrLen (UIDSTRStr
) + 3);
1064 AcpiEx
= (ACPI_EXTENDED_HID_DEVICE_PATH
*) CreateDeviceNode (
1070 AcpiEx
->HID
= EisaIdFromText (HIDStr
);
1071 AcpiEx
->CID
= EisaIdFromText (CIDStr
);
1074 AsciiStr
= (CHAR8
*) ((UINT8
*)AcpiEx
+ sizeof (ACPI_EXTENDED_HID_DEVICE_PATH
));
1076 // HID string is NULL
1080 // Convert UID string
1083 StrToAscii (UIDSTRStr
, &AsciiStr
);
1085 // CID string is NULL
1089 return (EFI_DEVICE_PATH_PROTOCOL
*) AcpiEx
;
1093 Converts a text device path node to ACPI _ADR device path structure.
1095 @param TextDeviceNode The input Text device path node.
1097 @return A pointer to the newly-created ACPI _ADR device path structure.
1100 EFI_DEVICE_PATH_PROTOCOL
*
1101 DevPathFromTextAcpiAdr (
1102 IN CHAR16
*TextDeviceNode
1105 CHAR16
*DisplayDeviceStr
;
1106 ACPI_ADR_DEVICE_PATH
*AcpiAdr
;
1110 AcpiAdr
= (ACPI_ADR_DEVICE_PATH
*) CreateDeviceNode (
1113 (UINT16
) sizeof (ACPI_ADR_DEVICE_PATH
)
1115 ASSERT (AcpiAdr
!= NULL
);
1117 for (Index
= 0; ; Index
++) {
1118 DisplayDeviceStr
= GetNextParamStr (&TextDeviceNode
);
1119 if (IS_NULL (*DisplayDeviceStr
)) {
1123 Length
= DevicePathNodeLength (AcpiAdr
);
1124 AcpiAdr
= ReallocatePool (
1126 Length
+ sizeof (UINT32
),
1129 ASSERT (AcpiAdr
!= NULL
);
1130 SetDevicePathNodeLength (AcpiAdr
, Length
+ sizeof (UINT32
));
1133 (&AcpiAdr
->ADR
)[Index
] = (UINT32
) Strtoi (DisplayDeviceStr
);
1136 return (EFI_DEVICE_PATH_PROTOCOL
*) AcpiAdr
;
1140 Converts a generic messaging text device path node to messaging device path structure.
1142 @param TextDeviceNode The input Text device path node.
1144 @return A pointer to messaging device path structure.
1147 EFI_DEVICE_PATH_PROTOCOL
*
1148 DevPathFromTextMsg (
1149 IN CHAR16
*TextDeviceNode
1152 return DevPathFromTextGenericPath (MESSAGING_DEVICE_PATH
, TextDeviceNode
);
1156 Converts a text device path node to Parallel Port device path structure.
1158 @param TextDeviceNode The input Text device path node.
1160 @return A pointer to the newly-created Parallel Port device path structure.
1163 EFI_DEVICE_PATH_PROTOCOL
*
1164 DevPathFromTextAta (
1165 IN CHAR16
*TextDeviceNode
1168 CHAR16
*PrimarySecondaryStr
;
1169 CHAR16
*SlaveMasterStr
;
1171 ATAPI_DEVICE_PATH
*Atapi
;
1173 Atapi
= (ATAPI_DEVICE_PATH
*) CreateDeviceNode (
1174 MESSAGING_DEVICE_PATH
,
1176 (UINT16
) sizeof (ATAPI_DEVICE_PATH
)
1179 PrimarySecondaryStr
= GetNextParamStr (&TextDeviceNode
);
1180 SlaveMasterStr
= GetNextParamStr (&TextDeviceNode
);
1181 LunStr
= GetNextParamStr (&TextDeviceNode
);
1183 if (StrCmp (PrimarySecondaryStr
, L
"Primary") == 0) {
1184 Atapi
->PrimarySecondary
= 0;
1185 } else if (StrCmp (PrimarySecondaryStr
, L
"Secondary") == 0) {
1186 Atapi
->PrimarySecondary
= 1;
1188 Atapi
->PrimarySecondary
= (UINT8
) Strtoi (PrimarySecondaryStr
);
1190 if (StrCmp (SlaveMasterStr
, L
"Master") == 0) {
1191 Atapi
->SlaveMaster
= 0;
1192 } else if (StrCmp (SlaveMasterStr
, L
"Slave") == 0) {
1193 Atapi
->SlaveMaster
= 1;
1195 Atapi
->SlaveMaster
= (UINT8
) Strtoi (SlaveMasterStr
);
1198 Atapi
->Lun
= (UINT16
) Strtoi (LunStr
);
1200 return (EFI_DEVICE_PATH_PROTOCOL
*) Atapi
;
1204 Converts a text device path node to SCSI device path structure.
1206 @param TextDeviceNode The input Text device path node.
1208 @return A pointer to the newly-created SCSI device path structure.
1211 EFI_DEVICE_PATH_PROTOCOL
*
1212 DevPathFromTextScsi (
1213 IN CHAR16
*TextDeviceNode
1218 SCSI_DEVICE_PATH
*Scsi
;
1220 PunStr
= GetNextParamStr (&TextDeviceNode
);
1221 LunStr
= GetNextParamStr (&TextDeviceNode
);
1222 Scsi
= (SCSI_DEVICE_PATH
*) CreateDeviceNode (
1223 MESSAGING_DEVICE_PATH
,
1225 (UINT16
) sizeof (SCSI_DEVICE_PATH
)
1228 Scsi
->Pun
= (UINT16
) Strtoi (PunStr
);
1229 Scsi
->Lun
= (UINT16
) Strtoi (LunStr
);
1231 return (EFI_DEVICE_PATH_PROTOCOL
*) Scsi
;
1235 Converts a text device path node to Fibre device path structure.
1237 @param TextDeviceNode The input Text device path node.
1239 @return A pointer to the newly-created Fibre device path structure.
1242 EFI_DEVICE_PATH_PROTOCOL
*
1243 DevPathFromTextFibre (
1244 IN CHAR16
*TextDeviceNode
1249 FIBRECHANNEL_DEVICE_PATH
*Fibre
;
1251 WWNStr
= GetNextParamStr (&TextDeviceNode
);
1252 LunStr
= GetNextParamStr (&TextDeviceNode
);
1253 Fibre
= (FIBRECHANNEL_DEVICE_PATH
*) CreateDeviceNode (
1254 MESSAGING_DEVICE_PATH
,
1255 MSG_FIBRECHANNEL_DP
,
1256 (UINT16
) sizeof (FIBRECHANNEL_DEVICE_PATH
)
1259 Fibre
->Reserved
= 0;
1260 Strtoi64 (WWNStr
, &Fibre
->WWN
);
1261 Strtoi64 (LunStr
, &Fibre
->Lun
);
1263 return (EFI_DEVICE_PATH_PROTOCOL
*) Fibre
;
1267 Converts a text device path node to FibreEx device path structure.
1269 @param TextDeviceNode The input Text device path node.
1271 @return A pointer to the newly-created FibreEx device path structure.
1274 EFI_DEVICE_PATH_PROTOCOL
*
1275 DevPathFromTextFibreEx (
1276 IN CHAR16
*TextDeviceNode
1281 FIBRECHANNELEX_DEVICE_PATH
*FibreEx
;
1283 WWNStr
= GetNextParamStr (&TextDeviceNode
);
1284 LunStr
= GetNextParamStr (&TextDeviceNode
);
1285 FibreEx
= (FIBRECHANNELEX_DEVICE_PATH
*) CreateDeviceNode (
1286 MESSAGING_DEVICE_PATH
,
1287 MSG_FIBRECHANNELEX_DP
,
1288 (UINT16
) sizeof (FIBRECHANNELEX_DEVICE_PATH
)
1291 FibreEx
->Reserved
= 0;
1292 Strtoi64 (WWNStr
, (UINT64
*) (&FibreEx
->WWN
));
1293 Strtoi64 (LunStr
, (UINT64
*) (&FibreEx
->Lun
));
1295 *(UINT64
*) (&FibreEx
->WWN
) = SwapBytes64 (*(UINT64
*) (&FibreEx
->WWN
));
1296 *(UINT64
*) (&FibreEx
->Lun
) = SwapBytes64 (*(UINT64
*) (&FibreEx
->Lun
));
1298 return (EFI_DEVICE_PATH_PROTOCOL
*) FibreEx
;
1302 Converts a text device path node to 1394 device path structure.
1304 @param TextDeviceNode The input Text device path node.
1306 @return A pointer to the newly-created 1394 device path structure.
1309 EFI_DEVICE_PATH_PROTOCOL
*
1310 DevPathFromText1394 (
1311 IN CHAR16
*TextDeviceNode
1315 F1394_DEVICE_PATH
*F1394DevPath
;
1317 GuidStr
= GetNextParamStr (&TextDeviceNode
);
1318 F1394DevPath
= (F1394_DEVICE_PATH
*) CreateDeviceNode (
1319 MESSAGING_DEVICE_PATH
,
1321 (UINT16
) sizeof (F1394_DEVICE_PATH
)
1324 F1394DevPath
->Reserved
= 0;
1325 F1394DevPath
->Guid
= StrHexToUint64 (GuidStr
);
1327 return (EFI_DEVICE_PATH_PROTOCOL
*) F1394DevPath
;
1331 Converts a text device path node to USB device path structure.
1333 @param TextDeviceNode The input Text device path node.
1335 @return A pointer to the newly-created USB device path structure.
1338 EFI_DEVICE_PATH_PROTOCOL
*
1339 DevPathFromTextUsb (
1340 IN CHAR16
*TextDeviceNode
1344 CHAR16
*InterfaceStr
;
1345 USB_DEVICE_PATH
*Usb
;
1347 PortStr
= GetNextParamStr (&TextDeviceNode
);
1348 InterfaceStr
= GetNextParamStr (&TextDeviceNode
);
1349 Usb
= (USB_DEVICE_PATH
*) CreateDeviceNode (
1350 MESSAGING_DEVICE_PATH
,
1352 (UINT16
) sizeof (USB_DEVICE_PATH
)
1355 Usb
->ParentPortNumber
= (UINT8
) Strtoi (PortStr
);
1356 Usb
->InterfaceNumber
= (UINT8
) Strtoi (InterfaceStr
);
1358 return (EFI_DEVICE_PATH_PROTOCOL
*) Usb
;
1362 Converts a text device path node to I20 device path structure.
1364 @param TextDeviceNode The input Text device path node.
1366 @return A pointer to the newly-created I20 device path structure.
1369 EFI_DEVICE_PATH_PROTOCOL
*
1370 DevPathFromTextI2O (
1371 IN CHAR16
*TextDeviceNode
1375 I2O_DEVICE_PATH
*I2ODevPath
;
1377 TIDStr
= GetNextParamStr (&TextDeviceNode
);
1378 I2ODevPath
= (I2O_DEVICE_PATH
*) CreateDeviceNode (
1379 MESSAGING_DEVICE_PATH
,
1381 (UINT16
) sizeof (I2O_DEVICE_PATH
)
1384 I2ODevPath
->Tid
= (UINT32
) Strtoi (TIDStr
);
1386 return (EFI_DEVICE_PATH_PROTOCOL
*) I2ODevPath
;
1390 Converts a text device path node to Infini Band device path structure.
1392 @param TextDeviceNode The input Text device path node.
1394 @return A pointer to the newly-created Infini Band device path structure.
1397 EFI_DEVICE_PATH_PROTOCOL
*
1398 DevPathFromTextInfiniband (
1399 IN CHAR16
*TextDeviceNode
1408 INFINIBAND_DEVICE_PATH
*InfiniBand
;
1410 FlagsStr
= GetNextParamStr (&TextDeviceNode
);
1411 GuidStr
= GetNextParamStr (&TextDeviceNode
);
1412 SidStr
= GetNextParamStr (&TextDeviceNode
);
1413 TidStr
= GetNextParamStr (&TextDeviceNode
);
1414 DidStr
= GetNextParamStr (&TextDeviceNode
);
1415 InfiniBand
= (INFINIBAND_DEVICE_PATH
*) CreateDeviceNode (
1416 MESSAGING_DEVICE_PATH
,
1418 (UINT16
) sizeof (INFINIBAND_DEVICE_PATH
)
1421 InfiniBand
->ResourceFlags
= (UINT32
) Strtoi (FlagsStr
);
1422 StrToGuid (GuidStr
, &PortGid
);
1423 CopyMem (InfiniBand
->PortGid
, &PortGid
, sizeof (EFI_GUID
));
1424 Strtoi64 (SidStr
, &InfiniBand
->ServiceId
);
1425 Strtoi64 (TidStr
, &InfiniBand
->TargetPortId
);
1426 Strtoi64 (DidStr
, &InfiniBand
->DeviceId
);
1428 return (EFI_DEVICE_PATH_PROTOCOL
*) InfiniBand
;
1432 Converts a text device path node to Vendor-Defined Messaging device path structure.
1434 @param TextDeviceNode The input Text device path node.
1436 @return A pointer to the newly-created Vendor-Defined Messaging device path structure.
1439 EFI_DEVICE_PATH_PROTOCOL
*
1440 DevPathFromTextVenMsg (
1441 IN CHAR16
*TextDeviceNode
1444 return ConvertFromTextVendor (
1446 MESSAGING_DEVICE_PATH
,
1452 Converts a text device path node to Vendor defined PC-ANSI device path structure.
1454 @param TextDeviceNode The input Text device path node.
1456 @return A pointer to the newly-created Vendor defined PC-ANSI device path structure.
1459 EFI_DEVICE_PATH_PROTOCOL
*
1460 DevPathFromTextVenPcAnsi (
1461 IN CHAR16
*TextDeviceNode
1464 VENDOR_DEVICE_PATH
*Vendor
;
1466 Vendor
= (VENDOR_DEVICE_PATH
*) CreateDeviceNode (
1467 MESSAGING_DEVICE_PATH
,
1469 (UINT16
) sizeof (VENDOR_DEVICE_PATH
));
1470 CopyGuid (&Vendor
->Guid
, &gEfiPcAnsiGuid
);
1472 return (EFI_DEVICE_PATH_PROTOCOL
*) Vendor
;
1476 Converts a text device path node to Vendor defined VT100 device path structure.
1478 @param TextDeviceNode The input Text device path node.
1480 @return A pointer to the newly-created Vendor defined VT100 device path structure.
1483 EFI_DEVICE_PATH_PROTOCOL
*
1484 DevPathFromTextVenVt100 (
1485 IN CHAR16
*TextDeviceNode
1488 VENDOR_DEVICE_PATH
*Vendor
;
1490 Vendor
= (VENDOR_DEVICE_PATH
*) CreateDeviceNode (
1491 MESSAGING_DEVICE_PATH
,
1493 (UINT16
) sizeof (VENDOR_DEVICE_PATH
));
1494 CopyGuid (&Vendor
->Guid
, &gEfiVT100Guid
);
1496 return (EFI_DEVICE_PATH_PROTOCOL
*) Vendor
;
1500 Converts a text device path node to Vendor defined VT100 Plus device path structure.
1502 @param TextDeviceNode The input Text device path node.
1504 @return A pointer to the newly-created Vendor defined VT100 Plus device path structure.
1507 EFI_DEVICE_PATH_PROTOCOL
*
1508 DevPathFromTextVenVt100Plus (
1509 IN CHAR16
*TextDeviceNode
1512 VENDOR_DEVICE_PATH
*Vendor
;
1514 Vendor
= (VENDOR_DEVICE_PATH
*) CreateDeviceNode (
1515 MESSAGING_DEVICE_PATH
,
1517 (UINT16
) sizeof (VENDOR_DEVICE_PATH
));
1518 CopyGuid (&Vendor
->Guid
, &gEfiVT100PlusGuid
);
1520 return (EFI_DEVICE_PATH_PROTOCOL
*) Vendor
;
1524 Converts a text device path node to Vendor defined UTF8 device path structure.
1526 @param TextDeviceNode The input Text device path node.
1528 @return A pointer to the newly-created Vendor defined UTF8 device path structure.
1531 EFI_DEVICE_PATH_PROTOCOL
*
1532 DevPathFromTextVenUtf8 (
1533 IN CHAR16
*TextDeviceNode
1536 VENDOR_DEVICE_PATH
*Vendor
;
1538 Vendor
= (VENDOR_DEVICE_PATH
*) CreateDeviceNode (
1539 MESSAGING_DEVICE_PATH
,
1541 (UINT16
) sizeof (VENDOR_DEVICE_PATH
));
1542 CopyGuid (&Vendor
->Guid
, &gEfiVTUTF8Guid
);
1544 return (EFI_DEVICE_PATH_PROTOCOL
*) Vendor
;
1548 Converts a text device path node to UART Flow Control device path structure.
1550 @param TextDeviceNode The input Text device path node.
1552 @return A pointer to the newly-created UART Flow Control device path structure.
1555 EFI_DEVICE_PATH_PROTOCOL
*
1556 DevPathFromTextUartFlowCtrl (
1557 IN CHAR16
*TextDeviceNode
1561 UART_FLOW_CONTROL_DEVICE_PATH
*UartFlowControl
;
1563 ValueStr
= GetNextParamStr (&TextDeviceNode
);
1564 UartFlowControl
= (UART_FLOW_CONTROL_DEVICE_PATH
*) CreateDeviceNode (
1565 MESSAGING_DEVICE_PATH
,
1567 (UINT16
) sizeof (UART_FLOW_CONTROL_DEVICE_PATH
)
1570 CopyGuid (&UartFlowControl
->Guid
, &gEfiUartDevicePathGuid
);
1571 if (StrCmp (ValueStr
, L
"XonXoff") == 0) {
1572 UartFlowControl
->FlowControlMap
= 2;
1573 } else if (StrCmp (ValueStr
, L
"Hardware") == 0) {
1574 UartFlowControl
->FlowControlMap
= 1;
1576 UartFlowControl
->FlowControlMap
= 0;
1579 return (EFI_DEVICE_PATH_PROTOCOL
*) UartFlowControl
;
1583 Converts a text device path node to Serial Attached SCSI device path structure.
1585 @param TextDeviceNode The input Text device path node.
1587 @return A pointer to the newly-created Serial Attached SCSI device path structure.
1590 EFI_DEVICE_PATH_PROTOCOL
*
1591 DevPathFromTextSAS (
1592 IN CHAR16
*TextDeviceNode
1599 CHAR16
*LocationStr
;
1601 CHAR16
*DriveBayStr
;
1602 CHAR16
*ReservedStr
;
1605 SAS_DEVICE_PATH
*Sas
;
1607 AddressStr
= GetNextParamStr (&TextDeviceNode
);
1608 LunStr
= GetNextParamStr (&TextDeviceNode
);
1609 RTPStr
= GetNextParamStr (&TextDeviceNode
);
1610 SASSATAStr
= GetNextParamStr (&TextDeviceNode
);
1611 LocationStr
= GetNextParamStr (&TextDeviceNode
);
1612 ConnectStr
= GetNextParamStr (&TextDeviceNode
);
1613 DriveBayStr
= GetNextParamStr (&TextDeviceNode
);
1614 ReservedStr
= GetNextParamStr (&TextDeviceNode
);
1615 Sas
= (SAS_DEVICE_PATH
*) CreateDeviceNode (
1616 MESSAGING_DEVICE_PATH
,
1618 (UINT16
) sizeof (SAS_DEVICE_PATH
)
1621 CopyGuid (&Sas
->Guid
, &gEfiSasDevicePathGuid
);
1622 Strtoi64 (AddressStr
, &Sas
->SasAddress
);
1623 Strtoi64 (LunStr
, &Sas
->Lun
);
1624 Sas
->RelativeTargetPort
= (UINT16
) Strtoi (RTPStr
);
1626 if (StrCmp (SASSATAStr
, L
"NoTopology") == 0) {
1629 } else if ((StrCmp (SASSATAStr
, L
"SATA") == 0) || (StrCmp (SASSATAStr
, L
"SAS") == 0)) {
1631 Uint16
= (UINT16
) Strtoi (DriveBayStr
);
1635 Info
= (UINT16
) (0x2 | ((Uint16
- 1) << 8));
1638 if (StrCmp (SASSATAStr
, L
"SATA") == 0) {
1643 // Location is an integer between 0 and 1 or else
1644 // the keyword Internal (0) or External (1).
1646 if (StrCmp (LocationStr
, L
"External") == 0) {
1648 } else if (StrCmp (LocationStr
, L
"Internal") == 0) {
1651 Uint16
= ((UINT16
) Strtoi (LocationStr
) & BIT0
);
1653 Info
|= (Uint16
<< 5);
1656 // Connect is an integer between 0 and 3 or else
1657 // the keyword Direct (0) or Expanded (1).
1659 if (StrCmp (ConnectStr
, L
"Expanded") == 0) {
1661 } else if (StrCmp (ConnectStr
, L
"Direct") == 0) {
1664 Uint16
= ((UINT16
) Strtoi (ConnectStr
) & (BIT0
| BIT1
));
1666 Info
|= (Uint16
<< 6);
1669 Info
= (UINT16
) Strtoi (SASSATAStr
);
1672 Sas
->DeviceTopology
= Info
;
1673 Sas
->Reserved
= (UINT32
) Strtoi (ReservedStr
);
1675 return (EFI_DEVICE_PATH_PROTOCOL
*) Sas
;
1679 Converts a text device path node to Serial Attached SCSI Ex device path structure.
1681 @param TextDeviceNode The input Text device path node.
1683 @return A pointer to the newly-created Serial Attached SCSI Ex device path structure.
1686 EFI_DEVICE_PATH_PROTOCOL
*
1687 DevPathFromTextSasEx (
1688 IN CHAR16
*TextDeviceNode
1695 CHAR16
*LocationStr
;
1697 CHAR16
*DriveBayStr
;
1702 SASEX_DEVICE_PATH
*SasEx
;
1704 AddressStr
= GetNextParamStr (&TextDeviceNode
);
1705 LunStr
= GetNextParamStr (&TextDeviceNode
);
1706 RTPStr
= GetNextParamStr (&TextDeviceNode
);
1707 SASSATAStr
= GetNextParamStr (&TextDeviceNode
);
1708 LocationStr
= GetNextParamStr (&TextDeviceNode
);
1709 ConnectStr
= GetNextParamStr (&TextDeviceNode
);
1710 DriveBayStr
= GetNextParamStr (&TextDeviceNode
);
1711 SasEx
= (SASEX_DEVICE_PATH
*) CreateDeviceNode (
1712 MESSAGING_DEVICE_PATH
,
1714 (UINT16
) sizeof (SASEX_DEVICE_PATH
)
1717 Strtoi64 (AddressStr
, &SasAddress
);
1718 Strtoi64 (LunStr
, &Lun
);
1719 WriteUnaligned64 ((UINT64
*) &SasEx
->SasAddress
, SwapBytes64 (SasAddress
));
1720 WriteUnaligned64 ((UINT64
*) &SasEx
->Lun
, SwapBytes64 (Lun
));
1721 SasEx
->RelativeTargetPort
= (UINT16
) Strtoi (RTPStr
);
1723 if (StrCmp (SASSATAStr
, L
"NoTopology") == 0) {
1726 } else if ((StrCmp (SASSATAStr
, L
"SATA") == 0) || (StrCmp (SASSATAStr
, L
"SAS") == 0)) {
1728 Uint16
= (UINT16
) Strtoi (DriveBayStr
);
1732 Info
= (UINT16
) (0x2 | ((Uint16
- 1) << 8));
1735 if (StrCmp (SASSATAStr
, L
"SATA") == 0) {
1740 // Location is an integer between 0 and 1 or else
1741 // the keyword Internal (0) or External (1).
1743 if (StrCmp (LocationStr
, L
"External") == 0) {
1745 } else if (StrCmp (LocationStr
, L
"Internal") == 0) {
1748 Uint16
= ((UINT16
) Strtoi (LocationStr
) & BIT0
);
1750 Info
|= (Uint16
<< 5);
1753 // Connect is an integer between 0 and 3 or else
1754 // the keyword Direct (0) or Expanded (1).
1756 if (StrCmp (ConnectStr
, L
"Expanded") == 0) {
1758 } else if (StrCmp (ConnectStr
, L
"Direct") == 0) {
1761 Uint16
= ((UINT16
) Strtoi (ConnectStr
) & (BIT0
| BIT1
));
1763 Info
|= (Uint16
<< 6);
1766 Info
= (UINT16
) Strtoi (SASSATAStr
);
1769 SasEx
->DeviceTopology
= Info
;
1771 return (EFI_DEVICE_PATH_PROTOCOL
*) SasEx
;
1775 Converts a text device path node to Debug Port device path structure.
1777 @param TextDeviceNode The input Text device path node.
1779 @return A pointer to the newly-created Debug Port device path structure.
1782 EFI_DEVICE_PATH_PROTOCOL
*
1783 DevPathFromTextDebugPort (
1784 IN CHAR16
*TextDeviceNode
1787 VENDOR_DEFINED_MESSAGING_DEVICE_PATH
*Vend
;
1789 Vend
= (VENDOR_DEFINED_MESSAGING_DEVICE_PATH
*) CreateDeviceNode (
1790 MESSAGING_DEVICE_PATH
,
1792 (UINT16
) sizeof (VENDOR_DEFINED_MESSAGING_DEVICE_PATH
)
1795 CopyGuid (&Vend
->Guid
, &gEfiDebugPortProtocolGuid
);
1797 return (EFI_DEVICE_PATH_PROTOCOL
*) Vend
;
1801 Converts a text device path node to MAC device path structure.
1803 @param TextDeviceNode The input Text device path node.
1805 @return A pointer to the newly-created MAC device path structure.
1808 EFI_DEVICE_PATH_PROTOCOL
*
1809 DevPathFromTextMAC (
1810 IN CHAR16
*TextDeviceNode
1816 MAC_ADDR_DEVICE_PATH
*MACDevPath
;
1818 AddressStr
= GetNextParamStr (&TextDeviceNode
);
1819 IfTypeStr
= GetNextParamStr (&TextDeviceNode
);
1820 MACDevPath
= (MAC_ADDR_DEVICE_PATH
*) CreateDeviceNode (
1821 MESSAGING_DEVICE_PATH
,
1823 (UINT16
) sizeof (MAC_ADDR_DEVICE_PATH
)
1826 MACDevPath
->IfType
= (UINT8
) Strtoi (IfTypeStr
);
1828 Length
= sizeof (EFI_MAC_ADDRESS
);
1829 StrToBuf (&MACDevPath
->MacAddress
.Addr
[0], Length
, AddressStr
);
1831 return (EFI_DEVICE_PATH_PROTOCOL
*) MACDevPath
;
1836 Converts a text format to the network protocol ID.
1838 @param Text String of protocol field.
1840 @return Network protocol ID .
1844 NetworkProtocolFromText (
1848 if (StrCmp (Text
, L
"UDP") == 0) {
1849 return RFC_1700_UDP_PROTOCOL
;
1852 if (StrCmp (Text
, L
"TCP") == 0) {
1853 return RFC_1700_TCP_PROTOCOL
;
1856 return Strtoi (Text
);
1861 Converts a text device path node to IPV4 device path structure.
1863 @param TextDeviceNode The input Text device path node.
1865 @return A pointer to the newly-created IPV4 device path structure.
1868 EFI_DEVICE_PATH_PROTOCOL
*
1869 DevPathFromTextIPv4 (
1870 IN CHAR16
*TextDeviceNode
1873 CHAR16
*RemoteIPStr
;
1874 CHAR16
*ProtocolStr
;
1877 CHAR16
*GatewayIPStr
;
1878 CHAR16
*SubnetMaskStr
;
1879 IPv4_DEVICE_PATH
*IPv4
;
1881 RemoteIPStr
= GetNextParamStr (&TextDeviceNode
);
1882 ProtocolStr
= GetNextParamStr (&TextDeviceNode
);
1883 TypeStr
= GetNextParamStr (&TextDeviceNode
);
1884 LocalIPStr
= GetNextParamStr (&TextDeviceNode
);
1885 GatewayIPStr
= GetNextParamStr (&TextDeviceNode
);
1886 SubnetMaskStr
= GetNextParamStr (&TextDeviceNode
);
1887 IPv4
= (IPv4_DEVICE_PATH
*) CreateDeviceNode (
1888 MESSAGING_DEVICE_PATH
,
1890 (UINT16
) sizeof (IPv4_DEVICE_PATH
)
1893 StrToIPv4Addr (&RemoteIPStr
, &IPv4
->RemoteIpAddress
);
1894 IPv4
->Protocol
= (UINT16
) NetworkProtocolFromText (ProtocolStr
);
1895 if (StrCmp (TypeStr
, L
"Static") == 0) {
1896 IPv4
->StaticIpAddress
= TRUE
;
1898 IPv4
->StaticIpAddress
= FALSE
;
1901 StrToIPv4Addr (&LocalIPStr
, &IPv4
->LocalIpAddress
);
1902 if (!IS_NULL (*GatewayIPStr
) && !IS_NULL (*SubnetMaskStr
)) {
1903 StrToIPv4Addr (&GatewayIPStr
, &IPv4
->GatewayIpAddress
);
1904 StrToIPv4Addr (&SubnetMaskStr
, &IPv4
->SubnetMask
);
1906 ZeroMem (&IPv4
->GatewayIpAddress
, sizeof (IPv4
->GatewayIpAddress
));
1907 ZeroMem (&IPv4
->SubnetMask
, sizeof (IPv4
->SubnetMask
));
1910 IPv4
->LocalPort
= 0;
1911 IPv4
->RemotePort
= 0;
1913 return (EFI_DEVICE_PATH_PROTOCOL
*) IPv4
;
1917 Converts a text device path node to IPV6 device path structure.
1919 @param TextDeviceNode The input Text device path node.
1921 @return A pointer to the newly-created IPV6 device path structure.
1924 EFI_DEVICE_PATH_PROTOCOL
*
1925 DevPathFromTextIPv6 (
1926 IN CHAR16
*TextDeviceNode
1929 CHAR16
*RemoteIPStr
;
1930 CHAR16
*ProtocolStr
;
1933 CHAR16
*GatewayIPStr
;
1934 CHAR16
*PrefixLengthStr
;
1935 IPv6_DEVICE_PATH
*IPv6
;
1937 RemoteIPStr
= GetNextParamStr (&TextDeviceNode
);
1938 ProtocolStr
= GetNextParamStr (&TextDeviceNode
);
1939 TypeStr
= GetNextParamStr (&TextDeviceNode
);
1940 LocalIPStr
= GetNextParamStr (&TextDeviceNode
);
1941 PrefixLengthStr
= GetNextParamStr (&TextDeviceNode
);
1942 GatewayIPStr
= GetNextParamStr (&TextDeviceNode
);
1943 IPv6
= (IPv6_DEVICE_PATH
*) CreateDeviceNode (
1944 MESSAGING_DEVICE_PATH
,
1946 (UINT16
) sizeof (IPv6_DEVICE_PATH
)
1949 StrToIPv6Addr (&RemoteIPStr
, &IPv6
->RemoteIpAddress
);
1950 IPv6
->Protocol
= (UINT16
) NetworkProtocolFromText (ProtocolStr
);
1951 if (StrCmp (TypeStr
, L
"Static") == 0) {
1952 IPv6
->IpAddressOrigin
= 0;
1953 } else if (StrCmp (TypeStr
, L
"StatelessAutoConfigure") == 0) {
1954 IPv6
->IpAddressOrigin
= 1;
1956 IPv6
->IpAddressOrigin
= 2;
1959 StrToIPv6Addr (&LocalIPStr
, &IPv6
->LocalIpAddress
);
1960 if (!IS_NULL (*GatewayIPStr
) && !IS_NULL (*PrefixLengthStr
)) {
1961 StrToIPv6Addr (&GatewayIPStr
, &IPv6
->GatewayIpAddress
);
1962 IPv6
->PrefixLength
= (UINT8
) Strtoi (PrefixLengthStr
);
1964 ZeroMem (&IPv6
->GatewayIpAddress
, sizeof (IPv6
->GatewayIpAddress
));
1965 IPv6
->PrefixLength
= 0;
1968 IPv6
->LocalPort
= 0;
1969 IPv6
->RemotePort
= 0;
1971 return (EFI_DEVICE_PATH_PROTOCOL
*) IPv6
;
1975 Converts a text device path node to UART device path structure.
1977 @param TextDeviceNode The input Text device path node.
1979 @return A pointer to the newly-created UART device path structure.
1982 EFI_DEVICE_PATH_PROTOCOL
*
1983 DevPathFromTextUart (
1984 IN CHAR16
*TextDeviceNode
1988 CHAR16
*DataBitsStr
;
1990 CHAR16
*StopBitsStr
;
1991 UART_DEVICE_PATH
*Uart
;
1993 BaudStr
= GetNextParamStr (&TextDeviceNode
);
1994 DataBitsStr
= GetNextParamStr (&TextDeviceNode
);
1995 ParityStr
= GetNextParamStr (&TextDeviceNode
);
1996 StopBitsStr
= GetNextParamStr (&TextDeviceNode
);
1997 Uart
= (UART_DEVICE_PATH
*) CreateDeviceNode (
1998 MESSAGING_DEVICE_PATH
,
2000 (UINT16
) sizeof (UART_DEVICE_PATH
)
2003 if (StrCmp (BaudStr
, L
"DEFAULT") == 0) {
2004 Uart
->BaudRate
= 115200;
2006 Strtoi64 (BaudStr
, &Uart
->BaudRate
);
2008 Uart
->DataBits
= (UINT8
) ((StrCmp (DataBitsStr
, L
"DEFAULT") == 0) ? 8 : Strtoi (DataBitsStr
));
2009 switch (*ParityStr
) {
2035 Uart
->Parity
= (UINT8
) Strtoi (ParityStr
);
2039 if (StrCmp (StopBitsStr
, L
"D") == 0) {
2040 Uart
->StopBits
= (UINT8
) 0;
2041 } else if (StrCmp (StopBitsStr
, L
"1") == 0) {
2042 Uart
->StopBits
= (UINT8
) 1;
2043 } else if (StrCmp (StopBitsStr
, L
"1.5") == 0) {
2044 Uart
->StopBits
= (UINT8
) 2;
2045 } else if (StrCmp (StopBitsStr
, L
"2") == 0) {
2046 Uart
->StopBits
= (UINT8
) 3;
2048 Uart
->StopBits
= (UINT8
) Strtoi (StopBitsStr
);
2051 return (EFI_DEVICE_PATH_PROTOCOL
*) Uart
;
2055 Converts a text device path node to USB class device path structure.
2057 @param TextDeviceNode The input Text device path node.
2058 @param UsbClassText A pointer to USB_CLASS_TEXT structure to be integrated to USB Class Text.
2060 @return A pointer to the newly-created USB class device path structure.
2063 EFI_DEVICE_PATH_PROTOCOL
*
2064 ConvertFromTextUsbClass (
2065 IN CHAR16
*TextDeviceNode
,
2066 IN USB_CLASS_TEXT
*UsbClassText
2072 CHAR16
*SubClassStr
;
2073 CHAR16
*ProtocolStr
;
2074 USB_CLASS_DEVICE_PATH
*UsbClass
;
2076 UsbClass
= (USB_CLASS_DEVICE_PATH
*) CreateDeviceNode (
2077 MESSAGING_DEVICE_PATH
,
2079 (UINT16
) sizeof (USB_CLASS_DEVICE_PATH
)
2082 VIDStr
= GetNextParamStr (&TextDeviceNode
);
2083 PIDStr
= GetNextParamStr (&TextDeviceNode
);
2084 if (UsbClassText
->ClassExist
) {
2085 ClassStr
= GetNextParamStr (&TextDeviceNode
);
2086 UsbClass
->DeviceClass
= (UINT8
) Strtoi (ClassStr
);
2088 UsbClass
->DeviceClass
= UsbClassText
->Class
;
2090 if (UsbClassText
->SubClassExist
) {
2091 SubClassStr
= GetNextParamStr (&TextDeviceNode
);
2092 UsbClass
->DeviceSubClass
= (UINT8
) Strtoi (SubClassStr
);
2094 UsbClass
->DeviceSubClass
= UsbClassText
->SubClass
;
2097 ProtocolStr
= GetNextParamStr (&TextDeviceNode
);
2099 UsbClass
->VendorId
= (UINT16
) Strtoi (VIDStr
);
2100 UsbClass
->ProductId
= (UINT16
) Strtoi (PIDStr
);
2101 UsbClass
->DeviceProtocol
= (UINT8
) Strtoi (ProtocolStr
);
2103 return (EFI_DEVICE_PATH_PROTOCOL
*) UsbClass
;
2108 Converts a text device path node to USB class device path structure.
2110 @param TextDeviceNode The input Text device path node.
2112 @return A pointer to the newly-created USB class device path structure.
2115 EFI_DEVICE_PATH_PROTOCOL
*
2116 DevPathFromTextUsbClass (
2117 IN CHAR16
*TextDeviceNode
2120 USB_CLASS_TEXT UsbClassText
;
2122 UsbClassText
.ClassExist
= TRUE
;
2123 UsbClassText
.SubClassExist
= TRUE
;
2125 return ConvertFromTextUsbClass (TextDeviceNode
, &UsbClassText
);
2129 Converts a text device path node to USB audio device path structure.
2131 @param TextDeviceNode The input Text device path node.
2133 @return A pointer to the newly-created USB audio device path structure.
2136 EFI_DEVICE_PATH_PROTOCOL
*
2137 DevPathFromTextUsbAudio (
2138 IN CHAR16
*TextDeviceNode
2141 USB_CLASS_TEXT UsbClassText
;
2143 UsbClassText
.ClassExist
= FALSE
;
2144 UsbClassText
.Class
= USB_CLASS_AUDIO
;
2145 UsbClassText
.SubClassExist
= TRUE
;
2147 return ConvertFromTextUsbClass (TextDeviceNode
, &UsbClassText
);
2151 Converts a text device path node to USB CDC Control device path structure.
2153 @param TextDeviceNode The input Text device path node.
2155 @return A pointer to the newly-created USB CDC Control device path structure.
2158 EFI_DEVICE_PATH_PROTOCOL
*
2159 DevPathFromTextUsbCDCControl (
2160 IN CHAR16
*TextDeviceNode
2163 USB_CLASS_TEXT UsbClassText
;
2165 UsbClassText
.ClassExist
= FALSE
;
2166 UsbClassText
.Class
= USB_CLASS_CDCCONTROL
;
2167 UsbClassText
.SubClassExist
= TRUE
;
2169 return ConvertFromTextUsbClass (TextDeviceNode
, &UsbClassText
);
2173 Converts a text device path node to USB HID device path structure.
2175 @param TextDeviceNode The input Text device path node.
2177 @return A pointer to the newly-created USB HID device path structure.
2180 EFI_DEVICE_PATH_PROTOCOL
*
2181 DevPathFromTextUsbHID (
2182 IN CHAR16
*TextDeviceNode
2185 USB_CLASS_TEXT UsbClassText
;
2187 UsbClassText
.ClassExist
= FALSE
;
2188 UsbClassText
.Class
= USB_CLASS_HID
;
2189 UsbClassText
.SubClassExist
= TRUE
;
2191 return ConvertFromTextUsbClass (TextDeviceNode
, &UsbClassText
);
2195 Converts a text device path node to USB Image device path structure.
2197 @param TextDeviceNode The input Text device path node.
2199 @return A pointer to the newly-created USB Image device path structure.
2202 EFI_DEVICE_PATH_PROTOCOL
*
2203 DevPathFromTextUsbImage (
2204 IN CHAR16
*TextDeviceNode
2207 USB_CLASS_TEXT UsbClassText
;
2209 UsbClassText
.ClassExist
= FALSE
;
2210 UsbClassText
.Class
= USB_CLASS_IMAGE
;
2211 UsbClassText
.SubClassExist
= TRUE
;
2213 return ConvertFromTextUsbClass (TextDeviceNode
, &UsbClassText
);
2217 Converts a text device path node to USB Print device path structure.
2219 @param TextDeviceNode The input Text device path node.
2221 @return A pointer to the newly-created USB Print device path structure.
2224 EFI_DEVICE_PATH_PROTOCOL
*
2225 DevPathFromTextUsbPrinter (
2226 IN CHAR16
*TextDeviceNode
2229 USB_CLASS_TEXT UsbClassText
;
2231 UsbClassText
.ClassExist
= FALSE
;
2232 UsbClassText
.Class
= USB_CLASS_PRINTER
;
2233 UsbClassText
.SubClassExist
= TRUE
;
2235 return ConvertFromTextUsbClass (TextDeviceNode
, &UsbClassText
);
2239 Converts a text device path node to USB mass storage device path structure.
2241 @param TextDeviceNode The input Text device path node.
2243 @return A pointer to the newly-created USB mass storage device path structure.
2246 EFI_DEVICE_PATH_PROTOCOL
*
2247 DevPathFromTextUsbMassStorage (
2248 IN CHAR16
*TextDeviceNode
2251 USB_CLASS_TEXT UsbClassText
;
2253 UsbClassText
.ClassExist
= FALSE
;
2254 UsbClassText
.Class
= USB_CLASS_MASS_STORAGE
;
2255 UsbClassText
.SubClassExist
= TRUE
;
2257 return ConvertFromTextUsbClass (TextDeviceNode
, &UsbClassText
);
2261 Converts a text device path node to USB HUB device path structure.
2263 @param TextDeviceNode The input Text device path node.
2265 @return A pointer to the newly-created USB HUB device path structure.
2268 EFI_DEVICE_PATH_PROTOCOL
*
2269 DevPathFromTextUsbHub (
2270 IN CHAR16
*TextDeviceNode
2273 USB_CLASS_TEXT UsbClassText
;
2275 UsbClassText
.ClassExist
= FALSE
;
2276 UsbClassText
.Class
= USB_CLASS_HUB
;
2277 UsbClassText
.SubClassExist
= TRUE
;
2279 return ConvertFromTextUsbClass (TextDeviceNode
, &UsbClassText
);
2283 Converts a text device path node to USB CDC data device path structure.
2285 @param TextDeviceNode The input Text device path node.
2287 @return A pointer to the newly-created USB CDC data device path structure.
2290 EFI_DEVICE_PATH_PROTOCOL
*
2291 DevPathFromTextUsbCDCData (
2292 IN CHAR16
*TextDeviceNode
2295 USB_CLASS_TEXT UsbClassText
;
2297 UsbClassText
.ClassExist
= FALSE
;
2298 UsbClassText
.Class
= USB_CLASS_CDCDATA
;
2299 UsbClassText
.SubClassExist
= TRUE
;
2301 return ConvertFromTextUsbClass (TextDeviceNode
, &UsbClassText
);
2305 Converts a text device path node to USB smart card device path structure.
2307 @param TextDeviceNode The input Text device path node.
2309 @return A pointer to the newly-created USB smart card device path structure.
2312 EFI_DEVICE_PATH_PROTOCOL
*
2313 DevPathFromTextUsbSmartCard (
2314 IN CHAR16
*TextDeviceNode
2317 USB_CLASS_TEXT UsbClassText
;
2319 UsbClassText
.ClassExist
= FALSE
;
2320 UsbClassText
.Class
= USB_CLASS_SMART_CARD
;
2321 UsbClassText
.SubClassExist
= TRUE
;
2323 return ConvertFromTextUsbClass (TextDeviceNode
, &UsbClassText
);
2327 Converts a text device path node to USB video device path structure.
2329 @param TextDeviceNode The input Text device path node.
2331 @return A pointer to the newly-created USB video device path structure.
2334 EFI_DEVICE_PATH_PROTOCOL
*
2335 DevPathFromTextUsbVideo (
2336 IN CHAR16
*TextDeviceNode
2339 USB_CLASS_TEXT UsbClassText
;
2341 UsbClassText
.ClassExist
= FALSE
;
2342 UsbClassText
.Class
= USB_CLASS_VIDEO
;
2343 UsbClassText
.SubClassExist
= TRUE
;
2345 return ConvertFromTextUsbClass (TextDeviceNode
, &UsbClassText
);
2349 Converts a text device path node to USB diagnostic device path structure.
2351 @param TextDeviceNode The input Text device path node.
2353 @return A pointer to the newly-created USB diagnostic device path structure.
2356 EFI_DEVICE_PATH_PROTOCOL
*
2357 DevPathFromTextUsbDiagnostic (
2358 IN CHAR16
*TextDeviceNode
2361 USB_CLASS_TEXT UsbClassText
;
2363 UsbClassText
.ClassExist
= FALSE
;
2364 UsbClassText
.Class
= USB_CLASS_DIAGNOSTIC
;
2365 UsbClassText
.SubClassExist
= TRUE
;
2367 return ConvertFromTextUsbClass (TextDeviceNode
, &UsbClassText
);
2371 Converts a text device path node to USB wireless device path structure.
2373 @param TextDeviceNode The input Text device path node.
2375 @return A pointer to the newly-created USB wireless device path structure.
2378 EFI_DEVICE_PATH_PROTOCOL
*
2379 DevPathFromTextUsbWireless (
2380 IN CHAR16
*TextDeviceNode
2383 USB_CLASS_TEXT UsbClassText
;
2385 UsbClassText
.ClassExist
= FALSE
;
2386 UsbClassText
.Class
= USB_CLASS_WIRELESS
;
2387 UsbClassText
.SubClassExist
= TRUE
;
2389 return ConvertFromTextUsbClass (TextDeviceNode
, &UsbClassText
);
2393 Converts a text device path node to USB device firmware update device path structure.
2395 @param TextDeviceNode The input Text device path node.
2397 @return A pointer to the newly-created USB device firmware update device path structure.
2400 EFI_DEVICE_PATH_PROTOCOL
*
2401 DevPathFromTextUsbDeviceFirmwareUpdate (
2402 IN CHAR16
*TextDeviceNode
2405 USB_CLASS_TEXT UsbClassText
;
2407 UsbClassText
.ClassExist
= FALSE
;
2408 UsbClassText
.Class
= USB_CLASS_RESERVE
;
2409 UsbClassText
.SubClassExist
= FALSE
;
2410 UsbClassText
.SubClass
= USB_SUBCLASS_FW_UPDATE
;
2412 return ConvertFromTextUsbClass (TextDeviceNode
, &UsbClassText
);
2416 Converts a text device path node to USB IRDA bridge device path structure.
2418 @param TextDeviceNode The input Text device path node.
2420 @return A pointer to the newly-created USB IRDA bridge device path structure.
2423 EFI_DEVICE_PATH_PROTOCOL
*
2424 DevPathFromTextUsbIrdaBridge (
2425 IN CHAR16
*TextDeviceNode
2428 USB_CLASS_TEXT UsbClassText
;
2430 UsbClassText
.ClassExist
= FALSE
;
2431 UsbClassText
.Class
= USB_CLASS_RESERVE
;
2432 UsbClassText
.SubClassExist
= FALSE
;
2433 UsbClassText
.SubClass
= USB_SUBCLASS_IRDA_BRIDGE
;
2435 return ConvertFromTextUsbClass (TextDeviceNode
, &UsbClassText
);
2439 Converts a text device path node to USB text and measurement device path structure.
2441 @param TextDeviceNode The input Text device path node.
2443 @return A pointer to the newly-created USB text and measurement device path structure.
2446 EFI_DEVICE_PATH_PROTOCOL
*
2447 DevPathFromTextUsbTestAndMeasurement (
2448 IN CHAR16
*TextDeviceNode
2451 USB_CLASS_TEXT UsbClassText
;
2453 UsbClassText
.ClassExist
= FALSE
;
2454 UsbClassText
.Class
= USB_CLASS_RESERVE
;
2455 UsbClassText
.SubClassExist
= FALSE
;
2456 UsbClassText
.SubClass
= USB_SUBCLASS_TEST
;
2458 return ConvertFromTextUsbClass (TextDeviceNode
, &UsbClassText
);
2462 Converts a text device path node to USB WWID device path structure.
2464 @param TextDeviceNode The input Text device path node.
2466 @return A pointer to the newly-created USB WWID device path structure.
2469 EFI_DEVICE_PATH_PROTOCOL
*
2470 DevPathFromTextUsbWwid (
2471 IN CHAR16
*TextDeviceNode
2476 CHAR16
*InterfaceNumStr
;
2477 CHAR16
*SerialNumberStr
;
2478 USB_WWID_DEVICE_PATH
*UsbWwid
;
2479 UINTN SerialNumberStrLen
;
2481 VIDStr
= GetNextParamStr (&TextDeviceNode
);
2482 PIDStr
= GetNextParamStr (&TextDeviceNode
);
2483 InterfaceNumStr
= GetNextParamStr (&TextDeviceNode
);
2484 SerialNumberStr
= GetNextParamStr (&TextDeviceNode
);
2485 SerialNumberStrLen
= StrLen (SerialNumberStr
);
2486 if (SerialNumberStrLen
>= 2 &&
2487 SerialNumberStr
[0] == L
'\"' &&
2488 SerialNumberStr
[SerialNumberStrLen
- 1] == L
'\"'
2490 SerialNumberStr
[SerialNumberStrLen
- 1] = L
'\0';
2492 SerialNumberStrLen
-= 2;
2494 UsbWwid
= (USB_WWID_DEVICE_PATH
*) CreateDeviceNode (
2495 MESSAGING_DEVICE_PATH
,
2497 (UINT16
) (sizeof (USB_WWID_DEVICE_PATH
) + SerialNumberStrLen
* sizeof (CHAR16
))
2499 UsbWwid
->VendorId
= (UINT16
) Strtoi (VIDStr
);
2500 UsbWwid
->ProductId
= (UINT16
) Strtoi (PIDStr
);
2501 UsbWwid
->InterfaceNumber
= (UINT16
) Strtoi (InterfaceNumStr
);
2502 StrnCpy ((CHAR16
*) ((UINT8
*) UsbWwid
+ sizeof (USB_WWID_DEVICE_PATH
)), SerialNumberStr
, SerialNumberStrLen
);
2504 return (EFI_DEVICE_PATH_PROTOCOL
*) UsbWwid
;
2508 Converts a text device path node to Logic Unit device path structure.
2510 @param TextDeviceNode The input Text device path node.
2512 @return A pointer to the newly-created Logic Unit device path structure.
2515 EFI_DEVICE_PATH_PROTOCOL
*
2516 DevPathFromTextUnit (
2517 IN CHAR16
*TextDeviceNode
2521 DEVICE_LOGICAL_UNIT_DEVICE_PATH
*LogicalUnit
;
2523 LunStr
= GetNextParamStr (&TextDeviceNode
);
2524 LogicalUnit
= (DEVICE_LOGICAL_UNIT_DEVICE_PATH
*) CreateDeviceNode (
2525 MESSAGING_DEVICE_PATH
,
2526 MSG_DEVICE_LOGICAL_UNIT_DP
,
2527 (UINT16
) sizeof (DEVICE_LOGICAL_UNIT_DEVICE_PATH
)
2530 LogicalUnit
->Lun
= (UINT8
) Strtoi (LunStr
);
2532 return (EFI_DEVICE_PATH_PROTOCOL
*) LogicalUnit
;
2536 Converts a text device path node to iSCSI device path structure.
2538 @param TextDeviceNode The input Text device path node.
2540 @return A pointer to the newly-created iSCSI device path structure.
2543 EFI_DEVICE_PATH_PROTOCOL
*
2544 DevPathFromTextiSCSI (
2545 IN CHAR16
*TextDeviceNode
2550 CHAR16
*PortalGroupStr
;
2552 CHAR16
*HeaderDigestStr
;
2553 CHAR16
*DataDigestStr
;
2554 CHAR16
*AuthenticationStr
;
2555 CHAR16
*ProtocolStr
;
2557 ISCSI_DEVICE_PATH_WITH_NAME
*ISCSIDevPath
;
2559 NameStr
= GetNextParamStr (&TextDeviceNode
);
2560 PortalGroupStr
= GetNextParamStr (&TextDeviceNode
);
2561 LunStr
= GetNextParamStr (&TextDeviceNode
);
2562 HeaderDigestStr
= GetNextParamStr (&TextDeviceNode
);
2563 DataDigestStr
= GetNextParamStr (&TextDeviceNode
);
2564 AuthenticationStr
= GetNextParamStr (&TextDeviceNode
);
2565 ProtocolStr
= GetNextParamStr (&TextDeviceNode
);
2566 ISCSIDevPath
= (ISCSI_DEVICE_PATH_WITH_NAME
*) CreateDeviceNode (
2567 MESSAGING_DEVICE_PATH
,
2569 (UINT16
) (sizeof (ISCSI_DEVICE_PATH_WITH_NAME
) + StrLen (NameStr
))
2572 AsciiStr
= ISCSIDevPath
->TargetName
;
2573 StrToAscii (NameStr
, &AsciiStr
);
2575 ISCSIDevPath
->TargetPortalGroupTag
= (UINT16
) Strtoi (PortalGroupStr
);
2576 Strtoi64 (LunStr
, &ISCSIDevPath
->Lun
);
2579 if (StrCmp (HeaderDigestStr
, L
"CRC32C") == 0) {
2583 if (StrCmp (DataDigestStr
, L
"CRC32C") == 0) {
2587 if (StrCmp (AuthenticationStr
, L
"None") == 0) {
2591 if (StrCmp (AuthenticationStr
, L
"CHAP_UNI") == 0) {
2595 ISCSIDevPath
->LoginOption
= (UINT16
) Options
;
2597 ISCSIDevPath
->NetworkProtocol
= (UINT16
) StrCmp (ProtocolStr
, L
"TCP");
2599 return (EFI_DEVICE_PATH_PROTOCOL
*) ISCSIDevPath
;
2603 Converts a text device path node to VLAN device path structure.
2605 @param TextDeviceNode The input Text device path node.
2607 @return A pointer to the newly-created VLAN device path structure.
2610 EFI_DEVICE_PATH_PROTOCOL
*
2611 DevPathFromTextVlan (
2612 IN CHAR16
*TextDeviceNode
2616 VLAN_DEVICE_PATH
*Vlan
;
2618 VlanStr
= GetNextParamStr (&TextDeviceNode
);
2619 Vlan
= (VLAN_DEVICE_PATH
*) CreateDeviceNode (
2620 MESSAGING_DEVICE_PATH
,
2622 (UINT16
) sizeof (VLAN_DEVICE_PATH
)
2625 Vlan
->VlanId
= (UINT16
) Strtoi (VlanStr
);
2627 return (EFI_DEVICE_PATH_PROTOCOL
*) Vlan
;
2631 Converts a media text device path node to media device path structure.
2633 @param TextDeviceNode The input Text device path node.
2635 @return A pointer to media device path structure.
2638 EFI_DEVICE_PATH_PROTOCOL
*
2639 DevPathFromTextMediaPath (
2640 IN CHAR16
*TextDeviceNode
2643 return DevPathFromTextGenericPath (MEDIA_DEVICE_PATH
, TextDeviceNode
);
2647 Converts a text device path node to HD device path structure.
2649 @param TextDeviceNode The input Text device path node.
2651 @return A pointer to the newly-created HD device path structure.
2654 EFI_DEVICE_PATH_PROTOCOL
*
2656 IN CHAR16
*TextDeviceNode
2659 CHAR16
*PartitionStr
;
2661 CHAR16
*SignatureStr
;
2665 EFI_GUID SignatureGuid
;
2666 HARDDRIVE_DEVICE_PATH
*Hd
;
2668 PartitionStr
= GetNextParamStr (&TextDeviceNode
);
2669 TypeStr
= GetNextParamStr (&TextDeviceNode
);
2670 SignatureStr
= GetNextParamStr (&TextDeviceNode
);
2671 StartStr
= GetNextParamStr (&TextDeviceNode
);
2672 SizeStr
= GetNextParamStr (&TextDeviceNode
);
2673 Hd
= (HARDDRIVE_DEVICE_PATH
*) CreateDeviceNode (
2676 (UINT16
) sizeof (HARDDRIVE_DEVICE_PATH
)
2679 Hd
->PartitionNumber
= (UINT32
) Strtoi (PartitionStr
);
2681 ZeroMem (Hd
->Signature
, 16);
2682 Hd
->MBRType
= (UINT8
) 0;
2684 if (StrCmp (TypeStr
, L
"MBR") == 0) {
2685 Hd
->SignatureType
= SIGNATURE_TYPE_MBR
;
2688 Signature32
= (UINT32
) Strtoi (SignatureStr
);
2689 CopyMem (Hd
->Signature
, &Signature32
, sizeof (UINT32
));
2690 } else if (StrCmp (TypeStr
, L
"GPT") == 0) {
2691 Hd
->SignatureType
= SIGNATURE_TYPE_GUID
;
2694 StrToGuid (SignatureStr
, &SignatureGuid
);
2695 CopyMem (Hd
->Signature
, &SignatureGuid
, sizeof (EFI_GUID
));
2697 Hd
->SignatureType
= (UINT8
) Strtoi (TypeStr
);
2700 Strtoi64 (StartStr
, &Hd
->PartitionStart
);
2701 Strtoi64 (SizeStr
, &Hd
->PartitionSize
);
2703 return (EFI_DEVICE_PATH_PROTOCOL
*) Hd
;
2707 Converts a text device path node to CDROM device path structure.
2709 @param TextDeviceNode The input Text device path node.
2711 @return A pointer to the newly-created CDROM device path structure.
2714 EFI_DEVICE_PATH_PROTOCOL
*
2715 DevPathFromTextCDROM (
2716 IN CHAR16
*TextDeviceNode
2722 CDROM_DEVICE_PATH
*CDROMDevPath
;
2724 EntryStr
= GetNextParamStr (&TextDeviceNode
);
2725 StartStr
= GetNextParamStr (&TextDeviceNode
);
2726 SizeStr
= GetNextParamStr (&TextDeviceNode
);
2727 CDROMDevPath
= (CDROM_DEVICE_PATH
*) CreateDeviceNode (
2730 (UINT16
) sizeof (CDROM_DEVICE_PATH
)
2733 CDROMDevPath
->BootEntry
= (UINT32
) Strtoi (EntryStr
);
2734 Strtoi64 (StartStr
, &CDROMDevPath
->PartitionStart
);
2735 Strtoi64 (SizeStr
, &CDROMDevPath
->PartitionSize
);
2737 return (EFI_DEVICE_PATH_PROTOCOL
*) CDROMDevPath
;
2741 Converts a text device path node to Vendor-defined media device path structure.
2743 @param TextDeviceNode The input Text device path node.
2745 @return A pointer to the newly-created Vendor-defined media device path structure.
2748 EFI_DEVICE_PATH_PROTOCOL
*
2749 DevPathFromTextVenMedia (
2750 IN CHAR16
*TextDeviceNode
2753 return ConvertFromTextVendor (
2761 Converts a text device path node to File device path structure.
2763 @param TextDeviceNode The input Text device path node.
2765 @return A pointer to the newly-created File device path structure.
2768 EFI_DEVICE_PATH_PROTOCOL
*
2769 DevPathFromTextFilePath (
2770 IN CHAR16
*TextDeviceNode
2773 FILEPATH_DEVICE_PATH
*File
;
2775 File
= (FILEPATH_DEVICE_PATH
*) CreateDeviceNode (
2778 (UINT16
) (sizeof (FILEPATH_DEVICE_PATH
) + StrLen (TextDeviceNode
) * 2)
2781 StrCpy (File
->PathName
, TextDeviceNode
);
2783 return (EFI_DEVICE_PATH_PROTOCOL
*) File
;
2787 Converts a text device path node to Media protocol device path structure.
2789 @param TextDeviceNode The input Text device path node.
2791 @return A pointer to the newly-created Media protocol device path structure.
2794 EFI_DEVICE_PATH_PROTOCOL
*
2795 DevPathFromTextMedia (
2796 IN CHAR16
*TextDeviceNode
2800 MEDIA_PROTOCOL_DEVICE_PATH
*Media
;
2802 GuidStr
= GetNextParamStr (&TextDeviceNode
);
2803 Media
= (MEDIA_PROTOCOL_DEVICE_PATH
*) CreateDeviceNode (
2806 (UINT16
) sizeof (MEDIA_PROTOCOL_DEVICE_PATH
)
2809 StrToGuid (GuidStr
, &Media
->Protocol
);
2811 return (EFI_DEVICE_PATH_PROTOCOL
*) Media
;
2815 Converts a text device path node to firmware volume device path structure.
2817 @param TextDeviceNode The input Text device path node.
2819 @return A pointer to the newly-created firmware volume device path structure.
2822 EFI_DEVICE_PATH_PROTOCOL
*
2824 IN CHAR16
*TextDeviceNode
2828 MEDIA_FW_VOL_DEVICE_PATH
*Fv
;
2830 GuidStr
= GetNextParamStr (&TextDeviceNode
);
2831 Fv
= (MEDIA_FW_VOL_DEVICE_PATH
*) CreateDeviceNode (
2833 MEDIA_PIWG_FW_VOL_DP
,
2834 (UINT16
) sizeof (MEDIA_FW_VOL_DEVICE_PATH
)
2837 StrToGuid (GuidStr
, &Fv
->FvName
);
2839 return (EFI_DEVICE_PATH_PROTOCOL
*) Fv
;
2843 Converts a text device path node to firmware file device path structure.
2845 @param TextDeviceNode The input Text device path node.
2847 @return A pointer to the newly-created firmware file device path structure.
2850 EFI_DEVICE_PATH_PROTOCOL
*
2851 DevPathFromTextFvFile (
2852 IN CHAR16
*TextDeviceNode
2856 MEDIA_FW_VOL_FILEPATH_DEVICE_PATH
*FvFile
;
2858 GuidStr
= GetNextParamStr (&TextDeviceNode
);
2859 FvFile
= (MEDIA_FW_VOL_FILEPATH_DEVICE_PATH
*) CreateDeviceNode (
2861 MEDIA_PIWG_FW_FILE_DP
,
2862 (UINT16
) sizeof (MEDIA_FW_VOL_FILEPATH_DEVICE_PATH
)
2865 StrToGuid (GuidStr
, &FvFile
->FvFileName
);
2867 return (EFI_DEVICE_PATH_PROTOCOL
*) FvFile
;
2871 Converts a text device path node to text relative offset device path structure.
2873 @param TextDeviceNode The input Text device path node.
2875 @return A pointer to the newly-created Text device path structure.
2878 EFI_DEVICE_PATH_PROTOCOL
*
2879 DevPathFromTextRelativeOffsetRange (
2880 IN CHAR16
*TextDeviceNode
2883 CHAR16
*StartingOffsetStr
;
2884 CHAR16
*EndingOffsetStr
;
2885 MEDIA_RELATIVE_OFFSET_RANGE_DEVICE_PATH
*Offset
;
2887 StartingOffsetStr
= GetNextParamStr (&TextDeviceNode
);
2888 EndingOffsetStr
= GetNextParamStr (&TextDeviceNode
);
2889 Offset
= (MEDIA_RELATIVE_OFFSET_RANGE_DEVICE_PATH
*) CreateDeviceNode (
2891 MEDIA_RELATIVE_OFFSET_RANGE_DP
,
2892 (UINT16
) sizeof (MEDIA_RELATIVE_OFFSET_RANGE_DEVICE_PATH
)
2895 Strtoi64 (StartingOffsetStr
, &Offset
->StartingOffset
);
2896 Strtoi64 (EndingOffsetStr
, &Offset
->EndingOffset
);
2898 return (EFI_DEVICE_PATH_PROTOCOL
*) Offset
;
2903 Converts a BBS text device path node to BBS device path structure.
2905 @param TextDeviceNode The input Text device path node.
2907 @return A pointer to BBS device path structure.
2910 EFI_DEVICE_PATH_PROTOCOL
*
2911 DevPathFromTextBbsPath (
2912 IN CHAR16
*TextDeviceNode
2915 return DevPathFromTextGenericPath (BBS_DEVICE_PATH
, TextDeviceNode
);
2919 Converts a text device path node to BIOS Boot Specification device path structure.
2921 @param TextDeviceNode The input Text device path node.
2923 @return A pointer to the newly-created BIOS Boot Specification device path structure.
2926 EFI_DEVICE_PATH_PROTOCOL
*
2927 DevPathFromTextBBS (
2928 IN CHAR16
*TextDeviceNode
2935 BBS_BBS_DEVICE_PATH
*Bbs
;
2937 TypeStr
= GetNextParamStr (&TextDeviceNode
);
2938 IdStr
= GetNextParamStr (&TextDeviceNode
);
2939 FlagsStr
= GetNextParamStr (&TextDeviceNode
);
2940 Bbs
= (BBS_BBS_DEVICE_PATH
*) CreateDeviceNode (
2943 (UINT16
) (sizeof (BBS_BBS_DEVICE_PATH
) + StrLen (IdStr
))
2946 if (StrCmp (TypeStr
, L
"Floppy") == 0) {
2947 Bbs
->DeviceType
= BBS_TYPE_FLOPPY
;
2948 } else if (StrCmp (TypeStr
, L
"HD") == 0) {
2949 Bbs
->DeviceType
= BBS_TYPE_HARDDRIVE
;
2950 } else if (StrCmp (TypeStr
, L
"CDROM") == 0) {
2951 Bbs
->DeviceType
= BBS_TYPE_CDROM
;
2952 } else if (StrCmp (TypeStr
, L
"PCMCIA") == 0) {
2953 Bbs
->DeviceType
= BBS_TYPE_PCMCIA
;
2954 } else if (StrCmp (TypeStr
, L
"USB") == 0) {
2955 Bbs
->DeviceType
= BBS_TYPE_USB
;
2956 } else if (StrCmp (TypeStr
, L
"Network") == 0) {
2957 Bbs
->DeviceType
= BBS_TYPE_EMBEDDED_NETWORK
;
2959 Bbs
->DeviceType
= (UINT16
) Strtoi (TypeStr
);
2962 AsciiStr
= Bbs
->String
;
2963 StrToAscii (IdStr
, &AsciiStr
);
2965 Bbs
->StatusFlag
= (UINT16
) Strtoi (FlagsStr
);
2967 return (EFI_DEVICE_PATH_PROTOCOL
*) Bbs
;
2971 Converts a text device path node to SATA device path structure.
2973 @param TextDeviceNode The input Text device path node.
2975 @return A pointer to the newly-created SATA device path structure.
2978 EFI_DEVICE_PATH_PROTOCOL
*
2979 DevPathFromTextSata (
2980 IN CHAR16
*TextDeviceNode
2983 SATA_DEVICE_PATH
*Sata
;
2988 Param1
= GetNextParamStr (&TextDeviceNode
);
2989 Param2
= GetNextParamStr (&TextDeviceNode
);
2990 Param3
= GetNextParamStr (&TextDeviceNode
);
2992 Sata
= (SATA_DEVICE_PATH
*) CreateDeviceNode (
2993 MESSAGING_DEVICE_PATH
,
2995 (UINT16
) sizeof (SATA_DEVICE_PATH
)
2997 Sata
->HBAPortNumber
= (UINT16
) Strtoi (Param1
);
2998 Sata
->PortMultiplierPortNumber
= (UINT16
) Strtoi (Param2
);
2999 Sata
->Lun
= (UINT16
) Strtoi (Param3
);
3001 return (EFI_DEVICE_PATH_PROTOCOL
*) Sata
;
3004 GLOBAL_REMOVE_IF_UNREFERENCED DEVICE_PATH_FROM_TEXT_TABLE mUefiDevicePathLibDevPathFromTextTable
[] = {
3005 {L
"Path", DevPathFromTextPath
},
3007 {L
"HardwarePath", DevPathFromTextHardwarePath
},
3008 {L
"Pci", DevPathFromTextPci
},
3009 {L
"PcCard", DevPathFromTextPcCard
},
3010 {L
"MemoryMapped", DevPathFromTextMemoryMapped
},
3011 {L
"VenHw", DevPathFromTextVenHw
},
3012 {L
"Ctrl", DevPathFromTextCtrl
},
3014 {L
"AcpiPath", DevPathFromTextAcpiPath
},
3015 {L
"Acpi", DevPathFromTextAcpi
},
3016 {L
"PciRoot", DevPathFromTextPciRoot
},
3017 {L
"PcieRoot", DevPathFromTextPcieRoot
},
3018 {L
"Floppy", DevPathFromTextFloppy
},
3019 {L
"Keyboard", DevPathFromTextKeyboard
},
3020 {L
"Serial", DevPathFromTextSerial
},
3021 {L
"ParallelPort", DevPathFromTextParallelPort
},
3022 {L
"AcpiEx", DevPathFromTextAcpiEx
},
3023 {L
"AcpiExp", DevPathFromTextAcpiExp
},
3024 {L
"AcpiAdr", DevPathFromTextAcpiAdr
},
3026 {L
"Msg", DevPathFromTextMsg
},
3027 {L
"Ata", DevPathFromTextAta
},
3028 {L
"Scsi", DevPathFromTextScsi
},
3029 {L
"Fibre", DevPathFromTextFibre
},
3030 {L
"FibreEx", DevPathFromTextFibreEx
},
3031 {L
"I1394", DevPathFromText1394
},
3032 {L
"USB", DevPathFromTextUsb
},
3033 {L
"I2O", DevPathFromTextI2O
},
3034 {L
"Infiniband", DevPathFromTextInfiniband
},
3035 {L
"VenMsg", DevPathFromTextVenMsg
},
3036 {L
"VenPcAnsi", DevPathFromTextVenPcAnsi
},
3037 {L
"VenVt100", DevPathFromTextVenVt100
},
3038 {L
"VenVt100Plus", DevPathFromTextVenVt100Plus
},
3039 {L
"VenUtf8", DevPathFromTextVenUtf8
},
3040 {L
"UartFlowCtrl", DevPathFromTextUartFlowCtrl
},
3041 {L
"SAS", DevPathFromTextSAS
},
3042 {L
"SasEx", DevPathFromTextSasEx
},
3043 {L
"DebugPort", DevPathFromTextDebugPort
},
3044 {L
"MAC", DevPathFromTextMAC
},
3045 {L
"IPv4", DevPathFromTextIPv4
},
3046 {L
"IPv6", DevPathFromTextIPv6
},
3047 {L
"Uart", DevPathFromTextUart
},
3048 {L
"UsbClass", DevPathFromTextUsbClass
},
3049 {L
"UsbAudio", DevPathFromTextUsbAudio
},
3050 {L
"UsbCDCControl", DevPathFromTextUsbCDCControl
},
3051 {L
"UsbHID", DevPathFromTextUsbHID
},
3052 {L
"UsbImage", DevPathFromTextUsbImage
},
3053 {L
"UsbPrinter", DevPathFromTextUsbPrinter
},
3054 {L
"UsbMassStorage", DevPathFromTextUsbMassStorage
},
3055 {L
"UsbHub", DevPathFromTextUsbHub
},
3056 {L
"UsbCDCData", DevPathFromTextUsbCDCData
},
3057 {L
"UsbSmartCard", DevPathFromTextUsbSmartCard
},
3058 {L
"UsbVideo", DevPathFromTextUsbVideo
},
3059 {L
"UsbDiagnostic", DevPathFromTextUsbDiagnostic
},
3060 {L
"UsbWireless", DevPathFromTextUsbWireless
},
3061 {L
"UsbDeviceFirmwareUpdate", DevPathFromTextUsbDeviceFirmwareUpdate
},
3062 {L
"UsbIrdaBridge", DevPathFromTextUsbIrdaBridge
},
3063 {L
"UsbTestAndMeasurement", DevPathFromTextUsbTestAndMeasurement
},
3064 {L
"UsbWwid", DevPathFromTextUsbWwid
},
3065 {L
"Unit", DevPathFromTextUnit
},
3066 {L
"iSCSI", DevPathFromTextiSCSI
},
3067 {L
"Vlan", DevPathFromTextVlan
},
3069 {L
"MediaPath", DevPathFromTextMediaPath
},
3070 {L
"HD", DevPathFromTextHD
},
3071 {L
"CDROM", DevPathFromTextCDROM
},
3072 {L
"VenMedia", DevPathFromTextVenMedia
},
3073 {L
"Media", DevPathFromTextMedia
},
3074 {L
"Fv", DevPathFromTextFv
},
3075 {L
"FvFile", DevPathFromTextFvFile
},
3076 {L
"Offset", DevPathFromTextRelativeOffsetRange
},
3078 {L
"BbsPath", DevPathFromTextBbsPath
},
3079 {L
"BBS", DevPathFromTextBBS
},
3080 {L
"Sata", DevPathFromTextSata
},
3085 Convert text to the binary representation of a device node.
3087 @param TextDeviceNode TextDeviceNode points to the text representation of a device
3088 node. Conversion starts with the first character and continues
3089 until the first non-device node character.
3091 @return A pointer to the EFI device node or NULL if TextDeviceNode is NULL or there was
3092 insufficient memory or text unsupported.
3095 EFI_DEVICE_PATH_PROTOCOL
*
3097 UefiDevicePathLibConvertTextToDeviceNode (
3098 IN CONST CHAR16
*TextDeviceNode
3101 DEVICE_PATH_FROM_TEXT FromText
;
3103 EFI_DEVICE_PATH_PROTOCOL
*DeviceNode
;
3104 CHAR16
*DeviceNodeStr
;
3107 if ((TextDeviceNode
== NULL
) || (IS_NULL (*TextDeviceNode
))) {
3113 DeviceNodeStr
= UefiDevicePathLibStrDuplicate (TextDeviceNode
);
3114 ASSERT (DeviceNodeStr
!= NULL
);
3116 for (Index
= 0; mUefiDevicePathLibDevPathFromTextTable
[Index
].Function
!= NULL
; Index
++) {
3117 ParamStr
= GetParamByNodeName (DeviceNodeStr
, mUefiDevicePathLibDevPathFromTextTable
[Index
].DevicePathNodeText
);
3118 if (ParamStr
!= NULL
) {
3119 FromText
= mUefiDevicePathLibDevPathFromTextTable
[Index
].Function
;
3124 if (FromText
== NULL
) {
3128 FromText
= DevPathFromTextFilePath
;
3129 DeviceNode
= FromText (DeviceNodeStr
);
3131 DeviceNode
= FromText (ParamStr
);
3132 FreePool (ParamStr
);
3135 FreePool (DeviceNodeStr
);
3141 Convert text to the binary representation of a device path.
3144 @param TextDevicePath TextDevicePath points to the text representation of a device
3145 path. Conversion starts with the first character and continues
3146 until the first non-device node character.
3148 @return A pointer to the allocated device path or NULL if TextDeviceNode is NULL or
3149 there was insufficient memory.
3152 EFI_DEVICE_PATH_PROTOCOL
*
3154 UefiDevicePathLibConvertTextToDevicePath (
3155 IN CONST CHAR16
*TextDevicePath
3158 EFI_DEVICE_PATH_PROTOCOL
*DeviceNode
;
3159 EFI_DEVICE_PATH_PROTOCOL
*NewDevicePath
;
3160 CHAR16
*DevicePathStr
;
3162 CHAR16
*DeviceNodeStr
;
3163 BOOLEAN IsInstanceEnd
;
3164 EFI_DEVICE_PATH_PROTOCOL
*DevicePath
;
3166 if ((TextDevicePath
== NULL
) || (IS_NULL (*TextDevicePath
))) {
3170 DevicePath
= (EFI_DEVICE_PATH_PROTOCOL
*) AllocatePool (END_DEVICE_PATH_LENGTH
);
3171 ASSERT (DevicePath
!= NULL
);
3172 SetDevicePathEndNode (DevicePath
);
3174 DevicePathStr
= UefiDevicePathLibStrDuplicate (TextDevicePath
);
3176 Str
= DevicePathStr
;
3177 while ((DeviceNodeStr
= GetNextDeviceNodeStr (&Str
, &IsInstanceEnd
)) != NULL
) {
3178 DeviceNode
= UefiDevicePathLibConvertTextToDeviceNode (DeviceNodeStr
);
3180 NewDevicePath
= AppendDevicePathNode (DevicePath
, DeviceNode
);
3181 FreePool (DevicePath
);
3182 FreePool (DeviceNode
);
3183 DevicePath
= NewDevicePath
;
3185 if (IsInstanceEnd
) {
3186 DeviceNode
= (EFI_DEVICE_PATH_PROTOCOL
*) AllocatePool (END_DEVICE_PATH_LENGTH
);
3187 ASSERT (DeviceNode
!= NULL
);
3188 SetDevicePathEndNode (DeviceNode
);
3190 NewDevicePath
= AppendDevicePathNode (DevicePath
, DeviceNode
);
3191 FreePool (DevicePath
);
3192 FreePool (DeviceNode
);
3193 DevicePath
= NewDevicePath
;
3197 FreePool (DevicePathStr
);