Optimize the code to not call StrToBuf when DataLength is 0.
[mirror_edk2.git] / MdePkg / Library / UefiDevicePathLib / DevicePathFromText.c
1 /** @file
2 DevicePathFromText protocol as defined in the UEFI 2.0 specification.
3
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
9
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.
12
13 **/
14
15 #include "UefiDevicePathLib.h"
16
17 /**
18
19 Duplicates a string.
20
21 @param Src Source string.
22
23 @return The duplicated string.
24
25 **/
26 CHAR16 *
27 UefiDevicePathLibStrDuplicate (
28 IN CONST CHAR16 *Src
29 )
30 {
31 return AllocateCopyPool (StrSize (Src), Src);
32 }
33
34 /**
35
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".
38
39 @param Str Device Path Text.
40 @param NodeName Name of the node.
41
42 @return Parameter text for the node.
43
44 **/
45 CHAR16 *
46 GetParamByNodeName (
47 IN CHAR16 *Str,
48 IN CHAR16 *NodeName
49 )
50 {
51 CHAR16 *ParamStr;
52 CHAR16 *StrPointer;
53 UINTN NodeNameLength;
54 UINTN ParameterLength;
55
56 //
57 // Check whether the node name matchs
58 //
59 NodeNameLength = StrLen (NodeName);
60 if (StrnCmp (Str, NodeName, NodeNameLength) != 0) {
61 return NULL;
62 }
63
64 ParamStr = Str + NodeNameLength;
65 if (!IS_LEFT_PARENTH (*ParamStr)) {
66 return NULL;
67 }
68
69 //
70 // Skip the found '(' and find first occurrence of ')'
71 //
72 ParamStr++;
73 ParameterLength = 0;
74 StrPointer = ParamStr;
75 while (!IS_NULL (*StrPointer)) {
76 if (IS_RIGHT_PARENTH (*StrPointer)) {
77 break;
78 }
79 StrPointer++;
80 ParameterLength++;
81 }
82 if (IS_NULL (*StrPointer)) {
83 //
84 // ')' not found
85 //
86 return NULL;
87 }
88
89 ParamStr = AllocateCopyPool ((ParameterLength + 1) * sizeof (CHAR16), ParamStr);
90 if (ParamStr == NULL) {
91 return NULL;
92 }
93 //
94 // Terminate the parameter string
95 //
96 ParamStr[ParameterLength] = L'\0';
97
98 return ParamStr;
99 }
100
101 /**
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"
106
107 @param List A string list separated by the specified separator
108 @param Separator The separator character
109
110 @return A pointer to the current sub-string
111
112 **/
113 CHAR16 *
114 SplitStr (
115 IN OUT CHAR16 **List,
116 IN CHAR16 Separator
117 )
118 {
119 CHAR16 *Str;
120 CHAR16 *ReturnStr;
121
122 Str = *List;
123 ReturnStr = Str;
124
125 if (IS_NULL (*Str)) {
126 return ReturnStr;
127 }
128
129 //
130 // Find first occurrence of the separator
131 //
132 while (!IS_NULL (*Str)) {
133 if (*Str == Separator) {
134 break;
135 }
136 Str++;
137 }
138
139 if (*Str == Separator) {
140 //
141 // Find a sub-string, terminate it
142 //
143 *Str = L'\0';
144 Str++;
145 }
146
147 //
148 // Move to next sub-string
149 //
150 *List = Str;
151
152 return ReturnStr;
153 }
154
155 /**
156 Gets the next parameter string from the list.
157
158 @param List A string list separated by the specified separator
159
160 @return A pointer to the current sub-string
161
162 **/
163 CHAR16 *
164 GetNextParamStr (
165 IN OUT CHAR16 **List
166 )
167 {
168 //
169 // The separator is comma
170 //
171 return SplitStr (List, L',');
172 }
173
174 /**
175 Get one device node from entire device path text.
176
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
179
180 @return A device node text or NULL if no more device node available
181
182 **/
183 CHAR16 *
184 GetNextDeviceNodeStr (
185 IN OUT CHAR16 **DevicePath,
186 OUT BOOLEAN *IsInstanceEnd
187 )
188 {
189 CHAR16 *Str;
190 CHAR16 *ReturnStr;
191 UINTN ParenthesesStack;
192
193 Str = *DevicePath;
194 if (IS_NULL (*Str)) {
195 return NULL;
196 }
197
198 //
199 // Skip the leading '/', '(', ')' and ','
200 //
201 while (!IS_NULL (*Str)) {
202 if (!IS_SLASH (*Str) &&
203 !IS_COMMA (*Str) &&
204 !IS_LEFT_PARENTH (*Str) &&
205 !IS_RIGHT_PARENTH (*Str)) {
206 break;
207 }
208 Str++;
209 }
210
211 ReturnStr = Str;
212
213 //
214 // Scan for the separator of this device node, '/' or ','
215 //
216 ParenthesesStack = 0;
217 while (!IS_NULL (*Str)) {
218 if ((IS_COMMA (*Str) || IS_SLASH (*Str)) && (ParenthesesStack == 0)) {
219 break;
220 }
221
222 if (IS_LEFT_PARENTH (*Str)) {
223 ParenthesesStack++;
224 } else if (IS_RIGHT_PARENTH (*Str)) {
225 ParenthesesStack--;
226 }
227
228 Str++;
229 }
230
231 if (ParenthesesStack != 0) {
232 //
233 // The '(' doesn't pair with ')', invalid device path text
234 //
235 return NULL;
236 }
237
238 if (IS_COMMA (*Str)) {
239 *IsInstanceEnd = TRUE;
240 *Str = L'\0';
241 Str++;
242 } else {
243 *IsInstanceEnd = FALSE;
244 if (!IS_NULL (*Str)) {
245 *Str = L'\0';
246 Str++;
247 }
248 }
249
250 *DevicePath = Str;
251
252 return ReturnStr;
253 }
254
255
256 /**
257 Return whether the integer string is a hex string.
258
259 @param Str The integer string
260
261 @retval TRUE Hex string
262 @retval FALSE Decimal string
263
264 **/
265 BOOLEAN
266 IsHexStr (
267 IN CHAR16 *Str
268 )
269 {
270 //
271 // skip preceeding white space
272 //
273 while ((*Str != 0) && *Str == L' ') {
274 Str ++;
275 }
276 //
277 // skip preceeding zeros
278 //
279 while ((*Str != 0) && *Str == L'0') {
280 Str ++;
281 }
282
283 return (BOOLEAN) (*Str == L'x' || *Str == L'X');
284 }
285
286 /**
287
288 Convert integer string to uint.
289
290 @param Str The integer string. If leading with "0x" or "0X", it's hexadecimal.
291
292 @return A UINTN value represented by Str
293
294 **/
295 UINTN
296 Strtoi (
297 IN CHAR16 *Str
298 )
299 {
300 if (IsHexStr (Str)) {
301 return StrHexToUintn (Str);
302 } else {
303 return StrDecimalToUintn (Str);
304 }
305 }
306
307 /**
308
309 Convert integer string to 64 bit data.
310
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
313
314 **/
315 VOID
316 Strtoi64 (
317 IN CHAR16 *Str,
318 OUT UINT64 *Data
319 )
320 {
321 if (IsHexStr (Str)) {
322 *Data = StrHexToUint64 (Str);
323 } else {
324 *Data = StrDecimalToUint64 (Str);
325 }
326 }
327
328 /**
329 Converts a list of string to a specified buffer.
330
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
334
335 @retval EFI_SUCCESS The string was successfully converted to the buffer.
336
337 **/
338 EFI_STATUS
339 StrToBuf (
340 OUT UINT8 *Buf,
341 IN UINTN BufferLength,
342 IN CHAR16 *Str
343 )
344 {
345 UINTN Index;
346 UINTN StrLength;
347 UINT8 Digit;
348 UINT8 Byte;
349
350 Digit = 0;
351
352 //
353 // Two hex char make up one byte
354 //
355 StrLength = BufferLength * sizeof (CHAR16);
356
357 for(Index = 0; Index < StrLength; Index++, Str++) {
358
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');
365 } else {
366 return EFI_INVALID_PARAMETER;
367 }
368
369 //
370 // For odd characters, write the upper nibble for each buffer byte,
371 // and for even characters, the lower nibble.
372 //
373 if ((Index & 1) == 0) {
374 Byte = (UINT8) (Digit << 4);
375 } else {
376 Byte = Buf[Index / 2];
377 Byte &= 0xF0;
378 Byte = (UINT8) (Byte | Digit);
379 }
380
381 Buf[Index / 2] = Byte;
382 }
383
384 return EFI_SUCCESS;
385 }
386
387 /**
388 Converts a string to GUID value.
389 Guid Format is xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
390
391 @param Str The registry format GUID string that contains the GUID value.
392 @param Guid A pointer to the converted GUID value.
393
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.
397
398 **/
399 EFI_STATUS
400 StrToGuid (
401 IN CHAR16 *Str,
402 OUT EFI_GUID *Guid
403 )
404 {
405 //
406 // Get the first UINT32 data
407 //
408 Guid->Data1 = (UINT32) StrHexToUint64 (Str);
409 while (!IS_HYPHEN (*Str) && !IS_NULL (*Str)) {
410 Str ++;
411 }
412
413 if (IS_HYPHEN (*Str)) {
414 Str++;
415 } else {
416 return EFI_UNSUPPORTED;
417 }
418
419 //
420 // Get the second UINT16 data
421 //
422 Guid->Data2 = (UINT16) StrHexToUint64 (Str);
423 while (!IS_HYPHEN (*Str) && !IS_NULL (*Str)) {
424 Str ++;
425 }
426
427 if (IS_HYPHEN (*Str)) {
428 Str++;
429 } else {
430 return EFI_UNSUPPORTED;
431 }
432
433 //
434 // Get the third UINT16 data
435 //
436 Guid->Data3 = (UINT16) StrHexToUint64 (Str);
437 while (!IS_HYPHEN (*Str) && !IS_NULL (*Str)) {
438 Str ++;
439 }
440
441 if (IS_HYPHEN (*Str)) {
442 Str++;
443 } else {
444 return EFI_UNSUPPORTED;
445 }
446
447 //
448 // Get the following 8 bytes data
449 //
450 StrToBuf (&Guid->Data4[0], 2, Str);
451 //
452 // Skip 2 byte hex chars
453 //
454 Str += 2 * 2;
455
456 if (IS_HYPHEN (*Str)) {
457 Str++;
458 } else {
459 return EFI_UNSUPPORTED;
460 }
461 StrToBuf (&Guid->Data4[2], 6, Str);
462
463 return EFI_SUCCESS;
464 }
465
466 /**
467 Converts a string to IPv4 address
468
469 @param Str A string representation of IPv4 address.
470 @param IPv4Addr A pointer to the converted IPv4 address.
471
472 **/
473 VOID
474 StrToIPv4Addr (
475 IN OUT CHAR16 **Str,
476 OUT EFI_IPv4_ADDRESS *IPv4Addr
477 )
478 {
479 UINTN Index;
480
481 for (Index = 0; Index < 4; Index++) {
482 IPv4Addr->Addr[Index] = (UINT8) Strtoi (SplitStr (Str, L'.'));
483 }
484 }
485
486 /**
487 Converts a string to IPv4 address
488
489 @param Str A string representation of IPv6 address.
490 @param IPv6Addr A pointer to the converted IPv6 address.
491
492 **/
493 VOID
494 StrToIPv6Addr (
495 IN OUT CHAR16 **Str,
496 OUT EFI_IPv6_ADDRESS *IPv6Addr
497 )
498 {
499 UINTN Index;
500 UINT16 Data;
501
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);
506 }
507 }
508
509 /**
510 Converts a Unicode string to ASCII string.
511
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
515
516 **/
517 VOID
518 StrToAscii (
519 IN CHAR16 *Str,
520 IN OUT CHAR8 **AsciiStr
521 )
522 {
523 CHAR8 *Dest;
524
525 Dest = *AsciiStr;
526 while (!IS_NULL (*Str)) {
527 *(Dest++) = (CHAR8) *(Str++);
528 }
529 *Dest = 0;
530
531 //
532 // Return the string next to it
533 //
534 *AsciiStr = Dest + 1;
535 }
536
537 /**
538 Converts a generic text device path node to device path structure.
539
540 @param Type The type of the device path node.
541 @param TextDeviceNode The input text device path node.
542
543 @return A pointer to device path structure.
544 **/
545 EFI_DEVICE_PATH_PROTOCOL *
546 DevPathFromTextGenericPath (
547 IN UINT8 Type,
548 IN CHAR16 *TextDeviceNode
549 )
550 {
551 EFI_DEVICE_PATH_PROTOCOL *Node;
552 CHAR16 *SubtypeStr;
553 CHAR16 *DataStr;
554 UINTN DataLength;
555
556 SubtypeStr = GetNextParamStr (&TextDeviceNode);
557 DataStr = GetNextParamStr (&TextDeviceNode);
558
559 if (DataStr == NULL) {
560 DataLength = 0;
561 } else {
562 DataLength = StrLen (DataStr) / 2;
563 }
564 Node = CreateDeviceNode (
565 Type,
566 (UINT8) Strtoi (SubtypeStr),
567 (UINT16) (sizeof (EFI_DEVICE_PATH_PROTOCOL) + DataLength)
568 );
569
570 if (DataLength != 0) {
571 StrToBuf ((UINT8 *) (Node + 1), DataLength, DataStr);
572 }
573 return Node;
574 }
575
576 /**
577 Converts a generic text device path node to device path structure.
578
579 @param TextDeviceNode The input Text device path node.
580
581 @return A pointer to device path structure.
582
583 **/
584 EFI_DEVICE_PATH_PROTOCOL *
585 DevPathFromTextPath (
586 IN CHAR16 *TextDeviceNode
587 )
588 {
589 CHAR16 *TypeStr;
590
591 TypeStr = GetNextParamStr (&TextDeviceNode);
592
593 return DevPathFromTextGenericPath ((UINT8) Strtoi (TypeStr), TextDeviceNode);
594 }
595
596 /**
597 Converts a generic hardware text device path node to Hardware device path structure.
598
599 @param TextDeviceNode The input Text device path node.
600
601 @return A pointer to Hardware device path structure.
602
603 **/
604 EFI_DEVICE_PATH_PROTOCOL *
605 DevPathFromTextHardwarePath (
606 IN CHAR16 *TextDeviceNode
607 )
608 {
609 return DevPathFromTextGenericPath (HARDWARE_DEVICE_PATH, TextDeviceNode);
610 }
611
612 /**
613 Converts a text device path node to Hardware PCI device path structure.
614
615 @param TextDeviceNode The input Text device path node.
616
617 @return A pointer to Hardware PCI device path structure.
618
619 **/
620 EFI_DEVICE_PATH_PROTOCOL *
621 DevPathFromTextPci (
622 IN CHAR16 *TextDeviceNode
623 )
624 {
625 CHAR16 *FunctionStr;
626 CHAR16 *DeviceStr;
627 PCI_DEVICE_PATH *Pci;
628
629 DeviceStr = GetNextParamStr (&TextDeviceNode);
630 FunctionStr = GetNextParamStr (&TextDeviceNode);
631 Pci = (PCI_DEVICE_PATH *) CreateDeviceNode (
632 HARDWARE_DEVICE_PATH,
633 HW_PCI_DP,
634 (UINT16) sizeof (PCI_DEVICE_PATH)
635 );
636
637 Pci->Function = (UINT8) Strtoi (FunctionStr);
638 Pci->Device = (UINT8) Strtoi (DeviceStr);
639
640 return (EFI_DEVICE_PATH_PROTOCOL *) Pci;
641 }
642
643 /**
644 Converts a text device path node to Hardware PC card device path structure.
645
646 @param TextDeviceNode The input Text device path node.
647
648 @return A pointer to Hardware PC card device path structure.
649
650 **/
651 EFI_DEVICE_PATH_PROTOCOL *
652 DevPathFromTextPcCard (
653 IN CHAR16 *TextDeviceNode
654 )
655 {
656 CHAR16 *FunctionNumberStr;
657 PCCARD_DEVICE_PATH *Pccard;
658
659 FunctionNumberStr = GetNextParamStr (&TextDeviceNode);
660 Pccard = (PCCARD_DEVICE_PATH *) CreateDeviceNode (
661 HARDWARE_DEVICE_PATH,
662 HW_PCCARD_DP,
663 (UINT16) sizeof (PCCARD_DEVICE_PATH)
664 );
665
666 Pccard->FunctionNumber = (UINT8) Strtoi (FunctionNumberStr);
667
668 return (EFI_DEVICE_PATH_PROTOCOL *) Pccard;
669 }
670
671 /**
672 Converts a text device path node to Hardware memory map device path structure.
673
674 @param TextDeviceNode The input Text device path node.
675
676 @return A pointer to Hardware memory map device path structure.
677
678 **/
679 EFI_DEVICE_PATH_PROTOCOL *
680 DevPathFromTextMemoryMapped (
681 IN CHAR16 *TextDeviceNode
682 )
683 {
684 CHAR16 *MemoryTypeStr;
685 CHAR16 *StartingAddressStr;
686 CHAR16 *EndingAddressStr;
687 MEMMAP_DEVICE_PATH *MemMap;
688
689 MemoryTypeStr = GetNextParamStr (&TextDeviceNode);
690 StartingAddressStr = GetNextParamStr (&TextDeviceNode);
691 EndingAddressStr = GetNextParamStr (&TextDeviceNode);
692 MemMap = (MEMMAP_DEVICE_PATH *) CreateDeviceNode (
693 HARDWARE_DEVICE_PATH,
694 HW_MEMMAP_DP,
695 (UINT16) sizeof (MEMMAP_DEVICE_PATH)
696 );
697
698 MemMap->MemoryType = (UINT32) Strtoi (MemoryTypeStr);
699 Strtoi64 (StartingAddressStr, &MemMap->StartingAddress);
700 Strtoi64 (EndingAddressStr, &MemMap->EndingAddress);
701
702 return (EFI_DEVICE_PATH_PROTOCOL *) MemMap;
703 }
704
705 /**
706 Converts a text device path node to Vendor device path structure based on the input Type
707 and SubType.
708
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.
712
713 @return A pointer to the newly-created Vendor device path structure.
714
715 **/
716 EFI_DEVICE_PATH_PROTOCOL *
717 ConvertFromTextVendor (
718 IN CHAR16 *TextDeviceNode,
719 IN UINT8 Type,
720 IN UINT8 SubType
721 )
722 {
723 CHAR16 *GuidStr;
724 CHAR16 *DataStr;
725 UINTN Length;
726 VENDOR_DEVICE_PATH *Vendor;
727
728 GuidStr = GetNextParamStr (&TextDeviceNode);
729
730 DataStr = GetNextParamStr (&TextDeviceNode);
731 Length = StrLen (DataStr);
732 //
733 // Two hex characters make up 1 buffer byte
734 //
735 Length = (Length + 1) / 2;
736
737 Vendor = (VENDOR_DEVICE_PATH *) CreateDeviceNode (
738 Type,
739 SubType,
740 (UINT16) (sizeof (VENDOR_DEVICE_PATH) + Length)
741 );
742
743 StrToGuid (GuidStr, &Vendor->Guid);
744 StrToBuf (((UINT8 *) Vendor) + sizeof (VENDOR_DEVICE_PATH), Length, DataStr);
745
746 return (EFI_DEVICE_PATH_PROTOCOL *) Vendor;
747 }
748
749 /**
750 Converts a text device path node to Vendor Hardware device path structure.
751
752 @param TextDeviceNode The input Text device path node.
753
754 @return A pointer to the newly-created Vendor Hardware device path structure.
755
756 **/
757 EFI_DEVICE_PATH_PROTOCOL *
758 DevPathFromTextVenHw (
759 IN CHAR16 *TextDeviceNode
760 )
761 {
762 return ConvertFromTextVendor (
763 TextDeviceNode,
764 HARDWARE_DEVICE_PATH,
765 HW_VENDOR_DP
766 );
767 }
768
769 /**
770 Converts a text device path node to Hardware Controller device path structure.
771
772 @param TextDeviceNode The input Text device path node.
773
774 @return A pointer to the newly-created Hardware Controller device path structure.
775
776 **/
777 EFI_DEVICE_PATH_PROTOCOL *
778 DevPathFromTextCtrl (
779 IN CHAR16 *TextDeviceNode
780 )
781 {
782 CHAR16 *ControllerStr;
783 CONTROLLER_DEVICE_PATH *Controller;
784
785 ControllerStr = GetNextParamStr (&TextDeviceNode);
786 Controller = (CONTROLLER_DEVICE_PATH *) CreateDeviceNode (
787 HARDWARE_DEVICE_PATH,
788 HW_CONTROLLER_DP,
789 (UINT16) sizeof (CONTROLLER_DEVICE_PATH)
790 );
791 Controller->ControllerNumber = (UINT32) Strtoi (ControllerStr);
792
793 return (EFI_DEVICE_PATH_PROTOCOL *) Controller;
794 }
795
796 /**
797 Converts a generic ACPI text device path node to ACPI device path structure.
798
799 @param TextDeviceNode The input Text device path node.
800
801 @return A pointer to ACPI device path structure.
802
803 **/
804 EFI_DEVICE_PATH_PROTOCOL *
805 DevPathFromTextAcpiPath (
806 IN CHAR16 *TextDeviceNode
807 )
808 {
809 return DevPathFromTextGenericPath (ACPI_DEVICE_PATH, TextDeviceNode);
810 }
811
812 /**
813 Converts a string to EisaId.
814
815 @param Text The input string.
816
817 @return UINT32 EISA ID.
818 **/
819 UINT32
820 EisaIdFromText (
821 IN CHAR16 *Text
822 )
823 {
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)
828 ;
829 }
830
831 /**
832 Converts a text device path node to ACPI HID device path structure.
833
834 @param TextDeviceNode The input Text device path node.
835
836 @return A pointer to the newly-created ACPI HID device path structure.
837
838 **/
839 EFI_DEVICE_PATH_PROTOCOL *
840 DevPathFromTextAcpi (
841 IN CHAR16 *TextDeviceNode
842 )
843 {
844 CHAR16 *HIDStr;
845 CHAR16 *UIDStr;
846 ACPI_HID_DEVICE_PATH *Acpi;
847
848 HIDStr = GetNextParamStr (&TextDeviceNode);
849 UIDStr = GetNextParamStr (&TextDeviceNode);
850 Acpi = (ACPI_HID_DEVICE_PATH *) CreateDeviceNode (
851 ACPI_DEVICE_PATH,
852 ACPI_DP,
853 (UINT16) sizeof (ACPI_HID_DEVICE_PATH)
854 );
855
856 Acpi->HID = EisaIdFromText (HIDStr);
857 Acpi->UID = (UINT32) Strtoi (UIDStr);
858
859 return (EFI_DEVICE_PATH_PROTOCOL *) Acpi;
860 }
861
862 /**
863 Converts a text device path node to ACPI HID device path structure.
864
865 @param TextDeviceNode The input Text device path node.
866 @param PnPId The input plug and play identification.
867
868 @return A pointer to the newly-created ACPI HID device path structure.
869
870 **/
871 EFI_DEVICE_PATH_PROTOCOL *
872 ConvertFromTextAcpi (
873 IN CHAR16 *TextDeviceNode,
874 IN UINT32 PnPId
875 )
876 {
877 CHAR16 *UIDStr;
878 ACPI_HID_DEVICE_PATH *Acpi;
879
880 UIDStr = GetNextParamStr (&TextDeviceNode);
881 Acpi = (ACPI_HID_DEVICE_PATH *) CreateDeviceNode (
882 ACPI_DEVICE_PATH,
883 ACPI_DP,
884 (UINT16) sizeof (ACPI_HID_DEVICE_PATH)
885 );
886
887 Acpi->HID = EFI_PNP_ID (PnPId);
888 Acpi->UID = (UINT32) Strtoi (UIDStr);
889
890 return (EFI_DEVICE_PATH_PROTOCOL *) Acpi;
891 }
892
893 /**
894 Converts a text device path node to PCI root device path structure.
895
896 @param TextDeviceNode The input Text device path node.
897
898 @return A pointer to the newly-created PCI root device path structure.
899
900 **/
901 EFI_DEVICE_PATH_PROTOCOL *
902 DevPathFromTextPciRoot (
903 IN CHAR16 *TextDeviceNode
904 )
905 {
906 return ConvertFromTextAcpi (TextDeviceNode, 0x0a03);
907 }
908
909 /**
910 Converts a text device path node to PCIE root device path structure.
911
912 @param TextDeviceNode The input Text device path node.
913
914 @return A pointer to the newly-created PCIE root device path structure.
915
916 **/
917 EFI_DEVICE_PATH_PROTOCOL *
918 DevPathFromTextPcieRoot (
919 IN CHAR16 *TextDeviceNode
920 )
921 {
922 return ConvertFromTextAcpi (TextDeviceNode, 0x0a08);
923 }
924
925 /**
926 Converts a text device path node to Floppy device path structure.
927
928 @param TextDeviceNode The input Text device path node.
929
930 @return A pointer to the newly-created Floppy device path structure.
931
932 **/
933 EFI_DEVICE_PATH_PROTOCOL *
934 DevPathFromTextFloppy (
935 IN CHAR16 *TextDeviceNode
936 )
937 {
938 return ConvertFromTextAcpi (TextDeviceNode, 0x0604);
939 }
940
941 /**
942 Converts a text device path node to Keyboard device path structure.
943
944 @param TextDeviceNode The input Text device path node.
945
946 @return A pointer to the newly-created Keyboard device path structure.
947
948 **/
949 EFI_DEVICE_PATH_PROTOCOL *
950 DevPathFromTextKeyboard (
951 IN CHAR16 *TextDeviceNode
952 )
953 {
954 return ConvertFromTextAcpi (TextDeviceNode, 0x0301);
955 }
956
957 /**
958 Converts a text device path node to Serial device path structure.
959
960 @param TextDeviceNode The input Text device path node.
961
962 @return A pointer to the newly-created Serial device path structure.
963
964 **/
965 EFI_DEVICE_PATH_PROTOCOL *
966 DevPathFromTextSerial (
967 IN CHAR16 *TextDeviceNode
968 )
969 {
970 return ConvertFromTextAcpi (TextDeviceNode, 0x0501);
971 }
972
973 /**
974 Converts a text device path node to Parallel Port device path structure.
975
976 @param TextDeviceNode The input Text device path node.
977
978 @return A pointer to the newly-created Parallel Port device path structure.
979
980 **/
981 EFI_DEVICE_PATH_PROTOCOL *
982 DevPathFromTextParallelPort (
983 IN CHAR16 *TextDeviceNode
984 )
985 {
986 return ConvertFromTextAcpi (TextDeviceNode, 0x0401);
987 }
988
989 /**
990 Converts a text device path node to ACPI extension device path structure.
991
992 @param TextDeviceNode The input Text device path node.
993
994 @return A pointer to the newly-created ACPI extension device path structure.
995
996 **/
997 EFI_DEVICE_PATH_PROTOCOL *
998 DevPathFromTextAcpiEx (
999 IN CHAR16 *TextDeviceNode
1000 )
1001 {
1002 CHAR16 *HIDStr;
1003 CHAR16 *CIDStr;
1004 CHAR16 *UIDStr;
1005 CHAR16 *HIDSTRStr;
1006 CHAR16 *CIDSTRStr;
1007 CHAR16 *UIDSTRStr;
1008 CHAR8 *AsciiStr;
1009 UINT16 Length;
1010 ACPI_EXTENDED_HID_DEVICE_PATH *AcpiEx;
1011
1012 HIDStr = GetNextParamStr (&TextDeviceNode);
1013 CIDStr = GetNextParamStr (&TextDeviceNode);
1014 UIDStr = GetNextParamStr (&TextDeviceNode);
1015 HIDSTRStr = GetNextParamStr (&TextDeviceNode);
1016 CIDSTRStr = GetNextParamStr (&TextDeviceNode);
1017 UIDSTRStr = GetNextParamStr (&TextDeviceNode);
1018
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 (
1023 ACPI_DEVICE_PATH,
1024 ACPI_EXTENDED_DP,
1025 Length
1026 );
1027
1028 AcpiEx->HID = EisaIdFromText (HIDStr);
1029 AcpiEx->CID = EisaIdFromText (CIDStr);
1030 AcpiEx->UID = (UINT32) Strtoi (UIDStr);
1031
1032 AsciiStr = (CHAR8 *) ((UINT8 *)AcpiEx + sizeof (ACPI_EXTENDED_HID_DEVICE_PATH));
1033 StrToAscii (HIDSTRStr, &AsciiStr);
1034 StrToAscii (UIDSTRStr, &AsciiStr);
1035 StrToAscii (CIDSTRStr, &AsciiStr);
1036
1037 return (EFI_DEVICE_PATH_PROTOCOL *) AcpiEx;
1038 }
1039
1040 /**
1041 Converts a text device path node to ACPI extension device path structure.
1042
1043 @param TextDeviceNode The input Text device path node.
1044
1045 @return A pointer to the newly-created ACPI extension device path structure.
1046
1047 **/
1048 EFI_DEVICE_PATH_PROTOCOL *
1049 DevPathFromTextAcpiExp (
1050 IN CHAR16 *TextDeviceNode
1051 )
1052 {
1053 CHAR16 *HIDStr;
1054 CHAR16 *CIDStr;
1055 CHAR16 *UIDSTRStr;
1056 CHAR8 *AsciiStr;
1057 UINT16 Length;
1058 ACPI_EXTENDED_HID_DEVICE_PATH *AcpiEx;
1059
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 (
1065 ACPI_DEVICE_PATH,
1066 ACPI_EXTENDED_DP,
1067 Length
1068 );
1069
1070 AcpiEx->HID = EisaIdFromText (HIDStr);
1071 AcpiEx->CID = EisaIdFromText (CIDStr);
1072 AcpiEx->UID = 0;
1073
1074 AsciiStr = (CHAR8 *) ((UINT8 *)AcpiEx + sizeof (ACPI_EXTENDED_HID_DEVICE_PATH));
1075 //
1076 // HID string is NULL
1077 //
1078 *AsciiStr = '\0';
1079 //
1080 // Convert UID string
1081 //
1082 AsciiStr++;
1083 StrToAscii (UIDSTRStr, &AsciiStr);
1084 //
1085 // CID string is NULL
1086 //
1087 *AsciiStr = '\0';
1088
1089 return (EFI_DEVICE_PATH_PROTOCOL *) AcpiEx;
1090 }
1091
1092 /**
1093 Converts a text device path node to ACPI _ADR device path structure.
1094
1095 @param TextDeviceNode The input Text device path node.
1096
1097 @return A pointer to the newly-created ACPI _ADR device path structure.
1098
1099 **/
1100 EFI_DEVICE_PATH_PROTOCOL *
1101 DevPathFromTextAcpiAdr (
1102 IN CHAR16 *TextDeviceNode
1103 )
1104 {
1105 CHAR16 *DisplayDeviceStr;
1106 ACPI_ADR_DEVICE_PATH *AcpiAdr;
1107 UINTN Index;
1108 UINTN Length;
1109
1110 AcpiAdr = (ACPI_ADR_DEVICE_PATH *) CreateDeviceNode (
1111 ACPI_DEVICE_PATH,
1112 ACPI_ADR_DP,
1113 (UINT16) sizeof (ACPI_ADR_DEVICE_PATH)
1114 );
1115 ASSERT (AcpiAdr != NULL);
1116
1117 for (Index = 0; ; Index++) {
1118 DisplayDeviceStr = GetNextParamStr (&TextDeviceNode);
1119 if (IS_NULL (*DisplayDeviceStr)) {
1120 break;
1121 }
1122 if (Index > 0) {
1123 Length = DevicePathNodeLength (AcpiAdr);
1124 AcpiAdr = ReallocatePool (
1125 Length,
1126 Length + sizeof (UINT32),
1127 AcpiAdr
1128 );
1129 ASSERT (AcpiAdr != NULL);
1130 SetDevicePathNodeLength (AcpiAdr, Length + sizeof (UINT32));
1131 }
1132
1133 (&AcpiAdr->ADR)[Index] = (UINT32) Strtoi (DisplayDeviceStr);
1134 }
1135
1136 return (EFI_DEVICE_PATH_PROTOCOL *) AcpiAdr;
1137 }
1138
1139 /**
1140 Converts a generic messaging text device path node to messaging device path structure.
1141
1142 @param TextDeviceNode The input Text device path node.
1143
1144 @return A pointer to messaging device path structure.
1145
1146 **/
1147 EFI_DEVICE_PATH_PROTOCOL *
1148 DevPathFromTextMsg (
1149 IN CHAR16 *TextDeviceNode
1150 )
1151 {
1152 return DevPathFromTextGenericPath (MESSAGING_DEVICE_PATH, TextDeviceNode);
1153 }
1154
1155 /**
1156 Converts a text device path node to Parallel Port device path structure.
1157
1158 @param TextDeviceNode The input Text device path node.
1159
1160 @return A pointer to the newly-created Parallel Port device path structure.
1161
1162 **/
1163 EFI_DEVICE_PATH_PROTOCOL *
1164 DevPathFromTextAta (
1165 IN CHAR16 *TextDeviceNode
1166 )
1167 {
1168 CHAR16 *PrimarySecondaryStr;
1169 CHAR16 *SlaveMasterStr;
1170 CHAR16 *LunStr;
1171 ATAPI_DEVICE_PATH *Atapi;
1172
1173 Atapi = (ATAPI_DEVICE_PATH *) CreateDeviceNode (
1174 MESSAGING_DEVICE_PATH,
1175 MSG_ATAPI_DP,
1176 (UINT16) sizeof (ATAPI_DEVICE_PATH)
1177 );
1178
1179 PrimarySecondaryStr = GetNextParamStr (&TextDeviceNode);
1180 SlaveMasterStr = GetNextParamStr (&TextDeviceNode);
1181 LunStr = GetNextParamStr (&TextDeviceNode);
1182
1183 if (StrCmp (PrimarySecondaryStr, L"Primary") == 0) {
1184 Atapi->PrimarySecondary = 0;
1185 } else if (StrCmp (PrimarySecondaryStr, L"Secondary") == 0) {
1186 Atapi->PrimarySecondary = 1;
1187 } else {
1188 Atapi->PrimarySecondary = (UINT8) Strtoi (PrimarySecondaryStr);
1189 }
1190 if (StrCmp (SlaveMasterStr, L"Master") == 0) {
1191 Atapi->SlaveMaster = 0;
1192 } else if (StrCmp (SlaveMasterStr, L"Slave") == 0) {
1193 Atapi->SlaveMaster = 1;
1194 } else {
1195 Atapi->SlaveMaster = (UINT8) Strtoi (SlaveMasterStr);
1196 }
1197
1198 Atapi->Lun = (UINT16) Strtoi (LunStr);
1199
1200 return (EFI_DEVICE_PATH_PROTOCOL *) Atapi;
1201 }
1202
1203 /**
1204 Converts a text device path node to SCSI device path structure.
1205
1206 @param TextDeviceNode The input Text device path node.
1207
1208 @return A pointer to the newly-created SCSI device path structure.
1209
1210 **/
1211 EFI_DEVICE_PATH_PROTOCOL *
1212 DevPathFromTextScsi (
1213 IN CHAR16 *TextDeviceNode
1214 )
1215 {
1216 CHAR16 *PunStr;
1217 CHAR16 *LunStr;
1218 SCSI_DEVICE_PATH *Scsi;
1219
1220 PunStr = GetNextParamStr (&TextDeviceNode);
1221 LunStr = GetNextParamStr (&TextDeviceNode);
1222 Scsi = (SCSI_DEVICE_PATH *) CreateDeviceNode (
1223 MESSAGING_DEVICE_PATH,
1224 MSG_SCSI_DP,
1225 (UINT16) sizeof (SCSI_DEVICE_PATH)
1226 );
1227
1228 Scsi->Pun = (UINT16) Strtoi (PunStr);
1229 Scsi->Lun = (UINT16) Strtoi (LunStr);
1230
1231 return (EFI_DEVICE_PATH_PROTOCOL *) Scsi;
1232 }
1233
1234 /**
1235 Converts a text device path node to Fibre device path structure.
1236
1237 @param TextDeviceNode The input Text device path node.
1238
1239 @return A pointer to the newly-created Fibre device path structure.
1240
1241 **/
1242 EFI_DEVICE_PATH_PROTOCOL *
1243 DevPathFromTextFibre (
1244 IN CHAR16 *TextDeviceNode
1245 )
1246 {
1247 CHAR16 *WWNStr;
1248 CHAR16 *LunStr;
1249 FIBRECHANNEL_DEVICE_PATH *Fibre;
1250
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)
1257 );
1258
1259 Fibre->Reserved = 0;
1260 Strtoi64 (WWNStr, &Fibre->WWN);
1261 Strtoi64 (LunStr, &Fibre->Lun);
1262
1263 return (EFI_DEVICE_PATH_PROTOCOL *) Fibre;
1264 }
1265
1266 /**
1267 Converts a text device path node to FibreEx device path structure.
1268
1269 @param TextDeviceNode The input Text device path node.
1270
1271 @return A pointer to the newly-created FibreEx device path structure.
1272
1273 **/
1274 EFI_DEVICE_PATH_PROTOCOL *
1275 DevPathFromTextFibreEx (
1276 IN CHAR16 *TextDeviceNode
1277 )
1278 {
1279 CHAR16 *WWNStr;
1280 CHAR16 *LunStr;
1281 FIBRECHANNELEX_DEVICE_PATH *FibreEx;
1282
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)
1289 );
1290
1291 FibreEx->Reserved = 0;
1292 Strtoi64 (WWNStr, (UINT64 *) (&FibreEx->WWN));
1293 Strtoi64 (LunStr, (UINT64 *) (&FibreEx->Lun));
1294
1295 *(UINT64 *) (&FibreEx->WWN) = SwapBytes64 (*(UINT64 *) (&FibreEx->WWN));
1296 *(UINT64 *) (&FibreEx->Lun) = SwapBytes64 (*(UINT64 *) (&FibreEx->Lun));
1297
1298 return (EFI_DEVICE_PATH_PROTOCOL *) FibreEx;
1299 }
1300
1301 /**
1302 Converts a text device path node to 1394 device path structure.
1303
1304 @param TextDeviceNode The input Text device path node.
1305
1306 @return A pointer to the newly-created 1394 device path structure.
1307
1308 **/
1309 EFI_DEVICE_PATH_PROTOCOL *
1310 DevPathFromText1394 (
1311 IN CHAR16 *TextDeviceNode
1312 )
1313 {
1314 CHAR16 *GuidStr;
1315 F1394_DEVICE_PATH *F1394DevPath;
1316
1317 GuidStr = GetNextParamStr (&TextDeviceNode);
1318 F1394DevPath = (F1394_DEVICE_PATH *) CreateDeviceNode (
1319 MESSAGING_DEVICE_PATH,
1320 MSG_1394_DP,
1321 (UINT16) sizeof (F1394_DEVICE_PATH)
1322 );
1323
1324 F1394DevPath->Reserved = 0;
1325 F1394DevPath->Guid = StrHexToUint64 (GuidStr);
1326
1327 return (EFI_DEVICE_PATH_PROTOCOL *) F1394DevPath;
1328 }
1329
1330 /**
1331 Converts a text device path node to USB device path structure.
1332
1333 @param TextDeviceNode The input Text device path node.
1334
1335 @return A pointer to the newly-created USB device path structure.
1336
1337 **/
1338 EFI_DEVICE_PATH_PROTOCOL *
1339 DevPathFromTextUsb (
1340 IN CHAR16 *TextDeviceNode
1341 )
1342 {
1343 CHAR16 *PortStr;
1344 CHAR16 *InterfaceStr;
1345 USB_DEVICE_PATH *Usb;
1346
1347 PortStr = GetNextParamStr (&TextDeviceNode);
1348 InterfaceStr = GetNextParamStr (&TextDeviceNode);
1349 Usb = (USB_DEVICE_PATH *) CreateDeviceNode (
1350 MESSAGING_DEVICE_PATH,
1351 MSG_USB_DP,
1352 (UINT16) sizeof (USB_DEVICE_PATH)
1353 );
1354
1355 Usb->ParentPortNumber = (UINT8) Strtoi (PortStr);
1356 Usb->InterfaceNumber = (UINT8) Strtoi (InterfaceStr);
1357
1358 return (EFI_DEVICE_PATH_PROTOCOL *) Usb;
1359 }
1360
1361 /**
1362 Converts a text device path node to I20 device path structure.
1363
1364 @param TextDeviceNode The input Text device path node.
1365
1366 @return A pointer to the newly-created I20 device path structure.
1367
1368 **/
1369 EFI_DEVICE_PATH_PROTOCOL *
1370 DevPathFromTextI2O (
1371 IN CHAR16 *TextDeviceNode
1372 )
1373 {
1374 CHAR16 *TIDStr;
1375 I2O_DEVICE_PATH *I2ODevPath;
1376
1377 TIDStr = GetNextParamStr (&TextDeviceNode);
1378 I2ODevPath = (I2O_DEVICE_PATH *) CreateDeviceNode (
1379 MESSAGING_DEVICE_PATH,
1380 MSG_I2O_DP,
1381 (UINT16) sizeof (I2O_DEVICE_PATH)
1382 );
1383
1384 I2ODevPath->Tid = (UINT32) Strtoi (TIDStr);
1385
1386 return (EFI_DEVICE_PATH_PROTOCOL *) I2ODevPath;
1387 }
1388
1389 /**
1390 Converts a text device path node to Infini Band device path structure.
1391
1392 @param TextDeviceNode The input Text device path node.
1393
1394 @return A pointer to the newly-created Infini Band device path structure.
1395
1396 **/
1397 EFI_DEVICE_PATH_PROTOCOL *
1398 DevPathFromTextInfiniband (
1399 IN CHAR16 *TextDeviceNode
1400 )
1401 {
1402 CHAR16 *FlagsStr;
1403 CHAR16 *GuidStr;
1404 CHAR16 *SidStr;
1405 CHAR16 *TidStr;
1406 CHAR16 *DidStr;
1407 EFI_GUID PortGid;
1408 INFINIBAND_DEVICE_PATH *InfiniBand;
1409
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,
1417 MSG_INFINIBAND_DP,
1418 (UINT16) sizeof (INFINIBAND_DEVICE_PATH)
1419 );
1420
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);
1427
1428 return (EFI_DEVICE_PATH_PROTOCOL *) InfiniBand;
1429 }
1430
1431 /**
1432 Converts a text device path node to Vendor-Defined Messaging device path structure.
1433
1434 @param TextDeviceNode The input Text device path node.
1435
1436 @return A pointer to the newly-created Vendor-Defined Messaging device path structure.
1437
1438 **/
1439 EFI_DEVICE_PATH_PROTOCOL *
1440 DevPathFromTextVenMsg (
1441 IN CHAR16 *TextDeviceNode
1442 )
1443 {
1444 return ConvertFromTextVendor (
1445 TextDeviceNode,
1446 MESSAGING_DEVICE_PATH,
1447 MSG_VENDOR_DP
1448 );
1449 }
1450
1451 /**
1452 Converts a text device path node to Vendor defined PC-ANSI device path structure.
1453
1454 @param TextDeviceNode The input Text device path node.
1455
1456 @return A pointer to the newly-created Vendor defined PC-ANSI device path structure.
1457
1458 **/
1459 EFI_DEVICE_PATH_PROTOCOL *
1460 DevPathFromTextVenPcAnsi (
1461 IN CHAR16 *TextDeviceNode
1462 )
1463 {
1464 VENDOR_DEVICE_PATH *Vendor;
1465
1466 Vendor = (VENDOR_DEVICE_PATH *) CreateDeviceNode (
1467 MESSAGING_DEVICE_PATH,
1468 MSG_VENDOR_DP,
1469 (UINT16) sizeof (VENDOR_DEVICE_PATH));
1470 CopyGuid (&Vendor->Guid, &gEfiPcAnsiGuid);
1471
1472 return (EFI_DEVICE_PATH_PROTOCOL *) Vendor;
1473 }
1474
1475 /**
1476 Converts a text device path node to Vendor defined VT100 device path structure.
1477
1478 @param TextDeviceNode The input Text device path node.
1479
1480 @return A pointer to the newly-created Vendor defined VT100 device path structure.
1481
1482 **/
1483 EFI_DEVICE_PATH_PROTOCOL *
1484 DevPathFromTextVenVt100 (
1485 IN CHAR16 *TextDeviceNode
1486 )
1487 {
1488 VENDOR_DEVICE_PATH *Vendor;
1489
1490 Vendor = (VENDOR_DEVICE_PATH *) CreateDeviceNode (
1491 MESSAGING_DEVICE_PATH,
1492 MSG_VENDOR_DP,
1493 (UINT16) sizeof (VENDOR_DEVICE_PATH));
1494 CopyGuid (&Vendor->Guid, &gEfiVT100Guid);
1495
1496 return (EFI_DEVICE_PATH_PROTOCOL *) Vendor;
1497 }
1498
1499 /**
1500 Converts a text device path node to Vendor defined VT100 Plus device path structure.
1501
1502 @param TextDeviceNode The input Text device path node.
1503
1504 @return A pointer to the newly-created Vendor defined VT100 Plus device path structure.
1505
1506 **/
1507 EFI_DEVICE_PATH_PROTOCOL *
1508 DevPathFromTextVenVt100Plus (
1509 IN CHAR16 *TextDeviceNode
1510 )
1511 {
1512 VENDOR_DEVICE_PATH *Vendor;
1513
1514 Vendor = (VENDOR_DEVICE_PATH *) CreateDeviceNode (
1515 MESSAGING_DEVICE_PATH,
1516 MSG_VENDOR_DP,
1517 (UINT16) sizeof (VENDOR_DEVICE_PATH));
1518 CopyGuid (&Vendor->Guid, &gEfiVT100PlusGuid);
1519
1520 return (EFI_DEVICE_PATH_PROTOCOL *) Vendor;
1521 }
1522
1523 /**
1524 Converts a text device path node to Vendor defined UTF8 device path structure.
1525
1526 @param TextDeviceNode The input Text device path node.
1527
1528 @return A pointer to the newly-created Vendor defined UTF8 device path structure.
1529
1530 **/
1531 EFI_DEVICE_PATH_PROTOCOL *
1532 DevPathFromTextVenUtf8 (
1533 IN CHAR16 *TextDeviceNode
1534 )
1535 {
1536 VENDOR_DEVICE_PATH *Vendor;
1537
1538 Vendor = (VENDOR_DEVICE_PATH *) CreateDeviceNode (
1539 MESSAGING_DEVICE_PATH,
1540 MSG_VENDOR_DP,
1541 (UINT16) sizeof (VENDOR_DEVICE_PATH));
1542 CopyGuid (&Vendor->Guid, &gEfiVTUTF8Guid);
1543
1544 return (EFI_DEVICE_PATH_PROTOCOL *) Vendor;
1545 }
1546
1547 /**
1548 Converts a text device path node to UART Flow Control device path structure.
1549
1550 @param TextDeviceNode The input Text device path node.
1551
1552 @return A pointer to the newly-created UART Flow Control device path structure.
1553
1554 **/
1555 EFI_DEVICE_PATH_PROTOCOL *
1556 DevPathFromTextUartFlowCtrl (
1557 IN CHAR16 *TextDeviceNode
1558 )
1559 {
1560 CHAR16 *ValueStr;
1561 UART_FLOW_CONTROL_DEVICE_PATH *UartFlowControl;
1562
1563 ValueStr = GetNextParamStr (&TextDeviceNode);
1564 UartFlowControl = (UART_FLOW_CONTROL_DEVICE_PATH *) CreateDeviceNode (
1565 MESSAGING_DEVICE_PATH,
1566 MSG_VENDOR_DP,
1567 (UINT16) sizeof (UART_FLOW_CONTROL_DEVICE_PATH)
1568 );
1569
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;
1575 } else {
1576 UartFlowControl->FlowControlMap = 0;
1577 }
1578
1579 return (EFI_DEVICE_PATH_PROTOCOL *) UartFlowControl;
1580 }
1581
1582 /**
1583 Converts a text device path node to Serial Attached SCSI device path structure.
1584
1585 @param TextDeviceNode The input Text device path node.
1586
1587 @return A pointer to the newly-created Serial Attached SCSI device path structure.
1588
1589 **/
1590 EFI_DEVICE_PATH_PROTOCOL *
1591 DevPathFromTextSAS (
1592 IN CHAR16 *TextDeviceNode
1593 )
1594 {
1595 CHAR16 *AddressStr;
1596 CHAR16 *LunStr;
1597 CHAR16 *RTPStr;
1598 CHAR16 *SASSATAStr;
1599 CHAR16 *LocationStr;
1600 CHAR16 *ConnectStr;
1601 CHAR16 *DriveBayStr;
1602 CHAR16 *ReservedStr;
1603 UINT16 Info;
1604 UINT16 Uint16;
1605 SAS_DEVICE_PATH *Sas;
1606
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,
1617 MSG_VENDOR_DP,
1618 (UINT16) sizeof (SAS_DEVICE_PATH)
1619 );
1620
1621 CopyGuid (&Sas->Guid, &gEfiSasDevicePathGuid);
1622 Strtoi64 (AddressStr, &Sas->SasAddress);
1623 Strtoi64 (LunStr, &Sas->Lun);
1624 Sas->RelativeTargetPort = (UINT16) Strtoi (RTPStr);
1625
1626 if (StrCmp (SASSATAStr, L"NoTopology") == 0) {
1627 Info = 0x0;
1628
1629 } else if ((StrCmp (SASSATAStr, L"SATA") == 0) || (StrCmp (SASSATAStr, L"SAS") == 0)) {
1630
1631 Uint16 = (UINT16) Strtoi (DriveBayStr);
1632 if (Uint16 == 0) {
1633 Info = 0x1;
1634 } else {
1635 Info = (UINT16) (0x2 | ((Uint16 - 1) << 8));
1636 }
1637
1638 if (StrCmp (SASSATAStr, L"SATA") == 0) {
1639 Info |= BIT4;
1640 }
1641
1642 //
1643 // Location is an integer between 0 and 1 or else
1644 // the keyword Internal (0) or External (1).
1645 //
1646 if (StrCmp (LocationStr, L"External") == 0) {
1647 Uint16 = 1;
1648 } else if (StrCmp (LocationStr, L"Internal") == 0) {
1649 Uint16 = 0;
1650 } else {
1651 Uint16 = ((UINT16) Strtoi (LocationStr) & BIT0);
1652 }
1653 Info |= (Uint16 << 5);
1654
1655 //
1656 // Connect is an integer between 0 and 3 or else
1657 // the keyword Direct (0) or Expanded (1).
1658 //
1659 if (StrCmp (ConnectStr, L"Expanded") == 0) {
1660 Uint16 = 1;
1661 } else if (StrCmp (ConnectStr, L"Direct") == 0) {
1662 Uint16 = 0;
1663 } else {
1664 Uint16 = ((UINT16) Strtoi (ConnectStr) & (BIT0 | BIT1));
1665 }
1666 Info |= (Uint16 << 6);
1667
1668 } else {
1669 Info = (UINT16) Strtoi (SASSATAStr);
1670 }
1671
1672 Sas->DeviceTopology = Info;
1673 Sas->Reserved = (UINT32) Strtoi (ReservedStr);
1674
1675 return (EFI_DEVICE_PATH_PROTOCOL *) Sas;
1676 }
1677
1678 /**
1679 Converts a text device path node to Serial Attached SCSI Ex device path structure.
1680
1681 @param TextDeviceNode The input Text device path node.
1682
1683 @return A pointer to the newly-created Serial Attached SCSI Ex device path structure.
1684
1685 **/
1686 EFI_DEVICE_PATH_PROTOCOL *
1687 DevPathFromTextSasEx (
1688 IN CHAR16 *TextDeviceNode
1689 )
1690 {
1691 CHAR16 *AddressStr;
1692 CHAR16 *LunStr;
1693 CHAR16 *RTPStr;
1694 CHAR16 *SASSATAStr;
1695 CHAR16 *LocationStr;
1696 CHAR16 *ConnectStr;
1697 CHAR16 *DriveBayStr;
1698 UINT16 Info;
1699 UINT16 Uint16;
1700 UINT64 SasAddress;
1701 UINT64 Lun;
1702 SASEX_DEVICE_PATH *SasEx;
1703
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,
1713 MSG_SASEX_DP,
1714 (UINT16) sizeof (SASEX_DEVICE_PATH)
1715 );
1716
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);
1722
1723 if (StrCmp (SASSATAStr, L"NoTopology") == 0) {
1724 Info = 0x0;
1725
1726 } else if ((StrCmp (SASSATAStr, L"SATA") == 0) || (StrCmp (SASSATAStr, L"SAS") == 0)) {
1727
1728 Uint16 = (UINT16) Strtoi (DriveBayStr);
1729 if (Uint16 == 0) {
1730 Info = 0x1;
1731 } else {
1732 Info = (UINT16) (0x2 | ((Uint16 - 1) << 8));
1733 }
1734
1735 if (StrCmp (SASSATAStr, L"SATA") == 0) {
1736 Info |= BIT4;
1737 }
1738
1739 //
1740 // Location is an integer between 0 and 1 or else
1741 // the keyword Internal (0) or External (1).
1742 //
1743 if (StrCmp (LocationStr, L"External") == 0) {
1744 Uint16 = 1;
1745 } else if (StrCmp (LocationStr, L"Internal") == 0) {
1746 Uint16 = 0;
1747 } else {
1748 Uint16 = ((UINT16) Strtoi (LocationStr) & BIT0);
1749 }
1750 Info |= (Uint16 << 5);
1751
1752 //
1753 // Connect is an integer between 0 and 3 or else
1754 // the keyword Direct (0) or Expanded (1).
1755 //
1756 if (StrCmp (ConnectStr, L"Expanded") == 0) {
1757 Uint16 = 1;
1758 } else if (StrCmp (ConnectStr, L"Direct") == 0) {
1759 Uint16 = 0;
1760 } else {
1761 Uint16 = ((UINT16) Strtoi (ConnectStr) & (BIT0 | BIT1));
1762 }
1763 Info |= (Uint16 << 6);
1764
1765 } else {
1766 Info = (UINT16) Strtoi (SASSATAStr);
1767 }
1768
1769 SasEx->DeviceTopology = Info;
1770
1771 return (EFI_DEVICE_PATH_PROTOCOL *) SasEx;
1772 }
1773
1774 /**
1775 Converts a text device path node to Debug Port device path structure.
1776
1777 @param TextDeviceNode The input Text device path node.
1778
1779 @return A pointer to the newly-created Debug Port device path structure.
1780
1781 **/
1782 EFI_DEVICE_PATH_PROTOCOL *
1783 DevPathFromTextDebugPort (
1784 IN CHAR16 *TextDeviceNode
1785 )
1786 {
1787 VENDOR_DEFINED_MESSAGING_DEVICE_PATH *Vend;
1788
1789 Vend = (VENDOR_DEFINED_MESSAGING_DEVICE_PATH *) CreateDeviceNode (
1790 MESSAGING_DEVICE_PATH,
1791 MSG_VENDOR_DP,
1792 (UINT16) sizeof (VENDOR_DEFINED_MESSAGING_DEVICE_PATH)
1793 );
1794
1795 CopyGuid (&Vend->Guid, &gEfiDebugPortProtocolGuid);
1796
1797 return (EFI_DEVICE_PATH_PROTOCOL *) Vend;
1798 }
1799
1800 /**
1801 Converts a text device path node to MAC device path structure.
1802
1803 @param TextDeviceNode The input Text device path node.
1804
1805 @return A pointer to the newly-created MAC device path structure.
1806
1807 **/
1808 EFI_DEVICE_PATH_PROTOCOL *
1809 DevPathFromTextMAC (
1810 IN CHAR16 *TextDeviceNode
1811 )
1812 {
1813 CHAR16 *AddressStr;
1814 CHAR16 *IfTypeStr;
1815 UINTN Length;
1816 MAC_ADDR_DEVICE_PATH *MACDevPath;
1817
1818 AddressStr = GetNextParamStr (&TextDeviceNode);
1819 IfTypeStr = GetNextParamStr (&TextDeviceNode);
1820 MACDevPath = (MAC_ADDR_DEVICE_PATH *) CreateDeviceNode (
1821 MESSAGING_DEVICE_PATH,
1822 MSG_MAC_ADDR_DP,
1823 (UINT16) sizeof (MAC_ADDR_DEVICE_PATH)
1824 );
1825
1826 MACDevPath->IfType = (UINT8) Strtoi (IfTypeStr);
1827
1828 Length = sizeof (EFI_MAC_ADDRESS);
1829 StrToBuf (&MACDevPath->MacAddress.Addr[0], Length, AddressStr);
1830
1831 return (EFI_DEVICE_PATH_PROTOCOL *) MACDevPath;
1832 }
1833
1834
1835 /**
1836 Converts a text format to the network protocol ID.
1837
1838 @param Text String of protocol field.
1839
1840 @return Network protocol ID .
1841
1842 **/
1843 UINTN
1844 NetworkProtocolFromText (
1845 IN CHAR16 *Text
1846 )
1847 {
1848 if (StrCmp (Text, L"UDP") == 0) {
1849 return RFC_1700_UDP_PROTOCOL;
1850 }
1851
1852 if (StrCmp (Text, L"TCP") == 0) {
1853 return RFC_1700_TCP_PROTOCOL;
1854 }
1855
1856 return Strtoi (Text);
1857 }
1858
1859
1860 /**
1861 Converts a text device path node to IPV4 device path structure.
1862
1863 @param TextDeviceNode The input Text device path node.
1864
1865 @return A pointer to the newly-created IPV4 device path structure.
1866
1867 **/
1868 EFI_DEVICE_PATH_PROTOCOL *
1869 DevPathFromTextIPv4 (
1870 IN CHAR16 *TextDeviceNode
1871 )
1872 {
1873 CHAR16 *RemoteIPStr;
1874 CHAR16 *ProtocolStr;
1875 CHAR16 *TypeStr;
1876 CHAR16 *LocalIPStr;
1877 CHAR16 *GatewayIPStr;
1878 CHAR16 *SubnetMaskStr;
1879 IPv4_DEVICE_PATH *IPv4;
1880
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,
1889 MSG_IPv4_DP,
1890 (UINT16) sizeof (IPv4_DEVICE_PATH)
1891 );
1892
1893 StrToIPv4Addr (&RemoteIPStr, &IPv4->RemoteIpAddress);
1894 IPv4->Protocol = (UINT16) NetworkProtocolFromText (ProtocolStr);
1895 if (StrCmp (TypeStr, L"Static") == 0) {
1896 IPv4->StaticIpAddress = TRUE;
1897 } else {
1898 IPv4->StaticIpAddress = FALSE;
1899 }
1900
1901 StrToIPv4Addr (&LocalIPStr, &IPv4->LocalIpAddress);
1902 if (!IS_NULL (*GatewayIPStr) && !IS_NULL (*SubnetMaskStr)) {
1903 StrToIPv4Addr (&GatewayIPStr, &IPv4->GatewayIpAddress);
1904 StrToIPv4Addr (&SubnetMaskStr, &IPv4->SubnetMask);
1905 } else {
1906 ZeroMem (&IPv4->GatewayIpAddress, sizeof (IPv4->GatewayIpAddress));
1907 ZeroMem (&IPv4->SubnetMask, sizeof (IPv4->SubnetMask));
1908 }
1909
1910 IPv4->LocalPort = 0;
1911 IPv4->RemotePort = 0;
1912
1913 return (EFI_DEVICE_PATH_PROTOCOL *) IPv4;
1914 }
1915
1916 /**
1917 Converts a text device path node to IPV6 device path structure.
1918
1919 @param TextDeviceNode The input Text device path node.
1920
1921 @return A pointer to the newly-created IPV6 device path structure.
1922
1923 **/
1924 EFI_DEVICE_PATH_PROTOCOL *
1925 DevPathFromTextIPv6 (
1926 IN CHAR16 *TextDeviceNode
1927 )
1928 {
1929 CHAR16 *RemoteIPStr;
1930 CHAR16 *ProtocolStr;
1931 CHAR16 *TypeStr;
1932 CHAR16 *LocalIPStr;
1933 CHAR16 *GatewayIPStr;
1934 CHAR16 *PrefixLengthStr;
1935 IPv6_DEVICE_PATH *IPv6;
1936
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,
1945 MSG_IPv6_DP,
1946 (UINT16) sizeof (IPv6_DEVICE_PATH)
1947 );
1948
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;
1955 } else {
1956 IPv6->IpAddressOrigin = 2;
1957 }
1958
1959 StrToIPv6Addr (&LocalIPStr, &IPv6->LocalIpAddress);
1960 if (!IS_NULL (*GatewayIPStr) && !IS_NULL (*PrefixLengthStr)) {
1961 StrToIPv6Addr (&GatewayIPStr, &IPv6->GatewayIpAddress);
1962 IPv6->PrefixLength = (UINT8) Strtoi (PrefixLengthStr);
1963 } else {
1964 ZeroMem (&IPv6->GatewayIpAddress, sizeof (IPv6->GatewayIpAddress));
1965 IPv6->PrefixLength = 0;
1966 }
1967
1968 IPv6->LocalPort = 0;
1969 IPv6->RemotePort = 0;
1970
1971 return (EFI_DEVICE_PATH_PROTOCOL *) IPv6;
1972 }
1973
1974 /**
1975 Converts a text device path node to UART device path structure.
1976
1977 @param TextDeviceNode The input Text device path node.
1978
1979 @return A pointer to the newly-created UART device path structure.
1980
1981 **/
1982 EFI_DEVICE_PATH_PROTOCOL *
1983 DevPathFromTextUart (
1984 IN CHAR16 *TextDeviceNode
1985 )
1986 {
1987 CHAR16 *BaudStr;
1988 CHAR16 *DataBitsStr;
1989 CHAR16 *ParityStr;
1990 CHAR16 *StopBitsStr;
1991 UART_DEVICE_PATH *Uart;
1992
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,
1999 MSG_UART_DP,
2000 (UINT16) sizeof (UART_DEVICE_PATH)
2001 );
2002
2003 if (StrCmp (BaudStr, L"DEFAULT") == 0) {
2004 Uart->BaudRate = 115200;
2005 } else {
2006 Strtoi64 (BaudStr, &Uart->BaudRate);
2007 }
2008 Uart->DataBits = (UINT8) ((StrCmp (DataBitsStr, L"DEFAULT") == 0) ? 8 : Strtoi (DataBitsStr));
2009 switch (*ParityStr) {
2010 case L'D':
2011 Uart->Parity = 0;
2012 break;
2013
2014 case L'N':
2015 Uart->Parity = 1;
2016 break;
2017
2018 case L'E':
2019 Uart->Parity = 2;
2020 break;
2021
2022 case L'O':
2023 Uart->Parity = 3;
2024 break;
2025
2026 case L'M':
2027 Uart->Parity = 4;
2028 break;
2029
2030 case L'S':
2031 Uart->Parity = 5;
2032 break;
2033
2034 default:
2035 Uart->Parity = (UINT8) Strtoi (ParityStr);
2036 break;
2037 }
2038
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;
2047 } else {
2048 Uart->StopBits = (UINT8) Strtoi (StopBitsStr);
2049 }
2050
2051 return (EFI_DEVICE_PATH_PROTOCOL *) Uart;
2052 }
2053
2054 /**
2055 Converts a text device path node to USB class device path structure.
2056
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.
2059
2060 @return A pointer to the newly-created USB class device path structure.
2061
2062 **/
2063 EFI_DEVICE_PATH_PROTOCOL *
2064 ConvertFromTextUsbClass (
2065 IN CHAR16 *TextDeviceNode,
2066 IN USB_CLASS_TEXT *UsbClassText
2067 )
2068 {
2069 CHAR16 *VIDStr;
2070 CHAR16 *PIDStr;
2071 CHAR16 *ClassStr;
2072 CHAR16 *SubClassStr;
2073 CHAR16 *ProtocolStr;
2074 USB_CLASS_DEVICE_PATH *UsbClass;
2075
2076 UsbClass = (USB_CLASS_DEVICE_PATH *) CreateDeviceNode (
2077 MESSAGING_DEVICE_PATH,
2078 MSG_USB_CLASS_DP,
2079 (UINT16) sizeof (USB_CLASS_DEVICE_PATH)
2080 );
2081
2082 VIDStr = GetNextParamStr (&TextDeviceNode);
2083 PIDStr = GetNextParamStr (&TextDeviceNode);
2084 if (UsbClassText->ClassExist) {
2085 ClassStr = GetNextParamStr (&TextDeviceNode);
2086 UsbClass->DeviceClass = (UINT8) Strtoi (ClassStr);
2087 } else {
2088 UsbClass->DeviceClass = UsbClassText->Class;
2089 }
2090 if (UsbClassText->SubClassExist) {
2091 SubClassStr = GetNextParamStr (&TextDeviceNode);
2092 UsbClass->DeviceSubClass = (UINT8) Strtoi (SubClassStr);
2093 } else {
2094 UsbClass->DeviceSubClass = UsbClassText->SubClass;
2095 }
2096
2097 ProtocolStr = GetNextParamStr (&TextDeviceNode);
2098
2099 UsbClass->VendorId = (UINT16) Strtoi (VIDStr);
2100 UsbClass->ProductId = (UINT16) Strtoi (PIDStr);
2101 UsbClass->DeviceProtocol = (UINT8) Strtoi (ProtocolStr);
2102
2103 return (EFI_DEVICE_PATH_PROTOCOL *) UsbClass;
2104 }
2105
2106
2107 /**
2108 Converts a text device path node to USB class device path structure.
2109
2110 @param TextDeviceNode The input Text device path node.
2111
2112 @return A pointer to the newly-created USB class device path structure.
2113
2114 **/
2115 EFI_DEVICE_PATH_PROTOCOL *
2116 DevPathFromTextUsbClass (
2117 IN CHAR16 *TextDeviceNode
2118 )
2119 {
2120 USB_CLASS_TEXT UsbClassText;
2121
2122 UsbClassText.ClassExist = TRUE;
2123 UsbClassText.SubClassExist = TRUE;
2124
2125 return ConvertFromTextUsbClass (TextDeviceNode, &UsbClassText);
2126 }
2127
2128 /**
2129 Converts a text device path node to USB audio device path structure.
2130
2131 @param TextDeviceNode The input Text device path node.
2132
2133 @return A pointer to the newly-created USB audio device path structure.
2134
2135 **/
2136 EFI_DEVICE_PATH_PROTOCOL *
2137 DevPathFromTextUsbAudio (
2138 IN CHAR16 *TextDeviceNode
2139 )
2140 {
2141 USB_CLASS_TEXT UsbClassText;
2142
2143 UsbClassText.ClassExist = FALSE;
2144 UsbClassText.Class = USB_CLASS_AUDIO;
2145 UsbClassText.SubClassExist = TRUE;
2146
2147 return ConvertFromTextUsbClass (TextDeviceNode, &UsbClassText);
2148 }
2149
2150 /**
2151 Converts a text device path node to USB CDC Control device path structure.
2152
2153 @param TextDeviceNode The input Text device path node.
2154
2155 @return A pointer to the newly-created USB CDC Control device path structure.
2156
2157 **/
2158 EFI_DEVICE_PATH_PROTOCOL *
2159 DevPathFromTextUsbCDCControl (
2160 IN CHAR16 *TextDeviceNode
2161 )
2162 {
2163 USB_CLASS_TEXT UsbClassText;
2164
2165 UsbClassText.ClassExist = FALSE;
2166 UsbClassText.Class = USB_CLASS_CDCCONTROL;
2167 UsbClassText.SubClassExist = TRUE;
2168
2169 return ConvertFromTextUsbClass (TextDeviceNode, &UsbClassText);
2170 }
2171
2172 /**
2173 Converts a text device path node to USB HID device path structure.
2174
2175 @param TextDeviceNode The input Text device path node.
2176
2177 @return A pointer to the newly-created USB HID device path structure.
2178
2179 **/
2180 EFI_DEVICE_PATH_PROTOCOL *
2181 DevPathFromTextUsbHID (
2182 IN CHAR16 *TextDeviceNode
2183 )
2184 {
2185 USB_CLASS_TEXT UsbClassText;
2186
2187 UsbClassText.ClassExist = FALSE;
2188 UsbClassText.Class = USB_CLASS_HID;
2189 UsbClassText.SubClassExist = TRUE;
2190
2191 return ConvertFromTextUsbClass (TextDeviceNode, &UsbClassText);
2192 }
2193
2194 /**
2195 Converts a text device path node to USB Image device path structure.
2196
2197 @param TextDeviceNode The input Text device path node.
2198
2199 @return A pointer to the newly-created USB Image device path structure.
2200
2201 **/
2202 EFI_DEVICE_PATH_PROTOCOL *
2203 DevPathFromTextUsbImage (
2204 IN CHAR16 *TextDeviceNode
2205 )
2206 {
2207 USB_CLASS_TEXT UsbClassText;
2208
2209 UsbClassText.ClassExist = FALSE;
2210 UsbClassText.Class = USB_CLASS_IMAGE;
2211 UsbClassText.SubClassExist = TRUE;
2212
2213 return ConvertFromTextUsbClass (TextDeviceNode, &UsbClassText);
2214 }
2215
2216 /**
2217 Converts a text device path node to USB Print device path structure.
2218
2219 @param TextDeviceNode The input Text device path node.
2220
2221 @return A pointer to the newly-created USB Print device path structure.
2222
2223 **/
2224 EFI_DEVICE_PATH_PROTOCOL *
2225 DevPathFromTextUsbPrinter (
2226 IN CHAR16 *TextDeviceNode
2227 )
2228 {
2229 USB_CLASS_TEXT UsbClassText;
2230
2231 UsbClassText.ClassExist = FALSE;
2232 UsbClassText.Class = USB_CLASS_PRINTER;
2233 UsbClassText.SubClassExist = TRUE;
2234
2235 return ConvertFromTextUsbClass (TextDeviceNode, &UsbClassText);
2236 }
2237
2238 /**
2239 Converts a text device path node to USB mass storage device path structure.
2240
2241 @param TextDeviceNode The input Text device path node.
2242
2243 @return A pointer to the newly-created USB mass storage device path structure.
2244
2245 **/
2246 EFI_DEVICE_PATH_PROTOCOL *
2247 DevPathFromTextUsbMassStorage (
2248 IN CHAR16 *TextDeviceNode
2249 )
2250 {
2251 USB_CLASS_TEXT UsbClassText;
2252
2253 UsbClassText.ClassExist = FALSE;
2254 UsbClassText.Class = USB_CLASS_MASS_STORAGE;
2255 UsbClassText.SubClassExist = TRUE;
2256
2257 return ConvertFromTextUsbClass (TextDeviceNode, &UsbClassText);
2258 }
2259
2260 /**
2261 Converts a text device path node to USB HUB device path structure.
2262
2263 @param TextDeviceNode The input Text device path node.
2264
2265 @return A pointer to the newly-created USB HUB device path structure.
2266
2267 **/
2268 EFI_DEVICE_PATH_PROTOCOL *
2269 DevPathFromTextUsbHub (
2270 IN CHAR16 *TextDeviceNode
2271 )
2272 {
2273 USB_CLASS_TEXT UsbClassText;
2274
2275 UsbClassText.ClassExist = FALSE;
2276 UsbClassText.Class = USB_CLASS_HUB;
2277 UsbClassText.SubClassExist = TRUE;
2278
2279 return ConvertFromTextUsbClass (TextDeviceNode, &UsbClassText);
2280 }
2281
2282 /**
2283 Converts a text device path node to USB CDC data device path structure.
2284
2285 @param TextDeviceNode The input Text device path node.
2286
2287 @return A pointer to the newly-created USB CDC data device path structure.
2288
2289 **/
2290 EFI_DEVICE_PATH_PROTOCOL *
2291 DevPathFromTextUsbCDCData (
2292 IN CHAR16 *TextDeviceNode
2293 )
2294 {
2295 USB_CLASS_TEXT UsbClassText;
2296
2297 UsbClassText.ClassExist = FALSE;
2298 UsbClassText.Class = USB_CLASS_CDCDATA;
2299 UsbClassText.SubClassExist = TRUE;
2300
2301 return ConvertFromTextUsbClass (TextDeviceNode, &UsbClassText);
2302 }
2303
2304 /**
2305 Converts a text device path node to USB smart card device path structure.
2306
2307 @param TextDeviceNode The input Text device path node.
2308
2309 @return A pointer to the newly-created USB smart card device path structure.
2310
2311 **/
2312 EFI_DEVICE_PATH_PROTOCOL *
2313 DevPathFromTextUsbSmartCard (
2314 IN CHAR16 *TextDeviceNode
2315 )
2316 {
2317 USB_CLASS_TEXT UsbClassText;
2318
2319 UsbClassText.ClassExist = FALSE;
2320 UsbClassText.Class = USB_CLASS_SMART_CARD;
2321 UsbClassText.SubClassExist = TRUE;
2322
2323 return ConvertFromTextUsbClass (TextDeviceNode, &UsbClassText);
2324 }
2325
2326 /**
2327 Converts a text device path node to USB video device path structure.
2328
2329 @param TextDeviceNode The input Text device path node.
2330
2331 @return A pointer to the newly-created USB video device path structure.
2332
2333 **/
2334 EFI_DEVICE_PATH_PROTOCOL *
2335 DevPathFromTextUsbVideo (
2336 IN CHAR16 *TextDeviceNode
2337 )
2338 {
2339 USB_CLASS_TEXT UsbClassText;
2340
2341 UsbClassText.ClassExist = FALSE;
2342 UsbClassText.Class = USB_CLASS_VIDEO;
2343 UsbClassText.SubClassExist = TRUE;
2344
2345 return ConvertFromTextUsbClass (TextDeviceNode, &UsbClassText);
2346 }
2347
2348 /**
2349 Converts a text device path node to USB diagnostic device path structure.
2350
2351 @param TextDeviceNode The input Text device path node.
2352
2353 @return A pointer to the newly-created USB diagnostic device path structure.
2354
2355 **/
2356 EFI_DEVICE_PATH_PROTOCOL *
2357 DevPathFromTextUsbDiagnostic (
2358 IN CHAR16 *TextDeviceNode
2359 )
2360 {
2361 USB_CLASS_TEXT UsbClassText;
2362
2363 UsbClassText.ClassExist = FALSE;
2364 UsbClassText.Class = USB_CLASS_DIAGNOSTIC;
2365 UsbClassText.SubClassExist = TRUE;
2366
2367 return ConvertFromTextUsbClass (TextDeviceNode, &UsbClassText);
2368 }
2369
2370 /**
2371 Converts a text device path node to USB wireless device path structure.
2372
2373 @param TextDeviceNode The input Text device path node.
2374
2375 @return A pointer to the newly-created USB wireless device path structure.
2376
2377 **/
2378 EFI_DEVICE_PATH_PROTOCOL *
2379 DevPathFromTextUsbWireless (
2380 IN CHAR16 *TextDeviceNode
2381 )
2382 {
2383 USB_CLASS_TEXT UsbClassText;
2384
2385 UsbClassText.ClassExist = FALSE;
2386 UsbClassText.Class = USB_CLASS_WIRELESS;
2387 UsbClassText.SubClassExist = TRUE;
2388
2389 return ConvertFromTextUsbClass (TextDeviceNode, &UsbClassText);
2390 }
2391
2392 /**
2393 Converts a text device path node to USB device firmware update device path structure.
2394
2395 @param TextDeviceNode The input Text device path node.
2396
2397 @return A pointer to the newly-created USB device firmware update device path structure.
2398
2399 **/
2400 EFI_DEVICE_PATH_PROTOCOL *
2401 DevPathFromTextUsbDeviceFirmwareUpdate (
2402 IN CHAR16 *TextDeviceNode
2403 )
2404 {
2405 USB_CLASS_TEXT UsbClassText;
2406
2407 UsbClassText.ClassExist = FALSE;
2408 UsbClassText.Class = USB_CLASS_RESERVE;
2409 UsbClassText.SubClassExist = FALSE;
2410 UsbClassText.SubClass = USB_SUBCLASS_FW_UPDATE;
2411
2412 return ConvertFromTextUsbClass (TextDeviceNode, &UsbClassText);
2413 }
2414
2415 /**
2416 Converts a text device path node to USB IRDA bridge device path structure.
2417
2418 @param TextDeviceNode The input Text device path node.
2419
2420 @return A pointer to the newly-created USB IRDA bridge device path structure.
2421
2422 **/
2423 EFI_DEVICE_PATH_PROTOCOL *
2424 DevPathFromTextUsbIrdaBridge (
2425 IN CHAR16 *TextDeviceNode
2426 )
2427 {
2428 USB_CLASS_TEXT UsbClassText;
2429
2430 UsbClassText.ClassExist = FALSE;
2431 UsbClassText.Class = USB_CLASS_RESERVE;
2432 UsbClassText.SubClassExist = FALSE;
2433 UsbClassText.SubClass = USB_SUBCLASS_IRDA_BRIDGE;
2434
2435 return ConvertFromTextUsbClass (TextDeviceNode, &UsbClassText);
2436 }
2437
2438 /**
2439 Converts a text device path node to USB text and measurement device path structure.
2440
2441 @param TextDeviceNode The input Text device path node.
2442
2443 @return A pointer to the newly-created USB text and measurement device path structure.
2444
2445 **/
2446 EFI_DEVICE_PATH_PROTOCOL *
2447 DevPathFromTextUsbTestAndMeasurement (
2448 IN CHAR16 *TextDeviceNode
2449 )
2450 {
2451 USB_CLASS_TEXT UsbClassText;
2452
2453 UsbClassText.ClassExist = FALSE;
2454 UsbClassText.Class = USB_CLASS_RESERVE;
2455 UsbClassText.SubClassExist = FALSE;
2456 UsbClassText.SubClass = USB_SUBCLASS_TEST;
2457
2458 return ConvertFromTextUsbClass (TextDeviceNode, &UsbClassText);
2459 }
2460
2461 /**
2462 Converts a text device path node to USB WWID device path structure.
2463
2464 @param TextDeviceNode The input Text device path node.
2465
2466 @return A pointer to the newly-created USB WWID device path structure.
2467
2468 **/
2469 EFI_DEVICE_PATH_PROTOCOL *
2470 DevPathFromTextUsbWwid (
2471 IN CHAR16 *TextDeviceNode
2472 )
2473 {
2474 CHAR16 *VIDStr;
2475 CHAR16 *PIDStr;
2476 CHAR16 *InterfaceNumStr;
2477 CHAR16 *SerialNumberStr;
2478 USB_WWID_DEVICE_PATH *UsbWwid;
2479 UINTN SerialNumberStrLen;
2480
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'\"'
2489 ) {
2490 SerialNumberStr[SerialNumberStrLen - 1] = L'\0';
2491 SerialNumberStr++;
2492 SerialNumberStrLen -= 2;
2493 }
2494 UsbWwid = (USB_WWID_DEVICE_PATH *) CreateDeviceNode (
2495 MESSAGING_DEVICE_PATH,
2496 MSG_USB_WWID_DP,
2497 (UINT16) (sizeof (USB_WWID_DEVICE_PATH) + SerialNumberStrLen * sizeof (CHAR16))
2498 );
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);
2503
2504 return (EFI_DEVICE_PATH_PROTOCOL *) UsbWwid;
2505 }
2506
2507 /**
2508 Converts a text device path node to Logic Unit device path structure.
2509
2510 @param TextDeviceNode The input Text device path node.
2511
2512 @return A pointer to the newly-created Logic Unit device path structure.
2513
2514 **/
2515 EFI_DEVICE_PATH_PROTOCOL *
2516 DevPathFromTextUnit (
2517 IN CHAR16 *TextDeviceNode
2518 )
2519 {
2520 CHAR16 *LunStr;
2521 DEVICE_LOGICAL_UNIT_DEVICE_PATH *LogicalUnit;
2522
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)
2528 );
2529
2530 LogicalUnit->Lun = (UINT8) Strtoi (LunStr);
2531
2532 return (EFI_DEVICE_PATH_PROTOCOL *) LogicalUnit;
2533 }
2534
2535 /**
2536 Converts a text device path node to iSCSI device path structure.
2537
2538 @param TextDeviceNode The input Text device path node.
2539
2540 @return A pointer to the newly-created iSCSI device path structure.
2541
2542 **/
2543 EFI_DEVICE_PATH_PROTOCOL *
2544 DevPathFromTextiSCSI (
2545 IN CHAR16 *TextDeviceNode
2546 )
2547 {
2548 UINT16 Options;
2549 CHAR16 *NameStr;
2550 CHAR16 *PortalGroupStr;
2551 CHAR16 *LunStr;
2552 CHAR16 *HeaderDigestStr;
2553 CHAR16 *DataDigestStr;
2554 CHAR16 *AuthenticationStr;
2555 CHAR16 *ProtocolStr;
2556 CHAR8 *AsciiStr;
2557 ISCSI_DEVICE_PATH_WITH_NAME *ISCSIDevPath;
2558
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,
2568 MSG_ISCSI_DP,
2569 (UINT16) (sizeof (ISCSI_DEVICE_PATH_WITH_NAME) + StrLen (NameStr))
2570 );
2571
2572 AsciiStr = ISCSIDevPath->TargetName;
2573 StrToAscii (NameStr, &AsciiStr);
2574
2575 ISCSIDevPath->TargetPortalGroupTag = (UINT16) Strtoi (PortalGroupStr);
2576 Strtoi64 (LunStr, &ISCSIDevPath->Lun);
2577
2578 Options = 0x0000;
2579 if (StrCmp (HeaderDigestStr, L"CRC32C") == 0) {
2580 Options |= 0x0002;
2581 }
2582
2583 if (StrCmp (DataDigestStr, L"CRC32C") == 0) {
2584 Options |= 0x0008;
2585 }
2586
2587 if (StrCmp (AuthenticationStr, L"None") == 0) {
2588 Options |= 0x0800;
2589 }
2590
2591 if (StrCmp (AuthenticationStr, L"CHAP_UNI") == 0) {
2592 Options |= 0x1000;
2593 }
2594
2595 ISCSIDevPath->LoginOption = (UINT16) Options;
2596
2597 ISCSIDevPath->NetworkProtocol = (UINT16) StrCmp (ProtocolStr, L"TCP");
2598
2599 return (EFI_DEVICE_PATH_PROTOCOL *) ISCSIDevPath;
2600 }
2601
2602 /**
2603 Converts a text device path node to VLAN device path structure.
2604
2605 @param TextDeviceNode The input Text device path node.
2606
2607 @return A pointer to the newly-created VLAN device path structure.
2608
2609 **/
2610 EFI_DEVICE_PATH_PROTOCOL *
2611 DevPathFromTextVlan (
2612 IN CHAR16 *TextDeviceNode
2613 )
2614 {
2615 CHAR16 *VlanStr;
2616 VLAN_DEVICE_PATH *Vlan;
2617
2618 VlanStr = GetNextParamStr (&TextDeviceNode);
2619 Vlan = (VLAN_DEVICE_PATH *) CreateDeviceNode (
2620 MESSAGING_DEVICE_PATH,
2621 MSG_VLAN_DP,
2622 (UINT16) sizeof (VLAN_DEVICE_PATH)
2623 );
2624
2625 Vlan->VlanId = (UINT16) Strtoi (VlanStr);
2626
2627 return (EFI_DEVICE_PATH_PROTOCOL *) Vlan;
2628 }
2629
2630 /**
2631 Converts a media text device path node to media device path structure.
2632
2633 @param TextDeviceNode The input Text device path node.
2634
2635 @return A pointer to media device path structure.
2636
2637 **/
2638 EFI_DEVICE_PATH_PROTOCOL *
2639 DevPathFromTextMediaPath (
2640 IN CHAR16 *TextDeviceNode
2641 )
2642 {
2643 return DevPathFromTextGenericPath (MEDIA_DEVICE_PATH, TextDeviceNode);
2644 }
2645
2646 /**
2647 Converts a text device path node to HD device path structure.
2648
2649 @param TextDeviceNode The input Text device path node.
2650
2651 @return A pointer to the newly-created HD device path structure.
2652
2653 **/
2654 EFI_DEVICE_PATH_PROTOCOL *
2655 DevPathFromTextHD (
2656 IN CHAR16 *TextDeviceNode
2657 )
2658 {
2659 CHAR16 *PartitionStr;
2660 CHAR16 *TypeStr;
2661 CHAR16 *SignatureStr;
2662 CHAR16 *StartStr;
2663 CHAR16 *SizeStr;
2664 UINT32 Signature32;
2665 EFI_GUID SignatureGuid;
2666 HARDDRIVE_DEVICE_PATH *Hd;
2667
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 (
2674 MEDIA_DEVICE_PATH,
2675 MEDIA_HARDDRIVE_DP,
2676 (UINT16) sizeof (HARDDRIVE_DEVICE_PATH)
2677 );
2678
2679 Hd->PartitionNumber = (UINT32) Strtoi (PartitionStr);
2680
2681 ZeroMem (Hd->Signature, 16);
2682 Hd->MBRType = (UINT8) 0;
2683
2684 if (StrCmp (TypeStr, L"MBR") == 0) {
2685 Hd->SignatureType = SIGNATURE_TYPE_MBR;
2686 Hd->MBRType = 0x01;
2687
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;
2692 Hd->MBRType = 0x02;
2693
2694 StrToGuid (SignatureStr, &SignatureGuid);
2695 CopyMem (Hd->Signature, &SignatureGuid, sizeof (EFI_GUID));
2696 } else {
2697 Hd->SignatureType = (UINT8) Strtoi (TypeStr);
2698 }
2699
2700 Strtoi64 (StartStr, &Hd->PartitionStart);
2701 Strtoi64 (SizeStr, &Hd->PartitionSize);
2702
2703 return (EFI_DEVICE_PATH_PROTOCOL *) Hd;
2704 }
2705
2706 /**
2707 Converts a text device path node to CDROM device path structure.
2708
2709 @param TextDeviceNode The input Text device path node.
2710
2711 @return A pointer to the newly-created CDROM device path structure.
2712
2713 **/
2714 EFI_DEVICE_PATH_PROTOCOL *
2715 DevPathFromTextCDROM (
2716 IN CHAR16 *TextDeviceNode
2717 )
2718 {
2719 CHAR16 *EntryStr;
2720 CHAR16 *StartStr;
2721 CHAR16 *SizeStr;
2722 CDROM_DEVICE_PATH *CDROMDevPath;
2723
2724 EntryStr = GetNextParamStr (&TextDeviceNode);
2725 StartStr = GetNextParamStr (&TextDeviceNode);
2726 SizeStr = GetNextParamStr (&TextDeviceNode);
2727 CDROMDevPath = (CDROM_DEVICE_PATH *) CreateDeviceNode (
2728 MEDIA_DEVICE_PATH,
2729 MEDIA_CDROM_DP,
2730 (UINT16) sizeof (CDROM_DEVICE_PATH)
2731 );
2732
2733 CDROMDevPath->BootEntry = (UINT32) Strtoi (EntryStr);
2734 Strtoi64 (StartStr, &CDROMDevPath->PartitionStart);
2735 Strtoi64 (SizeStr, &CDROMDevPath->PartitionSize);
2736
2737 return (EFI_DEVICE_PATH_PROTOCOL *) CDROMDevPath;
2738 }
2739
2740 /**
2741 Converts a text device path node to Vendor-defined media device path structure.
2742
2743 @param TextDeviceNode The input Text device path node.
2744
2745 @return A pointer to the newly-created Vendor-defined media device path structure.
2746
2747 **/
2748 EFI_DEVICE_PATH_PROTOCOL *
2749 DevPathFromTextVenMedia (
2750 IN CHAR16 *TextDeviceNode
2751 )
2752 {
2753 return ConvertFromTextVendor (
2754 TextDeviceNode,
2755 MEDIA_DEVICE_PATH,
2756 MEDIA_VENDOR_DP
2757 );
2758 }
2759
2760 /**
2761 Converts a text device path node to File device path structure.
2762
2763 @param TextDeviceNode The input Text device path node.
2764
2765 @return A pointer to the newly-created File device path structure.
2766
2767 **/
2768 EFI_DEVICE_PATH_PROTOCOL *
2769 DevPathFromTextFilePath (
2770 IN CHAR16 *TextDeviceNode
2771 )
2772 {
2773 FILEPATH_DEVICE_PATH *File;
2774
2775 File = (FILEPATH_DEVICE_PATH *) CreateDeviceNode (
2776 MEDIA_DEVICE_PATH,
2777 MEDIA_FILEPATH_DP,
2778 (UINT16) (sizeof (FILEPATH_DEVICE_PATH) + StrLen (TextDeviceNode) * 2)
2779 );
2780
2781 StrCpy (File->PathName, TextDeviceNode);
2782
2783 return (EFI_DEVICE_PATH_PROTOCOL *) File;
2784 }
2785
2786 /**
2787 Converts a text device path node to Media protocol device path structure.
2788
2789 @param TextDeviceNode The input Text device path node.
2790
2791 @return A pointer to the newly-created Media protocol device path structure.
2792
2793 **/
2794 EFI_DEVICE_PATH_PROTOCOL *
2795 DevPathFromTextMedia (
2796 IN CHAR16 *TextDeviceNode
2797 )
2798 {
2799 CHAR16 *GuidStr;
2800 MEDIA_PROTOCOL_DEVICE_PATH *Media;
2801
2802 GuidStr = GetNextParamStr (&TextDeviceNode);
2803 Media = (MEDIA_PROTOCOL_DEVICE_PATH *) CreateDeviceNode (
2804 MEDIA_DEVICE_PATH,
2805 MEDIA_PROTOCOL_DP,
2806 (UINT16) sizeof (MEDIA_PROTOCOL_DEVICE_PATH)
2807 );
2808
2809 StrToGuid (GuidStr, &Media->Protocol);
2810
2811 return (EFI_DEVICE_PATH_PROTOCOL *) Media;
2812 }
2813
2814 /**
2815 Converts a text device path node to firmware volume device path structure.
2816
2817 @param TextDeviceNode The input Text device path node.
2818
2819 @return A pointer to the newly-created firmware volume device path structure.
2820
2821 **/
2822 EFI_DEVICE_PATH_PROTOCOL *
2823 DevPathFromTextFv (
2824 IN CHAR16 *TextDeviceNode
2825 )
2826 {
2827 CHAR16 *GuidStr;
2828 MEDIA_FW_VOL_DEVICE_PATH *Fv;
2829
2830 GuidStr = GetNextParamStr (&TextDeviceNode);
2831 Fv = (MEDIA_FW_VOL_DEVICE_PATH *) CreateDeviceNode (
2832 MEDIA_DEVICE_PATH,
2833 MEDIA_PIWG_FW_VOL_DP,
2834 (UINT16) sizeof (MEDIA_FW_VOL_DEVICE_PATH)
2835 );
2836
2837 StrToGuid (GuidStr, &Fv->FvName);
2838
2839 return (EFI_DEVICE_PATH_PROTOCOL *) Fv;
2840 }
2841
2842 /**
2843 Converts a text device path node to firmware file device path structure.
2844
2845 @param TextDeviceNode The input Text device path node.
2846
2847 @return A pointer to the newly-created firmware file device path structure.
2848
2849 **/
2850 EFI_DEVICE_PATH_PROTOCOL *
2851 DevPathFromTextFvFile (
2852 IN CHAR16 *TextDeviceNode
2853 )
2854 {
2855 CHAR16 *GuidStr;
2856 MEDIA_FW_VOL_FILEPATH_DEVICE_PATH *FvFile;
2857
2858 GuidStr = GetNextParamStr (&TextDeviceNode);
2859 FvFile = (MEDIA_FW_VOL_FILEPATH_DEVICE_PATH *) CreateDeviceNode (
2860 MEDIA_DEVICE_PATH,
2861 MEDIA_PIWG_FW_FILE_DP,
2862 (UINT16) sizeof (MEDIA_FW_VOL_FILEPATH_DEVICE_PATH)
2863 );
2864
2865 StrToGuid (GuidStr, &FvFile->FvFileName);
2866
2867 return (EFI_DEVICE_PATH_PROTOCOL *) FvFile;
2868 }
2869
2870 /**
2871 Converts a text device path node to text relative offset device path structure.
2872
2873 @param TextDeviceNode The input Text device path node.
2874
2875 @return A pointer to the newly-created Text device path structure.
2876
2877 **/
2878 EFI_DEVICE_PATH_PROTOCOL *
2879 DevPathFromTextRelativeOffsetRange (
2880 IN CHAR16 *TextDeviceNode
2881 )
2882 {
2883 CHAR16 *StartingOffsetStr;
2884 CHAR16 *EndingOffsetStr;
2885 MEDIA_RELATIVE_OFFSET_RANGE_DEVICE_PATH *Offset;
2886
2887 StartingOffsetStr = GetNextParamStr (&TextDeviceNode);
2888 EndingOffsetStr = GetNextParamStr (&TextDeviceNode);
2889 Offset = (MEDIA_RELATIVE_OFFSET_RANGE_DEVICE_PATH *) CreateDeviceNode (
2890 MEDIA_DEVICE_PATH,
2891 MEDIA_RELATIVE_OFFSET_RANGE_DP,
2892 (UINT16) sizeof (MEDIA_RELATIVE_OFFSET_RANGE_DEVICE_PATH)
2893 );
2894
2895 Strtoi64 (StartingOffsetStr, &Offset->StartingOffset);
2896 Strtoi64 (EndingOffsetStr, &Offset->EndingOffset);
2897
2898 return (EFI_DEVICE_PATH_PROTOCOL *) Offset;
2899 }
2900
2901
2902 /**
2903 Converts a BBS text device path node to BBS device path structure.
2904
2905 @param TextDeviceNode The input Text device path node.
2906
2907 @return A pointer to BBS device path structure.
2908
2909 **/
2910 EFI_DEVICE_PATH_PROTOCOL *
2911 DevPathFromTextBbsPath (
2912 IN CHAR16 *TextDeviceNode
2913 )
2914 {
2915 return DevPathFromTextGenericPath (BBS_DEVICE_PATH, TextDeviceNode);
2916 }
2917
2918 /**
2919 Converts a text device path node to BIOS Boot Specification device path structure.
2920
2921 @param TextDeviceNode The input Text device path node.
2922
2923 @return A pointer to the newly-created BIOS Boot Specification device path structure.
2924
2925 **/
2926 EFI_DEVICE_PATH_PROTOCOL *
2927 DevPathFromTextBBS (
2928 IN CHAR16 *TextDeviceNode
2929 )
2930 {
2931 CHAR16 *TypeStr;
2932 CHAR16 *IdStr;
2933 CHAR16 *FlagsStr;
2934 CHAR8 *AsciiStr;
2935 BBS_BBS_DEVICE_PATH *Bbs;
2936
2937 TypeStr = GetNextParamStr (&TextDeviceNode);
2938 IdStr = GetNextParamStr (&TextDeviceNode);
2939 FlagsStr = GetNextParamStr (&TextDeviceNode);
2940 Bbs = (BBS_BBS_DEVICE_PATH *) CreateDeviceNode (
2941 BBS_DEVICE_PATH,
2942 BBS_BBS_DP,
2943 (UINT16) (sizeof (BBS_BBS_DEVICE_PATH) + StrLen (IdStr))
2944 );
2945
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;
2958 } else {
2959 Bbs->DeviceType = (UINT16) Strtoi (TypeStr);
2960 }
2961
2962 AsciiStr = Bbs->String;
2963 StrToAscii (IdStr, &AsciiStr);
2964
2965 Bbs->StatusFlag = (UINT16) Strtoi (FlagsStr);
2966
2967 return (EFI_DEVICE_PATH_PROTOCOL *) Bbs;
2968 }
2969
2970 /**
2971 Converts a text device path node to SATA device path structure.
2972
2973 @param TextDeviceNode The input Text device path node.
2974
2975 @return A pointer to the newly-created SATA device path structure.
2976
2977 **/
2978 EFI_DEVICE_PATH_PROTOCOL *
2979 DevPathFromTextSata (
2980 IN CHAR16 *TextDeviceNode
2981 )
2982 {
2983 SATA_DEVICE_PATH *Sata;
2984 CHAR16 *Param1;
2985 CHAR16 *Param2;
2986 CHAR16 *Param3;
2987
2988 Param1 = GetNextParamStr (&TextDeviceNode);
2989 Param2 = GetNextParamStr (&TextDeviceNode);
2990 Param3 = GetNextParamStr (&TextDeviceNode);
2991
2992 Sata = (SATA_DEVICE_PATH *) CreateDeviceNode (
2993 MESSAGING_DEVICE_PATH,
2994 MSG_SATA_DP,
2995 (UINT16) sizeof (SATA_DEVICE_PATH)
2996 );
2997 Sata->HBAPortNumber = (UINT16) Strtoi (Param1);
2998 Sata->PortMultiplierPortNumber = (UINT16) Strtoi (Param2);
2999 Sata->Lun = (UINT16) Strtoi (Param3);
3000
3001 return (EFI_DEVICE_PATH_PROTOCOL *) Sata;
3002 }
3003
3004 GLOBAL_REMOVE_IF_UNREFERENCED DEVICE_PATH_FROM_TEXT_TABLE mUefiDevicePathLibDevPathFromTextTable[] = {
3005 {L"Path", DevPathFromTextPath },
3006
3007 {L"HardwarePath", DevPathFromTextHardwarePath },
3008 {L"Pci", DevPathFromTextPci },
3009 {L"PcCard", DevPathFromTextPcCard },
3010 {L"MemoryMapped", DevPathFromTextMemoryMapped },
3011 {L"VenHw", DevPathFromTextVenHw },
3012 {L"Ctrl", DevPathFromTextCtrl },
3013
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 },
3025
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 },
3068
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 },
3077
3078 {L"BbsPath", DevPathFromTextBbsPath },
3079 {L"BBS", DevPathFromTextBBS },
3080 {L"Sata", DevPathFromTextSata },
3081 {NULL, NULL}
3082 };
3083
3084 /**
3085 Convert text to the binary representation of a device node.
3086
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.
3090
3091 @return A pointer to the EFI device node or NULL if TextDeviceNode is NULL or there was
3092 insufficient memory or text unsupported.
3093
3094 **/
3095 EFI_DEVICE_PATH_PROTOCOL *
3096 EFIAPI
3097 UefiDevicePathLibConvertTextToDeviceNode (
3098 IN CONST CHAR16 *TextDeviceNode
3099 )
3100 {
3101 DEVICE_PATH_FROM_TEXT FromText;
3102 CHAR16 *ParamStr;
3103 EFI_DEVICE_PATH_PROTOCOL *DeviceNode;
3104 CHAR16 *DeviceNodeStr;
3105 UINTN Index;
3106
3107 if ((TextDeviceNode == NULL) || (IS_NULL (*TextDeviceNode))) {
3108 return NULL;
3109 }
3110
3111 ParamStr = NULL;
3112 FromText = NULL;
3113 DeviceNodeStr = UefiDevicePathLibStrDuplicate (TextDeviceNode);
3114 ASSERT (DeviceNodeStr != NULL);
3115
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;
3120 break;
3121 }
3122 }
3123
3124 if (FromText == NULL) {
3125 //
3126 // A file path
3127 //
3128 FromText = DevPathFromTextFilePath;
3129 DeviceNode = FromText (DeviceNodeStr);
3130 } else {
3131 DeviceNode = FromText (ParamStr);
3132 FreePool (ParamStr);
3133 }
3134
3135 FreePool (DeviceNodeStr);
3136
3137 return DeviceNode;
3138 }
3139
3140 /**
3141 Convert text to the binary representation of a device path.
3142
3143
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.
3147
3148 @return A pointer to the allocated device path or NULL if TextDeviceNode is NULL or
3149 there was insufficient memory.
3150
3151 **/
3152 EFI_DEVICE_PATH_PROTOCOL *
3153 EFIAPI
3154 UefiDevicePathLibConvertTextToDevicePath (
3155 IN CONST CHAR16 *TextDevicePath
3156 )
3157 {
3158 EFI_DEVICE_PATH_PROTOCOL *DeviceNode;
3159 EFI_DEVICE_PATH_PROTOCOL *NewDevicePath;
3160 CHAR16 *DevicePathStr;
3161 CHAR16 *Str;
3162 CHAR16 *DeviceNodeStr;
3163 BOOLEAN IsInstanceEnd;
3164 EFI_DEVICE_PATH_PROTOCOL *DevicePath;
3165
3166 if ((TextDevicePath == NULL) || (IS_NULL (*TextDevicePath))) {
3167 return NULL;
3168 }
3169
3170 DevicePath = (EFI_DEVICE_PATH_PROTOCOL *) AllocatePool (END_DEVICE_PATH_LENGTH);
3171 ASSERT (DevicePath != NULL);
3172 SetDevicePathEndNode (DevicePath);
3173
3174 DevicePathStr = UefiDevicePathLibStrDuplicate (TextDevicePath);