xref: /btstack/src/hci.c (revision 94ab26f8d119a3bda5c373a8c9b3b6e636c2e919)
11f504dbdSmatthias.ringwald /*
21f504dbdSmatthias.ringwald  *  hci.c
31f504dbdSmatthias.ringwald  *
41f504dbdSmatthias.ringwald  *  Created by Matthias Ringwald on 4/29/09.
51f504dbdSmatthias.ringwald  *
61f504dbdSmatthias.ringwald  */
71f504dbdSmatthias.ringwald 
8475c8125Smatthias.ringwald #include <unistd.h>
993b8dc03Smatthias.ringwald #include <stdarg.h>
1093b8dc03Smatthias.ringwald #include <string.h>
1156fe0872Smatthias.ringwald #include <stdio.h>
121f504dbdSmatthias.ringwald #include "hci.h"
131f504dbdSmatthias.ringwald 
140a974e0cSmatthias.ringwald // calculate combined ogf/ocf value
150a974e0cSmatthias.ringwald #define OPCODE(ogf, ocf) (ocf | ogf << 10)
1602ea9861Smatthias.ringwald #define OGF_LINK_CONTROL 0x01
1702ea9861Smatthias.ringwald #define OGF_CONTROLLER_BASEBAND 0x03
1893b8dc03Smatthias.ringwald 
1993b8dc03Smatthias.ringwald hci_cmd_t hci_inquiry = {
203091b266Smatthias.ringwald     OPCODE(OGF_LINK_CONTROL, 0x01), "311"
213091b266Smatthias.ringwald     // LAP, Inquiry length, Num_responses
223091b266Smatthias.ringwald };
233091b266Smatthias.ringwald 
243091b266Smatthias.ringwald hci_cmd_t hci_link_key_request_negative_reply = {
253091b266Smatthias.ringwald     OPCODE(OGF_LINK_CONTROL, 0x0c), "B"
263091b266Smatthias.ringwald };
273091b266Smatthias.ringwald 
283091b266Smatthias.ringwald hci_cmd_t hci_pin_code_request_reply = {
293091b266Smatthias.ringwald     OPCODE(OGF_LINK_CONTROL, 0x0d), "B1P"
303091b266Smatthias.ringwald     // BD_ADDR, pin length, PIN: c-string
3193b8dc03Smatthias.ringwald };
3293b8dc03Smatthias.ringwald 
3393b8dc03Smatthias.ringwald hci_cmd_t hci_reset = {
3402ea9861Smatthias.ringwald     OPCODE(OGF_CONTROLLER_BASEBAND, 0x03), ""
3502ea9861Smatthias.ringwald };
3602ea9861Smatthias.ringwald 
3702ea9861Smatthias.ringwald hci_cmd_t hci_create_connection = {
3802ea9861Smatthias.ringwald     OPCODE(OGF_LINK_CONTROL, 0x05), "B21121"
3902ea9861Smatthias.ringwald     // BD_ADDR, Packet_Type, Page_Scan_Repetition_Mode, Reserved, Clock_Offset, Allow_Role_Switch
4002ea9861Smatthias.ringwald };
4102ea9861Smatthias.ringwald 
4202ea9861Smatthias.ringwald hci_cmd_t hci_write_page_timeout = {
4302ea9861Smatthias.ringwald     OPCODE(OGF_CONTROLLER_BASEBAND, 0x18), "2"
4402ea9861Smatthias.ringwald     // Page_Timeout * 0.625 ms
4502ea9861Smatthias.ringwald };
4602ea9861Smatthias.ringwald 
473091b266Smatthias.ringwald hci_cmd_t hci_write_authentication_enable = {
483091b266Smatthias.ringwald     OPCODE(OGF_CONTROLLER_BASEBAND, 0x20), "1"
493091b266Smatthias.ringwald     // Authentication_Enable
503091b266Smatthias.ringwald };
513091b266Smatthias.ringwald 
5202ea9861Smatthias.ringwald hci_cmd_t hci_host_buffer_size = {
5302ea9861Smatthias.ringwald     OPCODE(OGF_CONTROLLER_BASEBAND, 0x33), "2122"
5402ea9861Smatthias.ringwald     // Host_ACL_Data_Packet_Length:, Host_Synchronous_Data_Packet_Length:, Host_Total_Num_ACL_Data_Packets:, Host_Total_Num_Synchronous_Data_Packets:
5593b8dc03Smatthias.ringwald };
5693b8dc03Smatthias.ringwald 
5793b8dc03Smatthias.ringwald 
5816833f0aSmatthias.ringwald // the stack is here
5916833f0aSmatthias.ringwald static hci_stack_t       hci_stack;
6016833f0aSmatthias.ringwald 
61475c8125Smatthias.ringwald 
6243625864Smatthias.ringwald void bt_store_16(uint8_t *buffer, uint16_t pos, uint16_t value){
638b658ebcSmatthias.ringwald     buffer[pos++] = value;
648b658ebcSmatthias.ringwald     buffer[pos++] = value >> 8;
658b658ebcSmatthias.ringwald }
668b658ebcSmatthias.ringwald 
678b658ebcSmatthias.ringwald void bt_store_32(uint8_t *buffer, uint16_t pos, uint32_t value){
688b658ebcSmatthias.ringwald     buffer[pos++] = value;
698b658ebcSmatthias.ringwald     buffer[pos++] = value >> 8;
708b658ebcSmatthias.ringwald     buffer[pos++] = value >> 16;
718b658ebcSmatthias.ringwald     buffer[pos++] = value >> 24;
7243625864Smatthias.ringwald }
7343625864Smatthias.ringwald 
741281a47eSmatthias.ringwald void bt_flip_addr(bd_addr_t dest, bd_addr_t src){
751281a47eSmatthias.ringwald     dest[0] = src[5];
761281a47eSmatthias.ringwald     dest[1] = src[4];
771281a47eSmatthias.ringwald     dest[2] = src[3];
781281a47eSmatthias.ringwald     dest[3] = src[2];
791281a47eSmatthias.ringwald     dest[4] = src[1];
801281a47eSmatthias.ringwald     dest[5] = src[0];
811281a47eSmatthias.ringwald }
821281a47eSmatthias.ringwald 
8302582713Smatthias.ringwald void hexdump(void *data, int size){
8456fe0872Smatthias.ringwald     int i;
8556fe0872Smatthias.ringwald     for (i=0; i<size;i++){
8602582713Smatthias.ringwald         printf("%02X ", ((uint8_t *)data)[i]);
8756fe0872Smatthias.ringwald     }
8856fe0872Smatthias.ringwald     printf("\n");
8956fe0872Smatthias.ringwald }
9056fe0872Smatthias.ringwald 
9156fe0872Smatthias.ringwald #if 0
9256fe0872Smatthias.ringwald static void *hci_daemon_thread(void *arg){
9356fe0872Smatthias.ringwald     printf("HCI Daemon started\n");
9456fe0872Smatthias.ringwald     hci_run(transport, &config);
9556fe0872Smatthias.ringwald     return NULL;
9656fe0872Smatthias.ringwald }
9756fe0872Smatthias.ringwald #endif
9856fe0872Smatthias.ringwald 
9916833f0aSmatthias.ringwald /**
10097addcc5Smatthias.ringwald  * Linked link list
10197addcc5Smatthias.ringwald  */
10297addcc5Smatthias.ringwald 
10397addcc5Smatthias.ringwald /**
10497addcc5Smatthias.ringwald  * get link for given address
10597addcc5Smatthias.ringwald  *
10697addcc5Smatthias.ringwald  * @return connection OR NULL, if not found
10797addcc5Smatthias.ringwald  */
108145be03fSmatthias.ringwald #if 0
10997addcc5Smatthias.ringwald static hci_connection_t *link_for_addr(bd_addr_t addr){
11097addcc5Smatthias.ringwald     return NULL;
11197addcc5Smatthias.ringwald }
112145be03fSmatthias.ringwald #endif
11397addcc5Smatthias.ringwald 
11497addcc5Smatthias.ringwald /**
11516833f0aSmatthias.ringwald  * Handler called by HCI transport
11616833f0aSmatthias.ringwald  */
11716833f0aSmatthias.ringwald static void dummy_handler(uint8_t *packet, int size){
11816833f0aSmatthias.ringwald }
11916833f0aSmatthias.ringwald 
12016833f0aSmatthias.ringwald static void acl_handler(uint8_t *packet, int size){
12116833f0aSmatthias.ringwald     hci_stack.acl_packet_handler(packet, size);
122*94ab26f8Smatthias.ringwald 
123*94ab26f8Smatthias.ringwald     // execute main loop
124*94ab26f8Smatthias.ringwald     hci_run();
12516833f0aSmatthias.ringwald }
12622909952Smatthias.ringwald 
12716833f0aSmatthias.ringwald static void event_handler(uint8_t *packet, int size){
1281281a47eSmatthias.ringwald     bd_addr_t addr;
12922909952Smatthias.ringwald 
1303429f56bSmatthias.ringwald     // Get Num_HCI_Command_Packets
1313429f56bSmatthias.ringwald     if (packet[0] == HCI_EVENT_COMMAND_COMPLETE ||
1323429f56bSmatthias.ringwald         packet[0] == HCI_EVENT_COMMAND_STATUS){
1333429f56bSmatthias.ringwald         hci_stack.num_cmd_packets = packet[2];
13422909952Smatthias.ringwald     }
13522909952Smatthias.ringwald 
1363429f56bSmatthias.ringwald     // handle BT initialization
1373429f56bSmatthias.ringwald     if (hci_stack.state == HCI_STATE_INITIALIZING){
1387301ad89Smatthias.ringwald         // handle H4 synchronization loss on restart
1397301ad89Smatthias.ringwald         // if (hci_stack.substate == 1 && packet[0] == HCI_EVENT_HARDWARE_ERROR){
1407301ad89Smatthias.ringwald         //    hci_stack.substate = 0;
1417301ad89Smatthias.ringwald         // }
1427301ad89Smatthias.ringwald         // handle normal init sequence
1433429f56bSmatthias.ringwald         if (hci_stack.substate % 2){
1443429f56bSmatthias.ringwald             // odd: waiting for event
1453429f56bSmatthias.ringwald             if (packet[0] == HCI_EVENT_COMMAND_COMPLETE){
1463429f56bSmatthias.ringwald                 hci_stack.substate++;
1473429f56bSmatthias.ringwald             }
1483429f56bSmatthias.ringwald         }
14922909952Smatthias.ringwald     }
15022909952Smatthias.ringwald 
1511281a47eSmatthias.ringwald     // link key request
1523429f56bSmatthias.ringwald     if (packet[0] == HCI_EVENT_LINK_KEY_REQUEST){
1531281a47eSmatthias.ringwald         bt_flip_addr(addr, &packet[2]);
1541281a47eSmatthias.ringwald         hci_send_cmd(&hci_link_key_request_negative_reply, &addr);
1551281a47eSmatthias.ringwald         return;
1561281a47eSmatthias.ringwald     }
1571281a47eSmatthias.ringwald 
1581281a47eSmatthias.ringwald     // pin code request
1593429f56bSmatthias.ringwald     if (packet[0] == HCI_EVENT_PIN_CODE_REQUEST){
1601281a47eSmatthias.ringwald         bt_flip_addr(addr, &packet[2]);
1611281a47eSmatthias.ringwald         hci_send_cmd(&hci_pin_code_request_reply, &addr, 4, "1234");
1621281a47eSmatthias.ringwald     }
1631281a47eSmatthias.ringwald 
16416833f0aSmatthias.ringwald     hci_stack.event_packet_handler(packet, size);
165*94ab26f8Smatthias.ringwald 
166*94ab26f8Smatthias.ringwald 	// execute main loop
167*94ab26f8Smatthias.ringwald 	hci_run();
16816833f0aSmatthias.ringwald }
16916833f0aSmatthias.ringwald 
17016833f0aSmatthias.ringwald /** Register L2CAP handlers */
17116833f0aSmatthias.ringwald void hci_register_event_packet_handler(void (*handler)(uint8_t *packet, int size)){
17216833f0aSmatthias.ringwald     hci_stack.event_packet_handler = handler;
17316833f0aSmatthias.ringwald }
17416833f0aSmatthias.ringwald void hci_register_acl_packet_handler  (void (*handler)(uint8_t *packet, int size)){
17516833f0aSmatthias.ringwald     hci_stack.acl_packet_handler = handler;
17616833f0aSmatthias.ringwald }
17716833f0aSmatthias.ringwald 
1787301ad89Smatthias.ringwald static int null_control_function(void *config){
1797301ad89Smatthias.ringwald     return 0;
1807301ad89Smatthias.ringwald }
1817301ad89Smatthias.ringwald static const char * null_control_name(void *config){
1827301ad89Smatthias.ringwald     return "Hardware unknown";
1837301ad89Smatthias.ringwald }
1847301ad89Smatthias.ringwald 
1857301ad89Smatthias.ringwald static bt_control_t null_control = {
1867301ad89Smatthias.ringwald     null_control_function,
1877301ad89Smatthias.ringwald     null_control_function,
1887301ad89Smatthias.ringwald     null_control_function,
1897301ad89Smatthias.ringwald     null_control_name
1907301ad89Smatthias.ringwald };
1917301ad89Smatthias.ringwald 
19211e23e5fSmatthias.ringwald void hci_init(hci_transport_t *transport, void *config, bt_control_t *control){
193475c8125Smatthias.ringwald 
194475c8125Smatthias.ringwald     // reference to use transport layer implementation
19516833f0aSmatthias.ringwald     hci_stack.hci_transport = transport;
196475c8125Smatthias.ringwald 
19711e23e5fSmatthias.ringwald     // references to used control implementation
1987301ad89Smatthias.ringwald     if (control) {
19911e23e5fSmatthias.ringwald         hci_stack.control = control;
2007301ad89Smatthias.ringwald     } else {
2017301ad89Smatthias.ringwald         hci_stack.control = &null_control;
2027301ad89Smatthias.ringwald     }
20311e23e5fSmatthias.ringwald 
20411e23e5fSmatthias.ringwald     // reference to used config
20511e23e5fSmatthias.ringwald     hci_stack.config = config;
20611e23e5fSmatthias.ringwald 
20702ea9861Smatthias.ringwald     // empty cmd buffer
20816833f0aSmatthias.ringwald     hci_stack.hci_cmd_buffer = malloc(3+255);
20916833f0aSmatthias.ringwald 
21016833f0aSmatthias.ringwald     // higher level handler
21116833f0aSmatthias.ringwald     hci_stack.event_packet_handler = dummy_handler;
21216833f0aSmatthias.ringwald     hci_stack.acl_packet_handler = dummy_handler;
21316833f0aSmatthias.ringwald 
21416833f0aSmatthias.ringwald     // register packet handlers with transport
21516833f0aSmatthias.ringwald     transport->register_event_packet_handler( event_handler);
21616833f0aSmatthias.ringwald     transport->register_acl_packet_handler( acl_handler);
21716833f0aSmatthias.ringwald 
2188cbb57e6Smatthias.ringwald     // turn on
2198cbb57e6Smatthias.ringwald     hci_power_control(HCI_POWER_ON);
220475c8125Smatthias.ringwald }
221475c8125Smatthias.ringwald 
222475c8125Smatthias.ringwald int hci_power_control(HCI_POWER_MODE power_mode){
22311e23e5fSmatthias.ringwald     if (power_mode == HCI_POWER_ON) {
2247301ad89Smatthias.ringwald 
2257301ad89Smatthias.ringwald         // set up state machine
2267301ad89Smatthias.ringwald         hci_stack.num_cmd_packets = 1; // assume that one cmd can be sent
2277301ad89Smatthias.ringwald         hci_stack.state = HCI_STATE_INITIALIZING;
2287301ad89Smatthias.ringwald         hci_stack.substate = 0;
2297301ad89Smatthias.ringwald 
2307301ad89Smatthias.ringwald         // power on
23111e23e5fSmatthias.ringwald         hci_stack.control->on(hci_stack.config);
2327301ad89Smatthias.ringwald 
2337301ad89Smatthias.ringwald         // open low-level device
2347301ad89Smatthias.ringwald         hci_stack.hci_transport->open(hci_stack.config);
2357301ad89Smatthias.ringwald 
23611e23e5fSmatthias.ringwald     } else if (power_mode == HCI_POWER_OFF){
2377301ad89Smatthias.ringwald 
2387301ad89Smatthias.ringwald         // close low-level device
2397301ad89Smatthias.ringwald         hci_stack.hci_transport->close(hci_stack.config);
2407301ad89Smatthias.ringwald 
2417301ad89Smatthias.ringwald         // power off
24211e23e5fSmatthias.ringwald         hci_stack.control->off(hci_stack.config);
24311e23e5fSmatthias.ringwald     }
244475c8125Smatthias.ringwald     return 0;
245475c8125Smatthias.ringwald }
246475c8125Smatthias.ringwald 
2473429f56bSmatthias.ringwald uint32_t hci_run(){
2483429f56bSmatthias.ringwald     uint8_t micro_packet;
2493429f56bSmatthias.ringwald     switch (hci_stack.state){
2503429f56bSmatthias.ringwald         case HCI_STATE_INITIALIZING:
2513429f56bSmatthias.ringwald             if (hci_stack.substate % 2) {
2523429f56bSmatthias.ringwald                 // odd: waiting for command completion
2533429f56bSmatthias.ringwald                 return 0;
2543429f56bSmatthias.ringwald             }
2553429f56bSmatthias.ringwald             if (hci_stack.num_cmd_packets == 0) {
2563429f56bSmatthias.ringwald                 // cannot send command yet
2573429f56bSmatthias.ringwald                 return 0;
2583429f56bSmatthias.ringwald             }
2593429f56bSmatthias.ringwald             switch (hci_stack.substate/2){
2603429f56bSmatthias.ringwald                 case 0:
26122909952Smatthias.ringwald                     hci_send_cmd(&hci_reset);
2623429f56bSmatthias.ringwald                     break;
2633429f56bSmatthias.ringwald                 case 1:
2643429f56bSmatthias.ringwald                     // ca. 15 sec
2653429f56bSmatthias.ringwald                     hci_send_cmd(&hci_write_page_timeout, 0x6000);
2663429f56bSmatthias.ringwald                     break;
2673429f56bSmatthias.ringwald                 case 2:
2683429f56bSmatthias.ringwald                     // done.
2693429f56bSmatthias.ringwald                     hci_stack.state = HCI_STATE_WORKING;
2703429f56bSmatthias.ringwald                     micro_packet = BTSTACK_EVENT_HCI_WORKING;
2713429f56bSmatthias.ringwald                     hci_stack.event_packet_handler(&micro_packet, 1);
2723429f56bSmatthias.ringwald                     break;
2733429f56bSmatthias.ringwald                 default:
2743429f56bSmatthias.ringwald                     break;
275475c8125Smatthias.ringwald             }
2763429f56bSmatthias.ringwald             hci_stack.substate++;
2773429f56bSmatthias.ringwald             break;
2783429f56bSmatthias.ringwald         default:
2793429f56bSmatthias.ringwald             break;
2801f504dbdSmatthias.ringwald     }
28193b8dc03Smatthias.ringwald 
2823429f56bSmatthias.ringwald     // don't check for timetous yet
2833429f56bSmatthias.ringwald     return 0;
2843429f56bSmatthias.ringwald }
28516833f0aSmatthias.ringwald 
28616833f0aSmatthias.ringwald 
28743625864Smatthias.ringwald int hci_send_acl_packet(uint8_t *packet, int size){
28816833f0aSmatthias.ringwald     return hci_stack.hci_transport->send_acl_packet(packet, size);
28943625864Smatthias.ringwald }
29043625864Smatthias.ringwald 
2913429f56bSmatthias.ringwald 
2923429f56bSmatthias.ringwald /**
2933429f56bSmatthias.ringwald  * pre: numcmds >= 0 - it's allowed to send a command to the controller
2943429f56bSmatthias.ringwald  */
29502ea9861Smatthias.ringwald int hci_send_cmd(hci_cmd_t *cmd, ...){
29616833f0aSmatthias.ringwald     uint8_t * hci_cmd_buffer = hci_stack.hci_cmd_buffer;
29702ea9861Smatthias.ringwald     hci_cmd_buffer[0] = cmd->opcode & 0xff;
29802ea9861Smatthias.ringwald     hci_cmd_buffer[1] = cmd->opcode >> 8;
29993b8dc03Smatthias.ringwald     int pos = 3;
30093b8dc03Smatthias.ringwald 
30193b8dc03Smatthias.ringwald     va_list argptr;
30293b8dc03Smatthias.ringwald     va_start(argptr, cmd);
30393b8dc03Smatthias.ringwald     const char *format = cmd->format;
30493b8dc03Smatthias.ringwald     uint16_t word;
30593b8dc03Smatthias.ringwald     uint32_t longword;
3063091b266Smatthias.ringwald     uint8_t * ptr;
30793b8dc03Smatthias.ringwald     while (*format) {
30893b8dc03Smatthias.ringwald         switch(*format) {
30993b8dc03Smatthias.ringwald             case '1': //  8 bit value
31093b8dc03Smatthias.ringwald             case '2': // 16 bit value
31193b8dc03Smatthias.ringwald             case 'H': // hci_handle
312554588a5Smatthias.ringwald                 word = va_arg(argptr, int);  // minimal va_arg is int: 2 bytes on 8+16 bit CPUs
31302ea9861Smatthias.ringwald                 hci_cmd_buffer[pos++] = word & 0xff;
31493b8dc03Smatthias.ringwald                 if (*format == '2') {
31502ea9861Smatthias.ringwald                     hci_cmd_buffer[pos++] = word >> 8;
31693b8dc03Smatthias.ringwald                 } else if (*format == 'H') {
317554588a5Smatthias.ringwald                     // TODO
31893b8dc03Smatthias.ringwald                 }
31993b8dc03Smatthias.ringwald                 break;
32093b8dc03Smatthias.ringwald             case '3':
32193b8dc03Smatthias.ringwald             case '4':
32293b8dc03Smatthias.ringwald                 longword = va_arg(argptr, uint32_t);
32393b8dc03Smatthias.ringwald                 // longword = va_arg(argptr, int);
32402ea9861Smatthias.ringwald                 hci_cmd_buffer[pos++] = longword;
32502ea9861Smatthias.ringwald                 hci_cmd_buffer[pos++] = longword >> 8;
32602ea9861Smatthias.ringwald                 hci_cmd_buffer[pos++] = longword >> 16;
32793b8dc03Smatthias.ringwald                 if (*format == '4'){
32802ea9861Smatthias.ringwald                     hci_cmd_buffer[pos++] = longword >> 24;
32993b8dc03Smatthias.ringwald                 }
33093b8dc03Smatthias.ringwald                 break;
33193b8dc03Smatthias.ringwald             case 'B': // bt-addr
3323091b266Smatthias.ringwald                 ptr = va_arg(argptr, uint8_t *);
3333091b266Smatthias.ringwald                 hci_cmd_buffer[pos++] = ptr[5];
3343091b266Smatthias.ringwald                 hci_cmd_buffer[pos++] = ptr[4];
3353091b266Smatthias.ringwald                 hci_cmd_buffer[pos++] = ptr[3];
3363091b266Smatthias.ringwald                 hci_cmd_buffer[pos++] = ptr[2];
3373091b266Smatthias.ringwald                 hci_cmd_buffer[pos++] = ptr[1];
3383091b266Smatthias.ringwald                 hci_cmd_buffer[pos++] = ptr[0];
3393091b266Smatthias.ringwald                 break;
3403091b266Smatthias.ringwald             case 'P': // c string passed as pascal string with leading 1-byte len
3413091b266Smatthias.ringwald                 ptr = va_arg(argptr, uint8_t *);
3423091b266Smatthias.ringwald                 memcpy(&hci_cmd_buffer[pos], ptr, 16);
3433091b266Smatthias.ringwald                 pos += 16;
34493b8dc03Smatthias.ringwald                 break;
34593b8dc03Smatthias.ringwald             default:
34693b8dc03Smatthias.ringwald                 break;
34793b8dc03Smatthias.ringwald         }
34893b8dc03Smatthias.ringwald         format++;
34993b8dc03Smatthias.ringwald     };
35093b8dc03Smatthias.ringwald     va_end(argptr);
35102ea9861Smatthias.ringwald     hci_cmd_buffer[2] = pos - 3;
35202ea9861Smatthias.ringwald     // send packet
3533429f56bSmatthias.ringwald     hci_stack.num_cmd_packets--;
35416833f0aSmatthias.ringwald     return hci_stack.hci_transport->send_cmd_packet(hci_cmd_buffer, pos);
35593b8dc03Smatthias.ringwald }