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