mirror of
https://github.com/jam422470459/EPD-nRF52-hema213.git
synced 2025-12-19 14:53:19 +08:00
move components to SDK dir
This commit is contained in:
Shuanglei Tao
344
SDK/12.3.0_d7731ad/components/ble/ble_services/ble_bas/ble_bas.c
Normal file
344
SDK/12.3.0_d7731ad/components/ble/ble_services/ble_bas/ble_bas.c
Normal file
@@ -0,0 +1,344 @@
|
||||
/**
|
||||
* Copyright (c) 2012 - 2017, Nordic Semiconductor ASA
|
||||
*
|
||||
* All rights reserved.
|
||||
*
|
||||
* Redistribution and use in source and binary forms, with or without modification,
|
||||
* are permitted provided that the following conditions are met:
|
||||
*
|
||||
* 1. Redistributions of source code must retain the above copyright notice, this
|
||||
* list of conditions and the following disclaimer.
|
||||
*
|
||||
* 2. Redistributions in binary form, except as embedded into a Nordic
|
||||
* Semiconductor ASA integrated circuit in a product or a software update for
|
||||
* such product, must reproduce the above copyright notice, this list of
|
||||
* conditions and the following disclaimer in the documentation and/or other
|
||||
* materials provided with the distribution.
|
||||
*
|
||||
* 3. Neither the name of Nordic Semiconductor ASA nor the names of its
|
||||
* contributors may be used to endorse or promote products derived from this
|
||||
* software without specific prior written permission.
|
||||
*
|
||||
* 4. This software, with or without modification, must only be used with a
|
||||
* Nordic Semiconductor ASA integrated circuit.
|
||||
*
|
||||
* 5. Any software provided in binary form under this license must not be reverse
|
||||
* engineered, decompiled, modified and/or disassembled.
|
||||
*
|
||||
* THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
|
||||
* OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
||||
* OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||||
* DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
|
||||
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
||||
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
|
||||
* GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
||||
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
|
||||
* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
||||
*
|
||||
*/
|
||||
|
||||
/* Attention!
|
||||
* To maintain compliance with Nordic Semiconductor ASA<53>s Bluetooth profile
|
||||
* qualification listings, this section of source code must not be modified.
|
||||
*/
|
||||
#include "sdk_common.h"
|
||||
#if NRF_MODULE_ENABLED(BLE_BAS)
|
||||
#include "ble_bas.h"
|
||||
#include <string.h>
|
||||
#include "ble_srv_common.h"
|
||||
|
||||
|
||||
#define INVALID_BATTERY_LEVEL 255
|
||||
|
||||
|
||||
/**@brief Function for handling the Connect event.
|
||||
*
|
||||
* @param[in] p_bas Battery Service structure.
|
||||
* @param[in] p_ble_evt Event received from the BLE stack.
|
||||
*/
|
||||
static void on_connect(ble_bas_t * p_bas, ble_evt_t * p_ble_evt)
|
||||
{
|
||||
p_bas->conn_handle = p_ble_evt->evt.gap_evt.conn_handle;
|
||||
}
|
||||
|
||||
|
||||
/**@brief Function for handling the Disconnect event.
|
||||
*
|
||||
* @param[in] p_bas Battery Service structure.
|
||||
* @param[in] p_ble_evt Event received from the BLE stack.
|
||||
*/
|
||||
static void on_disconnect(ble_bas_t * p_bas, ble_evt_t * p_ble_evt)
|
||||
{
|
||||
UNUSED_PARAMETER(p_ble_evt);
|
||||
p_bas->conn_handle = BLE_CONN_HANDLE_INVALID;
|
||||
}
|
||||
|
||||
|
||||
/**@brief Function for handling the Write event.
|
||||
*
|
||||
* @param[in] p_bas Battery Service structure.
|
||||
* @param[in] p_ble_evt Event received from the BLE stack.
|
||||
*/
|
||||
static void on_write(ble_bas_t * p_bas, ble_evt_t * p_ble_evt)
|
||||
{
|
||||
if (p_bas->is_notification_supported)
|
||||
{
|
||||
ble_gatts_evt_write_t * p_evt_write = &p_ble_evt->evt.gatts_evt.params.write;
|
||||
|
||||
if (
|
||||
(p_evt_write->handle == p_bas->battery_level_handles.cccd_handle)
|
||||
&&
|
||||
(p_evt_write->len == 2)
|
||||
)
|
||||
{
|
||||
// CCCD written, call application event handler
|
||||
if (p_bas->evt_handler != NULL)
|
||||
{
|
||||
ble_bas_evt_t evt;
|
||||
|
||||
if (ble_srv_is_notification_enabled(p_evt_write->data))
|
||||
{
|
||||
evt.evt_type = BLE_BAS_EVT_NOTIFICATION_ENABLED;
|
||||
}
|
||||
else
|
||||
{
|
||||
evt.evt_type = BLE_BAS_EVT_NOTIFICATION_DISABLED;
|
||||
}
|
||||
|
||||
p_bas->evt_handler(p_bas, &evt);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
void ble_bas_on_ble_evt(ble_bas_t * p_bas, ble_evt_t * p_ble_evt)
|
||||
{
|
||||
if (p_bas == NULL || p_ble_evt == NULL)
|
||||
{
|
||||
return;
|
||||
}
|
||||
|
||||
switch (p_ble_evt->header.evt_id)
|
||||
{
|
||||
case BLE_GAP_EVT_CONNECTED:
|
||||
on_connect(p_bas, p_ble_evt);
|
||||
break;
|
||||
|
||||
case BLE_GAP_EVT_DISCONNECTED:
|
||||
on_disconnect(p_bas, p_ble_evt);
|
||||
break;
|
||||
|
||||
case BLE_GATTS_EVT_WRITE:
|
||||
on_write(p_bas, p_ble_evt);
|
||||
break;
|
||||
|
||||
default:
|
||||
// No implementation needed.
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
/**@brief Function for adding the Battery Level characteristic.
|
||||
*
|
||||
* @param[in] p_bas Battery Service structure.
|
||||
* @param[in] p_bas_init Information needed to initialize the service.
|
||||
*
|
||||
* @return NRF_SUCCESS on success, otherwise an error code.
|
||||
*/
|
||||
static uint32_t battery_level_char_add(ble_bas_t * p_bas, const ble_bas_init_t * p_bas_init)
|
||||
{
|
||||
uint32_t err_code;
|
||||
ble_gatts_char_md_t char_md;
|
||||
ble_gatts_attr_md_t cccd_md;
|
||||
ble_gatts_attr_t attr_char_value;
|
||||
ble_uuid_t ble_uuid;
|
||||
ble_gatts_attr_md_t attr_md;
|
||||
uint8_t initial_battery_level;
|
||||
uint8_t encoded_report_ref[BLE_SRV_ENCODED_REPORT_REF_LEN];
|
||||
uint8_t init_len;
|
||||
|
||||
// Add Battery Level characteristic
|
||||
if (p_bas->is_notification_supported)
|
||||
{
|
||||
memset(&cccd_md, 0, sizeof(cccd_md));
|
||||
|
||||
// According to BAS_SPEC_V10, the read operation on cccd should be possible without
|
||||
// authentication.
|
||||
BLE_GAP_CONN_SEC_MODE_SET_OPEN(&cccd_md.read_perm);
|
||||
cccd_md.write_perm = p_bas_init->battery_level_char_attr_md.cccd_write_perm;
|
||||
cccd_md.vloc = BLE_GATTS_VLOC_STACK;
|
||||
}
|
||||
|
||||
memset(&char_md, 0, sizeof(char_md));
|
||||
|
||||
char_md.char_props.read = 1;
|
||||
char_md.char_props.notify = (p_bas->is_notification_supported) ? 1 : 0;
|
||||
char_md.p_char_user_desc = NULL;
|
||||
char_md.p_char_pf = NULL;
|
||||
char_md.p_user_desc_md = NULL;
|
||||
char_md.p_cccd_md = (p_bas->is_notification_supported) ? &cccd_md : NULL;
|
||||
char_md.p_sccd_md = NULL;
|
||||
|
||||
BLE_UUID_BLE_ASSIGN(ble_uuid, BLE_UUID_BATTERY_LEVEL_CHAR);
|
||||
|
||||
memset(&attr_md, 0, sizeof(attr_md));
|
||||
|
||||
attr_md.read_perm = p_bas_init->battery_level_char_attr_md.read_perm;
|
||||
attr_md.write_perm = p_bas_init->battery_level_char_attr_md.write_perm;
|
||||
attr_md.vloc = BLE_GATTS_VLOC_STACK;
|
||||
attr_md.rd_auth = 0;
|
||||
attr_md.wr_auth = 0;
|
||||
attr_md.vlen = 0;
|
||||
|
||||
initial_battery_level = p_bas_init->initial_batt_level;
|
||||
|
||||
memset(&attr_char_value, 0, sizeof(attr_char_value));
|
||||
|
||||
attr_char_value.p_uuid = &ble_uuid;
|
||||
attr_char_value.p_attr_md = &attr_md;
|
||||
attr_char_value.init_len = sizeof(uint8_t);
|
||||
attr_char_value.init_offs = 0;
|
||||
attr_char_value.max_len = sizeof(uint8_t);
|
||||
attr_char_value.p_value = &initial_battery_level;
|
||||
|
||||
err_code = sd_ble_gatts_characteristic_add(p_bas->service_handle, &char_md,
|
||||
&attr_char_value,
|
||||
&p_bas->battery_level_handles);
|
||||
if (err_code != NRF_SUCCESS)
|
||||
{
|
||||
return err_code;
|
||||
}
|
||||
|
||||
if (p_bas_init->p_report_ref != NULL)
|
||||
{
|
||||
// Add Report Reference descriptor
|
||||
BLE_UUID_BLE_ASSIGN(ble_uuid, BLE_UUID_REPORT_REF_DESCR);
|
||||
|
||||
memset(&attr_md, 0, sizeof(attr_md));
|
||||
|
||||
attr_md.read_perm = p_bas_init->battery_level_report_read_perm;
|
||||
BLE_GAP_CONN_SEC_MODE_SET_NO_ACCESS(&attr_md.write_perm);
|
||||
|
||||
attr_md.vloc = BLE_GATTS_VLOC_STACK;
|
||||
attr_md.rd_auth = 0;
|
||||
attr_md.wr_auth = 0;
|
||||
attr_md.vlen = 0;
|
||||
|
||||
init_len = ble_srv_report_ref_encode(encoded_report_ref, p_bas_init->p_report_ref);
|
||||
|
||||
memset(&attr_char_value, 0, sizeof(attr_char_value));
|
||||
|
||||
attr_char_value.p_uuid = &ble_uuid;
|
||||
attr_char_value.p_attr_md = &attr_md;
|
||||
attr_char_value.init_len = init_len;
|
||||
attr_char_value.init_offs = 0;
|
||||
attr_char_value.max_len = attr_char_value.init_len;
|
||||
attr_char_value.p_value = encoded_report_ref;
|
||||
|
||||
err_code = sd_ble_gatts_descriptor_add(p_bas->battery_level_handles.value_handle,
|
||||
&attr_char_value,
|
||||
&p_bas->report_ref_handle);
|
||||
if (err_code != NRF_SUCCESS)
|
||||
{
|
||||
return err_code;
|
||||
}
|
||||
}
|
||||
else
|
||||
{
|
||||
p_bas->report_ref_handle = BLE_GATT_HANDLE_INVALID;
|
||||
}
|
||||
|
||||
return NRF_SUCCESS;
|
||||
}
|
||||
|
||||
|
||||
uint32_t ble_bas_init(ble_bas_t * p_bas, const ble_bas_init_t * p_bas_init)
|
||||
{
|
||||
if (p_bas == NULL || p_bas_init == NULL)
|
||||
{
|
||||
return NRF_ERROR_NULL;
|
||||
}
|
||||
|
||||
uint32_t err_code;
|
||||
ble_uuid_t ble_uuid;
|
||||
|
||||
// Initialize service structure
|
||||
p_bas->evt_handler = p_bas_init->evt_handler;
|
||||
p_bas->conn_handle = BLE_CONN_HANDLE_INVALID;
|
||||
p_bas->is_notification_supported = p_bas_init->support_notification;
|
||||
p_bas->battery_level_last = INVALID_BATTERY_LEVEL;
|
||||
|
||||
// Add service
|
||||
BLE_UUID_BLE_ASSIGN(ble_uuid, BLE_UUID_BATTERY_SERVICE);
|
||||
|
||||
err_code = sd_ble_gatts_service_add(BLE_GATTS_SRVC_TYPE_PRIMARY, &ble_uuid, &p_bas->service_handle);
|
||||
if (err_code != NRF_SUCCESS)
|
||||
{
|
||||
return err_code;
|
||||
}
|
||||
|
||||
// Add battery level characteristic
|
||||
return battery_level_char_add(p_bas, p_bas_init);
|
||||
}
|
||||
|
||||
|
||||
uint32_t ble_bas_battery_level_update(ble_bas_t * p_bas, uint8_t battery_level)
|
||||
{
|
||||
if (p_bas == NULL)
|
||||
{
|
||||
return NRF_ERROR_NULL;
|
||||
}
|
||||
|
||||
uint32_t err_code = NRF_SUCCESS;
|
||||
ble_gatts_value_t gatts_value;
|
||||
|
||||
if (battery_level != p_bas->battery_level_last)
|
||||
{
|
||||
// Initialize value struct.
|
||||
memset(&gatts_value, 0, sizeof(gatts_value));
|
||||
|
||||
gatts_value.len = sizeof(uint8_t);
|
||||
gatts_value.offset = 0;
|
||||
gatts_value.p_value = &battery_level;
|
||||
|
||||
// Update database.
|
||||
err_code = sd_ble_gatts_value_set(p_bas->conn_handle,
|
||||
p_bas->battery_level_handles.value_handle,
|
||||
&gatts_value);
|
||||
if (err_code == NRF_SUCCESS)
|
||||
{
|
||||
// Save new battery value.
|
||||
p_bas->battery_level_last = battery_level;
|
||||
}
|
||||
else
|
||||
{
|
||||
return err_code;
|
||||
}
|
||||
|
||||
// Send value if connected and notifying.
|
||||
if ((p_bas->conn_handle != BLE_CONN_HANDLE_INVALID) && p_bas->is_notification_supported)
|
||||
{
|
||||
ble_gatts_hvx_params_t hvx_params;
|
||||
|
||||
memset(&hvx_params, 0, sizeof(hvx_params));
|
||||
|
||||
hvx_params.handle = p_bas->battery_level_handles.value_handle;
|
||||
hvx_params.type = BLE_GATT_HVX_NOTIFICATION;
|
||||
hvx_params.offset = gatts_value.offset;
|
||||
hvx_params.p_len = &gatts_value.len;
|
||||
hvx_params.p_data = gatts_value.p_value;
|
||||
|
||||
err_code = sd_ble_gatts_hvx(p_bas->conn_handle, &hvx_params);
|
||||
}
|
||||
else
|
||||
{
|
||||
err_code = NRF_ERROR_INVALID_STATE;
|
||||
}
|
||||
}
|
||||
|
||||
return err_code;
|
||||
}
|
||||
#endif // NRF_MODULE_ENABLED(BLE_BAS)
|
||||
170
SDK/12.3.0_d7731ad/components/ble/ble_services/ble_bas/ble_bas.h
Normal file
170
SDK/12.3.0_d7731ad/components/ble/ble_services/ble_bas/ble_bas.h
Normal file
@@ -0,0 +1,170 @@
|
||||
/**
|
||||
* Copyright (c) 2012 - 2017, Nordic Semiconductor ASA
|
||||
*
|
||||
* All rights reserved.
|
||||
*
|
||||
* Redistribution and use in source and binary forms, with or without modification,
|
||||
* are permitted provided that the following conditions are met:
|
||||
*
|
||||
* 1. Redistributions of source code must retain the above copyright notice, this
|
||||
* list of conditions and the following disclaimer.
|
||||
*
|
||||
* 2. Redistributions in binary form, except as embedded into a Nordic
|
||||
* Semiconductor ASA integrated circuit in a product or a software update for
|
||||
* such product, must reproduce the above copyright notice, this list of
|
||||
* conditions and the following disclaimer in the documentation and/or other
|
||||
* materials provided with the distribution.
|
||||
*
|
||||
* 3. Neither the name of Nordic Semiconductor ASA nor the names of its
|
||||
* contributors may be used to endorse or promote products derived from this
|
||||
* software without specific prior written permission.
|
||||
*
|
||||
* 4. This software, with or without modification, must only be used with a
|
||||
* Nordic Semiconductor ASA integrated circuit.
|
||||
*
|
||||
* 5. Any software provided in binary form under this license must not be reverse
|
||||
* engineered, decompiled, modified and/or disassembled.
|
||||
*
|
||||
* THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
|
||||
* OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
||||
* OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||||
* DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
|
||||
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
||||
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
|
||||
* GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
||||
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
|
||||
* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
||||
*
|
||||
*/
|
||||
|
||||
/** @file
|
||||
*
|
||||
* @defgroup ble_bas Battery Service
|
||||
* @{
|
||||
* @ingroup ble_sdk_srv
|
||||
* @brief Battery Service module.
|
||||
*
|
||||
* @details This module implements the Battery Service with the Battery Level characteristic.
|
||||
* During initialization it adds the Battery Service and Battery Level characteristic
|
||||
* to the BLE stack database. Optionally it can also add a Report Reference descriptor
|
||||
* to the Battery Level characteristic (used when including the Battery Service in
|
||||
* the HID service).
|
||||
*
|
||||
* If specified, the module will support notification of the Battery Level characteristic
|
||||
* through the ble_bas_battery_level_update() function.
|
||||
* If an event handler is supplied by the application, the Battery Service will
|
||||
* generate Battery Service events to the application.
|
||||
*
|
||||
* @note The application must propagate BLE stack events to the Battery Service module by calling
|
||||
* ble_bas_on_ble_evt() from the @ref softdevice_handler callback.
|
||||
*
|
||||
* @note Attention!
|
||||
* To maintain compliance with Nordic Semiconductor ASA Bluetooth profile
|
||||
* qualification listings, this section of source code must not be modified.
|
||||
*/
|
||||
|
||||
#ifndef BLE_BAS_H__
|
||||
#define BLE_BAS_H__
|
||||
|
||||
#include <stdint.h>
|
||||
#include <stdbool.h>
|
||||
#include "ble.h"
|
||||
#include "ble_srv_common.h"
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
/**@brief Battery Service event type. */
|
||||
typedef enum
|
||||
{
|
||||
BLE_BAS_EVT_NOTIFICATION_ENABLED, /**< Battery value notification enabled event. */
|
||||
BLE_BAS_EVT_NOTIFICATION_DISABLED /**< Battery value notification disabled event. */
|
||||
} ble_bas_evt_type_t;
|
||||
|
||||
/**@brief Battery Service event. */
|
||||
typedef struct
|
||||
{
|
||||
ble_bas_evt_type_t evt_type; /**< Type of event. */
|
||||
} ble_bas_evt_t;
|
||||
|
||||
// Forward declaration of the ble_bas_t type.
|
||||
typedef struct ble_bas_s ble_bas_t;
|
||||
|
||||
/**@brief Battery Service event handler type. */
|
||||
typedef void (*ble_bas_evt_handler_t) (ble_bas_t * p_bas, ble_bas_evt_t * p_evt);
|
||||
|
||||
/**@brief Battery Service init structure. This contains all options and data needed for
|
||||
* initialization of the service.*/
|
||||
typedef struct
|
||||
{
|
||||
ble_bas_evt_handler_t evt_handler; /**< Event handler to be called for handling events in the Battery Service. */
|
||||
bool support_notification; /**< TRUE if notification of Battery Level measurement is supported. */
|
||||
ble_srv_report_ref_t * p_report_ref; /**< If not NULL, a Report Reference descriptor with the specified value will be added to the Battery Level characteristic */
|
||||
uint8_t initial_batt_level; /**< Initial battery level */
|
||||
ble_srv_cccd_security_mode_t battery_level_char_attr_md; /**< Initial security level for battery characteristics attribute */
|
||||
ble_gap_conn_sec_mode_t battery_level_report_read_perm; /**< Initial security level for battery report read attribute */
|
||||
} ble_bas_init_t;
|
||||
|
||||
/**@brief Battery Service structure. This contains various status information for the service. */
|
||||
struct ble_bas_s
|
||||
{
|
||||
ble_bas_evt_handler_t evt_handler; /**< Event handler to be called for handling events in the Battery Service. */
|
||||
uint16_t service_handle; /**< Handle of Battery Service (as provided by the BLE stack). */
|
||||
ble_gatts_char_handles_t battery_level_handles; /**< Handles related to the Battery Level characteristic. */
|
||||
uint16_t report_ref_handle; /**< Handle of the Report Reference descriptor. */
|
||||
uint8_t battery_level_last; /**< Last Battery Level measurement passed to the Battery Service. */
|
||||
uint16_t conn_handle; /**< Handle of the current connection (as provided by the BLE stack, is BLE_CONN_HANDLE_INVALID if not in a connection). */
|
||||
bool is_notification_supported; /**< TRUE if notification of Battery Level is supported. */
|
||||
};
|
||||
|
||||
/**@brief Function for initializing the Battery Service.
|
||||
*
|
||||
* @param[out] p_bas Battery Service structure. This structure will have to be supplied by
|
||||
* the application. It will be initialized by this function, and will later
|
||||
* be used to identify this particular service instance.
|
||||
* @param[in] p_bas_init Information needed to initialize the service.
|
||||
*
|
||||
* @return NRF_SUCCESS on successful initialization of service, otherwise an error code.
|
||||
*/
|
||||
uint32_t ble_bas_init(ble_bas_t * p_bas, const ble_bas_init_t * p_bas_init);
|
||||
|
||||
/**@brief Function for handling the Application's BLE Stack events.
|
||||
*
|
||||
* @details Handles all events from the BLE stack of interest to the Battery Service.
|
||||
*
|
||||
* @note For the requirements in the BAS specification to be fulfilled,
|
||||
* ble_bas_battery_level_update() must be called upon reconnection if the
|
||||
* battery level has changed while the service has been disconnected from a bonded
|
||||
* client.
|
||||
*
|
||||
* @param[in] p_bas Battery Service structure.
|
||||
* @param[in] p_ble_evt Event received from the BLE stack.
|
||||
*/
|
||||
void ble_bas_on_ble_evt(ble_bas_t * p_bas, ble_evt_t * p_ble_evt);
|
||||
|
||||
/**@brief Function for updating the battery level.
|
||||
*
|
||||
* @details The application calls this function after having performed a battery measurement. If
|
||||
* notification has been enabled, the battery level characteristic is sent to the client.
|
||||
*
|
||||
* @note For the requirements in the BAS specification to be fulfilled,
|
||||
* this function must be called upon reconnection if the battery level has changed
|
||||
* while the service has been disconnected from a bonded client.
|
||||
*
|
||||
* @param[in] p_bas Battery Service structure.
|
||||
* @param[in] battery_level New battery measurement value (in percent of full capacity).
|
||||
*
|
||||
* @return NRF_SUCCESS on success, otherwise an error code.
|
||||
*/
|
||||
uint32_t ble_bas_battery_level_update(ble_bas_t * p_bas, uint8_t battery_level);
|
||||
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
#endif
|
||||
|
||||
#endif // BLE_BAS_H__
|
||||
|
||||
/** @} */
|
||||
Reference in New Issue
Block a user