mirror of https://github.com/ARMmbed/mbed-os.git
88 lines
3.1 KiB
C++
88 lines
3.1 KiB
C++
/* mbed Microcontroller Library
|
|
* Copyright (c) 2017-2017 ARM Limited
|
|
*
|
|
* 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/BLEProtocol.h"
|
|
#include "ble/Gap.h"
|
|
#include "ble/BLETypes.h"
|
|
|
|
namespace ble {
|
|
namespace pal {
|
|
|
|
/**
|
|
* Implemented by classes that need to be notified of connection changes.
|
|
* Notification is done by calling functions in the passed in event handler
|
|
*/
|
|
class ConnectionEventMonitor {
|
|
public:
|
|
/**
|
|
* Implemented by classes that are reacting to connection changes.
|
|
* @see ConnectionEventMonitor
|
|
*/
|
|
class EventHandler {
|
|
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,
|
|
::Gap::Role_t role,
|
|
ble::peer_address_type_t peer_address_type,
|
|
const BLEProtocol::AddressBytes_t peer_address,
|
|
BLEProtocol::AddressType_t local_address_type,
|
|
const BLEProtocol::AddressBytes_t local_address,
|
|
const ::Gap::ConnectionParams_t *connection_params
|
|
) = 0;
|
|
|
|
/**
|
|
* 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,
|
|
::Gap::DisconnectionReason_t reason
|
|
) = 0;
|
|
};
|
|
|
|
/**
|
|
* Register a handler for connection events to be used internally and serviced first.
|
|
*
|
|
* @param[in] connection_event_handler Event handler being registered.
|
|
*/
|
|
virtual void set_connection_event_handler(EventHandler *connection_event_handler) = 0;
|
|
};
|
|
|
|
} // namespace pal
|
|
} // namespace ble
|
|
|
|
#endif /* MBED_BLE_CONNECTION_EVENT_MONITOR */
|