src/connectivity/bluetooth/core/bt-host/hci-spec/util.h

// Copyright 2017 The Fuchsia Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef SRC_CONNECTIVITY_BLUETOOTH_CORE_BT_HOST_HCI_SPEC_UTIL_H_
#define SRC_CONNECTIVITY_BLUETOOTH_CORE_BT_HOST_HCI_SPEC_UTIL_H_

#include <string>

#include "src/connectivity/bluetooth/core/bt-host/hci-spec/protocol.h"

namespace bt::hci_spec {

using AdvertisingEventBits = uint16_t;

// Helper functions to convert HCI data types to library objects.

// Returns a user-friendly string representation of |version|.
std::string HCIVersionToString(hci_spec::HCIVersion version);

// Returns a user-friendly string representation of |status|.
std::string StatusCodeToString(hci_spec::StatusCode code);

// Returns a user-friendly string representation of |link_type|.
std::string LinkTypeToString(hci_spec::LinkType link_type);

std::string ConnectionRoleToString(hci_spec::ConnectionRole role);

// Encode a legacy advertising interval to an extended advertising 3-octet interval, taking
// endianness into account.
void EncodeLegacyAdvertisingInterval(uint16_t input, uint8_t (&result)[3]);

// Decode an extended advertising 3-octet interval into an integer representation, taking endianness
// into account.
uint32_t DecodeExtendedAdvertisingInterval(const uint8_t (&input)[3]);

// Convert a LEAdvertisingType's properties (e.g. connectable, scannable, directed, etc) to the
// appropriate advertising event bits for use in HCI_LE_Set_Extended_Advertising_Parameters (Core
// Spec, Volume 4, Part E, Section 7.8.53)
std::optional<AdvertisingEventBits> AdvertisingTypeToEventBits(hci_spec::LEAdvertisingType type);

}  // namespace bt::hci_spec

#endif  // SRC_CONNECTIVITY_BLUETOOTH_CORE_BT_HOST_HCI_SPEC_UTIL_H_