1*4882a593Smuzhiyun // SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0
2*4882a593Smuzhiyun /******************************************************************************
3*4882a593Smuzhiyun *
4*4882a593Smuzhiyun * Module Name: uthex -- Hex/ASCII support functions
5*4882a593Smuzhiyun *
6*4882a593Smuzhiyun * Copyright (C) 2000 - 2020, Intel Corp.
7*4882a593Smuzhiyun *
8*4882a593Smuzhiyun *****************************************************************************/
9*4882a593Smuzhiyun
10*4882a593Smuzhiyun #include <acpi/acpi.h>
11*4882a593Smuzhiyun #include "accommon.h"
12*4882a593Smuzhiyun
13*4882a593Smuzhiyun #define _COMPONENT ACPI_COMPILER
14*4882a593Smuzhiyun ACPI_MODULE_NAME("uthex")
15*4882a593Smuzhiyun
16*4882a593Smuzhiyun /* Hex to ASCII conversion table */
17*4882a593Smuzhiyun static const char acpi_gbl_hex_to_ascii[] = {
18*4882a593Smuzhiyun '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D',
19*4882a593Smuzhiyun 'E', 'F'
20*4882a593Smuzhiyun };
21*4882a593Smuzhiyun
22*4882a593Smuzhiyun /*******************************************************************************
23*4882a593Smuzhiyun *
24*4882a593Smuzhiyun * FUNCTION: acpi_ut_hex_to_ascii_char
25*4882a593Smuzhiyun *
26*4882a593Smuzhiyun * PARAMETERS: integer - Contains the hex digit
27*4882a593Smuzhiyun * position - bit position of the digit within the
28*4882a593Smuzhiyun * integer (multiple of 4)
29*4882a593Smuzhiyun *
30*4882a593Smuzhiyun * RETURN: The converted Ascii character
31*4882a593Smuzhiyun *
32*4882a593Smuzhiyun * DESCRIPTION: Convert a hex digit to an Ascii character
33*4882a593Smuzhiyun *
34*4882a593Smuzhiyun ******************************************************************************/
35*4882a593Smuzhiyun
acpi_ut_hex_to_ascii_char(u64 integer,u32 position)36*4882a593Smuzhiyun char acpi_ut_hex_to_ascii_char(u64 integer, u32 position)
37*4882a593Smuzhiyun {
38*4882a593Smuzhiyun u64 index;
39*4882a593Smuzhiyun
40*4882a593Smuzhiyun acpi_ut_short_shift_right(integer, position, &index);
41*4882a593Smuzhiyun return (acpi_gbl_hex_to_ascii[index & 0xF]);
42*4882a593Smuzhiyun }
43*4882a593Smuzhiyun
44*4882a593Smuzhiyun /*******************************************************************************
45*4882a593Smuzhiyun *
46*4882a593Smuzhiyun * FUNCTION: acpi_ut_ascii_to_hex_byte
47*4882a593Smuzhiyun *
48*4882a593Smuzhiyun * PARAMETERS: two_ascii_chars - Pointer to two ASCII characters
49*4882a593Smuzhiyun * return_byte - Where converted byte is returned
50*4882a593Smuzhiyun *
51*4882a593Smuzhiyun * RETURN: Status and converted hex byte
52*4882a593Smuzhiyun *
53*4882a593Smuzhiyun * DESCRIPTION: Perform ascii-to-hex translation, exactly two ASCII characters
54*4882a593Smuzhiyun * to a single converted byte value.
55*4882a593Smuzhiyun *
56*4882a593Smuzhiyun ******************************************************************************/
57*4882a593Smuzhiyun
acpi_ut_ascii_to_hex_byte(char * two_ascii_chars,u8 * return_byte)58*4882a593Smuzhiyun acpi_status acpi_ut_ascii_to_hex_byte(char *two_ascii_chars, u8 *return_byte)
59*4882a593Smuzhiyun {
60*4882a593Smuzhiyun
61*4882a593Smuzhiyun /* Both ASCII characters must be valid hex digits */
62*4882a593Smuzhiyun
63*4882a593Smuzhiyun if (!isxdigit((int)two_ascii_chars[0]) ||
64*4882a593Smuzhiyun !isxdigit((int)two_ascii_chars[1])) {
65*4882a593Smuzhiyun return (AE_BAD_HEX_CONSTANT);
66*4882a593Smuzhiyun }
67*4882a593Smuzhiyun
68*4882a593Smuzhiyun *return_byte =
69*4882a593Smuzhiyun acpi_ut_ascii_char_to_hex(two_ascii_chars[1]) |
70*4882a593Smuzhiyun (acpi_ut_ascii_char_to_hex(two_ascii_chars[0]) << 4);
71*4882a593Smuzhiyun
72*4882a593Smuzhiyun return (AE_OK);
73*4882a593Smuzhiyun }
74*4882a593Smuzhiyun
75*4882a593Smuzhiyun /*******************************************************************************
76*4882a593Smuzhiyun *
77*4882a593Smuzhiyun * FUNCTION: acpi_ut_ascii_char_to_hex
78*4882a593Smuzhiyun *
79*4882a593Smuzhiyun * PARAMETERS: hex_char - Hex character in Ascii. Must be:
80*4882a593Smuzhiyun * 0-9 or A-F or a-f
81*4882a593Smuzhiyun *
82*4882a593Smuzhiyun * RETURN: The binary value of the ascii/hex character
83*4882a593Smuzhiyun *
84*4882a593Smuzhiyun * DESCRIPTION: Perform ascii-to-hex translation
85*4882a593Smuzhiyun *
86*4882a593Smuzhiyun ******************************************************************************/
87*4882a593Smuzhiyun
acpi_ut_ascii_char_to_hex(int hex_char)88*4882a593Smuzhiyun u8 acpi_ut_ascii_char_to_hex(int hex_char)
89*4882a593Smuzhiyun {
90*4882a593Smuzhiyun
91*4882a593Smuzhiyun /* Values 0-9 */
92*4882a593Smuzhiyun
93*4882a593Smuzhiyun if (hex_char <= '9') {
94*4882a593Smuzhiyun return ((u8)(hex_char - '0'));
95*4882a593Smuzhiyun }
96*4882a593Smuzhiyun
97*4882a593Smuzhiyun /* Upper case A-F */
98*4882a593Smuzhiyun
99*4882a593Smuzhiyun if (hex_char <= 'F') {
100*4882a593Smuzhiyun return ((u8)(hex_char - 0x37));
101*4882a593Smuzhiyun }
102*4882a593Smuzhiyun
103*4882a593Smuzhiyun /* Lower case a-f */
104*4882a593Smuzhiyun
105*4882a593Smuzhiyun return ((u8)(hex_char - 0x57));
106*4882a593Smuzhiyun }
107