wiced_bt_beacon.h File Reference

> More...

Data Structures
struct	wiced_bt_beacon_ble_advert_elem_t
struct	wiced_bt_beacon_multi_advert_data_t

Macros
#define	WICED_BT_BEACON_ADV_DATA_MAX   31
#define	EDDYSTONE_FRAME_TYPE_UID   0x00
#define	EDDYSTONE_FRAME_TYPE_URL   0x10
#define	EDDYSTONE_FRAME_TYPE_TLM   0x20
#define	EDDYSTONE_FRAME_TYPE_EID   0x30
#define	EDDYSTONE_UID_FRAME_LEN   20
#define	EDDYSTONE_UID_NAMESPACE_LEN   10
#define	EDDYSTONE_UID_INSTANCE_ID_LEN   6
#define	EDDYSTONE_URL_FRAME_LEN   20
#define	EDDYSTONE_URL_VALUE_MAX_LEN   17
#define	EDDYSTONE_TLM_UNENCRYPTED_VERSION   0
#define	EDDYSTONE_TLM_ENCRYPTED_VERSION   1
#define	EDDYSTONE_TLM_UNENCRYPTED_FRAME_LEN   14
#define	EDDYSTONE_TLM_ENCRYPTED_FRAME_LEN   18
#define	EDDYSTONE_ETLM_LEN   12
#define	EDDYSTONE_EID_FRAME_LEN   10
#define	EDDYSTONE_EID_LEN   8
#define	EDDYSTONE_UUID16   0xFEAA
#define	EDDYSTONE_ELEM_NUM   3
#define	EDDYSTONE_URL_SCHEME_0   0x00
#define	EDDYSTONE_URL_SCHEME_1   0x01
#define	EDDYSTONE_URL_SCHEME_2   0x02
#define	EDDYSTONE_URL_SCHEME_3   0x03
#define	IBEACON_TYPE   0x01
#define	IBEACON_PROXIMITY   0x02, 0x15
#define	IBEACON_COMPANY_ID_APPLE   0x4c, 0x00
#define	IBEACON_DATA_LENGTH   0x19
#define	IBEACON_ELEM_NUM   2

Functions
void	wiced_bt_eddystone_set_data_for_uid (uint8_t eddystone_ranging_data, uint8_t eddystone_namespace[EDDYSTONE_UID_NAMESPACE_LEN], uint8_t eddystone_instance[EDDYSTONE_UID_INSTANCE_ID_LEN], uint8_t adv_data[WICED_BT_BEACON_ADV_DATA_MAX], uint8_t *adv_len)
	Creates Google Eddystone UID format advertising data. More...
void	wiced_bt_eddystone_set_data_for_url (uint8_t tx_power, uint8_t urlscheme, uint8_t encoded_url[EDDYSTONE_URL_VALUE_MAX_LEN], uint8_t adv_data[WICED_BT_BEACON_ADV_DATA_MAX], uint8_t *adv_len)
	Creates Google Eddystone URL format advertising data. More...
void	wiced_bt_eddystone_set_data_for_eid (uint8_t eddystone_ranging_data, uint8_t eid[EDDYSTONE_EID_LEN], uint8_t adv_data[WICED_BT_BEACON_ADV_DATA_MAX], uint8_t *adv_len)
	Creates Google Eddystone EID format advertising data. More...
void	wiced_bt_eddystone_set_data_for_tlm_unencrypted (uint16_t vbatt, uint16_t temp, uint32_t adv_cnt, uint32_t sec_cnt, uint8_t adv_data[WICED_BT_BEACON_ADV_DATA_MAX], uint8_t *adv_len)
	Creates Google Eddystone TLM unencrypted format advertising data. More...
void	wiced_bt_eddystone_set_data_for_tlm_encrypted (uint8_t etlm[EDDYSTONE_ETLM_LEN], uint16_t salt, uint16_t mic, uint8_t adv_data[WICED_BT_BEACON_ADV_DATA_MAX], uint8_t *adv_len)
	Creates Google Eddystone TLM encrypted format advertising data. More...
void	wiced_bt_ibeacon_set_adv_data (uint8_t ibeacon_uuid[LEN_UUID_128], uint16_t ibeacon_major_number, uint16_t ibeacon_minor_number, uint8_t tx_power_lcl, uint8_t adv_data[WICED_BT_BEACON_ADV_DATA_MAX], uint8_t *adv_len)
	Creates Apple iBeacon format advertising data. More...

Detailed Description

>

The APIs to create Google Eddystone and Apple iBeacon advertisements.

To Eddystone, see specification at https://github.com/google/eddystone.

To iBeacon, see specification at https://developer.apple.com/ibeacon/.

For more usage details, refer example demo.beacon.

Copyright

(c) 2016-2025, Infineon Technologies AG, or an affiliate of Infineon Technologies AG. All rights reserved. This software, associated documentation and materials ("Software") is owned by Infineon Technologies AG or one of its affiliates ("Infineon") and is protected by and subject to worldwide patent protection, worldwide copyright laws, and international treaty provisions. Therefore, you may use this Software only as provided in the license agreement accompanying the software package from which you obtained this Software. If no license agreement applies, then any use, reproduction, modification, translation, or compilation of this Software is prohibited without the express written permission of Infineon.

Disclaimer: UNLESS OTHERWISE EXPRESSLY AGREED WITH INFINEON, THIS SOFTWARE IS PROVIDED AS-IS, WITH NO WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, ALL WARRANTIES OF NON-INFRINGEMENT OF THIRD-PARTY RIGHTS AND IMPLIED WARRANTIES SUCH AS WARRANTIES OF FITNESS FOR A SPECIFIC USE/PURPOSE OR MERCHANTABILITY. Infineon reserves the right to make changes to the Software without notice. You are responsible for properly designing, programming, and testing the functionality and safety of your intended application of the Software, as well as complying with any legal requirements related to its use. Infineon does not guarantee that the Software will be free from intrusion, data theft or loss, or other breaches ("Security Breaches"), and Infineon shall have no liability arising out of any Security Breaches. Unless otherwise explicitly approved by Infineon, the Software may not be used in any application where a failure of the Product or any consequences of the use thereof can reasonably be expected to result in personal injury.

Function Documentation

void wiced_bt_eddystone_set_data_for_eid	(	uint8_t	eddystone_ranging_data,
		uint8_t	eid[EDDYSTONE_EID_LEN],
		uint8_t	adv_data[WICED_BT_BEACON_ADV_DATA_MAX],
		uint8_t *	adv_len
	)

Creates Google Eddystone EID format advertising data.

The application calls the API to populate advertisement data for Google Eddystone EID advertisement format. It returns the adv data buffer and length.

Parameters

[in]	tx_power	Calibrated TX power, see specification for details for input parameters.
[in]	urlscheme	URL scheme
[in]	encoded_url	URL
[out]	adv_data	Buffer of advertisement data
[out]	adv_len	Length of advertisement data

Returns

None.

void wiced_bt_eddystone_set_data_for_tlm_encrypted	(	uint8_t	etlm[EDDYSTONE_ETLM_LEN],
		uint16_t	salt,
		uint16_t	mic,
		uint8_t	adv_data[WICED_BT_BEACON_ADV_DATA_MAX],
		uint8_t *	adv_len
	)

Creates Google Eddystone TLM encrypted format advertising data.

The application calls the API to populate advertisement data for Google Eddystone TLM encrypted advertisement format. It returns the adv data buffer and length.

Parameters

[in]	etlm	Encrypted TLM data, see specification for details for input parameters.
[in]	salt	16-bit Salt
[in]	mic	16 bit Message Integrity Check
[out]	adv_data	Buffer of advertisement data
[out]	adv_len	Length of advertisement data

Returns

None.

void wiced_bt_eddystone_set_data_for_tlm_unencrypted	(	uint16_t	vbatt,
		uint16_t	temp,
		uint32_t	adv_cnt,
		uint32_t	sec_cnt,
		uint8_t	adv_data[WICED_BT_BEACON_ADV_DATA_MAX],
		uint8_t *	adv_len
	)

Creates Google Eddystone TLM unencrypted format advertising data.

The application calls the API to populate advertisement data for Google Eddystone TLM unencrypted advertisement format. It returns the adv data buffer and length.

Parameters

[in]	temp	Beacon temperature, see specification for details for input parameters.
[in]	adv_cnt	Advertising PDU count
[in]	sec_cnt	Time since power-on or reboot
[out]	adv_data	Buffer of advertisement data
[out]	adv_len	Length of advertisement data

Returns

None.

void wiced_bt_eddystone_set_data_for_uid	(	uint8_t	eddystone_ranging_data,
		uint8_t	eddystone_namespace[EDDYSTONE_UID_NAMESPACE_LEN],
		uint8_t	eddystone_instance[EDDYSTONE_UID_INSTANCE_ID_LEN],
		uint8_t	adv_data[WICED_BT_BEACON_ADV_DATA_MAX],
		uint8_t *	adv_len
	)

Creates Google Eddystone UID format advertising data.

The application calls the API to populate advertisement data for Google Eddystone UID advertisement format. It returns the adv data buffer and length.

Parameters

[in]	eddystone_ranging_data	Calibrated TX power, see specification for details for input parameters.
[in]	eddystone_namespace	UID namespace
[in]	eddystone_instance	Instance
[out]	adv_data	Buffer of advertisement data
[out]	adv_len	Length of advertisement data

Returns

None.

void wiced_bt_eddystone_set_data_for_url	(	uint8_t	tx_power,
		uint8_t	urlscheme,
		uint8_t	encoded_url[EDDYSTONE_URL_VALUE_MAX_LEN],
		uint8_t	adv_data[WICED_BT_BEACON_ADV_DATA_MAX],
		uint8_t *	adv_len
	)

Creates Google Eddystone URL format advertising data.

The application calls the API to populate advertisement data for Google Eddystone URL advertisement format. It returns the adv data buffer and length.

Parameters

[in]	tx_power	Calibrated TX power, see specification for details for input parameters.
[in]	urlscheme	URL scheme
[in]	encoded_url	URL
[out]	adv_data	Buffer of advertisement data
[out]	adv_len	Length of advertisement data

Returns

None

void wiced_bt_ibeacon_set_adv_data	(	uint8_t	ibeacon_uuid[LEN_UUID_128],
		uint16_t	ibeacon_major_number,
		uint16_t	ibeacon_minor_number,
		uint8_t	tx_power_lcl,
		uint8_t	adv_data[WICED_BT_BEACON_ADV_DATA_MAX],
		uint8_t *	adv_len
	)

Creates Apple iBeacon format advertising data.

The application calls the API to populate advertisement data for Apple iBeacon advertisement format. It returns the adv data buffer and length.

Parameters

[in]	ibeacon_uuid	Customer beacon UUID, see specification for details for input parameters.
[in]	ibeacon_major_number	Beacon major number
[in]	ibeacon_minor_number	Beacon minor number
[in]	tx_power_lcl	measured power
[out]	adv_data	Buffer of advertisement data
[out]	adv_len	Length of advertisement data

Returns

None.