/* * 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 MATTHIAS * RINGWALD 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__ "le_streamer.c" // ***************************************************************************** /* EXAMPLE_START(le_streamer): LE Streamer - Stream data over GATT. * * @text All newer operating systems provide GATT Client functionality. * This example shows how to get a maximal throughput via BLE: * - send whenever possible, * - use the max ATT MTU. * * @text In theory, we should also update the connection parameters, but we already get * a connection interval of 30 ms and there's no public way to use a shorter * interval with iOS (if we're not implementing an HID device). * * @text Note: To start the streaming, run the example. * On remote device use some GATT Explorer, e.g. LightBlue, BLExplr to enable notifications. */ // ***************************************************************************** #include #include #include #include #include "btstack.h" #include "le_streamer.h" #define REPORT_INTERVAL_MS 3000 #define MAX_NR_CONNECTIONS 3 static void packet_handler (uint8_t packet_type, uint16_t channel, uint8_t *packet, uint16_t 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 streamer(void); const uint8_t adv_data[] = { // Flags general discoverable, BR/EDR not supported 0x02, 0x01, 0x06, // Name 0x0c, 0x09, 'L', 'E', ' ', 'S', 't', 'r', 'e', 'a', 'm', 'e', 'r', }; const uint8_t adv_data_len = sizeof(adv_data); static btstack_packet_callback_registration_t hci_event_callback_registration; // support for multiple clients typedef struct { char name; int le_notification_enabled; hci_con_handle_t connection_handle; int counter; char test_data[200]; int test_data_len; uint32_t test_data_sent; uint32_t test_data_start; } le_streamer_connection_t; static le_streamer_connection_t le_streamer_connections[MAX_NR_CONNECTIONS]; // round robin sending static int connection_index; static void init_connections(void){ // track connections int i; for (i=0;itest_data_start = btstack_run_loop_get_time_ms(); context->test_data_sent = 0; } static void test_track_sent(le_streamer_connection_t * context, int bytes_sent){ context->test_data_sent += bytes_sent; // evaluate uint32_t now = btstack_run_loop_get_time_ms(); uint32_t time_passed = now - context->test_data_start; if (time_passed < REPORT_INTERVAL_MS) return; // print speed int bytes_per_second = context->test_data_sent * 1000 / time_passed; printf("%c: %u bytes sent-> %u.%03u kB/s\n", context->name, context->test_data_sent, bytes_per_second / 1000, bytes_per_second % 1000); // restart context->test_data_start = now; context->test_data_sent = 0; } /* LISTING_END(tracking): Tracking throughput */ /* * @section Packet Handler * * @text The packet handler is used to stop the notifications and reset the MTU on connect * It would also be a good place to request the connection parameter update as indicated * in the commented code block. */ /* 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); int mtu; uint16_t conn_interval; le_streamer_connection_t * context; switch (packet_type) { case HCI_EVENT_PACKET: switch (hci_event_packet_get_type(packet)) { case BTSTACK_EVENT_STATE: // BTstack activated, get started if (btstack_event_state_get_state(packet) == HCI_STATE_WORKING) { printf("To start the streaming, please run the le_streamer_client example on other device, or use some GATT Explorer, e.g. LightBlue, BLExplr.\n"); } break; case HCI_EVENT_DISCONNECTION_COMPLETE: context = connection_for_conn_handle(hci_event_disconnection_complete_get_connection_handle(packet)); if (!context) break; // free connection printf("%c: Disconnect, reason %02x\n", context->name, hci_event_disconnection_complete_get_reason(packet)); context->le_notification_enabled = 0; context->connection_handle = HCI_CON_HANDLE_INVALID; break; case HCI_EVENT_LE_META: switch (hci_event_le_meta_get_subevent_code(packet)) { case HCI_SUBEVENT_LE_CONNECTION_COMPLETE: // setup new context = connection_for_conn_handle(HCI_CON_HANDLE_INVALID); if (!context) break; context->counter = 'A'; context->test_data_len = ATT_DEFAULT_MTU - 3; context->connection_handle = hci_subevent_le_connection_complete_get_connection_handle(packet); // print connection parameters (without using float operations) conn_interval = hci_subevent_le_connection_complete_get_conn_interval(packet); printf("%c: Connection Interval: %u.%02u ms\n", context->name, conn_interval * 125 / 100, 25 * (conn_interval & 3)); printf("%c: Connection Latency: %u\n", context->name, hci_subevent_le_connection_complete_get_conn_latency(packet)); // min con interval 20 ms // gap_request_connection_parameter_update(connection_handle, 0x10, 0x18, 0, 0x0048); // printf("Connected, requesting conn param update for handle 0x%04x\n", connection_handle); break; } break; case ATT_EVENT_MTU_EXCHANGE_COMPLETE: mtu = att_event_mtu_exchange_complete_get_MTU(packet) - 3; context = connection_for_conn_handle(att_event_mtu_exchange_complete_get_handle(packet)); if (!context) break; context->test_data_len = btstack_min(mtu - 3, sizeof(context->test_data)); printf("%c: ATT MTU = %u => use test data of len %u\n", context->name, mtu, context->test_data_len); break; case ATT_EVENT_CAN_SEND_NOW: streamer(); break; } } } /* LISTING_END */ /* * @section Streamer * * @text The streamer function checks if notifications are enabled and if a notification can be sent now. * It creates some test data - a single letter that gets increased every time - and tracks the data sent. */ /* LISTING_START(streamer): Streaming code */ static void streamer(void){ // find next active streaming connection int old_connection_index = connection_index; while (1){ // active found? if ((le_streamer_connections[connection_index].connection_handle != HCI_CON_HANDLE_INVALID) && (le_streamer_connections[connection_index].le_notification_enabled)) break; // check next next_connection_index(); // none found if (connection_index == old_connection_index) return; } le_streamer_connection_t * context = &le_streamer_connections[connection_index]; // create test data context->counter++; if (context->counter > 'Z') context->counter = 'A'; memset(context->test_data, context->counter, context->test_data_len); // send att_server_notify(context->connection_handle, ATT_CHARACTERISTIC_0000FF11_0000_1000_8000_00805F9B34FB_01_VALUE_HANDLE, (uint8_t*) context->test_data, context->test_data_len); // track test_track_sent(context, context->test_data_len); // request next send event att_server_request_can_send_now_event(context->connection_handle); // check next next_connection_index(); } /* LISTING_END */ /* * @section ATT Write * * @text The only valid ATT write in this example is to the Client Characteristic Configuration, which configures notification * and indication. If the ATT handle matches the client configuration handle, the new configuration value is stored. * If notifications get enabled, an ATT_EVENT_CAN_SEND_NOW is requested. See Listing attWrite. */ /* LISTING_START(attWrite): ATT Write */ 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){ UNUSED(offset); // printf("att_write_callback att_handle %04x, transaction mode %u\n", att_handle, transaction_mode); if (transaction_mode != ATT_TRANSACTION_MODE_NONE) return 0; le_streamer_connection_t * context = connection_for_conn_handle(con_handle); switch(att_handle){ case ATT_CHARACTERISTIC_0000FF11_0000_1000_8000_00805F9B34FB_01_CLIENT_CONFIGURATION_HANDLE: context->le_notification_enabled = little_endian_read_16(buffer, 0) == GATT_CLIENT_CHARACTERISTICS_CONFIGURATION_NOTIFICATION; printf("%c: Notifications enabled %u\n", context->name, context->le_notification_enabled); if (context->le_notification_enabled){ att_server_request_can_send_now_event(context->connection_handle); } test_reset(context); break; case ATT_CHARACTERISTIC_0000FF12_0000_1000_8000_00805F9B34FB_01_VALUE_HANDLE: printf("%c: Write to ...FF12... : ", context->name); printf_hexdump(buffer, buffer_size); break; } return 0; } /* LISTING_END */ int btstack_main(void); int btstack_main(void) { le_streamer_setup(); // turn on! hci_power_control(HCI_POWER_ON); return 0; } /* EXAMPLE_END */