xref: /aosp_15_r20/hardware/interfaces/bluetooth/hci/h4_protocol.h (revision 4d7e907c777eeecc4c5bd7cf640a754fac206ff7)
1*4d7e907cSAndroid Build Coastguard Worker /*
2*4d7e907cSAndroid Build Coastguard Worker  * Copyright 2022 The Android Open Source Project
3*4d7e907cSAndroid Build Coastguard Worker  *
4*4d7e907cSAndroid Build Coastguard Worker  * Licensed under the Apache License, Version 2.0 (the "License");
5*4d7e907cSAndroid Build Coastguard Worker  * you may not use this file except in compliance with the License.
6*4d7e907cSAndroid Build Coastguard Worker  * You may obtain a copy of the License at
7*4d7e907cSAndroid Build Coastguard Worker  *
8*4d7e907cSAndroid Build Coastguard Worker  *      http://www.apache.org/licenses/LICENSE-2.0
9*4d7e907cSAndroid Build Coastguard Worker  *
10*4d7e907cSAndroid Build Coastguard Worker  * Unless required by applicable law or agreed to in writing, software
11*4d7e907cSAndroid Build Coastguard Worker  * distributed under the License is distributed on an "AS IS" BASIS,
12*4d7e907cSAndroid Build Coastguard Worker  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13*4d7e907cSAndroid Build Coastguard Worker  * See the License for the specific language governing permissions and
14*4d7e907cSAndroid Build Coastguard Worker  * limitations under the License.
15*4d7e907cSAndroid Build Coastguard Worker  */
16*4d7e907cSAndroid Build Coastguard Worker 
17*4d7e907cSAndroid Build Coastguard Worker #pragma once
18*4d7e907cSAndroid Build Coastguard Worker 
19*4d7e907cSAndroid Build Coastguard Worker #include <memory>
20*4d7e907cSAndroid Build Coastguard Worker #include <vector>
21*4d7e907cSAndroid Build Coastguard Worker 
22*4d7e907cSAndroid Build Coastguard Worker #include "hci_internals.h"
23*4d7e907cSAndroid Build Coastguard Worker #include "hci_packetizer.h"
24*4d7e907cSAndroid Build Coastguard Worker 
25*4d7e907cSAndroid Build Coastguard Worker namespace android::hardware::bluetooth::hci {
26*4d7e907cSAndroid Build Coastguard Worker 
27*4d7e907cSAndroid Build Coastguard Worker using PacketReadCallback = std::function<void(const std::vector<uint8_t>&)>;
28*4d7e907cSAndroid Build Coastguard Worker using DisconnectCallback = std::function<void(void)>;
29*4d7e907cSAndroid Build Coastguard Worker 
30*4d7e907cSAndroid Build Coastguard Worker class H4Protocol {
31*4d7e907cSAndroid Build Coastguard Worker  public:
32*4d7e907cSAndroid Build Coastguard Worker   H4Protocol(int fd, PacketReadCallback cmd_cb, PacketReadCallback acl_cb,
33*4d7e907cSAndroid Build Coastguard Worker              PacketReadCallback sco_cb, PacketReadCallback event_cb,
34*4d7e907cSAndroid Build Coastguard Worker              PacketReadCallback iso_cb, DisconnectCallback disconnect_cb);
35*4d7e907cSAndroid Build Coastguard Worker 
36*4d7e907cSAndroid Build Coastguard Worker   size_t Send(PacketType type, const uint8_t* data, size_t length);
37*4d7e907cSAndroid Build Coastguard Worker   size_t Send(PacketType type, const std::vector<uint8_t>& data);
38*4d7e907cSAndroid Build Coastguard Worker 
39*4d7e907cSAndroid Build Coastguard Worker   void OnDataReady();
40*4d7e907cSAndroid Build Coastguard Worker 
41*4d7e907cSAndroid Build Coastguard Worker  protected:
42*4d7e907cSAndroid Build Coastguard Worker   size_t OnPacketReady(const std::vector<uint8_t>& packet);
43*4d7e907cSAndroid Build Coastguard Worker   void SendDataToPacketizer(uint8_t* buffer, size_t length);
44*4d7e907cSAndroid Build Coastguard Worker 
45*4d7e907cSAndroid Build Coastguard Worker  private:
46*4d7e907cSAndroid Build Coastguard Worker   int uart_fd_;
47*4d7e907cSAndroid Build Coastguard Worker   bool disconnected_{false};
48*4d7e907cSAndroid Build Coastguard Worker 
49*4d7e907cSAndroid Build Coastguard Worker   PacketReadCallback cmd_cb_;
50*4d7e907cSAndroid Build Coastguard Worker   PacketReadCallback acl_cb_;
51*4d7e907cSAndroid Build Coastguard Worker   PacketReadCallback sco_cb_;
52*4d7e907cSAndroid Build Coastguard Worker   PacketReadCallback event_cb_;
53*4d7e907cSAndroid Build Coastguard Worker   PacketReadCallback iso_cb_;
54*4d7e907cSAndroid Build Coastguard Worker   DisconnectCallback disconnect_cb_;
55*4d7e907cSAndroid Build Coastguard Worker 
56*4d7e907cSAndroid Build Coastguard Worker   PacketType hci_packet_type_{PacketType::UNKNOWN};
57*4d7e907cSAndroid Build Coastguard Worker   HciPacketizer hci_packetizer_;
58*4d7e907cSAndroid Build Coastguard Worker 
59*4d7e907cSAndroid Build Coastguard Worker   /**
60*4d7e907cSAndroid Build Coastguard Worker    * Question : Why read in single chunk rather than multiple reads?
61*4d7e907cSAndroid Build Coastguard Worker    * Answer: Using multiple reads does not work with some BT USB dongles.
62*4d7e907cSAndroid Build Coastguard Worker    * Reading in single shot gives expected response.
63*4d7e907cSAndroid Build Coastguard Worker    * ACL max length is 2 bytes, so using 64K as the buffer length.
64*4d7e907cSAndroid Build Coastguard Worker    */
65*4d7e907cSAndroid Build Coastguard Worker   static constexpr size_t kMaxPacketLength = 64 * 1024;
66*4d7e907cSAndroid Build Coastguard Worker };
67*4d7e907cSAndroid Build Coastguard Worker 
68*4d7e907cSAndroid Build Coastguard Worker }  // namespace android::hardware::bluetooth::hci
69