/* * Copyright (C) 2014 BlueKitchen GmbH * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * 3. Neither the name of the copyright holders nor the names of * contributors may be used to endorse or promote products derived * from this software without specific prior written permission. * 4. Any redistribution, use, or modification is done solely for * personal benefit and not for any commercial purpose or for * monetary gain. * * THIS SOFTWARE IS PROVIDED BY BLUEKITCHEN GMBH AND CONTRIBUTORS * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL BLUEKITCHEN * GMBH OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF * THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF * SUCH DAMAGE. * * Please inquire about commercial licensing options at * contact@bluekitchen-gmbh.com * */ #define BTSTACK_FILE__ "gatt_counter.c" // ***************************************************************************** /* EXAMPLE_START(gatt_counter): GATT Server - Heartbeat Counter over GATT * * @text All newer operating systems provide GATT Client functionality. * The LE Counter examples demonstrates how to specify a minimal GATT Database * with a custom GATT Service and a custom Characteristic that sends periodic * notifications. */ // ***************************************************************************** #include #include #include #include #include "gatt_counter.h" #include "btstack.h" #include "ble/gatt-service/battery_service_server.h" #define HEARTBEAT_PERIOD_MS 1000 /* @section Main Application Setup * * @text Listing MainConfiguration shows main application code. * It initializes L2CAP, the Security Manager and configures the ATT Server with the pre-compiled * ATT Database generated from $le_counter.gatt$. * Additionally, it enables the Battery Service Server with the current battery level. * Finally, it configures the advertisements * and the heartbeat handler and boots the Bluetooth stack. * In this example, the Advertisement contains the Flags attribute and the device name. * The flag 0x06 indicates: LE General Discoverable Mode and BR/EDR not supported. */ /* LISTING_START(MainConfiguration): Init L2CAP SM ATT Server and start heartbeat timer */ static int le_notification_enabled; static btstack_timer_source_t heartbeat; static btstack_packet_callback_registration_t hci_event_callback_registration; static hci_con_handle_t con_handle; static uint8_t battery = 100; #ifdef ENABLE_GATT_OVER_CLASSIC static uint8_t gatt_service_buffer[70]; #endif static void packet_handler (uint8_t packet_type, uint16_t channel, uint8_t *packet, uint16_t size); static uint16_t att_read_callback(hci_con_handle_t con_handle, uint16_t att_handle, uint16_t offset, uint8_t * buffer, uint16_t buffer_size); static int att_write_callback(hci_con_handle_t con_handle, uint16_t att_handle, uint16_t transaction_mode, uint16_t offset, uint8_t *buffer, uint16_t buffer_size); static void heartbeat_handler(struct btstack_timer_source *ts); static void beat(void); // Flags general discoverable, BR/EDR supported (== not supported flag not set) when ENABLE_GATT_OVER_CLASSIC is enabled #ifdef ENABLE_GATT_OVER_CLASSIC #define APP_AD_FLAGS 0x02 #else #define APP_AD_FLAGS 0x06 #endif const uint8_t adv_data[] = { // Flags general discoverable 0x02, BLUETOOTH_DATA_TYPE_FLAGS, APP_AD_FLAGS, // Name 0x0b, BLUETOOTH_DATA_TYPE_COMPLETE_LOCAL_NAME, 'L', 'E', ' ', 'C', 'o', 'u', 'n', 't', 'e', 'r', // Incomplete List of 16-bit Service Class UUIDs -- FF10 - only valid for testing! 0x03, BLUETOOTH_DATA_TYPE_INCOMPLETE_LIST_OF_16_BIT_SERVICE_CLASS_UUIDS, 0x10, 0xff, }; const uint8_t adv_data_len = sizeof(adv_data); static void le_counter_setup(void){ l2cap_init(); // setup SM: Display only sm_init(); #ifdef ENABLE_GATT_OVER_CLASSIC // init SDP, create record for GATT and register with SDP sdp_init(); memset(gatt_service_buffer, 0, sizeof(gatt_service_buffer)); gatt_create_sdp_record(gatt_service_buffer, sdp_create_service_record_handle(), ATT_SERVICE_GATT_SERVICE_START_HANDLE, ATT_SERVICE_GATT_SERVICE_END_HANDLE); btstack_assert(de_get_len( gatt_service_buffer) <= sizeof(gatt_service_buffer)); sdp_register_service(gatt_service_buffer); // configure Classic GAP gap_set_local_name("GATT Counter BR/EDR 00:00:00:00:00:00"); gap_ssp_set_io_capability(SSP_IO_CAPABILITY_DISPLAY_YES_NO); gap_discoverable_control(1); #endif // setup ATT server att_server_init(profile_data, att_read_callback, att_write_callback); // setup battery service battery_service_server_init(battery); // setup advertisements uint16_t adv_int_min = 0x0030; uint16_t adv_int_max = 0x0030; uint8_t adv_type = 0; bd_addr_t null_addr; memset(null_addr, 0, 6); gap_advertisements_set_params(adv_int_min, adv_int_max, adv_type, 0, null_addr, 0x07, 0x00); gap_advertisements_set_data(adv_data_len, (uint8_t*) adv_data); gap_advertisements_enable(1); // register for HCI events hci_event_callback_registration.callback = &packet_handler; hci_add_event_handler(&hci_event_callback_registration); // register for ATT event att_server_register_packet_handler(packet_handler); // set one-shot timer heartbeat.process = &heartbeat_handler; btstack_run_loop_set_timer(&heartbeat, HEARTBEAT_PERIOD_MS); btstack_run_loop_add_timer(&heartbeat); // beat once beat(); } /* LISTING_END */ /* * @section Heartbeat Handler * * @text The heartbeat handler updates the value of the single Characteristic provided in this example, * and request a ATT_EVENT_CAN_SEND_NOW to send a notification if enabled see Listing heartbeat. */ /* LISTING_START(heartbeat): Hearbeat Handler */ static int counter = 0; static char counter_string[30]; static int counter_string_len; static void beat(void){ counter++; counter_string_len = snprintf(counter_string, sizeof(counter_string), "BTstack counter %04u", counter); puts(counter_string); } static void heartbeat_handler(struct btstack_timer_source *ts){ if (le_notification_enabled) { beat(); att_server_request_can_send_now_event(con_handle); } // simulate battery drain battery--; if (battery < 50) { battery = 100; } battery_service_server_set_battery_value(battery); btstack_run_loop_set_timer(ts, HEARTBEAT_PERIOD_MS); btstack_run_loop_add_timer(ts); } /* LISTING_END */ /* * @section Packet Handler * * @text The packet handler is used to: * - stop the counter after a disconnect * - send a notification when the requested ATT_EVENT_CAN_SEND_NOW is received */ /* LISTING_START(packetHandler): Packet Handler */ static void packet_handler (uint8_t packet_type, uint16_t channel, uint8_t *packet, uint16_t size){ UNUSED(channel); UNUSED(size); if (packet_type != HCI_EVENT_PACKET) return; switch (hci_event_packet_get_type(packet)) { case HCI_EVENT_DISCONNECTION_COMPLETE: le_notification_enabled = 0; break; case ATT_EVENT_CAN_SEND_NOW: att_server_notify(con_handle, ATT_CHARACTERISTIC_0000FF11_0000_1000_8000_00805F9B34FB_01_VALUE_HANDLE, (uint8_t*) counter_string, counter_string_len); break; default: break; } } /* LISTING_END */ /* * @section ATT Read * * @text The ATT Server handles all reads to constant data. For dynamic data like the custom characteristic, the registered * att_read_callback is called. To handle long characteristics and long reads, the att_read_callback is first called * with buffer == NULL, to request the total value length. Then it will be called again requesting a chunk of the value. * See Listing attRead. */ /* LISTING_START(attRead): ATT Read */ // ATT Client Read Callback for Dynamic Data // - if buffer == NULL, don't copy data, just return size of value // - if buffer != NULL, copy data and return number bytes copied // @param offset defines start of attribute value static uint16_t att_read_callback(hci_con_handle_t connection_handle, uint16_t att_handle, uint16_t offset, uint8_t * buffer, uint16_t buffer_size){ UNUSED(connection_handle); if (att_handle == ATT_CHARACTERISTIC_0000FF11_0000_1000_8000_00805F9B34FB_01_VALUE_HANDLE){ return att_read_callback_handle_blob((const uint8_t *)counter_string, counter_string_len, offset, buffer, buffer_size); } return 0; } /* LISTING_END */ /* * @section ATT Write * * @text The only valid ATT writes in this example are to the Client Characteristic Configuration, which configures notification * and indication and to the the Characteristic Value. * If the ATT handle matches the client configuration handle, the new configuration value is stored and used * in the heartbeat handler to decide if a new value should be sent. * If the ATT handle matches the characteristic value handle, we print the write as hexdump * See Listing attWrite. */ /* LISTING_START(attWrite): ATT Write */ static int att_write_callback(hci_con_handle_t connection_handle, uint16_t att_handle, uint16_t transaction_mode, uint16_t offset, uint8_t *buffer, uint16_t buffer_size){ switch (att_handle){ case ATT_CHARACTERISTIC_0000FF11_0000_1000_8000_00805F9B34FB_01_CLIENT_CONFIGURATION_HANDLE: le_notification_enabled = little_endian_read_16(buffer, 0) == GATT_CLIENT_CHARACTERISTICS_CONFIGURATION_NOTIFICATION; con_handle = connection_handle; break; case ATT_CHARACTERISTIC_0000FF11_0000_1000_8000_00805F9B34FB_01_VALUE_HANDLE: printf("Write: transaction mode %u, offset %u, data (%u bytes): ", transaction_mode, offset, buffer_size); printf_hexdump(buffer, buffer_size); break; default: break; } return 0; } /* LISTING_END */ int btstack_main(void); int btstack_main(void) { le_counter_setup(); // turn on! hci_power_control(HCI_POWER_ON); return 0; } /* EXAMPLE_END */