nearby/cpp/core/internal/mediums/bluetooth_radio.h

#ifndef CORE_INTERNAL_MEDIUMS_BLUETOOTH_RADIO_H_
#define CORE_INTERNAL_MEDIUMS_BLUETOOTH_RADIO_H_

#include <cstdint>

#include "platform/public/atomic_boolean.h"
#include "platform/public/bluetooth_adapter.h"
#include "absl/time/clock.h"

namespace location {
namespace nearby {
namespace connections {

// Provides the operations that can be performed on the Bluetooth radio.
class BluetoothRadio {
 public:
  BluetoothRadio();
  BluetoothRadio(BluetoothRadio&&) = default;
  BluetoothRadio& operator=(BluetoothRadio&&) = default;

  // Reverts the Bluetooth radio to its original state.
  ~BluetoothRadio();

  // Enables Bluetooth.
  //
  // This must be called before attempting to invoke any other methods of
  // this class.
  //
  // Returns true if enabled successfully.
  bool Enable();

  // Disables Bluetooth.
  //
  // Returns true if disabled successfully.
  bool Disable();

  // Returns true if the Bluetooth radio is currently enabled.
  bool IsEnabled() const;

  // Turn BT radio Off, delay for kPauseBetweenToggle and then turn it On.
  // This will block calling thread for at least kPauseBetweenToggle duration.
  bool Toggle();

  // Returns result of BluetoothAdapter::IsValid() for private adapter instance.
  bool IsAdapterValid() const {
    return bluetooth_adapter_.IsValid();
  }

  BluetoothAdapter& GetBluetoothAdapter() {
    return bluetooth_adapter_;
  }

 private:
  static constexpr absl::Duration kPauseBetweenToggle = absl::Seconds(3);

  bool SetBluetoothState(bool enable);
  bool IsInDesiredState(bool should_be_enabled) const;
  // To be called in enable(), disable(), and toggle(). This will remember the
  // original state of the radio before any radio state has been modified.
  // Returns false if Bluetooth doesn't exist on the device and the state cannot
  // be obtained.
  bool SaveOriginalState();

  // BluetoothAdapter::IsValid() will return false if BT is not supported.
  BluetoothAdapter bluetooth_adapter_;

  // The Bluetooth radio's original state, before we modified it. True if
  // originally enabled, false if originally disabled.
  // We restore the radio to its original state in the destructor.

  AtomicBoolean originally_enabled_{false};
  // false if we never modified the radio state, true otherwise.
  AtomicBoolean ever_saved_state_{false};
};

}  // namespace connections
}  // namespace nearby
}  // namespace location

#endif  // CORE_INTERNAL_MEDIUMS_BLUETOOTH_RADIO_H_