xref: /btstack/example/sm_pairing_peripheral.c (revision 80e33422a96c028b3a9c308fc4b9b874712dafb4)
1 /*
2  * Copyright (C) 2014 BlueKitchen GmbH
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  *
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  * 3. Neither the name of the copyright holders nor the names of
14  *    contributors may be used to endorse or promote products derived
15  *    from this software without specific prior written permission.
16  * 4. Any redistribution, use, or modification is done solely for
17  *    personal benefit and not for any commercial purpose or for
18  *    monetary gain.
19  *
20  * THIS SOFTWARE IS PROVIDED BY BLUEKITCHEN GMBH AND CONTRIBUTORS
21  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
22  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
23  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL MATTHIAS
24  * RINGWALD OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
25  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
26  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
27  * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
28  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
29  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
30  * THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31  * SUCH DAMAGE.
32  *
33  * Please inquire about commercial licensing options at
34  * [email protected]
35  *
36  */
37 
38 #define __BTSTACK_FILE__ "sm_pairing_peripheral.c"
39 
40 // *****************************************************************************
41 /* EXAMPLE_START(sm_pairing_peripheral): LE Peripheral - Test pairing combinations
42  *
43  * @text Depending on the Authentication requiremens and IO Capabilities,
44  * the pairing process uses different short and long term key generation method.
45  * This example helps explore the different options incl. LE Secure Connections.
46  */
47  // *****************************************************************************
48 
49 #include <stdint.h>
50 #include <stdio.h>
51 #include <stdlib.h>
52 #include <string.h>
53 #include <inttypes.h>
54 
55 #include "sm_pairing_peripheral.h"
56 #include "btstack.h"
57 
58 /* @section Main Application Setup
59  *
60  * @text Listing MainConfiguration shows main application code.
61  * It initializes L2CAP, the Security Manager and configures the ATT Server with the pre-compiled
62  * ATT Database generated from $sm_pairing_peripheral.gatt$. Finally, it configures the advertisements
63  * and boots the Bluetooth stack.
64  * In this example, the Advertisement contains the Flags attribute, the device name, and a 16-bit (test) service 0x1111
65  * The flag 0x06 indicates: LE General Discoverable Mode and BR/EDR not supported.
66  * Various examples for IO Capabilites and Authentication Requirements are given below.
67  */
68 
69 /* LISTING_START(MainConfiguration): Setup stack to advertise */
70 static btstack_packet_callback_registration_t sm_event_callback_registration;
71 
72 static void packet_handler (uint8_t packet_type, uint16_t channel, uint8_t *packet, uint16_t size);
73 
74 const uint8_t adv_data[] = {
75     // Flags general discoverable, BR/EDR not supported
76     0x02, BLUETOOTH_DATA_TYPE_FLAGS, 0x06,
77     // Name
78     0x0b, BLUETOOTH_DATA_TYPE_COMPLETE_LOCAL_NAME, 'S', 'M', ' ', 'P', 'a', 'i', 'r', 'i', 'n', 'g',
79     // Incomplete List of 16-bit Service Class UUIDs -- 1111 - only valid for testing!
80     0x03, BLUETOOTH_DATA_TYPE_INCOMPLETE_LIST_OF_16_BIT_SERVICE_CLASS_UUIDS, 0x11, 0x11,
81 };
82 const uint8_t adv_data_len = sizeof(adv_data);
83 
84 static void sm_peripheral_setup(void){
85 
86     l2cap_init();
87 
88     // setup le device db
89     le_device_db_init();
90 
91     // setup SM: Display only
92     sm_init();
93 
94     /**
95      * Choose ONE of the following configurations
96      * Bonding is disabled to allow for repeated testing. It can be enabled with SM_AUTHREQ_BONDING
97      */
98 
99     // LE Legacy Pairing, Just Works
100     // sm_set_io_capabilities(IO_CAPABILITY_NO_INPUT_NO_OUTPUT);
101     // sm_set_authentication_requirements(SM_AUTHREQ_BONDING);
102 
103     // LE Legacy Pairing, Passkey entry initiator enter, responder (us) displays
104     // sm_set_io_capabilities(IO_CAPABILITY_DISPLAY_ONLY);
105     // sm_set_authentication_requirements(SM_AUTHREQ_MITM_PROTECTION);
106     // sm_use_fixed_passkey_in_display_role(123456);
107 
108 #ifdef ENABLE_LE_SECURE_CONNECTIONS
109     // LE Secure Connetions, Just Works
110     // sm_set_io_capabilities(IO_CAPABILITY_DISPLAY_YES_NO);
111     // sm_set_authentication_requirements(SM_AUTHREQ_SECURE_CONNECTION);
112 
113     // LE Secure Connections, Numeric Comparison
114     sm_set_io_capabilities(IO_CAPABILITY_DISPLAY_ONLY);
115     sm_set_authentication_requirements(SM_AUTHREQ_SECURE_CONNECTION|SM_AUTHREQ_MITM_PROTECTION);
116 
117     // LE Legacy Pairing, Passkey entry initiator enter, responder (us) displays
118     // sm_set_io_capabilities(IO_CAPABILITY_DISPLAY_ONLY);
119     // sm_set_authentication_requirements(SM_AUTHREQ_SECURE_CONNECTION|SM_AUTHREQ_MITM_PROTECTION);
120     // sm_use_fixed_passkey_in_display_role(123456);
121 #endif
122 
123     // setup ATT server
124     att_server_init(profile_data, NULL, NULL);
125 
126     // setup advertisements
127     uint16_t adv_int_min = 0x0030;
128     uint16_t adv_int_max = 0x0030;
129     uint8_t adv_type = 0;
130     bd_addr_t null_addr;
131     memset(null_addr, 0, 6);
132     gap_advertisements_set_params(adv_int_min, adv_int_max, adv_type, 0, null_addr, 0x07, 0x00);
133     gap_advertisements_set_data(adv_data_len, (uint8_t*) adv_data);
134     gap_advertisements_enable(1);
135 
136     // register for SM events
137     sm_event_callback_registration.callback = &packet_handler;
138     sm_add_event_handler(&sm_event_callback_registration);
139 
140     // register for ATT
141     att_server_register_packet_handler(packet_handler);
142 }
143 
144 /* LISTING_END */
145 
146 /*
147  * @section Packet Handler
148  *
149  * @text The packet handler is used to:
150  *        - report connect/disconnect
151  *        - handle Security Manager events
152  */
153 
154 /* LISTING_START(packetHandler): Packet Handler */
155 static void packet_handler (uint8_t packet_type, uint16_t channel, uint8_t *packet, uint16_t size){
156     UNUSED(channel);
157     UNUSED(size);
158     hci_con_handle_t con_handle;
159     bd_addr_t addr;
160     switch (packet_type) {
161         case HCI_EVENT_PACKET:
162             switch (hci_event_packet_get_type(packet)) {
163                 case HCI_EVENT_LE_META:
164                     switch (hci_event_le_meta_get_subevent_code(packet)) {
165                         case HCI_SUBEVENT_LE_CONNECTION_COMPLETE:
166                             // setup new
167                         printf("Connection complete\n");
168                             con_handle = hci_subevent_le_connection_complete_get_connection_handle(packet);
169                             sm_send_security_request(con_handle);
170                             break;
171                         default:
172                             break;
173                     }
174                     break;
175                 case SM_EVENT_JUST_WORKS_REQUEST:
176                     printf("Just Works requested\n");
177                     sm_just_works_confirm(sm_event_just_works_request_get_handle(packet));
178                     break;
179                 case SM_EVENT_NUMERIC_COMPARISON_REQUEST:
180                     printf("Confirming numeric comparison: %"PRIu32"\n", sm_event_numeric_comparison_request_get_passkey(packet));
181                     sm_numeric_comparison_confirm(sm_event_passkey_display_number_get_handle(packet));
182                     break;
183                 case SM_EVENT_PASSKEY_DISPLAY_NUMBER:
184                     printf("Display Passkey: %"PRIu32"\n", sm_event_passkey_display_number_get_passkey(packet));
185                     break;
186                 case SM_EVENT_IDENTITY_CREATED:
187                     sm_event_identity_created_get_identity_address(packet, addr);
188                     printf("Identity created: type %u address %s\n", sm_event_identity_created_get_identity_addr_type(packet), bd_addr_to_str(addr));
189                     break;
190                 case SM_EVENT_IDENTITY_RESOLVING_SUCCEEDED:
191                     sm_event_identity_resolving_succeeded_get_identity_address(packet, addr);
192                     printf("Identity resolved: type %u address %s\n", sm_event_identity_resolving_succeeded_get_identity_addr_type(packet), bd_addr_to_str(addr));
193                     break;
194                 case SM_EVENT_IDENTITY_RESOLVING_FAILED:
195                     sm_event_identity_created_get_address(packet, addr);
196                     printf("Identity resolving failed\n");
197                     break;
198                 case SM_EVENT_PAIRING_COMPLETE:
199                     switch (sm_event_pairing_complete_get_status(packet)){
200                         case ERROR_CODE_SUCCESS:
201                             printf("Pairing complete, success\n");
202                             break;
203                         case ERROR_CODE_CONNECTION_TIMEOUT:
204                             printf("Pairing failed, timeout\n");
205                             break;
206                         case ERROR_CODE_REMOTE_USER_TERMINATED_CONNECTION:
207                             printf("Pairing faileed, disconnected\n");
208                             break;
209                         case ERROR_CODE_AUTHENTICATION_FAILURE:
210                             printf("Pairing failed, reason = %u\n", sm_event_pairing_complete_get_reason(packet));
211                             break;
212                         default:
213                             break;
214                     }
215                     break;
216                 default:
217                     break;
218         }
219         break;
220     }
221 }
222 /* LISTING_END */
223 
224 int btstack_main(void);
225 int btstack_main(void)
226 {
227     sm_peripheral_setup();
228 
229     // turn on!
230 	hci_power_control(HCI_POWER_ON);
231 
232     return 0;
233 }
234 /* EXAMPLE_END */
235