236 lines
8.0 KiB
C
236 lines
8.0 KiB
C
/****************************************Copyright (c)************************************************
|
||
**
|
||
**--------------File Info-----------------------------------------------------------------------------
|
||
** File name:ble_nus.c
|
||
** Last modified Date:
|
||
** Last Version:
|
||
** Descriptions :串口透传服务文件
|
||
**---------------------------------------------------------------------------------------------------*/
|
||
#include "sdk_common.h"
|
||
//这里设置了串口透传服务程序模块的“编译开关”，所以要在sdk_config.h中启用BLE_NUS
|
||
#if NRF_MODULE_ENABLED(BLE_NUS)
|
||
#include "ble.h"
|
||
#include "ble_nus.h"
|
||
#include "ble_srv_common.h"
|
||
#include "nrf_log.h"
|
||
|
||
#if 0
|
||
#define NRF_LOG_MODULE_NAME ble_nus
|
||
#if BLE_NUS_CONFIG_LOG_ENABLED
|
||
#define NRF_LOG_LEVEL BLE_NUS_CONFIG_LOG_LEVEL
|
||
#define NRF_LOG_INFO_COLOR BLE_NUS_CONFIG_INFO_COLOR
|
||
#define NRF_LOG_DEBUG_COLOR BLE_NUS_CONFIG_DEBUG_COLOR
|
||
#else // BLE_NUS_CONFIG_LOG_ENABLED
|
||
#define NRF_LOG_LEVEL 0
|
||
#endif // BLE_NUS_CONFIG_LOG_ENABLED
|
||
|
||
NRF_LOG_MODULE_REGISTER();
|
||
#endif
|
||
|
||
#define BLE_NUS_MAX_RX_CHAR_LEN BLE_NUS_MAX_DATA_LEN //RX特征最大长度（字节数）
|
||
#define BLE_NUS_MAX_TX_CHAR_LEN BLE_NUS_MAX_DATA_LEN //TX特征最大长度（字节数）
|
||
|
||
//SoftDevice提交的“Write”事件处理函数
|
||
static void on_write(ble_nus_t * p_nus, ble_evt_t const * p_ble_evt)
|
||
{
|
||
//定义一个串口透传事件结构体变量，用于执行回调时传递参数
|
||
ble_nus_evt_t evt;
|
||
//定义write事件结构体指针并指向GATT事件的write
|
||
ble_gatts_evt_write_t const * p_evt_write = &p_ble_evt->evt.gatts_evt.params.write;
|
||
|
||
//清空evt结构体
|
||
memset(&evt, 0, sizeof(ble_nus_evt_t));
|
||
//指向串口透传实例
|
||
evt.p_nus = p_nus;
|
||
//设置连接句柄
|
||
evt.conn_handle = p_ble_evt->evt.gatts_evt.conn_handle;
|
||
//写RX特征值
|
||
if ((p_evt_write->handle == p_nus->rx_handles.value_handle) &&
|
||
(p_nus->data_handler != NULL))
|
||
{
|
||
//设置事件类型
|
||
evt.type = BLE_NUS_EVT_RX_DATA;
|
||
//设置数据
|
||
evt.params.rx_data.p_data = p_evt_write->data;
|
||
//设置数据长度
|
||
evt.params.rx_data.length = p_evt_write->len;
|
||
//执行回调
|
||
p_nus->data_handler(&evt);
|
||
}
|
||
else
|
||
{
|
||
// Do Nothing. This event is not relevant for this service.
|
||
}
|
||
}
|
||
|
||
//SoftDevice提交的“BLE_GATTS_EVT_HVN_TX_COMPLETE”事件处理函数
|
||
static void on_hvx_tx_complete(ble_nus_t * p_nus, ble_evt_t const * p_ble_evt)
|
||
{
|
||
//定义一个串口透传事件结构体变量evt，用于执行回调时传递参数
|
||
ble_nus_evt_t evt;
|
||
//清零evt
|
||
memset(&evt, 0, sizeof(ble_nus_evt_t));
|
||
//设置事件类型
|
||
evt.type = BLE_NUS_EVT_TX_RDY;
|
||
//指向串口透传服务实例
|
||
evt.p_nus = p_nus;
|
||
//设置连接句柄
|
||
evt.conn_handle = p_ble_evt->evt.gatts_evt.conn_handle;
|
||
//执行回调
|
||
p_nus->data_handler(&evt);
|
||
}
|
||
|
||
|
||
//串口透传服务BLE事件监视者的事件回调函数
|
||
void ble_nus_on_ble_evt(ble_evt_t const * p_ble_evt, void * p_context)
|
||
{
|
||
//检查参数是否有效
|
||
if ((p_context == NULL) || (p_ble_evt == NULL))
|
||
{
|
||
return;
|
||
}
|
||
//定义一个串口透传结构体指针并指向串口透传结构体
|
||
ble_nus_t * p_nus = (ble_nus_t *)p_context;
|
||
//判断事件类型
|
||
switch (p_ble_evt->header.evt_id)
|
||
{
|
||
//写事件
|
||
case BLE_GATTS_EVT_WRITE:
|
||
on_write(p_nus, p_ble_evt);
|
||
break;
|
||
//TX就绪事件
|
||
case BLE_GATTS_EVT_HVN_TX_COMPLETE:
|
||
on_hvx_tx_complete(p_nus, p_ble_evt);
|
||
break;
|
||
|
||
default:
|
||
// No implementation needed.
|
||
break;
|
||
}
|
||
}
|
||
|
||
|
||
//初始化串口透传服务
|
||
uint32_t ble_nus_init(ble_nus_t * p_nus, ble_nus_init_t const * p_nus_init)
|
||
{
|
||
ret_code_t err_code;
|
||
//定义16位UUID结构体变量
|
||
ble_uuid_t ble_uuid;
|
||
//定义128位UUID结构体变量，并初始化为串口透传服务UUID基数
|
||
ble_uuid128_t nus_base_uuid = NUS_BASE_UUID;
|
||
//定义特征参数结构体变量
|
||
ble_add_char_params_t add_char_params;
|
||
//检查指针是否为NULL
|
||
VERIFY_PARAM_NOT_NULL(p_nus);
|
||
VERIFY_PARAM_NOT_NULL(p_nus_init);
|
||
|
||
//拷贝串口透传服务初始化结构体中的事件句柄
|
||
p_nus->data_handler = p_nus_init->data_handler;
|
||
|
||
//将自定义UUID基数添加到SoftDevice
|
||
err_code = sd_ble_uuid_vs_add(&nus_base_uuid, &p_nus->uuid_type);
|
||
VERIFY_SUCCESS(err_code);
|
||
//UUID类型和数值赋值给ble_uuid变量
|
||
ble_uuid.type = BLE_UUID_TYPE_BLE;
|
||
ble_uuid.uuid = BLE_UUID_NUS_SERVICE;
|
||
|
||
//添加串口透传服务
|
||
err_code = sd_ble_gatts_service_add(BLE_GATTS_SRVC_TYPE_PRIMARY,
|
||
&ble_uuid,
|
||
&p_nus->service_handle);
|
||
VERIFY_SUCCESS(err_code);
|
||
/*---------------------以下代码添加RX特征--------------------*/
|
||
//添加RX特征
|
||
//配置参数之前先清零add_char_params
|
||
memset(&add_char_params, 0, sizeof(add_char_params));
|
||
//RX特征的UUID
|
||
add_char_params.uuid = BLE_UUID_NUS_RX_CHARACTERISTIC;
|
||
//RX特征的UUID类型
|
||
add_char_params.uuid_type = p_nus->uuid_type;
|
||
//设置RX特征值的最大长度
|
||
add_char_params.max_len = BLE_NUS_MAX_RX_CHAR_LEN;
|
||
//设置RX特征值的初始长度
|
||
add_char_params.init_len = sizeof(uint8_t);
|
||
//设置RX的特征值长度为可变长度
|
||
add_char_params.is_var_len = true;
|
||
//设置RX特征的性质支持写
|
||
add_char_params.char_props.write = 1;
|
||
//设置RX特性的性质支持读
|
||
add_char_params.char_props.read = 1;
|
||
//设置RX特征的性质支持无响应写
|
||
add_char_params.char_props.write_wo_resp = 1;
|
||
//设置读/写RX特征值的安全需求：无安全性
|
||
add_char_params.read_access = SEC_OPEN;
|
||
add_char_params.write_access = SEC_OPEN;
|
||
//为串口透传服务添加RX特征
|
||
err_code = characteristic_add(p_nus->service_handle, &add_char_params, &p_nus->rx_handles);
|
||
if (err_code != NRF_SUCCESS)
|
||
{
|
||
return err_code;
|
||
}
|
||
/*---------------------添加RX特征-END------------------------*/
|
||
|
||
/*---------------------以下代码添加TX特征--------------------*/
|
||
//添加TX特征
|
||
//配置参数之前先清零add_char_params
|
||
memset(&add_char_params, 0, sizeof(add_char_params));
|
||
//TX特征的UUID
|
||
add_char_params.uuid = BLE_UUID_NUS_TX_CHARACTERISTIC;
|
||
//TX特征的UUID类型
|
||
add_char_params.uuid_type = p_nus->uuid_type;
|
||
//设置TX特征值的最大长度
|
||
add_char_params.max_len = BLE_NUS_MAX_TX_CHAR_LEN;
|
||
//设置TX特征值的初始长度
|
||
add_char_params.init_len = sizeof(uint8_t);
|
||
//设置TX的特征值长度为可变长度
|
||
add_char_params.is_var_len = true;
|
||
//设置TX特征的性质：支持通知
|
||
add_char_params.char_props.notify = 1;
|
||
//设置TX特性的性质：支持读
|
||
add_char_params.char_props.read = 1;
|
||
//设置读/写RX特征值的安全需求：无安全性
|
||
add_char_params.read_access = SEC_OPEN;
|
||
add_char_params.write_access = SEC_OPEN;
|
||
add_char_params.cccd_write_access = SEC_OPEN;
|
||
//为串口透传服务添加TX特征
|
||
return characteristic_add(p_nus->service_handle, &add_char_params, &p_nus->tx_handles);
|
||
/*---------------------添加TX特征-END------------------------*/
|
||
}
|
||
|
||
//蓝牙数据上传发送，并进行反馈
|
||
uint32_t ble_nus_data_send(ble_nus_t * p_nus,
|
||
uint8_t * p_data,
|
||
uint16_t * p_length,
|
||
uint16_t conn_handle)
|
||
{
|
||
ble_gatts_hvx_params_t hvx_params;
|
||
//验证p_uarts没有指向NULL
|
||
VERIFY_PARAM_NOT_NULL(p_nus);
|
||
|
||
//如果连接句柄无效，表示没有和主机建立连接，返回NRF_ERROR_NOT_FOUND
|
||
if (conn_handle == BLE_CONN_HANDLE_INVALID)
|
||
{
|
||
return NRF_ERROR_NOT_FOUND;
|
||
}
|
||
|
||
if (*p_length > BLE_NUS_MAX_DATA_LEN)
|
||
{
|
||
return NRF_ERROR_INVALID_PARAM;
|
||
}
|
||
//设置之前先清零hvx_params
|
||
memset(&hvx_params, 0, sizeof(hvx_params));
|
||
//TX特征值句柄
|
||
hvx_params.handle = p_nus->tx_handles.value_handle;
|
||
//发送的数据
|
||
hvx_params.p_data = p_data;
|
||
//发送的数据长度
|
||
hvx_params.p_len = p_length;
|
||
//类型为通知
|
||
hvx_params.type = BLE_GATT_HVX_NOTIFICATION;
|
||
//发送TX特征值通知
|
||
return sd_ble_gatts_hvx(conn_handle, &hvx_params);
|
||
}
|
||
|
||
|
||
#endif // NRF_MODULE_ENABLED(BLE_NUS)
|