1 // SPDX-License-Identifier: LGPL-2.1-or-later
4 * BlueZ - Bluetooth protocol stack for Linux
6 * Copyright (C) 2011-2014 Intel Corporation
7 * Copyright (C) 2002-2010 Marcel Holtmann <marcel@holtmann.org>
19 #include "src/shared/util.h"
25 #define COLOR_OPCODE COLOR_MAGENTA
26 #define COLOR_OPCODE_UNKNOWN COLOR_WHITE_BG
28 static const char *get_opcode_str(uint16_t opcode);
30 static void print_opcode(uint16_t opcode)
34 str = get_opcode_str(opcode);
39 print_field("Operation: %s (%u/%u)", str,
40 opcode >> 8, opcode & 0xff);
42 print_field("Operation: %s (%u)", str, opcode);
45 static void name_req(const void *data, uint8_t size)
47 const struct bt_lmp_name_req *pdu = data;
49 print_field("Offset: %u", pdu->offset);
52 static void name_rsp(const void *data, uint8_t size)
54 const struct bt_lmp_name_rsp *pdu = data;
57 memcpy(str, pdu->fragment, 14);
60 print_field("Offset: %u", pdu->offset);
61 print_field("Length: %u", pdu->length);
62 print_field("Fragment: %s", str);
65 static void accepted(const void *data, uint8_t size)
67 const struct bt_lmp_accepted *pdu = data;
69 print_opcode(pdu->opcode);
72 static void not_accepted(const void *data, uint8_t size)
74 const struct bt_lmp_not_accepted *pdu = data;
76 print_opcode(pdu->opcode);
77 packet_print_error("Error code", pdu->error);
80 static void clkoffset_req(const void *data, uint8_t size)
84 static void clkoffset_rsp(const void *data, uint8_t size)
86 const struct bt_lmp_clkoffset_rsp *pdu = data;
88 print_field("Clock offset: 0x%4.4x", le16_to_cpu(pdu->offset));
91 static void detach(const void *data, uint8_t size)
93 const struct bt_lmp_detach *pdu = data;
95 packet_print_error("Error code", pdu->error);
98 static void au_rand(const void *data, uint8_t size)
100 const struct bt_lmp_au_rand *pdu = data;
102 packet_hexdump(pdu->number, 16);
105 static void sres(const void *data, uint8_t size)
107 const struct bt_lmp_sres *pdu = data;
109 packet_hexdump(pdu->response, 4);
112 static void encryption_mode_req(const void *data, uint8_t size)
114 const struct bt_lmp_encryption_mode_req *pdu = data;
119 str = "No encryption";
132 print_field("Mode: %s (%u)", str, pdu->mode);
135 static void encryption_key_size_req(const void *data, uint8_t size)
137 const struct bt_lmp_encryption_key_size_req *pdu = data;
139 print_field("Key size: %u", pdu->key_size);
142 static void start_encryption_req(const void *data, uint8_t size)
144 const struct bt_lmp_start_encryption_req *pdu = data;
146 packet_hexdump(pdu->number, 16);
149 static void stop_encryption_req(const void *data, uint8_t size)
153 static void switch_req(const void *data, uint8_t size)
155 const struct bt_lmp_switch_req *pdu = data;
157 print_field("Instant: 0x%8.8x", le32_to_cpu(pdu->instant));
160 static void unsniff_req(const void *data, uint8_t size)
164 static void max_power(const void *data, uint8_t size)
168 static void min_power(const void *data, uint8_t size)
172 static void auto_rate(const void *data, uint8_t size)
176 static void preferred_rate(const void *data, uint8_t size)
178 const struct bt_lmp_preferred_rate *pdu = data;
181 str = (pdu->rate & 0x01) ? "do not use FEC" : "use FEC";
183 print_field("Basic data rate: %s (0x%02x)", str, pdu->rate & 0x01);
185 switch ((pdu->rate & 0x06) >> 1) {
187 str = "No packet-size preference available";
190 str = "use 1-slot packets";
193 str = "use 3-slot packets";
196 str = "use 5-slot packets";
200 print_field("Basic data rate: %s (0x%02x)", str, pdu->rate & 0x06);
202 switch ((pdu->rate & 0x11) >> 3) {
204 str = "use DM1 packets";
207 str = "use 2 Mb/s packets";
210 str = "use 3 MB/s packets";
217 print_field("Enhanced data rate: %s (0x%2.2x)", str, pdu->rate & 0x11);
219 switch ((pdu->rate & 0x60) >> 5) {
221 str = "No packet-size preference available";
224 str = "use 1-slot packets";
227 str = "use 3-slot packets";
230 str = "use 5-slot packets";
234 print_field("Enhanced data rate: %s (0x%2.2x)", str, pdu->rate & 0x60);
237 static void version_req(const void *data, uint8_t size)
239 const struct bt_lmp_version_req *pdu = data;
241 packet_print_version("Version", pdu->version,
242 "Subversion", le16_to_cpu(pdu->subversion));
243 packet_print_company("Company", le16_to_cpu(pdu->company));
246 static void version_res(const void *data, uint8_t size)
248 const struct bt_lmp_version_res *pdu = data;
250 packet_print_version("Version", pdu->version,
251 "Subversion", le16_to_cpu(pdu->subversion));
252 packet_print_company("Company", le16_to_cpu(pdu->company));
255 static void features_req(const void *data, uint8_t size)
257 const struct bt_lmp_features_req *pdu = data;
259 packet_print_features_lmp(pdu->features, 0x00);
262 static void features_res(const void *data, uint8_t size)
264 const struct bt_lmp_features_res *pdu = data;
266 packet_print_features_lmp(pdu->features, 0x00);
269 static void max_slot(const void *data, uint8_t size)
271 const struct bt_lmp_max_slot *pdu = data;
273 print_field("Slots: 0x%4.4x", pdu->slots);
276 static void max_slot_req(const void *data, uint8_t size)
278 const struct bt_lmp_max_slot_req *pdu = data;
280 print_field("Slots: 0x%4.4x", pdu->slots);
283 static void timing_accuracy_req(const void *data, uint8_t size)
287 static void timing_accuracy_res(const void *data, uint8_t size)
289 const struct bt_lmp_timing_accuracy_res *pdu = data;
291 print_field("Drift: %u ppm", pdu->drift);
292 print_field("Jitter: %u usec", pdu->jitter);
295 static void setup_complete(const void *data, uint8_t size)
299 static void use_semi_permanent_key(const void *data, uint8_t size)
303 static void host_connection_req(const void *data, uint8_t size)
307 static void slot_offset(const void *data, uint8_t size)
309 const struct bt_lmp_slot_offset *pdu = data;
311 print_field("Offset: %u usec", le16_to_cpu(pdu->offset));
312 packet_print_addr("Address", pdu->bdaddr, 0x00);
315 static void page_scan_mode_req(const void *data, uint8_t size)
317 const struct bt_lmp_page_scan_mode_req *pdu = data;
320 switch (pdu->scheme) {
329 print_field("Paging scheme: %s (%u)", str, pdu->scheme);
331 if (pdu->scheme == 0x00) {
332 switch (pdu->settings) {
349 print_field("Paging scheme settings: %s (%u)", str, pdu->settings);
352 static void test_activate(const void *data, uint8_t size)
356 static void encryption_key_size_mask_req(const void *data, uint8_t size)
360 static void set_afh(const void *data, uint8_t size)
362 const struct bt_lmp_set_afh *pdu = data;
365 print_field("Instant: %u", le32_to_cpu(pdu->instant));
379 print_field("Mode: %s (0x%2.2x)", str, pdu->mode);
380 packet_print_channel_map_lmp(pdu->map);
383 static void encapsulated_header(const void *data, uint8_t size)
385 const struct bt_lmp_encapsulated_header *pdu = data;
388 print_field("Major type: %u", pdu->major);
389 print_field("Minor type: %u", pdu->minor);
391 if (pdu->major == 0x01) {
392 switch (pdu->minor) {
394 str = "P-192 Public Key";
397 str = "P-256 Public Key";
404 print_field(" %s", str);
407 print_field("Length: %u", pdu->length);
410 static void encapsulated_payload(const void *data, uint8_t size)
412 const struct bt_lmp_encapsulated_payload *pdu = data;
414 packet_hexdump(pdu->data, 16);
417 static void simple_pairing_confirm(const void *data, uint8_t size)
419 const struct bt_lmp_simple_pairing_confirm *pdu = data;
421 packet_hexdump(pdu->value, 16);
424 static void simple_pairing_number(const void *data, uint8_t size)
426 const struct bt_lmp_simple_pairing_number *pdu = data;
428 packet_hexdump(pdu->value, 16);
431 static void dhkey_check(const void *data, uint8_t size)
433 const struct bt_lmp_dhkey_check *pdu = data;
435 packet_hexdump(pdu->value, 16);
438 static void accepted_ext(const void *data, uint8_t size)
440 const struct bt_lmp_accepted_ext *pdu = data;
443 switch (pdu->escape) {
445 opcode = LMP_ESC4(pdu->opcode);
451 print_opcode(opcode);
454 static void not_accepted_ext(const void *data, uint8_t size)
456 const struct bt_lmp_not_accepted_ext *pdu = data;
459 switch (pdu->escape) {
461 opcode = LMP_ESC4(pdu->opcode);
467 print_opcode(opcode);
468 print_field("Error code: %u", pdu->error);
471 static void features_req_ext(const void *data, uint8_t size)
473 const struct bt_lmp_features_req_ext *pdu = data;
475 print_field("Features page: %u", pdu->page);
476 print_field("Max supported page: %u", pdu->max_page);
477 packet_print_features_lmp(pdu->features, pdu->page);
480 static void features_res_ext(const void *data, uint8_t size)
482 const struct bt_lmp_features_res_ext *pdu = data;
484 print_field("Features page: %u", pdu->page);
485 print_field("Max supported page: %u", pdu->max_page);
486 packet_print_features_lmp(pdu->features, pdu->page);
489 static void packet_type_table_req(const void *data, uint8_t size)
491 const struct bt_lmp_packet_type_table_req *pdu = data;
494 switch (pdu->table) {
506 print_field("Table: %s (0x%2.2x)", str, pdu->table);
509 static void channel_classification_req(const void *data, uint8_t size)
511 const struct bt_lmp_channel_classification_req *pdu = data;
526 print_field("Reporting mode: %s (0x%2.2x)", str, pdu->mode);
527 print_field("Min interval: 0x%2.2x", pdu->min_interval);
528 print_field("Max interval: 0x%2.2x", pdu->max_interval);
531 static void channel_classification(const void *data, uint8_t size)
533 const struct bt_lmp_channel_classification *pdu = data;
537 for (i = 0; i < 10; i++)
538 sprintf(str + (i * 2), "%2.2x", pdu->classification[i]);
540 print_field("Classification: 0x%s", str);
543 static void pause_encryption_req(const void *data, uint8_t size)
547 static void resume_encryption_req(const void *data, uint8_t size)
551 static void io_capability_req(const void *data, uint8_t size)
553 const struct bt_lmp_io_capability_req *pdu = data;
556 packet_print_io_capability(pdu->capability);
558 switch (pdu->oob_data) {
560 str = "No authentication data received";
563 str = "Authentication data received";
570 print_field("OOB data: %s (0x%2.2x)", str, pdu->oob_data);
572 packet_print_io_authentication(pdu->authentication);
575 static void io_capability_res(const void *data, uint8_t size)
577 const struct bt_lmp_io_capability_res *pdu = data;
580 packet_print_io_capability(pdu->capability);
582 switch (pdu->oob_data) {
584 str = "No authentication data received";
587 str = "Authentication data received";
594 print_field("OOB data: %s (0x%2.2x)", str, pdu->oob_data);
596 packet_print_io_authentication(pdu->authentication);
599 static void numeric_comparison_failed(const void *data, uint8_t size)
603 static void passkey_failed(const void *data, uint8_t size)
607 static void oob_failed(const void *data, uint8_t size)
611 static void power_control_req(const void *data, uint8_t size)
613 const struct bt_lmp_power_control_req *pdu = data;
616 switch (pdu->request) {
618 str = "Decrement power one step";
621 str = "Increment power one step";
624 str = "Increase to maximum power";
631 print_field("Request: %s (0x%2.2x)", str, pdu->request);
634 static void power_control_res(const void *data, uint8_t size)
636 const struct bt_lmp_power_control_res *pdu = data;
639 print_field("Response: 0x%2.2x", pdu->response);
641 switch (pdu->response & 0x03) {
643 str = "Not supported";
646 str = "Changed one step";
659 print_field(" GFSK: %s", str);
661 switch ((pdu->response & 0x0c) >> 2) {
663 str = "Not supported";
666 str = "Changed one step";
679 print_field(" DQPSK: %s", str);
681 switch ((pdu->response & 0x30) >> 4) {
683 str = "Not supported";
686 str = "Changed one step";
699 print_field(" 8DPSK: %s", str);
702 static void ping_req(const void *data, uint8_t size)
706 static void ping_res(const void *data, uint8_t size)
713 void (*func) (const void *data, uint8_t size);
718 static const struct lmp_data lmp_table[] = {
719 { 1, "LMP_name_req", name_req, 1, true },
720 { 2, "LMP_name_res", name_rsp, 16, true },
721 { 3, "LMP_accepted", accepted, 1, true },
722 { 4, "LMP_not_accepted", not_accepted, 2, true },
723 { 5, "LMP_clkoffset_req", clkoffset_req, 0, true },
724 { 6, "LMP_clkoffset_res", clkoffset_rsp, 2, true },
725 { 7, "LMP_detach", detach, 1, true },
726 { 8, "LMP_in_rand" },
727 { 9, "LMP_comb_key" },
728 { 10, "LMP_unit_key" },
729 { 11, "LMP_au_rand", au_rand, 16, true },
730 { 12, "LMP_sres", sres, 4, true },
731 { 13, "LMP_temp_rand" },
732 { 14, "LMP_temp_key" },
733 { 15, "LMP_encryption_mode_req", encryption_mode_req, 1, true },
734 { 16, "LMP_encryption_key_size_req", encryption_key_size_req, 1, true },
735 { 17, "LMP_start_encryption_req", start_encryption_req, 16, true },
736 { 18, "LMP_stop_encryption_req", stop_encryption_req, 0, true },
737 { 19, "LMP_switch_req", switch_req, 4, true },
739 { 21, "LMP_hold_req" },
741 { 23, "LMP_sniff_req" },
742 { 24, "LMP_unsniff_req", unsniff_req, 0, true },
743 { 25, "LMP_park_req" },
745 { 27, "LMP_set_broadcast_scan_window" },
746 { 28, "LMP_modify_beacon" },
747 { 29, "LMP_unpark_BD_ADDR_req" },
748 { 30, "LMP_unpark_PM_ADDR_req" },
749 { 31, "LMP_incr_power_req" },
750 { 32, "LMP_decr_power_req" },
751 { 33, "LMP_max_power", max_power, 0, true },
752 { 34, "LMP_min_power", min_power, 0, true },
753 { 35, "LMP_auto_rate", auto_rate, 0, true },
754 { 36, "LMP_preferred_rate", preferred_rate, 1, true },
755 { 37, "LMP_version_req", version_req, 5, true },
756 { 38, "LMP_version_res", version_res, 5, true },
757 { 39, "LMP_features_req", features_req, 8, true },
758 { 40, "LMP_features_res", features_res, 8, true },
759 { 41, "LMP_quality_of_service" },
760 { 42, "LMP_quality_of_service_req" },
761 { 43, "LMP_SCO_link_req" },
762 { 44, "LMP_remove_SCO_link_req" },
763 { 45, "LMP_max_slot", max_slot, 1, true },
764 { 46, "LMP_max_slot_req", max_slot_req, 1, true },
765 { 47, "LMP_timing_accuracy_req", timing_accuracy_req, 0, true },
766 { 48, "LMP_timing_accuracy_res", timing_accuracy_res, 2, true },
767 { 49, "LMP_setup_complete", setup_complete, 0, true },
768 { 50, "LMP_use_semi_permanent_key", use_semi_permanent_key, 0, true },
769 { 51, "LMP_host_connection_req", host_connection_req, 0, true },
770 { 52, "LMP_slot_offset", slot_offset, 8, true },
771 { 53, "LMP_page_mode_req" },
772 { 54, "LMP_page_scan_mode_req", page_scan_mode_req, 2, true },
773 { 55, "LMP_supervision_timeout" },
774 { 56, "LMP_test_activate", test_activate, 0, true },
775 { 57, "LMP_test_control" },
776 { 58, "LMP_encryption_key_size_mask_req", encryption_key_size_mask_req, 0, true },
777 { 59, "LMP_encryption_key_size_mask_res" },
778 { 60, "LMP_set_AFH", set_afh, 15, true },
779 { 61, "LMP_encapsulated_header", encapsulated_header, 3, true },
780 { 62, "LMP_encapsulated_payload", encapsulated_payload, 16, true },
781 { 63, "LMP_simple_pairing_confirm", simple_pairing_confirm, 16, true },
782 { 64, "LMP_simple_pairing_number", simple_pairing_number, 16, true },
783 { 65, "LMP_DHkey_check", dhkey_check, 16, true },
784 { 66, "LMP_pause_encryption_aes_req" },
785 { LMP_ESC4(1), "LMP_accepted_ext", accepted_ext, 2, true },
786 { LMP_ESC4(2), "LMP_not_accepted_ext", not_accepted_ext, 3, true },
787 { LMP_ESC4(3), "LMP_features_req_ext", features_req_ext, 10, true },
788 { LMP_ESC4(4), "LMP_features_res_ext", features_res_ext, 10, true },
789 { LMP_ESC4(5), "LMP_clk_adj" },
790 { LMP_ESC4(6), "LMP_clk_adj_ack" },
791 { LMP_ESC4(7), "LMP_clk_adj_req" },
792 { LMP_ESC4(11), "LMP_packet_type_table_req", packet_type_table_req, 1, true },
793 { LMP_ESC4(12), "LMP_eSCO_link_req" },
794 { LMP_ESC4(13), "LMP_remove_eSCO_link_req" },
795 { LMP_ESC4(16), "LMP_channel_classification_req", channel_classification_req, 5, true },
796 { LMP_ESC4(17), "LMP_channel_classification", channel_classification, 10, true },
797 { LMP_ESC4(21), "LMP_sniff_subrating_req" },
798 { LMP_ESC4(22), "LMP_sniff_subrating_res" },
799 { LMP_ESC4(23), "LMP_pause_encryption_req", pause_encryption_req, 0, true },
800 { LMP_ESC4(24), "LMP_resume_encryption_req", resume_encryption_req, 0, true },
801 { LMP_ESC4(25), "LMP_IO_capability_req", io_capability_req, 3, true },
802 { LMP_ESC4(26), "LMP_IO_capability_res", io_capability_res, 3, true },
803 { LMP_ESC4(27), "LMP_numeric_comparison_failed", numeric_comparison_failed, 0, true },
804 { LMP_ESC4(28), "LMP_passkey_failed", passkey_failed, 0, true },
805 { LMP_ESC4(29), "LMP_oob_failed", oob_failed, 0, true },
806 { LMP_ESC4(30), "LMP_keypress_notification" },
807 { LMP_ESC4(31), "LMP_power_control_req", power_control_req, 1, true },
808 { LMP_ESC4(32), "LMP_power_control_res", power_control_res, 1, true },
809 { LMP_ESC4(33), "LMP_ping_req", ping_req, 0, true },
810 { LMP_ESC4(34), "LMP_ping_res", ping_res, 0, true },
811 { LMP_ESC4(35), "LMP_SAM_set_type0" },
812 { LMP_ESC4(36), "LMP_SAM_define_map" },
813 { LMP_ESC4(37), "LMP_SAM_switch" },
817 static const char *get_opcode_str(uint16_t opcode)
821 for (i = 0; lmp_table[i].str; i++) {
822 if (lmp_table[i].opcode == opcode)
823 return lmp_table[i].str;
829 void lmp_packet(const void *data, uint8_t size, bool padded)
831 const struct lmp_data *lmp_data = NULL;
832 const char *opcode_color, *opcode_str;
838 tid = ((const uint8_t *) data)[0] & 0x01;
839 opcode = (((const uint8_t *) data)[0] & 0xfe) >> 1;
841 tid_str = tid == 0x00 ? "Central" : "Peripheral";
846 print_text(COLOR_ERROR, "extended opcode too short");
847 packet_hexdump(data, size);
850 opcode = LMP_ESC4(((const uint8_t *) data)[1]);
862 for (i = 0; lmp_table[i].str; i++) {
863 if (lmp_table[i].opcode == opcode) {
864 lmp_data = &lmp_table[i];
871 opcode_color = COLOR_OPCODE;
873 opcode_color = COLOR_OPCODE_UNKNOWN;
874 opcode_str = lmp_data->str;
876 opcode_color = COLOR_OPCODE_UNKNOWN;
877 opcode_str = "Unknown";
881 print_indent(6, opcode_color, "", opcode_str, COLOR_OFF,
882 " (%u/%u) %s transaction (%u)",
883 opcode >> 8, opcode & 0xff, tid_str, tid);
885 print_indent(6, opcode_color, "", opcode_str, COLOR_OFF,
886 " (%u) %s transaction (%d)",
887 opcode, tid_str, tid);
889 if (!lmp_data || !lmp_data->func) {
890 packet_hexdump(data + off, size - off);
894 if (lmp_data->fixed && !padded) {
895 if (size - off != lmp_data->size) {
896 print_text(COLOR_ERROR, "invalid packet size");
897 packet_hexdump(data + off, size - off);
901 if (size - off < lmp_data->size) {
902 print_text(COLOR_ERROR, "too short packet");
903 packet_hexdump(data + off, size - off);
908 lmp_data->func(data + off, size - off);
915 printf("LMP operations with missing decodings:\n");
917 for (i = 0; lmp_table[i].str; i++) {
918 if (lmp_table[i].func)
921 printf("\t%s\n", lmp_table[i].str);