BLE: Exclude Gap Event constructors from documentation.

pull/8738/head
Vincent Coubard 2018-11-23 11:25:17 +00:00
parent 430777e20b
commit dea2ae9c1f
1 changed files with 20 additions and 1 deletions

View File

@ -30,6 +30,7 @@ namespace ble {
* @see ble::Gap::EventHandler::onPeriodicAdvertisingReport() * @see ble::Gap::EventHandler::onPeriodicAdvertisingReport()
*/ */
struct AdvertisingReportEvent { struct AdvertisingReportEvent {
#if !defined(DOXYGEN_ONLY)
/** Create a advertising report event. /** Create a advertising report event.
* *
* @param type Type of advertising used. * @param type Type of advertising used.
@ -71,6 +72,7 @@ struct AdvertisingReportEvent {
directAddressType(directAddressType), directAddressType(directAddressType),
directAddress(directAddress), directAddress(directAddress),
advertisingData(advertisingData) { } advertisingData(advertisingData) { }
#endif
/** Get event type. */ /** Get event type. */
const advertising_event_t &getType() const const advertising_event_t &getType() const
@ -165,6 +167,7 @@ private:
* @see ble::Gap::EventHandler::onConnectionComplete(). * @see ble::Gap::EventHandler::onConnectionComplete().
*/ */
struct ConnectionCompleteEvent { struct ConnectionCompleteEvent {
#if !defined(DOXYGEN_ONLY)
/** Create a connection complete event. /** Create a connection complete event.
* *
* @param success BLE_ERROR_NONE if connection succeeded. * @param success BLE_ERROR_NONE if connection succeeded.
@ -203,6 +206,7 @@ struct ConnectionCompleteEvent {
connectionLatency(connectionLatency), connectionLatency(connectionLatency),
supervisionTimeout(supervisionTimeout), supervisionTimeout(supervisionTimeout),
masterClockAccuracy(masterClockAccuracy) { } masterClockAccuracy(masterClockAccuracy) { }
#endif
/** Get connection complete event status. */ /** Get connection complete event status. */
ble_error_t getStatus() const ble_error_t getStatus() const
@ -290,6 +294,7 @@ private:
* @see ble::Gap::EventHandler::onPeriodicAdvertisingSyncEstablished(). * @see ble::Gap::EventHandler::onPeriodicAdvertisingSyncEstablished().
*/ */
struct PeriodicAdvertisingSyncEstablishedEvent { struct PeriodicAdvertisingSyncEstablishedEvent {
#if !defined(DOXYGEN_ONLY)
/** Create advertising sync event. /** Create advertising sync event.
* *
* @param success BLE_ERROR_NONE if synchronisation was achieved. * @param success BLE_ERROR_NONE if synchronisation was achieved.
@ -319,6 +324,7 @@ struct PeriodicAdvertisingSyncEstablishedEvent {
peerPhy(peerPhy), peerPhy(peerPhy),
advertisingInterval(advertisingInterval), advertisingInterval(advertisingInterval),
peerClockAccuracy(peerClockAccuracy) { } peerClockAccuracy(peerClockAccuracy) { }
#endif
/** Get sync establishment status. */ /** Get sync establishment status. */
ble_error_t getStatus() const ble_error_t getStatus() const
@ -385,6 +391,7 @@ private:
* @see ble::Gap::EventHandler::onPeriodicAdvertisingReport(). * @see ble::Gap::EventHandler::onPeriodicAdvertisingReport().
*/ */
struct PeriodicAdvertisingReportEvent { struct PeriodicAdvertisingReportEvent {
#if !defined(DOXYGEN_ONLY)
/** Create periodic advertising report event. /** Create periodic advertising report event.
* *
* @param syncHandle Periodic advertising sync handle * @param syncHandle Periodic advertising sync handle
@ -405,6 +412,7 @@ struct PeriodicAdvertisingReportEvent {
rssi(rssi), rssi(rssi),
dataStatus(dataStatus), dataStatus(dataStatus),
payload(payload) { } payload(payload) { }
#endif
/** Get periodic advertising sync handle. */ /** Get periodic advertising sync handle. */
periodic_sync_handle_t getSyncHandle() const periodic_sync_handle_t getSyncHandle() const
@ -450,6 +458,7 @@ private:
* @see ble::Gap::EventHandler::onPeriodicAdvertisingSyncLoss(). * @see ble::Gap::EventHandler::onPeriodicAdvertisingSyncLoss().
*/ */
struct PeriodicAdvertisingSyncLoss { struct PeriodicAdvertisingSyncLoss {
#if !defined(DOXYGEN_ONLY)
/** Create periodic advertising sync loss event. /** Create periodic advertising sync loss event.
* *
* @param syncHandle Periodic advertising sync handle. * @param syncHandle Periodic advertising sync handle.
@ -458,6 +467,7 @@ struct PeriodicAdvertisingSyncLoss {
periodic_sync_handle_t syncHandle periodic_sync_handle_t syncHandle
) : ) :
syncHandle(syncHandle) { } syncHandle(syncHandle) { }
#endif
/** Get periodic sync handle. */ /** Get periodic sync handle. */
periodic_sync_handle_t getSyncHandle() const periodic_sync_handle_t getSyncHandle() const
@ -482,6 +492,7 @@ struct ScanTimeoutEvent { };
* @see ble::Gap::EventHandler::onAdvertisingEnd(). * @see ble::Gap::EventHandler::onAdvertisingEnd().
*/ */
struct AdvertisingEndEvent_t { struct AdvertisingEndEvent_t {
#if !defined(DOXYGEN_ONLY)
/** Create advertising end event. /** Create advertising end event.
* *
* @param advHandle Advertising set handle. * @param advHandle Advertising set handle.
@ -499,6 +510,7 @@ struct AdvertisingEndEvent_t {
connection(connection), connection(connection),
completed_events(completed_events), completed_events(completed_events),
connected(connected) { } connected(connected) { }
#endif
/** Get advertising handle. */ /** Get advertising handle. */
advertising_handle_t getAdvHandle() const advertising_handle_t getAdvHandle() const
@ -537,6 +549,7 @@ private:
* @see ble::Gap::EventHandler::onScanRequestReceived(). * @see ble::Gap::EventHandler::onScanRequestReceived().
*/ */
struct ScanRequestEvent_t { struct ScanRequestEvent_t {
#if !defined(DOXYGEN_ONLY)
/** Create scan request event. /** Create scan request event.
* *
* @param advHandle Advertising handle. * @param advHandle Advertising handle.
@ -551,6 +564,7 @@ struct ScanRequestEvent_t {
advHandle(advHandle), advHandle(advHandle),
peerAddressType(peerAddressType), peerAddressType(peerAddressType),
peerAddress(peerAddress) { } peerAddress(peerAddress) { }
#endif
/** Get advertising handle. */ /** Get advertising handle. */
advertising_handle_t getAdvHandle() const advertising_handle_t getAdvHandle() const
@ -582,10 +596,12 @@ private:
* @see ble::Gap::EventHandler::onDisconnectionComplete(). * @see ble::Gap::EventHandler::onDisconnectionComplete().
*/ */
struct DisconnectionEvent { struct DisconnectionEvent {
#if !defined(DOXYGEN_ONLY)
DisconnectionEvent( DisconnectionEvent(
connection_handle_t connectionHandle, connection_handle_t connectionHandle,
const disconnection_reason_t &reason const disconnection_reason_t &reason
) : connectionHandle(connectionHandle), reason(reason) { } ) : connectionHandle(connectionHandle), reason(reason) { }
#endif
/** /**
* Get the handle of the connection that has expired. * Get the handle of the connection that has expired.
@ -614,6 +630,7 @@ private:
* @see ble::Gap::EventHandler::onUpdateConnectionParametersRequest(). * @see ble::Gap::EventHandler::onUpdateConnectionParametersRequest().
*/ */
struct UpdateConnectionParametersRequestEvent { struct UpdateConnectionParametersRequestEvent {
#if !defined(DOXYGEN_ONLY)
UpdateConnectionParametersRequestEvent( UpdateConnectionParametersRequestEvent(
connection_handle_t connectionHandle, connection_handle_t connectionHandle,
const conn_interval_t &minConnectionInterval, const conn_interval_t &minConnectionInterval,
@ -627,6 +644,7 @@ struct UpdateConnectionParametersRequestEvent {
slaveLatency(slaveLatency), slaveLatency(slaveLatency),
supervisionTimeout(supervision_timeout) supervisionTimeout(supervision_timeout)
{ } { }
#endif
/** /**
* Get the connection handle. * Get the connection handle.
@ -682,6 +700,7 @@ private:
* @see ble::Gap::EventHandler::onConnectionParametersUpdateComplete(). * @see ble::Gap::EventHandler::onConnectionParametersUpdateComplete().
*/ */
struct ConnectionParametersUpdateCompleteEvent { struct ConnectionParametersUpdateCompleteEvent {
#if !defined(DOXYGEN_ONLY)
ConnectionParametersUpdateCompleteEvent( ConnectionParametersUpdateCompleteEvent(
ble_error_t status, ble_error_t status,
connection_handle_t connectionHandle, connection_handle_t connectionHandle,
@ -695,6 +714,7 @@ struct ConnectionParametersUpdateCompleteEvent {
slaveLatency(slaveLatency), slaveLatency(slaveLatency),
supervisionTimeout(supervisionTimeout) supervisionTimeout(supervisionTimeout)
{ } { }
#endif
/** /**
* Get The status of the operation. It is equal to BLE_ERROR_NONE in case of * Get The status of the operation. It is equal to BLE_ERROR_NONE in case of
@ -746,7 +766,6 @@ private:
}; };
} // namespace ble } // namespace ble
#endif //BLE_GAP_EVENTS_H #endif //BLE_GAP_EVENTS_H