1 /* 2 * Copyright 2022 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 #pragma once 17 18 #include "address.h" 19 #include "module.h" 20 21 namespace bluetooth { 22 namespace hci { 23 24 enum DistanceMeasurementMethod { 25 METHOD_AUTO, 26 METHOD_RSSI, 27 }; 28 29 enum DistanceMeasurementErrorCode { 30 REASON_FEATURE_NOT_SUPPORTED_LOCAL, 31 REASON_FEATURE_NOT_SUPPORTED_REMOTE, 32 REASON_LOCAL_REQUEST, 33 REASON_REMOTE_REQUEST, 34 REASON_DURATION_TIMEOUT, 35 REASON_NO_LE_CONNECTION, 36 REASON_INVALID_PARAMETERS, 37 REASON_INTERNAL_ERROR, 38 }; 39 40 struct DistanceMeasurementResult { 41 Address address; 42 uint32_t centimeter; 43 uint32_t error_centimeter; 44 DistanceMeasurementMethod method; 45 }; 46 47 class DistanceMeasurementCallbacks { 48 public: 49 virtual ~DistanceMeasurementCallbacks() = default; 50 virtual void OnDistanceMeasurementStarted(Address address, DistanceMeasurementMethod method) = 0; 51 virtual void OnDistanceMeasurementStartFail( 52 Address address, DistanceMeasurementErrorCode reason, DistanceMeasurementMethod method) = 0; 53 virtual void OnDistanceMeasurementStopped( 54 Address address, DistanceMeasurementErrorCode reason, DistanceMeasurementMethod method) = 0; 55 virtual void OnDistanceMeasurementResult( 56 Address address, 57 uint32_t centimeter, 58 uint32_t error_centimeter, 59 int azimuth_angle, 60 int error_azimuth_angle, 61 int altitude_angle, 62 int error_altitude_angle, 63 DistanceMeasurementMethod method) = 0; 64 }; 65 66 class DistanceMeasurementManager : public bluetooth::Module { 67 public: 68 DistanceMeasurementManager(); 69 ~DistanceMeasurementManager(); 70 DistanceMeasurementManager(const DistanceMeasurementManager&) = delete; 71 DistanceMeasurementManager& operator=(const DistanceMeasurementManager&) = delete; 72 73 void RegisterDistanceMeasurementCallbacks(DistanceMeasurementCallbacks* callbacks); 74 void StartDistanceMeasurement( 75 const Address&, uint16_t frequency, DistanceMeasurementMethod method); 76 void StopDistanceMeasurement(const Address& address, DistanceMeasurementMethod method); 77 78 static const ModuleFactory Factory; 79 80 protected: 81 void ListDependencies(ModuleList* list) const override; 82 83 void Start() override; 84 85 void Stop() override; 86 87 std::string ToString() const override; 88 89 private: 90 struct impl; 91 std::unique_ptr<impl> pimpl_; 92 }; 93 94 } // namespace hci 95 } // namespace bluetooth 96