1 | /****************************************************************************** |
2 | * |
3 | * Module Name: uthex -- Hex/ASCII support functions |
4 | * |
5 | *****************************************************************************/ |
6 | |
7 | /* |
8 | * Copyright (C) 2000 - 2016, Intel Corp. |
9 | * All rights reserved. |
10 | * |
11 | * Redistribution and use in source and binary forms, with or without |
12 | * modification, are permitted provided that the following conditions |
13 | * are met: |
14 | * 1. Redistributions of source code must retain the above copyright |
15 | * notice, this list of conditions, and the following disclaimer, |
16 | * without modification. |
17 | * 2. Redistributions in binary form must reproduce at minimum a disclaimer |
18 | * substantially similar to the "NO WARRANTY" disclaimer below |
19 | * ("Disclaimer") and any redistribution must be conditioned upon |
20 | * including a substantially similar Disclaimer requirement for further |
21 | * binary redistribution. |
22 | * 3. Neither the names of the above-listed copyright holders nor the names |
23 | * of any contributors may be used to endorse or promote products derived |
24 | * from this software without specific prior written permission. |
25 | * |
26 | * Alternatively, this software may be distributed under the terms of the |
27 | * GNU General Public License ("GPL") version 2 as published by the Free |
28 | * Software Foundation. |
29 | * |
30 | * NO WARRANTY |
31 | * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
32 | * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
33 | * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR |
34 | * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
35 | * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL |
36 | * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS |
37 | * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) |
38 | * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, |
39 | * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING |
40 | * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE |
41 | * POSSIBILITY OF SUCH DAMAGES. |
42 | */ |
43 | |
44 | #include "acpi.h" |
45 | #include "accommon.h" |
46 | |
47 | #define _COMPONENT ACPI_COMPILER |
48 | ACPI_MODULE_NAME ("uthex" ) |
49 | |
50 | |
51 | /* Hex to ASCII conversion table */ |
52 | |
53 | static const char AcpiGbl_HexToAscii[] = |
54 | { |
55 | '0','1','2','3','4','5','6','7','8','9','A','B','C','D','E','F' |
56 | }; |
57 | |
58 | |
59 | /******************************************************************************* |
60 | * |
61 | * FUNCTION: AcpiUtHexToAsciiChar |
62 | * |
63 | * PARAMETERS: Integer - Contains the hex digit |
64 | * Position - bit position of the digit within the |
65 | * integer (multiple of 4) |
66 | * |
67 | * RETURN: The converted Ascii character |
68 | * |
69 | * DESCRIPTION: Convert a hex digit to an Ascii character |
70 | * |
71 | ******************************************************************************/ |
72 | |
73 | char |
74 | AcpiUtHexToAsciiChar ( |
75 | UINT64 Integer, |
76 | UINT32 Position) |
77 | { |
78 | |
79 | return (AcpiGbl_HexToAscii[(Integer >> Position) & 0xF]); |
80 | } |
81 | |
82 | |
83 | /******************************************************************************* |
84 | * |
85 | * FUNCTION: AcpiUtAsciiToHexByte |
86 | * |
87 | * PARAMETERS: TwoAsciiChars - Pointer to two ASCII characters |
88 | * ReturnByte - Where converted byte is returned |
89 | * |
90 | * RETURN: Status and converted hex byte |
91 | * |
92 | * DESCRIPTION: Perform ascii-to-hex translation, exactly two ASCII characters |
93 | * to a single converted byte value. |
94 | * |
95 | ******************************************************************************/ |
96 | |
97 | ACPI_STATUS |
98 | AcpiUtAsciiToHexByte ( |
99 | char *TwoAsciiChars, |
100 | UINT8 *ReturnByte) |
101 | { |
102 | |
103 | /* Both ASCII characters must be valid hex digits */ |
104 | |
105 | if (!isxdigit ((int) TwoAsciiChars[0]) || |
106 | !isxdigit ((int) TwoAsciiChars[1])) |
107 | { |
108 | return (AE_BAD_HEX_CONSTANT); |
109 | } |
110 | |
111 | *ReturnByte = |
112 | AcpiUtAsciiCharToHex (TwoAsciiChars[1]) | |
113 | (AcpiUtAsciiCharToHex (TwoAsciiChars[0]) << 4); |
114 | |
115 | return (AE_OK); |
116 | } |
117 | |
118 | |
119 | /******************************************************************************* |
120 | * |
121 | * FUNCTION: AcpiUtAsciiCharToHex |
122 | * |
123 | * PARAMETERS: HexChar - Hex character in Ascii. Must be: |
124 | * 0-9 or A-F or a-f |
125 | * |
126 | * RETURN: The binary value of the ascii/hex character |
127 | * |
128 | * DESCRIPTION: Perform ascii-to-hex translation |
129 | * |
130 | ******************************************************************************/ |
131 | |
132 | UINT8 |
133 | AcpiUtAsciiCharToHex ( |
134 | int HexChar) |
135 | { |
136 | |
137 | /* Values 0-9 */ |
138 | |
139 | if (HexChar <= '9') |
140 | { |
141 | return ((UINT8) (HexChar - '0')); |
142 | } |
143 | |
144 | /* Upper case A-F */ |
145 | |
146 | if (HexChar <= 'F') |
147 | { |
148 | return ((UINT8) (HexChar - 0x37)); |
149 | } |
150 | |
151 | /* Lower case a-f */ |
152 | |
153 | return ((UINT8) (HexChar - 0x57)); |
154 | } |
155 | |