/****************************************************************************** * * Copyright (C) 2014 Google, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at: * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * ******************************************************************************/ #pragma once #include <hardware/bluetooth.h> #include <stdbool.h> typedef struct uuid_string_t uuid_string_t; // Creates uuid string structure to hold a well formed UUID // string. Must release resources with |uuid_string_free|. // Returns NULL if no memory. uuid_string_t *uuid_string_new(void); // Frees a uuid string structure created from |uuid_string_new|. // |uuid_string| may be NULL. void uuid_string_free(uuid_string_t *uuid_string); // Returns a string pointer to the well formed UUID string // entry. |uuid_string| must not be NULL. const char *uuid_string_data(const uuid_string_t *uuid_string); // Creates uuid structure from a well formed UUID string // |uuid_string|. The caller takes ownership of the uuid // structure and must release resources with |uuid_free|. // |uuid_string| must not be NULL. // // Returns NULL if |uuid_string| is malformed or no memory. // // A well formed UUID string is structured like this: // "00112233-4455-6677-8899-aabbccddeeff" bt_uuid_t *uuid_new(const char *uuid_string); // Frees a uuid structure created from |uuid_new| and friends. // |uuid| may be NULL. void uuid_free(bt_uuid_t *uuid); // Returns true if the UUID is all zeros, false otherwise. // |uuid| may not be NULL. bool uuid_is_empty(const bt_uuid_t *uuid); // Returns true if the two UUIDs are equal, false otherwise. // |first| and |second| may not be NULL. bool uuid_is_equal(const bt_uuid_t *first, const bt_uuid_t *second); // Copies uuid |src| into |dest| and returns a pointer to |dest|. // |src| and |dest| must not be NULL. bt_uuid_t *uuid_copy(bt_uuid_t *dest, const bt_uuid_t *src); // Converts contents of |uuid| to a well formed UUID string // |uuid_string| using numbers and lower case letter. |uuid| // and |uuid_string| must not be NULL. void uuid_to_string(const bt_uuid_t *uuid, uuid_string_t *uuid_string); // Converts contents of |uuid| to a short uuid if possible. Returns // true if conversion is possible, false otherwise. // |uuid|, |uuid16| and |uuid32| must not be NULL. bool uuid_128_to_16(const bt_uuid_t *uuid, uint16_t *uuid16); bool uuid_128_to_32(const bt_uuid_t *uuid, uint32_t *uuid32);