Macros | |
#define | ADV_DATA_PRESENT (0x01) |
#define | AT_BLE_ADDR_LEN (6) |
BLE address length. More... | |
#define | AT_BLE_ADV_INTERVAL_MAX 0x4000 |
Maximum Advertising interval in 625 us units, i.e. More... | |
#define | AT_BLE_ADV_INTERVAL_MIN 0x0020 |
Minimum Advertising interval in 625 us units, i.e. More... | |
#define | AT_BLE_ADV_MAX_SIZE (31) |
Maximum size of advertising data in octets. More... | |
#define | AT_BLE_ADV_NONCON_INTERVAL_MIN 0x00A0 |
Minimum Advertising interval in 625 us units for non connectable mode, i.e. More... | |
#define | AT_BLE_ATTR_NO_PERMISSIONS 0x00 |
#define | AT_BLE_ATTR_READABLE_NO_AUTHN_NO_AUTHR 0x01 |
Read enable. More... | |
#define | AT_BLE_ATTR_READABLE_NO_AUTHN_REQ_AUTHR 0x09 |
Read operation require Authorization & no encryption. More... | |
#define | AT_BLE_ATTR_READABLE_REQ_AUTHN_NO_AUTHR 0x03 |
Read operation require MITM protected encrypted link & no authorization. More... | |
#define | AT_BLE_ATTR_READABLE_REQ_AUTHN_REQ_AUTHR 0x0B |
Read operation require MITM protected encrypted link & authorization. More... | |
#define | AT_BLE_ATTR_READABLE_REQ_ENC_NO_AUTHN_NO_AUTHR 0x02 |
Read operation require encrypted link , MITM protection not necessary & No authorization. More... | |
#define | AT_BLE_ATTR_READABLE_REQ_ENC_NO_AUTHN_REQ_AUTHR 0x0A |
Read operation require encrypted link, MITM protection not necessary & authorization. More... | |
#define | AT_BLE_ATTR_WRITABLE_NO_AUTHN_NO_AUTHR 0x10 |
Write enable. More... | |
#define | AT_BLE_ATTR_WRITABLE_NO_AUTHN_REQ_AUTHR 0x90 |
Write operation require Authorization & no encryption. More... | |
#define | AT_BLE_ATTR_WRITABLE_REQ_AUTHN_NO_AUTHR 0x30 |
Write operation require MITM protected encrypted link & no authorization. More... | |
#define | AT_BLE_ATTR_WRITABLE_REQ_AUTHN_REQ_AUTHR 0xB0 |
Write operation require MITM protected encrypted link & authorization. More... | |
#define | AT_BLE_ATTR_WRITABLE_REQ_ENC_NO_AUTHN_NO_AUTHR 0x20 |
Write operation require encrypted link , MITM protection not necessary & No authorization. More... | |
#define | AT_BLE_ATTR_WRITABLE_REQ_ENC_NO_AUTHN_REQ_AUTHR 0xA0 |
Write operation require encrypted link, MITM protection not necessary & authorization. More... | |
#define | AT_BLE_AUTO_ALLOC_HANDLE (0x0000) |
Default value used to automatic allocate handle. More... | |
#define | AT_BLE_CH_MAP_LEN (0x05) |
Maximum number of channel mapping. More... | |
#define | AT_BLE_CHAR_BROADCST (1 << 0) |
#define | AT_BLE_CHAR_INDICATE (1 << 5) |
#define | AT_BLE_CHAR_NOTIFY (1 << 4) |
#define | AT_BLE_CHAR_READ (1 << 1) |
#define | AT_BLE_CHAR_RELIABLE_WRITE (1 << 7) |
#define | AT_BLE_CHAR_SIGNED_WRITE (1 << 6) |
#define | AT_BLE_CHAR_WRITE (1 << 3) |
#define | AT_BLE_CHAR_WRITE_WITHOUT_RESPONSE (1 << 2) |
#define | AT_BLE_CHAR_WRITEABLE_AUX (1 << 8) |
#define | AT_BLE_ENC_KEY_SIZE_PERM 0X40 |
Encryption key Size must be 16 bytes. More... | |
#define | AT_BLE_HCI_DTM_EVENT (0xBB) |
Maximum number of connections at the same time Direct test mode defines. More... | |
#define | AT_BLE_LECB_MAX_PKT_SIZE (0x200) |
LE credit based max packet size. More... | |
#define | AT_BLE_MAX_ATT_LEN (512) |
ATT MAximum Attribute Length. More... | |
#define | AT_BLE_MAX_CONCURRENT_CONNS (8) |
#define | AT_BLE_MAX_KEY_LEN (16) |
BLE security key maximum length. More... | |
#define | AT_BLE_MAX_NAME_LEN (0x20) |
BLE device name maximum length. More... | |
#define | AT_BLE_PASSKEY_LEN (6) |
GAP Security Key Length. More... | |
#define | AT_BLE_SCAN_INTERVAL_MAX 0x4000 |
Maximum scanning interval in 625 us units , i.e. More... | |
#define | AT_BLE_SCAN_INTERVAL_MIN 0x0004 |
Minimum scanning interval in 625 us units , i.e. More... | |
#define | AT_BLE_SCAN_WINDOW_MAX 0x4000 |
Maximum scanning window in 625 us units , i.e. More... | |
#define | AT_BLE_SCAN_WINDOW_MIN 0x0004 |
Minimum scanning window in 625 us units , i.e. More... | |
#define | AT_BLE_SCN_RESP_MAX_SIZE (31) |
Maximum size of scan response data in octets. More... | |
#define | at_ble_set_adv_channel_Map at_ble_adv_channel_map_set |
#define | AT_BLE_SLV_PREF_CON_INTV_MAX 0x0140 |
Maximum Slave Preferred Connection Interval. More... | |
#define | AT_BLE_SLV_PREF_CON_INTV_MIN 0x0140 |
Minimum Slave Preferred Connection Interval. More... | |
#define | AT_BLE_SLV_PREF_CON_LATENCY 0x0000 |
Slave Preferred Connection Latency. More... | |
#define | AT_BLE_SLV_PREF_SUPV_TO 0x01F4 |
Slave Preferred Connection Supervision Timeout. More... | |
#define | AT_BLE_UUID_128_LEN (16) |
UUID 128 size in bytes. More... | |
#define | AT_BLE_UUID_16_LEN (2) |
UUID 16 size in bytes. More... | |
#define | AT_BLE_UUID_32_LEN (4) |
UUID 32 size in bytes. More... | |
#define | AT_CNX_INTERVAL_MAX (3200) |
Connection interval max (N*1.250ms) More... | |
#define | AT_CNX_INTERVAL_MIN (6) |
Connection interval min (N*1.250ms) More... | |
#define | AT_CNX_LATENCY_MAX (499) |
Connection latency Max (N*cnx evt. More... | |
#define | AT_CNX_LATENCY_MIN (0) |
Connection latency min (N*cnx evt) More... | |
#define | AT_CNX_SUP_TO_MAX (3200) |
Supervision TO Max (N*10ms) More... | |
#define | AT_CNX_SUP_TO_MIN (10) |
Supervision TO min (N*10ms) More... | |
#define | AT_MTU_VAL_MAX (512) |
Maximal MTU value. More... | |
#define | AT_MTU_VAL_MIN (23) |
Minimal MTU value. More... | |
#define | AT_MTU_VAL_RECOMMENDED (512) |
Recommended MTU value. More... | |
#define | AT_RENEW_DUR_VAL_MIN (0x3A98) |
Minimal Renew duration value (150 seconds); resolution of 10 mSeconds (N*10ms) More... | |
#define | SCN_RESP_DATA_PRESENT (0x02) |
Typedefs | |
typedef uint8_t | at_ble_attr_permissions_t |
typedef uint16_t | at_ble_char_properties_t |
Characteristic properties. More... | |
typedef at_ble_cmd_complete_event_t | at_ble_discovery_complete_t |
typedef at_ble_status_t | at_ble_gattc_discovery_complete_status_t |
Discovery status. More... | |
typedef uint16_t | at_ble_handle_t |
BLE connection handle. More... | |
typedef struct platform_api_list_tag | at_ble_platform_api_list_t |
typedef struct at_ble_addr_t | at_ble_rand_addr_changed_t |
typedef at_ble_err_status_t | at_ble_status_t |
Functions | |
at_ble_status_t | at_ble_addr_get (at_ble_addr_t *address) |
Get device BT Address. More... | |
at_ble_status_t | at_ble_addr_set (at_ble_addr_t *address) |
Set device BT Address. More... | |
at_ble_status_t | at_ble_adv_channel_map_get (at_ble_adv_channel_map_t *ch) |
get advertising channel. More... | |
at_ble_status_t | at_ble_adv_channel_map_set (at_ble_adv_channel_map_t ch) |
Set advertising channel using one of at_ble_adv_channel_map_t. More... | |
at_ble_status_t | at_ble_adv_data_set (uint8_t const *const adv_data, uint8_t adv_data_len, uint8_t const *const scan_resp_data, uint8_t scan_response_data_len) |
Set, clear or update advertisement and scan response data. More... | |
at_ble_status_t | at_ble_adv_data_update_on_the_fly (at_ble_adv_data_update_on_the_fly_t *update_on_the_fly_data) |
Set, clear or update advertising data or scan response data or both on the fly (while an advertising operation is ongoing) . More... | |
at_ble_status_t | at_ble_adv_start (at_ble_adv_type_t type, at_ble_adv_mode_t mode, at_ble_addr_t *peer_addr, at_ble_filter_type_t filtered, uint16_t interval, uint16_t timeout, bool disable_randomness) |
Start advertising (GAP Discoverable, Connectable modes, Broadcast Procedure). More... | |
at_ble_status_t | at_ble_adv_stop (void) |
Stop advertising (GAP Discoverable, Connectable modes, Broadcast Procedure). More... | |
at_ble_status_t | at_ble_authenticate (at_ble_handle_t conn_handle, at_ble_pair_features_t *features, at_ble_LTK_t *ltk, at_ble_CSRK_t *csrk) |
Starts Pairing procedure for a given connection. More... | |
at_ble_status_t | at_ble_calib_config (int calib_enable, uint32_t no_samples, uint32_t cal_freq) |
Configures periodic Vbat/Vtemp calibration: enable/disable, number of ADC samples needed for averaging, frequency of the calibration in seconds. More... | |
at_ble_status_t | at_ble_calib_get_temp (int *temperature) |
Retrieves temperature value in Celsius. More... | |
at_ble_status_t | at_ble_calib_get_voltage (float *voltage) |
Retrieves voltage value in volts. More... | |
at_ble_status_t | at_ble_characteristic_discover_all (at_ble_handle_t conn_handle, at_ble_handle_t start_handle, at_ble_handle_t end_handle) |
Discover all Characteristics declared in a connected device. More... | |
at_ble_status_t | at_ble_characteristic_discover_by_uuid (at_ble_handle_t conn_handle, at_ble_handle_t start_handle, at_ble_handle_t end_handle, at_ble_uuid_t *uuid) |
Discover all Characteristics of a given UUID declared in a connected device. More... | |
at_ble_status_t | at_ble_characteristic_read (at_ble_handle_t conn_handle, at_ble_handle_t char_handle, uint16_t offset, uint16_t length) |
Read a characteristic given its handle. More... | |
at_ble_status_t | at_ble_characteristic_read_by_uuid (at_ble_handle_t conn_handle, at_ble_handle_t start_handle, at_ble_handle_t end_handle, at_ble_uuid_t *uuid) |
Read a characteristic given its UUID. More... | |
at_ble_status_t | at_ble_characteristic_read_long (at_ble_handle_t conn_handle, at_ble_handle_t char_handle, uint16_t offset, uint16_t length) |
Long read a characteristic given its handle. More... | |
at_ble_status_t | at_ble_characteristic_read_multiple (at_ble_handle_t conn_handle, at_ble_char_list *char_handle_list, uint8_t char_handle_count) |
Read a list of characteristics given their handles. More... | |
at_ble_status_t | at_ble_characteristic_reliable_write_cancel (at_ble_handle_t conn_handle) |
Cancels a pending prepared reliable write operation. More... | |
at_ble_status_t | at_ble_characteristic_reliable_write_execute (at_ble_handle_t conn_handle) |
Executes a pending prepared write operation. More... | |
at_ble_status_t | at_ble_characteristic_reliable_write_prepare (at_ble_handle_t conn_handle, at_ble_handle_t char_handle, uint16_t offset, uint16_t length, uint8_t *data) |
add a new prepared write request More... | |
at_ble_status_t | at_ble_characteristic_value_get (at_ble_handle_t handle, uint8_t *value, uint16_t *len) |
Reads A characteristic value. More... | |
at_ble_status_t | at_ble_characteristic_value_set (at_ble_handle_t handle, uint8_t *value, uint16_t len) |
Sets A characteristic value. More... | |
at_ble_status_t | at_ble_characteristic_write (at_ble_handle_t conn_handle, at_ble_handle_t char_handle, uint16_t offset, uint16_t length, uint8_t *data, bool signed_write, bool with_response) |
Write a characteristic value in peer device and write completion will be reported via AT_BLE_CHARACTERISTIC_WRITE_CMD_CMP event after firmware handling. More... | |
at_ble_status_t | at_ble_chip_id_get (uint32_t *chip_id) |
Gets BTLC1000 Chip ID. More... | |
at_ble_status_t | at_ble_conn_update_reply (at_ble_handle_t handle, bool accept, uint16_t ce_len_min, uint16_t ce_len_max) |
Reply to connection parameters update request AT_BLE_CONN_PARAM_UPDATE_REQUEST. More... | |
at_ble_status_t | at_ble_connect (at_ble_addr_t peers[], uint8_t peer_count, uint16_t scan_interval, uint16_t scan_window, at_ble_connection_params_t *connection_params) |
Connect to a peer device. More... | |
at_ble_status_t | at_ble_connect_cancel (void) |
Cancels an ongoing connection attempt. More... | |
at_ble_status_t | at_ble_connection_param_update (at_ble_handle_t handle, at_ble_connection_params_t *connection_params) |
Update the connection parameters of an ongoing connection. More... | |
at_ble_status_t | at_ble_descriptor_discover_all (at_ble_handle_t conn_handle, at_ble_handle_t start_handle, at_ble_handle_t end_handle) |
Discover all Descriptors declared in a connected device. More... | |
at_ble_status_t | at_ble_descriptor_value_get (at_ble_handle_t handle, uint8_t *value, uint16_t *len) |
Reads A Descriptor value. More... | |
at_ble_status_t | at_ble_descriptor_value_set (at_ble_handle_t handle, uint8_t *value, uint16_t len) |
Sets A characteristic value. More... | |
at_ble_status_t | at_ble_device_name_set (uint8_t *dev_name, uint8_t len) |
Set device name. More... | |
at_ble_status_t | at_ble_disconnect (at_ble_handle_t handle, at_ble_disconnect_reason_t reason) |
Disconnect a connected peer device and receive response through AT_BLE_DISCONNECTED event. More... | |
at_ble_status_t | at_ble_dtm_reset (void) |
pack and send Direct test mode reset command, after calling this API you should wait for AT_BLE_LE_TEST_STATUS event More... | |
at_ble_status_t | at_ble_dtm_rx_test_start (uint8_t frequency_index) |
pack and send Direct test mode RX test start command, after calling this API you should wait for AT_BLE_LE_TEST_STATUS event More... | |
at_ble_status_t | at_ble_dtm_stop_test (void) |
pack and send Direct test mode stop test command, after calling this API you should wait for AT_BLE_LE_PACKET_REPORT event More... | |
at_ble_status_t | at_ble_dtm_tx_test_start (uint8_t frequency_index, uint8_t data_length, at_ble_dtm_payload_type_t payload) |
Pack and send Direct test mode TX test start command, after calling this API you should wait for AT_BLE_LE_TEST_STATUS event. More... | |
at_ble_status_t | at_ble_en_recv_adv_cmp_event (bool en_adv_notification) |
Enable/Disable receiving advertising complete event AT_BLE_ADV_CMP_EVENT with the end of advertising event. More... | |
at_ble_status_t | at_ble_enable_sleep (bool en_sleep) |
Enable/disable deep sleep. More... | |
at_ble_status_t | at_ble_encryption_request_reply (at_ble_handle_t conn_handle, at_ble_auth_t auth, bool key_found, at_ble_LTK_t *key) |
Responds to encryption start request from master device AT_BLE_ENCRYPTION_REQUEST, once encryption starts AT_BLE_ENCRYPTION_STATUS_CHANGED event is delivered. More... | |
at_ble_status_t | at_ble_encryption_start (at_ble_handle_t conn_handle, at_ble_LTK_t *key, at_ble_auth_t auth) |
Starts encryption, once encryption starts AT_BLE_ENCRYPTION_STATUS_CHANGED event is delivered. More... | |
at_ble_status_t | at_ble_event_get (at_ble_events_t *event, void *params, uint32_t timeout) |
extracts the next event form the event queue More... | |
at_ble_status_t | at_ble_event_user_defined_post (void *params) |
Posts a user defined custom event into the event queue, allowing the user code to process other events in the same event handling loop. More... | |
at_ble_status_t | at_ble_exchange_mtu (at_ble_handle_t conn_handle) |
send the MTU exchange command to peer device More... | |
at_ble_status_t | at_ble_firmware_version_get (uint32_t *fw_version) |
Gets BTLC1000 Firmware version. More... | |
at_ble_status_t | at_ble_gap_get_peer_deviceinfo (uint16_t conn_handle, at_ble_gapc_get_info_cmd_t *operation) |
Retrieve information about peer device or about the current active link expected events are AT_BLE_PEER_ATT_INFO_IND AT_BLE_CON_CHANNEL_MAP_IND. More... | |
at_ble_status_t | at_ble_get_adv_cnt (uint32_t *adv_pdu_cnt) |
Get the count of Advertising frame. More... | |
at_ble_status_t | at_ble_get_whitelist_size (uint8_t *size) |
Get total number of white list entries that can be stored in the Controller. More... | |
at_ble_status_t | at_ble_htpt_create_db (at_ble_htpt_db_config_flag features, at_ble_htpt_temp_type temp_type, uint16_t valid_range_min, uint16_t valid_range_max, uint16_t meas_intv, at_ble_htpt_sec_level sec_lvl, at_ble_handle_t *start_handle) |
This API message shall be used to add an instance of the Health Thermometer service into the database. More... | |
at_ble_status_t | at_ble_htpt_enable (at_ble_handle_t conn_handle, at_ble_htpt_ntf_ind_cfg ntf_ind_cfg) |
This API message can be used after the connection with a peer device has been established in order to restore known device bond data, in response a AT_BLE_HTPT_ENABLE_RSP event should be received. More... | |
at_ble_status_t | at_ble_htpt_meas_intv_chg_cfm (at_ble_handle_t conn_handle, at_ble_status_t status) |
This message is used by application to confirm that measurement interval modification is accepted or not by the application.Write confirmation is sent back to peer devices that requests modification and if accepted, all other devices connected which have configured to receive measurement interval change indication will be informed about this modification. More... | |
at_ble_status_t | at_ble_htpt_meas_intv_update (uint16_t meas_intv) |
This message is used by the application to order the HTPT profile to generate an indication (if enabled) of the Measurement Interval Char. More... | |
at_ble_status_t | at_ble_htpt_temp_send (uint32_t temp, at_ble_prf_date_time_t *time_stamp, at_ble_htpt_temp_flags flags, at_ble_htpt_temp_type type, bool flag_stable_meas) |
This message is used by the application (which handles the temperature device driver and measurements) to send a temperature measurement through the Thermometer role. More... | |
at_ble_status_t | at_ble_included_service_discover_all (at_ble_handle_t conn_handle, at_ble_handle_t start_handle, at_ble_handle_t end_handle) |
Discover all included services declared in a connected device. More... | |
at_ble_status_t | at_ble_indication_send (at_ble_handle_t conn_handle, at_ble_handle_t attr_handle) |
Sends an Indication AT_BLE_INDICATION_CONFIRMED is received when indication has been correctly received by peer device. More... | |
at_ble_status_t | at_ble_init (at_ble_init_config_t *args) |
Initialize bus interface, reset the link layer and the host , Initialize memory required for storing data base related data. More... | |
at_ble_status_t | at_ble_lecb_add_credit (at_ble_handle_t conn_handle, uint16_t le_psm, uint16_t credit) |
Inform peer device that local device can receive more packets, this is a blocking API. More... | |
at_ble_status_t | at_ble_lecb_cfm (at_ble_handle_t conn_handle, uint16_t le_psm, at_ble_lecb_status status) |
Server confirms if a credit based connection is completed successfully. More... | |
at_ble_status_t | at_ble_lecb_connect (at_ble_handle_t conn_handle, uint16_t le_psm, uint16_t cid, uint16_t intial_credit) |
Initiate a credit based connection. More... | |
at_ble_status_t | at_ble_lecb_create (at_ble_handle_t conn_handle, at_ble_lecb_sec_level_t sec_level, uint16_t le_psm, uint16_t cid, uint16_t initial_credit) |
Initialize a credit based channel to receive a credit based connection request, this API is blocking. More... | |
at_ble_status_t | at_ble_lecb_destroy (at_ble_handle_t conn_handle, uint16_t le_psm) |
Close an initialized credit based channel, this API is blocking. More... | |
at_ble_status_t | at_ble_lecb_disconnect (at_ble_handle_t conn_handle, uint16_t le_psm) |
Terminate a credit based connection. More... | |
at_ble_status_t | at_ble_lecb_send (at_ble_handle_t conn_handle, uint16_t cid, uint16_t len, uint8_t *data) |
Send data. More... | |
at_ble_status_t | at_ble_notification_send (at_ble_handle_t conn_handle, at_ble_handle_t attr_handle) |
Sends a Notification AT_BLE_NOTIFICATION_CONFIRMED is received as soon as notification PDU has been sent over the air. More... | |
at_ble_status_t | at_ble_pair_key_reply (at_ble_handle_t conn_handle, at_ble_pair_key_type_t type, uint8_t *key) |
Provides a passkey or OOB data that was requested via AT_BLE_PAIR_KEY_REQUEST event, If key type is AT_BLE_PAIR_PASSKEY, then a 6-byte ASCII string (digit 0..9 only). More... | |
at_ble_status_t | at_ble_primary_service_define (at_ble_uuid_t *uuid, at_ble_handle_t *service_handle, at_ble_included_service_t *included_service_list, uint16_t included_service_count, at_ble_characteristic_t *charactristic_list, uint16_t charactristic_count) |
Defines a new Primary service along with its included services and characteristics. More... | |
at_ble_status_t | at_ble_primary_service_discover_all (at_ble_handle_t conn_handle, at_ble_handle_t start_handle, at_ble_handle_t end_handle) |
Discover all Primary services in a peer device. More... | |
at_ble_status_t | at_ble_primary_service_discover_by_uuid (at_ble_handle_t conn_handle, at_ble_handle_t start_handle, at_ble_handle_t end_handle, at_ble_uuid_t *uuid) |
Discover Primary service of a given UUID declared and located in a peer device. More... | |
at_ble_status_t | at_ble_random_address_resolve (uint8_t nb_key, at_ble_addr_t *rand_addr, uint8_t *irk_key) |
Handles request of resolving a resolvable random address ,AT_BLE_RESOLV_RAND_ADDR_STATUS event is used to inform which key has been used to perform resolution for the returned address. More... | |
at_ble_status_t | at_ble_read_authorize_reply (at_ble_handle_t conn_handle, at_ble_handle_t attr_handle, bool grant_authorization) |
Replies to a read authorization request requested by by AT_BLE_READ_AUTHORIZE_REQUEST event. More... | |
at_ble_status_t | at_ble_rf_version_get (uint32_t *rf_version) |
Gets BTLC1000 RF version. More... | |
at_ble_status_t | at_ble_rst_adv_cnt (void) |
Reset the count of Advertising frame. More... | |
at_ble_status_t | at_ble_rx_power_get (at_ble_handle_t conn_handle, int8_t *rx_power) |
Gets RX power of a given connection. More... | |
at_ble_status_t | at_ble_scan_start (uint16_t interval, uint16_t window, uint16_t timeout, at_ble_scan_type_t type, at_ble_scan_mode_t mode, bool filter_whitelist, bool filter_dublicates) |
Start scan operation. More... | |
at_ble_status_t | at_ble_scan_stop (void) |
Stops an ongoing scan operation. More... | |
at_ble_status_t | at_ble_secondary_service_define (at_ble_uuid_t *uuid, at_ble_handle_t *service_handle, at_ble_included_service_t *included_service_list, uint16_t included_service_count, at_ble_characteristic_t *charactristic_list, uint16_t charactristic_count) |
Defines a new Secondary service along with its included services and characteristics. More... | |
at_ble_status_t | at_ble_send_sec_config (at_ble_signature_info_t *signature_info, at_ble_auth_t authen, bool service_changed) |
Set specific link security configuration and bonding data. More... | |
at_ble_status_t | at_ble_send_service_changed_indication (at_ble_handle_t conn_handle, at_ble_handle_t start_handle, at_ble_handle_t end_handle) |
Sends a Service changed Indication. More... | |
at_ble_status_t | at_ble_send_slave_sec_request (at_ble_handle_t conn_handle, bool mitm_protection, bool bond) |
Send slave security request to master. More... | |
at_ble_status_t | at_ble_service_define (at_ble_service_t *svc) |
Defines a new service along with its included services and characteristics. More... | |
at_ble_status_t | at_ble_set_att_config (at_ble_att_cfg_t *dev_att_cfg) |
Set attribute permissions configuration (Device Appearance permissions, slave preferred connection parameters, Device Name permissions, Service Change feature) More... | |
at_ble_status_t | at_ble_set_channel_map (at_ble_channel_map_t *map) |
Set channel map. More... | |
at_ble_status_t | at_ble_set_conn_mode (at_ble_conn_mode_t mode) |
Set connection mode parameter. More... | |
at_ble_status_t | at_ble_set_dev_config (at_ble_dev_config_t *config) |
Set device configuration. More... | |
at_ble_status_t | at_ble_set_gap_deviceinfo (at_ble_gap_deviceinfo_t *gap_deviceinfo) |
Set GAP attribute data base (Appearance , slave preferred connection parameters , device name write permissions) More... | |
at_ble_status_t | at_ble_set_privacy_key (at_ble_gap_irk_t *irk, uint16_t interval) |
Set device Identity Resolving Key. More... | |
at_ble_status_t | at_ble_set_ulp_delay (at_ble_ulp_delay_t arg) |
at_ble_status_t | at_ble_tx_power_get (at_ble_tx_power_level_t *power) |
Gets TX power value. More... | |
at_ble_status_t | at_ble_tx_power_set (at_ble_tx_power_level_t power) |
Sets TX power value. More... | |
at_ble_uuid_type_t | at_ble_uuid_len2type (uint8_t len) |
uint8_t | at_ble_uuid_type2len (at_ble_uuid_type_t type) |
at_ble_status_t | at_ble_whitelist_add (at_ble_addr_t *address) |
Adds a peer device address to the white-list. More... | |
at_ble_status_t | at_ble_whitelist_clear (void) |
Clear the white-list. More... | |
at_ble_status_t | at_ble_whitelist_remove (at_ble_addr_t *address) |
Removes a peer device address from the white-list. More... | |
at_ble_status_t | at_ble_write_authorize_reply (at_ble_characteristic_write_request_t *param, at_ble_status_t status) |
Replies to a write authorization request requested by by AT_BLE_WRITE_AUTHORIZE_REQUEST event. More... | |
at_ble_status_t | read_32_from_BTLC1000 (uint32_t address, uint32_t *value) |
Raeds 32 bit from BTLC1000. More... | |
#define ADV_DATA_PRESENT (0x01) |
Referenced by eddystone_adv_start().
#define AT_BLE_ADDR_LEN (6) |
BLE address length.
#define AT_BLE_ADV_INTERVAL_MAX 0x4000 |
Maximum Advertising interval in 625 us units, i.e.
10.24 s.
#define AT_BLE_ADV_INTERVAL_MIN 0x0020 |
Minimum Advertising interval in 625 us units, i.e.
20 ms.
#define AT_BLE_ADV_MAX_SIZE (31) |
Maximum size of advertising data in octets.
Referenced by ble_advertisement_data_set().
#define AT_BLE_ADV_NONCON_INTERVAL_MIN 0x00A0 |
Minimum Advertising interval in 625 us units for non connectable mode, i.e.
100 ms.
Referenced by altbeacon_init().
#define AT_BLE_ATTR_NO_PERMISSIONS 0x00 |
#define AT_BLE_ATTR_READABLE_NO_AUTHN_NO_AUTHR 0x01 |
Read enable.
Referenced by bat_init_service(), dis_init_service(), esurl_conf_service_init(), hid_serv_init(), hr_init_service(), init_linkloss_service(), init_tx_power_service(), and sps_init_service().
#define AT_BLE_ATTR_READABLE_NO_AUTHN_REQ_AUTHR 0x09 |
Read operation require Authorization & no encryption.
#define AT_BLE_ATTR_READABLE_REQ_AUTHN_NO_AUTHR 0x03 |
Read operation require MITM protected encrypted link & no authorization.
Referenced by bat_init_service(), blp_init_service(), csc_serv_init(), dis_init_service(), esurl_conf_service_init(), hid_serv_init(), hr_init_service(), init_linkloss_service(), and init_tx_power_service().
#define AT_BLE_ATTR_READABLE_REQ_AUTHN_REQ_AUTHR 0x0B |
Read operation require MITM protected encrypted link & authorization.
#define AT_BLE_ATTR_READABLE_REQ_ENC_NO_AUTHN_NO_AUTHR 0x02 |
Read operation require encrypted link , MITM protection not necessary & No authorization.
#define AT_BLE_ATTR_READABLE_REQ_ENC_NO_AUTHN_REQ_AUTHR 0x0A |
Read operation require encrypted link, MITM protection not necessary & authorization.
#define AT_BLE_ATTR_WRITABLE_NO_AUTHN_NO_AUTHR 0x10 |
Write enable.
Referenced by bat_init_service(), hid_serv_init(), hr_init_service(), init_immediate_alert_service(), init_linkloss_service(), and sps_init_service().
#define AT_BLE_ATTR_WRITABLE_NO_AUTHN_REQ_AUTHR 0x90 |
Write operation require Authorization & no encryption.
Referenced by esurl_conf_service_init().
#define AT_BLE_ATTR_WRITABLE_REQ_AUTHN_NO_AUTHR 0x30 |
Write operation require MITM protected encrypted link & no authorization.
Referenced by bat_init_service(), blp_init_service(), csc_serv_init(), hid_serv_init(), hr_init_service(), init_immediate_alert_service(), init_linkloss_service(), and sps_init_service().
#define AT_BLE_ATTR_WRITABLE_REQ_AUTHN_REQ_AUTHR 0xB0 |
Write operation require MITM protected encrypted link & authorization.
Referenced by esurl_conf_service_init(), and hr_init_service().
#define AT_BLE_ATTR_WRITABLE_REQ_ENC_NO_AUTHN_NO_AUTHR 0x20 |
Write operation require encrypted link , MITM protection not necessary & No authorization.
#define AT_BLE_ATTR_WRITABLE_REQ_ENC_NO_AUTHN_REQ_AUTHR 0xA0 |
Write operation require encrypted link, MITM protection not necessary & authorization.
#define AT_BLE_AUTO_ALLOC_HANDLE (0x0000) |
Default value used to automatic allocate handle.
Referenced by ble_device_config(), and ble_set_dev_config().
#define AT_BLE_CH_MAP_LEN (0x05) |
Maximum number of channel mapping.
#define AT_BLE_CHAR_BROADCST (1 << 0) |
#define AT_BLE_CHAR_INDICATE (1 << 5) |
Referenced by blp_init_service().
#define AT_BLE_CHAR_NOTIFY (1 << 4) |
Referenced by bat_init_service(), blp_init_service(), csc_serv_init(), hid_serv_init(), hr_init_service(), and sps_init_service().
#define AT_BLE_CHAR_READ (1 << 1) |
#define AT_BLE_CHAR_RELIABLE_WRITE (1 << 7) |
#define AT_BLE_CHAR_SIGNED_WRITE (1 << 6) |
#define AT_BLE_CHAR_WRITE (1 << 3) |
Referenced by esurl_conf_service_init(), hid_serv_init(), hr_init_service(), and init_linkloss_service().
#define AT_BLE_CHAR_WRITE_WITHOUT_RESPONSE (1 << 2) |
Referenced by hid_serv_init(), init_immediate_alert_service(), and sps_init_service().
#define AT_BLE_CHAR_WRITEABLE_AUX (1 << 8) |
#define AT_BLE_ENC_KEY_SIZE_PERM 0X40 |
Encryption key Size must be 16 bytes.
#define AT_BLE_HCI_DTM_EVENT (0xBB) |
Maximum number of connections at the same time Direct test mode defines.
#define AT_BLE_LECB_MAX_PKT_SIZE (0x200) |
LE credit based max packet size.
#define AT_BLE_MAX_ATT_LEN (512) |
ATT MAximum Attribute Length.
#define AT_BLE_MAX_CONCURRENT_CONNS (8) |
#define AT_BLE_MAX_KEY_LEN (16) |
BLE security key maximum length.
Referenced by ble_connected_state_handler(), and ble_resolv_rand_addr_handler().
#define AT_BLE_MAX_NAME_LEN (0x20) |
BLE device name maximum length.
#define AT_BLE_PASSKEY_LEN (6) |
GAP Security Key Length.
Referenced by ble_pair_key_request_handler().
#define AT_BLE_SCAN_INTERVAL_MAX 0x4000 |
Maximum scanning interval in 625 us units , i.e.
10.24 s.
#define AT_BLE_SCAN_INTERVAL_MIN 0x0004 |
Minimum scanning interval in 625 us units , i.e.
2.5 ms.
#define AT_BLE_SCAN_WINDOW_MAX 0x4000 |
Maximum scanning window in 625 us units , i.e.
10.24 s.
#define AT_BLE_SCAN_WINDOW_MIN 0x0004 |
Minimum scanning window in 625 us units , i.e.
2.5 ms.
#define AT_BLE_SCN_RESP_MAX_SIZE (31) |
Maximum size of scan response data in octets.
#define at_ble_set_adv_channel_Map at_ble_adv_channel_map_set |
#define AT_BLE_SLV_PREF_CON_INTV_MAX 0x0140 |
Maximum Slave Preferred Connection Interval.
#define AT_BLE_SLV_PREF_CON_INTV_MIN 0x0140 |
Minimum Slave Preferred Connection Interval.
#define AT_BLE_SLV_PREF_CON_LATENCY 0x0000 |
Slave Preferred Connection Latency.
#define AT_BLE_SLV_PREF_SUPV_TO 0x01F4 |
Slave Preferred Connection Supervision Timeout.
#define AT_BLE_UUID_128_LEN (16) |
UUID 128 size in bytes.
Referenced by ble_observer_scan_info_handler(), esurl_conf_adv_start(), esurl_conf_service_init(), and scan_info_parse().
#define AT_BLE_UUID_16_LEN (2) |
UUID 16 size in bytes.
Referenced by ble_observer_scan_info_handler(), and scan_info_parse().
#define AT_BLE_UUID_32_LEN (4) |
UUID 32 size in bytes.
Referenced by ble_observer_scan_info_handler(), and scan_info_parse().
#define AT_CNX_INTERVAL_MAX (3200) |
Connection interval max (N*1.250ms)
#define AT_CNX_INTERVAL_MIN (6) |
Connection interval min (N*1.250ms)
#define AT_CNX_LATENCY_MAX (499) |
Connection latency Max (N*cnx evt.
#define AT_CNX_LATENCY_MIN (0) |
Connection latency min (N*cnx evt)
#define AT_CNX_SUP_TO_MAX (3200) |
Supervision TO Max (N*10ms)
#define AT_CNX_SUP_TO_MIN (10) |
Supervision TO min (N*10ms)
#define AT_MTU_VAL_MAX (512) |
Maximal MTU value.
#define AT_MTU_VAL_MIN (23) |
Minimal MTU value.
#define AT_MTU_VAL_RECOMMENDED (512) |
Recommended MTU value.
Referenced by ble_device_config(), and ble_set_dev_config().
#define AT_RENEW_DUR_VAL_MIN (0x3A98) |
Minimal Renew duration value (150 seconds); resolution of 10 mSeconds (N*10ms)
Referenced by ble_device_config(), and ble_set_dev_config().
#define SCN_RESP_DATA_PRESENT (0x02) |
typedef uint8_t at_ble_attr_permissions_t |
typedef uint16_t at_ble_char_properties_t |
Characteristic properties.
Discovery status.
typedef uint16_t at_ble_handle_t |
BLE connection handle.
typedef struct platform_api_list_tag at_ble_platform_api_list_t |
typedef struct at_ble_addr_t at_ble_rand_addr_changed_t |
typedef at_ble_err_status_t at_ble_status_t |
enum at_ble_addr_type_t |
BLE can accept to kinds of addresses, either public or random addresses.
Advertising channels enables.
enum at_ble_adv_mode_t |
Advertising Mode.
enum at_ble_adv_type_t |
GAP Advertising types.
Enumerator | |
---|---|
AT_BLE_ADV_TYPE_UNDIRECTED |
Connectable undirected. |
AT_BLE_ADV_TYPE_DIRECTED |
Connectable high duty cycle directed advertising. |
AT_BLE_ADV_TYPE_SCANNABLE_UNDIRECTED |
Scannable undirected. |
AT_BLE_ADV_TYPE_NONCONN_UNDIRECTED |
Non connectable undirected. |
AT_BLE_ADV_TYPE_DIRECTED_LDC |
Connectable low duty cycle directed advertising. |
AT_BLE_ADV_TYPE_SCAN_RESPONSE |
only used in AT_BLE_SCAN_INFO event to signify a scan response |
enum at_ble_auth_levels_t |
Security authentication level.
enum at_ble_auth_t |
enum at_ble_author_t |
enum at_ble_bus_type_tag |
This enumeration used by platform_config to select platform_config::bus_type either AT_BLE_UART or AT_BLE_SPI.
Enumerator | |
---|---|
AT_BLE_UART |
UART Interface is used [Default]. |
AT_BLE_SPI |
SPI interface is used. |
enum at_ble_conn_mode_t |
enum at_ble_dev_role_t |
Constant defining the role.
disconnection reasons
enum at_ble_eks |
enum at_ble_events_t |
Events delivered from BLE stack to the application layer.
Enumerator | |
---|---|
AT_BLE_UNDEFINED_EVENT |
Undefined event received. |
AT_BLE_SCAN_INFO |
Scan info needs to be delivered either adv data or scan response data.
|
AT_BLE_SCAN_REPORT |
Scan report received at the end of scan period if AT_BLE_SCAN_GEN_DISCOVERY or AT_BLE_SCAN_LIM_DISCOVERY are used.
|
AT_BLE_ADV_CMP_EVENT |
Advertising complete event , this event is received at the end of advertising event. Refer to at_ble_adv_cmp_evt_t |
AT_BLE_ADV_REPORT |
Advertising report received if error has occurred or timeout happened. Refer to at_ble_adv_report_t |
AT_BLE_RAND_ADDR_CHANGED |
Used random address.
|
AT_BLE_CONNECTED |
connected to a peer device.
|
AT_BLE_DISCONNECTED |
peer device connection terminated.
|
AT_BLE_CONN_PARAM_UPDATE_DONE |
connection parameters updated. It is requires to call at_ble_conn_update_reply function to send response back if needed. |
AT_BLE_CONN_PARAM_UPDATE_REQUEST |
peer device asks for connection parameters update.
|
AT_BLE_PAIR_DONE |
Pairing procedure is completed.
|
AT_BLE_PAIR_REQUEST |
A central device asks for Pairing.
|
AT_BLE_SLAVE_SEC_REQUEST |
Slave security request.
|
AT_BLE_PAIR_KEY_REQUEST |
A passkey or OOB data is requested as part of pairing procedure.
|
AT_BLE_ENCRYPTION_REQUEST |
Encryption is requested by a master device.
|
AT_BLE_ENCRYPTION_STATUS_CHANGED |
Encryption status changed.
|
AT_BLE_RESOLV_RAND_ADDR_STATUS |
Resolve random address status.
|
AT_BLE_SIGN_COUNTERS_IND |
Signature counters new values indication Refer to at_ble_sign_counter_t. |
AT_BLE_PEER_ATT_INFO_IND |
peer attribute info received Refer to at_ble_peer_att_info_ind_t |
AT_BLE_CON_CHANNEL_MAP_IND |
peer device channel map received Refer to at_ble_channel_map_t |
AT_BLE_PRIMARY_SERVICE_FOUND |
A primary service is found.
|
AT_BLE_INCLUDED_SERVICE_FOUND |
An included service is found .
|
AT_BLE_CHARACTERISTIC_FOUND |
A Characteristic is found.
|
AT_BLE_DESCRIPTOR_FOUND |
A descriptor is found.
|
AT_BLE_DISCOVERY_COMPLETE |
A discover operation has completed.
|
AT_BLE_CHARACTERISTIC_READ_RESPONSE |
Characteristic read procedure is done. |
AT_BLE_CHARACTERISTIC_READ_BY_UUID_RESPONSE |
Characteristic read by UUID procedure is done.
|
AT_BLE_CHARACTERISTIC_READ_MULTIBLE_RESPONSE |
Characteristic multiple read procedure is done.
|
AT_BLE_CHARACTERISTIC_WRITE_RESPONSE |
Characteristic write procedure is done. |
AT_BLE_NOTIFICATION_RECIEVED |
A Notification is received.
|
AT_BLE_INDICATION_RECIEVED |
An Indication is received.
|
AT_BLE_NOTIFICATION_CONFIRMED |
The firmware confirmed that an Notification PDU has been sent over the air.
|
AT_BLE_INDICATION_CONFIRMED |
The peer confirmed that it has received an Indication.
|
AT_BLE_CHARACTERISTIC_CHANGED |
The peer has changed a characteristic value.
|
AT_BLE_CHARACTERISTIC_CONFIGURATION_CHANGED |
The peer has changed a characteristic configuration descriptor value. |
AT_BLE_SERVICE_CHANGED_INDICATION_SENT |
the service changed indication had been sent .
|
AT_BLE_WRITE_AUTHORIZE_REQUEST |
The peer asks for a write Authorization. |
AT_BLE_MTU_CHANGED_INDICATION |
peer sends an indication of the new MTU.
|
AT_BLE_MTU_CHANGED_CMD_COMPLETE |
MTU Exchange completed.
|
AT_BLE_CHARACTERISTIC_WRITE_CMD_CMP |
write command complete.
|
AT_BLE_READ_AUTHORIZE_REQUEST |
The peer asks for a read Authorization.
|
AT_BLE_LECB_CONN_REQ |
Connection request is received from server.
|
AT_BLE_LECB_CONNECTED |
Peer connected successfully.
|
AT_BLE_LECB_DISCONNECTED |
Peer disconnected.
|
AT_BLE_LECB_ADD_CREDIT_IND |
Indication when peer device added credit.
|
AT_BLE_LECB_SEND_RESP |
Response from local device to data send command.
|
AT_BLE_LECB_DATA_RECIEVED |
Data received from peer device.
|
AT_BLE_HTPT_CREATE_DB_CFM |
Inform APP of database creation status.
|
AT_BLE_HTPT_ERROR_IND |
Error indication to APP.
|
AT_BLE_HTPT_DISABLE_IND |
Automatically sent to the APP after a disconnection with the peer device to confirm disabled profile.
|
AT_BLE_HTPT_TEMP_SEND_CFM |
Temperature value confirm to APP.
|
AT_BLE_HTPT_MEAS_INTV_CHG_IND |
Inform APP of new measurement interval value.
|
AT_BLE_HTPT_CFG_INDNTF_IND |
Inform APP of new configuration value.
|
AT_BLE_HTPT_ENABLE_RSP |
HTPT profile enable confirmation.
|
AT_BLE_HTPT_MEAS_INTV_UPD_RSP |
Response to APP for measurement interval update request.
|
AT_BLE_HTPT_MEAS_INTV_CHG_REQ |
Inform APP of new measurement interval value requested by a peer device.
|
AT_BLE_LE_TEST_STATUS |
inform app about DTM command test status Refer to at_ble_dtm_t |
AT_BLE_LE_PACKET_REPORT |
inform app about the RX packets report Refer to at_ble_dtm_t |
AT_BLE_CUSTOM_EVENT |
A user-defined event is delivered to the system. |
AT_BLE_DEVICE_READY | |
AT_BLE_DEVICE_DEAD |
inform app that device is dead, the application should start again from at_ble_init |
AT_BLE_DEVICE_OUT_OF_SYNC |
inform app that device was out of sync, last messages (one or more) sent from host to BTLC1000 has been discarded |
AT_BLE_EVENT_MAX |
enum at_ble_filter_type_t |
Advertising Filter Policy.
enum at_ble_gpio_pin_t |
Initialization Configuration parameters.
Enumerator | |
---|---|
AT_BLE_CHIP_ENABLE |
Used to identify chip enable pin to be set or cleared using at_ble_gpio_status_t. |
AT_BLE_EXTERNAL_WAKEUP |
Used to identify external wakeup pin to be set or cleared using at_ble_gpio_status_t. |
enum at_ble_gpio_status_t |
HTPT Database Configuration Flags.
enum at_ble_htpt_ntfind |
Service Security Level.
Temperature Type Description.
enum at_ble_iocab_t |
a device IO capabilities
enum at_ble_key_dis_t |
enum at_ble_lecb_status |
LE Credit based connection status codes.
enum at_ble_multi_inst |
enum at_ble_operation |
request operation type - application interface
Pairing Key Type.
Enumerator | |
---|---|
AT_BLE_PAIR_PASSKEY |
A passkey is required at_ble_passkey_type_t for more details. |
AT_BLE_PAIR_OOB |
Out of band key is required. |
enum at_ble_parameters_t |
Enumeration for GAP Parameters.
enum at_ble_scan_mode_t |
Scan modes used at at_ble_scan_start.
Enumerator | |
---|---|
AT_BLE_SCAN_GEN_DISCOVERY |
Send advertising report about device that advertise in limited or general mode ,the operation stops after 10 sec of activity. |
AT_BLE_SCAN_LIM_DISCOVERY |
Send advertising report about device that advertise in limited mode ,the operation stops after 10 sec of activity. |
AT_BLE_SCAN_OBSERVER_MODE |
Send any advertising report ,this operation can only be stopped by at_ble_scan_stop. |
enum at_ble_scan_type_t |
Scan types used at at_ble_scan_start.
Enumerator | |
---|---|
AT_BLE_SCAN_PASSIVE |
No SCAN_REQ packets shall be sent. |
AT_BLE_SCAN_ACTIVE |
SCAN_REQ packets may be sent. |
TX Power levels.
enum at_ble_uuid_type_t |
enum btlc1000_gpio_tag |
enum dtm_op_codes |
GAPC Retrieve information command request type.
at_ble_status_t at_ble_descriptor_value_get | ( | at_ble_handle_t | handle, |
uint8_t * | value, | ||
uint16_t * | len | ||
) |
Reads A Descriptor value.
[in] | handle | Characteristic value handle |
[out] | value | read value will be returned here |
[out] | len | actual read length, in bytes |
Referenced by hid_get_reportchar(), and hid_get_reportid().
at_ble_status_t at_ble_descriptor_value_set | ( | at_ble_handle_t | handle, |
uint8_t * | value, | ||
uint16_t | len | ||
) |
Sets A characteristic value.
[in] | handle | Descriptor value handle |
[in] | value | new value |
[in] | len | Value length, in bytes |
Referenced by hid_service_dbreg().
at_ble_status_t at_ble_htpt_meas_intv_chg_cfm | ( | at_ble_handle_t | conn_handle, |
at_ble_status_t | status | ||
) |
This message is used by application to confirm that measurement interval modification is accepted or not by the application.Write confirmation is sent back to peer devices that requests modification and if accepted, all other devices connected which have configured to receive measurement interval change indication will be informed about this modification.
[in] | conn_handle | Connection handle |
[in] | status | operation status code |
at_ble_status_t at_ble_set_ulp_delay | ( | at_ble_ulp_delay_t | arg | ) |
at_ble_uuid_type_t at_ble_uuid_len2type | ( | uint8_t | len | ) |
uint8_t at_ble_uuid_type2len | ( | at_ble_uuid_type_t | type | ) |