//
// Copyright (C) 2015 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 <array>
#include <string>
// TODO: Find places that break include what you use and remove this.
#include <base/logging.h>
#include <hardware/bluetooth.h>
namespace bluetooth {
class UUID {
public:
static constexpr size_t kNumBytes128 = 16;
static constexpr size_t kNumBytes32 = 4;
static constexpr size_t kNumBytes16 = 2;
typedef std::array<uint8_t, kNumBytes16> UUID16Bit;
typedef std::array<uint8_t, kNumBytes32> UUID32Bit;
typedef std::array<uint8_t, kNumBytes128> UUID128Bit;
// Creates and returns a random 128-bit UUID.
static UUID GetRandom();
// Creates and returns a UUID in which all 128 bits are equal to 0.
static UUID GetNil();
// Creates and returns a UUID in which all 128 bits are equal to 1.
static UUID GetMax();
// Construct a Bluetooth 'base' UUID.
UUID();
// BlueDroid constructor.
explicit UUID(const bt_uuid_t& uuid);
// String constructor. Only hex ASCII accepted.
explicit UUID(std::string uuid);
// std::array variants constructors.
explicit UUID(const UUID16Bit& uuid);
explicit UUID(const UUID32Bit& uuid);
explicit UUID(const UUID128Bit& uuid);
// Provide the full network-byte-ordered blob.
UUID128Bit GetFullBigEndian() const;
// Provide blob in Little endian (BlueDroid expects this).
UUID128Bit GetFullLittleEndian() const;
// Helper for bluedroid LE type.
bt_uuid_t GetBlueDroid() const;
// Returns a string representation for the UUID.
std::string ToString() const;
// Returns whether or not this UUID was initialized correctly.
bool is_valid() const { return is_valid_; }
// Returns the shortest possible representation of this UUID in bytes.
size_t GetShortestRepresentationSize() const;
bool operator<(const UUID& rhs) const;
bool operator==(const UUID& rhs) const;
inline bool operator!=(const UUID& rhs) const {
return !(*this == rhs);
}
private:
void InitializeDefault();
// Network-byte-ordered ID.
UUID128Bit id_;
// True if this UUID was initialized with a correct representation.
bool is_valid_;
};
} // namespace bluetooth
// Custom std::hash specialization so that bluetooth::UUID can be used as a key
// in std::unordered_map.
namespace std {
template<>
struct hash<bluetooth::UUID> {
std::size_t operator()(const bluetooth::UUID& key) const {
const auto& uuid_bytes = key.GetFullBigEndian();
std::hash<std::string> hash_fn;
return hash_fn(std::string((char *)uuid_bytes.data(), uuid_bytes.size()));
}
};
} // namespace std