/****************************************************************************** * * Copyright 2017 The Android Open Source Project * * 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 #include #include /** Bluetooth Address */ class RawAddress final { public: static constexpr unsigned int kLength = 6; uint8_t address[kLength]; RawAddress() = default; RawAddress(const uint8_t (&addr)[kLength]); RawAddress(const std::array array); bool operator<(const RawAddress& rhs) const { return (std::memcmp(address, rhs.address, sizeof(address)) < 0); } bool operator==(const RawAddress& rhs) const { return (std::memcmp(address, rhs.address, sizeof(address)) == 0); } bool operator>(const RawAddress& rhs) const { return (rhs < *this); } bool operator<=(const RawAddress& rhs) const { return !(*this > rhs); } bool operator>=(const RawAddress& rhs) const { return !(*this < rhs); } bool operator!=(const RawAddress& rhs) const { return !(*this == rhs); } bool IsEmpty() const { return *this == kEmpty; } // TODO (b/258090765): remove it and // replace its usage with ToColonSepHexString std::string ToString() const; // Return a string representation in the form of // hexadecimal string separated by colon (:), e.g., // "12:34:56:ab:cd:ef" std::string ToColonSepHexString() const; // same as ToColonSepHexString std::string ToStringForLogging() const; // Similar with ToColonHexString, ToRedactedStringForLogging returns a // colon separated hexadecimal reprentation of the address but, with the // leftmost 4 bytes masked with "xx", e.g., "xx:xx:xx:xx:ab:cd". std::string ToRedactedStringForLogging() const; // Converts |string| to RawAddress and places it in |to|. If |from| does // not represent a Bluetooth address, |to| is not modified and this function // returns false. Otherwise, it returns true. static bool FromString(const std::string& from, RawAddress& to); // Copies |from| raw Bluetooth address octets to the local object. // Returns the number of copied octets - should be always RawAddress::kLength size_t FromOctets(const uint8_t* from); std::array ToArray() const; static bool IsValidAddress(const std::string& address); static const RawAddress kEmpty; // 00:00:00:00:00:00 static const RawAddress kAny; // FF:FF:FF:FF:FF:FF }; inline std::ostream& operator<<(std::ostream& os, const RawAddress& a) { os << a.ToString(); return os; } template <> struct std::hash { std::size_t operator()(const RawAddress& val) const { static_assert(sizeof(uint64_t) >= RawAddress::kLength); uint64_t int_addr = 0; memcpy(reinterpret_cast(&int_addr), val.address, RawAddress::kLength); return std::hash{}(int_addr); } }; #define BD_ADDR_LEN 6 /* Device address length */ inline void BDADDR_TO_STREAM(uint8_t*& p, const RawAddress& a) { for (int ijk = 0; ijk < BD_ADDR_LEN; ijk++) *(p)++ = (uint8_t)(a.address)[BD_ADDR_LEN - 1 - ijk]; } inline void STREAM_TO_BDADDR(RawAddress& a, const uint8_t*& p) { uint8_t* pbda = (uint8_t*)(a.address) + BD_ADDR_LEN - 1; for (int ijk = 0; ijk < BD_ADDR_LEN; ijk++) *pbda-- = *(p)++; } // DEPRECATED inline void STREAM_TO_BDADDR(RawAddress& a, uint8_t*& p) { uint8_t* pbda = (uint8_t*)(a.address) + BD_ADDR_LEN - 1; for (int ijk = 0; ijk < BD_ADDR_LEN; ijk++) *pbda-- = *(p)++; }