/* * Copyright 2018 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 namespace android { namespace bluetooth { namespace audio { using ::android::sp; using ::android::hardware::kSynchronizedReadWrite; using ::android::hardware::MessageQueue; using ::android::hardware::bluetooth::audio::V2_0::AudioConfiguration; using ::android::hardware::bluetooth::audio::V2_0::BitsPerSample; using ::android::hardware::bluetooth::audio::V2_0::ChannelMode; using ::android::hardware::bluetooth::audio::V2_0::CodecConfiguration; using ::android::hardware::bluetooth::audio::V2_0::IBluetoothAudioPort; using ::android::hardware::bluetooth::audio::V2_0::PcmParameters; using ::android::hardware::bluetooth::audio::V2_0::SampleRate; using ::android::hardware::bluetooth::audio::V2_0::SessionType; using BluetoothAudioStatus = ::android::hardware::bluetooth::audio::V2_0::Status; using DataMQ = MessageQueue; static constexpr uint16_t kObserversCookieSize = 0x0010; // 0x0000 ~ 0x000f constexpr uint16_t kObserversCookieUndefined = (static_cast(SessionType::UNKNOWN) << 8 & 0xff00); inline SessionType ObserversCookieGetSessionType(uint16_t cookie) { return static_cast(cookie >> 8 & 0x00ff); } inline uint16_t ObserversCookieGetInitValue(SessionType session_type) { return (static_cast(session_type) << 8 & 0xff00); } inline uint16_t ObserversCookieGetUpperBound(SessionType session_type) { return (static_cast(session_type) << 8 & 0xff00) + kObserversCookieSize; } // This presents the callbacks of started / suspended and session changed, // and the bluetooth_audio module uses to receive the status notification struct PortStatusCallbacks { // control_result_cb_ - when the Bluetooth stack reports results of // streamStarted or streamSuspended, the BluetoothAudioProvider will invoke // this callback to report to the bluetooth_audio module. // @param: cookie - indicates which bluetooth_audio output should handle // @param: start_resp - this report is for startStream or not // @param: status - the result of startStream std::function control_result_cb_; // session_changed_cb_ - when the Bluetooth stack start / end session, the // BluetoothAudioProvider will invoke this callback to notify to the // bluetooth_audio module. // @param: cookie - indicates which bluetooth_audio output should handle std::function session_changed_cb_; }; class BluetoothAudioSession { friend class BluetoothAudioSession_2_1; friend class BluetoothAudioSession_2_2; private: // using recursive_mutex to allow hwbinder to re-enter agian. std::recursive_mutex mutex_; SessionType session_type_; // audio control path to use for both software and offloading sp stack_iface_; // audio data path (FMQ) for software encoding std::unique_ptr mDataMQ; // audio data configuration for both software and offloading AudioConfiguration audio_config_; static AudioConfiguration invalidSoftwareAudioConfiguration; static AudioConfiguration invalidOffloadAudioConfiguration; // saving those registered bluetooth_audio's callbacks std::unordered_map> observers_; bool UpdateDataPath(const DataMQ::Descriptor* dataMQ); bool UpdateAudioConfig(const AudioConfiguration& audio_config); // invoking the registered session_changed_cb_ void ReportSessionStatus(); public: BluetoothAudioSession(const SessionType& session_type); // The function helps to check if this session is ready or not // @return: true if the Bluetooth stack has started the specified session bool IsSessionReady(); // The report function is used to report that the Bluetooth stack has started // this session without any failure, and will invoke session_changed_cb_ to // notify those registered bluetooth_audio outputs void OnSessionStarted(const sp stack_iface, const DataMQ::Descriptor* dataMQ, const AudioConfiguration& audio_config); // The report function is used to report that the Bluetooth stack has ended // the session, and will invoke session_changed_cb_ to notify registered // bluetooth_audio outputs void OnSessionEnded(); // The report function is used to report that the Bluetooth stack has notified // the result of startStream or suspendStream, and will invoke // control_result_cb_ to notify registered bluetooth_audio outputs void ReportControlStatus(bool start_resp, const BluetoothAudioStatus& status); // The control function helps the bluetooth_audio module to register // PortStatusCallbacks // @return: cookie - the assigned number to this bluetooth_audio output uint16_t RegisterStatusCback(const PortStatusCallbacks& cbacks); // The control function helps the bluetooth_audio module to unregister // PortStatusCallbacks // @param: cookie - indicates which bluetooth_audio output is void UnregisterStatusCback(uint16_t cookie); // The control function is for the bluetooth_audio module to get the current // AudioConfiguration const AudioConfiguration& GetAudioConfig(); // Those control functions are for the bluetooth_audio module to start, // suspend, stop stream, to check position, and to update metadata. bool StartStream(); bool SuspendStream(); void StopStream(); bool GetPresentationPosition(uint64_t* remote_delay_report_ns, uint64_t* total_bytes_readed, timespec* data_position); void UpdateTracksMetadata(const struct source_metadata* source_metadata); // The control function writes stream to FMQ size_t OutWritePcmData(const void* buffer, size_t bytes); // The control function read stream from FMQ size_t InReadPcmData(void* buffer, size_t bytes); static constexpr PcmParameters kInvalidPcmParameters = { .sampleRate = SampleRate::RATE_UNKNOWN, .channelMode = ChannelMode::UNKNOWN, .bitsPerSample = BitsPerSample::BITS_UNKNOWN, }; // can't be constexpr because of non-literal type static const CodecConfiguration kInvalidCodecConfiguration; static constexpr AudioConfiguration& kInvalidSoftwareAudioConfiguration = invalidSoftwareAudioConfiguration; static constexpr AudioConfiguration& kInvalidOffloadAudioConfiguration = invalidOffloadAudioConfiguration; }; class BluetoothAudioSessionInstance { public: // The API is to fetch the specified session of A2DP / Hearing Aid static std::shared_ptr GetSessionInstance( const SessionType& session_type); private: static std::unique_ptr instance_ptr; std::mutex mutex_; std::unordered_map> sessions_map_; }; } // namespace audio } // namespace bluetooth } // namespace android