1// SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0
  2/******************************************************************************
  3 *
  4 * Module Name: utuuid -- UUID support functions
  5 *
  6 * Copyright (C) 2000 - 2023, Intel Corp.
  7 *
  8 *****************************************************************************/
  9
 10#include <acpi/acpi.h>
 11#include "accommon.h"
 12
 13#define _COMPONENT          ACPI_COMPILER
 14ACPI_MODULE_NAME("utuuid")
 15
 16#if (defined ACPI_ASL_COMPILER || defined ACPI_EXEC_APP || defined ACPI_HELP_APP)
 17/*
 18 * UUID support functions.
 19 *
 20 * This table is used to convert an input UUID ascii string to a 16 byte
 21 * buffer and the reverse. The table maps a UUID buffer index 0-15 to
 22 * the index within the 36-byte UUID string where the associated 2-byte
 23 * hex value can be found.
 24 *
 25 * 36-byte UUID strings are of the form:
 26 *     aabbccdd-eeff-gghh-iijj-kkllmmnnoopp
 27 * Where aa-pp are one byte hex numbers, made up of two hex digits
 28 *
 29 * Note: This table is basically the inverse of the string-to-offset table
 30 * found in the ACPI spec in the description of the to_UUID macro.
 31 */
 32const u8 acpi_gbl_map_to_uuid_offset[UUID_BUFFER_LENGTH] = {
 33	6, 4, 2, 0, 11, 9, 16, 14, 19, 21, 24, 26, 28, 30, 32, 34
 34};
 35
 36/*******************************************************************************
 37 *
 38 * FUNCTION:    acpi_ut_convert_string_to_uuid
 39 *
 40 * PARAMETERS:  in_string           - 36-byte formatted UUID string
 41 *              uuid_buffer         - Where the 16-byte UUID buffer is returned
 42 *
 43 * RETURN:      None. Output data is returned in the uuid_buffer
 44 *
 45 * DESCRIPTION: Convert a 36-byte formatted UUID string to 16-byte UUID buffer
 46 *
 47 ******************************************************************************/
 48
 49void acpi_ut_convert_string_to_uuid(char *in_string, u8 *uuid_buffer)
 50{
 51	u32 i;
 52
 53	for (i = 0; i < UUID_BUFFER_LENGTH; i++) {
 54		uuid_buffer[i] =
 55		    (acpi_ut_ascii_char_to_hex
 56		     (in_string[acpi_gbl_map_to_uuid_offset[i]]) << 4);
 57
 58		uuid_buffer[i] |=
 59		    acpi_ut_ascii_char_to_hex(in_string
 60					      [acpi_gbl_map_to_uuid_offset[i] +
 61					       1]);
 62	}
 63}
 64
 65/*******************************************************************************
 66 *
 67 * FUNCTION:    acpi_ut_convert_uuid_to_string
 68 *
 69 * PARAMETERS:  uuid_buffer         - 16-byte UUID buffer
 70 *              out_string          - 36-byte formatted UUID string
 71 *
 72 * RETURN:      Status
 73 *
 74 * DESCRIPTION: Convert 16-byte UUID buffer to 36-byte formatted UUID string
 75 *              out_string must be 37 bytes to include null terminator.
 76 *
 77 ******************************************************************************/
 78
 79acpi_status acpi_ut_convert_uuid_to_string(char *uuid_buffer, char *out_string)
 80{
 81	u32 i;
 82
 83	if (!uuid_buffer || !out_string) {
 84		return (AE_BAD_PARAMETER);
 85	}
 86
 87	for (i = 0; i < UUID_BUFFER_LENGTH; i++) {
 88		out_string[acpi_gbl_map_to_uuid_offset[i]] =
 89		    acpi_ut_hex_to_ascii_char(uuid_buffer[i], 4);
 90
 91		out_string[acpi_gbl_map_to_uuid_offset[i] + 1] =
 92		    acpi_ut_hex_to_ascii_char(uuid_buffer[i], 0);
 93	}
 94
 95	/* Insert required hyphens (dashes) */
 96
 97	out_string[UUID_HYPHEN1_OFFSET] =
 98	    out_string[UUID_HYPHEN2_OFFSET] =
 99	    out_string[UUID_HYPHEN3_OFFSET] =
100	    out_string[UUID_HYPHEN4_OFFSET] = '-';
101
102	out_string[UUID_STRING_LENGTH] = 0;	/* Null terminate */
103	return (AE_OK);
104}
105#endif