Atmel BLE SDK

Data Structures
struct	adv_element
	advertisement data element More...
struct	ble_custom_event_cb
struct	ble_custom_event_cb_t
	All BLE Custom event callback types. More...
struct	gatt_service_handler
	GATT service handles. More...
struct	gatt_wificon_char_handler
struct	gatt_wifiscan_char_handler
struct	wificon_gatt_service_handler
struct	wifiscan_gatt_service_handler

Macros
#define	ADV_INTERVAL_SIZE   2
#define	ALERT_LEVEL_CHAR_UUID   (0x2A06)
#define	APPEARANCE_SIZE   2
	Length of Adv data types. More...
#define	BAT_CHAR_BAT_LEVEL_UUID   (0x2A19)
	battery level characteristic uuid More...
#define	BAT_SERVICE_UUID   (0x180F)
	battery service uuid More...
#define	BLE_CHARACTERISTIC_CHANGED   wifi_provision_char_changed_handler
#define	BLE_CONN_PARAM_UPDATE_DONE   ble_conn_param_update
#define	BLE_CONNECTED_STATE_HANDLER(param)
#define	BLE_DEVICE_NAME   "MCHP_BLE"
#define	BLE_DISCONNECTED_STATE_HANDLER(param)
#define	BLE_ENCRYPTION_REQUEST   ble_encryption_request_handler
#define	BLE_ENCRYPTION_STATUS_CHANGED(param)
#define	BLE_EVENT_TIMEOUT   (0)
	default device name More...
#define	BLE_PAIR_DONE(param)
#define	BLE_PAIR_KEY_REQUEST   ble_pair_key_request_handler
#define	BLE_PAIR_REQUEST   ble_pair_request_handler
#define	BLE_PROFILE_INIT   wifi_provision_init
#define	BLE_SERVICE_CHANGED   wifi_provision_svc_changed_handler
#define	BLE_SLAVE_SEC_REQUEST   ble_slave_security_handler
#define	BODY_SENSOR_LOCATION_CHAR_UUID   (0x2A38)
	Body Sensor location characteristic uuid. More...
#define	BREDR_NOT_SUPPORTED   ((uint8_t) 1 << 2)
#define	CHAR_USER_STR_WIFICON_APPARAM   ("AP Parameters")
#define	CHAR_USER_STR_WIFICON_APPARAM_LEN   (13)
	WIFICON APPARAM NAME_LEN the length of the device name. More...
#define	CHAR_USER_STR_WIFICON_STATE   ("WiFi Connect State")
#define	CHAR_USER_STR_WIFICON_STATE_LEN   (18)
	WIFICON STATE NAME_LEN the length of the device name. More...
#define	CHAR_USER_STR_WIFISCAN_APCOUNT   ("AP Count")
#define	CHAR_USER_STR_WIFISCAN_APCOUNT_LEN   (8)
	WIFISCAN APCOUNT NAME_LEN the length of the device name. More...
#define	CHAR_USER_STR_WIFISCAN_APDETAILS   ("AP Details")
#define	CHAR_USER_STR_WIFISCAN_APDETAILS_LEN   (10)
	WIFISCAN APDETAILS NAME_LEN the length of the device name. More...
#define	CHAR_USER_STR_WIFISCAN_SCANMODE   ("WiFi Scanning Mode")
#define	CHAR_USER_STR_WIFISCAN_SCANMODE_LEN   (18)
	WIFISCAN SCANMODE NAME_LEN the length of the device name. More...
#define	CSC_ENDPOINT_CHAR_UUID   ("\x1b\xc5\xd5\xa5\x02\x00\xa6\x85\xe5\x11\x35\x39\xa1\xbb\x5a\xfd")
	CSC Endpoint Characteristic UUID. More...
#define	CSC_SERVICE_UUID   ("\x1b\xc5\xd5\xa5\x02\x00\xa6\x85\xe5\x11\x35\x39\xa0\xbb\x5a\xfd")
	CSC Service UUID. More...
#define	CURRENT_TIME_CHAR_UUID   (0x2A2B)
#define	CURRENT_TIME_SERVICE_UUID   (0x1805)
#define	DIS_CHAR_FIRMWARE_REVISION_UUID   (0x2A26)
#define	DIS_CHAR_HARDWARE_REVISION_UUID   (0x2A27)
#define	DIS_CHAR_IEEE_REG_CERT_DATA_LIST_UUID   (0x2A2A)
#define	DIS_CHAR_MANUFACTURER_NAME_UUID   (0x2A29)
#define	DIS_CHAR_MODEL_NUMBER_UUID   (0x2A24)
#define	DIS_CHAR_PNP_ID_UUID   (0x2A50)
#define	DIS_CHAR_SERIAL_NUMBER_UUID   (0x2A25)
#define	DIS_CHAR_SOFTWARE_REVISION_UUID   (0x2A28)
#define	DIS_CHAR_SYSTEM_ID_UUID   (0x2A23)
#define	DIS_SERVICE_UUID   (0x180A)
#define	FAILED_WIFICON_CHANGE_PARAM   (0xee)
#define	FAILED_WIFISCAN_CHANGE_PARAM   (0xee)
#define	HEART_RATE_CONTROL_POINT_CHAR_UUID   (0x2A39)
	Heart Rate Control Point characteristic uuid. More...
#define	HEART_RATE_MEASUREMENT_CHAR_UUID   (0x2A37)
	heart rate measurement characteristic uuid More...
#define	HEART_RATE_SERVICE_UUID   (0x180D)
#define	IMMEDIATE_ALERT_SERVICE_UUID   (0x1802)
#define	INVALID_WIFICON_CHANGE_PARAM   (0xff)
	status wifi_con of characteristics write More...
#define	INVALID_WIFISCAN_CHANGE_PARAM   (0xff)
	results of wifiscan characteristics write More...
#define	LE_BREDR_CAPABLE_CONTROLLER   ((uint8_t) 1 << 3)
#define	LE_BREDR_CAPABLE_HOST   ((uint8_t) 1 << 4)
#define	LE_GENERAL_DISCOVERABLE_MODE   ((uint8_t) 1 << 1)
#define	LE_LIMITED_DISCOVERABLE_MODE   ((uint8_t) 1 << 0)
	Observer related declarations. More...
#define	LINK_LOSS_SERVICE_UUID   (0x1803)
#define	MAX_DEVICE_CONNECTED   (1)
	maximum number of devices connected More...
#define	SPS_CHAR_SCAN_INT_VALUE_UUID   (0x2A4F)
	scan interval characteristic uuid More...
#define	SPS_CHAR_SCAN_REFRESH_UUID   (0x2A31)
	scan refresh characteristic uuid More...
#define	SPS_SERVICE_UUID   (0x1813)
	Scan param service uuid. More...
#define	TOTAL_CHARACTERISTIC_NUM   1
#define	TX_POWER_LEVEL_CHAR_UUID   (0x2A07)
#define	TX_POWER_LEVEL_SIZE   1
#define	TX_POWER_SERVICE_UUID   (0x1804)
#define	UUID_MCHP_PROPRIETARY_SERVICE_16   0x55,0xE4,0x05,0xD2,0xAF,0x9F,0xA9,0x8F,0xE5,0x4A,0x7D,0xFE,0x43,0x53,0x53,0x49
#define	UUID_MCHP_TRANS_CTRL_16   0x7e,0x3b,0x07,0xff,0x1c,0x51,0x49,0x2f,0xb3,0x39,0x8a,0x4c,0x43,0x53,0x53,0x49
#define	UUID_MCHP_TRANS_RX_16   0xB3,0x9B,0x72,0x34,0xBE,0xEC,0xD4,0xA8,0xF4,0x43,0x41,0x88,0x43,0x53,0x53,0x49
#define	UUID_MCHP_TRANS_TX_16   0x16,0x96,0x24,0x47,0xC6,0x23,0x61,0xBA,0xD9,0x4B,0x4D,0x1E,0x43,0x53,0x53,0x49
#define	VALID_WIFICON_CHANGE_PARAM   (0xdd)
#define	VALID_WIFISCAN_CHANGE_PARAM   (0xdd)
#define	WIFI_CON_APPARAM_CHAR_UUID   ("\x1b\xc5\xd5\xa5\x02\x00\x89\x86\xe4\x11\x29\xd2\x03\x00\x88\x77")
#define	WIFI_CON_SERVICE_UUID   ("\x1b\xc5\xd5\xa5\x02\x00\x89\x86\xe4\x11\x29\xd2\x01\x00\x88\x77")
	Service UUID's. More...
#define	WIFI_CON_STATE_CHAR_UUID   ("\x1b\xc5\xd5\xa5\x02\x00\x89\x86\xe4\x11\x29\xd2\x02\x00\x88\x77")
#define	WIFI_SCAN_APCOUNT_CHAR_UUID   ("\x1b\xc5\xd5\xa5\x02\x00\xa1\x85\xe4\x11\x24\xd2\x03\x00\x8c\xfb")
#define	WIFI_SCAN_APDETAILS_CHAR_UUID   ("\x1b\xc5\xd5\xa5\x02\x00\xa1\x85\xe4\x11\x24\xd2\x00\x01\x8c\xfb")
#define	WIFI_SCAN_MODE_CHAR_UUID   ("\x1b\xc5\xd5\xa5\x02\x00\xa1\x85\xe4\x11\x24\xd2\x02\x00\x8c\xfb")
#define	WIFI_SCAN_SERVICE_UUID   ("\x1b\xc5\xd5\xa5\x02\x00\xa1\x85\xe4\x11\x24\xd2\x01\x00\x8c\xfb")
#define	WIFICON_CHARACTERISTIC_COUNT   (2)
	count of characteristics in wifi_con service More...
#define	WIFICON_INCLUDED_SERVICE_COUNT   (0)
	count of included services in wifi_con service More...
#define	WIFICON_UUID_128_LEN   (16)
	WIFICON_UUID_LEN the size of WIFICON service uuid. More...
#define	WIFISCAN_BASIC_CHARACTERISTIC   (2)
	the two basic characteristics are scan mode and apcount More...
#define	WIFISCAN_CHARACTERISTIC_COUNT   (WIFISCAN_BASIC_CHARACTERISTIC+WIFI_PROVISION_MAX_AP_NUM)
	count of characteristics in wifi_scan service More...
#define	WIFISCAN_INCLUDED_SERVICE_COUNT   (0)
	count of included service in wifi_scan service More...
#define	WIFISCAN_UUID_128_LEN   (16)
	WIFISCAN_UUID_LEN the size of WIFISCAN service uuid. More...

Typedefs
typedef struct adv_element	adv_element_t
	advertisement data element More...
typedef at_ble_status_t(*	ble_characteristic_changed_callback_t )(at_ble_characteristic_changed_t *)
typedef struct ble_custom_event_cb	ble_custom_event_cb_t
typedef enum ble_device_ll_state	ble_device_ll_state_t
typedef at_ble_status_t(*	ble_event_callback_t )(void *params)
typedef void(*	ble_gap_event_callback_t )(at_ble_handle_t)
typedef struct gatt_service_handler	gatt_service_handler_t
	GATT service handles. More...
typedef struct gatt_wificon_char_handler	gatt_wificon_char_handler_t
typedef struct gatt_wifiscan_char_handler	gatt_wifiscan_char_handler_t
typedef struct wificon_gatt_service_handler	wificon_gatt_service_handler_t
typedef struct wifiscan_gatt_service_handler	wifiscan_gatt_service_handler_t

Enumerations
enum	ble_device_ll_state {   BLE_DEVICE_IDLE_STATE,   PERIPHERAL_ADVERTISING_STATE,   CENTRAL_SCANNING_STATE,   PERIPHERAL_CONNECTED_STATE,   PERIPHERAL_PAIRED_STATE,   PERIPHERAL_ENCRYPTION_STATE,   PERIPHERAL_DISCONNECTED_STATE }
enum	gap_ad_type {   FLAGS = 0x01,   INCOMPLETE_LIST_16BIT_SERV_UUIDS,   COMPLETE_LIST_16BIT_SERV_UUIDS,   INCOMPLETE_LIST_32BIT_SERV_UUIDS,   COMPLETE_LIST_32BIT_SERV_UUIDS,   INCOMPLETE_LIST_128BIT_SERV_UUIDS,   COMPLETE_LIST_128BIT_SERV_UUIDS,   SHORTENED_LOCAL_NAME,   COMPLETE_LOCAL_NAME,   TX_POWER_LEVEL,   CLASS_OF_DEVICE = 0x0D,   SIMPLE_PAIRING_HASHING,   SIMPLE_PAIRING_RANDOMIZER,   DEVICE_ID,   SECURITY_MANAGER_OOB_FLAGS,   SLAVE_CONNECTION_INTERVAL_RANGE,   LIST_16BIT_SERV_SOLICITATION_UUIDS = 0x14,   LIST_128BIT_SERV_SOLICITATION_UUIDS,   SERVICE_DATA,   PUBLIC_TARGET_ADDRESS,   RANDOM_TARGET_ADDRESS,   APPEARANCE,   ADVERTISING_INTERVAL,   LE_BLUETOOTH_DEVICE_ADDRESS,   LE_ROLE,   SIMPLE_PAIRING_HASHING_C256,   SIMPLE_PAIRING_RANDOMIZER_R256,   SERVICE_DATA_32BIT = 0x20,   SERVICE_DATA_128BIT,   LE_SECURE_CONNECTIONS_CONFIRMATION_VALUE,   LE_SECURE_CONNECTIONS_RANDOM_VALUE,   THREED_INFORMATION_DATA = 0x3D,   MANUFACTURER_SPECIFIC_DATA = 0xFF }
	Gap Advertisement Types. More...

Functions
void	ble_conn_param_update (at_ble_conn_param_update_done_t *conn_param_update)
	function used to update the connection parameter. More...
void	ble_connected_state_handler (at_ble_connected_t *conn_params)
	function called when the AT_BLE_CONNECTED event is received from the stack. More...
void	ble_device_init (at_ble_addr_t *addr)
	function sets both device address and device name which are exposed to all other devices. More...
void	ble_disconnected_state_handler (at_ble_disconnected_t *disconnect)
	function called when the AT_BLE_DISCONNECTED event is received from the stack. More...
void	ble_discovery_complete_handler (at_ble_discovery_complete_t *discover_status)
	function called when the AT_BLE_DISCOVERY_COMPLETE event is received from the stack. More...
static void	ble_dummy_handler (void *param)
void	ble_encryption_request_handler (at_ble_encryption_request_t *encry_req)
	function called when the AT_BLE_ENCRYPTION_REQUEST event is received from stack. More...
void	ble_encryption_status_change_handler (at_ble_encryption_status_changed_t *encry_status)
	function called when the AT_BLE_ENCRYPTION_STATUS_CHANGED event is received from stack. More...
void	ble_event_manager (at_ble_events_t events, void *event_params)
	function handling all the events from the stack, responsible for calling the respective functions initialized for the events. More...
at_ble_status_t	ble_event_task (void)
	function to handle the BLE event task. More...
at_ble_status_t	ble_pair_done_handler (at_ble_pair_done_t *pairing_params)
	function called when the AT_BLE_PAIR_DONE event is received from stack. More...
void	ble_pair_key_request_handler (at_ble_pair_key_request_t *pair_key)
	function called when the AT_BLE_PAIR_KEY_REQUEST event is received from stack. More...
void	ble_pair_request_handler (at_ble_pair_request_t *at_ble_pair_req)
	function called when the AT_BLE_PAIR_REQUEST event is received from stack. More...
at_ble_status_t	ble_send_slave_sec_request (at_ble_handle_t conn_handle)
	function to send slave security request. More...
at_ble_status_t	ble_set_device_name (uint8_t *name, uint8_t name_len)
	function to set the device name. More...
void	ble_slave_security_handler (at_ble_slave_sec_request_t *slave_sec_req)
	slave security handler More...
static at_ble_status_t	BLE_UNUSED2_VAR (void *param1_var, void *param2_var)
void	init_wifi_con_service (wificon_gatt_service_handler_t *wificon_handle)
	Initialize the wifi_con service with default values. More...
void	init_wifi_scan_service (wifiscan_gatt_service_handler_t *wifiscan_handle)
	Initialize the wifi_scan service with default values. More...
void	register_ble_characteristic_changed_cb (ble_characteristic_changed_callback_t char_changed_cb_fn)
	Register callback function, to be triggered when characteristic value is changed. More...
void	register_ble_connected_event_cb (ble_gap_event_callback_t connected_cb_fn)
	Register callback function, to be triggered when connected to the device. More...
void	register_ble_disconnected_event_cb (ble_gap_event_callback_t disconnected_cb_fn)
	Register callback function, to be triggered when disconnected from the peer device. More...
void	register_ble_paired_event_cb (ble_gap_event_callback_t paired_cb_fn)
	Register callback function, to be triggered when pairing procedure is completed. More...
uint8_t	wificon_char_change_apparam (at_ble_characteristic_changed_t *param, wificon_gatt_service_handler_t *wificon_handle)
	wificon service apparam characteristics change More...
uint8_t	wificon_char_change_state_client_cfg (at_ble_characteristic_changed_t *param, wificon_gatt_service_handler_t *wificon_handle)
	wificon service state characteristics client config change More...
at_ble_status_t	wificon_connect_noti (wificon_gatt_service_handler_t *wificon_handler, uint8_t s)
	notification on the wifi connecting progress More...
at_ble_status_t	wificon_primary_service_define (wificon_gatt_service_handler_t *wificon_primary_service)
	Defining the wifi_con service to the attribute data base. More...
uint8_t	wifiscan_char_change_scanmode (at_ble_characteristic_changed_t *p, wifiscan_gatt_service_handler_t *wifiscan_handle)
	wifiscan service scan mode characteristics change More...
at_ble_status_t	wifiscan_primary_service_define (wifiscan_gatt_service_handler_t *wifiscan_primary_service)
	Defining the wifi_scan service to the attribute data base. More...
void	wifiscan_print_char (wifiscan_gatt_service_handler_t *wifiscan_handler)
	utility function to retrieve and print out characteristics (scanmode and ap_num) More...
at_ble_status_t	wifiscan_scanlist_receive (wifiscan_gatt_service_handler_t *wifiscan_serv, wifi_provision_scanlist *param, uint8_t *num_ap_found)
	update wifiscan scan list More...
at_ble_status_t	wifiscan_update_scanmode_char_value (wifiscan_gatt_service_handler_t *wifiscan_serv, uint8_t char_data)
	update wifiscan scan mode More...

#define ADV_INTERVAL_SIZE   2

#define ALERT_LEVEL_CHAR_UUID   (0x2A06)

#define APPEARANCE_SIZE   2

Length of Adv data types.

#define BAT_CHAR_BAT_LEVEL_UUID   (0x2A19)

battery level characteristic uuid

#define BAT_SERVICE_UUID   (0x180F)

battery service uuid

#define BLE_CHARACTERISTIC_CHANGED   wifi_provision_char_changed_handler

Referenced by ble_event_manager().

#define BLE_CONN_PARAM_UPDATE_DONE   ble_conn_param_update

Referenced by ble_event_manager().

#define BLE_CONNECTED_STATE_HANDLER

(

param

)

Value:

ble_connected_state_handler(param);\
                                                    BLE_ADDITIONAL_CONNECTED_STATE_HANDLER(param);

Referenced by ble_event_manager().

#define BLE_DEVICE_NAME   "MCHP_BLE"

Referenced by ble_device_init().

#define BLE_DISCONNECTED_STATE_HANDLER

(

param

)

Value:

ble_disconnected_state_handler(param);\
                                                    BLE_ADDITIONAL_DISCONNECTED_STATE_HANDLER(param);

Referenced by ble_event_manager().

#define BLE_ENCRYPTION_REQUEST   ble_encryption_request_handler

Referenced by ble_event_manager().

#define BLE_ENCRYPTION_STATUS_CHANGED

(

param

)

Value:

ble_encryption_status_change_handler(param);\
                                                    BLE_ADDITIONAL_ENCRYPTION_CHANGED_HANDLER(param);

Referenced by ble_event_manager().

#define BLE_EVENT_TIMEOUT   (0)

default device name

event timeout

Referenced by ble_event_task().

#define BLE_PAIR_DONE

(

param

)

Value:

ble_pair_done_handler(param);\
                                                    BLE_ADDITIONAL_PAIR_DONE_HANDLER(param);

Referenced by ble_event_manager().

#define BLE_PAIR_KEY_REQUEST   ble_pair_key_request_handler

Referenced by ble_event_manager().

#define BLE_PAIR_REQUEST   ble_pair_request_handler

Referenced by ble_event_manager().

#define BLE_PROFILE_INIT   wifi_provision_init

Referenced by ble_device_init().

#define BLE_SERVICE_CHANGED   wifi_provision_svc_changed_handler

Referenced by ble_event_manager().

#define BLE_SLAVE_SEC_REQUEST   ble_slave_security_handler

Referenced by ble_event_manager().

#define BODY_SENSOR_LOCATION_CHAR_UUID   (0x2A38)

Body Sensor location characteristic uuid.

#define BREDR_NOT_SUPPORTED   ((uint8_t) 1 << 2)

#define CHAR_USER_STR_WIFICON_APPARAM   ("AP Parameters")

Referenced by init_wifi_con_service().

#define CHAR_USER_STR_WIFICON_APPARAM_LEN   (13)

WIFICON APPARAM NAME_LEN the length of the device name.

Referenced by init_wifi_con_service().

#define CHAR_USER_STR_WIFICON_STATE   ("WiFi Connect State")

Referenced by init_wifi_con_service().

#define CHAR_USER_STR_WIFICON_STATE_LEN   (18)

WIFICON STATE NAME_LEN the length of the device name.

Referenced by init_wifi_con_service().

#define CHAR_USER_STR_WIFISCAN_APCOUNT   ("AP Count")

#define CHAR_USER_STR_WIFISCAN_APCOUNT_LEN   (8)

WIFISCAN APCOUNT NAME_LEN the length of the device name.

#define CHAR_USER_STR_WIFISCAN_APDETAILS   ("AP Details")

Referenced by init_wifi_scan_service().

#define CHAR_USER_STR_WIFISCAN_APDETAILS_LEN   (10)

WIFISCAN APDETAILS NAME_LEN the length of the device name.

Referenced by init_wifi_scan_service().

#define CHAR_USER_STR_WIFISCAN_SCANMODE   ("WiFi Scanning Mode")

Referenced by init_wifi_scan_service().

#define CHAR_USER_STR_WIFISCAN_SCANMODE_LEN   (18)

WIFISCAN SCANMODE NAME_LEN the length of the device name.

Referenced by init_wifi_scan_service().

#define CSC_ENDPOINT_CHAR_UUID   ("\x1b\xc5\xd5\xa5\x02\x00\xa6\x85\xe5\x11\x35\x39\xa1\xbb\x5a\xfd")

CSC Endpoint Characteristic UUID.

#define CSC_SERVICE_UUID   ("\x1b\xc5\xd5\xa5\x02\x00\xa6\x85\xe5\x11\x35\x39\xa0\xbb\x5a\xfd")

CSC Service UUID.

#define CURRENT_TIME_CHAR_UUID   (0x2A2B)

#define CURRENT_TIME_SERVICE_UUID   (0x1805)

#define DIS_CHAR_FIRMWARE_REVISION_UUID   (0x2A26)

#define DIS_CHAR_HARDWARE_REVISION_UUID   (0x2A27)

#define DIS_CHAR_IEEE_REG_CERT_DATA_LIST_UUID   (0x2A2A)

#define DIS_CHAR_MANUFACTURER_NAME_UUID   (0x2A29)

#define DIS_CHAR_MODEL_NUMBER_UUID   (0x2A24)

#define DIS_CHAR_PNP_ID_UUID   (0x2A50)

#define DIS_CHAR_SERIAL_NUMBER_UUID   (0x2A25)

#define DIS_CHAR_SOFTWARE_REVISION_UUID   (0x2A28)

#define DIS_CHAR_SYSTEM_ID_UUID   (0x2A23)

#define DIS_SERVICE_UUID   (0x180A)

#define FAILED_WIFICON_CHANGE_PARAM   (0xee)

Referenced by wifi_provision_char_changed_handler(), wificon_char_change_apparam(), and wificon_char_change_state_client_cfg().

#define FAILED_WIFISCAN_CHANGE_PARAM   (0xee)

Referenced by wifi_provision_char_changed_handler(), and wifiscan_char_change_scanmode().

#define HEART_RATE_CONTROL_POINT_CHAR_UUID   (0x2A39)

Heart Rate Control Point characteristic uuid.

#define HEART_RATE_MEASUREMENT_CHAR_UUID   (0x2A37)

heart rate measurement characteristic uuid

#define HEART_RATE_SERVICE_UUID   (0x180D)

#define IMMEDIATE_ALERT_SERVICE_UUID   (0x1802)

#define INVALID_WIFICON_CHANGE_PARAM   (0xff)

status wifi_con of characteristics write

Referenced by wifi_provision_char_changed_handler(), wificon_char_change_apparam(), and wificon_char_change_state_client_cfg().

#define INVALID_WIFISCAN_CHANGE_PARAM   (0xff)

results of wifiscan characteristics write

Referenced by wifiscan_char_change_scanmode().

#define LE_BREDR_CAPABLE_CONTROLLER   ((uint8_t) 1 << 3)

#define LE_BREDR_CAPABLE_HOST   ((uint8_t) 1 << 4)

#define LE_GENERAL_DISCOVERABLE_MODE   ((uint8_t) 1 << 1)

#define LE_LIMITED_DISCOVERABLE_MODE   ((uint8_t) 1 << 0)

Observer related declarations.

#define LINK_LOSS_SERVICE_UUID   (0x1803)

#define MAX_DEVICE_CONNECTED   (1)

maximum number of devices connected

#define SPS_CHAR_SCAN_INT_VALUE_UUID   (0x2A4F)

scan interval characteristic uuid

#define SPS_CHAR_SCAN_REFRESH_UUID   (0x2A31)

scan refresh characteristic uuid

#define SPS_SERVICE_UUID   (0x1813)

Scan param service uuid.

#define TOTAL_CHARACTERISTIC_NUM   1

#define TX_POWER_LEVEL_CHAR_UUID   (0x2A07)

#define TX_POWER_LEVEL_SIZE   1

#define TX_POWER_SERVICE_UUID   (0x1804)

#define UUID_MCHP_PROPRIETARY_SERVICE_16   0x55,0xE4,0x05,0xD2,0xAF,0x9F,0xA9,0x8F,0xE5,0x4A,0x7D,0xFE,0x43,0x53,0x53,0x49

#define UUID_MCHP_TRANS_CTRL_16   0x7e,0x3b,0x07,0xff,0x1c,0x51,0x49,0x2f,0xb3,0x39,0x8a,0x4c,0x43,0x53,0x53,0x49

#define UUID_MCHP_TRANS_RX_16   0xB3,0x9B,0x72,0x34,0xBE,0xEC,0xD4,0xA8,0xF4,0x43,0x41,0x88,0x43,0x53,0x53,0x49

#define UUID_MCHP_TRANS_TX_16   0x16,0x96,0x24,0x47,0xC6,0x23,0x61,0xBA,0xD9,0x4B,0x4D,0x1E,0x43,0x53,0x53,0x49

#define VALID_WIFICON_CHANGE_PARAM   (0xdd)

Referenced by wifi_provision_char_changed_handler(), wificon_char_change_apparam(), and wificon_char_change_state_client_cfg().

#define VALID_WIFISCAN_CHANGE_PARAM   (0xdd)

Referenced by wifi_provision_char_changed_handler(), and wifiscan_char_change_scanmode().

#define WIFI_CON_APPARAM_CHAR_UUID   ("\x1b\xc5\xd5\xa5\x02\x00\x89\x86\xe4\x11\x29\xd2\x03\x00\x88\x77")

Referenced by init_wifi_con_service().

#define WIFI_CON_SERVICE_UUID   ("\x1b\xc5\xd5\xa5\x02\x00\x89\x86\xe4\x11\x29\xd2\x01\x00\x88\x77")

Service UUID's.

Referenced by init_wifi_con_service(), and prepare_advertisement().

#define WIFI_CON_STATE_CHAR_UUID   ("\x1b\xc5\xd5\xa5\x02\x00\x89\x86\xe4\x11\x29\xd2\x02\x00\x88\x77")

Referenced by init_wifi_con_service().

#define WIFI_SCAN_APCOUNT_CHAR_UUID   ("\x1b\xc5\xd5\xa5\x02\x00\xa1\x85\xe4\x11\x24\xd2\x03\x00\x8c\xfb")

Referenced by init_wifi_scan_service().

#define WIFI_SCAN_APDETAILS_CHAR_UUID   ("\x1b\xc5\xd5\xa5\x02\x00\xa1\x85\xe4\x11\x24\xd2\x00\x01\x8c\xfb")

Referenced by init_wifi_scan_service().

#define WIFI_SCAN_MODE_CHAR_UUID   ("\x1b\xc5\xd5\xa5\x02\x00\xa1\x85\xe4\x11\x24\xd2\x02\x00\x8c\xfb")

Referenced by init_wifi_scan_service().

#define WIFI_SCAN_SERVICE_UUID   ("\x1b\xc5\xd5\xa5\x02\x00\xa1\x85\xe4\x11\x24\xd2\x01\x00\x8c\xfb")

Referenced by init_wifi_scan_service().

#define WIFICON_CHARACTERISTIC_COUNT   (2)

count of characteristics in wifi_con service

Referenced by wificon_primary_service_define().

#define WIFICON_INCLUDED_SERVICE_COUNT   (0)

count of included services in wifi_con service

Referenced by wificon_primary_service_define().

#define WIFICON_UUID_128_LEN   (16)

WIFICON_UUID_LEN the size of WIFICON service uuid.

Referenced by init_wifi_con_service(), and prepare_advertisement().

#define WIFISCAN_BASIC_CHARACTERISTIC   (2)

the two basic characteristics are scan mode and apcount

Referenced by init_wifi_scan_service(), and wifiscan_scanlist_receive().

#define WIFISCAN_CHARACTERISTIC_COUNT   (WIFISCAN_BASIC_CHARACTERISTIC+WIFI_PROVISION_MAX_AP_NUM)

count of characteristics in wifi_scan service

Referenced by init_wifi_scan_service(), and wifiscan_primary_service_define().

#define WIFISCAN_INCLUDED_SERVICE_COUNT   (0)

count of included service in wifi_scan service

Referenced by wifiscan_primary_service_define().

#define WIFISCAN_UUID_128_LEN   (16)

WIFISCAN_UUID_LEN the size of WIFISCAN service uuid.

Referenced by init_wifi_scan_service().

typedef struct adv_element adv_element_t

advertisement data element

typedef at_ble_status_t(* ble_characteristic_changed_callback_t)(at_ble_characteristic_changed_t *)

typedef struct ble_custom_event_cb ble_custom_event_cb_t

typedef enum ble_device_ll_state ble_device_ll_state_t

typedef at_ble_status_t(* ble_event_callback_t)(void *params)

typedef void(* ble_gap_event_callback_t)(at_ble_handle_t)

typedef struct gatt_service_handler gatt_service_handler_t

GATT service handles.

typedef struct gatt_wificon_char_handler gatt_wificon_char_handler_t

typedef struct gatt_wifiscan_char_handler gatt_wifiscan_char_handler_t

typedef struct wificon_gatt_service_handler wificon_gatt_service_handler_t

typedef struct wifiscan_gatt_service_handler wifiscan_gatt_service_handler_t

enum ble_device_ll_state

Enumerator
BLE_DEVICE_IDLE_STATE	Device is in idle state.
PERIPHERAL_ADVERTISING_STATE	Peripheral state in advertisement.
CENTRAL_SCANNING_STATE	Central in scanning state.
PERIPHERAL_CONNECTED_STATE	Device stopped advertisement/scanning and Connection established.
PERIPHERAL_PAIRED_STATE	Device paired with peer device.
PERIPHERAL_ENCRYPTION_STATE	Device GAP state in Encryption state.
PERIPHERAL_DISCONNECTED_STATE	Device disconnected from peer device.

enum gap_ad_type

Gap Advertisement Types.

Enumerator
FLAGS	flags
INCOMPLETE_LIST_16BIT_SERV_UUIDS	incomplete list of 16bits service uuids
COMPLETE_LIST_16BIT_SERV_UUIDS	complete list of 16bits service uuids
INCOMPLETE_LIST_32BIT_SERV_UUIDS	incomplete list of 32bits service uuids
COMPLETE_LIST_32BIT_SERV_UUIDS	complete list of 32bits service uuids
INCOMPLETE_LIST_128BIT_SERV_UUIDS	incomplete list of 128bits service uuids
COMPLETE_LIST_128BIT_SERV_UUIDS	complete list of 128bits of service uuids
SHORTENED_LOCAL_NAME	shortened local name of the device
COMPLETE_LOCAL_NAME	complete local name of the device
TX_POWER_LEVEL	TX power level.
CLASS_OF_DEVICE	class of the device
SIMPLE_PAIRING_HASHING	simple pairing hashing
SIMPLE_PAIRING_RANDOMIZER	simple pairing randomizer
DEVICE_ID	device id
SECURITY_MANAGER_OOB_FLAGS	security manager out of band flags
SLAVE_CONNECTION_INTERVAL_RANGE	slave connection interval range
LIST_16BIT_SERV_SOLICITATION_UUIDS	list of 16bits service solicitation uuid
LIST_128BIT_SERV_SOLICITATION_UUIDS	list of 128bits service solicitation uuids
SERVICE_DATA	service data
PUBLIC_TARGET_ADDRESS	public target address
RANDOM_TARGET_ADDRESS	random target address
APPEARANCE	appearance
ADVERTISING_INTERVAL	advertising interval
LE_BLUETOOTH_DEVICE_ADDRESS	le bluetooth device address
LE_ROLE	le role
SIMPLE_PAIRING_HASHING_C256	simple pairing hashing c256
SIMPLE_PAIRING_RANDOMIZER_R256	simple pairing randomizer r256
SERVICE_DATA_32BIT	service data 32bits
SERVICE_DATA_128BIT	service data 128bits
LE_SECURE_CONNECTIONS_CONFIRMATION_VALUE	le secure connection confirmation value
LE_SECURE_CONNECTIONS_RANDOM_VALUE	le secure connection random value
THREED_INFORMATION_DATA	threed information data
MANUFACTURER_SPECIFIC_DATA	manufacturer specific data

void ble_conn_param_update

(

at_ble_conn_param_update_done_t *

conn_param_update

)

function used to update the connection parameter.

Parameters

[in]

conn_param_update

at_ble_conn_param_update_done_t parameters to be updated.

Returns

none.

function used to update the connection parameter.

References at_ble_conn_param_update_done_t::con_intv, at_ble_conn_param_update_done_t::con_latency, DBG_LOG, and at_ble_conn_param_update_done_t::superv_to.

void ble_connected_state_handler

(

at_ble_connected_t *

conn_params

)

function called when the AT_BLE_CONNECTED event is received from the stack.

Parameters

[in]

conn_params

connection parameters at_ble_connected_t.

Returns

none.

function called when the AT_BLE_CONNECTED event is received from the stack.

References at_ble_addr_t::addr, AT_BLE_SUCCESS, ble_connected_cb, ble_send_slave_sec_request(), at_ble_connected_t::conn_status, DBG_LOG, at_ble_connected_t::handle, NULL, and at_ble_connected_t::peer_addr.

void ble_device_init

(

at_ble_addr_t *

addr

)

function sets both device address and device name which are exposed to all other devices.

Parameters

[in]

addr

address to be set as a device address.

Returns

none.

function sets both device address and device name which are exposed to all other devices.

References AT_BLE_SUCCESS, BLE_DEVICE_NAME, ble_init(), BLE_PROFILE_INIT, ble_set_device_name(), DBG_LOG, and NULL.

Referenced by app_ble_wifi_provisioning().

void ble_disconnected_state_handler

(

at_ble_disconnected_t *

disconnect

)

function called when the AT_BLE_DISCONNECTED event is received from the stack.

Parameters

[in]

disconnect

at_ble_disconnected_t information about the disconnection.

Returns

none.

function called when the AT_BLE_DISCONNECTED event is received from the stack.

References ble_disconnected_cb, DBG_LOG, at_ble_disconnected_t::handle, NULL, and at_ble_disconnected_t::reason.

void ble_discovery_complete_handler

(

at_ble_discovery_complete_t *

discover_status

)

function called when the AT_BLE_DISCOVERY_COMPLETE event is received from the stack.

Parameters

[in]

discover_status

status of the discovery.

Returns

none.

static void ble_dummy_handler ( void *  param )

inlinestatic

References DBG_LOG_DEV, and UNUSED.

void ble_encryption_request_handler

(

at_ble_encryption_request_t *

encry_req

)

function called when the AT_BLE_ENCRYPTION_REQUEST event is received from stack.

Parameters

[in]

encry_req

encryption request from the peer device.

Returns

none.

function called when the AT_BLE_ENCRYPTION_REQUEST event is received from stack.

References at_ble_encryption_request_reply(), auth_info, at_ble_LTK_t::ediv, at_ble_encryption_request_t::ediv, at_ble_connected_t::handle, at_ble_LTK_t::nb, and at_ble_encryption_request_t::nb.

void ble_encryption_status_change_handler

(

at_ble_encryption_status_changed_t *

encry_status

)

function called when the AT_BLE_ENCRYPTION_STATUS_CHANGED event is received from stack.

Parameters

[in]

encry_status

changed encryption status.

Returns

none.

function called when the AT_BLE_ENCRYPTION_STATUS_CHANGED event is received from stack.

References AT_BLE_SUCCESS, ble_paired_cb, DBG_LOG, at_ble_connected_t::handle, at_ble_encryption_status_changed_t::handle, NULL, and at_ble_encryption_status_changed_t::status.

void ble_event_manager	(	at_ble_events_t	events,
		void *	event_params
	)

function handling all the events from the stack, responsible for calling the respective functions initialized for the events.

Parameters

[in]	events	events received from the stack at_ble_events_t.
[in]	event_params	data received from stack for the respective event received.

Returns

none.

Undefined event received

Scan info needs to be delivered either adv data or scan response data.
Refer to at_ble_scan_info_t

Scan report received at the end of scan period if AT_BLE_SCAN_GEN_DISCOVERY or AT_BLE_SCAN_LIM_DISCOVERY are used.
Refer to at_ble_scan_report_t

Used random address.
Refer to at_ble_rand_addr_changed_t

connected to a peer device.
Refer to at_ble_connected_t

peer device connection terminated.
Refer to at_ble_disconnected_t

connection parameters updated. It is required to call at_ble_conn_update_reply function to send response back if needed.
Refer to at_ble_conn_param_update_done_t

peer device asks for connection parameters update.
Refer to at_ble_conn_param_update_request_t

reported RX power value.
Refer to at_ble_rx_power_value_t

Pairing procedure is completed.
Refer to at_ble_pair_done_t

A central device asks for Pairing.
Refer to at_ble_pair_request_t

Slave security request.
Refer to at_ble_slave_sec_request_t

A passkey or OOB data is requested as part of pairing procedure.
Refer to at_ble_pair_key_request_t

Encryption is requested by a master device.
Refer to at_ble_encryption_request_t

Encryption status changed.
Refer to at_ble_encryption_status_changed_t

Resolve random address status.
Refer to at_ble_resolv_rand_addr_status_t

A primary service is found.
Refer to at_ble_primary_service_found_t

An included service is found .
Refer to at_ble_included_service_found_t

A Characteristic is found.
Refer to at_ble_characteristic_found_t

A descriptor is found.
Refer to at_ble_descriptor_found_t

A discover operation has completed.
Refer to at_ble_discovery_complete_t

Characteristic read procedure is done.
Refer to at_ble_characteristic_read_response_t

Characteristic multiple read procedure is done.
Refer to at_ble_characteristic_read_response_t

Characteristic write procedure is done.
Refer to at_ble_characteristic_write_response_t

A Notification is received.
Refer to at_ble_notification_received_t

An Indication is received.
Refer to at_ble_indication_received_t

The peer confirmed that it has received an Indication.
Refer to at_ble_indication_confirmed_t

The peer has changed a characteristic value.
Refer to at_ble_characteristic_changed_t

The peer has confirmed that it has received the service changed notification.
Refer to at_ble_service_changed_notification_confirmed_t

The peer asks for a write Authorization.
Refer to at_ble_write_authorize_request_t

The peer asks for a read Authorization.
Refer to at_ble_read_authorize_request_t

An L2CAP packet received from a registered custom CID.
Refer to at_ble_l2cap_rx_t

A user-defined event is delivered to the system

References AT_BLE_CHARACTERISTIC_CHANGED, AT_BLE_CHARACTERISTIC_FOUND, AT_BLE_CHARACTERISTIC_READ_MULTIBLE_RESPONSE, AT_BLE_CHARACTERISTIC_READ_RESPONSE, AT_BLE_CHARACTERISTIC_WRITE_RESPONSE, AT_BLE_CONN_PARAM_UPDATE_DONE, AT_BLE_CONN_PARAM_UPDATE_REQUEST, AT_BLE_CONNECTED, AT_BLE_CUSTOM_EVENT, AT_BLE_DESCRIPTOR_FOUND, AT_BLE_DISCONNECTED, AT_BLE_DISCOVERY_COMPLETE, AT_BLE_ENCRYPTION_REQUEST, AT_BLE_ENCRYPTION_STATUS_CHANGED, AT_BLE_INCLUDED_SERVICE_FOUND, AT_BLE_INDICATION_CONFIRMED, AT_BLE_INDICATION_RECEIVED, AT_BLE_L2CAP_RX, AT_BLE_NOTIFICATION_RECEIVED, AT_BLE_PAIR_DONE, AT_BLE_PAIR_KEY_REQUEST, AT_BLE_PAIR_REQUEST, AT_BLE_PRIMARY_SERVICE_FOUND, AT_BLE_RAND_ADDR_CHANGED, AT_BLE_READ_AUTHORIZE_REQUEST, AT_BLE_RESOLV_RAND_ADDR_STATUS, AT_BLE_RX_POWER_VALUE, AT_BLE_SCAN_INFO, AT_BLE_SCAN_REPORT, AT_BLE_SERVICE_CHANGED_NOTIFICATION_CONFIRMED, AT_BLE_SLAVE_SEC_REQUEST, AT_BLE_UNDEFINED_EVENT, AT_BLE_WRITE_AUTHORIZE_REQUEST, ble_char_changed_cb, BLE_CHARACTERISTIC_CHANGED, BLE_CONN_PARAM_UPDATE_DONE, BLE_CONNECTED_STATE_HANDLER, BLE_DISCONNECTED_STATE_HANDLER, BLE_ENCRYPTION_REQUEST, BLE_ENCRYPTION_STATUS_CHANGED, BLE_PAIR_DONE, BLE_PAIR_KEY_REQUEST, BLE_PAIR_REQUEST, BLE_SERVICE_CHANGED, BLE_SLAVE_SEC_REQUEST, DBG_LOG_DEV, and NULL.

Referenced by app_ble_wifi_provisioning(), and ble_event_task().

at_ble_status_t ble_event_task

(

void

)

function to handle the BLE event task.

Returns

AT_BLE_SUCCESS operation completed successfully

AT_BLE_FAILURE Generic error.

function to handle the BLE event task.

function to get event from stack

References at_ble_event_get(), AT_BLE_FAILURE, AT_BLE_SUCCESS, ble_event_manager(), BLE_EVENT_TIMEOUT, and params.

at_ble_status_t ble_pair_done_handler

(

at_ble_pair_done_t *

pairing_params

)

function called when the AT_BLE_PAIR_DONE event is received from stack.

Parameters

[in]

pairing_params

at_ble_pair_done_t pair done information.

Returns

AT_BLE_SUCCESS operation completed successfully.

AT_BLE_FAILURE Generic error.

function called when the AT_BLE_PAIR_DONE event is received from stack.

References app_device_bond, at_ble_disconnect(), AT_BLE_SUCCESS, AT_BLE_TERMINATED_BY_USER, at_ble_pair_done_t::auth, auth_info, ble_paired_cb, DBG_LOG, at_ble_connected_t::handle, at_ble_pair_done_t::handle, NULL, and at_ble_pair_done_t::status.

void ble_pair_key_request_handler

(

at_ble_pair_key_request_t *

pair_key

)

function called when the AT_BLE_PAIR_KEY_REQUEST event is received from stack.

Parameters

[in]

pair_key

at_ble_pair_key_request_t key details for the pairing request.

Returns

none.

function called when the AT_BLE_PAIR_KEY_REQUEST event is received from stack.

References at_ble_disconnect(), AT_BLE_FAILURE, at_ble_pair_key_reply(), AT_BLE_PAIR_PASSKEY, AT_BLE_PAIR_PASSKEY_DISPLAY, AT_BLE_PAIR_PASSKEY_ENTRY, AT_BLE_PASSKEY_LEN, AT_BLE_SUCCESS, AT_BLE_TERMINATED_BY_USER, DBG_LOG, DBG_LOG_CONT, DBG_LOG_DEV, at_ble_pair_key_request_t::handle, at_ble_pair_key_request_t::passkey_type, and at_ble_pair_key_request_t::type.

void ble_pair_request_handler

(

at_ble_pair_request_t *

at_ble_pair_req

)

function called when the AT_BLE_PAIR_REQUEST event is received from stack.

Parameters

[in]

at_ble_pair_req

at_ble_pair_request_t details for the pairing request from the peer.

Returns

none.

function called when the AT_BLE_PAIR_REQUEST event is received from stack.

References app_device_bond, at_ble_authenticate(), AT_BLE_IO_CAP_DISPLAY_ONLY, AT_BLE_KEY_DIST_ENC, AT_BLE_MODE1_L3_AUTH_PAIR_ENC, AT_BLE_SUCCESS, at_ble_pair_features_t::bond, DBG_LOG, at_ble_pair_features_t::desired_auth, at_ble_LTK_t::ediv, at_ble_connected_t::handle, at_ble_pair_features_t::initiator_keys, at_ble_pair_features_t::io_capabilities, at_ble_LTK_t::key, at_ble_LTK_t::key_size, at_ble_pair_features_t::max_key_size, at_ble_pair_features_t::min_key_size, at_ble_pair_features_t::mitm_protection, at_ble_LTK_t::nb, NULL, at_ble_pair_features_t::oob_available, and at_ble_pair_features_t::responder_keys.

at_ble_status_t ble_send_slave_sec_request

(

at_ble_handle_t

conn_handle

)

function to send slave security request.

Parameters

[in]

conn_handle

connection handle.

Returns

AT_BLE_SUCCESS operation completed successfully

AT_BLE_FAILURE Generic error.

function to send slave security request.

References AT_BLE_FAILURE, at_ble_send_slave_sec_request(), AT_BLE_SUCCESS, DBG_LOG, and DBG_LOG_DEV.

Referenced by ble_connected_state_handler().

at_ble_status_t ble_set_device_name	(	uint8_t *	name,
		uint8_t	name_len
	)

function to set the device name.

Parameters

[in]	name	name of the device.
[in]	name_len	length of the device name.

Returns

AT_BLE_SUCCESS operation completed successfully.

AT_BLE_FAILURE Generic error.

function to set the device name.

References at_ble_device_name_set(), AT_BLE_INVALID_PARAM, and NULL.

Referenced by ble_device_init().

void ble_slave_security_handler

(

at_ble_slave_sec_request_t *

slave_sec_req

)

slave security handler

References app_device_bond, at_ble_authenticate(), AT_BLE_IO_CAP_KB_DISPLAY, AT_BLE_KEY_DIST_ENC, AT_BLE_SUCCESS, at_ble_pair_features_t::bond, at_ble_slave_sec_request_t::bond, DBG_LOG, DBG_LOG_DEV, at_ble_pair_features_t::desired_auth, at_ble_LTK_t::ediv, at_ble_slave_sec_request_t::handle, at_ble_pair_features_t::initiator_keys, at_ble_pair_features_t::io_capabilities, at_ble_LTK_t::key, at_ble_LTK_t::key_size, at_ble_pair_features_t::max_key_size, at_ble_pair_features_t::min_key_size, at_ble_pair_features_t::mitm_protection, at_ble_slave_sec_request_t::mitm_protection, at_ble_LTK_t::nb, NULL, at_ble_pair_features_t::oob_available, and at_ble_pair_features_t::responder_keys.

static at_ble_status_t BLE_UNUSED2_VAR ( void *  param1_var, void *  param2_var  )

inlinestatic

References AT_BLE_SUCCESS, DBG_LOG_DEV, and UNUSED.

void init_wifi_con_service

(

wificon_gatt_service_handler_t *

wificon_handle

)

Initialize the wifi_con service with default values.

Parameters

[in]

wificon_handle

the service info which has handle (range,uuid and characteristic array fields)

Precondition

Must be called before wificon_primary_service_define

Returns

void

Initialize the wifi_con service with default values.

References APPARAM_MAX_LEN, AT_BLE_ATTR_READABLE_NO_AUTHN_NO_AUTHR, AT_BLE_ATTR_WRITABLE_NO_AUTHN_NO_AUTHR, AT_BLE_CHAR_INDICATE, AT_BLE_CHAR_NOTIFY, AT_BLE_CHAR_READ, AT_BLE_CHAR_WRITE, AT_BLE_UUID_128, CHAR_USER_STR_WIFICON_APPARAM, CHAR_USER_STR_WIFICON_APPARAM_LEN, CHAR_USER_STR_WIFICON_STATE, CHAR_USER_STR_WIFICON_STATE_LEN, at_ble_characteristic_t::char_val_handle, at_ble_characteristic_t::client_config_handle, at_ble_characteristic_t::client_config_permissions, init_ap_param, init_connect_state, at_ble_characteristic_t::init_value, at_ble_characteristic_t::presentation_format, at_ble_characteristic_t::properties, wificon_gatt_service_handler::serv_chars, wificon_gatt_service_handler::serv_handle, wificon_gatt_service_handler::serv_uuid, at_ble_characteristic_t::server_config_handle, at_ble_uuid_t::type, at_ble_characteristic_t::user_desc, at_ble_characteristic_t::user_desc_handle, at_ble_characteristic_t::user_desc_len, at_ble_characteristic_t::user_desc_max_len, at_ble_uuid_t::uuid, at_ble_characteristic_t::uuid, at_ble_characteristic_t::value_init_len, at_ble_characteristic_t::value_max_len, at_ble_characteristic_t::value_permissions, WIFI_CON_APPARAM_CHAR_UUID, WIFI_CON_SERVICE_UUID, WIFI_CON_STATE_CHAR_UUID, wificon_char_pres_fmt_struct, wificon_char_pres_fmt_uint8, and WIFICON_UUID_128_LEN.

Referenced by wifi_provision_service_init().

void init_wifi_scan_service

(

wifiscan_gatt_service_handler_t *

wifiscan_handle

)

Initialize the wifi_scan service with default values.

Parameters

[in]

wifiscan_handle

the service info which has handle range,uuid and characteristic array fields

Precondition

Must be called before wifiscan_primary_service_define

Returns

void

Initialize the wifi_scan service with default values.

References APDETAILS_MAX_LEN, AT_BLE_ATTR_NO_PERMISSIONS, AT_BLE_ATTR_READABLE_NO_AUTHN_NO_AUTHR, AT_BLE_ATTR_READABLE_REQ_AUTHN_NO_AUTHR, AT_BLE_ATTR_WRITABLE_NO_AUTHN_NO_AUTHR, AT_BLE_CHAR_INDICATE, AT_BLE_CHAR_NOTIFY, AT_BLE_CHAR_READ, AT_BLE_CHAR_WRITE, AT_BLE_UUID_128, CHAR_USER_STR_WIFISCAN_APDETAILS, CHAR_USER_STR_WIFISCAN_APDETAILS_LEN, CHAR_USER_STR_WIFISCAN_SCANMODE, CHAR_USER_STR_WIFISCAN_SCANMODE_LEN, at_ble_characteristic_t::char_val_handle, at_ble_characteristic_t::client_config_handle, at_ble_characteristic_t::client_config_permissions, init_ap_count, init_ap_details, init_scan_mode, at_ble_characteristic_t::init_value, at_ble_characteristic_t::presentation_format, at_ble_characteristic_t::properties, wifiscan_gatt_service_handler::serv_chars, wifiscan_gatt_service_handler::serv_handle, wifiscan_gatt_service_handler::serv_uuid, at_ble_characteristic_t::server_config_handle, at_ble_characteristic_t::server_config_permissions, at_ble_uuid_t::type, at_ble_characteristic_t::user_desc, at_ble_characteristic_t::user_desc_handle, at_ble_characteristic_t::user_desc_len, at_ble_characteristic_t::user_desc_max_len, at_ble_characteristic_t::user_desc_permissions, at_ble_uuid_t::uuid, at_ble_characteristic_t::uuid, at_ble_characteristic_t::value_init_len, at_ble_characteristic_t::value_max_len, at_ble_characteristic_t::value_permissions, WIFI_SCAN_APCOUNT_CHAR_UUID, WIFI_SCAN_APDETAILS_CHAR_UUID, WIFI_SCAN_MODE_CHAR_UUID, WIFI_SCAN_SERVICE_UUID, WIFISCAN_BASIC_CHARACTERISTIC, wifiscan_char_pres_fmt_struct, wifiscan_char_pres_fmt_uint8, WIFISCAN_CHARACTERISTIC_COUNT, and WIFISCAN_UUID_128_LEN.

Referenced by wifi_provision_service_init().

void register_ble_characteristic_changed_cb

(

ble_characteristic_changed_callback_t

char_changed_cb_fn

)

Register callback function, to be triggered when characteristic value is changed.

Parameters

[in]

char_changed_cb_fn

function called when characteristic value is changed.

Returns

none.

Register callback function, to be triggered when characteristic value is changed.

References ble_char_changed_cb.

void register_ble_connected_event_cb

(

ble_gap_event_callback_t

connected_cb_fn

)

Register callback function, to be triggered when connected to the device.

Parameters

[in]

connected_cb_fn

function called when disconnected from the device.

Returns

none.

Register callback function, to be triggered when connected to the device.

References ble_connected_cb.

Referenced by initialise_provisioning_app().

void register_ble_disconnected_event_cb

(

ble_gap_event_callback_t

disconnected_cb_fn

)

Register callback function, to be triggered when disconnected from the peer device.

Parameters

[in]

disconnected_cb_fn

function called when disconnected from the peer device.

Returns

none.

Register callback function, to be triggered when disconnected from the peer device.

References ble_disconnected_cb.

Referenced by initialise_provisioning_app().

void register_ble_paired_event_cb

(

ble_gap_event_callback_t

paired_cb_fn

)

Register callback function, to be triggered when pairing procedure is completed.

Parameters

[in]

paired_cb_fn

function called when pairing is completed.

Returns

none.

Register callback function, to be triggered when pairing procedure is completed.

References ble_paired_cb.

Referenced by initialise_provisioning_app().

uint8_t wificon_char_change_apparam	(	at_ble_characteristic_changed_t *	param,
		wificon_gatt_service_handler_t *	wificon_handle
	)

wificon service apparam characteristics change

Parameters

[in]	param	changed parameter
[in]	wificon_handle	the service info which has handle range,uuid and characteristic array fields

Returns

status of the change request

References at_ble_characteristic_value_set(), AT_BLE_FAILURE, at_ble_characteristic_changed_t::char_handle, at_ble_characteristic_changed_t::char_len, at_ble_characteristic_changed_t::char_new_value, at_ble_characteristic_t::char_val_handle, FAILED_WIFICON_CHANGE_PARAM, INVALID_WIFICON_CHANGE_PARAM, wificon_gatt_service_handler::serv_chars, and VALID_WIFICON_CHANGE_PARAM.

Referenced by wifi_provision_char_changed_handler().

uint8_t wificon_char_change_state_client_cfg	(	at_ble_characteristic_changed_t *	param,
		wificon_gatt_service_handler_t *	wificon_handle
	)

wificon service state characteristics client config change

Parameters

[in]	param	changed parameter
[in]	wificon_handle	the service info which has handle (range,uuid and characteristic array fields)

Returns

status of the change request

References at_ble_characteristic_value_set(), AT_BLE_FAILURE, at_ble_characteristic_changed_t::char_handle, at_ble_characteristic_changed_t::char_len, at_ble_characteristic_changed_t::char_new_value, at_ble_characteristic_t::client_config_handle, FAILED_WIFICON_CHANGE_PARAM, INVALID_WIFICON_CHANGE_PARAM, wificon_gatt_service_handler::serv_chars, and VALID_WIFICON_CHANGE_PARAM.

Referenced by wifi_provision_char_changed_handler().

at_ble_status_t wificon_connect_noti	(	wificon_gatt_service_handler_t *	wificon_handler,
		uint8_t	s
	)

notification on the wifi connecting progress

Parameters

[in]	wificon_handler	the service info which has handle (range,uuid and characteristic array fields)
[in]	s	Connected state NOTIFY_STATE_PROVISIONFAILED, NOTIFY_STATE_WIFICONNECTING or NOTIFY_STATE_PROVISIONED

Returns

AT_BLE_SUCCESS operation completed successfully

AT_BLE_FAILURE Generic error.

References at_ble_characteristic_value_set(), AT_BLE_FAILURE, at_ble_notification_send(), AT_BLE_SUCCESS, at_ble_characteristic_t::char_val_handle, connect_state, and wificon_gatt_service_handler::serv_chars.

Referenced by inform_wifi_connection_state().

at_ble_status_t wificon_primary_service_define

(

wificon_gatt_service_handler_t *

wificon_primary_service

)

Defining the wifi_con service to the attribute data base.

Parameters

[in]

wificon_primary_service

the service info which has handle (range,uuid and characteristic array fields)

Precondition

Must be called after init_wifi_con_service

Returns

AT_BLE_SUCCESS operation completed successfully

AT_BLE_FAILURE Generic error.

Defining the wifi_con service to the attribute data base.

References at_ble_primary_service_define(), NULL, wificon_gatt_service_handler::serv_chars, wificon_gatt_service_handler::serv_handle, wificon_gatt_service_handler::serv_uuid, WIFICON_CHARACTERISTIC_COUNT, and WIFICON_INCLUDED_SERVICE_COUNT.

Referenced by wifi_provision_define().

uint8_t wifiscan_char_change_scanmode	(	at_ble_characteristic_changed_t *	p,
		wifiscan_gatt_service_handler_t *	wifiscan_handle
	)

wifiscan service scan mode characteristics change

Parameters

[in]	p	characteristic changed
[in]	wifiscan_handle	the wifi scan handle

Returns

status of the change request

wifiscan service scan mode characteristics change

References at_ble_characteristic_value_set(), AT_BLE_FAILURE, at_ble_characteristic_changed_t::char_handle, at_ble_characteristic_changed_t::char_len, at_ble_characteristic_changed_t::char_new_value, at_ble_characteristic_t::char_val_handle, FAILED_WIFISCAN_CHANGE_PARAM, INVALID_WIFISCAN_CHANGE_PARAM, wifiscan_gatt_service_handler::serv_chars, and VALID_WIFISCAN_CHANGE_PARAM.

Referenced by wifi_provision_char_changed_handler().

at_ble_status_t wifiscan_primary_service_define

(

wifiscan_gatt_service_handler_t *

wifiscan_primary_service

)

Defining the wifi_scan service to the attribute data base.

Parameters

[in]

wifiscan_primary_service

the service info which has handle range,uuid and characteristic array fields

Precondition

Must be called after init_wifi_scan_service

Returns

AT_BLE_SUCCESS operation completed successfully

AT_BLE_FAILURE Generic error.

Defining the wifi_scan service to the attribute data base.

References at_ble_primary_service_define(), NULL, wifiscan_gatt_service_handler::serv_chars, wifiscan_gatt_service_handler::serv_handle, wifiscan_gatt_service_handler::serv_uuid, WIFISCAN_CHARACTERISTIC_COUNT, and WIFISCAN_INCLUDED_SERVICE_COUNT.

Referenced by wifi_provision_define().

void wifiscan_print_char

(

wifiscan_gatt_service_handler_t *

wifiscan_handler

)

utility function to retrieve and print out characteristics (scanmode and ap_num)

Parameters

[in]

wifiscan_handler

the wifi scan handler

References at_ble_characteristic_value_get(), at_ble_characteristic_t::char_val_handle, and wifiscan_gatt_service_handler::serv_chars.

at_ble_status_t wifiscan_scanlist_receive	(	wifiscan_gatt_service_handler_t *	wifiscan_serv,
		wifi_provision_scanlist *	param,
		uint8_t *	num_ap_found
	)

update wifiscan scan list

Parameters

[in]	wifiscan_serv	wifiscan service
[in]	param	pointer to variable to be updated with number of APs found
[in]	num_ap_found	number of APs found

Returns

AT_BLE_SUCCESS operation completed successfully

AT_BLE_FAILURE Generic error.

update wifiscan scan list

References at_ble_characteristic_value_set(), AT_BLE_FAILURE, at_ble_notification_send(), AT_BLE_SUCCESS, at_ble_characteristic_t::char_val_handle, num_ap, wifi_provision_scanlist::num_valid, ap_details_t::rssi, _scanitem::rssi, wifi_provision_scanlist::scandetails, ap_details_t::sec_type, _scanitem::sec_type, wifiscan_gatt_service_handler::serv_chars, _scanitem::ssid, ap_details_t::ssidLen, WIFI_PROVISION_MAX_SSID_LENGTH, and WIFISCAN_BASIC_CHARACTERISTIC.

Referenced by wifi_provision_scanlist_receive().

at_ble_status_t wifiscan_update_scanmode_char_value	(	wifiscan_gatt_service_handler_t *	wifiscan_serv,
		uint8_t	char_data
	)

update wifiscan scan mode

Parameters

[in]	wifiscan_serv	wifiscan service
[in]	char_data	characteristics data

Returns

AT_BLE_SUCCESS operation completed successfully

AT_BLE_FAILURE Generic error.

update wifiscan scan mode

References at_ble_characteristic_value_set(), AT_BLE_FAILURE, at_ble_notification_send(), AT_BLE_SUCCESS, at_ble_characteristic_t::char_val_handle, scan_mode, and wifiscan_gatt_service_handler::serv_chars.

Referenced by wifi_provision_scanmode_update().