/****************************************************************************** * * Copyright 2022 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 #include #include #include #include "packet/custom_field_fixed_size_interface.h" namespace bluetooth { namespace hci { class Address final : public packet::CustomFieldFixedSizeInterface
{ public: static constexpr size_t kLength = 6; // Bluetooth MAC address bytes saved in little endian format. // The address MSB is address[5], the address LSB is address[0]. // Note that the textual representation follows the big endian format, // ie. Address{0, 1, 2, 3, 4, 5} is represented as 05:04:03:02:01:00. std::array address = {}; constexpr Address() = default; constexpr Address(std::array const& address); Address(const uint8_t (&address)[kLength]); Address(std::initializer_list l); // CustomFieldFixedSizeInterface methods inline uint8_t* data() override { return address.data(); } inline const uint8_t* data() const override { return address.data(); } // storage::Serializable methods std::string ToString() const; static std::optional
FromString(const std::string& from); bool operator<(const Address& rhs) const { return address < rhs.address; } bool operator==(const Address& rhs) const { return address == rhs.address; } bool operator>(const Address& rhs) const { return (rhs < *this); } bool operator<=(const Address& rhs) const { return !(*this > rhs); } bool operator>=(const Address& rhs) const { return !(*this < rhs); } bool operator!=(const Address& rhs) const { return !(*this == rhs); } bool IsEmpty() const { return *this == kEmpty; } // Converts |string| to Address 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, Address& to); // Copies |from| raw Bluetooth address octets to the local object. // Returns the number of copied octets - should be always Address::kLength size_t FromOctets(const uint8_t* from); static bool IsValidAddress(const std::string& address); static const Address kEmpty; // 00:00:00:00:00:00 static const Address kAny; // FF:FF:FF:FF:FF:FF }; inline std::ostream& operator<<(std::ostream& os, const Address& a) { os << a.ToString(); return os; } } // namespace hci } // namespace bluetooth namespace std { template <> struct hash { std::size_t operator()(const bluetooth::hci::Address& address) const { uint64_t address_int = 0; for (auto b : address.address) { address_int <<= 8; address_int |= b; } return std::hash{}(address_int); } }; } // namespace std