mirror of https://github.com/ARMmbed/mbed-os.git
95 lines
3.1 KiB
C++
95 lines
3.1 KiB
C++
/* mbed Microcontroller Library
|
|
* Copyright (c) 2006-2020 ARM Limited
|
|
*
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*
|
|
* 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.
|
|
*/
|
|
|
|
#ifndef MBED_BLE_CONNECTION_EVENT_MONITOR
|
|
#define MBED_BLE_CONNECTION_EVENT_MONITOR
|
|
|
|
#include "ble/Gap.h"
|
|
#include "ble/common/BLETypes.h"
|
|
|
|
namespace ble {
|
|
|
|
/**
|
|
* Implemented by classes that are reacting to connection changes.
|
|
* @see PalConnectionMonitor
|
|
*/
|
|
class PalConnectionMonitorEventHandler {
|
|
public:
|
|
/**
|
|
* Inform the Security manager of a new connection. This will create
|
|
* or retrieve an existing security manager entry for the connected device.
|
|
* Called by GAP.
|
|
*
|
|
* @param[in] connection Handle to identify the connection.
|
|
* @param[in] role indicate if the device is central or peripheral.
|
|
* @param[in] peer_address_type type of address.
|
|
* @param[in] peer_address Address of the connected device.
|
|
* @param[in] local_address_type type of address of the local device.
|
|
* @param[in] local_address Address of the local device that was used during connection.
|
|
* @param[in] connection_params connection parameters like interval, latency and timeout.
|
|
* @param[in] resolved_peer_address resolved address of the peer; may
|
|
* be NULL.
|
|
*/
|
|
virtual void on_connected(
|
|
connection_handle_t connection,
|
|
connection_role_t role,
|
|
ble::peer_address_type_t peer_address_type,
|
|
address_t peer_address,
|
|
own_address_type_t local_address_type,
|
|
const address_t local_address
|
|
) { };
|
|
|
|
/**
|
|
* Inform the monitor about a disconnection.
|
|
*
|
|
* @param[in] connectionHandle Handle to identify the connection.
|
|
* @param[in] reason Reason for the disconnection.
|
|
*/
|
|
virtual void on_disconnected(
|
|
connection_handle_t connection,
|
|
ble::disconnection_reason_t reason
|
|
) { };
|
|
};
|
|
|
|
|
|
/**
|
|
* Implemented by classes that need to be notified of connection changes.
|
|
* Notification is done by calling functions in the passed in event handler
|
|
*/
|
|
class PalConnectionMonitor {
|
|
|
|
protected:
|
|
PalConnectionMonitor() : _connection_event_handler(nullptr) { }
|
|
|
|
PalConnectionMonitorEventHandler* _connection_event_handler;
|
|
|
|
public:
|
|
/**
|
|
* Register a handler for connection events to be used internally and serviced first.
|
|
*
|
|
* @param[in] connection_event_handler Event handler being registered.
|
|
*/
|
|
void set_connection_event_handler(PalConnectionMonitorEventHandler *connection_event_handler) {
|
|
_connection_event_handler = connection_event_handler;
|
|
}
|
|
};
|
|
|
|
} // namespace ble
|
|
|
|
#endif /* MBED_BLE_CONNECTION_EVENT_MONITOR */
|