11 changed files with 994 additions and 133 deletions
-
241.vscode/c_cpp_properties.app.json
-
160.vscode/c_cpp_properties.json
-
17.vscode/settings.json
-
2ble_app_uart_c/.vscode/keil-assistant.log
-
0ble_app_uart_c/.vscode/uv4.log.lock
-
2ble_app_uart_c/ble_app_uart_c_pca10100_s122.uvguix.h_zha
-
6ble_app_uart_c/ble_app_uart_c_pca10100_s122.uvoptx
-
110ble_app_uart_c/ble_app_uart_c_pca10100_s122.uvprojx
-
2ble_app_uart_c/main.c
-
319ble_app_uart_c/zble_nus_c.c
-
268ble_app_uart_c/zble_nus_c.h
@ -0,0 +1,241 @@ |
|||||
|
{ |
||||
|
"configurations": [ |
||||
|
{ |
||||
|
"name": "nrf52833_xxaa", |
||||
|
"includePath": [ |
||||
|
"libznordic\\include", |
||||
|
"sdk/external/fatfs/src/", |
||||
|
"sdk/external/fatfs/src/", |
||||
|
"sdk/external/fatfs/port/", |
||||
|
"sdk/components/libraries/block_dev/sdc/", |
||||
|
"sdk/components/libraries/block_dev/", |
||||
|
"sdk\\config", |
||||
|
"app\\src", |
||||
|
"sdk\\components", |
||||
|
"sdk\\components\\ble\\ble_advertising", |
||||
|
"sdk\\components\\ble\\ble_dtm", |
||||
|
"sdk\\components\\ble\\ble_link_ctx_manager", |
||||
|
"sdk\\components\\ble\\ble_racp", |
||||
|
"sdk\\components\\ble\\ble_services\\ble_ancs_c", |
||||
|
"sdk\\components\\ble\\ble_services\\ble_ans_c", |
||||
|
"sdk\\components\\ble\\ble_services\\ble_bas", |
||||
|
"sdk\\components\\ble\\ble_services\\ble_bas_c", |
||||
|
"sdk\\components\\ble\\ble_services\\ble_cscs", |
||||
|
"sdk\\components\\ble\\ble_services\\ble_cts_c", |
||||
|
"sdk\\components\\ble\\ble_services\\ble_dfu", |
||||
|
"sdk\\components\\ble\\ble_services\\ble_dis", |
||||
|
"sdk\\components\\ble\\ble_services\\ble_gls", |
||||
|
"sdk\\components\\ble\\ble_services\\ble_hids", |
||||
|
"sdk\\components\\ble\\ble_services\\ble_hrs", |
||||
|
"sdk\\components\\ble\\ble_services\\ble_hrs_c", |
||||
|
"sdk\\components\\ble\\ble_services\\ble_hts", |
||||
|
"sdk\\components\\ble\\ble_services\\ble_ias", |
||||
|
"sdk\\components\\ble\\ble_services\\ble_ias_c", |
||||
|
"sdk\\components\\ble\\ble_services\\ble_lbs", |
||||
|
"sdk\\components\\ble\\ble_services\\ble_lbs_c", |
||||
|
"sdk\\components\\ble\\ble_services\\ble_lls", |
||||
|
"sdk\\components\\ble\\ble_services\\ble_nus", |
||||
|
"sdk\\components\\ble\\ble_services\\ble_nus_c", |
||||
|
"sdk\\components\\ble\\ble_services\\ble_rscs", |
||||
|
"sdk\\components\\ble\\ble_services\\ble_rscs_c", |
||||
|
"sdk\\components\\ble\\ble_services\\ble_tps", |
||||
|
"sdk\\components\\ble\\common", |
||||
|
"sdk\\components\\ble\\nrf_ble_gatt", |
||||
|
"sdk\\components\\ble\\nrf_ble_qwr", |
||||
|
"sdk\\components\\ble\\peer_manager", |
||||
|
"sdk\\components\\boards", |
||||
|
"sdk\\components\\libraries\\atomic", |
||||
|
"sdk\\components\\libraries\\atomic_fifo", |
||||
|
"sdk\\components\\libraries\\atomic_flags", |
||||
|
"sdk\\components\\libraries\\balloc", |
||||
|
"sdk\\components\\libraries\\bootloader\\ble_dfu", |
||||
|
"sdk\\components\\libraries\\bsp", |
||||
|
"sdk\\components\\libraries\\button", |
||||
|
"sdk\\components\\libraries\\cli", |
||||
|
"sdk\\components\\libraries\\crc16", |
||||
|
"sdk\\components\\libraries\\crc32", |
||||
|
"sdk\\components\\libraries\\crypto", |
||||
|
"sdk\\components\\libraries\\csense", |
||||
|
"sdk\\components\\libraries\\csense_drv", |
||||
|
"sdk\\components\\libraries\\delay", |
||||
|
"sdk\\components\\libraries\\ecc", |
||||
|
"sdk\\components\\libraries\\experimental_section_vars", |
||||
|
"sdk\\components\\libraries\\experimental_task_manager", |
||||
|
"sdk\\components\\libraries\\fds", |
||||
|
"sdk\\components\\libraries\\fifo", |
||||
|
"sdk\\components\\libraries\\fstorage", |
||||
|
"sdk\\components\\libraries\\gfx", |
||||
|
"sdk\\components\\libraries\\gpiote", |
||||
|
"sdk\\components\\libraries\\hardfault", |
||||
|
"sdk\\components\\libraries\\hci", |
||||
|
"sdk\\components\\libraries\\led_softblink", |
||||
|
"sdk\\components\\libraries\\log", |
||||
|
"sdk\\components\\libraries\\log\\src", |
||||
|
"sdk\\components\\libraries\\low_power_pwm", |
||||
|
"sdk\\components\\libraries\\mem_manager", |
||||
|
"sdk\\components\\libraries\\memobj", |
||||
|
"sdk\\components\\libraries\\mpu", |
||||
|
"sdk\\components\\libraries\\mutex", |
||||
|
"sdk\\components\\libraries\\pwm", |
||||
|
"sdk\\components\\libraries\\pwr_mgmt", |
||||
|
"sdk\\components\\libraries\\queue", |
||||
|
"sdk\\components\\libraries\\ringbuf", |
||||
|
"sdk\\components\\libraries\\scheduler", |
||||
|
"sdk\\components\\libraries\\sdcard", |
||||
|
"sdk\\components\\libraries\\slip", |
||||
|
"sdk\\components\\libraries\\sortlist", |
||||
|
"sdk\\components\\libraries\\spi_mngr", |
||||
|
"sdk\\components\\libraries\\stack_guard", |
||||
|
"sdk\\components\\libraries\\strerror", |
||||
|
"sdk\\components\\libraries\\svc", |
||||
|
"sdk\\components\\libraries\\timer", |
||||
|
"sdk\\components\\libraries\\twi_mngr", |
||||
|
"sdk\\components\\libraries\\twi_sensor", |
||||
|
"sdk\\components\\libraries\\uart", |
||||
|
"sdk\\components\\libraries\\usbd", |
||||
|
"sdk\\components\\libraries\\usbd\\class\\audio", |
||||
|
"sdk\\components\\libraries\\usbd\\class\\cdc", |
||||
|
"sdk\\components\\libraries\\usbd\\class\\cdc\\acm", |
||||
|
"sdk\\components\\libraries\\usbd\\class\\hid", |
||||
|
"sdk\\components\\libraries\\usbd\\class\\hid\\generic", |
||||
|
"sdk\\components\\libraries\\usbd\\class\\hid\\kbd", |
||||
|
"sdk\\components\\libraries\\usbd\\class\\hid\\mouse", |
||||
|
"sdk\\components\\libraries\\usbd\\class\\msc", |
||||
|
"sdk\\components\\libraries\\util", |
||||
|
"sdk\\components\\nfc\\ndef\\conn_hand_parser", |
||||
|
"sdk\\components\\nfc\\ndef\\conn_hand_parser\\ac_rec_parser", |
||||
|
"sdk\\components\\nfc\\ndef\\conn_hand_parser\\ble_oob_advdata_parser", |
||||
|
"sdk\\components\\nfc\\ndef\\conn_hand_parser\\le_oob_rec_parser", |
||||
|
"sdk\\components\\nfc\\ndef\\connection_handover\\ac_rec", |
||||
|
"sdk\\components\\nfc\\ndef\\connection_handover\\ble_oob_advdata", |
||||
|
"sdk\\components\\nfc\\ndef\\connection_handover\\ble_pair_lib", |
||||
|
"sdk\\components\\nfc\\ndef\\connection_handover\\ble_pair_msg", |
||||
|
"sdk\\components\\nfc\\ndef\\connection_handover\\common", |
||||
|
"sdk\\components\\nfc\\ndef\\connection_handover\\ep_oob_rec", |
||||
|
"sdk\\components\\nfc\\ndef\\connection_handover\\hs_rec", |
||||
|
"sdk\\components\\nfc\\ndef\\connection_handover\\le_oob_rec", |
||||
|
"sdk\\components\\nfc\\ndef\\generic\\message", |
||||
|
"sdk\\components\\nfc\\ndef\\generic\\record", |
||||
|
"sdk\\components\\nfc\\ndef\\launchapp", |
||||
|
"sdk\\components\\nfc\\ndef\\parser\\message", |
||||
|
"sdk\\components\\nfc\\ndef\\parser\\record", |
||||
|
"sdk\\components\\nfc\\ndef\\text", |
||||
|
"sdk\\components\\nfc\\ndef\\uri", |
||||
|
"sdk\\components\\nfc\\platform", |
||||
|
"sdk\\components\\nfc\\t2t_lib", |
||||
|
"sdk\\components\\nfc\\t2t_parser", |
||||
|
"sdk\\components\\nfc\\t4t_lib", |
||||
|
"sdk\\components\\nfc\\t4t_parser\\apdu", |
||||
|
"sdk\\components\\nfc\\t4t_parser\\cc_file", |
||||
|
"sdk\\components\\nfc\\t4t_parser\\hl_detection_procedure", |
||||
|
"sdk\\components\\nfc\\t4t_parser\\tlv", |
||||
|
"sdk\\components\\softdevice\\common", |
||||
|
"sdk\\components\\softdevice\\s140\\headers", |
||||
|
"sdk\\components\\softdevice\\s140\\headers\\nrf52", |
||||
|
"sdk\\external\\fprintf", |
||||
|
"sdk\\external\\segger_rtt", |
||||
|
"sdk\\external\\utf_converter", |
||||
|
"sdk\\integration\\nrfx", |
||||
|
"sdk\\integration\\nrfx\\legacy", |
||||
|
"sdk\\modules\\nrfx", |
||||
|
"sdk\\modules\\nrfx\\drivers\\include", |
||||
|
"sdk\\modules\\nrfx\\hal", |
||||
|
"app\\config\\", |
||||
|
"app\\config", |
||||
|
"app", |
||||
|
"sdk\\modules\\nrfx\\soc", |
||||
|
"sdk\\modules\\nrfx\\drivers\\src", |
||||
|
"sdk\\modules\\nrfx\\drivers\\src\\prs", |
||||
|
"sdk\\modules\\nrfx\\mdk\\", |
||||
|
"sdk\\components\\toolchain\\cmsis\\include\\" |
||||
|
], |
||||
|
"defines": [ |
||||
|
"APP_TIMER_V2", |
||||
|
"APP_TIMER_V2_RTC1_ENABLED", |
||||
|
"BOARD_PCA10100", |
||||
|
"CONFIG_GPIO_AS_PINRESET", |
||||
|
"FLOAT_ABI_HARD", |
||||
|
"NRF52833_XXAA", |
||||
|
"NRF_SD_BLE_API_VERSION=7", |
||||
|
"S140", |
||||
|
"SOFTDEVICE_PRESENT", |
||||
|
"__HEAP_SIZE=2048", |
||||
|
"__STACK_SIZE=2048", |
||||
|
"__CC_ARM", |
||||
|
"__arm__", |
||||
|
"__align(x)=", |
||||
|
"__ALIGNOF__(x)=", |
||||
|
"__alignof__(x)=", |
||||
|
"__asm(x)=", |
||||
|
"__forceinline=", |
||||
|
"__restrict=", |
||||
|
"__global_reg(n)=", |
||||
|
"__inline=", |
||||
|
"__int64=long long", |
||||
|
"__INTADDR__(expr)=0", |
||||
|
"__irq=", |
||||
|
"__packed=", |
||||
|
"__pure=", |
||||
|
"__smc(n)=", |
||||
|
"__svc(n)=", |
||||
|
"__svc_indirect(n)=", |
||||
|
"__svc_indirect_r7(n)=", |
||||
|
"__value_in_regs=", |
||||
|
"__weak=", |
||||
|
"__writeonly=", |
||||
|
"__declspec(x)=", |
||||
|
"__attribute__(x)=", |
||||
|
"__nonnull__(x)=", |
||||
|
"__register=", |
||||
|
"__breakpoint(x)=", |
||||
|
"__cdp(x,y,z)=", |
||||
|
"__clrex()=", |
||||
|
"__clz(x)=0U", |
||||
|
"__current_pc()=0U", |
||||
|
"__current_sp()=0U", |
||||
|
"__disable_fiq()=", |
||||
|
"__disable_irq()=", |
||||
|
"__dmb(x)=", |
||||
|
"__dsb(x)=", |
||||
|
"__enable_fiq()=", |
||||
|
"__enable_irq()=", |
||||
|
"__fabs(x)=0.0", |
||||
|
"__fabsf(x)=0.0f", |
||||
|
"__force_loads()=", |
||||
|
"__force_stores()=", |
||||
|
"__isb(x)=", |
||||
|
"__ldrex(x)=0U", |
||||
|
"__ldrexd(x)=0U", |
||||
|
"__ldrt(x)=0U", |
||||
|
"__memory_changed()=", |
||||
|
"__nop()=", |
||||
|
"__pld(...)=", |
||||
|
"__pli(...)=", |
||||
|
"__qadd(x,y)=0", |
||||
|
"__qdbl(x)=0", |
||||
|
"__qsub(x,y)=0", |
||||
|
"__rbit(x)=0U", |
||||
|
"__rev(x)=0U", |
||||
|
"__return_address()=0U", |
||||
|
"__ror(x,y)=0U", |
||||
|
"__schedule_barrier()=", |
||||
|
"__semihost(x,y)=0", |
||||
|
"__sev()=", |
||||
|
"__sqrt(x)=0.0", |
||||
|
"__sqrtf(x)=0.0f", |
||||
|
"__ssat(x,y)=0", |
||||
|
"__strex(x,y)=0U", |
||||
|
"__strexd(x,y)=0", |
||||
|
"__strt(x,y)=", |
||||
|
"__swp(x,y)=0U", |
||||
|
"__usat(x,y)=0U", |
||||
|
"__wfe()=", |
||||
|
"__wfi()=", |
||||
|
"__yield()=", |
||||
|
"__vfp_status(x,y)=0" |
||||
|
], |
||||
|
"intelliSenseMode": "${default}" |
||||
|
} |
||||
|
], |
||||
|
"version": 4 |
||||
|
} |
||||
@ -0,0 +1,2 @@ |
|||||
|
[info] Log at : 2024/1/25|13:55:45|GMT+0800 |
||||
|
|
||||
@ -0,0 +1,319 @@ |
|||||
|
/** |
||||
|
* Copyright (c) 2012 - 2021, 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. |
||||
|
* |
||||
|
*/ |
||||
|
|
||||
|
#include "sdk_common.h" |
||||
|
#if 1 |
||||
|
#include <stdlib.h> |
||||
|
|
||||
|
#include "ble.h" |
||||
|
#include "zble_nus_c.h" |
||||
|
#include "ble_gattc.h" |
||||
|
#include "ble_srv_common.h" |
||||
|
#include "app_error.h" |
||||
|
|
||||
|
#define NRF_LOG_MODULE_NAME ble_nus_c |
||||
|
#include "nrf_log.h" |
||||
|
NRF_LOG_MODULE_REGISTER(); |
||||
|
|
||||
|
|
||||
|
/**@brief Function for intercepting the errors of GATTC and the BLE GATT Queue. |
||||
|
* |
||||
|
* @param[in] nrf_error Error code. |
||||
|
* @param[in] p_ctx Parameter from the event handler. |
||||
|
* @param[in] conn_handle Connection handle. |
||||
|
*/ |
||||
|
static void gatt_error_handler(uint32_t nrf_error, |
||||
|
void * p_ctx, |
||||
|
uint16_t conn_handle) |
||||
|
{ |
||||
|
ble_nus_c_t * p_ble_nus_c = (ble_nus_c_t *)p_ctx; |
||||
|
|
||||
|
NRF_LOG_DEBUG("A GATT Client error has occurred on conn_handle: 0X%X", conn_handle); |
||||
|
|
||||
|
if (p_ble_nus_c->error_handler != NULL) |
||||
|
{ |
||||
|
p_ble_nus_c->error_handler(nrf_error); |
||||
|
} |
||||
|
} |
||||
|
|
||||
|
|
||||
|
void ble_nus_c_on_db_disc_evt(ble_nus_c_t * p_ble_nus_c, ble_db_discovery_evt_t * p_evt) |
||||
|
{ |
||||
|
ble_nus_c_evt_t nus_c_evt; |
||||
|
memset(&nus_c_evt,0,sizeof(ble_nus_c_evt_t)); |
||||
|
|
||||
|
ble_gatt_db_char_t * p_chars = p_evt->params.discovered_db.charateristics; |
||||
|
|
||||
|
// Check if the NUS was discovered. |
||||
|
if ( (p_evt->evt_type == BLE_DB_DISCOVERY_COMPLETE) |
||||
|
&& (p_evt->params.discovered_db.srv_uuid.uuid == BLE_UUID_NUS_SERVICE) |
||||
|
&& (p_evt->params.discovered_db.srv_uuid.type == p_ble_nus_c->uuid_type)) |
||||
|
{ |
||||
|
for (uint32_t i = 0; i < p_evt->params.discovered_db.char_count; i++) |
||||
|
{ |
||||
|
switch (p_chars[i].characteristic.uuid.uuid) |
||||
|
{ |
||||
|
case BLE_UUID_NUS_RX_CHARACTERISTIC: |
||||
|
nus_c_evt.handles.nus_rx_handle = p_chars[i].characteristic.handle_value; |
||||
|
break; |
||||
|
|
||||
|
case BLE_UUID_NUS_TX_CHARACTERISTIC: |
||||
|
nus_c_evt.handles.nus_tx_handle = p_chars[i].characteristic.handle_value; |
||||
|
nus_c_evt.handles.nus_tx_cccd_handle = p_chars[i].cccd_handle; |
||||
|
break; |
||||
|
|
||||
|
case BLE_UUID_NUS_TX_BLOCK_CHARACTERISTIC: |
||||
|
nus_c_evt.handles.nus_tx_block_handle = p_chars[i].characteristic.handle_value; |
||||
|
nus_c_evt.handles.nus_tx_cccd_handle = p_chars[i].cccd_handle; |
||||
|
break; |
||||
|
|
||||
|
default: |
||||
|
break; |
||||
|
} |
||||
|
} |
||||
|
if (p_ble_nus_c->evt_handler != NULL) |
||||
|
{ |
||||
|
nus_c_evt.conn_handle = p_evt->conn_handle; |
||||
|
nus_c_evt.evt_type = BLE_NUS_C_EVT_DISCOVERY_COMPLETE; |
||||
|
p_ble_nus_c->evt_handler(p_ble_nus_c, &nus_c_evt); |
||||
|
} |
||||
|
} |
||||
|
} |
||||
|
|
||||
|
/**@brief Function for handling Handle Value Notification received from the SoftDevice. |
||||
|
* |
||||
|
* @details This function uses the Handle Value Notification received from the SoftDevice |
||||
|
* and checks if it is a notification of the NUS TX characteristic from the peer. |
||||
|
* If it is, this function decodes the data and sends it to the application. |
||||
|
* |
||||
|
* @param[in] p_ble_nus_c Pointer to the NUS Client structure. |
||||
|
* @param[in] p_ble_evt Pointer to the BLE event received. |
||||
|
*/ |
||||
|
static void on_hvx(ble_nus_c_t * p_ble_nus_c, ble_evt_t const * p_ble_evt) |
||||
|
{ |
||||
|
// HVX can only occur from client sending. |
||||
|
if ( (p_ble_nus_c->handles.nus_tx_handle != BLE_GATT_HANDLE_INVALID) |
||||
|
&& (p_ble_evt->evt.gattc_evt.params.hvx.handle == p_ble_nus_c->handles.nus_tx_handle) |
||||
|
&& (p_ble_nus_c->evt_handler != NULL)) |
||||
|
{ |
||||
|
ble_nus_c_evt_t ble_nus_c_evt; |
||||
|
|
||||
|
ble_nus_c_evt.evt_type = BLE_NUS_C_EVT_NUS_TX_EVT; |
||||
|
ble_nus_c_evt.p_data = (uint8_t *)p_ble_evt->evt.gattc_evt.params.hvx.data; |
||||
|
ble_nus_c_evt.data_len = p_ble_evt->evt.gattc_evt.params.hvx.len; |
||||
|
|
||||
|
p_ble_nus_c->evt_handler(p_ble_nus_c, &ble_nus_c_evt); |
||||
|
NRF_LOG_DEBUG("Client sending data."); |
||||
|
} |
||||
|
|
||||
|
if ( (p_ble_nus_c->handles.nus_tx_block_handle != BLE_GATT_HANDLE_INVALID) |
||||
|
&& (p_ble_evt->evt.gattc_evt.params.hvx.handle == p_ble_nus_c->handles.nus_tx_block_handle) |
||||
|
&& (p_ble_nus_c->evt_handler != NULL)) |
||||
|
{ |
||||
|
ble_nus_c_evt_t ble_nus_c_evt; |
||||
|
|
||||
|
ble_nus_c_evt.evt_type = BLE_NUS_C_EVT_NUS_TX_BLOCK_EVT; |
||||
|
ble_nus_c_evt.p_data = (uint8_t *)p_ble_evt->evt.gattc_evt.params.hvx.data; |
||||
|
ble_nus_c_evt.data_len = p_ble_evt->evt.gattc_evt.params.hvx.len; |
||||
|
|
||||
|
p_ble_nus_c->evt_handler(p_ble_nus_c, &ble_nus_c_evt); |
||||
|
NRF_LOG_DEBUG("Client sending data."); |
||||
|
} |
||||
|
} |
||||
|
|
||||
|
uint32_t ble_nus_c_init(ble_nus_c_t * p_ble_nus_c, ble_nus_c_init_t * p_ble_nus_c_init) |
||||
|
{ |
||||
|
uint32_t err_code; |
||||
|
ble_uuid_t uart_uuid; |
||||
|
ble_uuid128_t nus_base_uuid = NUS_BASE_UUID; |
||||
|
|
||||
|
VERIFY_PARAM_NOT_NULL(p_ble_nus_c); |
||||
|
VERIFY_PARAM_NOT_NULL(p_ble_nus_c_init); |
||||
|
VERIFY_PARAM_NOT_NULL(p_ble_nus_c_init->p_gatt_queue); |
||||
|
|
||||
|
err_code = sd_ble_uuid_vs_add(&nus_base_uuid, &p_ble_nus_c->uuid_type); |
||||
|
VERIFY_SUCCESS(err_code); |
||||
|
|
||||
|
uart_uuid.type = p_ble_nus_c->uuid_type; |
||||
|
uart_uuid.uuid = BLE_UUID_NUS_SERVICE; |
||||
|
|
||||
|
p_ble_nus_c->conn_handle = BLE_CONN_HANDLE_INVALID; |
||||
|
p_ble_nus_c->evt_handler = p_ble_nus_c_init->evt_handler; |
||||
|
p_ble_nus_c->error_handler = p_ble_nus_c_init->error_handler; |
||||
|
p_ble_nus_c->handles.nus_tx_handle = BLE_GATT_HANDLE_INVALID; |
||||
|
p_ble_nus_c->handles.nus_tx_block_handle = BLE_GATT_HANDLE_INVALID; |
||||
|
p_ble_nus_c->handles.nus_rx_handle = BLE_GATT_HANDLE_INVALID; |
||||
|
p_ble_nus_c->p_gatt_queue = p_ble_nus_c_init->p_gatt_queue; |
||||
|
|
||||
|
return ble_db_discovery_evt_register(&uart_uuid); |
||||
|
} |
||||
|
|
||||
|
void ble_nus_c_on_ble_evt(ble_evt_t const * p_ble_evt, void * p_context) |
||||
|
{ |
||||
|
ble_nus_c_t * p_ble_nus_c = (ble_nus_c_t *)p_context; |
||||
|
|
||||
|
if ((p_ble_nus_c == NULL) || (p_ble_evt == NULL)) |
||||
|
{ |
||||
|
return; |
||||
|
} |
||||
|
|
||||
|
if ( (p_ble_nus_c->conn_handle == BLE_CONN_HANDLE_INVALID) |
||||
|
||(p_ble_nus_c->conn_handle != p_ble_evt->evt.gap_evt.conn_handle) |
||||
|
) |
||||
|
{ |
||||
|
return; |
||||
|
} |
||||
|
|
||||
|
switch (p_ble_evt->header.evt_id) |
||||
|
{ |
||||
|
case BLE_GATTC_EVT_HVX: |
||||
|
on_hvx(p_ble_nus_c, p_ble_evt); |
||||
|
break; |
||||
|
|
||||
|
case BLE_GAP_EVT_DISCONNECTED: |
||||
|
if (p_ble_evt->evt.gap_evt.conn_handle == p_ble_nus_c->conn_handle |
||||
|
&& p_ble_nus_c->evt_handler != NULL) |
||||
|
{ |
||||
|
ble_nus_c_evt_t nus_c_evt; |
||||
|
|
||||
|
nus_c_evt.evt_type = BLE_NUS_C_EVT_DISCONNECTED; |
||||
|
|
||||
|
p_ble_nus_c->conn_handle = BLE_CONN_HANDLE_INVALID; |
||||
|
p_ble_nus_c->evt_handler(p_ble_nus_c, &nus_c_evt); |
||||
|
} |
||||
|
break; |
||||
|
|
||||
|
default: |
||||
|
// No implementation needed. |
||||
|
break; |
||||
|
} |
||||
|
} |
||||
|
|
||||
|
/**@brief Function for creating a message for writing to the CCCD. */ |
||||
|
static uint32_t cccd_configure(ble_nus_c_t * p_ble_nus_c, bool notification_enable) |
||||
|
{ |
||||
|
nrf_ble_gq_req_t cccd_req; |
||||
|
uint8_t cccd[BLE_CCCD_VALUE_LEN]; |
||||
|
uint16_t cccd_val = notification_enable ? BLE_GATT_HVX_NOTIFICATION : 0; |
||||
|
|
||||
|
memset(&cccd_req, 0, sizeof(nrf_ble_gq_req_t)); |
||||
|
|
||||
|
cccd[0] = LSB_16(cccd_val); |
||||
|
cccd[1] = MSB_16(cccd_val); |
||||
|
|
||||
|
cccd_req.type = NRF_BLE_GQ_REQ_GATTC_WRITE; |
||||
|
cccd_req.error_handler.cb = gatt_error_handler; |
||||
|
cccd_req.error_handler.p_ctx = p_ble_nus_c; |
||||
|
cccd_req.params.gattc_write.handle = p_ble_nus_c->handles.nus_tx_cccd_handle; |
||||
|
cccd_req.params.gattc_write.len = BLE_CCCD_VALUE_LEN; |
||||
|
cccd_req.params.gattc_write.offset = 0; |
||||
|
cccd_req.params.gattc_write.p_value = cccd; |
||||
|
cccd_req.params.gattc_write.write_op = BLE_GATT_OP_WRITE_REQ; |
||||
|
cccd_req.params.gattc_write.flags = BLE_GATT_EXEC_WRITE_FLAG_PREPARED_WRITE; |
||||
|
|
||||
|
return nrf_ble_gq_item_add(p_ble_nus_c->p_gatt_queue, &cccd_req, p_ble_nus_c->conn_handle); |
||||
|
} |
||||
|
|
||||
|
|
||||
|
uint32_t ble_nus_c_tx_notif_enable(ble_nus_c_t * p_ble_nus_c) |
||||
|
{ |
||||
|
VERIFY_PARAM_NOT_NULL(p_ble_nus_c); |
||||
|
|
||||
|
if ( (p_ble_nus_c->conn_handle == BLE_CONN_HANDLE_INVALID) |
||||
|
||(p_ble_nus_c->handles.nus_tx_cccd_handle == BLE_GATT_HANDLE_INVALID) |
||||
|
) |
||||
|
{ |
||||
|
return NRF_ERROR_INVALID_STATE; |
||||
|
} |
||||
|
return cccd_configure(p_ble_nus_c, true); |
||||
|
} |
||||
|
|
||||
|
|
||||
|
uint32_t ble_nus_c_string_send(ble_nus_c_t * p_ble_nus_c, uint8_t * p_string, uint16_t length) |
||||
|
{ |
||||
|
VERIFY_PARAM_NOT_NULL(p_ble_nus_c); |
||||
|
|
||||
|
nrf_ble_gq_req_t write_req; |
||||
|
|
||||
|
memset(&write_req, 0, sizeof(nrf_ble_gq_req_t)); |
||||
|
|
||||
|
if (length > BLE_NUS_MAX_DATA_LEN) |
||||
|
{ |
||||
|
NRF_LOG_WARNING("Content too long."); |
||||
|
return NRF_ERROR_INVALID_PARAM; |
||||
|
} |
||||
|
if (p_ble_nus_c->conn_handle == BLE_CONN_HANDLE_INVALID) |
||||
|
{ |
||||
|
NRF_LOG_WARNING("Connection handle invalid."); |
||||
|
return NRF_ERROR_INVALID_STATE; |
||||
|
} |
||||
|
|
||||
|
write_req.type = NRF_BLE_GQ_REQ_GATTC_WRITE; |
||||
|
write_req.error_handler.cb = gatt_error_handler; |
||||
|
write_req.error_handler.p_ctx = p_ble_nus_c; |
||||
|
write_req.params.gattc_write.handle = p_ble_nus_c->handles.nus_rx_handle; |
||||
|
write_req.params.gattc_write.len = length; |
||||
|
write_req.params.gattc_write.offset = 0; |
||||
|
write_req.params.gattc_write.p_value = p_string; |
||||
|
write_req.params.gattc_write.write_op = BLE_GATT_OP_WRITE_CMD; |
||||
|
write_req.params.gattc_write.flags = BLE_GATT_EXEC_WRITE_FLAG_PREPARED_WRITE; |
||||
|
|
||||
|
return nrf_ble_gq_item_add(p_ble_nus_c->p_gatt_queue, &write_req, p_ble_nus_c->conn_handle); |
||||
|
} |
||||
|
|
||||
|
|
||||
|
uint32_t ble_nus_c_handles_assign(ble_nus_c_t * p_ble_nus, |
||||
|
uint16_t conn_handle, |
||||
|
ble_nus_c_handles_t const * p_peer_handles) |
||||
|
{ |
||||
|
VERIFY_PARAM_NOT_NULL(p_ble_nus); |
||||
|
|
||||
|
p_ble_nus->conn_handle = conn_handle; |
||||
|
if (p_peer_handles != NULL) |
||||
|
{ |
||||
|
p_ble_nus->handles.nus_tx_cccd_handle = p_peer_handles->nus_tx_cccd_handle; |
||||
|
p_ble_nus->handles.nus_tx_handle = p_peer_handles->nus_tx_handle; |
||||
|
p_ble_nus->handles.nus_tx_block_handle = p_peer_handles->nus_tx_block_handle; |
||||
|
p_ble_nus->handles.nus_tx_block_cccd_handle = p_peer_handles->nus_tx_block_cccd_handle; |
||||
|
p_ble_nus->handles.nus_rx_handle = p_peer_handles->nus_rx_handle; |
||||
|
} |
||||
|
return nrf_ble_gq_conn_handle_register(p_ble_nus->p_gatt_queue, conn_handle); |
||||
|
} |
||||
|
#endif // NRF_MODULE_ENABLED(BLE_NUS_C) |
||||
@ -0,0 +1,268 @@ |
|||||
|
/** |
||||
|
* Copyright (c) 2012 - 2021, 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_nus_c Nordic UART Service Client |
||||
|
* @{ |
||||
|
* @ingroup ble_sdk_srv |
||||
|
* @brief Nordic UART Service Client module. |
||||
|
* |
||||
|
* @details This module contains the APIs and types exposed by the Nordic UART Service Client |
||||
|
* module. The application can use these APIs and types to perform the discovery of |
||||
|
* the Nordic UART Service at the peer and to interact with it. |
||||
|
* |
||||
|
* @note The application must register this module as the BLE event observer by using the |
||||
|
* NRF_SDH_BLE_OBSERVER macro. Example: |
||||
|
* @code |
||||
|
* ble_nus_c_t instance; |
||||
|
* NRF_SDH_BLE_OBSERVER(anything, BLE_NUS_C_BLE_OBSERVER_PRIO, |
||||
|
* ble_nus_c_on_ble_evt, &instance); |
||||
|
* @endcode |
||||
|
* |
||||
|
*/ |
||||
|
|
||||
|
#ifndef BLE_NUS_C_H__ |
||||
|
#define BLE_NUS_C_H__ |
||||
|
|
||||
|
#include <stdbool.h> |
||||
|
#include <stdint.h> |
||||
|
|
||||
|
#include "ble.h" |
||||
|
#include "ble_db_discovery.h" |
||||
|
#include "ble_gatt.h" |
||||
|
#include "ble_srv_common.h" |
||||
|
#include "nrf_ble_gq.h" |
||||
|
#include "nrf_sdh_ble.h" |
||||
|
#include "sdk_config.h" |
||||
|
|
||||
|
#ifdef __cplusplus |
||||
|
extern "C" { |
||||
|
#endif |
||||
|
|
||||
|
/**@brief Macro for defining a ble_nus_c instance. |
||||
|
* |
||||
|
* @param _name Name of the instance. |
||||
|
* @hideinitializer |
||||
|
*/ |
||||
|
#define BLE_NUS_C_DEF(_name) \ |
||||
|
static ble_nus_c_t _name; \ |
||||
|
NRF_SDH_BLE_OBSERVER(_name##_obs, BLE_NUS_C_BLE_OBSERVER_PRIO, ble_nus_c_on_ble_evt, &_name) |
||||
|
|
||||
|
/** @brief Macro for defining multiple ble_nus_c instances. |
||||
|
* |
||||
|
* @param _name Name of the array of instances. |
||||
|
* @param _cnt Number of instances to define. |
||||
|
* @hideinitializer |
||||
|
*/ |
||||
|
#define BLE_NUS_C_ARRAY_DEF(_name, _cnt) \ |
||||
|
static ble_nus_c_t _name[_cnt]; \ |
||||
|
NRF_SDH_BLE_OBSERVERS(_name##_obs, BLE_NUS_C_BLE_OBSERVER_PRIO, ble_nus_c_on_ble_evt, &_name, _cnt) |
||||
|
|
||||
|
#define NUS_BASE_UUID \ |
||||
|
{ \ |
||||
|
{ 0x9E, 0xCA, 0xDC, 0x24, 0x0E, 0xE5, 0xA9, 0xE0, 0x93, 0xF3, 0xA3, 0xB5, 0x00, 0x00, 0x40, 0x6E } \ |
||||
|
} /**< Used vendor-specific UUID. */ |
||||
|
|
||||
|
#define BLE_UUID_NUS_SERVICE 0x0001 /**< The UUID of the Nordic UART Service. */ |
||||
|
#define BLE_UUID_NUS_RX_CHARACTERISTIC 0x0002 /**< The UUID of the RX Characteristic. */ |
||||
|
#define BLE_UUID_NUS_TX_CHARACTERISTIC 0x0003 /**< The UUID of the TX Characteristic. */ |
||||
|
#define BLE_UUID_NUS_TX_BLOCK_CHARACTERISTIC 0x0004 /**< The UUID of the TX Characteristic. */ |
||||
|
|
||||
|
#define OPCODE_LENGTH 1 |
||||
|
#define HANDLE_LENGTH 2 |
||||
|
|
||||
|
/**@brief Maximum length of data (in bytes) that can be transmitted to the peer by the Nordic UART service module. */ |
||||
|
#if defined(NRF_SDH_BLE_GATT_MAX_MTU_SIZE) && (NRF_SDH_BLE_GATT_MAX_MTU_SIZE != 0) |
||||
|
#define BLE_NUS_MAX_DATA_LEN (NRF_SDH_BLE_GATT_MAX_MTU_SIZE - OPCODE_LENGTH - HANDLE_LENGTH) |
||||
|
#else |
||||
|
#define BLE_NUS_MAX_DATA_LEN (BLE_GATT_MTU_SIZE_DEFAULT - OPCODE_LENGTH - HANDLE_LENGTH) |
||||
|
#warning NRF_SDH_BLE_GATT_MAX_MTU_SIZE is not defined. |
||||
|
#endif |
||||
|
|
||||
|
/**@brief NUS Client event type. */ |
||||
|
typedef enum { |
||||
|
BLE_NUS_C_EVT_DISCOVERY_COMPLETE, /**< Event indicating that the NUS service and its characteristics were found. */ |
||||
|
BLE_NUS_C_EVT_NUS_TX_EVT, /**< Event indicating that the central received something from a peer. */ |
||||
|
BLE_NUS_C_EVT_NUS_TX_BLOCK_EVT, /**< Event indicating that the central received something from a peer. */ |
||||
|
BLE_NUS_C_EVT_DISCONNECTED /**< Event indicating that the NUS server disconnected. */ |
||||
|
} ble_nus_c_evt_type_t; |
||||
|
|
||||
|
/**@brief Handles on the connected peer device needed to interact with it. */ |
||||
|
typedef struct { |
||||
|
uint16_t nus_tx_handle; /**< Handle of the NUS TX characteristic, as provided by a discovery. */ |
||||
|
uint16_t nus_tx_cccd_handle; /**< Handle of the CCCD of the NUS TX characteristic, as provided by a discovery. */ |
||||
|
|
||||
|
uint16_t nus_tx_block_handle; /**< Handle of the NUS TX characteristic, as provided by a discovery. */ |
||||
|
uint16_t nus_tx_block_cccd_handle; /**< Handle of the CCCD of the NUS TX characteristic, as provided by a discovery. */ |
||||
|
|
||||
|
uint16_t nus_rx_handle; /**< Handle of the NUS RX characteristic, as provided by a discovery. */ |
||||
|
} ble_nus_c_handles_t; |
||||
|
|
||||
|
/**@brief Structure containing the NUS event data received from the peer. */ |
||||
|
typedef struct { |
||||
|
ble_nus_c_evt_type_t evt_type; |
||||
|
uint16_t conn_handle; |
||||
|
uint16_t max_data_len; |
||||
|
uint8_t* p_data; |
||||
|
uint16_t data_len; |
||||
|
ble_nus_c_handles_t handles; /**< Handles on which the Nordic UART service characteristics were discovered on the peer device. This is filled if the evt_type is @ref BLE_NUS_C_EVT_DISCOVERY_COMPLETE.*/ |
||||
|
} ble_nus_c_evt_t; |
||||
|
|
||||
|
// Forward declaration of the ble_nus_t type. |
||||
|
typedef struct ble_nus_c_s ble_nus_c_t; |
||||
|
|
||||
|
/**@brief Event handler type. |
||||
|
* |
||||
|
* @details This is the type of the event handler that is to be provided by the application |
||||
|
* of this module to receive events. |
||||
|
*/ |
||||
|
typedef void (*ble_nus_c_evt_handler_t)(ble_nus_c_t* p_ble_nus_c, ble_nus_c_evt_t const* p_evt); |
||||
|
|
||||
|
/**@brief NUS Client structure. */ |
||||
|
struct ble_nus_c_s { |
||||
|
uint8_t uuid_type; /**< UUID type. */ |
||||
|
uint16_t conn_handle; /**< Handle of the current connection. Set with @ref ble_nus_c_handles_assign when connected. */ |
||||
|
ble_nus_c_handles_t handles; /**< Handles on the connected peer device needed to interact with it. */ |
||||
|
ble_nus_c_evt_handler_t evt_handler; /**< Application event handler to be called when there is an event related to the NUS. */ |
||||
|
ble_srv_error_handler_t error_handler; /**< Function to be called in case of an error. */ |
||||
|
nrf_ble_gq_t* p_gatt_queue; /**< Pointer to BLE GATT Queue instance. */ |
||||
|
}; |
||||
|
|
||||
|
/**@brief NUS Client initialization structure. */ |
||||
|
typedef struct { |
||||
|
ble_nus_c_evt_handler_t evt_handler; /**< Application event handler to be called when there is an event related to the NUS. */ |
||||
|
ble_srv_error_handler_t error_handler; /**< Function to be called in case of an error. */ |
||||
|
nrf_ble_gq_t* p_gatt_queue; /**< Pointer to BLE GATT Queue instance. */ |
||||
|
} ble_nus_c_init_t; |
||||
|
|
||||
|
/**@brief Function for initializing the Nordic UART client module. |
||||
|
* |
||||
|
* @details This function registers with the Database Discovery module |
||||
|
* for the NUS. The Database Discovery module looks for the presence |
||||
|
* of a NUS instance at the peer when a discovery is started. |
||||
|
* |
||||
|
* @param[in] p_ble_nus_c Pointer to the NUS client structure. |
||||
|
* @param[in] p_ble_nus_c_init Pointer to the NUS initialization structure that contains the |
||||
|
* initialization information. |
||||
|
* |
||||
|
* @retval NRF_SUCCESS If the module was initialized successfully. |
||||
|
* @retval err_code Otherwise, this function propagates the error code |
||||
|
* returned by the Database Discovery module API |
||||
|
* @ref ble_db_discovery_evt_register. |
||||
|
*/ |
||||
|
uint32_t ble_nus_c_init(ble_nus_c_t* p_ble_nus_c, ble_nus_c_init_t* p_ble_nus_c_init); |
||||
|
|
||||
|
/**@brief Function for handling events from the Database Discovery module. |
||||
|
* |
||||
|
* @details This function handles an event from the Database Discovery module, and determines |
||||
|
* whether it relates to the discovery of NUS at the peer. If it does, the function |
||||
|
* calls the application's event handler to indicate that NUS was |
||||
|
* discovered at the peer. The function also populates the event with service-related |
||||
|
* information before providing it to the application. |
||||
|
* |
||||
|
* @param[in] p_ble_nus_c Pointer to the NUS client structure. |
||||
|
* @param[in] p_evt Pointer to the event received from the Database Discovery module. |
||||
|
*/ |
||||
|
void ble_nus_c_on_db_disc_evt(ble_nus_c_t* p_ble_nus_c, ble_db_discovery_evt_t* p_evt); |
||||
|
|
||||
|
/**@brief Function for handling BLE events from the SoftDevice. |
||||
|
* |
||||
|
* @details This function handles the BLE events received from the SoftDevice. If a BLE |
||||
|
* event is relevant to the NUS module, the function uses the event's data to update |
||||
|
* internal variables and, if necessary, send events to the application. |
||||
|
* |
||||
|
* @param[in] p_ble_evt Pointer to the BLE event. |
||||
|
* @param[in] p_context Pointer to the NUS client structure. |
||||
|
*/ |
||||
|
void ble_nus_c_on_ble_evt(ble_evt_t const* p_ble_evt, void* p_context); |
||||
|
|
||||
|
/**@brief Function for requesting the peer to start sending notification of TX characteristic. |
||||
|
* |
||||
|
* @details This function enables notifications of the NUS TX characteristic at the peer |
||||
|
* by writing to the CCCD of the NUS TX characteristic. |
||||
|
* |
||||
|
* @param p_ble_nus_c Pointer to the NUS client structure. |
||||
|
* |
||||
|
* @retval NRF_SUCCESS If the operation was successful. |
||||
|
* @retval err_code Otherwise, this API propagates the error code returned by function @ref nrf_ble_gq_item_add. |
||||
|
*/ |
||||
|
uint32_t ble_nus_c_tx_notif_enable(ble_nus_c_t* p_ble_nus_c); |
||||
|
|
||||
|
/**@brief Function for sending a string to the server. |
||||
|
* |
||||
|
* @details This function writes the RX characteristic of the server. |
||||
|
* |
||||
|
* @param[in] p_ble_nus_c Pointer to the NUS client structure. |
||||
|
* @param[in] p_string String to be sent. |
||||
|
* @param[in] length Length of the string. |
||||
|
* |
||||
|
* @retval NRF_SUCCESS If the string was sent successfully. |
||||
|
* @retval err_code Otherwise, this API propagates the error code returned by function @ref nrf_ble_gq_item_add. |
||||
|
*/ |
||||
|
uint32_t ble_nus_c_string_send(ble_nus_c_t* p_ble_nus_c, uint8_t* p_string, uint16_t length); |
||||
|
|
||||
|
/**@brief Function for assigning handles to this instance of nus_c. |
||||
|
* |
||||
|
* @details Call this function when a link has been established with a peer to |
||||
|
* associate the link to this instance of the module. This makes it |
||||
|
* possible to handle several links and associate each link to a particular |
||||
|
* instance of this module. The connection handle and attribute handles are |
||||
|
* provided from the discovery event @ref BLE_NUS_C_EVT_DISCOVERY_COMPLETE. |
||||
|
* |
||||
|
* @param[in] p_ble_nus_c Pointer to the NUS client structure instance to associate with these |
||||
|
* handles. |
||||
|
* @param[in] conn_handle Connection handle to associated with the given NUS Instance. |
||||
|
* @param[in] p_peer_handles Attribute handles on the NUS server that you want this NUS client to |
||||
|
* interact with. |
||||
|
* |
||||
|
* @retval NRF_SUCCESS If the operation was successful. |
||||
|
* @retval NRF_ERROR_NULL If a p_nus was a NULL pointer. |
||||
|
* @retval err_code Otherwise, this API propagates the error code returned |
||||
|
* by function @ref nrf_ble_gq_item_add. |
||||
|
*/ |
||||
|
uint32_t ble_nus_c_handles_assign(ble_nus_c_t* p_ble_nus_c, uint16_t conn_handle, ble_nus_c_handles_t const* p_peer_handles); |
||||
|
|
||||
|
#ifdef __cplusplus |
||||
|
} |
||||
|
#endif |
||||
|
|
||||
|
#endif // BLE_NUS_C_H__ |
||||
|
|
||||
|
/** @} */ |
||||
Write
Preview
Loading…
Cancel
Save
Reference in new issue