初始版本

This commit is contained in:
xiaozhengsheng
2025-08-19 09:49:41 +08:00
parent 10f1ddf1c1
commit 6df0f7d96e
2974 changed files with 1712873 additions and 54 deletions

View File

@@ -0,0 +1,106 @@
/**
* Copyright (c) 2015 - 2020, 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 NRF_MODULE_ENABLED(NFC_LE_OOB_REC)
#include "nfc_le_oob_rec.h"
#include "sdk_errors.h"
#include "ble_gap.h"
#include "nfc_ble_pair_common.h"
/**
* @brief Function for validating AD structure content for a Bluetooth Carrier Configuration LE record.
*
* This function validates AD structure content. LE Bluetooth Device Address and LE Role
* fields are required. Security Manager Out Of Band Flags structure must not be included.
*
* @param[in] p_ble_advdata Pointer to the description of the payload.
*
* @retval NRF_SUCCESS If the validation was successful.
* @retval NRF_ERROR_INVALID_PARAM Otherwise.
*/
static ret_code_t nfc_le_oob_adv_data_check(ble_advdata_t const * const p_ble_advdata)
{
if ((false == p_ble_advdata->include_ble_device_addr) ||
(BLE_ADVDATA_ROLE_NOT_PRESENT == p_ble_advdata->le_role) ||
(NULL != p_ble_advdata->p_sec_mgr_oob_flags))
{
return NRF_ERROR_INVALID_PARAM;
}
/* If Flags field in AD structure is present, the BLE_GAP_ADV_FLAG_BR_EDR_NOT_SUPPORTED flag
must be set. */
if ((0 != p_ble_advdata->flags) &&
((p_ble_advdata->flags & BLE_GAP_ADV_FLAG_BR_EDR_NOT_SUPPORTED) == 0))
{
return NRF_ERROR_INVALID_PARAM;
}
return NRF_SUCCESS;
}
ret_code_t nfc_le_oob_payload_constructor(ble_advdata_t * p_ble_advdata,
uint8_t * p_buff,
uint32_t * p_len)
{
ret_code_t err_code = NRF_SUCCESS;
/* Check correctness of the configuration structure */
err_code = nfc_le_oob_adv_data_check(p_ble_advdata);
if (NRF_SUCCESS != err_code)
{
return err_code;
}
/* Encode AD structures into NFC record payload */
uint16_t buff_len = *p_len;
if (*p_len > UINT16_MAX)
{
buff_len = UINT16_MAX;
}
err_code = nfc_ble_oob_adv_data_encode(p_ble_advdata, p_buff, &buff_len);
/* Update total payload length */
*p_len = (uint32_t) buff_len;
return err_code;
}
#endif // NRF_MODULE_ENABLED(NFC_LE_OOB_REC)

View File

@@ -0,0 +1,123 @@
/**
* Copyright (c) 2015 - 2020, 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.
*
*/
#ifndef NFC_LE_OOB_REC_H__
#define NFC_LE_OOB_REC_H__
/**@file
*
* @defgroup nfc_le_oob_rec LE OOB records
* @{
* @ingroup nfc_ble_pair_msg
*
* @brief Generation of NFC NDEF LE OOB records for NDEF messages.
*
*/
#include <stdint.h>
#include "nfc_ndef_record.h"
#include "nfc_ble_oob_advdata.h"
#include "nfc_ble_pair_common.h"
#ifdef __cplusplus
extern "C" {
#endif
/**
* @brief Function for constructing the payload for a Bluetooth Carrier Configuration LE record.
*
* This function encodes the record payload according to the BLE AD structure. It implements
* an API compatible with @ref p_payload_constructor_t
*
* @param[in] p_ble_advdata Pointer to the description of the payload.
* @param[out] p_buff Pointer to payload destination. If NULL, function will
* calculate the expected size of the record payload.
*
* @param[in,out] p_len Size of available memory to write as input. Size of generated
* payload as output.
*
* @retval NRF_SUCCESS If the record payload was encoded successfully.
* @retval Other If the record payload encoding failed.
*/
ret_code_t nfc_le_oob_payload_constructor(ble_advdata_t * p_ble_advdata,
uint8_t * p_buff,
uint32_t * p_len);
/** @brief Macro for generating a description of an NFC NDEF Bluetooth Carrier Configuration LE Record.
*
* This macro declares and initializes an instance of an NFC NDEF record description
* for a Bluetooth Carrier Configuration LE record.
*
* @note The record descriptor is declared as automatic variable, which implies that
* the NDEF message encoding (see @ref nfc_ble_simplified_le_oob_msg_encode)
* must be done in the same variable scope.
*
* @param[in] NAME Name for accessing record descriptor.
* @param[in] PAYLOAD_ID NDEF record header Payload ID field (Limited to one byte).
* If 0, no ID is present in the record description.
* @param[in] P_BLE_ADVDATA Pointer to the encoded BLE advertising data structure. This
* data is used to create the record payload.
*/
#define NFC_NDEF_LE_OOB_RECORD_DESC_DEF(NAME, \
PAYLOAD_ID, \
P_BLE_ADVDATA) \
uint8_t NAME##_ndef_le_oob_record_id = (PAYLOAD_ID); \
uint8_t NAME##_ndef_le_oob_record_id_length = ((PAYLOAD_ID) != 0) ? 1 : 0; \
NFC_NDEF_GENERIC_RECORD_DESC_DEF( NAME, \
TNF_MEDIA_TYPE, \
&NAME##_ndef_le_oob_record_id, \
NAME##_ndef_le_oob_record_id_length, \
(le_oob_rec_type_field), \
sizeof(le_oob_rec_type_field), \
nfc_le_oob_payload_constructor, \
(P_BLE_ADVDATA)) \
/**
* @brief Macro for accessing the NFC NDEF Bluetooth Carrier Configuration LE record descriptor
* instance that was created with @ref NFC_NDEF_LE_OOB_RECORD_DESC_DEF.
*/
#define NFC_NDEF_LE_OOB_RECORD_DESC(NAME) NFC_NDEF_GENERIC_RECORD_DESC(NAME)
/** @} */
#ifdef __cplusplus
}
#endif
#endif // NFC_LE_OOB_REC_H__