/* * * Copyright (c) 2020-2021 Project CHIP Authors * Copyright (c) 2019 Nest Labs, Inc. * * 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. */ /** * @file * Provides an implementation of the BLEManager singleton object * for the Silicon Labs EFR32 platforms. */ #pragma once #if CHIP_DEVICE_CONFIG_ENABLE_CHIPOBLE #include "FreeRTOS.h" #include "timers.h" #if (SLI_SI91X_ENABLE_BLE || RSI_BLE_ENABLE) #ifdef __cplusplus extern "C" { #endif // __cplusplus #include "wfx_sl_ble_init.h" #ifdef __cplusplus } #endif // __cplusplus #else #include "gatt_db.h" #include "sl_bgapi.h" #include "sl_bt_api.h" #endif // (SLI_SI91X_ENABLE_BLE || RSI_BLE_ENABLE) namespace chip { namespace DeviceLayer { namespace Internal { using namespace chip::Ble; /** * Concrete implementation of the BLEManager singleton object for the EFR32 platforms. */ class BLEManagerImpl final : public BLEManager, private BleLayer, private BlePlatformDelegate, private BleApplicationDelegate { public: void HandleBootEvent(void); #if (SLI_SI91X_ENABLE_BLE || RSI_BLE_ENABLE) // Used for posting the event in the BLE queue void BlePostEvent(SilabsBleWrapper::BleEvent_t * event); void HandleConnectEvent(SilabsBleWrapper::sl_wfx_msg_t * evt); void HandleConnectionCloseEvent(SilabsBleWrapper::sl_wfx_msg_t * evt); void HandleWriteEvent(SilabsBleWrapper::sl_wfx_msg_t * evt); void UpdateMtu(SilabsBleWrapper::sl_wfx_msg_t * evt); void HandleTxConfirmationEvent(BLE_CONNECTION_OBJECT conId); void HandleTXCharCCCDWrite(SilabsBleWrapper::sl_wfx_msg_t * evt); void HandleSoftTimerEvent(void); int32_t SendBLEAdvertisementCommand(void); #else void HandleConnectEvent(volatile sl_bt_msg_t * evt); void HandleConnectionCloseEvent(volatile sl_bt_msg_t * evt); void HandleWriteEvent(volatile sl_bt_msg_t * evt); void UpdateMtu(volatile sl_bt_msg_t * evt); void HandleTxConfirmationEvent(BLE_CONNECTION_OBJECT conId); void HandleTXCharCCCDWrite(volatile sl_bt_msg_t * evt); void HandleSoftTimerEvent(volatile sl_bt_msg_t * evt); #endif // RSI_BLE_ENABLEHandleConnectEvent CHIP_ERROR StartAdvertising(void); CHIP_ERROR StopAdvertising(void); #if CHIP_ENABLE_ADDITIONAL_DATA_ADVERTISING #if (SLI_SI91X_ENABLE_BLE || RSI_BLE_ENABLE) static void HandleC3ReadRequest(SilabsBleWrapper::sl_wfx_msg_t * rsi_ble_read_req); #else #if CHIP_ENABLE_ADDITIONAL_DATA_ADVERTISING static void HandleC3ReadRequest(volatile sl_bt_msg_t * evt); #endif #endif #endif private: // Allow the BLEManager interface class to delegate method calls to // the implementation methods provided by this class. friend BLEManager; #if (SLI_SI91X_ENABLE_BLE || RSI_BLE_ENABLE) // rs91x BLE task handling osMessageQueueId_t sBleEventQueue = NULL; static void sl_ble_event_handling_task(void * args); void sl_ble_init(); void ProcessEvent(SilabsBleWrapper::BleEvent_t inEvent); #endif // ===== Members that implement the BLEManager internal interface. CHIP_ERROR _Init(void); void _Shutdown() {} bool _IsAdvertisingEnabled(void); CHIP_ERROR _SetAdvertisingEnabled(bool val); bool _IsAdvertising(void); CHIP_ERROR _SetAdvertisingMode(BLEAdvertisingMode mode); CHIP_ERROR _GetDeviceName(char * buf, size_t bufSize); CHIP_ERROR _SetDeviceName(const char * deviceName); uint16_t _NumConnections(void); void _OnPlatformEvent(const ChipDeviceEvent * event); BleLayer * _GetBleLayer(void); // ===== Members that implement virtual methods on BlePlatformDelegate. CHIP_ERROR SubscribeCharacteristic(BLE_CONNECTION_OBJECT conId, const Ble::ChipBleUUID * svcId, const Ble::ChipBleUUID * charId) override; CHIP_ERROR UnsubscribeCharacteristic(BLE_CONNECTION_OBJECT conId, const Ble::ChipBleUUID * svcId, const Ble::ChipBleUUID * charId) override; CHIP_ERROR CloseConnection(BLE_CONNECTION_OBJECT conId) override; uint16_t GetMTU(BLE_CONNECTION_OBJECT conId) const override; CHIP_ERROR SendIndication(BLE_CONNECTION_OBJECT conId, const Ble::ChipBleUUID * svcId, const Ble::ChipBleUUID * charId, System::PacketBufferHandle pBuf) override; CHIP_ERROR SendWriteRequest(BLE_CONNECTION_OBJECT conId, const Ble::ChipBleUUID * svcId, const Ble::ChipBleUUID * charId, System::PacketBufferHandle pBuf) override; // ===== Members that implement virtual methods on BleApplicationDelegate. void NotifyChipConnectionClosed(BLE_CONNECTION_OBJECT conId) override; // ===== Members for internal use by the following friends. friend BLEManager & BLEMgr(void); friend BLEManagerImpl & BLEMgrImpl(void); static BLEManagerImpl sInstance; // ===== Private members reserved for use by this class only. enum class Flags : uint16_t { kAdvertisingEnabled = 0x0001, kFastAdvertisingEnabled = 0x0002, kAdvertising = 0x0004, kRestartAdvertising = 0x0008, kEFRBLEStackInitialized = 0x0010, kDeviceNameSet = 0x0020, kExtAdvertisingEnabled = 0x0040, }; enum { kMaxConnections = BLE_LAYER_NUM_BLE_ENDPOINTS, kMaxDeviceNameLength = 21, kUnusedIndex = 0xFF, }; static constexpr uint8_t kFlagTlvSize = 3; // 1 byte for length, 1b for type and 1b for the Flag value static constexpr uint8_t kUUIDTlvSize = 4; // 1 byte for length, 1b for type and 2b for the UUID value static constexpr uint8_t kDeviceNameTlvSize = (2 + kMaxDeviceNameLength); // 1 byte for length, 1b for type and + device name struct CHIPoBLEConState { #if !(SLI_SI91X_ENABLE_BLE || RSI_BLE_ENABLE) bd_addr address; #endif uint16_t mtu : 10; uint16_t allocated : 1; uint16_t subscribed : 1; uint16_t unused : 4; uint8_t connectionHandle; uint8_t bondingHandle; }; CHIPoBLEConState mBleConnections[kMaxConnections]; uint8_t mIndConfId[kMaxConnections]; CHIPoBLEServiceMode mServiceMode; BitFlags mFlags; char mDeviceName[kMaxDeviceNameLength + 1]; // The advertising set handle allocated from Bluetooth stack. uint8_t advertising_set_handle = 0xff; #if CHIP_ENABLE_ADDITIONAL_DATA_ADVERTISING PacketBufferHandle c3AdditionalDataBufferHandle; #endif CHIP_ERROR MapBLEError(int bleErr); void DriveBLEState(void); CHIP_ERROR ConfigureAdvertisingData(void); #if CHIP_ENABLE_ADDITIONAL_DATA_ADVERTISING CHIP_ERROR EncodeAdditionalDataTlv(); #endif #if (SLI_SI91X_ENABLE_BLE || RSI_BLE_ENABLE) void HandleRXCharWrite(SilabsBleWrapper::sl_wfx_msg_t * evt); #else void HandleRXCharWrite(volatile sl_bt_msg_t * evt); #endif bool RemoveConnection(uint8_t connectionHandle); void AddConnection(uint8_t connectionHandle, uint8_t bondingHandle); void StartBleAdvTimeoutTimer(uint32_t aTimeoutInMs); void CancelBleAdvTimeoutTimer(void); CHIPoBLEConState * GetConnectionState(uint8_t conId, bool allocate = false); static void DriveBLEState(intptr_t arg); static void BleAdvTimeoutHandler(void * arg); uint8_t GetTimerHandle(uint8_t connectionHandle, bool allocate); #if (SLI_SI91X_ENABLE_BLE || RSI_BLE_ENABLE) protected: static void OnSendIndicationTimeout(System::Layer * aLayer, void * appState); #endif }; /** * Returns a reference to the public interface of the BLEManager singleton object. * * Internal components should use this to access features of the BLEManager object * that are common to all platforms. */ inline BLEManager & BLEMgr(void) { return BLEManagerImpl::sInstance; } /** * Returns the platform-specific implementation of the BLEManager singleton object. * * Internal components can use this to gain access to features of the BLEManager * that are specific to the EFR32 platforms. */ inline BLEManagerImpl & BLEMgrImpl(void) { return BLEManagerImpl::sInstance; } inline BleLayer * BLEManagerImpl::_GetBleLayer() { return this; } inline bool BLEManagerImpl::_IsAdvertisingEnabled(void) { return mFlags.Has(Flags::kAdvertisingEnabled); } } // namespace Internal } // namespace DeviceLayer } // namespace chip #endif // CHIP_DEVICE_CONFIG_ENABLE_CHIPOBLE