/* * Copyright 2019 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 "hci/acl_manager/classic_acl_connection.h" #include "l2cap/classic/dynamic_channel_configuration_option.h" #include "l2cap/classic/internal/dynamic_channel_service_manager_impl.h" #include "l2cap/classic/internal/fixed_channel_impl.h" #include "l2cap/classic/internal/fixed_channel_service_manager_impl.h" #include "l2cap/classic/security_enforcement_interface.h" #include "l2cap/internal/data_pipeline_manager.h" #include "l2cap/internal/dynamic_channel_allocator.h" #include "l2cap/internal/dynamic_channel_impl.h" #include "l2cap/internal/fixed_channel_allocator.h" #include "l2cap/internal/ilink.h" #include "l2cap/internal/parameter_provider.h" #include "os/alarm.h" #include "os/handler.h" #include "signalling_manager.h" namespace bluetooth { namespace l2cap { namespace classic { namespace internal { class LinkManager; class DumpsysHelper; class Link : public l2cap::internal::ILink, public hci::acl_manager::ConnectionManagementCallbacks { public: Link(os::Handler* l2cap_handler, std::unique_ptr acl_connection, l2cap::internal::ParameterProvider* parameter_provider, DynamicChannelServiceManagerImpl* dynamic_service_manager, FixedChannelServiceManagerImpl* fixed_service_manager, LinkManager* link_manager); hci::AddressWithType GetDevice() const override { return {acl_connection_->GetAddress(), hci::AddressType::PUBLIC_DEVICE_ADDRESS}; } struct PendingDynamicChannelConnection { os::Handler* handler_; DynamicChannelManager::OnConnectionOpenCallback on_open_callback_; DynamicChannelManager::OnConnectionFailureCallback on_fail_callback_; classic::DynamicChannelConfigurationOption configuration_; }; struct PendingAuthenticateDynamicChannelConnection { Psm psm_; Cid cid_; PendingDynamicChannelConnection pending_dynamic_channel_connection_; }; // ACL methods virtual void OnAclDisconnected(hci::ErrorCode status); virtual void Disconnect(); virtual void Encrypt(); virtual void Authenticate(); virtual bool IsAuthenticated() const; virtual void ReadRemoteVersionInformation(); virtual void ReadRemoteSupportedFeatures(); virtual void ReadRemoteExtendedFeatures(uint8_t page_number); virtual void ReadClockOffset(); // Increase the link usage refcount to ensure the link won't be disconnected when SecurityModule needs it virtual void AcquireSecurityHold(); // Decrease the link usage refcount when SecurityModule no longer needs it virtual void ReleaseSecurityHold(); // FixedChannel methods std::shared_ptr AllocateFixedChannel(Cid cid); virtual bool IsFixedChannelAllocated(Cid cid); // DynamicChannel methods virtual Cid ReserveDynamicChannel(); virtual void SendConnectionRequest(Psm psm, Cid local_cid); virtual void SendConnectionRequest(Psm psm, Cid local_cid, PendingDynamicChannelConnection pending_dynamic_channel_connection); void SetChannelTxPriority(Cid local_cid, bool high_priority) override; // When a Link is established, LinkManager notifies pending dynamic channels to connect virtual void SetPendingDynamicChannels(std::list psm_list, std::list callback_list); // Invoked by signalling manager to indicate an outgoing connection request failed and link shall free resources virtual void OnOutgoingConnectionRequestFail(Cid local_cid, DynamicChannelManager::ConnectionResult result); virtual void SendInitialConfigRequestOrQueue(Cid local_cid); virtual void SendInformationRequest(InformationRequestInfoType type); virtual void SendDisconnectionRequest(Cid local_cid, Cid remote_cid) override; virtual std::shared_ptr AllocateDynamicChannel(Psm psm, Cid remote_cid); virtual std::shared_ptr AllocateReservedDynamicChannel(Cid reserved_cid, Psm psm, Cid remote_cid); virtual classic::DynamicChannelConfigurationOption GetConfigurationForInitialConfiguration(Cid cid); virtual void FreeDynamicChannel(Cid cid); // Check how many channels are acquired or in use, if zero, start tear down timer, if non-zero, cancel tear down timer virtual void RefreshRefCount(); virtual void NotifyChannelCreation(Cid cid, std::unique_ptr channel); virtual void NotifyChannelFail(Cid cid, DynamicChannelManager::ConnectionResult result); // Information received from signaling channel virtual void SetRemoteConnectionlessMtu(Mtu mtu); virtual Mtu GetRemoteConnectionlessMtu() const; virtual bool GetRemoteSupportsErtm() const; virtual bool GetRemoteSupportsFcs() const; virtual void OnRemoteExtendedFeatureReceived(bool ertm_supported, bool fcs_supported); virtual std::string ToString() const { return GetDevice().ToString(); } void SendLeCredit(Cid local_cid, uint16_t credit) override {} // ConnectionManagementCallbacks void OnConnectionPacketTypeChanged(uint16_t packet_type) override; void OnAuthenticationComplete(hci::ErrorCode hci_status) override; void OnEncryptionChange(hci::EncryptionEnabled enabled) override; void OnChangeConnectionLinkKeyComplete() override; void OnReadClockOffsetComplete(uint16_t clock_offset) override; void OnModeChange(hci::ErrorCode status, hci::Mode current_mode, uint16_t interval) override; void OnSniffSubrating( hci::ErrorCode hci_status, uint16_t maximum_transmit_latency, uint16_t maximum_receive_latency, uint16_t minimum_remote_timeout, uint16_t minimum_local_timeout) override; void OnQosSetupComplete(hci::ServiceType service_type, uint32_t token_rate, uint32_t peak_bandwidth, uint32_t latency, uint32_t delay_variation) override; void OnFlowSpecificationComplete(hci::FlowDirection flow_direction, hci::ServiceType service_type, uint32_t token_rate, uint32_t token_bucket_size, uint32_t peak_bandwidth, uint32_t access_latency) override; void OnFlushOccurred() override; void OnRoleDiscoveryComplete(hci::Role current_role) override; void OnReadLinkPolicySettingsComplete(uint16_t link_policy_settings) override; void OnReadAutomaticFlushTimeoutComplete(uint16_t flush_timeout) override; void OnReadTransmitPowerLevelComplete(uint8_t transmit_power_level) override; void OnReadLinkSupervisionTimeoutComplete(uint16_t link_supervision_timeout) override; void OnReadFailedContactCounterComplete(uint16_t failed_contact_counter) override; void OnReadLinkQualityComplete(uint8_t link_quality) override; void OnReadAfhChannelMapComplete(hci::AfhMode afh_mode, std::array afh_channel_map) override; void OnReadRssiComplete(uint8_t rssi) override; void OnReadClockComplete(uint32_t clock, uint16_t accuracy) override; void OnCentralLinkKeyComplete(hci::KeyFlag key_flag) override; void OnRoleChange(hci::ErrorCode hci_status, hci::Role new_role) override; void OnDisconnection(hci::ErrorCode reason) override; void OnReadRemoteVersionInformationComplete( hci::ErrorCode hci_status, uint8_t lmp_version, uint16_t manufacturer_name, uint16_t sub_version); void OnReadRemoteSupportedFeaturesComplete(uint64_t features); void OnReadRemoteExtendedFeaturesComplete(uint8_t page_number, uint8_t max_page_number, uint64_t features); struct EncryptionChangeListener { Cid cid; Psm psm; }; void AddEncryptionChangeListener(EncryptionChangeListener); uint16_t GetAclHandle() const { return acl_handle_; } hci::Role GetRole() const { return role_; } void OnPendingPacketChange(Cid local_cid, bool has_packet) override; private: friend class DumpsysHelper; void connect_to_pending_dynamic_channels(); void send_pending_configuration_requests(); os::Handler* l2cap_handler_; l2cap::internal::FixedChannelAllocator fixed_channel_allocator_{this, l2cap_handler_}; l2cap::internal::DynamicChannelAllocator dynamic_channel_allocator_{this, l2cap_handler_}; std::unique_ptr acl_connection_; l2cap::internal::DataPipelineManager data_pipeline_manager_; l2cap::internal::ParameterProvider* parameter_provider_; DynamicChannelServiceManagerImpl* dynamic_service_manager_; FixedChannelServiceManagerImpl* fixed_service_manager_; LinkManager* link_manager_; std::unordered_map local_cid_to_pending_dynamic_channel_connection_map_; os::Alarm link_idle_disconnect_alarm_{l2cap_handler_}; ClassicSignallingManager signalling_manager_; uint16_t acl_handle_; Mtu remote_connectionless_mtu_ = kMinimumClassicMtu; hci::Role role_ = hci::Role::CENTRAL; bool remote_extended_feature_received_ = false; bool remote_supports_ertm_ = false; bool remote_supports_fcs_ = false; hci::EncryptionEnabled encryption_enabled_ = hci::EncryptionEnabled::OFF; std::list pending_dynamic_psm_list_; std::list pending_dynamic_channel_callback_list_; std::list pending_outgoing_configuration_request_list_; bool used_by_security_module_ = false; bool has_requested_authentication_ = false; std::list encryption_change_listener_; std::atomic_int remaining_packets_to_be_sent_ = 0; DISALLOW_COPY_AND_ASSIGN(Link); }; } // namespace internal } // namespace classic } // namespace l2cap } // namespace bluetooth