From aa342b3ed9fc00fdc577bbc14fa92fb010b37c48 Mon Sep 17 00:00:00 2001 From: Lauszus Date: Tue, 19 Jan 2021 21:36:49 +0000 Subject: [PATCH] deploy: 5af56accc32fa8959717853e6109f3f71a037ccf --- _b_t_d_8cpp_source.html | 2 +- _b_t_d_8h.html | 19 +- _b_t_d_8h__dep__incl.map | 19 +- _b_t_d_8h__dep__incl.md5 | 2 +- _b_t_d_8h__dep__incl.png | Bin 19106 -> 20754 bytes _b_t_d_8h_source.html | 2 +- _b_t_h_i_d_8cpp_source.html | 4 +- _b_t_h_i_d_8h.html | 3 +- _b_t_h_i_d_8h__dep__incl.map | 3 +- _b_t_h_i_d_8h__dep__incl.md5 | 2 +- _b_t_h_i_d_8h__dep__incl.png | Bin 6746 -> 7455 bytes _b_t_h_i_d_8h_source.html | 2 +- _p_s3_b_t_8cpp_source.html | 36 +- _p_s3_b_t_8h_source.html | 6 +- _p_s3_u_s_b_8cpp_source.html | 14 +- _p_s3_u_s_b_8h_source.html | 6 +- _p_s4_parser_8cpp.html | 28 +- _p_s4_parser_8cpp_source.html | 2 +- _p_s4_parser_8h_source.html | 20 +- _p_s5_b_t_8h.html | 149 + _p_s5_b_t_8h__incl.map | 11 + _p_s5_b_t_8h__incl.md5 | 1 + _p_s5_b_t_8h__incl.png | Bin 0 -> 30714 bytes _p_s5_b_t_8h_source.html | 114 + _p_s5_parser_8cpp.html | 177 ++ _p_s5_parser_8cpp__incl.map | 6 + _p_s5_parser_8cpp__incl.md5 | 1 + _p_s5_parser_8cpp__incl.png | Bin 0 -> 10854 bytes _p_s5_parser_8cpp_source.html | 126 + _p_s5_parser_8h.html | 145 + _p_s5_parser_8h__dep__incl.map | 5 + _p_s5_parser_8h__dep__incl.md5 | 1 + _p_s5_parser_8h__dep__incl.png | Bin 0 -> 5762 bytes _p_s5_parser_8h__incl.map | 5 + _p_s5_parser_8h__incl.md5 | 1 + _p_s5_parser_8h__incl.png | Bin 0 -> 9787 bytes _p_s5_parser_8h_source.html | 165 + _p_s5_trigger_8cpp.html | 100 + _p_s5_trigger_8cpp__incl.map | 3 + _p_s5_trigger_8cpp__incl.md5 | 1 + _p_s5_trigger_8cpp__incl.png | Bin 0 -> 5379 bytes _p_s5_trigger_8cpp_source.html | 77 + _p_s5_trigger_8h.html | 120 + _p_s5_trigger_8h__dep__incl.map | 7 + _p_s5_trigger_8h__dep__incl.md5 | 1 + _p_s5_trigger_8h__dep__incl.png | Bin 0 -> 10349 bytes _p_s5_trigger_8h__incl.map | 2 + _p_s5_trigger_8h__incl.md5 | 1 + _p_s5_trigger_8h__incl.png | Bin 0 -> 2986 bytes _p_s5_trigger_8h_source.html | 82 + _p_s5_u_s_b_8h.html | 142 + _p_s5_u_s_b_8h__incl.map | 10 + _p_s5_u_s_b_8h__incl.md5 | 1 + _p_s5_u_s_b_8h__incl.png | Bin 0 -> 25117 bytes _p_s5_u_s_b_8h_source.html | 116 + _p_s_buzz_8h_source.html | 4 +- _r_e_a_d_m_e_8md_source.html | 2 +- _usb_8cpp_source.html | 6 +- _usb_8h.html | 98 +- _usb_8h__dep__incl.map | 98 +- _usb_8h__dep__incl.md5 | 2 +- _usb_8h__dep__incl.png | Bin 155656 -> 157594 bytes _wii_8cpp_source.html | 10 +- _wii_8h_source.html | 2 +- _x_b_o_x_o_l_d_8cpp_source.html | 10 +- _x_b_o_x_o_l_d_8h_source.html | 2 +- _x_b_o_x_o_n_e_8cpp_source.html | 10 +- _x_b_o_x_o_n_e_8h_source.html | 2 +- _x_b_o_x_o_n_e_s_parser_8cpp.html | 28 +- _x_b_o_x_o_n_e_s_parser_8cpp_source.html | 2 +- _x_b_o_x_o_n_e_s_parser_8h_source.html | 2 +- _x_b_o_x_r_e_c_v_8cpp_source.html | 10 +- _x_b_o_x_r_e_c_v_8h_source.html | 2 +- _x_b_o_x_u_s_b_8cpp_source.html | 10 +- _x_b_o_x_u_s_b_8h_source.html | 2 +- annotated.html | 89 +- class_b_t_h_i_d.html | 15 +- class_b_t_h_i_d__coll__graph.md5 | 2 +- class_b_t_h_i_d__inherit__graph.map | 5 +- class_b_t_h_i_d__inherit__graph.md5 | 2 +- class_b_t_h_i_d__inherit__graph.png | Bin 6556 -> 8167 bytes class_bluetooth_service.html | 11 +- class_bluetooth_service__coll__graph.md5 | 2 +- class_bluetooth_service__inherit__graph.map | 11 +- class_bluetooth_service__inherit__graph.md5 | 2 +- class_bluetooth_service__inherit__graph.png | Bin 11182 -> 12702 bytes class_h_i_d_composite.html | 7 +- class_h_i_d_composite__coll__graph.md5 | 2 +- class_h_i_d_composite__inherit__graph.map | 5 +- class_h_i_d_composite__inherit__graph.md5 | 2 +- class_h_i_d_composite__inherit__graph.png | Bin 12378 -> 13591 bytes class_h_i_d_universal.html | 7 +- class_h_i_d_universal__coll__graph.md5 | 2 +- class_h_i_d_universal__inherit__graph.map | 5 +- class_h_i_d_universal__inherit__graph.md5 | 2 +- class_h_i_d_universal__inherit__graph.png | Bin 12365 -> 13573 bytes class_p_s5_b_t-members.html | 136 + class_p_s5_b_t.html | 478 +++ class_p_s5_b_t__coll__graph.map | 12 + class_p_s5_b_t__coll__graph.md5 | 1 + class_p_s5_b_t__coll__graph.png | Bin 0 -> 22955 bytes class_p_s5_b_t__inherit__graph.map | 5 + class_p_s5_b_t__inherit__graph.md5 | 1 + class_p_s5_b_t__inherit__graph.png | Bin 0 -> 7171 bytes class_p_s5_parser-members.html | 105 + class_p_s5_parser.html | 1062 +++++++ class_p_s5_parser__coll__graph.map | 3 + class_p_s5_parser__coll__graph.md5 | 1 + class_p_s5_parser__coll__graph.png | Bin 0 -> 3689 bytes class_p_s5_parser__inherit__graph.map | 4 + class_p_s5_parser__inherit__graph.md5 | 1 + class_p_s5_parser__inherit__graph.png | Bin 0 -> 3798 bytes class_p_s5_trigger-members.html | 84 + class_p_s5_trigger.html | 375 +++ class_p_s5_u_s_b-members.html | 163 + class_p_s5_u_s_b.html | 591 ++++ class_p_s5_u_s_b__coll__graph.map | 16 + class_p_s5_u_s_b__coll__graph.md5 | 1 + class_p_s5_u_s_b__coll__graph.png | Bin 0 -> 44442 bytes class_p_s5_u_s_b__inherit__graph.map | 8 + class_p_s5_u_s_b__inherit__graph.md5 | 1 + class_p_s5_u_s_b__inherit__graph.png | Bin 0 -> 14472 bytes class_u_s_b_device_config.html | 17 +- class_u_s_b_device_config__inherit__graph.map | 15 +- class_u_s_b_device_config__inherit__graph.md5 | 2 +- class_u_s_b_device_config__inherit__graph.png | Bin 45423 -> 46642 bytes class_u_s_b_h_i_d.html | 5 +- class_u_s_b_h_i_d__coll__graph.md5 | 2 +- class_u_s_b_h_i_d__inherit__graph.map | 5 +- class_u_s_b_h_i_d__inherit__graph.md5 | 2 +- class_u_s_b_h_i_d__inherit__graph.png | Bin 14836 -> 16205 bytes class_usb_config_xtracter.html | 7 +- class_usb_config_xtracter__inherit__graph.map | 7 +- class_usb_config_xtracter__inherit__graph.md5 | 2 +- class_usb_config_xtracter__inherit__graph.png | Bin 26265 -> 27897 bytes classes.html | 83 +- controller_enums_8h.html | 62 +- controller_enums_8h__dep__incl.map | 36 +- controller_enums_8h__dep__incl.md5 | 2 +- controller_enums_8h__dep__incl.png | Bin 45011 -> 48877 bytes controller_enums_8h_source.html | 64 +- files.html | 74 +- functions_a.html | 4 + functions_b.html | 5 +- functions_c.html | 15 +- functions_d.html | 8 + functions_f.html | 3 +- functions_func.html | 1 + functions_func_c.html | 7 +- functions_func_g.html | 12 + functions_func_i.html | 1 + functions_func_o.html | 2 + functions_func_p.html | 15 + functions_func_r.html | 5 +- functions_func_s.html | 33 +- functions_func_v.html | 1 + functions_func_w.html | 2 +- functions_g.html | 16 + functions_h.html | 4 + functions_i.html | 1 + functions_l.html | 6 + functions_m.html | 12 +- functions_o.html | 2 + functions_p.html | 19 + functions_r.html | 22 +- functions_s.html | 37 + functions_t.html | 6 +- functions_u.html | 1 + functions_v.html | 3 + functions_vars_a.html | 3 + functions_vars_b.html | 5 +- functions_vars_c.html | 8 +- functions_vars_d.html | 8 + functions_vars_f.html | 3 +- functions_vars_g.html | 4 + functions_vars_h.html | 4 + functions_vars_l.html | 6 + functions_vars_m.html | 8 +- functions_vars_p.html | 4 + functions_vars_r.html | 17 +- functions_vars_s.html | 8 + functions_vars_t.html | 6 +- functions_vars_u.html | 1 + functions_vars_v.html | 2 + functions_vars_w.html | 2 +- functions_vars_x.html | 4 +- functions_vars_y.html | 3 +- functions_w.html | 4 +- functions_x.html | 4 +- functions_y.html | 3 +- globals_c.html | 9 + globals_d.html | 28 +- globals_defs_c.html | 3 + globals_defs_p.html | 14 +- globals_enum.html | 1 + globals_eval.html | 33 +- globals_m.html | 3 + globals_p.html | 9 + globals_vars.html | 2595 +--------------- globals_vars_p.html | 2669 +++++++++++++++++ globals_w.html | 6 +- globals_y.html | 6 +- hidboot_8h.html | 7 +- hidboot_8h__dep__incl.map | 7 +- hidboot_8h__dep__incl.md5 | 2 +- hidboot_8h__dep__incl.png | Bin 10116 -> 12086 bytes hidcomposite_8h.html | 13 +- hidcomposite_8h__dep__incl.map | 13 +- hidcomposite_8h__dep__incl.md5 | 2 +- hidcomposite_8h__dep__incl.png | Bin 12658 -> 14365 bytes hiduniversal_8h.html | 5 +- hiduniversal_8h__dep__incl.map | 5 +- hiduniversal_8h__dep__incl.md5 | 2 +- hiduniversal_8h__dep__incl.png | Bin 9529 -> 11174 bytes hidusagestr_8h.html | 62 +- hidusagestr_8h__dep__incl.map | 62 +- hidusagestr_8h__dep__incl.md5 | 2 +- hidusagestr_8h__dep__incl.png | Bin 66087 -> 72097 bytes hierarchy.html | 127 +- index.html | 13 +- inherit_graph_17.md5 | 2 +- inherit_graph_31.md5 | 2 +- inherit_graph_40.map | 2 +- inherit_graph_40.md5 | 2 +- inherit_graph_40.png | Bin 1562 -> 1489 bytes inherit_graph_41.map | 2 +- inherit_graph_41.md5 | 2 +- inherit_graph_41.png | Bin 1073 -> 1105 bytes inherit_graph_42.map | 2 +- inherit_graph_42.md5 | 2 +- inherit_graph_42.png | Bin 1757 -> 1275 bytes inherit_graph_43.map | 2 +- inherit_graph_43.md5 | 2 +- inherit_graph_43.png | Bin 1074 -> 1163 bytes inherit_graph_44.map | 2 +- inherit_graph_44.md5 | 2 +- inherit_graph_44.png | Bin 2240 -> 1738 bytes inherit_graph_45.map | 2 +- inherit_graph_45.md5 | 2 +- inherit_graph_45.png | Bin 1701 -> 1275 bytes inherit_graph_46.map | 2 +- inherit_graph_46.md5 | 2 +- inherit_graph_46.png | Bin 1408 -> 1562 bytes inherit_graph_47.map | 2 +- inherit_graph_47.md5 | 2 +- inherit_graph_47.png | Bin 1128 -> 1073 bytes inherit_graph_48.map | 2 +- inherit_graph_48.md5 | 2 +- inherit_graph_48.png | Bin 1372 -> 1757 bytes inherit_graph_49.map | 2 +- inherit_graph_49.md5 | 2 +- inherit_graph_49.png | Bin 2383 -> 1074 bytes inherit_graph_50.map | 2 +- inherit_graph_50.md5 | 2 +- inherit_graph_50.png | Bin 2068 -> 2240 bytes inherit_graph_51.map | 2 +- inherit_graph_51.md5 | 2 +- inherit_graph_51.png | Bin 1953 -> 1701 bytes inherit_graph_52.map | 2 +- inherit_graph_52.md5 | 2 +- inherit_graph_52.png | Bin 1708 -> 1408 bytes inherit_graph_53.map | 2 +- inherit_graph_53.md5 | 2 +- inherit_graph_53.png | Bin 2108 -> 1128 bytes inherit_graph_54.map | 2 +- inherit_graph_54.md5 | 2 +- inherit_graph_54.png | Bin 1228 -> 1372 bytes inherit_graph_55.map | 2 +- inherit_graph_55.md5 | 2 +- inherit_graph_55.png | Bin 1614 -> 2383 bytes inherit_graph_56.map | 6 +- inherit_graph_56.md5 | 2 +- inherit_graph_56.png | Bin 16219 -> 2068 bytes inherit_graph_57.map | 2 +- inherit_graph_57.md5 | 2 +- inherit_graph_57.png | Bin 1903 -> 1953 bytes inherit_graph_58.map | 2 +- inherit_graph_58.md5 | 2 +- inherit_graph_58.png | Bin 1721 -> 1708 bytes inherit_graph_59.map | 32 +- inherit_graph_59.md5 | 2 +- inherit_graph_59.png | Bin 101984 -> 2108 bytes inherit_graph_60.map | 3 + inherit_graph_60.md5 | 1 + inherit_graph_60.png | Bin 0 -> 1228 bytes inherit_graph_61.map | 3 + inherit_graph_61.md5 | 1 + inherit_graph_61.png | Bin 0 -> 1614 bytes inherit_graph_62.map | 7 + inherit_graph_62.md5 | 1 + inherit_graph_62.png | Bin 0 -> 16219 bytes inherit_graph_63.map | 3 + inherit_graph_63.md5 | 1 + inherit_graph_63.png | Bin 0 -> 1903 bytes inherit_graph_64.map | 3 + inherit_graph_64.md5 | 1 + inherit_graph_64.png | Bin 0 -> 1721 bytes inherit_graph_65.map | 36 + inherit_graph_65.md5 | 1 + inherit_graph_65.png | Bin 0 -> 108697 bytes inherits.html | 135 +- menudata.js | 3 +- search/all_1.js | 8 +- search/all_10.js | 28 +- search/all_12.js | 23 +- search/all_13.js | 25 +- search/all_14.js | 8 +- search/all_15.js | 2 +- search/all_16.js | 4 +- search/all_17.js | 6 +- search/all_18.js | 4 +- search/all_19.js | 4 +- search/all_2.js | 6 +- search/all_3.js | 12 +- search/all_4.js | 29 +- search/all_5.js | 2 +- search/all_6.js | 2 +- search/all_7.js | 27 +- search/all_8.js | 3 +- search/all_9.js | 2 +- search/all_c.js | 7 +- search/all_d.js | 6 +- search/all_f.js | 4 +- search/classes_a.js | 9 + search/defines_10.js | 2 + search/defines_3.js | 3 +- search/enums_3.js | 2 +- search/enumvalues_13.js | 2 +- search/enumvalues_15.js | 2 +- search/enumvalues_2.js | 1 + search/enumvalues_3.js | 18 +- search/enumvalues_a.js | 1 + search/files_5.js | 6 + search/functions_0.js | 2 +- search/functions_10.js | 19 +- search/functions_13.js | 2 +- search/functions_14.js | 2 +- search/functions_2.js | 3 +- search/functions_6.js | 19 +- search/functions_8.js | 2 +- search/functions_d.js | 4 +- search/functions_e.js | 10 +- search/functions_f.js | 6 +- search/variables_1.js | 6 +- search/variables_11.js | 17 +- search/variables_12.js | 6 +- search/variables_13.js | 8 +- search/variables_14.js | 2 +- search/variables_15.js | 2 +- search/variables_16.js | 2 +- search/variables_17.js | 4 +- search/variables_18.js | 2 +- search/variables_2.js | 6 +- search/variables_3.js | 8 +- search/variables_4.js | 9 +- search/variables_5.js | 2 +- search/variables_6.js | 2 +- search/variables_7.js | 8 +- search/variables_8.js | 3 +- search/variables_b.js | 7 +- search/variables_c.js | 5 +- search/variables_f.js | 4 +- struct_hub_descriptor.html | 34 +- struct_hub_event.html | 32 +- struct_p_s5_data-members.html | 91 + struct_p_s5_data.html | 351 +++ struct_p_s5_data__coll__graph.map | 4 + struct_p_s5_data__coll__graph.md5 | 1 + struct_p_s5_data__coll__graph.png | Bin 0 -> 6629 bytes struct_p_s5_output-members.html | 86 + struct_p_s5_output.html | 252 ++ struct_s_e_t_u_p___p_k_t-members.html | 4 +- struct_s_e_t_u_p___p_k_t.html | 60 +- structps5_touchpad_x_y-members.html | 82 + structps5_touchpad_x_y.html | 179 ++ union_p_s5_buttons-members.html | 95 + union_p_s5_buttons.html | 431 +++ union_p_s5_status-members.html | 84 + union_p_s5_status.html | 233 ++ union_p_s_b_u_z_z_buttons-members.html | 2 +- union_p_s_b_u_z_z_buttons.html | 30 +- union_xbox_one_s_buttons.html | 62 +- usbhid_8h.html | 58 +- usbhid_8h__dep__incl.map | 58 +- usbhid_8h__dep__incl.md5 | 2 +- usbhid_8h__dep__incl.png | Bin 59493 -> 59158 bytes 386 files changed, 10938 insertions(+), 3734 deletions(-) create mode 100644 _p_s5_b_t_8h.html create mode 100644 _p_s5_b_t_8h__incl.map create mode 100644 _p_s5_b_t_8h__incl.md5 create mode 100644 _p_s5_b_t_8h__incl.png create mode 100644 _p_s5_b_t_8h_source.html create mode 100644 _p_s5_parser_8cpp.html create mode 100644 _p_s5_parser_8cpp__incl.map create mode 100644 _p_s5_parser_8cpp__incl.md5 create mode 100644 _p_s5_parser_8cpp__incl.png create mode 100644 _p_s5_parser_8cpp_source.html create mode 100644 _p_s5_parser_8h.html create mode 100644 _p_s5_parser_8h__dep__incl.map create mode 100644 _p_s5_parser_8h__dep__incl.md5 create mode 100644 _p_s5_parser_8h__dep__incl.png create mode 100644 _p_s5_parser_8h__incl.map create mode 100644 _p_s5_parser_8h__incl.md5 create mode 100644 _p_s5_parser_8h__incl.png create mode 100644 _p_s5_parser_8h_source.html create mode 100644 _p_s5_trigger_8cpp.html create mode 100644 _p_s5_trigger_8cpp__incl.map create mode 100644 _p_s5_trigger_8cpp__incl.md5 create mode 100644 _p_s5_trigger_8cpp__incl.png create mode 100644 _p_s5_trigger_8cpp_source.html create mode 100644 _p_s5_trigger_8h.html create mode 100644 _p_s5_trigger_8h__dep__incl.map create mode 100644 _p_s5_trigger_8h__dep__incl.md5 create mode 100644 _p_s5_trigger_8h__dep__incl.png create mode 100644 _p_s5_trigger_8h__incl.map create mode 100644 _p_s5_trigger_8h__incl.md5 create mode 100644 _p_s5_trigger_8h__incl.png create mode 100644 _p_s5_trigger_8h_source.html create mode 100644 _p_s5_u_s_b_8h.html create mode 100644 _p_s5_u_s_b_8h__incl.map create mode 100644 _p_s5_u_s_b_8h__incl.md5 create mode 100644 _p_s5_u_s_b_8h__incl.png create mode 100644 _p_s5_u_s_b_8h_source.html create mode 100644 class_p_s5_b_t-members.html create mode 100644 class_p_s5_b_t.html create mode 100644 class_p_s5_b_t__coll__graph.map create mode 100644 class_p_s5_b_t__coll__graph.md5 create mode 100644 class_p_s5_b_t__coll__graph.png create mode 100644 class_p_s5_b_t__inherit__graph.map create mode 100644 class_p_s5_b_t__inherit__graph.md5 create mode 100644 class_p_s5_b_t__inherit__graph.png create mode 100644 class_p_s5_parser-members.html create mode 100644 class_p_s5_parser.html create mode 100644 class_p_s5_parser__coll__graph.map create mode 100644 class_p_s5_parser__coll__graph.md5 create mode 100644 class_p_s5_parser__coll__graph.png create mode 100644 class_p_s5_parser__inherit__graph.map create mode 100644 class_p_s5_parser__inherit__graph.md5 create mode 100644 class_p_s5_parser__inherit__graph.png create mode 100644 class_p_s5_trigger-members.html create mode 100644 class_p_s5_trigger.html create mode 100644 class_p_s5_u_s_b-members.html create mode 100644 class_p_s5_u_s_b.html create mode 100644 class_p_s5_u_s_b__coll__graph.map create mode 100644 class_p_s5_u_s_b__coll__graph.md5 create mode 100644 class_p_s5_u_s_b__coll__graph.png create mode 100644 class_p_s5_u_s_b__inherit__graph.map create mode 100644 class_p_s5_u_s_b__inherit__graph.md5 create mode 100644 class_p_s5_u_s_b__inherit__graph.png create mode 100644 globals_vars_p.html create mode 100644 inherit_graph_60.map create mode 100644 inherit_graph_60.md5 create mode 100644 inherit_graph_60.png create mode 100644 inherit_graph_61.map create mode 100644 inherit_graph_61.md5 create mode 100644 inherit_graph_61.png create mode 100644 inherit_graph_62.map create mode 100644 inherit_graph_62.md5 create mode 100644 inherit_graph_62.png create mode 100644 inherit_graph_63.map create mode 100644 inherit_graph_63.md5 create mode 100644 inherit_graph_63.png create mode 100644 inherit_graph_64.map create mode 100644 inherit_graph_64.md5 create mode 100644 inherit_graph_64.png create mode 100644 inherit_graph_65.map create mode 100644 inherit_graph_65.md5 create mode 100644 inherit_graph_65.png create mode 100644 struct_p_s5_data-members.html create mode 100644 struct_p_s5_data.html create mode 100644 struct_p_s5_data__coll__graph.map create mode 100644 struct_p_s5_data__coll__graph.md5 create mode 100644 struct_p_s5_data__coll__graph.png create mode 100644 struct_p_s5_output-members.html create mode 100644 struct_p_s5_output.html create mode 100644 structps5_touchpad_x_y-members.html create mode 100644 structps5_touchpad_x_y.html create mode 100644 union_p_s5_buttons-members.html create mode 100644 union_p_s5_buttons.html create mode 100644 union_p_s5_status-members.html create mode 100644 union_p_s5_status.html diff --git a/_b_t_d_8cpp_source.html b/_b_t_d_8cpp_source.html index 63fd5ff5..48b714dd 100644 --- a/_b_t_d_8cpp_source.html +++ b/_b_t_d_8cpp_source.html @@ -63,7 +63,7 @@ $(function() {
BTD.cpp
-Go to the documentation of this file.
1 /* Copyright (C) 2012 Kristian Lauszus, TKJ Electronics. All rights reserved.
2 
3  This software may be distributed and modified under the terms of the GNU
4  General Public License version 2 (GPL2) as published by the Free Software
5  Foundation and appearing in the file GPL2.TXT included in the packaging of
6  this file. Please note that GPL2 Section 2[b] requires that all works based
7  on this software must also be made publicly available under the terms of
8  the GPL2 ("Copyleft").
9 
10  Contact information
11  -------------------
12 
13  Kristian Lauszus, TKJ Electronics
14  Web : http://www.tkjelectronics.com
15  e-mail : kristianl@tkjelectronics.com
16  */
17 
18 #include "BTD.h"
19 // To enable serial debugging see "settings.h"
20 //#define EXTRADEBUG // Uncomment to get even more debugging data
21 
22 const uint8_t BTD::BTD_CONTROL_PIPE = 0;
23 const uint8_t BTD::BTD_EVENT_PIPE = 1;
24 const uint8_t BTD::BTD_DATAIN_PIPE = 2;
25 const uint8_t BTD::BTD_DATAOUT_PIPE = 3;
26 
27 BTD::BTD(USB *p) :
28 connectToWii(false),
29 pairWithWii(false),
30 connectToHIDDevice(false),
31 pairWithHIDDevice(false),
32 useSimplePairing(false),
33 pUsb(p), // Pointer to USB class instance - mandatory
34 bAddress(0), // Device address - mandatory
35 bNumEP(1), // If config descriptor needs to be parsed
36 qNextPollTime(0), // Reset NextPollTime
37 pollInterval(0),
38 simple_pairing_supported(false),
39 bPollEnable(false) // Don't start polling before dongle is connected
40 {
41  for(uint8_t i = 0; i < BTD_NUM_SERVICES; i++)
42  btService[i] = NULL;
43 
44  Initialize(); // Set all variables, endpoint structs etc. to default values
45 
46  if(pUsb) // Register in USB subsystem
47  pUsb->RegisterDeviceClass(this); // Set devConfig[] entry
48 }
49 
50 uint8_t BTD::ConfigureDevice(uint8_t parent, uint8_t port, bool lowspeed) {
51  const uint8_t constBufSize = sizeof (USB_DEVICE_DESCRIPTOR);
52  uint8_t buf[constBufSize];
53  USB_DEVICE_DESCRIPTOR * udd = reinterpret_cast<USB_DEVICE_DESCRIPTOR*>(buf);
54  uint8_t rcode;
55  UsbDevice *p = NULL;
56  EpInfo *oldep_ptr = NULL;
57 
58  Initialize(); // Set all variables, endpoint structs etc. to default values
59 
60  AddressPool &addrPool = pUsb->GetAddressPool(); // Get memory address of USB device address pool
61 #ifdef EXTRADEBUG
62  Notify(PSTR("\r\nBTD ConfigureDevice"), 0x80);
63 #endif
64 
65  if(bAddress) { // Check if address has already been assigned to an instance
66 #ifdef DEBUG_USB_HOST
67  Notify(PSTR("\r\nAddress in use"), 0x80);
68 #endif
69  return USB_ERROR_CLASS_INSTANCE_ALREADY_IN_USE;
70  }
71 
72  p = addrPool.GetUsbDevicePtr(0); // Get pointer to pseudo device with address 0 assigned
73  if(!p) {
74 #ifdef DEBUG_USB_HOST
75  Notify(PSTR("\r\nAddress not found"), 0x80);
76 #endif
77  return USB_ERROR_ADDRESS_NOT_FOUND_IN_POOL;
78  }
79 
80  if(!p->epinfo) {
81 #ifdef DEBUG_USB_HOST
82  Notify(PSTR("\r\nepinfo is null"), 0x80);
83 #endif
84  return USB_ERROR_EPINFO_IS_NULL;
85  }
86 
87  oldep_ptr = p->epinfo; // Save old pointer to EP_RECORD of address 0
88  p->epinfo = epInfo; // Temporary assign new pointer to epInfo to p->epinfo in order to avoid toggle inconsistence
89  p->lowspeed = lowspeed;
90  rcode = pUsb->getDevDescr(0, 0, constBufSize, (uint8_t*)buf); // Get device descriptor - addr, ep, nbytes, data
91 
92  p->epinfo = oldep_ptr; // Restore p->epinfo
93 
94  if(rcode)
95  goto FailGetDevDescr;
96 
97  bAddress = addrPool.AllocAddress(parent, false, port); // Allocate new address according to device class
98 
99  if(!bAddress) {
100 #ifdef DEBUG_USB_HOST
101  Notify(PSTR("\r\nOut of address space"), 0x80);
102 #endif
103  return USB_ERROR_OUT_OF_ADDRESS_SPACE_IN_POOL;
104  }
105 
106  if (udd->bDeviceClass == 0x09) // Some dongles have an USB hub inside
107  goto FailHub;
108 
109  epInfo[0].maxPktSize = udd->bMaxPacketSize0; // Extract Max Packet Size from device descriptor
110  epInfo[1].epAddr = udd->bNumConfigurations; // Steal and abuse from epInfo structure to save memory
111 
112  VID = udd->idVendor;
113  PID = udd->idProduct;
114 
115  return USB_ERROR_CONFIG_REQUIRES_ADDITIONAL_RESET;
116 
117 FailHub:
118 #ifdef DEBUG_USB_HOST
119  Notify(PSTR("\r\nPlease create a hub instance in your code: \"USBHub Hub1(&Usb);\""), 0x80);
120 #endif
121  pUsb->setAddr(bAddress, 0, 0); // Reset address
122  rcode = USB_DEV_CONFIG_ERROR_DEVICE_NOT_SUPPORTED;
123  Release();
124  return rcode;
125 
126 FailGetDevDescr:
127 #ifdef DEBUG_USB_HOST
128  NotifyFailGetDevDescr(rcode);
129 #endif
130  if(rcode != hrJERR)
131  rcode = USB_ERROR_FailGetDevDescr;
132  Release();
133  return rcode;
134 };
135 
136 uint8_t BTD::Init(uint8_t parent __attribute__((unused)), uint8_t port __attribute__((unused)), bool lowspeed) {
137  uint8_t rcode;
138  uint8_t num_of_conf = epInfo[1].epAddr; // Number of configurations
139  epInfo[1].epAddr = 0;
140 
141  AddressPool &addrPool = pUsb->GetAddressPool();
142 #ifdef EXTRADEBUG
143  Notify(PSTR("\r\nBTD Init"), 0x80);
144 #endif
145  UsbDevice *p = addrPool.GetUsbDevicePtr(bAddress); // Get pointer to assigned address record
146 
147  if(!p) {
148 #ifdef DEBUG_USB_HOST
149  Notify(PSTR("\r\nAddress not found"), 0x80);
150 #endif
151  return USB_ERROR_ADDRESS_NOT_FOUND_IN_POOL;
152  }
153 
154  delay(300); // Assign new address to the device
155 
156  rcode = pUsb->setAddr(0, 0, bAddress); // Assign new address to the device
157  if(rcode) {
158 #ifdef DEBUG_USB_HOST
159  Notify(PSTR("\r\nsetAddr: "), 0x80);
160  D_PrintHex<uint8_t > (rcode, 0x80);
161 #endif
162  p->lowspeed = false;
163  goto Fail;
164  }
165 #ifdef EXTRADEBUG
166  Notify(PSTR("\r\nAddr: "), 0x80);
167  D_PrintHex<uint8_t > (bAddress, 0x80);
168 #endif
169 
170  p->lowspeed = false;
171 
172  p = addrPool.GetUsbDevicePtr(bAddress); // Get pointer to assigned address record
173  if(!p) {
174 #ifdef DEBUG_USB_HOST
175  Notify(PSTR("\r\nAddress not found"), 0x80);
176 #endif
177  return USB_ERROR_ADDRESS_NOT_FOUND_IN_POOL;
178  }
179 
180  p->lowspeed = lowspeed;
181 
182  rcode = pUsb->setEpInfoEntry(bAddress, 1, epInfo); // Assign epInfo to epinfo pointer - only EP0 is known
183  if(rcode)
184  goto FailSetDevTblEntry;
185 
186  if(VID == PS3_VID && (PID == PS3_PID || PID == PS3NAVIGATION_PID || PID == PS3MOVE_PID)) {
187  delay(100);
188  rcode = pUsb->setConf(bAddress, epInfo[ BTD_CONTROL_PIPE ].epAddr, 1); // We only need the Control endpoint, so we don't have to initialize the other endpoints of device
189  if(rcode)
190  goto FailSetConfDescr;
191 
192 #ifdef DEBUG_USB_HOST
193  if(PID == PS3_PID || PID == PS3NAVIGATION_PID) {
194  if(PID == PS3_PID)
195  Notify(PSTR("\r\nDualshock 3 Controller Connected"), 0x80);
196  else // It must be a navigation controller
197  Notify(PSTR("\r\nNavigation Controller Connected"), 0x80);
198  } else // It must be a Motion controller
199  Notify(PSTR("\r\nMotion Controller Connected"), 0x80);
200 #endif
201 
202  if(my_bdaddr[0] == 0x00 && my_bdaddr[1] == 0x00 && my_bdaddr[2] == 0x00 && my_bdaddr[3] == 0x00 && my_bdaddr[4] == 0x00 && my_bdaddr[5] == 0x00) {
203 #ifdef DEBUG_USB_HOST
204  Notify(PSTR("\r\nPlease plug in the dongle before trying to pair with the PS3 Controller\r\nor set the Bluetooth address in the constructor of the PS3BT class"), 0x80);
205 #endif
206  } else {
207  if(PID == PS3_PID || PID == PS3NAVIGATION_PID)
208  setBdaddr(my_bdaddr); // Set internal Bluetooth address
209  else
210  setMoveBdaddr(my_bdaddr); // Set internal Bluetooth address
211 #ifdef DEBUG_USB_HOST
212  Notify(PSTR("\r\nBluetooth Address was set to: "), 0x80);
213  for(int8_t i = 5; i > 0; i--) {
214  D_PrintHex<uint8_t > (my_bdaddr[i], 0x80);
215  Notify(PSTR(":"), 0x80);
216  }
217  D_PrintHex<uint8_t > (my_bdaddr[0], 0x80);
218 #endif
219  }
220 
221  pUsb->setConf(bAddress, epInfo[ BTD_CONTROL_PIPE ].epAddr, 0); // Reset configuration value
222  pUsb->setAddr(bAddress, 0, 0); // Reset address
223  Release(); // Release device
224  return USB_DEV_CONFIG_ERROR_DEVICE_NOT_SUPPORTED; // Return
225  } else {
226  // Check if attached device is a Bluetooth dongle and fill endpoint data structure
227  // First interface in the configuration must have Bluetooth assigned Class/Subclass/Protocol
228  // And 3 endpoints - interrupt-IN, bulk-IN, bulk-OUT, not necessarily in this order
229  for(uint8_t i = 0; i < num_of_conf; i++) {
230  if((VID == IOGEAR_GBU521_VID && PID == IOGEAR_GBU521_PID) || (VID == BELKIN_F8T065BF_VID && PID == BELKIN_F8T065BF_PID)) {
231  ConfigDescParser<USB_CLASS_VENDOR_SPECIFIC, WI_SUBCLASS_RF, WI_PROTOCOL_BT, CP_MASK_COMPARE_ALL> confDescrParser(this); // Workaround issue with some dongles
232  rcode = pUsb->getConfDescr(bAddress, 0, i, &confDescrParser);
233  } else {
234  ConfigDescParser<USB_CLASS_WIRELESS_CTRL, WI_SUBCLASS_RF, WI_PROTOCOL_BT, CP_MASK_COMPARE_ALL> confDescrParser(this); // Set class id according to the specification
235  rcode = pUsb->getConfDescr(bAddress, 0, i, &confDescrParser);
236  }
237  if(rcode) // Check error code
238  goto FailGetConfDescr;
239  if(bNumEP >= BTD_MAX_ENDPOINTS) // All endpoints extracted
240  break;
241  }
242 
243  if(bNumEP < BTD_MAX_ENDPOINTS)
244  goto FailUnknownDevice;
245 
246  // Assign epInfo to epinfo pointer - this time all 3 endpoins
247  rcode = pUsb->setEpInfoEntry(bAddress, bNumEP, epInfo);
248  if(rcode)
249  goto FailSetDevTblEntry;
250 
251  // Set Configuration Value
252  rcode = pUsb->setConf(bAddress, epInfo[ BTD_CONTROL_PIPE ].epAddr, bConfNum);
253  if(rcode)
254  goto FailSetConfDescr;
255 
256  hci_num_reset_loops = 100; // only loop 100 times before trying to send the hci reset command
257  hci_counter = 0;
258  hci_state = HCI_INIT_STATE;
259  waitingForConnection = false;
260  bPollEnable = true;
261 
262 #ifdef DEBUG_USB_HOST
263  Notify(PSTR("\r\nBluetooth Dongle Initialized"), 0x80);
264 #endif
265  }
266  return 0; // Successful configuration
267 
268  /* Diagnostic messages */
269 FailSetDevTblEntry:
270 #ifdef DEBUG_USB_HOST
271  NotifyFailSetDevTblEntry();
272  goto Fail;
273 #endif
274 
275 FailGetConfDescr:
276 #ifdef DEBUG_USB_HOST
277  NotifyFailGetConfDescr();
278  goto Fail;
279 #endif
280 
281 FailSetConfDescr:
282 #ifdef DEBUG_USB_HOST
283  NotifyFailSetConfDescr();
284 #endif
285  goto Fail;
286 
287 FailUnknownDevice:
288 #ifdef DEBUG_USB_HOST
289  NotifyFailUnknownDevice(VID, PID);
290 #endif
291  pUsb->setAddr(bAddress, 0, 0); // Reset address
292  rcode = USB_DEV_CONFIG_ERROR_DEVICE_NOT_SUPPORTED;
293 Fail:
294 #ifdef DEBUG_USB_HOST
295  Notify(PSTR("\r\nBTD Init Failed, error code: "), 0x80);
296  NotifyFail(rcode);
297 #endif
298  Release();
299  return rcode;
300 }
301 
302 void BTD::Initialize() {
303  uint8_t i;
304  for(i = 0; i < BTD_MAX_ENDPOINTS; i++) {
305  epInfo[i].epAddr = 0;
306  epInfo[i].maxPktSize = (i) ? 0 : 8;
307  epInfo[i].bmSndToggle = 0;
308  epInfo[i].bmRcvToggle = 0;
309  epInfo[i].bmNakPower = (i) ? USB_NAK_NOWAIT : USB_NAK_MAX_POWER;
310  }
311  for(i = 0; i < BTD_NUM_SERVICES; i++) {
312  if(btService[i])
313  btService[i]->Reset(); // Reset all Bluetooth services
314  }
315 
316  connectToWii = false;
317  incomingWii = false;
318  connectToHIDDevice = false;
319  incomingHIDDevice = false;
320  incomingPS4 = false;
321  bAddress = 0; // Clear device address
322  bNumEP = 1; // Must have to be reset to 1
323  qNextPollTime = 0; // Reset next poll time
324  pollInterval = 0;
325  bPollEnable = false; // Don't start polling before dongle is connected
326  simple_pairing_supported = false;
327 }
328 
329 /* Extracts interrupt-IN, bulk-IN, bulk-OUT endpoint information from config descriptor */
330 void BTD::EndpointXtract(uint8_t conf, uint8_t iface __attribute__((unused)), uint8_t alt, uint8_t proto __attribute__((unused)), const USB_ENDPOINT_DESCRIPTOR *pep) {
331  //ErrorMessage<uint8_t>(PSTR("Conf.Val"),conf);
332  //ErrorMessage<uint8_t>(PSTR("Iface Num"),iface);
333  //ErrorMessage<uint8_t>(PSTR("Alt.Set"),alt);
334 
335  if(alt) // Wrong interface - by BT spec, no alt setting
336  return;
337 
338  bConfNum = conf;
339  uint8_t index;
340 
341  if((pep->bmAttributes & bmUSB_TRANSFER_TYPE) == USB_TRANSFER_TYPE_INTERRUPT && (pep->bEndpointAddress & 0x80) == 0x80) { // Interrupt In endpoint found
342  index = BTD_EVENT_PIPE;
343  epInfo[index].bmNakPower = USB_NAK_NOWAIT;
344  } else if((pep->bmAttributes & bmUSB_TRANSFER_TYPE) == USB_TRANSFER_TYPE_BULK) // Bulk endpoint found
345  index = ((pep->bEndpointAddress & 0x80) == 0x80) ? BTD_DATAIN_PIPE : BTD_DATAOUT_PIPE;
346  else
347  return;
348 
349  // Fill the rest of endpoint data structure
350  epInfo[index].epAddr = (pep->bEndpointAddress & 0x0F);
351  epInfo[index].maxPktSize = (uint8_t)pep->wMaxPacketSize;
352 #ifdef EXTRADEBUG
353  PrintEndpointDescriptor(pep);
354 #endif
355  if(pollInterval < pep->bInterval) // Set the polling interval as the largest polling interval obtained from endpoints
356  pollInterval = pep->bInterval;
357  bNumEP++;
358 }
359 
360 void BTD::PrintEndpointDescriptor(const USB_ENDPOINT_DESCRIPTOR* ep_ptr __attribute__((unused))) {
361 #ifdef EXTRADEBUG
362  Notify(PSTR("\r\nEndpoint descriptor:"), 0x80);
363  Notify(PSTR("\r\nLength:\t\t"), 0x80);
364  D_PrintHex<uint8_t > (ep_ptr->bLength, 0x80);
365  Notify(PSTR("\r\nType:\t\t"), 0x80);
366  D_PrintHex<uint8_t > (ep_ptr->bDescriptorType, 0x80);
367  Notify(PSTR("\r\nAddress:\t"), 0x80);
368  D_PrintHex<uint8_t > (ep_ptr->bEndpointAddress, 0x80);
369  Notify(PSTR("\r\nAttributes:\t"), 0x80);
370  D_PrintHex<uint8_t > (ep_ptr->bmAttributes, 0x80);
371  Notify(PSTR("\r\nMaxPktSize:\t"), 0x80);
372  D_PrintHex<uint16_t > (ep_ptr->wMaxPacketSize, 0x80);
373  Notify(PSTR("\r\nPoll Intrv:\t"), 0x80);
374  D_PrintHex<uint8_t > (ep_ptr->bInterval, 0x80);
375 #endif
376 }
377 
378 /* Performs a cleanup after failed Init() attempt */
379 uint8_t BTD::Release() {
380  Initialize(); // Set all variables, endpoint structs etc. to default values
381  pUsb->GetAddressPool().FreeAddress(bAddress);
382  return 0;
383 }
384 
385 uint8_t BTD::Poll() {
386  if(!bPollEnable)
387  return 0;
388  if((int32_t)((uint32_t)millis() - qNextPollTime) >= 0L) { // Don't poll if shorter than polling interval
389  qNextPollTime = (uint32_t)millis() + pollInterval; // Set new poll time
390  HCI_event_task(); // Poll the HCI event pipe
391  HCI_task(); // HCI state machine
392  ACL_event_task(); // Poll the ACL input pipe too
393  }
394  return 0;
395 }
396 
397 void BTD::disconnect() {
398  for(uint8_t i = 0; i < BTD_NUM_SERVICES; i++)
399  if(btService[i])
400  btService[i]->disconnect();
401 };
402 
403 void BTD::HCI_event_task() {
404  uint16_t length = BULK_MAXPKTSIZE; // Request more than 16 bytes anyway, the inTransfer routine will take care of this
405  uint8_t rcode = pUsb->inTransfer(bAddress, epInfo[ BTD_EVENT_PIPE ].epAddr, &length, hcibuf, pollInterval); // Input on endpoint 1
406 
407  if(!rcode || rcode == hrNAK) { // Check for errors
408  switch(hcibuf[0]) { // Switch on event type
409  case EV_COMMAND_COMPLETE:
410  if(!hcibuf[5]) { // Check if command succeeded
411  hci_set_flag(HCI_FLAG_CMD_COMPLETE); // Set command complete flag
412  if((hcibuf[3] == 0x01) && (hcibuf[4] == 0x10)) { // Parameters from read local version information
413  hci_version = hcibuf[6]; // Used to check if it supports 2.0+EDR - see http://www.bluetooth.org/Technical/AssignedNumbers/hci.htm
414 #ifdef EXTRADEBUG
415  if(!hci_check_flag(HCI_FLAG_READ_VERSION)) {
416  Notify(PSTR("\r\nHCI version: "), 0x80);
417  D_PrintHex<uint8_t > (hci_version, 0x80);
418  }
419 #endif
420  hci_set_flag(HCI_FLAG_READ_VERSION);
421  } else if((hcibuf[3] == 0x04) && (hcibuf[4] == 0x10)) { // Parameters from read local extended features
422  if(!hci_check_flag(HCI_FLAG_LOCAL_EXTENDED_FEATURES)) {
423 #ifdef EXTRADEBUG
424  Notify(PSTR("\r\nPage number: "), 0x80);
425  D_PrintHex<uint8_t > (hcibuf[6], 0x80);
426  Notify(PSTR("\r\nMaximum page number: "), 0x80);
427  D_PrintHex<uint8_t > (hcibuf[7], 0x80);
428  Notify(PSTR("\r\nExtended LMP features:"), 0x80);
429  for(uint8_t i = 0; i < 8; i++) {
430  Notify(PSTR(" "), 0x80);
431  D_PrintHex<uint8_t > (hcibuf[8 + i], 0x80);
432  }
433 #endif
434  if(hcibuf[6] == 0) { // Page 0
435 #ifdef DEBUG_USB_HOST
436  Notify(PSTR("\r\nDongle "), 0x80);
437 #endif
438  if(hcibuf[8 + 6] & (1U << 3)) {
439  simple_pairing_supported = true;
440 #ifdef DEBUG_USB_HOST
441  Notify(PSTR("supports"), 0x80);
442 #endif
443  } else {
444  simple_pairing_supported = false;
445 #ifdef DEBUG_USB_HOST
446  Notify(PSTR("does NOT support"), 0x80);
447 #endif
448  }
449 #ifdef DEBUG_USB_HOST
450  Notify(PSTR(" secure simple pairing (controller support)"), 0x80);
451 #endif
452  } else if(hcibuf[6] == 1) { // Page 1
453 #ifdef DEBUG_USB_HOST
454  Notify(PSTR("\r\nDongle "), 0x80);
455  if(hcibuf[8 + 0] & (1U << 0))
456  Notify(PSTR("supports"), 0x80);
457  else
458  Notify(PSTR("does NOT support"), 0x80);
459  Notify(PSTR(" secure simple pairing (host support)"), 0x80);
460 #endif
461  }
462  }
463 
464  hci_set_flag(HCI_FLAG_LOCAL_EXTENDED_FEATURES);
465  } else if((hcibuf[3] == 0x09) && (hcibuf[4] == 0x10)) { // Parameters from read local bluetooth address
466  for(uint8_t i = 0; i < 6; i++)
467  my_bdaddr[i] = hcibuf[6 + i];
468  hci_set_flag(HCI_FLAG_READ_BDADDR);
469  }
470  }
471  break;
472 
473  case EV_COMMAND_STATUS:
474  if(hcibuf[2]) { // Show status on serial if not OK
475 #ifdef DEBUG_USB_HOST
476  Notify(PSTR("\r\nHCI Command Failed: "), 0x80);
477  D_PrintHex<uint8_t > (hcibuf[2], 0x80);
478  Notify(PSTR("\r\nNum HCI Command Packets: "), 0x80);
479  D_PrintHex<uint8_t > (hcibuf[3], 0x80);
480  Notify(PSTR("\r\nCommand Opcode: "), 0x80);
481  D_PrintHex<uint8_t > (hcibuf[4], 0x80);
482  Notify(PSTR(" "), 0x80);
483  D_PrintHex<uint8_t > (hcibuf[5], 0x80);
484 #endif
485  }
486  break;
487 
488  case EV_INQUIRY_COMPLETE:
489  if(inquiry_counter >= 5 && (pairWithWii || pairWithHIDDevice)) {
490  inquiry_counter = 0;
491 #ifdef DEBUG_USB_HOST
492  if(pairWithWii)
493  Notify(PSTR("\r\nCouldn't find Wiimote"), 0x80);
494  else
495  Notify(PSTR("\r\nCouldn't find HID device"), 0x80);
496 #endif
497  connectToWii = false;
498  pairWithWii = false;
499  connectToHIDDevice = false;
500  pairWithHIDDevice = false;
501  hci_state = HCI_SCANNING_STATE;
502  }
503  inquiry_counter++;
504  break;
505 
506  case EV_INQUIRY_RESULT:
507  if(hcibuf[2]) { // Check that there is more than zero responses
508 #ifdef EXTRADEBUG
509  Notify(PSTR("\r\nNumber of responses: "), 0x80);
510  Notify(hcibuf[2], 0x80);
511 #endif
512  for(uint8_t i = 0; i < hcibuf[2]; i++) {
513  uint8_t offset = 8 * hcibuf[2] + 3 * i;
514 
515  for(uint8_t j = 0; j < 3; j++)
516  classOfDevice[j] = hcibuf[j + 4 + offset];
517 
518 #ifdef EXTRADEBUG
519  Notify(PSTR("\r\nClass of device: "), 0x80);
520  D_PrintHex<uint8_t > (classOfDevice[2], 0x80);
521  Notify(PSTR(" "), 0x80);
522  D_PrintHex<uint8_t > (classOfDevice[1], 0x80);
523  Notify(PSTR(" "), 0x80);
524  D_PrintHex<uint8_t > (classOfDevice[0], 0x80);
525 #endif
526 
527  if(pairWithWii && classOfDevice[2] == 0x00 && (classOfDevice[1] == 0x05) && (classOfDevice[0] & 0x0C)) { // See http://wiibrew.org/wiki/Wiimote#SDP_information
528  checkRemoteName = true; // Check remote name to distinguish between the different controllers
529 
530  for(uint8_t j = 0; j < 6; j++)
531  disc_bdaddr[j] = hcibuf[j + 3 + 6 * i];
532 
533  hci_set_flag(HCI_FLAG_DEVICE_FOUND);
534  break;
535  } else if(pairWithHIDDevice && (classOfDevice[1] & 0x0F) == 0x05 && (classOfDevice[0] & 0xC8)) { // Check if it is a mouse, keyboard or a gamepad - see: http://bluetooth-pentest.narod.ru/software/bluetooth_class_of_device-service_generator.html
536 #ifdef DEBUG_USB_HOST
537  checkRemoteName = true; // Used to print name in the serial monitor if serial debugging is enabled
538 
539  if(classOfDevice[0] & 0x80)
540  Notify(PSTR("\r\nMouse found"), 0x80);
541  if(classOfDevice[0] & 0x40)
542  Notify(PSTR("\r\nKeyboard found"), 0x80);
543  if(classOfDevice[0] & 0x08)
544  Notify(PSTR("\r\nGamepad found"), 0x80);
545 #endif
546  for(uint8_t j = 0; j < 6; j++)
547  disc_bdaddr[j] = hcibuf[j + 3 + 6 * i];
548 
549  hci_set_flag(HCI_FLAG_DEVICE_FOUND);
550  break;
551  }
552  }
553  }
554  break;
555 
556  case EV_CONNECT_COMPLETE:
557  hci_set_flag(HCI_FLAG_CONNECT_EVENT);
558  if(!hcibuf[2]) { // Check if connected OK
559 #ifdef EXTRADEBUG
560  Notify(PSTR("\r\nConnection established"), 0x80);
561 #endif
562  hci_handle = hcibuf[3] | ((hcibuf[4] & 0x0F) << 8); // Store the handle for the ACL connection
563  hci_set_flag(HCI_FLAG_CONNECT_COMPLETE); // Set connection complete flag
564  } else {
565  hci_state = HCI_CHECK_DEVICE_SERVICE;
566 #ifdef DEBUG_USB_HOST
567  Notify(PSTR("\r\nConnection Failed: "), 0x80);
568  D_PrintHex<uint8_t > (hcibuf[2], 0x80);
569 #endif
570  }
571  break;
572 
573  case EV_DISCONNECT_COMPLETE:
574  if(!hcibuf[2]) { // Check if disconnected OK
575  hci_set_flag(HCI_FLAG_DISCONNECT_COMPLETE); // Set disconnect command complete flag
576  hci_clear_flag(HCI_FLAG_CONNECT_COMPLETE); // Clear connection complete flag
577  }
578  break;
579 
580  case EV_REMOTE_NAME_COMPLETE:
581  if(!hcibuf[2]) { // Check if reading is OK
582  for(uint8_t i = 0; i < min(sizeof (remote_name), sizeof (hcibuf) - 9); i++) {
583  remote_name[i] = hcibuf[9 + i];
584  if(remote_name[i] == '\0') // End of string
585  break;
586  }
587  // TODO: Always set '\0' in remote name!
588  hci_set_flag(HCI_FLAG_REMOTE_NAME_COMPLETE);
589  }
590  break;
591 
592  case EV_INCOMING_CONNECT:
593  for(uint8_t i = 0; i < 6; i++)
594  disc_bdaddr[i] = hcibuf[i + 2];
595 
596  for(uint8_t i = 0; i < 3; i++)
597  classOfDevice[i] = hcibuf[i + 8];
598 
599  if((classOfDevice[1] & 0x0F) == 0x05 && (classOfDevice[0] & 0xC8)) { // Check if it is a mouse, keyboard or a gamepad
600 #ifdef DEBUG_USB_HOST
601  if(classOfDevice[0] & 0x80)
602  Notify(PSTR("\r\nMouse is connecting"), 0x80);
603  if(classOfDevice[0] & 0x40)
604  Notify(PSTR("\r\nKeyboard is connecting"), 0x80);
605  if(classOfDevice[0] & 0x08)
606  Notify(PSTR("\r\nGamepad is connecting"), 0x80);
607 #endif
608  incomingHIDDevice = true;
609  }
610 
611 #ifdef EXTRADEBUG
612  Notify(PSTR("\r\nClass of device: "), 0x80);
613  D_PrintHex<uint8_t > (classOfDevice[2], 0x80);
614  Notify(PSTR(" "), 0x80);
615  D_PrintHex<uint8_t > (classOfDevice[1], 0x80);
616  Notify(PSTR(" "), 0x80);
617  D_PrintHex<uint8_t > (classOfDevice[0], 0x80);
618 #endif
619  hci_set_flag(HCI_FLAG_INCOMING_REQUEST);
620  break;
621 
622  case EV_PIN_CODE_REQUEST:
623  if(pairWithWii) {
624 #ifdef DEBUG_USB_HOST
625  Notify(PSTR("\r\nPairing with Wiimote"), 0x80);
626 #endif
627  hci_pin_code_request_reply();
628  } else if(btdPin != NULL) {
629 #ifdef DEBUG_USB_HOST
630  Notify(PSTR("\r\nBluetooth pin is set too: "), 0x80);
631  NotifyStr(btdPin, 0x80);
632 #endif
633  hci_pin_code_request_reply();
634  } else {
635 #ifdef DEBUG_USB_HOST
636  Notify(PSTR("\r\nNo pin was set"), 0x80);
637 #endif
638  hci_pin_code_negative_request_reply();
639  }
640  break;
641 
642  case EV_LINK_KEY_REQUEST:
643 #ifdef DEBUG_USB_HOST
644  Notify(PSTR("\r\nReceived Key Request"), 0x80);
645 #endif
646  hci_link_key_request_negative_reply();
647  break;
648 
649  case EV_AUTHENTICATION_COMPLETE:
650  if(!hcibuf[2]) { // Check if pairing was successful
651  if(pairWithWii && !connectToWii) {
652 #ifdef DEBUG_USB_HOST
653  Notify(PSTR("\r\nPairing successful with Wiimote"), 0x80);
654 #endif
655  connectToWii = true; // Used to indicate to the Wii service, that it should connect to this device
656  } else if(pairWithHIDDevice && !connectToHIDDevice) {
657 #ifdef DEBUG_USB_HOST
658  Notify(PSTR("\r\nPairing successful with HID device"), 0x80);
659 #endif
660  connectToHIDDevice = true; // Used to indicate to the BTHID service, that it should connect to this device
661  } else {
662 #ifdef EXTRADEBUG
663  Notify(PSTR("\r\nPairing was successful"), 0x80);
664 #endif
665  }
666  } else {
667 #ifdef DEBUG_USB_HOST
668  Notify(PSTR("\r\nPairing Failed: "), 0x80);
669  D_PrintHex<uint8_t > (hcibuf[2], 0x80);
670 #endif
671  hci_disconnect(hci_handle);
672  hci_state = HCI_DISCONNECT_STATE;
673  }
674  break;
675 
676  case EV_IO_CAPABILITY_REQUEST:
677 #ifdef DEBUG_USB_HOST
678  Notify(PSTR("\r\nReceived IO Capability Request"), 0x80);
679 #endif
680  hci_io_capability_request_reply();
681  break;
682 
683  case EV_IO_CAPABILITY_RESPONSE:
684 #ifdef EXTRADEBUG
685  Notify(PSTR("\r\nReceived IO Capability Response: "), 0x80);
686  Notify(PSTR("\r\nIO capability: "), 0x80);
687  D_PrintHex<uint8_t > (hcibuf[8], 0x80);
688  Notify(PSTR("\r\nOOB data present: "), 0x80);
689  D_PrintHex<uint8_t > (hcibuf[9], 0x80);
690  Notify(PSTR("\r\nAuthentication request: "), 0x80);
691  D_PrintHex<uint8_t > (hcibuf[10], 0x80);
692 #endif
693  break;
694 
695  case EV_USER_CONFIRMATION_REQUEST:
696 #ifdef DEBUG_USB_HOST
697  Notify(PSTR("\r\nUser confirmation Request"), 0x80);
698 #ifdef EXTRADEBUG
699  Notify(PSTR(": \r\nNumeric value: "), 0x80);
700  for(uint8_t i = 0; i < 4; i++) {
701  Notify(PSTR(" "), 0x80);
702  D_PrintHex<uint8_t > (hcibuf[8 + i], 0x80);
703  }
704 #endif
705 #endif
706  // Simply confirm the connection, as the host has no "NoInputNoOutput" capabilities
707  hci_user_confirmation_request_reply();
708  break;
709 
710  case EV_SIMPLE_PAIRING_COMPLETE:
711 #ifdef EXTRADEBUG
712  if(!hcibuf[2]) { // Check if connected OK
713  Notify(PSTR("\r\nSimple Pairing succeeded"), 0x80);
714  } else {
715  Notify(PSTR("\r\nSimple Pairing failed: "), 0x80);
716  D_PrintHex<uint8_t > (hcibuf[2], 0x80);
717  }
718 #endif
719  break;
720 
721  /* We will just ignore the following events */
722  case EV_MAX_SLOTS_CHANGE:
723  case EV_NUM_COMPLETE_PKT:
724  break;
725  case EV_ROLE_CHANGED:
726  case EV_PAGE_SCAN_REP_MODE:
727  case EV_LOOPBACK_COMMAND:
728  case EV_DATA_BUFFER_OVERFLOW:
729  case EV_CHANGE_CONNECTION_LINK:
730  case EV_QOS_SETUP_COMPLETE:
731  case EV_LINK_KEY_NOTIFICATION:
732  case EV_ENCRYPTION_CHANGE:
733  case EV_READ_REMOTE_VERSION_INFORMATION_COMPLETE:
734 #ifdef EXTRADEBUG
735  if(hcibuf[0] != 0x00) {
736  Notify(PSTR("\r\nIgnore HCI Event: "), 0x80);
737  D_PrintHex<uint8_t > (hcibuf[0], 0x80);
738  }
739 #endif
740  break;
741 #ifdef EXTRADEBUG
742  default:
743  if(hcibuf[0] != 0x00) {
744  Notify(PSTR("\r\nUnmanaged HCI Event: "), 0x80);
745  D_PrintHex<uint8_t > (hcibuf[0], 0x80);
746  Notify(PSTR(", data: "), 0x80);
747  for(uint16_t i = 0; i < hcibuf[1]; i++) {
748  D_PrintHex<uint8_t > (hcibuf[2 + i], 0x80);
749  Notify(PSTR(" "), 0x80);
750  }
751  }
752  break;
753 #endif
754  } // Switch
755  }
756 #ifdef EXTRADEBUG
757  else {
758  Notify(PSTR("\r\nHCI event error: "), 0x80);
759  D_PrintHex<uint8_t > (rcode, 0x80);
760  }
761 #endif
762 }
763 
764 /* Poll Bluetooth and print result */
765 void BTD::HCI_task() {
766  switch(hci_state) {
767  case HCI_INIT_STATE:
768  hci_counter++;
769  if(hci_counter > hci_num_reset_loops) { // wait until we have looped x times to clear any old events
770  hci_reset();
771  hci_state = HCI_RESET_STATE;
772  hci_counter = 0;
773  }
774  break;
775 
776  case HCI_RESET_STATE:
777  hci_counter++;
778  if(hci_check_flag(HCI_FLAG_CMD_COMPLETE)) {
779  hci_counter = 0;
780 #ifdef DEBUG_USB_HOST
781  Notify(PSTR("\r\nHCI Reset complete"), 0x80);
782 #endif
783  hci_state = HCI_CLASS_STATE;
784  hci_write_class_of_device();
785  } else if(hci_counter > hci_num_reset_loops) {
786  hci_num_reset_loops *= 10;
787  if(hci_num_reset_loops > 2000)
788  hci_num_reset_loops = 2000;
789 #ifdef DEBUG_USB_HOST
790  Notify(PSTR("\r\nNo response to HCI Reset"), 0x80);
791 #endif
792  hci_state = HCI_INIT_STATE;
793  hci_counter = 0;
794  }
795  break;
796 
797  case HCI_CLASS_STATE:
798  if(hci_check_flag(HCI_FLAG_CMD_COMPLETE)) {
799 #ifdef DEBUG_USB_HOST
800  Notify(PSTR("\r\nWrite class of device"), 0x80);
801 #endif
802  hci_state = HCI_BDADDR_STATE;
803  hci_read_bdaddr();
804  }
805  break;
806 
807  case HCI_BDADDR_STATE:
808  if(hci_check_flag(HCI_FLAG_READ_BDADDR)) {
809 #ifdef DEBUG_USB_HOST
810  Notify(PSTR("\r\nLocal Bluetooth Address: "), 0x80);
811  for(int8_t i = 5; i > 0; i--) {
812  D_PrintHex<uint8_t > (my_bdaddr[i], 0x80);
813  Notify(PSTR(":"), 0x80);
814  }
815  D_PrintHex<uint8_t > (my_bdaddr[0], 0x80);
816 #endif
817  hci_read_local_version_information();
818  hci_state = HCI_LOCAL_VERSION_STATE;
819  }
820  break;
821 
822  case HCI_LOCAL_VERSION_STATE: // The local version is used by the PS3BT class
823  if(hci_check_flag(HCI_FLAG_READ_VERSION)) {
824  if(btdName != NULL) {
825  hci_write_local_name(btdName);
826  hci_state = HCI_WRITE_NAME_STATE;
827  } else if(useSimplePairing) {
828  hci_read_local_extended_features(0); // "Requests the normal LMP features as returned by Read_Local_Supported_Features"
829  //hci_read_local_extended_features(1); // Read page 1
830  hci_state = HCI_LOCAL_EXTENDED_FEATURES_STATE;
831  } else
832  hci_state = HCI_CHECK_DEVICE_SERVICE;
833  }
834  break;
835 
836  case HCI_WRITE_NAME_STATE:
837  if(hci_check_flag(HCI_FLAG_CMD_COMPLETE)) {
838 #ifdef DEBUG_USB_HOST
839  Notify(PSTR("\r\nThe name was set to: "), 0x80);
840  NotifyStr(btdName, 0x80);
841 #endif
842  if(useSimplePairing) {
843  hci_read_local_extended_features(0); // "Requests the normal LMP features as returned by Read_Local_Supported_Features"
844  //hci_read_local_extended_features(1); // Read page 1
845  hci_state = HCI_LOCAL_EXTENDED_FEATURES_STATE;
846  } else
847  hci_state = HCI_CHECK_DEVICE_SERVICE;
848  }
849  break;
850 
851  case HCI_LOCAL_EXTENDED_FEATURES_STATE:
852  if(hci_check_flag(HCI_FLAG_LOCAL_EXTENDED_FEATURES)) {
853  if(simple_pairing_supported) {
854  hci_write_simple_pairing_mode(true);
855  hci_state = HCI_WRITE_SIMPLE_PAIRING_STATE;
856  } else
857  hci_state = HCI_CHECK_DEVICE_SERVICE;
858  }
859  break;
860 
861  case HCI_WRITE_SIMPLE_PAIRING_STATE:
862  if(hci_check_flag(HCI_FLAG_CMD_COMPLETE)) {
863 #ifdef DEBUG_USB_HOST
864  Notify(PSTR("\r\nSimple pairing was enabled"), 0x80);
865 #endif
866  hci_set_event_mask();
867  hci_state = HCI_SET_EVENT_MASK_STATE;
868  }
869  break;
870 
871  case HCI_SET_EVENT_MASK_STATE:
872  if(hci_check_flag(HCI_FLAG_CMD_COMPLETE)) {
873 #ifdef DEBUG_USB_HOST
874  Notify(PSTR("\r\nSet event mask completed"), 0x80);
875 #endif
876  hci_state = HCI_CHECK_DEVICE_SERVICE;
877  }
878  break;
879 
880  case HCI_CHECK_DEVICE_SERVICE:
881  if(pairWithHIDDevice || pairWithWii) { // Check if it should try to connect to a Wiimote
882 #ifdef DEBUG_USB_HOST
883  if(pairWithWii)
884  Notify(PSTR("\r\nStarting inquiry\r\nPress 1 & 2 on the Wiimote\r\nOr press the SYNC button if you are using a Wii U Pro Controller or a Wii Balance Board"), 0x80);
885  else
886  Notify(PSTR("\r\nPlease enable discovery of your device"), 0x80);
887 #endif
888  hci_inquiry();
889  hci_state = HCI_INQUIRY_STATE;
890  } else
891  hci_state = HCI_SCANNING_STATE; // Don't try to connect to a Wiimote
892  break;
893 
894  case HCI_INQUIRY_STATE:
895  if(hci_check_flag(HCI_FLAG_DEVICE_FOUND)) {
896  hci_inquiry_cancel(); // Stop inquiry
897 #ifdef DEBUG_USB_HOST
898  if(pairWithWii)
899  Notify(PSTR("\r\nWiimote found"), 0x80);
900  else
901  Notify(PSTR("\r\nHID device found"), 0x80);
902 
903  Notify(PSTR("\r\nNow just create the instance like so:"), 0x80);
904  if(pairWithWii)
905  Notify(PSTR("\r\nWII Wii(&Btd);"), 0x80);
906  else
907  Notify(PSTR("\r\nBTHID bthid(&Btd);"), 0x80);
908 
909  Notify(PSTR("\r\nAnd then press any button on the "), 0x80);
910  if(pairWithWii)
911  Notify(PSTR("Wiimote"), 0x80);
912  else
913  Notify(PSTR("device"), 0x80);
914 #endif
915  if(checkRemoteName) {
916  hci_remote_name(); // We need to know the name to distinguish between the Wiimote, the new Wiimote with Motion Plus inside, a Wii U Pro Controller and a Wii Balance Board
917  hci_state = HCI_REMOTE_NAME_STATE;
918  } else
919  hci_state = HCI_CONNECT_DEVICE_STATE;
920  }
921  break;
922 
923  case HCI_CONNECT_DEVICE_STATE:
924  if(hci_check_flag(HCI_FLAG_CMD_COMPLETE)) {
925 #ifdef DEBUG_USB_HOST
926  if(pairWithWii)
927  Notify(PSTR("\r\nConnecting to Wiimote"), 0x80);
928  else
929  Notify(PSTR("\r\nConnecting to HID device"), 0x80);
930 #endif
931  checkRemoteName = false;
932  hci_connect();
933  hci_state = HCI_CONNECTED_DEVICE_STATE;
934  }
935  break;
936 
937  case HCI_CONNECTED_DEVICE_STATE:
938  if(hci_check_flag(HCI_FLAG_CONNECT_EVENT)) {
939  if(hci_check_flag(HCI_FLAG_CONNECT_COMPLETE)) {
940 #ifdef DEBUG_USB_HOST
941  if(pairWithWii)
942  Notify(PSTR("\r\nConnected to Wiimote"), 0x80);
943  else
944  Notify(PSTR("\r\nConnected to HID device"), 0x80);
945 #endif
946  hci_authentication_request(); // This will start the pairing with the device
947  hci_state = HCI_SCANNING_STATE;
948  } else {
949 #ifdef DEBUG_USB_HOST
950  Notify(PSTR("\r\nTrying to connect one more time..."), 0x80);
951 #endif
952  hci_connect(); // Try to connect one more time
953  }
954  }
955  break;
956 
957  case HCI_SCANNING_STATE:
958  if(!connectToWii && !pairWithWii && !connectToHIDDevice && !pairWithHIDDevice) {
959 #ifdef DEBUG_USB_HOST
960  Notify(PSTR("\r\nWait For Incoming Connection Request"), 0x80);
961 #endif
962  hci_write_scan_enable();
963  waitingForConnection = true;
964  hci_state = HCI_CONNECT_IN_STATE;
965  }
966  break;
967 
968  case HCI_CONNECT_IN_STATE:
969  if(hci_check_flag(HCI_FLAG_INCOMING_REQUEST)) {
970  waitingForConnection = false;
971 #ifdef DEBUG_USB_HOST
972  Notify(PSTR("\r\nIncoming Connection Request"), 0x80);
973 #endif
974  hci_remote_name();
975  hci_state = HCI_REMOTE_NAME_STATE;
976  } else if(hci_check_flag(HCI_FLAG_DISCONNECT_COMPLETE))
977  hci_state = HCI_DISCONNECT_STATE;
978  break;
979 
980  case HCI_REMOTE_NAME_STATE:
981  if(hci_check_flag(HCI_FLAG_REMOTE_NAME_COMPLETE)) {
982 #ifdef DEBUG_USB_HOST
983  Notify(PSTR("\r\nRemote Name: "), 0x80);
984  for(uint8_t i = 0; i < strlen(remote_name); i++)
985  Notifyc(remote_name[i], 0x80);
986 #endif
987  if(strncmp((const char*)remote_name, "Nintendo", 8) == 0) {
988  incomingWii = true;
989  motionPlusInside = false;
990  wiiUProController = false;
991  pairWiiUsingSync = false;
992 #ifdef DEBUG_USB_HOST
993  Notify(PSTR("\r\nWiimote is connecting"), 0x80);
994 #endif
995  if(strncmp((const char*)remote_name, "Nintendo RVL-CNT-01-TR", 22) == 0) {
996 #ifdef DEBUG_USB_HOST
997  Notify(PSTR(" with Motion Plus Inside"), 0x80);
998 #endif
999  motionPlusInside = true;
1000  } else if(strncmp((const char*)remote_name, "Nintendo RVL-CNT-01-UC", 22) == 0) {
1001 #ifdef DEBUG_USB_HOST
1002  Notify(PSTR(" - Wii U Pro Controller"), 0x80);
1003 #endif
1004  wiiUProController = motionPlusInside = pairWiiUsingSync = true;
1005  } else if(strncmp((const char*)remote_name, "Nintendo RVL-WBC-01", 19) == 0) {
1006 #ifdef DEBUG_USB_HOST
1007  Notify(PSTR(" - Wii Balance Board"), 0x80);
1008 #endif
1009  pairWiiUsingSync = true;
1010  }
1011  }
1012  if(classOfDevice[2] == 0 && classOfDevice[1] == 0x25 && classOfDevice[0] == 0x08 && strncmp((const char*)remote_name, "Wireless Controller", 19) == 0) {
1013 #ifdef DEBUG_USB_HOST
1014  Notify(PSTR("\r\nPS4 controller is connecting"), 0x80);
1015 #endif
1016  incomingPS4 = true;
1017  }
1018  if((pairWithWii || pairWithHIDDevice) && checkRemoteName)
1019  hci_state = HCI_CONNECT_DEVICE_STATE;
1020  else {
1021  hci_accept_connection();
1022  hci_state = HCI_CONNECTED_STATE;
1023  }
1024  }
1025  break;
1026 
1027  case HCI_CONNECTED_STATE:
1028  if(hci_check_flag(HCI_FLAG_CONNECT_COMPLETE)) {
1029 #ifdef DEBUG_USB_HOST
1030  Notify(PSTR("\r\nConnected to Device: "), 0x80);
1031  for(int8_t i = 5; i > 0; i--) {
1032  D_PrintHex<uint8_t > (disc_bdaddr[i], 0x80);
1033  Notify(PSTR(":"), 0x80);
1034  }
1035  D_PrintHex<uint8_t > (disc_bdaddr[0], 0x80);
1036 #endif
1037  if(incomingPS4)
1038  connectToHIDDevice = true; // We should always connect to the PS4 controller
1039 
1040  // Clear these flags for a new connection
1041  l2capConnectionClaimed = false;
1042  sdpConnectionClaimed = false;
1043  rfcommConnectionClaimed = false;
1044 
1045  hci_event_flag = 0;
1046  hci_state = HCI_DONE_STATE;
1047  }
1048  break;
1049 
1050  case HCI_DONE_STATE:
1051  hci_counter++;
1052  if(hci_counter > 1000) { // Wait until we have looped 1000 times to make sure that the L2CAP connection has been started
1053  hci_counter = 0;
1054  hci_state = HCI_SCANNING_STATE;
1055  }
1056  break;
1057 
1058  case HCI_DISCONNECT_STATE:
1059  if(hci_check_flag(HCI_FLAG_DISCONNECT_COMPLETE)) {
1060 #ifdef DEBUG_USB_HOST
1061  Notify(PSTR("\r\nHCI Disconnected from Device"), 0x80);
1062 #endif
1063  hci_event_flag = 0; // Clear all flags
1064 
1065  // Reset all buffers
1066  memset(hcibuf, 0, BULK_MAXPKTSIZE);
1067  memset(l2capinbuf, 0, BULK_MAXPKTSIZE);
1068 
1069  connectToWii = incomingWii = pairWithWii = false;
1070  connectToHIDDevice = incomingHIDDevice = pairWithHIDDevice = checkRemoteName = false;
1071  incomingPS4 = false;
1072 
1073  hci_state = HCI_SCANNING_STATE;
1074  }
1075  break;
1076  default:
1077  break;
1078  }
1079 }
1080 
1081 void BTD::ACL_event_task() {
1082  uint16_t length = BULK_MAXPKTSIZE;
1083  uint8_t rcode = pUsb->inTransfer(bAddress, epInfo[ BTD_DATAIN_PIPE ].epAddr, &length, l2capinbuf, pollInterval); // Input on endpoint 2
1084 
1085  if(!rcode) { // Check for errors
1086  if(length > 0) { // Check if any data was read
1087  for(uint8_t i = 0; i < BTD_NUM_SERVICES; i++) {
1088  if(btService[i])
1089  btService[i]->ACLData(l2capinbuf);
1090  }
1091  }
1092  }
1093 #ifdef EXTRADEBUG
1094  else if(rcode != hrNAK) {
1095  Notify(PSTR("\r\nACL data in error: "), 0x80);
1096  D_PrintHex<uint8_t > (rcode, 0x80);
1097  }
1098 #endif
1099  for(uint8_t i = 0; i < BTD_NUM_SERVICES; i++)
1100  if(btService[i])
1101  btService[i]->Run();
1102 }
1103 
1104 /************************************************************/
1105 /* HCI Commands */
1106 
1107 /************************************************************/
1108 void BTD::HCI_Command(uint8_t* data, uint16_t nbytes) {
1109  hci_clear_flag(HCI_FLAG_CMD_COMPLETE);
1110  pUsb->ctrlReq(bAddress, epInfo[ BTD_CONTROL_PIPE ].epAddr, bmREQ_HCI_OUT, 0x00, 0x00, 0x00, 0x00, nbytes, nbytes, data, NULL);
1111 }
1112 
1113 void BTD::hci_reset() {
1114  hci_event_flag = 0; // Clear all the flags
1115  hcibuf[0] = 0x03; // HCI OCF = 3
1116  hcibuf[1] = 0x03 << 2; // HCI OGF = 3
1117  hcibuf[2] = 0x00;
1118 
1119  HCI_Command(hcibuf, 3);
1120 }
1121 
1122 void BTD::hci_write_scan_enable() {
1123  hci_clear_flag(HCI_FLAG_INCOMING_REQUEST);
1124  hcibuf[0] = 0x1A; // HCI OCF = 1A
1125  hcibuf[1] = 0x03 << 2; // HCI OGF = 3
1126  hcibuf[2] = 0x01; // parameter length = 1
1127  if(btdName != NULL)
1128  hcibuf[3] = 0x03; // Inquiry Scan enabled. Page Scan enabled.
1129  else
1130  hcibuf[3] = 0x02; // Inquiry Scan disabled. Page Scan enabled.
1131 
1132  HCI_Command(hcibuf, 4);
1133 }
1134 
1135 void BTD::hci_write_scan_disable() {
1136  hcibuf[0] = 0x1A; // HCI OCF = 1A
1137  hcibuf[1] = 0x03 << 2; // HCI OGF = 3
1138  hcibuf[2] = 0x01; // parameter length = 1
1139  hcibuf[3] = 0x00; // Inquiry Scan disabled. Page Scan disabled.
1140 
1141  HCI_Command(hcibuf, 4);
1142 }
1143 
1144 void BTD::hci_read_bdaddr() {
1145  hci_clear_flag(HCI_FLAG_READ_BDADDR);
1146  hcibuf[0] = 0x09; // HCI OCF = 9
1147  hcibuf[1] = 0x04 << 2; // HCI OGF = 4
1148  hcibuf[2] = 0x00;
1149 
1150  HCI_Command(hcibuf, 3);
1151 }
1152 
1153 void BTD::hci_read_local_version_information() {
1154  hci_clear_flag(HCI_FLAG_READ_VERSION);
1155  hcibuf[0] = 0x01; // HCI OCF = 1
1156  hcibuf[1] = 0x04 << 2; // HCI OGF = 4
1157  hcibuf[2] = 0x00;
1158 
1159  HCI_Command(hcibuf, 3);
1160 }
1161 
1162 void BTD::hci_read_local_extended_features(uint8_t page_number) {
1163  hci_clear_flag(HCI_FLAG_LOCAL_EXTENDED_FEATURES);
1164  hcibuf[0] = 0x04; // HCI OCF = 4
1165  hcibuf[1] = 0x04 << 2; // HCI OGF = 4
1166  hcibuf[2] = 0x01; // parameter length = 1
1167  hcibuf[3] = page_number;
1168 
1169  HCI_Command(hcibuf, 4);
1170 }
1171 
1172 void BTD::hci_accept_connection() {
1173  hci_clear_flag(HCI_FLAG_CONNECT_COMPLETE);
1174  hcibuf[0] = 0x09; // HCI OCF = 9
1175  hcibuf[1] = 0x01 << 2; // HCI OGF = 1
1176  hcibuf[2] = 0x07; // parameter length 7
1177  hcibuf[3] = disc_bdaddr[0]; // 6 octet bdaddr
1178  hcibuf[4] = disc_bdaddr[1];
1179  hcibuf[5] = disc_bdaddr[2];
1180  hcibuf[6] = disc_bdaddr[3];
1181  hcibuf[7] = disc_bdaddr[4];
1182  hcibuf[8] = disc_bdaddr[5];
1183  hcibuf[9] = 0x00; // Switch role to master
1184 
1185  HCI_Command(hcibuf, 10);
1186 }
1187 
1188 void BTD::hci_remote_name() {
1189  hci_clear_flag(HCI_FLAG_REMOTE_NAME_COMPLETE);
1190  hcibuf[0] = 0x19; // HCI OCF = 19
1191  hcibuf[1] = 0x01 << 2; // HCI OGF = 1
1192  hcibuf[2] = 0x0A; // parameter length = 10
1193  hcibuf[3] = disc_bdaddr[0]; // 6 octet bdaddr
1194  hcibuf[4] = disc_bdaddr[1];
1195  hcibuf[5] = disc_bdaddr[2];
1196  hcibuf[6] = disc_bdaddr[3];
1197  hcibuf[7] = disc_bdaddr[4];
1198  hcibuf[8] = disc_bdaddr[5];
1199  hcibuf[9] = 0x01; // Page Scan Repetition Mode
1200  hcibuf[10] = 0x00; // Reserved
1201  hcibuf[11] = 0x00; // Clock offset - low byte
1202  hcibuf[12] = 0x00; // Clock offset - high byte
1203 
1204  HCI_Command(hcibuf, 13);
1205 }
1206 
1207 void BTD::hci_write_local_name(const char* name) {
1208  hcibuf[0] = 0x13; // HCI OCF = 13
1209  hcibuf[1] = 0x03 << 2; // HCI OGF = 3
1210  hcibuf[2] = strlen(name) + 1; // parameter length = the length of the string + end byte
1211  uint8_t i;
1212  for(i = 0; i < strlen(name); i++)
1213  hcibuf[i + 3] = name[i];
1214  hcibuf[i + 3] = 0x00; // End of string
1215 
1216  HCI_Command(hcibuf, 4 + strlen(name));
1217 }
1218 
1219 void BTD::hci_set_event_mask() {
1220  hcibuf[0] = 0x01; // HCI OCF = 01
1221  hcibuf[1] = 0x03 << 2; // HCI OGF = 3
1222  hcibuf[2] = 0x08;
1223  // The first 6 bytes are the default of 1FFF FFFF FFFF
1224  // However we need to set bits 48-55 for simple pairing to work
1225  hcibuf[3] = 0xFF;
1226  hcibuf[4] = 0xFF;
1227  hcibuf[5] = 0xFF;
1228  hcibuf[6] = 0xFF;
1229  hcibuf[7] = 0xFF;
1230  hcibuf[8] = 0x1F;
1231  hcibuf[9] = 0xFF; // Enable bits 48-55 used for simple pairing
1232  hcibuf[10] = 0x00;
1233 
1234  HCI_Command(hcibuf, 11);
1235 }
1236 
1237 void BTD::hci_write_simple_pairing_mode(bool enable) {
1238  hcibuf[0] = 0x56; // HCI OCF = 56
1239  hcibuf[1] = 0x03 << 2; // HCI OGF = 3
1240  hcibuf[2] = 1; // parameter length = 1
1241  hcibuf[3] = enable ? 1 : 0;
1242 
1243  HCI_Command(hcibuf, 4);
1244 }
1245 
1246 void BTD::hci_inquiry() {
1247  hci_clear_flag(HCI_FLAG_DEVICE_FOUND);
1248  hcibuf[0] = 0x01;
1249  hcibuf[1] = 0x01 << 2; // HCI OGF = 1
1250  hcibuf[2] = 0x05; // Parameter Total Length = 5
1251  hcibuf[3] = 0x33; // LAP: Genera/Unlimited Inquiry Access Code (GIAC = 0x9E8B33) - see https://www.bluetooth.org/Technical/AssignedNumbers/baseband.htm
1252  hcibuf[4] = 0x8B;
1253  hcibuf[5] = 0x9E;
1254  hcibuf[6] = 0x30; // Inquiry time = 61.44 sec (maximum)
1255  hcibuf[7] = 0x0A; // 10 number of responses
1256 
1257  HCI_Command(hcibuf, 8);
1258 }
1259 
1260 void BTD::hci_inquiry_cancel() {
1261  hcibuf[0] = 0x02;
1262  hcibuf[1] = 0x01 << 2; // HCI OGF = 1
1263  hcibuf[2] = 0x00; // Parameter Total Length = 0
1264 
1265  HCI_Command(hcibuf, 3);
1266 }
1267 
1268 void BTD::hci_connect() {
1269  hci_connect(disc_bdaddr); // Use last discovered device
1270 }
1271 
1272 void BTD::hci_connect(uint8_t *bdaddr) {
1273  hci_clear_flag(HCI_FLAG_CONNECT_COMPLETE | HCI_FLAG_CONNECT_EVENT);
1274  hcibuf[0] = 0x05; // HCI OCF = 5
1275  hcibuf[1] = 0x01 << 2; // HCI OGF = 1
1276  hcibuf[2] = 0x0D; // parameter Total Length = 13
1277  hcibuf[3] = bdaddr[0]; // 6 octet bdaddr (LSB)
1278  hcibuf[4] = bdaddr[1];
1279  hcibuf[5] = bdaddr[2];
1280  hcibuf[6] = bdaddr[3];
1281  hcibuf[7] = bdaddr[4];
1282  hcibuf[8] = bdaddr[5];
1283  hcibuf[9] = 0x18; // DM1 or DH1 may be used
1284  hcibuf[10] = 0xCC; // DM3, DH3, DM5, DH5 may be used
1285  hcibuf[11] = 0x01; // Page repetition mode R1
1286  hcibuf[12] = 0x00; // Reserved
1287  hcibuf[13] = 0x00; // Clock offset
1288  hcibuf[14] = 0x00; // Invalid clock offset
1289  hcibuf[15] = 0x00; // Do not allow role switch
1290 
1291  HCI_Command(hcibuf, 16);
1292 }
1293 
1294 void BTD::hci_pin_code_request_reply() {
1295  hcibuf[0] = 0x0D; // HCI OCF = 0D
1296  hcibuf[1] = 0x01 << 2; // HCI OGF = 1
1297  hcibuf[2] = 0x17; // parameter length 23
1298  hcibuf[3] = disc_bdaddr[0]; // 6 octet bdaddr
1299  hcibuf[4] = disc_bdaddr[1];
1300  hcibuf[5] = disc_bdaddr[2];
1301  hcibuf[6] = disc_bdaddr[3];
1302  hcibuf[7] = disc_bdaddr[4];
1303  hcibuf[8] = disc_bdaddr[5];
1304  if(pairWithWii) {
1305  hcibuf[9] = 6; // Pin length is the length of the Bluetooth address
1306  if(pairWiiUsingSync) {
1307 #ifdef DEBUG_USB_HOST
1308  Notify(PSTR("\r\nPairing with Wii controller via SYNC"), 0x80);
1309 #endif
1310  for(uint8_t i = 0; i < 6; i++)
1311  hcibuf[10 + i] = my_bdaddr[i]; // The pin is the Bluetooth dongles Bluetooth address backwards
1312  } else {
1313  for(uint8_t i = 0; i < 6; i++)
1314  hcibuf[10 + i] = disc_bdaddr[i]; // The pin is the Wiimote's Bluetooth address backwards
1315  }
1316  for(uint8_t i = 16; i < 26; i++)
1317  hcibuf[i] = 0x00; // The rest should be 0
1318  } else {
1319  hcibuf[9] = strlen(btdPin); // Length of pin
1320  uint8_t i;
1321  for(i = 0; i < strlen(btdPin); i++) // The maximum size of the pin is 16
1322  hcibuf[i + 10] = btdPin[i];
1323  for(; i < 16; i++)
1324  hcibuf[i + 10] = 0x00; // The rest should be 0
1325  }
1326 
1327  HCI_Command(hcibuf, 26);
1328 }
1329 
1330 void BTD::hci_pin_code_negative_request_reply() {
1331  hcibuf[0] = 0x0E; // HCI OCF = 0E
1332  hcibuf[1] = 0x01 << 2; // HCI OGF = 1
1333  hcibuf[2] = 0x06; // parameter length 6
1334  hcibuf[3] = disc_bdaddr[0]; // 6 octet bdaddr
1335  hcibuf[4] = disc_bdaddr[1];
1336  hcibuf[5] = disc_bdaddr[2];
1337  hcibuf[6] = disc_bdaddr[3];
1338  hcibuf[7] = disc_bdaddr[4];
1339  hcibuf[8] = disc_bdaddr[5];
1340 
1341  HCI_Command(hcibuf, 9);
1342 }
1343 
1344 void BTD::hci_link_key_request_negative_reply() {
1345  hcibuf[0] = 0x0C; // HCI OCF = 0C
1346  hcibuf[1] = 0x01 << 2; // HCI OGF = 1
1347  hcibuf[2] = 0x06; // parameter length 6
1348  hcibuf[3] = disc_bdaddr[0]; // 6 octet bdaddr
1349  hcibuf[4] = disc_bdaddr[1];
1350  hcibuf[5] = disc_bdaddr[2];
1351  hcibuf[6] = disc_bdaddr[3];
1352  hcibuf[7] = disc_bdaddr[4];
1353  hcibuf[8] = disc_bdaddr[5];
1354 
1355  HCI_Command(hcibuf, 9);
1356 }
1357 
1358 void BTD::hci_io_capability_request_reply() {
1359  hcibuf[0] = 0x2B; // HCI OCF = 2B
1360  hcibuf[1] = 0x01 << 2; // HCI OGF = 1
1361  hcibuf[2] = 0x09;
1362  hcibuf[3] = disc_bdaddr[0]; // 6 octet bdaddr
1363  hcibuf[4] = disc_bdaddr[1];
1364  hcibuf[5] = disc_bdaddr[2];
1365  hcibuf[6] = disc_bdaddr[3];
1366  hcibuf[7] = disc_bdaddr[4];
1367  hcibuf[8] = disc_bdaddr[5];
1368  hcibuf[9] = 0x03; // NoInputNoOutput
1369  hcibuf[10] = 0x00; // OOB authentication data not present
1370  hcibuf[11] = 0x00; // MITM Protection Not Required – No Bonding. Numeric comparison with automatic accept allowed
1371 
1372  HCI_Command(hcibuf, 12);
1373 }
1374 
1375 void BTD::hci_user_confirmation_request_reply() {
1376  hcibuf[0] = 0x2C; // HCI OCF = 2C
1377  hcibuf[1] = 0x01 << 2; // HCI OGF = 1
1378  hcibuf[2] = 0x06; // parameter length 6
1379  hcibuf[3] = disc_bdaddr[0]; // 6 octet bdaddr
1380  hcibuf[4] = disc_bdaddr[1];
1381  hcibuf[5] = disc_bdaddr[2];
1382  hcibuf[6] = disc_bdaddr[3];
1383  hcibuf[7] = disc_bdaddr[4];
1384  hcibuf[8] = disc_bdaddr[5];
1385 
1386  HCI_Command(hcibuf, 9);
1387 }
1388 
1389 void BTD::hci_authentication_request() {
1390  hcibuf[0] = 0x11; // HCI OCF = 11
1391  hcibuf[1] = 0x01 << 2; // HCI OGF = 1
1392  hcibuf[2] = 0x02; // parameter length = 2
1393  hcibuf[3] = (uint8_t)(hci_handle & 0xFF); //connection handle - low byte
1394  hcibuf[4] = (uint8_t)((hci_handle >> 8) & 0x0F); //connection handle - high byte
1395 
1396  HCI_Command(hcibuf, 5);
1397 }
1398 
1399 void BTD::hci_disconnect(uint16_t handle) { // This is called by the different services
1400  hci_clear_flag(HCI_FLAG_DISCONNECT_COMPLETE);
1401  hcibuf[0] = 0x06; // HCI OCF = 6
1402  hcibuf[1] = 0x01 << 2; // HCI OGF = 1
1403  hcibuf[2] = 0x03; // parameter length = 3
1404  hcibuf[3] = (uint8_t)(handle & 0xFF); //connection handle - low byte
1405  hcibuf[4] = (uint8_t)((handle >> 8) & 0x0F); //connection handle - high byte
1406  hcibuf[5] = 0x13; // reason
1407 
1408  HCI_Command(hcibuf, 6);
1409 }
1410 
1411 void BTD::hci_write_class_of_device() { // See http://bluetooth-pentest.narod.ru/software/bluetooth_class_of_device-service_generator.html
1412  hcibuf[0] = 0x24; // HCI OCF = 24
1413  hcibuf[1] = 0x03 << 2; // HCI OGF = 3
1414  hcibuf[2] = 0x03; // parameter length = 3
1415  hcibuf[3] = 0x04; // Robot
1416  hcibuf[4] = 0x08; // Toy
1417  hcibuf[5] = 0x00;
1418 
1419  HCI_Command(hcibuf, 6);
1420 }
1421 /*******************************************************************
1422  * *
1423  * HCI ACL Data Packet *
1424  * *
1425  * buf[0] buf[1] buf[2] buf[3]
1426  * 0 4 8 11 12 16 24 31 MSB
1427  * .-+-+-+-+-+-+-+-|-+-+-+-|-+-|-+-|-+-+-+-+-+-+-+-|-+-+-+-+-+-+-+-.
1428  * | HCI Handle |PB |BC | Data Total Length | HCI ACL Data Packet
1429  * .-+-+-+-+-+-+-+-|-+-+-+-|-+-|-+-|-+-+-+-+-+-+-+-|-+-+-+-+-+-+-+-.
1430  *
1431  * buf[4] buf[5] buf[6] buf[7]
1432  * 0 8 16 31 MSB
1433  * .-+-+-+-+-+-+-+-|-+-+-+-+-+-+-+-|-+-+-+-+-+-+-+-|-+-+-+-+-+-+-+-.
1434  * | Length | Channel ID | Basic L2CAP header
1435  * .-+-+-+-+-+-+-+-|-+-+-+-+-+-+-+-|-+-+-+-+-+-+-+-|-+-+-+-+-+-+-+-.
1436  *
1437  * buf[8] buf[9] buf[10] buf[11]
1438  * 0 8 16 31 MSB
1439  * .-+-+-+-+-+-+-+-|-+-+-+-+-+-+-+-|-+-+-+-+-+-+-+-|-+-+-+-+-+-+-+-.
1440  * | Code | Identifier | Length | Control frame (C-frame)
1441  * .-+-+-+-+-+-+-+-|-+-+-+-+-+-+-+-|-+-+-+-+-+-+-+-|-+-+-+-+-+-+-+-. (signaling packet format)
1442  */
1443 /************************************************************/
1444 /* L2CAP Commands */
1445 
1446 /************************************************************/
1447 void BTD::L2CAP_Command(uint16_t handle, uint8_t* data, uint8_t nbytes, uint8_t channelLow, uint8_t channelHigh) {
1448  uint8_t buf[8 + nbytes];
1449  buf[0] = (uint8_t)(handle & 0xff); // HCI handle with PB,BC flag
1450  buf[1] = (uint8_t)(((handle >> 8) & 0x0f) | 0x20);
1451  buf[2] = (uint8_t)((4 + nbytes) & 0xff); // HCI ACL total data length
1452  buf[3] = (uint8_t)((4 + nbytes) >> 8);
1453  buf[4] = (uint8_t)(nbytes & 0xff); // L2CAP header: Length
1454  buf[5] = (uint8_t)(nbytes >> 8);
1455  buf[6] = channelLow;
1456  buf[7] = channelHigh;
1457 
1458  for(uint16_t i = 0; i < nbytes; i++) // L2CAP C-frame
1459  buf[8 + i] = data[i];
1460 
1461  uint8_t rcode = pUsb->outTransfer(bAddress, epInfo[ BTD_DATAOUT_PIPE ].epAddr, (8 + nbytes), buf);
1462  if(rcode) {
1463  delay(100); // This small delay prevents it from overflowing if it fails
1464 #ifdef DEBUG_USB_HOST
1465  Notify(PSTR("\r\nError sending L2CAP message: 0x"), 0x80);
1466  D_PrintHex<uint8_t > (rcode, 0x80);
1467  Notify(PSTR(" - Channel ID: "), 0x80);
1468  D_PrintHex<uint8_t > (channelHigh, 0x80);
1469  Notify(PSTR(" "), 0x80);
1470  D_PrintHex<uint8_t > (channelLow, 0x80);
1471 #endif
1472  }
1473 }
1474 
1475 void BTD::l2cap_connection_request(uint16_t handle, uint8_t rxid, uint8_t* scid, uint16_t psm) {
1476  l2capoutbuf[0] = L2CAP_CMD_CONNECTION_REQUEST; // Code
1477  l2capoutbuf[1] = rxid; // Identifier
1478  l2capoutbuf[2] = 0x04; // Length
1479  l2capoutbuf[3] = 0x00;
1480  l2capoutbuf[4] = (uint8_t)(psm & 0xff); // PSM
1481  l2capoutbuf[5] = (uint8_t)(psm >> 8);
1482  l2capoutbuf[6] = scid[0]; // Source CID
1483  l2capoutbuf[7] = scid[1];
1484 
1485  L2CAP_Command(handle, l2capoutbuf, 8);
1486 }
1487 
1488 void BTD::l2cap_connection_response(uint16_t handle, uint8_t rxid, uint8_t* dcid, uint8_t* scid, uint8_t result) {
1489  l2capoutbuf[0] = L2CAP_CMD_CONNECTION_RESPONSE; // Code
1490  l2capoutbuf[1] = rxid; // Identifier
1491  l2capoutbuf[2] = 0x08; // Length
1492  l2capoutbuf[3] = 0x00;
1493  l2capoutbuf[4] = dcid[0]; // Destination CID
1494  l2capoutbuf[5] = dcid[1];
1495  l2capoutbuf[6] = scid[0]; // Source CID
1496  l2capoutbuf[7] = scid[1];
1497  l2capoutbuf[8] = result; // Result: Pending or Success
1498  l2capoutbuf[9] = 0x00;
1499  l2capoutbuf[10] = 0x00; // No further information
1500  l2capoutbuf[11] = 0x00;
1501 
1502  L2CAP_Command(handle, l2capoutbuf, 12);
1503 }
1504 
1505 void BTD::l2cap_config_request(uint16_t handle, uint8_t rxid, uint8_t* dcid) {
1506  l2capoutbuf[0] = L2CAP_CMD_CONFIG_REQUEST; // Code
1507  l2capoutbuf[1] = rxid; // Identifier
1508  l2capoutbuf[2] = 0x08; // Length
1509  l2capoutbuf[3] = 0x00;
1510  l2capoutbuf[4] = dcid[0]; // Destination CID
1511  l2capoutbuf[5] = dcid[1];
1512  l2capoutbuf[6] = 0x00; // Flags
1513  l2capoutbuf[7] = 0x00;
1514  l2capoutbuf[8] = 0x01; // Config Opt: type = MTU (Maximum Transmission Unit) - Hint
1515  l2capoutbuf[9] = 0x02; // Config Opt: length
1516  l2capoutbuf[10] = 0xFF; // MTU
1517  l2capoutbuf[11] = 0xFF;
1518 
1519  L2CAP_Command(handle, l2capoutbuf, 12);
1520 }
1521 
1522 void BTD::l2cap_config_response(uint16_t handle, uint8_t rxid, uint8_t* scid) {
1523  l2capoutbuf[0] = L2CAP_CMD_CONFIG_RESPONSE; // Code
1524  l2capoutbuf[1] = rxid; // Identifier
1525  l2capoutbuf[2] = 0x0A; // Length
1526  l2capoutbuf[3] = 0x00;
1527  l2capoutbuf[4] = scid[0]; // Source CID
1528  l2capoutbuf[5] = scid[1];
1529  l2capoutbuf[6] = 0x00; // Flag
1530  l2capoutbuf[7] = 0x00;
1531  l2capoutbuf[8] = 0x00; // Result
1532  l2capoutbuf[9] = 0x00;
1533  l2capoutbuf[10] = 0x01; // Config
1534  l2capoutbuf[11] = 0x02;
1535  l2capoutbuf[12] = 0xA0;
1536  l2capoutbuf[13] = 0x02;
1537 
1538  L2CAP_Command(handle, l2capoutbuf, 14);
1539 }
1540 
1541 void BTD::l2cap_disconnection_request(uint16_t handle, uint8_t rxid, uint8_t* dcid, uint8_t* scid) {
1542  l2capoutbuf[0] = L2CAP_CMD_DISCONNECT_REQUEST; // Code
1543  l2capoutbuf[1] = rxid; // Identifier
1544  l2capoutbuf[2] = 0x04; // Length
1545  l2capoutbuf[3] = 0x00;
1546  l2capoutbuf[4] = dcid[0];
1547  l2capoutbuf[5] = dcid[1];
1548  l2capoutbuf[6] = scid[0];
1549  l2capoutbuf[7] = scid[1];
1550 
1551  L2CAP_Command(handle, l2capoutbuf, 8);
1552 }
1553 
1554 void BTD::l2cap_disconnection_response(uint16_t handle, uint8_t rxid, uint8_t* dcid, uint8_t* scid) {
1555  l2capoutbuf[0] = L2CAP_CMD_DISCONNECT_RESPONSE; // Code
1556  l2capoutbuf[1] = rxid; // Identifier
1557  l2capoutbuf[2] = 0x04; // Length
1558  l2capoutbuf[3] = 0x00;
1559  l2capoutbuf[4] = dcid[0];
1560  l2capoutbuf[5] = dcid[1];
1561  l2capoutbuf[6] = scid[0];
1562  l2capoutbuf[7] = scid[1];
1563 
1564  L2CAP_Command(handle, l2capoutbuf, 8);
1565 }
1566 
1567 void BTD::l2cap_information_response(uint16_t handle, uint8_t rxid, uint8_t infoTypeLow, uint8_t infoTypeHigh) {
1568  l2capoutbuf[0] = L2CAP_CMD_INFORMATION_RESPONSE; // Code
1569  l2capoutbuf[1] = rxid; // Identifier
1570  l2capoutbuf[2] = 0x08; // Length
1571  l2capoutbuf[3] = 0x00;
1572  l2capoutbuf[4] = infoTypeLow;
1573  l2capoutbuf[5] = infoTypeHigh;
1574  l2capoutbuf[6] = 0x00; // Result = success
1575  l2capoutbuf[7] = 0x00; // Result = success
1576  l2capoutbuf[8] = 0x00;
1577  l2capoutbuf[9] = 0x00;
1578  l2capoutbuf[10] = 0x00;
1579  l2capoutbuf[11] = 0x00;
1580 
1581  L2CAP_Command(handle, l2capoutbuf, 12);
1582 }
1583 
1584 /* PS3 Commands - only set Bluetooth address is implemented in this library */
1585 void BTD::setBdaddr(uint8_t* bdaddr) {
1586  /* Set the internal Bluetooth address */
1587  uint8_t buf[8];
1588  buf[0] = 0x01;
1589  buf[1] = 0x00;
1590 
1591  for(uint8_t i = 0; i < 6; i++)
1592  buf[i + 2] = bdaddr[5 - i]; // Copy into buffer, has to be written reversed, so it is MSB first
1593 
1594  // bmRequest = Host to device (0x00) | Class (0x20) | Interface (0x01) = 0x21, bRequest = Set Report (0x09), Report ID (0xF5), Report Type (Feature 0x03), interface (0x00), datalength, datalength, data
1595  pUsb->ctrlReq(bAddress, epInfo[BTD_CONTROL_PIPE].epAddr, bmREQ_HID_OUT, HID_REQUEST_SET_REPORT, 0xF5, 0x03, 0x00, 8, 8, buf, NULL);
1596 }
1597 
1598 void BTD::setMoveBdaddr(uint8_t* bdaddr) {
1599  /* Set the internal Bluetooth address */
1600  uint8_t buf[11];
1601  buf[0] = 0x05;
1602  buf[7] = 0x10;
1603  buf[8] = 0x01;
1604  buf[9] = 0x02;
1605  buf[10] = 0x12;
1606 
1607  for(uint8_t i = 0; i < 6; i++)
1608  buf[i + 1] = bdaddr[i];
1609 
1610  // bmRequest = Host to device (0x00) | Class (0x20) | Interface (0x01) = 0x21, bRequest = Set Report (0x09), Report ID (0x05), Report Type (Feature 0x03), interface (0x00), datalength, datalength, data
1611  pUsb->ctrlReq(bAddress, epInfo[BTD_CONTROL_PIPE].epAddr, bmREQ_HID_OUT, HID_REQUEST_SET_REPORT, 0x05, 0x03, 0x00, 11, 11, buf, NULL);
1612 }
BTD::BTD_DATAOUT_PIPE
static const uint8_t BTD_DATAOUT_PIPE
Definition: BTD.h:558
+Go to the documentation of this file.
1 /* Copyright (C) 2012 Kristian Lauszus, TKJ Electronics. All rights reserved.
2 
3  This software may be distributed and modified under the terms of the GNU
4  General Public License version 2 (GPL2) as published by the Free Software
5  Foundation and appearing in the file GPL2.TXT included in the packaging of
6  this file. Please note that GPL2 Section 2[b] requires that all works based
7  on this software must also be made publicly available under the terms of
8  the GPL2 ("Copyleft").
9 
10  Contact information
11  -------------------
12 
13  Kristian Lauszus, TKJ Electronics
14  Web : http://www.tkjelectronics.com
15  e-mail : kristianl@tkjelectronics.com
16  */
17 
18 #include "BTD.h"
19 // To enable serial debugging see "settings.h"
20 //#define EXTRADEBUG // Uncomment to get even more debugging data
21 
22 const uint8_t BTD::BTD_CONTROL_PIPE = 0;
23 const uint8_t BTD::BTD_EVENT_PIPE = 1;
24 const uint8_t BTD::BTD_DATAIN_PIPE = 2;
25 const uint8_t BTD::BTD_DATAOUT_PIPE = 3;
26 
27 BTD::BTD(USB *p) :
28 connectToWii(false),
29 pairWithWii(false),
30 connectToHIDDevice(false),
31 pairWithHIDDevice(false),
32 useSimplePairing(false),
33 pUsb(p), // Pointer to USB class instance - mandatory
34 bAddress(0), // Device address - mandatory
35 bNumEP(1), // If config descriptor needs to be parsed
36 qNextPollTime(0), // Reset NextPollTime
37 pollInterval(0),
38 simple_pairing_supported(false),
39 bPollEnable(false) // Don't start polling before dongle is connected
40 {
41  for(uint8_t i = 0; i < BTD_NUM_SERVICES; i++)
42  btService[i] = NULL;
43 
44  Initialize(); // Set all variables, endpoint structs etc. to default values
45 
46  if(pUsb) // Register in USB subsystem
47  pUsb->RegisterDeviceClass(this); // Set devConfig[] entry
48 }
49 
50 uint8_t BTD::ConfigureDevice(uint8_t parent, uint8_t port, bool lowspeed) {
51  const uint8_t constBufSize = sizeof (USB_DEVICE_DESCRIPTOR);
52  uint8_t buf[constBufSize];
53  USB_DEVICE_DESCRIPTOR * udd = reinterpret_cast<USB_DEVICE_DESCRIPTOR*>(buf);
54  uint8_t rcode;
55  UsbDevice *p = NULL;
56  EpInfo *oldep_ptr = NULL;
57 
58  Initialize(); // Set all variables, endpoint structs etc. to default values
59 
60  AddressPool &addrPool = pUsb->GetAddressPool(); // Get memory address of USB device address pool
61 #ifdef EXTRADEBUG
62  Notify(PSTR("\r\nBTD ConfigureDevice"), 0x80);
63 #endif
64 
65  if(bAddress) { // Check if address has already been assigned to an instance
66 #ifdef DEBUG_USB_HOST
67  Notify(PSTR("\r\nAddress in use"), 0x80);
68 #endif
69  return USB_ERROR_CLASS_INSTANCE_ALREADY_IN_USE;
70  }
71 
72  p = addrPool.GetUsbDevicePtr(0); // Get pointer to pseudo device with address 0 assigned
73  if(!p) {
74 #ifdef DEBUG_USB_HOST
75  Notify(PSTR("\r\nAddress not found"), 0x80);
76 #endif
77  return USB_ERROR_ADDRESS_NOT_FOUND_IN_POOL;
78  }
79 
80  if(!p->epinfo) {
81 #ifdef DEBUG_USB_HOST
82  Notify(PSTR("\r\nepinfo is null"), 0x80);
83 #endif
84  return USB_ERROR_EPINFO_IS_NULL;
85  }
86 
87  oldep_ptr = p->epinfo; // Save old pointer to EP_RECORD of address 0
88  p->epinfo = epInfo; // Temporary assign new pointer to epInfo to p->epinfo in order to avoid toggle inconsistence
89  p->lowspeed = lowspeed;
90  rcode = pUsb->getDevDescr(0, 0, constBufSize, (uint8_t*)buf); // Get device descriptor - addr, ep, nbytes, data
91 
92  p->epinfo = oldep_ptr; // Restore p->epinfo
93 
94  if(rcode)
95  goto FailGetDevDescr;
96 
97  bAddress = addrPool.AllocAddress(parent, false, port); // Allocate new address according to device class
98 
99  if(!bAddress) {
100 #ifdef DEBUG_USB_HOST
101  Notify(PSTR("\r\nOut of address space"), 0x80);
102 #endif
103  return USB_ERROR_OUT_OF_ADDRESS_SPACE_IN_POOL;
104  }
105 
106  if (udd->bDeviceClass == 0x09) // Some dongles have an USB hub inside
107  goto FailHub;
108 
109  epInfo[0].maxPktSize = udd->bMaxPacketSize0; // Extract Max Packet Size from device descriptor
110  epInfo[1].epAddr = udd->bNumConfigurations; // Steal and abuse from epInfo structure to save memory
111 
112  VID = udd->idVendor;
113  PID = udd->idProduct;
114 
115  return USB_ERROR_CONFIG_REQUIRES_ADDITIONAL_RESET;
116 
117 FailHub:
118 #ifdef DEBUG_USB_HOST
119  Notify(PSTR("\r\nPlease create a hub instance in your code: \"USBHub Hub1(&Usb);\""), 0x80);
120 #endif
121  pUsb->setAddr(bAddress, 0, 0); // Reset address
122  rcode = USB_DEV_CONFIG_ERROR_DEVICE_NOT_SUPPORTED;
123  Release();
124  return rcode;
125 
126 FailGetDevDescr:
127 #ifdef DEBUG_USB_HOST
128  NotifyFailGetDevDescr(rcode);
129 #endif
130  if(rcode != hrJERR)
131  rcode = USB_ERROR_FailGetDevDescr;
132  Release();
133  return rcode;
134 };
135 
136 uint8_t BTD::Init(uint8_t parent __attribute__((unused)), uint8_t port __attribute__((unused)), bool lowspeed) {
137  uint8_t rcode;
138  uint8_t num_of_conf = epInfo[1].epAddr; // Number of configurations
139  epInfo[1].epAddr = 0;
140 
141  AddressPool &addrPool = pUsb->GetAddressPool();
142 #ifdef EXTRADEBUG
143  Notify(PSTR("\r\nBTD Init"), 0x80);
144 #endif
145  UsbDevice *p = addrPool.GetUsbDevicePtr(bAddress); // Get pointer to assigned address record
146 
147  if(!p) {
148 #ifdef DEBUG_USB_HOST
149  Notify(PSTR("\r\nAddress not found"), 0x80);
150 #endif
151  return USB_ERROR_ADDRESS_NOT_FOUND_IN_POOL;
152  }
153 
154  delay(300); // Assign new address to the device
155 
156  rcode = pUsb->setAddr(0, 0, bAddress); // Assign new address to the device
157  if(rcode) {
158 #ifdef DEBUG_USB_HOST
159  Notify(PSTR("\r\nsetAddr: "), 0x80);
160  D_PrintHex<uint8_t > (rcode, 0x80);
161 #endif
162  p->lowspeed = false;
163  goto Fail;
164  }
165 #ifdef EXTRADEBUG
166  Notify(PSTR("\r\nAddr: "), 0x80);
167  D_PrintHex<uint8_t > (bAddress, 0x80);
168 #endif
169 
170  p->lowspeed = false;
171 
172  p = addrPool.GetUsbDevicePtr(bAddress); // Get pointer to assigned address record
173  if(!p) {
174 #ifdef DEBUG_USB_HOST
175  Notify(PSTR("\r\nAddress not found"), 0x80);
176 #endif
177  return USB_ERROR_ADDRESS_NOT_FOUND_IN_POOL;
178  }
179 
180  p->lowspeed = lowspeed;
181 
182  rcode = pUsb->setEpInfoEntry(bAddress, 1, epInfo); // Assign epInfo to epinfo pointer - only EP0 is known
183  if(rcode)
184  goto FailSetDevTblEntry;
185 
186  if(VID == PS3_VID && (PID == PS3_PID || PID == PS3NAVIGATION_PID || PID == PS3MOVE_PID)) {
187  delay(100);
188  rcode = pUsb->setConf(bAddress, epInfo[ BTD_CONTROL_PIPE ].epAddr, 1); // We only need the Control endpoint, so we don't have to initialize the other endpoints of device
189  if(rcode)
190  goto FailSetConfDescr;
191 
192 #ifdef DEBUG_USB_HOST
193  if(PID == PS3_PID || PID == PS3NAVIGATION_PID) {
194  if(PID == PS3_PID)
195  Notify(PSTR("\r\nDualshock 3 Controller Connected"), 0x80);
196  else // It must be a navigation controller
197  Notify(PSTR("\r\nNavigation Controller Connected"), 0x80);
198  } else // It must be a Motion controller
199  Notify(PSTR("\r\nMotion Controller Connected"), 0x80);
200 #endif
201 
202  if(my_bdaddr[0] == 0x00 && my_bdaddr[1] == 0x00 && my_bdaddr[2] == 0x00 && my_bdaddr[3] == 0x00 && my_bdaddr[4] == 0x00 && my_bdaddr[5] == 0x00) {
203 #ifdef DEBUG_USB_HOST
204  Notify(PSTR("\r\nPlease plug in the dongle before trying to pair with the PS3 Controller\r\nor set the Bluetooth address in the constructor of the PS3BT class"), 0x80);
205 #endif
206  } else {
207  if(PID == PS3_PID || PID == PS3NAVIGATION_PID)
208  setBdaddr(my_bdaddr); // Set internal Bluetooth address
209  else
210  setMoveBdaddr(my_bdaddr); // Set internal Bluetooth address
211 #ifdef DEBUG_USB_HOST
212  Notify(PSTR("\r\nBluetooth Address was set to: "), 0x80);
213  for(int8_t i = 5; i > 0; i--) {
214  D_PrintHex<uint8_t > (my_bdaddr[i], 0x80);
215  Notify(PSTR(":"), 0x80);
216  }
217  D_PrintHex<uint8_t > (my_bdaddr[0], 0x80);
218 #endif
219  }
220 
221  pUsb->setConf(bAddress, epInfo[ BTD_CONTROL_PIPE ].epAddr, 0); // Reset configuration value
222  pUsb->setAddr(bAddress, 0, 0); // Reset address
223  Release(); // Release device
224  return USB_DEV_CONFIG_ERROR_DEVICE_NOT_SUPPORTED; // Return
225  } else {
226  // Check if attached device is a Bluetooth dongle and fill endpoint data structure
227  // First interface in the configuration must have Bluetooth assigned Class/Subclass/Protocol
228  // And 3 endpoints - interrupt-IN, bulk-IN, bulk-OUT, not necessarily in this order
229  for(uint8_t i = 0; i < num_of_conf; i++) {
230  if((VID == IOGEAR_GBU521_VID && PID == IOGEAR_GBU521_PID) || (VID == BELKIN_F8T065BF_VID && PID == BELKIN_F8T065BF_PID)) {
231  ConfigDescParser<USB_CLASS_VENDOR_SPECIFIC, WI_SUBCLASS_RF, WI_PROTOCOL_BT, CP_MASK_COMPARE_ALL> confDescrParser(this); // Workaround issue with some dongles
232  rcode = pUsb->getConfDescr(bAddress, 0, i, &confDescrParser);
233  } else {
234  ConfigDescParser<USB_CLASS_WIRELESS_CTRL, WI_SUBCLASS_RF, WI_PROTOCOL_BT, CP_MASK_COMPARE_ALL> confDescrParser(this); // Set class id according to the specification
235  rcode = pUsb->getConfDescr(bAddress, 0, i, &confDescrParser);
236  }
237  if(rcode) // Check error code
238  goto FailGetConfDescr;
239  if(bNumEP >= BTD_MAX_ENDPOINTS) // All endpoints extracted
240  break;
241  }
242 
243  if(bNumEP < BTD_MAX_ENDPOINTS)
244  goto FailUnknownDevice;
245 
246  // Assign epInfo to epinfo pointer - this time all 3 endpoins
247  rcode = pUsb->setEpInfoEntry(bAddress, bNumEP, epInfo);
248  if(rcode)
249  goto FailSetDevTblEntry;
250 
251  // Set Configuration Value
252  rcode = pUsb->setConf(bAddress, epInfo[ BTD_CONTROL_PIPE ].epAddr, bConfNum);
253  if(rcode)
254  goto FailSetConfDescr;
255 
256  hci_num_reset_loops = 100; // only loop 100 times before trying to send the hci reset command
257  hci_counter = 0;
258  hci_state = HCI_INIT_STATE;
259  waitingForConnection = false;
260  bPollEnable = true;
261 
262 #ifdef DEBUG_USB_HOST
263  Notify(PSTR("\r\nBluetooth Dongle Initialized"), 0x80);
264 #endif
265  }
266  return 0; // Successful configuration
267 
268  /* Diagnostic messages */
269 FailSetDevTblEntry:
270 #ifdef DEBUG_USB_HOST
271  NotifyFailSetDevTblEntry();
272  goto Fail;
273 #endif
274 
275 FailGetConfDescr:
276 #ifdef DEBUG_USB_HOST
277  NotifyFailGetConfDescr();
278  goto Fail;
279 #endif
280 
281 FailSetConfDescr:
282 #ifdef DEBUG_USB_HOST
283  NotifyFailSetConfDescr();
284 #endif
285  goto Fail;
286 
287 FailUnknownDevice:
288 #ifdef DEBUG_USB_HOST
289  NotifyFailUnknownDevice(VID, PID);
290 #endif
291  pUsb->setAddr(bAddress, 0, 0); // Reset address
292  rcode = USB_DEV_CONFIG_ERROR_DEVICE_NOT_SUPPORTED;
293 Fail:
294 #ifdef DEBUG_USB_HOST
295  Notify(PSTR("\r\nBTD Init Failed, error code: "), 0x80);
296  NotifyFail(rcode);
297 #endif
298  Release();
299  return rcode;
300 }
301 
302 void BTD::Initialize() {
303  uint8_t i;
304  for(i = 0; i < BTD_MAX_ENDPOINTS; i++) {
305  epInfo[i].epAddr = 0;
306  epInfo[i].maxPktSize = (i) ? 0 : 8;
307  epInfo[i].bmSndToggle = 0;
308  epInfo[i].bmRcvToggle = 0;
309  epInfo[i].bmNakPower = (i) ? USB_NAK_NOWAIT : USB_NAK_MAX_POWER;
310  }
311  for(i = 0; i < BTD_NUM_SERVICES; i++) {
312  if(btService[i])
313  btService[i]->Reset(); // Reset all Bluetooth services
314  }
315 
316  connectToWii = false;
317  incomingWii = false;
318  connectToHIDDevice = false;
319  incomingHIDDevice = false;
320  incomingPSController = false;
321  bAddress = 0; // Clear device address
322  bNumEP = 1; // Must have to be reset to 1
323  qNextPollTime = 0; // Reset next poll time
324  pollInterval = 0;
325  bPollEnable = false; // Don't start polling before dongle is connected
326  simple_pairing_supported = false;
327 }
328 
329 /* Extracts interrupt-IN, bulk-IN, bulk-OUT endpoint information from config descriptor */
330 void BTD::EndpointXtract(uint8_t conf, uint8_t iface __attribute__((unused)), uint8_t alt, uint8_t proto __attribute__((unused)), const USB_ENDPOINT_DESCRIPTOR *pep) {
331  //ErrorMessage<uint8_t>(PSTR("Conf.Val"),conf);
332  //ErrorMessage<uint8_t>(PSTR("Iface Num"),iface);
333  //ErrorMessage<uint8_t>(PSTR("Alt.Set"),alt);
334 
335  if(alt) // Wrong interface - by BT spec, no alt setting
336  return;
337 
338  bConfNum = conf;
339  uint8_t index;
340 
341  if((pep->bmAttributes & bmUSB_TRANSFER_TYPE) == USB_TRANSFER_TYPE_INTERRUPT && (pep->bEndpointAddress & 0x80) == 0x80) { // Interrupt In endpoint found
342  index = BTD_EVENT_PIPE;
343  epInfo[index].bmNakPower = USB_NAK_NOWAIT;
344  } else if((pep->bmAttributes & bmUSB_TRANSFER_TYPE) == USB_TRANSFER_TYPE_BULK) // Bulk endpoint found
345  index = ((pep->bEndpointAddress & 0x80) == 0x80) ? BTD_DATAIN_PIPE : BTD_DATAOUT_PIPE;
346  else
347  return;
348 
349  // Fill the rest of endpoint data structure
350  epInfo[index].epAddr = (pep->bEndpointAddress & 0x0F);
351  epInfo[index].maxPktSize = (uint8_t)pep->wMaxPacketSize;
352 #ifdef EXTRADEBUG
353  PrintEndpointDescriptor(pep);
354 #endif
355  if(pollInterval < pep->bInterval) // Set the polling interval as the largest polling interval obtained from endpoints
356  pollInterval = pep->bInterval;
357  bNumEP++;
358 }
359 
360 void BTD::PrintEndpointDescriptor(const USB_ENDPOINT_DESCRIPTOR* ep_ptr __attribute__((unused))) {
361 #ifdef EXTRADEBUG
362  Notify(PSTR("\r\nEndpoint descriptor:"), 0x80);
363  Notify(PSTR("\r\nLength:\t\t"), 0x80);
364  D_PrintHex<uint8_t > (ep_ptr->bLength, 0x80);
365  Notify(PSTR("\r\nType:\t\t"), 0x80);
366  D_PrintHex<uint8_t > (ep_ptr->bDescriptorType, 0x80);
367  Notify(PSTR("\r\nAddress:\t"), 0x80);
368  D_PrintHex<uint8_t > (ep_ptr->bEndpointAddress, 0x80);
369  Notify(PSTR("\r\nAttributes:\t"), 0x80);
370  D_PrintHex<uint8_t > (ep_ptr->bmAttributes, 0x80);
371  Notify(PSTR("\r\nMaxPktSize:\t"), 0x80);
372  D_PrintHex<uint16_t > (ep_ptr->wMaxPacketSize, 0x80);
373  Notify(PSTR("\r\nPoll Intrv:\t"), 0x80);
374  D_PrintHex<uint8_t > (ep_ptr->bInterval, 0x80);
375 #endif
376 }
377 
378 /* Performs a cleanup after failed Init() attempt */
379 uint8_t BTD::Release() {
380  Initialize(); // Set all variables, endpoint structs etc. to default values
381  pUsb->GetAddressPool().FreeAddress(bAddress);
382  return 0;
383 }
384 
385 uint8_t BTD::Poll() {
386  if(!bPollEnable)
387  return 0;
388  if((int32_t)((uint32_t)millis() - qNextPollTime) >= 0L) { // Don't poll if shorter than polling interval
389  qNextPollTime = (uint32_t)millis() + pollInterval; // Set new poll time
390  HCI_event_task(); // Poll the HCI event pipe
391  HCI_task(); // HCI state machine
392  ACL_event_task(); // Poll the ACL input pipe too
393  }
394  return 0;
395 }
396 
397 void BTD::disconnect() {
398  for(uint8_t i = 0; i < BTD_NUM_SERVICES; i++)
399  if(btService[i])
400  btService[i]->disconnect();
401 };
402 
403 void BTD::HCI_event_task() {
404  uint16_t length = BULK_MAXPKTSIZE; // Request more than 16 bytes anyway, the inTransfer routine will take care of this
405  uint8_t rcode = pUsb->inTransfer(bAddress, epInfo[ BTD_EVENT_PIPE ].epAddr, &length, hcibuf, pollInterval); // Input on endpoint 1
406 
407  if(!rcode || rcode == hrNAK) { // Check for errors
408  switch(hcibuf[0]) { // Switch on event type
409  case EV_COMMAND_COMPLETE:
410  if(!hcibuf[5]) { // Check if command succeeded
411  hci_set_flag(HCI_FLAG_CMD_COMPLETE); // Set command complete flag
412  if((hcibuf[3] == 0x01) && (hcibuf[4] == 0x10)) { // Parameters from read local version information
413  hci_version = hcibuf[6]; // Used to check if it supports 2.0+EDR - see http://www.bluetooth.org/Technical/AssignedNumbers/hci.htm
414 #ifdef EXTRADEBUG
415  if(!hci_check_flag(HCI_FLAG_READ_VERSION)) {
416  Notify(PSTR("\r\nHCI version: "), 0x80);
417  D_PrintHex<uint8_t > (hci_version, 0x80);
418  }
419 #endif
420  hci_set_flag(HCI_FLAG_READ_VERSION);
421  } else if((hcibuf[3] == 0x04) && (hcibuf[4] == 0x10)) { // Parameters from read local extended features
422  if(!hci_check_flag(HCI_FLAG_LOCAL_EXTENDED_FEATURES)) {
423 #ifdef EXTRADEBUG
424  Notify(PSTR("\r\nPage number: "), 0x80);
425  D_PrintHex<uint8_t > (hcibuf[6], 0x80);
426  Notify(PSTR("\r\nMaximum page number: "), 0x80);
427  D_PrintHex<uint8_t > (hcibuf[7], 0x80);
428  Notify(PSTR("\r\nExtended LMP features:"), 0x80);
429  for(uint8_t i = 0; i < 8; i++) {
430  Notify(PSTR(" "), 0x80);
431  D_PrintHex<uint8_t > (hcibuf[8 + i], 0x80);
432  }
433 #endif
434  if(hcibuf[6] == 0) { // Page 0
435 #ifdef DEBUG_USB_HOST
436  Notify(PSTR("\r\nDongle "), 0x80);
437 #endif
438  if(hcibuf[8 + 6] & (1U << 3)) {
439  simple_pairing_supported = true;
440 #ifdef DEBUG_USB_HOST
441  Notify(PSTR("supports"), 0x80);
442 #endif
443  } else {
444  simple_pairing_supported = false;
445 #ifdef DEBUG_USB_HOST
446  Notify(PSTR("does NOT support"), 0x80);
447 #endif
448  }
449 #ifdef DEBUG_USB_HOST
450  Notify(PSTR(" secure simple pairing (controller support)"), 0x80);
451 #endif
452  } else if(hcibuf[6] == 1) { // Page 1
453 #ifdef DEBUG_USB_HOST
454  Notify(PSTR("\r\nDongle "), 0x80);
455  if(hcibuf[8 + 0] & (1U << 0))
456  Notify(PSTR("supports"), 0x80);
457  else
458  Notify(PSTR("does NOT support"), 0x80);
459  Notify(PSTR(" secure simple pairing (host support)"), 0x80);
460 #endif
461  }
462  }
463 
464  hci_set_flag(HCI_FLAG_LOCAL_EXTENDED_FEATURES);
465  } else if((hcibuf[3] == 0x09) && (hcibuf[4] == 0x10)) { // Parameters from read local bluetooth address
466  for(uint8_t i = 0; i < 6; i++)
467  my_bdaddr[i] = hcibuf[6 + i];
468  hci_set_flag(HCI_FLAG_READ_BDADDR);
469  }
470  }
471  break;
472 
473  case EV_COMMAND_STATUS:
474  if(hcibuf[2]) { // Show status on serial if not OK
475 #ifdef DEBUG_USB_HOST
476  Notify(PSTR("\r\nHCI Command Failed: "), 0x80);
477  D_PrintHex<uint8_t > (hcibuf[2], 0x80);
478  Notify(PSTR("\r\nNum HCI Command Packets: "), 0x80);
479  D_PrintHex<uint8_t > (hcibuf[3], 0x80);
480  Notify(PSTR("\r\nCommand Opcode: "), 0x80);
481  D_PrintHex<uint8_t > (hcibuf[4], 0x80);
482  Notify(PSTR(" "), 0x80);
483  D_PrintHex<uint8_t > (hcibuf[5], 0x80);
484 #endif
485  }
486  break;
487 
488  case EV_INQUIRY_COMPLETE:
489  if(inquiry_counter >= 5 && (pairWithWii || pairWithHIDDevice)) {
490  inquiry_counter = 0;
491 #ifdef DEBUG_USB_HOST
492  if(pairWithWii)
493  Notify(PSTR("\r\nCouldn't find Wiimote"), 0x80);
494  else
495  Notify(PSTR("\r\nCouldn't find HID device"), 0x80);
496 #endif
497  connectToWii = false;
498  pairWithWii = false;
499  connectToHIDDevice = false;
500  pairWithHIDDevice = false;
501  hci_state = HCI_SCANNING_STATE;
502  }
503  inquiry_counter++;
504  break;
505 
506  case EV_INQUIRY_RESULT:
507  if(hcibuf[2]) { // Check that there is more than zero responses
508 #ifdef EXTRADEBUG
509  Notify(PSTR("\r\nNumber of responses: "), 0x80);
510  Notify(hcibuf[2], 0x80);
511 #endif
512  for(uint8_t i = 0; i < hcibuf[2]; i++) {
513  uint8_t offset = 8 * hcibuf[2] + 3 * i;
514 
515  for(uint8_t j = 0; j < 3; j++)
516  classOfDevice[j] = hcibuf[j + 4 + offset];
517 
518 #ifdef EXTRADEBUG
519  Notify(PSTR("\r\nClass of device: "), 0x80);
520  D_PrintHex<uint8_t > (classOfDevice[2], 0x80);
521  Notify(PSTR(" "), 0x80);
522  D_PrintHex<uint8_t > (classOfDevice[1], 0x80);
523  Notify(PSTR(" "), 0x80);
524  D_PrintHex<uint8_t > (classOfDevice[0], 0x80);
525 #endif
526 
527  if(pairWithWii && classOfDevice[2] == 0x00 && (classOfDevice[1] == 0x05) && (classOfDevice[0] & 0x0C)) { // See http://wiibrew.org/wiki/Wiimote#SDP_information
528  checkRemoteName = true; // Check remote name to distinguish between the different controllers
529 
530  for(uint8_t j = 0; j < 6; j++)
531  disc_bdaddr[j] = hcibuf[j + 3 + 6 * i];
532 
533  hci_set_flag(HCI_FLAG_DEVICE_FOUND);
534  break;
535  } else if(pairWithHIDDevice && (classOfDevice[1] & 0x0F) == 0x05 && (classOfDevice[0] & 0xC8)) { // Check if it is a mouse, keyboard or a gamepad - see: http://bluetooth-pentest.narod.ru/software/bluetooth_class_of_device-service_generator.html
536 #ifdef DEBUG_USB_HOST
537  checkRemoteName = true; // Used to print name in the serial monitor if serial debugging is enabled
538 
539  if(classOfDevice[0] & 0x80)
540  Notify(PSTR("\r\nMouse found"), 0x80);
541  if(classOfDevice[0] & 0x40)
542  Notify(PSTR("\r\nKeyboard found"), 0x80);
543  if(classOfDevice[0] & 0x08)
544  Notify(PSTR("\r\nGamepad found"), 0x80);
545 #endif
546  for(uint8_t j = 0; j < 6; j++)
547  disc_bdaddr[j] = hcibuf[j + 3 + 6 * i];
548 
549  hci_set_flag(HCI_FLAG_DEVICE_FOUND);
550  break;
551  }
552  }
553  }
554  break;
555 
556  case EV_CONNECT_COMPLETE:
557  hci_set_flag(HCI_FLAG_CONNECT_EVENT);
558  if(!hcibuf[2]) { // Check if connected OK
559 #ifdef EXTRADEBUG
560  Notify(PSTR("\r\nConnection established"), 0x80);
561 #endif
562  hci_handle = hcibuf[3] | ((hcibuf[4] & 0x0F) << 8); // Store the handle for the ACL connection
563  hci_set_flag(HCI_FLAG_CONNECT_COMPLETE); // Set connection complete flag
564  } else {
565  hci_state = HCI_CHECK_DEVICE_SERVICE;
566 #ifdef DEBUG_USB_HOST
567  Notify(PSTR("\r\nConnection Failed: "), 0x80);
568  D_PrintHex<uint8_t > (hcibuf[2], 0x80);
569 #endif
570  }
571  break;
572 
573  case EV_DISCONNECT_COMPLETE:
574  if(!hcibuf[2]) { // Check if disconnected OK
575  hci_set_flag(HCI_FLAG_DISCONNECT_COMPLETE); // Set disconnect command complete flag
576  hci_clear_flag(HCI_FLAG_CONNECT_COMPLETE); // Clear connection complete flag
577  }
578  break;
579 
580  case EV_REMOTE_NAME_COMPLETE:
581  if(!hcibuf[2]) { // Check if reading is OK
582  for(uint8_t i = 0; i < min(sizeof (remote_name), sizeof (hcibuf) - 9); i++) {
583  remote_name[i] = hcibuf[9 + i];
584  if(remote_name[i] == '\0') // End of string
585  break;
586  }
587  // TODO: Always set '\0' in remote name!
588  hci_set_flag(HCI_FLAG_REMOTE_NAME_COMPLETE);
589  }
590  break;
591 
592  case EV_INCOMING_CONNECT:
593  for(uint8_t i = 0; i < 6; i++)
594  disc_bdaddr[i] = hcibuf[i + 2];
595 
596  for(uint8_t i = 0; i < 3; i++)
597  classOfDevice[i] = hcibuf[i + 8];
598 
599  if((classOfDevice[1] & 0x0F) == 0x05 && (classOfDevice[0] & 0xC8)) { // Check if it is a mouse, keyboard or a gamepad
600 #ifdef DEBUG_USB_HOST
601  if(classOfDevice[0] & 0x80)
602  Notify(PSTR("\r\nMouse is connecting"), 0x80);
603  if(classOfDevice[0] & 0x40)
604  Notify(PSTR("\r\nKeyboard is connecting"), 0x80);
605  if(classOfDevice[0] & 0x08)
606  Notify(PSTR("\r\nGamepad is connecting"), 0x80);
607 #endif
608  incomingHIDDevice = true;
609  }
610 
611 #ifdef EXTRADEBUG
612  Notify(PSTR("\r\nClass of device: "), 0x80);
613  D_PrintHex<uint8_t > (classOfDevice[2], 0x80);
614  Notify(PSTR(" "), 0x80);
615  D_PrintHex<uint8_t > (classOfDevice[1], 0x80);
616  Notify(PSTR(" "), 0x80);
617  D_PrintHex<uint8_t > (classOfDevice[0], 0x80);
618 #endif
619  hci_set_flag(HCI_FLAG_INCOMING_REQUEST);
620  break;
621 
622  case EV_PIN_CODE_REQUEST:
623  if(pairWithWii) {
624 #ifdef DEBUG_USB_HOST
625  Notify(PSTR("\r\nPairing with Wiimote"), 0x80);
626 #endif
627  hci_pin_code_request_reply();
628  } else if(btdPin != NULL) {
629 #ifdef DEBUG_USB_HOST
630  Notify(PSTR("\r\nBluetooth pin is set too: "), 0x80);
631  NotifyStr(btdPin, 0x80);
632 #endif
633  hci_pin_code_request_reply();
634  } else {
635 #ifdef DEBUG_USB_HOST
636  Notify(PSTR("\r\nNo pin was set"), 0x80);
637 #endif
638  hci_pin_code_negative_request_reply();
639  }
640  break;
641 
642  case EV_LINK_KEY_REQUEST:
643 #ifdef DEBUG_USB_HOST
644  Notify(PSTR("\r\nReceived Key Request"), 0x80);
645 #endif
646  hci_link_key_request_negative_reply();
647  break;
648 
649  case EV_AUTHENTICATION_COMPLETE:
650  if(!hcibuf[2]) { // Check if pairing was successful
651  if(pairWithWii && !connectToWii) {
652 #ifdef DEBUG_USB_HOST
653  Notify(PSTR("\r\nPairing successful with Wiimote"), 0x80);
654 #endif
655  connectToWii = true; // Used to indicate to the Wii service, that it should connect to this device
656  } else if(pairWithHIDDevice && !connectToHIDDevice) {
657 #ifdef DEBUG_USB_HOST
658  Notify(PSTR("\r\nPairing successful with HID device"), 0x80);
659 #endif
660  connectToHIDDevice = true; // Used to indicate to the BTHID service, that it should connect to this device
661  } else {
662 #ifdef EXTRADEBUG
663  Notify(PSTR("\r\nPairing was successful"), 0x80);
664 #endif
665  }
666  } else {
667 #ifdef DEBUG_USB_HOST
668  Notify(PSTR("\r\nPairing Failed: "), 0x80);
669  D_PrintHex<uint8_t > (hcibuf[2], 0x80);
670 #endif
671  hci_disconnect(hci_handle);
672  hci_state = HCI_DISCONNECT_STATE;
673  }
674  break;
675 
676  case EV_IO_CAPABILITY_REQUEST:
677 #ifdef DEBUG_USB_HOST
678  Notify(PSTR("\r\nReceived IO Capability Request"), 0x80);
679 #endif
680  hci_io_capability_request_reply();
681  break;
682 
683  case EV_IO_CAPABILITY_RESPONSE:
684 #ifdef EXTRADEBUG
685  Notify(PSTR("\r\nReceived IO Capability Response: "), 0x80);
686  Notify(PSTR("\r\nIO capability: "), 0x80);
687  D_PrintHex<uint8_t > (hcibuf[8], 0x80);
688  Notify(PSTR("\r\nOOB data present: "), 0x80);
689  D_PrintHex<uint8_t > (hcibuf[9], 0x80);
690  Notify(PSTR("\r\nAuthentication request: "), 0x80);
691  D_PrintHex<uint8_t > (hcibuf[10], 0x80);
692 #endif
693  break;
694 
695  case EV_USER_CONFIRMATION_REQUEST:
696 #ifdef DEBUG_USB_HOST
697  Notify(PSTR("\r\nUser confirmation Request"), 0x80);
698 #ifdef EXTRADEBUG
699  Notify(PSTR(": \r\nNumeric value: "), 0x80);
700  for(uint8_t i = 0; i < 4; i++) {
701  Notify(PSTR(" "), 0x80);
702  D_PrintHex<uint8_t > (hcibuf[8 + i], 0x80);
703  }
704 #endif
705 #endif
706  // Simply confirm the connection, as the host has no "NoInputNoOutput" capabilities
707  hci_user_confirmation_request_reply();
708  break;
709 
710  case EV_SIMPLE_PAIRING_COMPLETE:
711 #ifdef EXTRADEBUG
712  if(!hcibuf[2]) { // Check if connected OK
713  Notify(PSTR("\r\nSimple Pairing succeeded"), 0x80);
714  } else {
715  Notify(PSTR("\r\nSimple Pairing failed: "), 0x80);
716  D_PrintHex<uint8_t > (hcibuf[2], 0x80);
717  }
718 #endif
719  break;
720 
721  /* We will just ignore the following events */
722  case EV_MAX_SLOTS_CHANGE:
723  case EV_NUM_COMPLETE_PKT:
724  break;
725  case EV_ROLE_CHANGED:
726  case EV_PAGE_SCAN_REP_MODE:
727  case EV_LOOPBACK_COMMAND:
728  case EV_DATA_BUFFER_OVERFLOW:
729  case EV_CHANGE_CONNECTION_LINK:
730  case EV_QOS_SETUP_COMPLETE:
731  case EV_LINK_KEY_NOTIFICATION:
732  case EV_ENCRYPTION_CHANGE:
733  case EV_READ_REMOTE_VERSION_INFORMATION_COMPLETE:
734 #ifdef EXTRADEBUG
735  if(hcibuf[0] != 0x00) {
736  Notify(PSTR("\r\nIgnore HCI Event: "), 0x80);
737  D_PrintHex<uint8_t > (hcibuf[0], 0x80);
738  }
739 #endif
740  break;
741 #ifdef EXTRADEBUG
742  default:
743  if(hcibuf[0] != 0x00) {
744  Notify(PSTR("\r\nUnmanaged HCI Event: "), 0x80);
745  D_PrintHex<uint8_t > (hcibuf[0], 0x80);
746  Notify(PSTR(", data: "), 0x80);
747  for(uint16_t i = 0; i < hcibuf[1]; i++) {
748  D_PrintHex<uint8_t > (hcibuf[2 + i], 0x80);
749  Notify(PSTR(" "), 0x80);
750  }
751  }
752  break;
753 #endif
754  } // Switch
755  }
756 #ifdef EXTRADEBUG
757  else {
758  Notify(PSTR("\r\nHCI event error: "), 0x80);
759  D_PrintHex<uint8_t > (rcode, 0x80);
760  }
761 #endif
762 }
763 
764 /* Poll Bluetooth and print result */
765 void BTD::HCI_task() {
766  switch(hci_state) {
767  case HCI_INIT_STATE:
768  hci_counter++;
769  if(hci_counter > hci_num_reset_loops) { // wait until we have looped x times to clear any old events
770  hci_reset();
771  hci_state = HCI_RESET_STATE;
772  hci_counter = 0;
773  }
774  break;
775 
776  case HCI_RESET_STATE:
777  hci_counter++;
778  if(hci_check_flag(HCI_FLAG_CMD_COMPLETE)) {
779  hci_counter = 0;
780 #ifdef DEBUG_USB_HOST
781  Notify(PSTR("\r\nHCI Reset complete"), 0x80);
782 #endif
783  hci_state = HCI_CLASS_STATE;
784  hci_write_class_of_device();
785  } else if(hci_counter > hci_num_reset_loops) {
786  hci_num_reset_loops *= 10;
787  if(hci_num_reset_loops > 2000)
788  hci_num_reset_loops = 2000;
789 #ifdef DEBUG_USB_HOST
790  Notify(PSTR("\r\nNo response to HCI Reset"), 0x80);
791 #endif
792  hci_state = HCI_INIT_STATE;
793  hci_counter = 0;
794  }
795  break;
796 
797  case HCI_CLASS_STATE:
798  if(hci_check_flag(HCI_FLAG_CMD_COMPLETE)) {
799 #ifdef DEBUG_USB_HOST
800  Notify(PSTR("\r\nWrite class of device"), 0x80);
801 #endif
802  hci_state = HCI_BDADDR_STATE;
803  hci_read_bdaddr();
804  }
805  break;
806 
807  case HCI_BDADDR_STATE:
808  if(hci_check_flag(HCI_FLAG_READ_BDADDR)) {
809 #ifdef DEBUG_USB_HOST
810  Notify(PSTR("\r\nLocal Bluetooth Address: "), 0x80);
811  for(int8_t i = 5; i > 0; i--) {
812  D_PrintHex<uint8_t > (my_bdaddr[i], 0x80);
813  Notify(PSTR(":"), 0x80);
814  }
815  D_PrintHex<uint8_t > (my_bdaddr[0], 0x80);
816 #endif
817  hci_read_local_version_information();
818  hci_state = HCI_LOCAL_VERSION_STATE;
819  }
820  break;
821 
822  case HCI_LOCAL_VERSION_STATE: // The local version is used by the PS3BT class
823  if(hci_check_flag(HCI_FLAG_READ_VERSION)) {
824  if(btdName != NULL) {
825  hci_write_local_name(btdName);
826  hci_state = HCI_WRITE_NAME_STATE;
827  } else if(useSimplePairing) {
828  hci_read_local_extended_features(0); // "Requests the normal LMP features as returned by Read_Local_Supported_Features"
829  //hci_read_local_extended_features(1); // Read page 1
830  hci_state = HCI_LOCAL_EXTENDED_FEATURES_STATE;
831  } else
832  hci_state = HCI_CHECK_DEVICE_SERVICE;
833  }
834  break;
835 
836  case HCI_WRITE_NAME_STATE:
837  if(hci_check_flag(HCI_FLAG_CMD_COMPLETE)) {
838 #ifdef DEBUG_USB_HOST
839  Notify(PSTR("\r\nThe name was set to: "), 0x80);
840  NotifyStr(btdName, 0x80);
841 #endif
842  if(useSimplePairing) {
843  hci_read_local_extended_features(0); // "Requests the normal LMP features as returned by Read_Local_Supported_Features"
844  //hci_read_local_extended_features(1); // Read page 1
845  hci_state = HCI_LOCAL_EXTENDED_FEATURES_STATE;
846  } else
847  hci_state = HCI_CHECK_DEVICE_SERVICE;
848  }
849  break;
850 
851  case HCI_LOCAL_EXTENDED_FEATURES_STATE:
852  if(hci_check_flag(HCI_FLAG_LOCAL_EXTENDED_FEATURES)) {
853  if(simple_pairing_supported) {
854  hci_write_simple_pairing_mode(true);
855  hci_state = HCI_WRITE_SIMPLE_PAIRING_STATE;
856  } else
857  hci_state = HCI_CHECK_DEVICE_SERVICE;
858  }
859  break;
860 
861  case HCI_WRITE_SIMPLE_PAIRING_STATE:
862  if(hci_check_flag(HCI_FLAG_CMD_COMPLETE)) {
863 #ifdef DEBUG_USB_HOST
864  Notify(PSTR("\r\nSimple pairing was enabled"), 0x80);
865 #endif
866  hci_set_event_mask();
867  hci_state = HCI_SET_EVENT_MASK_STATE;
868  }
869  break;
870 
871  case HCI_SET_EVENT_MASK_STATE:
872  if(hci_check_flag(HCI_FLAG_CMD_COMPLETE)) {
873 #ifdef DEBUG_USB_HOST
874  Notify(PSTR("\r\nSet event mask completed"), 0x80);
875 #endif
876  hci_state = HCI_CHECK_DEVICE_SERVICE;
877  }
878  break;
879 
880  case HCI_CHECK_DEVICE_SERVICE:
881  if(pairWithHIDDevice || pairWithWii) { // Check if it should try to connect to a Wiimote
882 #ifdef DEBUG_USB_HOST
883  if(pairWithWii)
884  Notify(PSTR("\r\nStarting inquiry\r\nPress 1 & 2 on the Wiimote\r\nOr press the SYNC button if you are using a Wii U Pro Controller or a Wii Balance Board"), 0x80);
885  else
886  Notify(PSTR("\r\nPlease enable discovery of your device"), 0x80);
887 #endif
888  hci_inquiry();
889  hci_state = HCI_INQUIRY_STATE;
890  } else
891  hci_state = HCI_SCANNING_STATE; // Don't try to connect to a Wiimote
892  break;
893 
894  case HCI_INQUIRY_STATE:
895  if(hci_check_flag(HCI_FLAG_DEVICE_FOUND)) {
896  hci_inquiry_cancel(); // Stop inquiry
897 #ifdef DEBUG_USB_HOST
898  if(pairWithWii)
899  Notify(PSTR("\r\nWiimote found"), 0x80);
900  else
901  Notify(PSTR("\r\nHID device found"), 0x80);
902 
903  Notify(PSTR("\r\nNow just create the instance like so:"), 0x80);
904  if(pairWithWii)
905  Notify(PSTR("\r\nWII Wii(&Btd);"), 0x80);
906  else
907  Notify(PSTR("\r\nBTHID bthid(&Btd);"), 0x80);
908 
909  Notify(PSTR("\r\nAnd then press any button on the "), 0x80);
910  if(pairWithWii)
911  Notify(PSTR("Wiimote"), 0x80);
912  else
913  Notify(PSTR("device"), 0x80);
914 #endif
915  if(checkRemoteName) {
916  hci_remote_name(); // We need to know the name to distinguish between the Wiimote, the new Wiimote with Motion Plus inside, a Wii U Pro Controller and a Wii Balance Board
917  hci_state = HCI_REMOTE_NAME_STATE;
918  } else
919  hci_state = HCI_CONNECT_DEVICE_STATE;
920  }
921  break;
922 
923  case HCI_CONNECT_DEVICE_STATE:
924  if(hci_check_flag(HCI_FLAG_CMD_COMPLETE)) {
925 #ifdef DEBUG_USB_HOST
926  if(pairWithWii)
927  Notify(PSTR("\r\nConnecting to Wiimote"), 0x80);
928  else
929  Notify(PSTR("\r\nConnecting to HID device"), 0x80);
930 #endif
931  checkRemoteName = false;
932  hci_connect();
933  hci_state = HCI_CONNECTED_DEVICE_STATE;
934  }
935  break;
936 
937  case HCI_CONNECTED_DEVICE_STATE:
938  if(hci_check_flag(HCI_FLAG_CONNECT_EVENT)) {
939  if(hci_check_flag(HCI_FLAG_CONNECT_COMPLETE)) {
940 #ifdef DEBUG_USB_HOST
941  if(pairWithWii)
942  Notify(PSTR("\r\nConnected to Wiimote"), 0x80);
943  else
944  Notify(PSTR("\r\nConnected to HID device"), 0x80);
945 #endif
946  hci_authentication_request(); // This will start the pairing with the device
947  hci_state = HCI_SCANNING_STATE;
948  } else {
949 #ifdef DEBUG_USB_HOST
950  Notify(PSTR("\r\nTrying to connect one more time..."), 0x80);
951 #endif
952  hci_connect(); // Try to connect one more time
953  }
954  }
955  break;
956 
957  case HCI_SCANNING_STATE:
958  if(!connectToWii && !pairWithWii && !connectToHIDDevice && !pairWithHIDDevice) {
959 #ifdef DEBUG_USB_HOST
960  Notify(PSTR("\r\nWait For Incoming Connection Request"), 0x80);
961 #endif
962  hci_write_scan_enable();
963  waitingForConnection = true;
964  hci_state = HCI_CONNECT_IN_STATE;
965  }
966  break;
967 
968  case HCI_CONNECT_IN_STATE:
969  if(hci_check_flag(HCI_FLAG_INCOMING_REQUEST)) {
970  waitingForConnection = false;
971 #ifdef DEBUG_USB_HOST
972  Notify(PSTR("\r\nIncoming Connection Request"), 0x80);
973 #endif
974  hci_remote_name();
975  hci_state = HCI_REMOTE_NAME_STATE;
976  } else if(hci_check_flag(HCI_FLAG_DISCONNECT_COMPLETE))
977  hci_state = HCI_DISCONNECT_STATE;
978  break;
979 
980  case HCI_REMOTE_NAME_STATE:
981  if(hci_check_flag(HCI_FLAG_REMOTE_NAME_COMPLETE)) {
982 #ifdef DEBUG_USB_HOST
983  Notify(PSTR("\r\nRemote Name: "), 0x80);
984  for(uint8_t i = 0; i < strlen(remote_name); i++)
985  Notifyc(remote_name[i], 0x80);
986 #endif
987  if(strncmp((const char*)remote_name, "Nintendo", 8) == 0) {
988  incomingWii = true;
989  motionPlusInside = false;
990  wiiUProController = false;
991  pairWiiUsingSync = false;
992 #ifdef DEBUG_USB_HOST
993  Notify(PSTR("\r\nWiimote is connecting"), 0x80);
994 #endif
995  if(strncmp((const char*)remote_name, "Nintendo RVL-CNT-01-TR", 22) == 0) {
996 #ifdef DEBUG_USB_HOST
997  Notify(PSTR(" with Motion Plus Inside"), 0x80);
998 #endif
999  motionPlusInside = true;
1000  } else if(strncmp((const char*)remote_name, "Nintendo RVL-CNT-01-UC", 22) == 0) {
1001 #ifdef DEBUG_USB_HOST
1002  Notify(PSTR(" - Wii U Pro Controller"), 0x80);
1003 #endif
1004  wiiUProController = motionPlusInside = pairWiiUsingSync = true;
1005  } else if(strncmp((const char*)remote_name, "Nintendo RVL-WBC-01", 19) == 0) {
1006 #ifdef DEBUG_USB_HOST
1007  Notify(PSTR(" - Wii Balance Board"), 0x80);
1008 #endif
1009  pairWiiUsingSync = true;
1010  }
1011  }
1012  if(classOfDevice[2] == 0 && classOfDevice[1] == 0x25 && classOfDevice[0] == 0x08 && strncmp((const char*)remote_name, "Wireless Controller", 19) == 0) {
1013 #ifdef DEBUG_USB_HOST
1014  Notify(PSTR("\r\nPS4/PS5 controller is connecting"), 0x80);
1015 #endif
1016  incomingPSController = true;
1017  }
1018  if((pairWithWii || pairWithHIDDevice) && checkRemoteName)
1019  hci_state = HCI_CONNECT_DEVICE_STATE;
1020  else {
1021  hci_accept_connection();
1022  hci_state = HCI_CONNECTED_STATE;
1023  }
1024  }
1025  break;
1026 
1027  case HCI_CONNECTED_STATE:
1028  if(hci_check_flag(HCI_FLAG_CONNECT_COMPLETE)) {
1029 #ifdef DEBUG_USB_HOST
1030  Notify(PSTR("\r\nConnected to Device: "), 0x80);
1031  for(int8_t i = 5; i > 0; i--) {
1032  D_PrintHex<uint8_t > (disc_bdaddr[i], 0x80);
1033  Notify(PSTR(":"), 0x80);
1034  }
1035  D_PrintHex<uint8_t > (disc_bdaddr[0], 0x80);
1036 #endif
1037  if(incomingPSController)
1038  connectToHIDDevice = true; // We should always connect to the PS4/PS5 controller
1039 
1040  // Clear these flags for a new connection
1041  l2capConnectionClaimed = false;
1042  sdpConnectionClaimed = false;
1043  rfcommConnectionClaimed = false;
1044 
1045  hci_event_flag = 0;
1046  hci_state = HCI_DONE_STATE;
1047  }
1048  break;
1049 
1050  case HCI_DONE_STATE:
1051  hci_counter++;
1052  if(hci_counter > 1000) { // Wait until we have looped 1000 times to make sure that the L2CAP connection has been started
1053  hci_counter = 0;
1054  hci_state = HCI_SCANNING_STATE;
1055  }
1056  break;
1057 
1058  case HCI_DISCONNECT_STATE:
1059  if(hci_check_flag(HCI_FLAG_DISCONNECT_COMPLETE)) {
1060 #ifdef DEBUG_USB_HOST
1061  Notify(PSTR("\r\nHCI Disconnected from Device"), 0x80);
1062 #endif
1063  hci_event_flag = 0; // Clear all flags
1064 
1065  // Reset all buffers
1066  memset(hcibuf, 0, BULK_MAXPKTSIZE);
1067  memset(l2capinbuf, 0, BULK_MAXPKTSIZE);
1068 
1069  connectToWii = incomingWii = pairWithWii = false;
1070  connectToHIDDevice = incomingHIDDevice = pairWithHIDDevice = checkRemoteName = false;
1071  incomingPSController = false;
1072 
1073  hci_state = HCI_SCANNING_STATE;
1074  }
1075  break;
1076  default:
1077  break;
1078  }
1079 }
1080 
1081 void BTD::ACL_event_task() {
1082  uint16_t length = BULK_MAXPKTSIZE;
1083  uint8_t rcode = pUsb->inTransfer(bAddress, epInfo[ BTD_DATAIN_PIPE ].epAddr, &length, l2capinbuf, pollInterval); // Input on endpoint 2
1084 
1085  if(!rcode) { // Check for errors
1086  if(length > 0) { // Check if any data was read
1087  for(uint8_t i = 0; i < BTD_NUM_SERVICES; i++) {
1088  if(btService[i])
1089  btService[i]->ACLData(l2capinbuf);
1090  }
1091  }
1092  }
1093 #ifdef EXTRADEBUG
1094  else if(rcode != hrNAK) {
1095  Notify(PSTR("\r\nACL data in error: "), 0x80);
1096  D_PrintHex<uint8_t > (rcode, 0x80);
1097  }
1098 #endif
1099  for(uint8_t i = 0; i < BTD_NUM_SERVICES; i++)
1100  if(btService[i])
1101  btService[i]->Run();
1102 }
1103 
1104 /************************************************************/
1105 /* HCI Commands */
1106 
1107 /************************************************************/
1108 void BTD::HCI_Command(uint8_t* data, uint16_t nbytes) {
1109  hci_clear_flag(HCI_FLAG_CMD_COMPLETE);
1110  pUsb->ctrlReq(bAddress, epInfo[ BTD_CONTROL_PIPE ].epAddr, bmREQ_HCI_OUT, 0x00, 0x00, 0x00, 0x00, nbytes, nbytes, data, NULL);
1111 }
1112 
1113 void BTD::hci_reset() {
1114  hci_event_flag = 0; // Clear all the flags
1115  hcibuf[0] = 0x03; // HCI OCF = 3
1116  hcibuf[1] = 0x03 << 2; // HCI OGF = 3
1117  hcibuf[2] = 0x00;
1118 
1119  HCI_Command(hcibuf, 3);
1120 }
1121 
1122 void BTD::hci_write_scan_enable() {
1123  hci_clear_flag(HCI_FLAG_INCOMING_REQUEST);
1124  hcibuf[0] = 0x1A; // HCI OCF = 1A
1125  hcibuf[1] = 0x03 << 2; // HCI OGF = 3
1126  hcibuf[2] = 0x01; // parameter length = 1
1127  if(btdName != NULL)
1128  hcibuf[3] = 0x03; // Inquiry Scan enabled. Page Scan enabled.
1129  else
1130  hcibuf[3] = 0x02; // Inquiry Scan disabled. Page Scan enabled.
1131 
1132  HCI_Command(hcibuf, 4);
1133 }
1134 
1135 void BTD::hci_write_scan_disable() {
1136  hcibuf[0] = 0x1A; // HCI OCF = 1A
1137  hcibuf[1] = 0x03 << 2; // HCI OGF = 3
1138  hcibuf[2] = 0x01; // parameter length = 1
1139  hcibuf[3] = 0x00; // Inquiry Scan disabled. Page Scan disabled.
1140 
1141  HCI_Command(hcibuf, 4);
1142 }
1143 
1144 void BTD::hci_read_bdaddr() {
1145  hci_clear_flag(HCI_FLAG_READ_BDADDR);
1146  hcibuf[0] = 0x09; // HCI OCF = 9
1147  hcibuf[1] = 0x04 << 2; // HCI OGF = 4
1148  hcibuf[2] = 0x00;
1149 
1150  HCI_Command(hcibuf, 3);
1151 }
1152 
1153 void BTD::hci_read_local_version_information() {
1154  hci_clear_flag(HCI_FLAG_READ_VERSION);
1155  hcibuf[0] = 0x01; // HCI OCF = 1
1156  hcibuf[1] = 0x04 << 2; // HCI OGF = 4
1157  hcibuf[2] = 0x00;
1158 
1159  HCI_Command(hcibuf, 3);
1160 }
1161 
1162 void BTD::hci_read_local_extended_features(uint8_t page_number) {
1163  hci_clear_flag(HCI_FLAG_LOCAL_EXTENDED_FEATURES);
1164  hcibuf[0] = 0x04; // HCI OCF = 4
1165  hcibuf[1] = 0x04 << 2; // HCI OGF = 4
1166  hcibuf[2] = 0x01; // parameter length = 1
1167  hcibuf[3] = page_number;
1168 
1169  HCI_Command(hcibuf, 4);
1170 }
1171 
1172 void BTD::hci_accept_connection() {
1173  hci_clear_flag(HCI_FLAG_CONNECT_COMPLETE);
1174  hcibuf[0] = 0x09; // HCI OCF = 9
1175  hcibuf[1] = 0x01 << 2; // HCI OGF = 1
1176  hcibuf[2] = 0x07; // parameter length 7
1177  hcibuf[3] = disc_bdaddr[0]; // 6 octet bdaddr
1178  hcibuf[4] = disc_bdaddr[1];
1179  hcibuf[5] = disc_bdaddr[2];
1180  hcibuf[6] = disc_bdaddr[3];
1181  hcibuf[7] = disc_bdaddr[4];
1182  hcibuf[8] = disc_bdaddr[5];
1183  hcibuf[9] = 0x00; // Switch role to master
1184 
1185  HCI_Command(hcibuf, 10);
1186 }
1187 
1188 void BTD::hci_remote_name() {
1189  hci_clear_flag(HCI_FLAG_REMOTE_NAME_COMPLETE);
1190  hcibuf[0] = 0x19; // HCI OCF = 19
1191  hcibuf[1] = 0x01 << 2; // HCI OGF = 1
1192  hcibuf[2] = 0x0A; // parameter length = 10
1193  hcibuf[3] = disc_bdaddr[0]; // 6 octet bdaddr
1194  hcibuf[4] = disc_bdaddr[1];
1195  hcibuf[5] = disc_bdaddr[2];
1196  hcibuf[6] = disc_bdaddr[3];
1197  hcibuf[7] = disc_bdaddr[4];
1198  hcibuf[8] = disc_bdaddr[5];
1199  hcibuf[9] = 0x01; // Page Scan Repetition Mode
1200  hcibuf[10] = 0x00; // Reserved
1201  hcibuf[11] = 0x00; // Clock offset - low byte
1202  hcibuf[12] = 0x00; // Clock offset - high byte
1203 
1204  HCI_Command(hcibuf, 13);
1205 }
1206 
1207 void BTD::hci_write_local_name(const char* name) {
1208  hcibuf[0] = 0x13; // HCI OCF = 13
1209  hcibuf[1] = 0x03 << 2; // HCI OGF = 3
1210  hcibuf[2] = strlen(name) + 1; // parameter length = the length of the string + end byte
1211  uint8_t i;
1212  for(i = 0; i < strlen(name); i++)
1213  hcibuf[i + 3] = name[i];
1214  hcibuf[i + 3] = 0x00; // End of string
1215 
1216  HCI_Command(hcibuf, 4 + strlen(name));
1217 }
1218 
1219 void BTD::hci_set_event_mask() {
1220  hcibuf[0] = 0x01; // HCI OCF = 01
1221  hcibuf[1] = 0x03 << 2; // HCI OGF = 3
1222  hcibuf[2] = 0x08;
1223  // The first 6 bytes are the default of 1FFF FFFF FFFF
1224  // However we need to set bits 48-55 for simple pairing to work
1225  hcibuf[3] = 0xFF;
1226  hcibuf[4] = 0xFF;
1227  hcibuf[5] = 0xFF;
1228  hcibuf[6] = 0xFF;
1229  hcibuf[7] = 0xFF;
1230  hcibuf[8] = 0x1F;
1231  hcibuf[9] = 0xFF; // Enable bits 48-55 used for simple pairing
1232  hcibuf[10] = 0x00;
1233 
1234  HCI_Command(hcibuf, 11);
1235 }
1236 
1237 void BTD::hci_write_simple_pairing_mode(bool enable) {
1238  hcibuf[0] = 0x56; // HCI OCF = 56
1239  hcibuf[1] = 0x03 << 2; // HCI OGF = 3
1240  hcibuf[2] = 1; // parameter length = 1
1241  hcibuf[3] = enable ? 1 : 0;
1242 
1243  HCI_Command(hcibuf, 4);
1244 }
1245 
1246 void BTD::hci_inquiry() {
1247  hci_clear_flag(HCI_FLAG_DEVICE_FOUND);
1248  hcibuf[0] = 0x01;
1249  hcibuf[1] = 0x01 << 2; // HCI OGF = 1
1250  hcibuf[2] = 0x05; // Parameter Total Length = 5
1251  hcibuf[3] = 0x33; // LAP: Genera/Unlimited Inquiry Access Code (GIAC = 0x9E8B33) - see https://www.bluetooth.org/Technical/AssignedNumbers/baseband.htm
1252  hcibuf[4] = 0x8B;
1253  hcibuf[5] = 0x9E;
1254  hcibuf[6] = 0x30; // Inquiry time = 61.44 sec (maximum)
1255  hcibuf[7] = 0x0A; // 10 number of responses
1256 
1257  HCI_Command(hcibuf, 8);
1258 }
1259 
1260 void BTD::hci_inquiry_cancel() {
1261  hcibuf[0] = 0x02;
1262  hcibuf[1] = 0x01 << 2; // HCI OGF = 1
1263  hcibuf[2] = 0x00; // Parameter Total Length = 0
1264 
1265  HCI_Command(hcibuf, 3);
1266 }
1267 
1268 void BTD::hci_connect() {
1269  hci_connect(disc_bdaddr); // Use last discovered device
1270 }
1271 
1272 void BTD::hci_connect(uint8_t *bdaddr) {
1273  hci_clear_flag(HCI_FLAG_CONNECT_COMPLETE | HCI_FLAG_CONNECT_EVENT);
1274  hcibuf[0] = 0x05; // HCI OCF = 5
1275  hcibuf[1] = 0x01 << 2; // HCI OGF = 1
1276  hcibuf[2] = 0x0D; // parameter Total Length = 13
1277  hcibuf[3] = bdaddr[0]; // 6 octet bdaddr (LSB)
1278  hcibuf[4] = bdaddr[1];
1279  hcibuf[5] = bdaddr[2];
1280  hcibuf[6] = bdaddr[3];
1281  hcibuf[7] = bdaddr[4];
1282  hcibuf[8] = bdaddr[5];
1283  hcibuf[9] = 0x18; // DM1 or DH1 may be used
1284  hcibuf[10] = 0xCC; // DM3, DH3, DM5, DH5 may be used
1285  hcibuf[11] = 0x01; // Page repetition mode R1
1286  hcibuf[12] = 0x00; // Reserved
1287  hcibuf[13] = 0x00; // Clock offset
1288  hcibuf[14] = 0x00; // Invalid clock offset
1289  hcibuf[15] = 0x00; // Do not allow role switch
1290 
1291  HCI_Command(hcibuf, 16);
1292 }
1293 
1294 void BTD::hci_pin_code_request_reply() {
1295  hcibuf[0] = 0x0D; // HCI OCF = 0D
1296  hcibuf[1] = 0x01 << 2; // HCI OGF = 1
1297  hcibuf[2] = 0x17; // parameter length 23
1298  hcibuf[3] = disc_bdaddr[0]; // 6 octet bdaddr
1299  hcibuf[4] = disc_bdaddr[1];
1300  hcibuf[5] = disc_bdaddr[2];
1301  hcibuf[6] = disc_bdaddr[3];
1302  hcibuf[7] = disc_bdaddr[4];
1303  hcibuf[8] = disc_bdaddr[5];
1304  if(pairWithWii) {
1305  hcibuf[9] = 6; // Pin length is the length of the Bluetooth address
1306  if(pairWiiUsingSync) {
1307 #ifdef DEBUG_USB_HOST
1308  Notify(PSTR("\r\nPairing with Wii controller via SYNC"), 0x80);
1309 #endif
1310  for(uint8_t i = 0; i < 6; i++)
1311  hcibuf[10 + i] = my_bdaddr[i]; // The pin is the Bluetooth dongles Bluetooth address backwards
1312  } else {
1313  for(uint8_t i = 0; i < 6; i++)
1314  hcibuf[10 + i] = disc_bdaddr[i]; // The pin is the Wiimote's Bluetooth address backwards
1315  }
1316  for(uint8_t i = 16; i < 26; i++)
1317  hcibuf[i] = 0x00; // The rest should be 0
1318  } else {
1319  hcibuf[9] = strlen(btdPin); // Length of pin
1320  uint8_t i;
1321  for(i = 0; i < strlen(btdPin); i++) // The maximum size of the pin is 16
1322  hcibuf[i + 10] = btdPin[i];
1323  for(; i < 16; i++)
1324  hcibuf[i + 10] = 0x00; // The rest should be 0
1325  }
1326 
1327  HCI_Command(hcibuf, 26);
1328 }
1329 
1330 void BTD::hci_pin_code_negative_request_reply() {
1331  hcibuf[0] = 0x0E; // HCI OCF = 0E
1332  hcibuf[1] = 0x01 << 2; // HCI OGF = 1
1333  hcibuf[2] = 0x06; // parameter length 6
1334  hcibuf[3] = disc_bdaddr[0]; // 6 octet bdaddr
1335  hcibuf[4] = disc_bdaddr[1];
1336  hcibuf[5] = disc_bdaddr[2];
1337  hcibuf[6] = disc_bdaddr[3];
1338  hcibuf[7] = disc_bdaddr[4];
1339  hcibuf[8] = disc_bdaddr[5];
1340 
1341  HCI_Command(hcibuf, 9);
1342 }
1343 
1344 void BTD::hci_link_key_request_negative_reply() {
1345  hcibuf[0] = 0x0C; // HCI OCF = 0C
1346  hcibuf[1] = 0x01 << 2; // HCI OGF = 1
1347  hcibuf[2] = 0x06; // parameter length 6
1348  hcibuf[3] = disc_bdaddr[0]; // 6 octet bdaddr
1349  hcibuf[4] = disc_bdaddr[1];
1350  hcibuf[5] = disc_bdaddr[2];
1351  hcibuf[6] = disc_bdaddr[3];
1352  hcibuf[7] = disc_bdaddr[4];
1353  hcibuf[8] = disc_bdaddr[5];
1354 
1355  HCI_Command(hcibuf, 9);
1356 }
1357 
1358 void BTD::hci_io_capability_request_reply() {
1359  hcibuf[0] = 0x2B; // HCI OCF = 2B
1360  hcibuf[1] = 0x01 << 2; // HCI OGF = 1
1361  hcibuf[2] = 0x09;
1362  hcibuf[3] = disc_bdaddr[0]; // 6 octet bdaddr
1363  hcibuf[4] = disc_bdaddr[1];
1364  hcibuf[5] = disc_bdaddr[2];
1365  hcibuf[6] = disc_bdaddr[3];
1366  hcibuf[7] = disc_bdaddr[4];
1367  hcibuf[8] = disc_bdaddr[5];
1368  hcibuf[9] = 0x03; // NoInputNoOutput
1369  hcibuf[10] = 0x00; // OOB authentication data not present
1370  hcibuf[11] = 0x00; // MITM Protection Not Required – No Bonding. Numeric comparison with automatic accept allowed
1371 
1372  HCI_Command(hcibuf, 12);
1373 }
1374 
1375 void BTD::hci_user_confirmation_request_reply() {
1376  hcibuf[0] = 0x2C; // HCI OCF = 2C
1377  hcibuf[1] = 0x01 << 2; // HCI OGF = 1
1378  hcibuf[2] = 0x06; // parameter length 6
1379  hcibuf[3] = disc_bdaddr[0]; // 6 octet bdaddr
1380  hcibuf[4] = disc_bdaddr[1];
1381  hcibuf[5] = disc_bdaddr[2];
1382  hcibuf[6] = disc_bdaddr[3];
1383  hcibuf[7] = disc_bdaddr[4];
1384  hcibuf[8] = disc_bdaddr[5];
1385 
1386  HCI_Command(hcibuf, 9);
1387 }
1388 
1389 void BTD::hci_authentication_request() {
1390  hcibuf[0] = 0x11; // HCI OCF = 11
1391  hcibuf[1] = 0x01 << 2; // HCI OGF = 1
1392  hcibuf[2] = 0x02; // parameter length = 2
1393  hcibuf[3] = (uint8_t)(hci_handle & 0xFF); //connection handle - low byte
1394  hcibuf[4] = (uint8_t)((hci_handle >> 8) & 0x0F); //connection handle - high byte
1395 
1396  HCI_Command(hcibuf, 5);
1397 }
1398 
1399 void BTD::hci_disconnect(uint16_t handle) { // This is called by the different services
1400  hci_clear_flag(HCI_FLAG_DISCONNECT_COMPLETE);
1401  hcibuf[0] = 0x06; // HCI OCF = 6
1402  hcibuf[1] = 0x01 << 2; // HCI OGF = 1
1403  hcibuf[2] = 0x03; // parameter length = 3
1404  hcibuf[3] = (uint8_t)(handle & 0xFF); //connection handle - low byte
1405  hcibuf[4] = (uint8_t)((handle >> 8) & 0x0F); //connection handle - high byte
1406  hcibuf[5] = 0x13; // reason
1407 
1408  HCI_Command(hcibuf, 6);
1409 }
1410 
1411 void BTD::hci_write_class_of_device() { // See http://bluetooth-pentest.narod.ru/software/bluetooth_class_of_device-service_generator.html
1412  hcibuf[0] = 0x24; // HCI OCF = 24
1413  hcibuf[1] = 0x03 << 2; // HCI OGF = 3
1414  hcibuf[2] = 0x03; // parameter length = 3
1415  hcibuf[3] = 0x04; // Robot
1416  hcibuf[4] = 0x08; // Toy
1417  hcibuf[5] = 0x00;
1418 
1419  HCI_Command(hcibuf, 6);
1420 }
1421 /*******************************************************************
1422  * *
1423  * HCI ACL Data Packet *
1424  * *
1425  * buf[0] buf[1] buf[2] buf[3]
1426  * 0 4 8 11 12 16 24 31 MSB
1427  * .-+-+-+-+-+-+-+-|-+-+-+-|-+-|-+-|-+-+-+-+-+-+-+-|-+-+-+-+-+-+-+-.
1428  * | HCI Handle |PB |BC | Data Total Length | HCI ACL Data Packet
1429  * .-+-+-+-+-+-+-+-|-+-+-+-|-+-|-+-|-+-+-+-+-+-+-+-|-+-+-+-+-+-+-+-.
1430  *
1431  * buf[4] buf[5] buf[6] buf[7]
1432  * 0 8 16 31 MSB
1433  * .-+-+-+-+-+-+-+-|-+-+-+-+-+-+-+-|-+-+-+-+-+-+-+-|-+-+-+-+-+-+-+-.
1434  * | Length | Channel ID | Basic L2CAP header
1435  * .-+-+-+-+-+-+-+-|-+-+-+-+-+-+-+-|-+-+-+-+-+-+-+-|-+-+-+-+-+-+-+-.
1436  *
1437  * buf[8] buf[9] buf[10] buf[11]
1438  * 0 8 16 31 MSB
1439  * .-+-+-+-+-+-+-+-|-+-+-+-+-+-+-+-|-+-+-+-+-+-+-+-|-+-+-+-+-+-+-+-.
1440  * | Code | Identifier | Length | Control frame (C-frame)
1441  * .-+-+-+-+-+-+-+-|-+-+-+-+-+-+-+-|-+-+-+-+-+-+-+-|-+-+-+-+-+-+-+-. (signaling packet format)
1442  */
1443 /************************************************************/
1444 /* L2CAP Commands */
1445 
1446 /************************************************************/
1447 void BTD::L2CAP_Command(uint16_t handle, uint8_t* data, uint8_t nbytes, uint8_t channelLow, uint8_t channelHigh) {
1448  uint8_t buf[8 + nbytes];
1449  buf[0] = (uint8_t)(handle & 0xff); // HCI handle with PB,BC flag
1450  buf[1] = (uint8_t)(((handle >> 8) & 0x0f) | 0x20);
1451  buf[2] = (uint8_t)((4 + nbytes) & 0xff); // HCI ACL total data length
1452  buf[3] = (uint8_t)((4 + nbytes) >> 8);
1453  buf[4] = (uint8_t)(nbytes & 0xff); // L2CAP header: Length
1454  buf[5] = (uint8_t)(nbytes >> 8);
1455  buf[6] = channelLow;
1456  buf[7] = channelHigh;
1457 
1458  for(uint16_t i = 0; i < nbytes; i++) // L2CAP C-frame
1459  buf[8 + i] = data[i];
1460 
1461  uint8_t rcode = pUsb->outTransfer(bAddress, epInfo[ BTD_DATAOUT_PIPE ].epAddr, (8 + nbytes), buf);
1462  if(rcode) {
1463  delay(100); // This small delay prevents it from overflowing if it fails
1464 #ifdef DEBUG_USB_HOST
1465  Notify(PSTR("\r\nError sending L2CAP message: 0x"), 0x80);
1466  D_PrintHex<uint8_t > (rcode, 0x80);
1467  Notify(PSTR(" - Channel ID: "), 0x80);
1468  D_PrintHex<uint8_t > (channelHigh, 0x80);
1469  Notify(PSTR(" "), 0x80);
1470  D_PrintHex<uint8_t > (channelLow, 0x80);
1471 #endif
1472  }
1473 }
1474 
1475 void BTD::l2cap_connection_request(uint16_t handle, uint8_t rxid, uint8_t* scid, uint16_t psm) {
1476  l2capoutbuf[0] = L2CAP_CMD_CONNECTION_REQUEST; // Code
1477  l2capoutbuf[1] = rxid; // Identifier
1478  l2capoutbuf[2] = 0x04; // Length
1479  l2capoutbuf[3] = 0x00;
1480  l2capoutbuf[4] = (uint8_t)(psm & 0xff); // PSM
1481  l2capoutbuf[5] = (uint8_t)(psm >> 8);
1482  l2capoutbuf[6] = scid[0]; // Source CID
1483  l2capoutbuf[7] = scid[1];
1484 
1485  L2CAP_Command(handle, l2capoutbuf, 8);
1486 }
1487 
1488 void BTD::l2cap_connection_response(uint16_t handle, uint8_t rxid, uint8_t* dcid, uint8_t* scid, uint8_t result) {
1489  l2capoutbuf[0] = L2CAP_CMD_CONNECTION_RESPONSE; // Code
1490  l2capoutbuf[1] = rxid; // Identifier
1491  l2capoutbuf[2] = 0x08; // Length
1492  l2capoutbuf[3] = 0x00;
1493  l2capoutbuf[4] = dcid[0]; // Destination CID
1494  l2capoutbuf[5] = dcid[1];
1495  l2capoutbuf[6] = scid[0]; // Source CID
1496  l2capoutbuf[7] = scid[1];
1497  l2capoutbuf[8] = result; // Result: Pending or Success
1498  l2capoutbuf[9] = 0x00;
1499  l2capoutbuf[10] = 0x00; // No further information
1500  l2capoutbuf[11] = 0x00;
1501 
1502  L2CAP_Command(handle, l2capoutbuf, 12);
1503 }
1504 
1505 void BTD::l2cap_config_request(uint16_t handle, uint8_t rxid, uint8_t* dcid) {
1506  l2capoutbuf[0] = L2CAP_CMD_CONFIG_REQUEST; // Code
1507  l2capoutbuf[1] = rxid; // Identifier
1508  l2capoutbuf[2] = 0x08; // Length
1509  l2capoutbuf[3] = 0x00;
1510  l2capoutbuf[4] = dcid[0]; // Destination CID
1511  l2capoutbuf[5] = dcid[1];
1512  l2capoutbuf[6] = 0x00; // Flags
1513  l2capoutbuf[7] = 0x00;
1514  l2capoutbuf[8] = 0x01; // Config Opt: type = MTU (Maximum Transmission Unit) - Hint
1515  l2capoutbuf[9] = 0x02; // Config Opt: length
1516  l2capoutbuf[10] = 0xFF; // MTU
1517  l2capoutbuf[11] = 0xFF;
1518 
1519  L2CAP_Command(handle, l2capoutbuf, 12);
1520 }
1521 
1522 void BTD::l2cap_config_response(uint16_t handle, uint8_t rxid, uint8_t* scid) {
1523  l2capoutbuf[0] = L2CAP_CMD_CONFIG_RESPONSE; // Code
1524  l2capoutbuf[1] = rxid; // Identifier
1525  l2capoutbuf[2] = 0x0A; // Length
1526  l2capoutbuf[3] = 0x00;
1527  l2capoutbuf[4] = scid[0]; // Source CID
1528  l2capoutbuf[5] = scid[1];
1529  l2capoutbuf[6] = 0x00; // Flag
1530  l2capoutbuf[7] = 0x00;
1531  l2capoutbuf[8] = 0x00; // Result
1532  l2capoutbuf[9] = 0x00;
1533  l2capoutbuf[10] = 0x01; // Config
1534  l2capoutbuf[11] = 0x02;
1535  l2capoutbuf[12] = 0xA0;
1536  l2capoutbuf[13] = 0x02;
1537 
1538  L2CAP_Command(handle, l2capoutbuf, 14);
1539 }
1540 
1541 void BTD::l2cap_disconnection_request(uint16_t handle, uint8_t rxid, uint8_t* dcid, uint8_t* scid) {
1542  l2capoutbuf[0] = L2CAP_CMD_DISCONNECT_REQUEST; // Code
1543  l2capoutbuf[1] = rxid; // Identifier
1544  l2capoutbuf[2] = 0x04; // Length
1545  l2capoutbuf[3] = 0x00;
1546  l2capoutbuf[4] = dcid[0];
1547  l2capoutbuf[5] = dcid[1];
1548  l2capoutbuf[6] = scid[0];
1549  l2capoutbuf[7] = scid[1];
1550 
1551  L2CAP_Command(handle, l2capoutbuf, 8);
1552 }
1553 
1554 void BTD::l2cap_disconnection_response(uint16_t handle, uint8_t rxid, uint8_t* dcid, uint8_t* scid) {
1555  l2capoutbuf[0] = L2CAP_CMD_DISCONNECT_RESPONSE; // Code
1556  l2capoutbuf[1] = rxid; // Identifier
1557  l2capoutbuf[2] = 0x04; // Length
1558  l2capoutbuf[3] = 0x00;
1559  l2capoutbuf[4] = dcid[0];
1560  l2capoutbuf[5] = dcid[1];
1561  l2capoutbuf[6] = scid[0];
1562  l2capoutbuf[7] = scid[1];
1563 
1564  L2CAP_Command(handle, l2capoutbuf, 8);
1565 }
1566 
1567 void BTD::l2cap_information_response(uint16_t handle, uint8_t rxid, uint8_t infoTypeLow, uint8_t infoTypeHigh) {
1568  l2capoutbuf[0] = L2CAP_CMD_INFORMATION_RESPONSE; // Code
1569  l2capoutbuf[1] = rxid; // Identifier
1570  l2capoutbuf[2] = 0x08; // Length
1571  l2capoutbuf[3] = 0x00;
1572  l2capoutbuf[4] = infoTypeLow;
1573  l2capoutbuf[5] = infoTypeHigh;
1574  l2capoutbuf[6] = 0x00; // Result = success
1575  l2capoutbuf[7] = 0x00; // Result = success
1576  l2capoutbuf[8] = 0x00;
1577  l2capoutbuf[9] = 0x00;
1578  l2capoutbuf[10] = 0x00;
1579  l2capoutbuf[11] = 0x00;
1580 
1581  L2CAP_Command(handle, l2capoutbuf, 12);
1582 }
1583 
1584 /* PS3 Commands - only set Bluetooth address is implemented in this library */
1585 void BTD::setBdaddr(uint8_t* bdaddr) {
1586  /* Set the internal Bluetooth address */
1587  uint8_t buf[8];
1588  buf[0] = 0x01;
1589  buf[1] = 0x00;
1590 
1591  for(uint8_t i = 0; i < 6; i++)
1592  buf[i + 2] = bdaddr[5 - i]; // Copy into buffer, has to be written reversed, so it is MSB first
1593 
1594  // bmRequest = Host to device (0x00) | Class (0x20) | Interface (0x01) = 0x21, bRequest = Set Report (0x09), Report ID (0xF5), Report Type (Feature 0x03), interface (0x00), datalength, datalength, data
1595  pUsb->ctrlReq(bAddress, epInfo[BTD_CONTROL_PIPE].epAddr, bmREQ_HID_OUT, HID_REQUEST_SET_REPORT, 0xF5, 0x03, 0x00, 8, 8, buf, NULL);
1596 }
1597 
1598 void BTD::setMoveBdaddr(uint8_t* bdaddr) {
1599  /* Set the internal Bluetooth address */
1600  uint8_t buf[11];
1601  buf[0] = 0x05;
1602  buf[7] = 0x10;
1603  buf[8] = 0x01;
1604  buf[9] = 0x02;
1605  buf[10] = 0x12;
1606 
1607  for(uint8_t i = 0; i < 6; i++)
1608  buf[i + 1] = bdaddr[i];
1609 
1610  // bmRequest = Host to device (0x00) | Class (0x20) | Interface (0x01) = 0x21, bRequest = Set Report (0x09), Report ID (0x05), Report Type (Feature 0x03), interface (0x00), datalength, datalength, data
1611  pUsb->ctrlReq(bAddress, epInfo[BTD_CONTROL_PIPE].epAddr, bmREQ_HID_OUT, HID_REQUEST_SET_REPORT, 0x05, 0x03, 0x00, 11, 11, buf, NULL);
1612 }
BTD::BTD_DATAOUT_PIPE
static const uint8_t BTD_DATAOUT_PIPE
Definition: BTD.h:558
USB::getConfDescr
uint8_t getConfDescr(uint8_t addr, uint8_t ep, uint16_t nbytes, uint8_t conf, uint8_t *dataptr)
Definition: Usb.cpp:801
EpInfo::bmRcvToggle
uint8_t bmRcvToggle
Definition: address.h:48
BTD::incomingWii
bool incomingWii
Definition: BTD.h:504
diff --git a/_b_t_d_8h.html b/_b_t_d_8h.html index f2fd6182..5cc205f5 100644 --- a/_b_t_d_8h.html +++ b/_b_t_d_8h.html @@ -83,17 +83,18 @@ This graph shows which files directly or indirectly include this file:
- - - - - + + + + + - - - - + + + + +
diff --git a/_b_t_d_8h__dep__incl.map b/_b_t_d_8h__dep__incl.map index d124b572..f7b0e8bb 100644 --- a/_b_t_d_8h__dep__incl.map +++ b/_b_t_d_8h__dep__incl.map @@ -1,13 +1,14 @@ - - - - - + + + + + - - - - + + + + + diff --git a/_b_t_d_8h__dep__incl.md5 b/_b_t_d_8h__dep__incl.md5 index c59fa974..e025c0af 100644 --- a/_b_t_d_8h__dep__incl.md5 +++ b/_b_t_d_8h__dep__incl.md5 @@ -1 +1 @@ -f319401190d1085c45724d4fdcb1e6d0 \ No newline at end of file +cf0549b2c2a90bf20d4d75b13087ec87 \ No newline at end of file diff --git a/_b_t_d_8h__dep__incl.png b/_b_t_d_8h__dep__incl.png index 008b22f1569959e642d19c33f5b498d6ab9dfdb1..4712263cfe47cbc2b65f47e1669e26ece6d8d3ee 100644 GIT binary patch literal 20754 zcmaI;1z1*F)HVt~g3=%e3X;-Fhja>v($YvHD&5^8-BN-eBBgYfbazX43(`sn0%tt# z_r1RVKi4_OeeKO78`hd@&Jp(*_dQm~GsP#kSfp481Oiv)sgw!=fwBXiYcbH^zr)9$ zGvN!`3%Ms!h%4kjpX4vUrL4n4pf=SZ=|z#)8I-frW*Rg~0=JJ&axRg6c<)#L4+T;Ju^9qDiLvae}VU z!{Gle*3PGpdE!R*(nldT`<9d+!h;vKB!Nca7}Wmw5*W(bx|OK+ke{giA4bGDBfsKH z#F5kQ{P(^40P)1%Jr{R28sIv80_5QwXrQ|)SEaeeJ_|5x6-@hsm z5D;9WqN1vlR1W?zn7T4w?_nAAD7YshGX?Hq)O>cdHHG(xnoYkhcu?%>;|>RgvfINi z$o~hop?@MH^zUxevXTE!i%ANWMc(FHvmg4zS-oDZ^Zwys+j4u@aG{=%Znf<-1J8rU z89t51op^npL~6&q#>dAuhBMID2UBkv8?P`#)w}HJPfkx)?#kdxXb1eegVc?`e}4}a zmy}#<<>(q5?2Hn-3@*^AdU5n~jD*7wfk!2ZgXkI<=y-bro30V{O?0$!fmg5;jj-1l zQ4k(Q%SQo+{qw!X)~2R6@jo78MC0K`As;~PO-Kl)yn=$!>(^++#Ke6mLc}E{B?yF- zl~rO=Qp@Nl5d#AQ;@+P*_#{kOG%niL-#=VtqU8B!Edkb&77&G@d@Zh=5O#$rxOXib z9<^Y8Fp<-kuG`1>79k-4IeGYS#uMX{-MIo$2I|bU`(}*D+lsrn3H0>#Dr;y2_Vvm8 z`}-T7?k^S07p0_7d=l{(U*+ZG5!`+0L#dO8Xm zx>k+jgX6u0h1`qRuU_%!-0hg1B}X(Z*=jqnNCa=2y5hjTq`z=^}qkhE2@&w7#IAz{+n%t~RP>hUY|xT8h(D z9%+^|sL|Pfa+%=+`{;M1y?4QtGx%LODB+ZgD|sb?@LroP%;S%bcObuLXmk`8o1)A0 zI&<*w7z*i11c(0T1kt_;353qu)#2&sT*B^gH}M!zJw=IeP%#41wT}k>cv8yC9~zpO zUH^>J(IL5ivasoTzN5JKdo!JnI@9exqu|;<+{VERqLmrA8~8{)zPQ=y1`74B-(k_I z1~`aCd)&p%Dc@Vp62YSz-`|33Mf-mEaE+XtC37~(_q~Rb&G~4K;{E&l*9Zwycq5|l z)Aj$`wU^J7sm1r^ZN%lmCRUww+0YT_twAo5j)$a&JIq$;N*L5v=}VkQLm|43La;m6 zE1{;w#b%%=t*a}TpC3+*A53~dCYp+kifYxDdd2I0?1{=}Bih`b%>FrVD|~e|!Pbsb zb&(sv#NOIrs>2tg)kq)^ z>gp1+jaT^^G5X5XZ{p(#X6Gnu*JQDJdT-okFS0ynU}oatu$k8x8j0~X${fEH^2TDK zXK{^Qr=^br=aVo&Q-?J6^z;bT?~P&0)gKcE*&&@P5}KOWH8s;i# zMfLKc*x0gY9ePGw_S!AOLR06%3kIo_|BM3xw`$p$Q6iv9Rc4nt+26piu_1Q#sBM~` zCr1>&?A9k2bgXYbn)dRvv|VgsL=c_tX=+XoFfh=*OFkzfk-qm`^zf**xyzJ;i8(dB zPWZ;!+9rNTPtrxL^Uhi8(2!){irLEX4trV=`&!j?iBXb&F7{C6`E&Z17_Mab5p-Pp zW-^;ZzS9#GPoIj z|AP4Nf?jIw-*ZdRjw*~4>B&8Lm31iNu7}gw^xXlKiyM1Ltwn{$~~Une(J1T4>wavuN4aBx5pXW|A{(4A5O&9j%>W@DSg= zJ?3}3f9?FlKvKHH0by#ZD-_lFxXPMhzmv*gsG;5{FLFvdmhmcdV}l4IfX4P4`QL>r z1qnmL-p<4@P8`2CZw&CMQin~Kan%f7!9Eq2aksaHP-<0LUgsyr`}Iqo_P(hQrEr&Z zac4^BO1kRTi0n>v*xG zJ@e1gR4p-4!ck0BeEaFsosRI$8$LcRmQ(ga_>sZjQbiszy)qTXL6m3*L@9$%I6E&!LpP5iRNv48~FS3Z|Q)7AgEh_J7vL6F; zc_&#GW!rs2a{apd(y5{;`1nJ_gbatipY)v`$BJFm1$=XGNk40RfKHBA?6_&m zq9-Wvz&*%ix9;trsF1G3FUEx4<_NOX)|Pa=yyJS06ZL$3is6?xC|Fr3192T%BPsSK zJml{aEo~JkEhQKX$OTUC{}B$SS|HP@l)v^&5}~ZAqH8QBs#BsLruqxdyRAy2>nL3&du*K!NE_(9UZaq3nDnZJ*lqWaFgi~ z8CO%Mmx`iHP0P;4fe5ctg=W;3sBa&U!y_Gac@08iVZ7GwKf3t_Vt2SrDhp$9TR9T> z?Z^uCQljyRC~$c7?*@0EEfF zZ1X1(&Wh<*9pTsPeQx6auK^HE%8s;KFL;NFc)YM(eM*y?>rcX&o;)g2vo%5W*wq!q zdG8Y8bv9Wg<5}u@oR9By?mfKdKfF7)V|#WuqCq7oEdQlW_t_Rdx#E#}(A9+v+PvG> zCuQdX4(oX919Jg*6!HWV^)=mAs;a;7@7#fdD@^4zp1rkc!1PZw_^nB0J?9=eI;tz5xX3nU$IN`=^nB09V}X@5VsURT((HR( zCfl4$aPH@SVMgM}Z28b~T217&SBt;sWS!fK zWQD%|F4xG`pd#a|ON*{x?pJnmF0= zVLB~;@^aP3(C{-Vg5OIJlgg`{%BIdJaKSs7I${2zV>JKpH$0$`x%nG-K%<|d-nLE^ zW@Rh4M#lenCk=7W`%F}EWo3a#sz%@aeb=^5lcw?U>kzq{4>vD#^osPRyngo^Ox7If zW?+kjqzF}^=+$&Fe!#_zXbHq+wEa1%QupWePJ1RK3=WrF#mq13OEWg82lE~xYxaF# zR#)p+^uP;b%L5Gl*7}NFG45ttIY!YyLk1XJ`Hjf?L%IT0(VWePNEPJ3g;S_2lcQ{6KxW)=*cN^lb+{tWDw!%3-|athP%~%P zR95b;c3>o=A)u8(E`!7HjYAlNZBJ~qrqkZM79hANSa{3A0>$O!E(hnZ2|YvQ>iQj{ zooU*N-QHg2mK34qBwU$t1?M~4@&{8U#zc21@u(Ui2nnJQ5CH%Fb*Bc;6mfS{GiC9A z`d>IhWXg@8<2eTAJn)dINpy|xt8uEyQF*!&$7+V2ODunO_`P+qiX8%!yYbF6XMVYX zvhrQ91}Goy&o-vAKDZEY%1!9d%cAZHL)z}}vm%3pmGyo`rsz!6BgS~=T}xlP6?fwi zIwfraRji)G^00uQPUEp$497j|Agh@#%$}4|3d@fxAG(QNS5`#A+u%UggLIORkSGG; z1ZtU)YfatVSd^4_vI&`}6+s+;vM6W>=#@)V)-x%x*}4Tx1{8&TE=iHm6{51n3W1Nz zZ2dXb?ris4NIEE}A{=HhjD7vM&m$sC8Ia|ylmbs&rUO4Yzo52kj3a=!th&FcDSE-+ zlq*qUFZNfvvAbV3ml%7r4!vW*?va>^b^csqx$$ca-EMmlw=Y%fda5TEmM~?)PBC5m z-jgVX^iq{z0@{r*T4mw?uD|+&n3jRzC{>3vCf1>O&3y?;Hwpf4SZq!4hAE^NK&R4gUYo8dL6W+i+&4yzRH#;aL4xSC!2M zuaf&rOp;fZiVt(jakEuM@DMJ$FO3F1ra&>*sU&v8Xy`NF6kg7q1FTx7g{uF;_PHi{ z@Yz4aqbAjV`w1CYtf=Wb?C^+qAsO_`f^lV+x_v+;P~LPpyPC_4#W;U^2D~eRlPEFl? zq`fUqB`~OSWl+rKkz8010c{QSz0d3sxEcs``RVrK?U3dqo}k6e&EQlYJe6s7=grN* z5}zv`{{X$#-UPMKxGrL(x1`hc^e{!g+sCl8+YAot6}Pn1uBS`cX%BySu>G7mlKflb zTy4?v=J$kh6nZ%|0Whbtrl^Dm8QVH-EeIduB z0o1Y#dZI>zyh%$;X{jt7{VN(#QPc!>#+B&`M>P#BIvMwc20SDXGiDM?YZ6x~w^0fkx{vK7Gu>`I>-rY3+FPSH20pleUVaPlKIy>vZo;mwLJk0%|;n}dFJF+K<71dkGSq2P+%slQoCQj_50V@&tJa= zK%Q!bPzy_%!i#z+J{RMRaQ#zyJ?zfTBY4fLUf&0Jg&rEb{P-|SORP%lX@M!wxKMzV`h|j&_ zq%ht7;>8Gu&!zRo*4ARx!rP_wFEt`#aKK29=Xcx?g#Jh1&Aq_S_t>HCET$ke`j;R^ z{2|}pV`6%4&&=Dfo;>t``BQvAB#BT>Wye}=ju)RmyL=J(?-@|) zOgGR}zUsZ}d3A9&oNNN!z-OoE&epZyMky+RnBd&ppX|eslFKNTv!;#sisJEjaxx*H4cup?8$|kQJ0nuf};k-e+=A76rPIBVBOqb;HS;F`64IB4Ffx@wb{=OvXT~8jw2wsq3;i?JiuOH{l0rG&jd%n;36(G&6j?ZTM{WpH;u@*) zA*0`@wzG2@olI1uVsn{E00+mA?^hF(!@a%h?Cgw(8%AF_uNI-QNMI>~O-He?FoqHZ z{reZUoW~DjNB9+xCV6zr`!vnHx(__5*i7}!wAX`zT9lI0x=)c=XzAHqX?E|evl&$7uRjj6>&QpNRdZ& z7`~}9ZbG^SLm%l9>|9nSKG}_E&v^1DMkY(mO@iCZ9Wv1K=Qk4hZ1`ZGI@bFMIh`$S zAm(z%$D{ncIBBfkLwe=jLPB9~4hQnAn6mQoZ((9a;S(pYJ$EY4mBsMzaB%g|R3bk* za8sox){G9yWrCKn=Nmvse~%`tz<&(;5!^d!N6y@g+vg0#vk}TqI zbNBBGD9UuVH~Sr6VAlpFu;;OdoS)aOKr+wul90%hl<}~F6ta{Nb=(RqqM0gmi#7=( z9_Ggvu)@S7QdpsWqF@D;uHINiO{Czz(^B)7AlRMnm(bNkTVCO|Jy=Gq^VY*-W~PPy zLLd}OXg8g+y44Y(p*?ngPaCrqEUgp(EKks0aipZ^7WbF7@UgD+mOtKkPOXrZS#NavHj3q>EebVt0s+x# zKm-}1>F7Ix=-}pf<_AaPX3(>~SL0mqN=R4*6`5KBEKDEKDrh^Y-C5S>JjfjR|A)?y z@lfuY*-QhpFR_2c5B--CFOOnr#qqvgkBI&KYVA~RWUqs-uu40hDeot8;pN}z>L#k4 zS#gmt9f~%nG$2plx|}GIJj||PgqFXeT4X++-BHm09X^M5`NtfuXJxG+!BAKCgO;0O z^3Bl5n!*dY%~Q1TSc(oBq3B|b`sK1*y~ta2&4m%SSG)75bFp0>amg019kU%_K#$09hsP}LpA#Ui(ifc4)l2R)k(rH+wD@N8Ng|D#)3sW*G&7-w)knr|JTw=!XB7Z$A zbM*y0wJW4A@3RLO4Go2sL77Bt@p;aB4R3{9N*AFrX%fFFpR|hU;2>Gqs;YwwT1oT@ z1&6+K&pi)x(F8o|)V)l)ITH&@ZURy2!*0~b$oJr~4*|LqlvzyN&ew4v0(@}L z%l>_+LFDNEgqps7Kv!4oWEmqG7|F(HjtGPNh9BVO=J9d=o&8Z1`W-3Op{hUc%{I!F zlziB7;=SSWSlDt#fZR~gHBQn`_Vz|CG0XkXZ_;pZ6c@B;xZSzajE`lIQT`BfZOv@| zgenS2g|*UH-Me=W0c?n6kTQ0v4VvEEz%5}VM3I4*=ih@)%b>Kw$;)(h9U%qNSgq-#bWxX&DFpxs zOj!&>Z~0t#p?e&+8P3i^}8BxtJue1{KZ}#I` zT52UXH9HuB$afvhy=i9VM!ow~Z;nB!^o+Fuc61DkW(E?5`su zgmVFvMgeI=E`C@0y8O~Ru=sK z#5kr$L$9kK`P(-Ez&X#JJwtr1Ig^>QGM~4et5M$*MMp=6o-wVMSn8U|SMAlYJ7#8P zxVyFM7q}N}a%8;D!V=mUyXV8e>3Ms5yZ${bd6^s&b1Pr>+pQEK7r@%0y1Kf>)^mb! z2?@Q9IL`;F0*`ZKe)v7Kx~HHcTc)6wbgUi5s#{&GAOE30na{6v>7Iy)p1r~A*9_46 zWz(ziFE4*6b5xcj#wVq&uPHkn(h(XG@<>q;ue7YpZoTjB%a<<=50={z2r)4+VA$?4 zGNJ?D2Q;Gye6qH-t~id4j}Q2d_e*oxn|D3>dD~)8?sj(utG0)wxnw$y`6p~*c71>G zdrhM`s`OFp+T|Dr2L}K>@jnT>y?yr%pIpqFyf=Y8!BSOSJs?XiAzd;EkAs)DBU?G+ zU3B#DA}5hoLk_ChG{UrjHES*q(a_NFR9-&+sC{F5s%-JVH8?yxZkCvk5S4<0!qwfq zrL7H$>0g+L(X;1Soc`I@5b|1DT49w+3JL{I25M?V#^&bQHZ!B6YG2Y+v(kXgXgxhW z<=7f8h!wo^7z-QQV*gw5x2sCau$mLTlUgkYtI5fQ3jfANv6a2OgnH5A9L#w>=^^Uxk@EWdGqz_*TCo2x&5~Nwc3qF zMTixk)#xpuA7WvglUh-@biYLG()` zm|&@SE^hlks#p}*M-%KOP~ZV?X=sxIJ6EnDuA^Lg^OLf5XQnEnxcFIVL{$|ZrHDJ- zpNp0N>_hb~=G8zvnc-MxnoiQxQO!-&~mic(U);28`! zJalByDn?LJQUcR@1F=0*brYi76X56fcWd{SgQ&d4H8eB|yvRk|iSjgy0-w@JfKNH^ z%||@)L*sG9aq~Jh8~Jljfeg`Kl~q17nk7@@q#!CPTJ3(sgt*7Wb;|~zFzi+HlI^>9 z@80zE$kH(|$i^JMR|%P@P&hxpRL1Y(5dN~;-_;c?BPW+vWhEE%vaPd|&o$?R5lP3` zSiFGyVfO0D`NUfWe%}X75=4oQPEFy9y-Uqa+QZiy{wf> zVB-W^rHOv}MJ}($@k3HqYJRJ+`Fwdr#RqE1K#tAL&5BCG5UD=k&Oa12oP};ql`&>y zWwn#@+kT$EY`8eqK|_28S;YFmN+&L*Ut~3*x+UudxPN%W8=G`se?qs#N0Tl=NB`x9?vOL zH$z>iRF#B=wQ_QD3`x*%T0fVU6M>Di&Db=uCR_*#3i6&#u5?B%t*+AjnHw9sZQL1I zP!Um9R<`;BjP)Kjw`y*u+6Uq3^mWm;s`0k(T4bS9)6*#8WeLy_2}#;p2@S>iDCB|% ze-Lj*MpXO*0(^}~4tM9skRii*w%V7+Vth3DIwqp`J*%X%GcSYU$KcPOKchua7Y&Lk z2vBK{pea*-Q`O(9@$~e37aQw$dg?k`V91Vd(B}yJ09UUAJ;#*rQgoA_g za=MYJt`O1(inx-}&9FPHEg4Uu-X$bViA!O8~^=dFgiIoY<5-`8U7)z6_=Iy1q3_}J2}{%;)W1+ccmjjQd%1AJ)0iW z6ayXIbqIrqH)h|z81*Odz`F2u=W2rju!+Z$>&jnt-^$F&qNb+427Xegewml^-w9Q8 zzOTf^Gzv>gqyD0h9N5$({!!G66b_yrPK_SV1EKgG|u=(L(qTstHI$bN1Bjwc8 zmROjW&BO+tzPFh*?(y*4uB@y~d}wxSyikvM>h(;e6`Ty4bQC47ulSoZ$sig!I;mf- z7K3~WVpN%CsBXiD6E$oG1_pptijD#uaKV-U4}fUsjoP{L*hGAcb9%Hk*ZkD*a7pt{ z*4&f+9dOwC1jP~*g0X+5XC z)sVEeP_y?+-Am8xpXLT6ME}H8asJWK1h6v`%biH6Rr)1VG*U8I2tNUVS_J*miaenX+=oLwwggUAuU}Kvrtj7nE}6o zVJ3H&`W{~;s-b~5l2YM%>L6+YHi8@|77&Z%YR(oa=p>^{O6uA2qmUA)y8gZc=EavKYQkKv!4PXv8+gs*sT;4Nna{B3!y_ZAV68Ym}F!-#LH zKW!P{z+qy(VLy{9eDXM$OID`)mC$t+NpmKlJW-4E@`qzS1vy_+vLj%tDVLU(0OyXj zg+1iy93H;K%gX@W);Mzy(NuKiJZB7y;?|z{1>=#-X(z|WG*4} zNaC*tf-ejV3_~HDkX$CpnArZs_2Z8_&*HFjcGRACOUj16n30?kbs_rWb3Q2H26jls6EBA8ivdU}4I0f9T8 zJh|VQiD^XIC=D+(tis4tE9adt)At{d=~p(y#1<>vgtYtux68XPZy$)RbM(|~6H-ep zeG>DD2qUIi+@A6PzM>;fGs|?FPy%Xdysz%2@;o5+sa~|@$Hxl5$0ECwq>KuK(z3+i zhvmjbdH%xUXwHmQ{TV)J9#9SO?;KOt)$3`ON3CB+zq%P6eS!dJS$MkV!}u8*^Y$WW z)RrUyzpiZ0of*c9sKNvsJSXvZTo-cI?Fc5A!zUFC+p!&;j%8#YDq27T;l)R> zMie$SX!_C-l73eVM$5~_U;MQebo%$V@&3`Af7QHpn0g+~GYyRpq?vZEjGdF=p~HHi zu_a}?u}vDqk)4}Mc{Q)rvb*w|!Fk90dCMix)L-QP+%7W-q7iEpG~(mqlLF#})w82N zS@;_j|CKHYC~*R-PBc%q%V_Vj6}~$!!BCDvwr?Liz(zp08?=9T9Z{&Sa03C#LgMaj z0hT8j^Pu-YYq|!)hK>lIQi{kvq?nEr5<4;Msx-3dgU;7PQLmAW4IZ#r`OmpY{m|+k z$Yd*}Hbk7BKEV&kjkN_?7F$A?l9<=cGLxGq2BjOcNd^h-`rL*%kHT9mH z9!+VkZ1942ZE%0`)!Wnb&rjQ+2NER{E8M)&-MC=1@r(~VAHd{cs<}W@q24gRGYdhg z7cbhiYhG*K@)Fb2!xsPy`r4TRr2Gv&5(_^a0Y-V@m8+QsF?ZvlroNHD2C_ zvK+*TLcvi6VTp-K5KpCW$ksLT&^;%Mtz+5}d)J!!`|*g`3*+dvk*ciX*M!bsS<$q$ zD<=ykvMI$+o_vK&QnY_G@%5QHeH`5o0=_gs6IJ^c*VBl>A2dKZm6u=E_uRt|-v9Lq z6X-0ej>x$)r6OGFTv{5MNA`GTW(T&1rZl|-W|g3%kSTnsp^j+>-vAD~+g|PG*5!rC zm74gmcnMjM22zT7`+^h$pS%uLuO|PI;UX`R%qups#=t(uKiRt?HZr1m zalHL#W2m`&_yXc!D0DSlh4J3Al0n9NKT5V>Wp0jeaA=kGs0S^Mbi_|z1Md&|%mmi* z*1OD57N8R{UcT+?L%|3*V(fF;d=bW`XPGpYkk6oWoX>YnlkP#l_pu+GCf`0e(vN{ z;R^yQFwC0ytTs?Sfh2}jVFE*Md&W)LgYqie(9gEF{8w*#BT|G?ibnRhV zF>nss_!i_Xc_V>F45z5QEhEFT)y4Oh52w`-nrH>?`Xh0l#h+EWihWyKvoCG5(IIZ_+Xwv56X%F!4%1+-_x`)5i5z&c@H;94xO+J<0{&?|` zbNv8ubnv6s>vH76BtZ{UK z2#wx;6-QP{ksbg04?x^j>r#e)J3gG-WEZyo$)df$##k?9nTba$w4vr|XJk@{dI2M% zfI6?W(u(+9>J_QCcm00jRljL*#|{wMljWOq`VB1Y=v1eGq&Znb`{(Aa{TN{FJlqu8 zUu-VZCRA!C32cU+EO1vG;o{+G+F!EfcUZTsZ%gUDK@#YfB^P82Y9OqTApGa#BHBKt z;girZ4i1xh0>l!F)R%9|%OlM{9LWBLL$-lRmQ?ONjxjaYk>iy&@2RJC1kdAKPMrOp z>JO0e;KyNsr9^tY&y<9yWmo_Fo(PUmkbJqS2M5*)snm4^*8wOv6o~kzr`4cgt?FMv z>L!F-q-p8sus|^j&D)ThV&phFIxYwtTS)6IHxqj15R3!8!l2gnss*$c%Ti2NPva8A?@1uVY{kXp&7Gi9hN#l^ zMd2D&qj{K_QA%gtY`nF7E8Sr4%8msyl&v4F{yxF<;LK zBw2I*^Lfyy zpJ1%7Pn@e;17HUj5->kTC%eof++V&*tWamtr)R{HDNOqQbh`^t1T6XBVV#_B?vHys zAB$1N&CG5fjV}MWAL(4+)4ln669rLyNET6IpW17jys<)`IwJ$Sp#rOQx#d)_b{N@% zo_deL{jDNmWPY%;lrMHaGL=u6E^1%-t9>5T2)4)l+P`Ufnxr#|y*W$nW{F`l6+m0@ zd-%-@1|=dh!un2GNjo#_Z;aj)>RAW3DMJ+j z*4@9C9z?GP4y8LIUt@*J^THF1boBJ*AxZJxggnBdnX1(P?H~VI+cRA4+AS`#sMB!Q z2@R9$9286KoGLq6{AuoYb>1igOw3JY`eN{j(pTt6w)U%{7Y=l1LHp+NQTPwR+qd4R z3BA5SLCc!O*f@tx@aujcKen9Wx*;g&sijpeX}TeQ9nHGcWg!JFK}$qQOs$XuKx{N8 zlY#Kq90v-C%uKyU%gbB{H5ZJ1SKVMK`2qoMPtlt@Gi2$K=&G~z$pN2477UryDr~PV z8|$~1E2P@8{3F5-7q=|~U=x>?UyK=s7`>7Nn#D?dHklG~RRX)16euSF{Q)O}YcU=! z4eptL^!cG$rQMH#=OlvV%y}Xm3*H{2J{R%+7w12k=jV0peG=Fz!P&*Y4~^+X85!mN z{_1^r`sXOu>96+%`N7e|B`B%!(j82&f#g1ZbssZY0}u?f3{(ovZ{4C?^0}(@2ep^Q zToF?|_vjQQIR^Frbj7z7MrXi61bl&;)C0@*UVec8+$lqjih< zVo9r`m{JpQQ*<&!AsGdqXtmv$pY_+2$&+G}L3Jr97Lc8QIz#el22$4rZ1&Pr+1?ah zz$i!&sE~SR(+w7AnhP!8YU8m2r7${P8#V8->ihH@bBV$;wlX z<_pir#chzDpRcl3$OV#+;5c(OYscelk=50|wbjGOI5f$@my?%&|84#&vfG;w5HaxP zeMP+lbK3eY0>LzpVoS&-Zx$CR_}v`|aBv(a@xt)aX+V=39jn^qOhVc^HH8IC=HcNF zTL;yG+rBXRkx78dYTdSEiMiv$*kjeG+2?QMtzs4jo438{>O_D!&@Xa!44$@^q-o4F{n92Jbrw|W?gRBj1R(v$D5sW%obD9X1Wc3@yU3}JAaO4a9Spk z!L{|o#SQ2ff55<$3Xpas6t}3QLY_ar>({wLBXoXyCe0Mb#Dp2BeTvFfQ%>M5 zrY+3vGOqsqpa4~h!lvdULW^w6l@LO?xOB^mhrl%W{`r0N21WxwYv;dXJKgtlY!4(` z#EIM{jEbNBVx$OGmd~Gc^!REJP7a0WSzhpxHwTzE3jy)9NvGGkoE*XyQ%AG)J`$9 zO>%4A;?VDeE<+#zBu*(d5R{QY4>d6i%B9}{>pVPJkm>6C>tdI|-bfx*wXlmqMz;3A z={~Fa{h9l?K!Lx#;R9n%L=Y77%VUk#WMJeZEsdMgeDqFVaur#vi_d2j5kY_a_L558 zjxrOqV`XKa-kR3z-^IkpLAVNi=3+++u*Q0Bd+~>6eRXv1(U*x#rdMQH6?Q9_$fF3t zV^!;BSAwA^u8x6}G7jf$4bRIzoG?blk0i+MQ|ssu&eooU?{GW}{Pc+zxvL7fGT0g?<7(P|YhS^-SycIMB&D{{sPYJL|#0$YsmufSfz8k0< zc4d~^1l~JQm{mq09R^y*INAR8h=EV_K`kvRTH2MMg0@-yk@~f{^M^vkhoP@MuuIX9 z_3m;@3>Br)A_?f3rD7mtmbyTHJyj+N0*YI8f4=;br(y6fXC)&e1O*?m-UFrR6y6hB zejyzrQ1`~4rGpa0D88CcuMWjbMTMcf!fk(lBm4%onz3ERdzGWoh!If98Ls!?gDh%s z!oaV2CFl4ysv9&4P8+Y1ulrp64CO)^z#Zo1TN2uX9bepi=?{vPMvirL^Ob=mHyKnj zQDz3GXyK`<9$swLGc?VfMY=KtxU!!S35#A0)#m0Oey5+bBzHGUDPl&3hL>pRUf!Aa zI`QaBIugR8{8&^Pn}tdJi}us!D-b!(&I%TjN4&Omu0%m(X08G&6Raf}Mz*D zc!!lV6ttDC-7-$HY!z`eaaM8T;{`u#|DGyrPxFxB;oY$e%5Y?1oiQ5xBtXKwj-Ib& zhri$>_F?B81~tp~iHX4IXtptP&3lA|UQjdy$HnQMp4C8GLJjQ6N}{e>89EXJsf|%F zF`P9>1+w`u-%?~;kfyt_usPB769k%Br~e3wUEBcZty-^iiiDdPnMMa7AMHmRZFXt|4*IzDwGkXUZ9okylBru zD^MUq2u5WwS3~>ssjGj+6XG;44<_|-6>V+dzsEB;b?3Wx`jT#k1_%E+Y!AZ6l@i$r z)hv4(4$8Fm8D^9hCig1pT$RINgoxn3D(fEmUd2nhj8tzdl{`plX%E2ZZo?!tH^qLYZYW8Yz)4+F)wMPEFr#8Vy+wE?)z08EUA_EYm%>+W+MvevGr z$fg$rjz90Mq|VJRAgcCp7Z;gR|tGAoWvVs=xjd32}T;ILC!P zMeB0ABnWu$)5Vvs7zG517B{jRUcHNt$jHd*QG1t`sfW4-dPRWVwg4@V$ocW(SEMD7 z@E?|deImycJe=+1#n{@v)sr%q~_u5ni%-L{0n zySu#|8U^XXp!tD1&jz-miW5c>x~th#6jZ?~kq-#x2m_t|1v-8YFPXyY`af<)z&r}5 zFT9ZgSN9`#KcsVEK~;-@8Ysd-lLPW4=td!sf>&v(g6-GXE{TSQ@z~hWJ~y=oqk*|T zP!Zo_{Bc_`<&5ME1YKWPA?&-tVDc?)lRyB_QS@>jL1#!D)an}_&&gVxX*e*T(KX;5 z04Xqw>XrEO2RCgKmx* zA7i*6nL;{zBQk;vp5ov2Ssi|kT3JrrLZZ^4#zw-KrR;j=9mf)j3Cp^3Yp2H_U`{11 zdQBa3m=0!YU5~>9JMXJN*@6s!^z;ca&NO25^tVBfbvruR#qRR2m#~Kh2FweAVkjJ! ztiyP+xDZ4uuZ85Zp1dN{+5JDD6y}ql8T=4Pr9|j$pAe8#<08R6vql{<_PpaoLes>= zhn1~E_k}5mQ-pM~+g_^4PRDDhLRu)>_=oC%yd=4wefJHZ;5r$U7RSh5VwFj+UkU z(7rWIYL)fkvUXr+ArSaQ$oB$N5`pdOfhPU;`VLC!AapOjn@O-VE6e(^yqnaZVTH03IVwD}WLmByMgc(C6Tnhas*kt7V#;(G64wpD^{H=hcJ(sD zxbqjV2u?V3Cj-<@=cWJPiceoBEJ|BGAdfe zUX*@l1WUs575BHAIfmI`fx;HP(*~2D7}(gxh@k>po0=Lnc~I;ph7kG~d7o{v{N6Wm zo_qc7ZUq$y5?3>przmaBzQqzua`XZv|!#| zXV(oJX{CRuR+6ZsfwQND9%)o4m(>)Mw#)KGz+N@Mk%l z@&v#L`s1%j01`#gd;c%*WcWt6Lyq@#ydTE>A3b_>|Nec%Gm++uU0xm=AaGHFS|4d^ zUu1b~%`Xh?@z?;B4?RL@Z|?@-Pf60*=cGySHiW^!n^9C^?=3+y_%@zdGu`3Gz|h1* zP*@oDc!3TuTlOC!se3&#)4X^OKPkT&y|Z2G_8V|m1<34_w=O|pAo=78y36kDwV}UT z_cgS&LxIlyY%=%>$liBm`LP9@y55Y?llNFGxbaiz#!K)~)Awc`p)!mJhWxaUu0wMm(13t~p&aT>T=jXHd z2L`5RXJf!%D$rr&M8)Oil?&}*#1I}ioPMfxuYlx0!qZb2k3!I&QR&k?VCy@hs5*bG z^=|Dji-=IbTO*DxH%tFeD%1Zm4FfTX`xU-Mf%e!UXEv+(7DzzgFF^g@fhHY3;+dM7 zKZtCM=W3i_ZZY}g%oqJ9$Tv6yg4SVqWu?UIJA-bcH$|RCK?}U4gA*8ec(FxJ6k~rw z8y=-_Fub4Pb!r~}Wep#v*`NnMOw`)y9hoXKXG*clkmKobIQ?C^(oV~GA)B}8N&mGzkB zE54RP7^9GlzThj53f#5Xb>W29iM)n~V09zKqVC@-V}QY+Mf@(xw+csmb*@%s1V>b z9l9rdpJ;r#Ff-HN&eqn@d3%!j=pb{B81Z_(&Mh1Sgt4))v{QxFIMd@gmh0WlV3V)v>g(4iZFJ1Hy%t^@PrC_I z_Vx8mo1gS2@!3!+eiEKqG?qxi-|H*nmyI?H3)GCSa2g5P+n^ zpYG04+^9}e1jcm~#Mr{qDw_qiP0Z^E8yg#8kT8ue6o8n~>-;$WjHJLT>Z6zsrCyDr zFPvusKx~a2x#!&@ce=Z~k%wGX#tm}E{q!}NlIpZ}&Aa?dBcHYsp{Z=7n{@*J|>_Ig6%ao%D2_QG+k=l0~(6bQcs_+55CzMM3Km)d|p2qFG+iL>WSyO-6B{lNnm-oOkE z3yc2vF&vaehSTL{Tss--3K|0g0}+uSv!!cSGvBJ-WjC0lek=`Dp9(FzsepcslE&-6 z_X)NaR4vVR1AXL99RizYP1jN!W<6>rrawiLt?NoCD-%!(yS{l6MY#luuctCH!!-=t z+=TS>^wmCBqVUQWyWLp<)elI)qDu8 z8$^H6#=j`DnPq9(E^nFwFj+L*4kqXl0?AZ}8Lwt@5r`SurPX6DiH@fW71 z80`9WLzdI+G26OPR}<$idzm|^VAZ4Z^MwutX}?IkI$!pHq}2TS0v;XBufxO4<>eRs zC#1H zT6t-O60Ovw3F7dQP+4AcYK0Ppl1_)2Im%m#+NRCYmDf_dK;jFXxAgT1Q7Du_KL(SI$Kwso)v>i`)v36+ zul6`OU3`5U70JD-11L?ZFwAAbam^u79pQP0*oENC>VdEeRQ z`1$z>24(GU)~#Jjr$*4}7P7#osVgL+7mMbo(CN-Tdh(>Fv&A#*Zr?6xX!yFp1ud{53=X28E6xJ~Em^O+20RbKP`z{%1`2?H7dyM+H zQDkp_zh79`ww9OCJFKnS8J#K|AcdJb;32HP9;i)#^}J&_A^n@3ZvpiLfx96oF_G_C z)X^&up?V50`?z&H8_T7!%bqe*Q&T&-#)Q~Uv*p1i9=mvgAXAOzsymf}MG~LYC+Obg zBHDnlTfQzewY4c1w>vwF^z`*#L9Um;hh?QY#Bn_P+9;!fk<EU&C2@4@S z+ccn#33U3+!9Ac$6@6724Xd!Ym>E<+EX4#@OQnsyz2A4qa_OO=22hug)352ntLwvS zjg0gWAcZT6h=yinW-65mfdGBa;PWk1#ih|Ng5v`_{Zmqs$QAGunr&>1d5Jz>eQp( z#m2?mC@Wh7EU>$$XJchp>)NyP$}ToXGh>*Qm8BBXR$`r5X>iYnH{HTv&1OG$NgfmDiw1WHan{AFwux>76#&z-@>)gQvPw{>?X z=jWpoO-+ombI+e2X&d+<%GC{VPAYXMEGdcT%VqM?xX+JmLn9Al+dzf78Tx#s&CZ^} zI5>c1g$9&*m*h9`ZW}CiGnGocn3}4GfVmpl+l@Voh@)8A^ySRV<)&C*2Plxs&7rN= za$S{|2Sx;P66D8}37=z>Az5v$m6g>uQ&nhM^WIs6;-ye^W_Nh;h=3F_k^o`_^80OM z}-^i6KPr~5}Dy}IN*`ctWKTJ@9KHZ zeNjG|j22`7){SRt{71+!nayeV>|MbJfp-%&_Zu!g8yvLQf@ftyCZ@yN=#5C^eh?M% zP-{zzrIC?Q^obJ|MMMvMefOr03aIj6frHSdK;o$M+B^md7L_@`Q}*4oyVCzs3Vx_1i_mYV75?Oilb&+)mr*DjLFJ3ycK zhCqmYM4Q=Cpm-tNIGy6o3j4UAM-;+dntyWvuJ9f#wgckN&F+EM1;_EB z-kx46Nj8Gciu6Y4WR;x)~PUj$AUv(3RN5*ilfJ#P+wcMwf260uIm&gP$El%iAr zPVpJfaU5oXp&sVP`#xEob(6s9&;M3HpOiC>zCY~sSGoG?oytn#x*4kL6zz3v3ndnIpZta0x5`oy=?qn#6zlj&e%VSKXQ9?u(4 z+^eY(R*b7uq_IEm_a7U7f&tG_c!a1&F&6sx{a{lV{HxY9l5pnuKDW>x#k>DKQ@6i_ p|9j36h^49-i}(AoiKbcHy6-WOy~{PZ6q+0&JoX)QyG1yB{vR?NELQ*k literal 19106 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 diff --git a/_b_t_d_8h_source.html b/_b_t_d_8h_source.html index d4605bdf..290b5a5e 100644 --- a/_b_t_d_8h_source.html +++ b/_b_t_d_8h_source.html @@ -63,7 +63,7 @@ $(function() {
BTD.h
-Go to the documentation of this file.
1 /* Copyright (C) 2012 Kristian Lauszus, TKJ Electronics. All rights reserved.
2 
3  This software may be distributed and modified under the terms of the GNU
4  General Public License version 2 (GPL2) as published by the Free Software
5  Foundation and appearing in the file GPL2.TXT included in the packaging of
6  this file. Please note that GPL2 Section 2[b] requires that all works based
7  on this software must also be made publicly available under the terms of
8  the GPL2 ("Copyleft").
9 
10  Contact information
11  -------------------
12 
13  Kristian Lauszus, TKJ Electronics
14  Web : http://www.tkjelectronics.com
15  e-mail : kristianl@tkjelectronics.com
16  */
17 
18 #ifndef _btd_h_
19 #define _btd_h_
20 
21 #include "Usb.h"
22 #include "usbhid.h"
23 
24 //PID and VID of the Sony PS3 devices
25 #define PS3_VID 0x054C // Sony Corporation
26 #define PS3_PID 0x0268 // PS3 Controller DualShock 3
27 #define PS3NAVIGATION_PID 0x042F // Navigation controller
28 #define PS3MOVE_PID 0x03D5 // Motion controller
29 
30 // These dongles do not present themselves correctly, so we have to check for them manually
31 #define IOGEAR_GBU521_VID 0x0A5C
32 #define IOGEAR_GBU521_PID 0x21E8
33 #define BELKIN_F8T065BF_VID 0x050D
34 #define BELKIN_F8T065BF_PID 0x065A
35 
36 /* Bluetooth dongle data taken from descriptors */
37 #define BULK_MAXPKTSIZE 64 // Max size for ACL data
38 
39 // Used in control endpoint header for HCI Commands
40 #define bmREQ_HCI_OUT USB_SETUP_HOST_TO_DEVICE|USB_SETUP_TYPE_CLASS|USB_SETUP_RECIPIENT_DEVICE
41 
42 /* Bluetooth HCI states for hci_task() */
43 #define HCI_INIT_STATE 0
44 #define HCI_RESET_STATE 1
45 #define HCI_CLASS_STATE 2
46 #define HCI_BDADDR_STATE 3
47 #define HCI_LOCAL_VERSION_STATE 4
48 #define HCI_WRITE_NAME_STATE 5
49 #define HCI_CHECK_DEVICE_SERVICE 6
50 
51 #define HCI_INQUIRY_STATE 7 // These three states are only used if it should pair and connect to a device
52 #define HCI_CONNECT_DEVICE_STATE 8
53 #define HCI_CONNECTED_DEVICE_STATE 9
54 
55 #define HCI_SCANNING_STATE 10
56 #define HCI_CONNECT_IN_STATE 11
57 #define HCI_REMOTE_NAME_STATE 12
58 #define HCI_CONNECTED_STATE 13
59 #define HCI_DISABLE_SCAN_STATE 14
60 #define HCI_DONE_STATE 15
61 #define HCI_DISCONNECT_STATE 16
62 #define HCI_LOCAL_EXTENDED_FEATURES_STATE 17
63 #define HCI_WRITE_SIMPLE_PAIRING_STATE 18
64 #define HCI_SET_EVENT_MASK_STATE 19
65 
66 /* HCI event flags*/
67 #define HCI_FLAG_CMD_COMPLETE (1UL << 0)
68 #define HCI_FLAG_CONNECT_COMPLETE (1UL << 1)
69 #define HCI_FLAG_DISCONNECT_COMPLETE (1UL << 2)
70 #define HCI_FLAG_REMOTE_NAME_COMPLETE (1UL << 3)
71 #define HCI_FLAG_INCOMING_REQUEST (1UL << 4)
72 #define HCI_FLAG_READ_BDADDR (1UL << 5)
73 #define HCI_FLAG_READ_VERSION (1UL << 6)
74 #define HCI_FLAG_DEVICE_FOUND (1UL << 7)
75 #define HCI_FLAG_CONNECT_EVENT (1UL << 8)
76 #define HCI_FLAG_LOCAL_EXTENDED_FEATURES (1UL << 9)
77 
78 /* Macros for HCI event flag tests */
79 #define hci_check_flag(flag) (hci_event_flag & (flag))
80 #define hci_set_flag(flag) (hci_event_flag |= (flag))
81 #define hci_clear_flag(flag) (hci_event_flag &= ~(flag))
82 
83 /* HCI Events managed */
84 #define EV_INQUIRY_COMPLETE 0x01
85 #define EV_INQUIRY_RESULT 0x02
86 #define EV_CONNECT_COMPLETE 0x03
87 #define EV_INCOMING_CONNECT 0x04
88 #define EV_DISCONNECT_COMPLETE 0x05
89 #define EV_AUTHENTICATION_COMPLETE 0x06
90 #define EV_REMOTE_NAME_COMPLETE 0x07
91 #define EV_ENCRYPTION_CHANGE 0x08
92 #define EV_CHANGE_CONNECTION_LINK 0x09
93 #define EV_READ_REMOTE_VERSION_INFORMATION_COMPLETE 0x0C
94 #define EV_QOS_SETUP_COMPLETE 0x0D
95 #define EV_COMMAND_COMPLETE 0x0E
96 #define EV_COMMAND_STATUS 0x0F
97 #define EV_ROLE_CHANGED 0x12
98 #define EV_NUM_COMPLETE_PKT 0x13
99 #define EV_PIN_CODE_REQUEST 0x16
100 #define EV_LINK_KEY_REQUEST 0x17
101 #define EV_LINK_KEY_NOTIFICATION 0x18
102 #define EV_DATA_BUFFER_OVERFLOW 0x1A
103 #define EV_MAX_SLOTS_CHANGE 0x1B
104 #define EV_LOOPBACK_COMMAND 0x19
105 #define EV_PAGE_SCAN_REP_MODE 0x20
106 #define EV_READ_REMOTE_EXTENDED_FEATURES_COMPLETE 0x23
107 #define EV_IO_CAPABILITY_REQUEST 0x31
108 #define EV_IO_CAPABILITY_RESPONSE 0x32
109 #define EV_USER_CONFIRMATION_REQUEST 0x33
110 #define EV_SIMPLE_PAIRING_COMPLETE 0x36
111 
112 /* Bluetooth states for the different Bluetooth drivers */
113 #define L2CAP_WAIT 0
114 #define L2CAP_DONE 1
115 
116 /* Used for HID Control channel */
117 #define L2CAP_CONTROL_CONNECT_REQUEST 2
118 #define L2CAP_CONTROL_CONFIG_REQUEST 3
119 #define L2CAP_CONTROL_SUCCESS 4
120 #define L2CAP_CONTROL_DISCONNECT 5
121 
122 /* Used for HID Interrupt channel */
123 #define L2CAP_INTERRUPT_SETUP 6
124 #define L2CAP_INTERRUPT_CONNECT_REQUEST 7
125 #define L2CAP_INTERRUPT_CONFIG_REQUEST 8
126 #define L2CAP_INTERRUPT_DISCONNECT 9
127 
128 /* Used for SDP channel */
129 #define L2CAP_SDP_WAIT 10
130 #define L2CAP_SDP_SUCCESS 11
131 
132 /* Used for RFCOMM channel */
133 #define L2CAP_RFCOMM_WAIT 12
134 #define L2CAP_RFCOMM_SUCCESS 13
135 
136 #define L2CAP_DISCONNECT_RESPONSE 14 // Used for both SDP and RFCOMM channel
137 
138 /* Bluetooth states used by some drivers */
139 #define TURN_ON_LED 17
140 #define PS3_ENABLE_SIXAXIS 18
141 #define WII_CHECK_MOTION_PLUS_STATE 19
142 #define WII_CHECK_EXTENSION_STATE 20
143 #define WII_INIT_MOTION_PLUS_STATE 21
144 
145 /* L2CAP event flags for HID Control channel */
146 #define L2CAP_FLAG_CONNECTION_CONTROL_REQUEST (1UL << 0)
147 #define L2CAP_FLAG_CONFIG_CONTROL_SUCCESS (1UL << 1)
148 #define L2CAP_FLAG_CONTROL_CONNECTED (1UL << 2)
149 #define L2CAP_FLAG_DISCONNECT_CONTROL_RESPONSE (1UL << 3)
150 
151 /* L2CAP event flags for HID Interrupt channel */
152 #define L2CAP_FLAG_CONNECTION_INTERRUPT_REQUEST (1UL << 4)
153 #define L2CAP_FLAG_CONFIG_INTERRUPT_SUCCESS (1UL << 5)
154 #define L2CAP_FLAG_INTERRUPT_CONNECTED (1UL << 6)
155 #define L2CAP_FLAG_DISCONNECT_INTERRUPT_RESPONSE (1UL << 7)
156 
157 /* L2CAP event flags for SDP channel */
158 #define L2CAP_FLAG_CONNECTION_SDP_REQUEST (1UL << 8)
159 #define L2CAP_FLAG_CONFIG_SDP_SUCCESS (1UL << 9)
160 #define L2CAP_FLAG_DISCONNECT_SDP_REQUEST (1UL << 10)
161 
162 /* L2CAP event flags for RFCOMM channel */
163 #define L2CAP_FLAG_CONNECTION_RFCOMM_REQUEST (1UL << 11)
164 #define L2CAP_FLAG_CONFIG_RFCOMM_SUCCESS (1UL << 12)
165 #define L2CAP_FLAG_DISCONNECT_RFCOMM_REQUEST (1UL << 13)
166 
167 #define L2CAP_FLAG_DISCONNECT_RESPONSE (1UL << 14)
168 
169 /* Macros for L2CAP event flag tests */
170 #define l2cap_check_flag(flag) (l2cap_event_flag & (flag))
171 #define l2cap_set_flag(flag) (l2cap_event_flag |= (flag))
172 #define l2cap_clear_flag(flag) (l2cap_event_flag &= ~(flag))
173 
174 /* L2CAP signaling commands */
175 #define L2CAP_CMD_COMMAND_REJECT 0x01
176 #define L2CAP_CMD_CONNECTION_REQUEST 0x02
177 #define L2CAP_CMD_CONNECTION_RESPONSE 0x03
178 #define L2CAP_CMD_CONFIG_REQUEST 0x04
179 #define L2CAP_CMD_CONFIG_RESPONSE 0x05
180 #define L2CAP_CMD_DISCONNECT_REQUEST 0x06
181 #define L2CAP_CMD_DISCONNECT_RESPONSE 0x07
182 #define L2CAP_CMD_INFORMATION_REQUEST 0x0A
183 #define L2CAP_CMD_INFORMATION_RESPONSE 0x0B
184 
185 // Used For Connection Response - Remember to Include High Byte
186 #define PENDING 0x01
187 #define SUCCESSFUL 0x00
188 
189 /* Bluetooth L2CAP PSM - see http://www.bluetooth.org/Technical/AssignedNumbers/logical_link.htm */
190 #define SDP_PSM 0x01 // Service Discovery Protocol PSM Value
191 #define RFCOMM_PSM 0x03 // RFCOMM PSM Value
192 #define HID_CTRL_PSM 0x11 // HID_Control PSM Value
193 #define HID_INTR_PSM 0x13 // HID_Interrupt PSM Value
194 
195 /* Used for SDP */
196 #define SDP_SERVICE_SEARCH_REQUEST 0x02
197 #define SDP_SERVICE_SEARCH_RESPONSE 0x03
198 #define SDP_SERVICE_ATTRIBUTE_REQUEST 0x04
199 #define SDP_SERVICE_ATTRIBUTE_RESPONSE 0x05
200 #define SDP_SERVICE_SEARCH_ATTRIBUTE_REQUEST 0x06 // See the RFCOMM specs
201 #define SDP_SERVICE_SEARCH_ATTRIBUTE_RESPONSE 0x07 // See the RFCOMM specs
202 #define PNP_INFORMATION_UUID 0x1200
203 #define SERIALPORT_UUID 0x1101 // See http://www.bluetooth.org/Technical/AssignedNumbers/service_discovery.htm
204 #define L2CAP_UUID 0x0100
205 
206 // Used to determine if it is a Bluetooth dongle
207 #define WI_SUBCLASS_RF 0x01 // RF Controller
208 #define WI_PROTOCOL_BT 0x01 // Bluetooth Programming Interface
209 
210 #define BTD_MAX_ENDPOINTS 4
211 #define BTD_NUM_SERVICES 4 // Max number of Bluetooth services - if you need more than 4 simply increase this number
212 
213 #define PAIR 1
214 
215 class BluetoothService;
216 
221 class BTD : public USBDeviceConfig, public UsbConfigXtracter {
222 public:
227  BTD(USB *p);
228 
237  uint8_t ConfigureDevice(uint8_t parent, uint8_t port, bool lowspeed);
245  uint8_t Init(uint8_t parent, uint8_t port, bool lowspeed);
250  uint8_t Release();
255  uint8_t Poll();
256 
261  virtual uint8_t GetAddress() {
262  return bAddress;
263  };
264 
269  virtual bool isReady() {
270  return bPollEnable;
271  };
272 
278  virtual bool DEVCLASSOK(uint8_t klass) {
279  return (klass == USB_CLASS_WIRELESS_CTRL);
280  };
281 
289  virtual bool VIDPIDOK(uint16_t vid, uint16_t pid) {
290  if((vid == IOGEAR_GBU521_VID && pid == IOGEAR_GBU521_PID) || (vid == BELKIN_F8T065BF_VID && pid == BELKIN_F8T065BF_PID))
291  return true;
292  if(my_bdaddr[0] != 0x00 || my_bdaddr[1] != 0x00 || my_bdaddr[2] != 0x00 || my_bdaddr[3] != 0x00 || my_bdaddr[4] != 0x00 || my_bdaddr[5] != 0x00) { // Check if Bluetooth address is set
293  if(vid == PS3_VID && (pid == PS3_PID || pid == PS3NAVIGATION_PID || pid == PS3MOVE_PID))
294  return true;
295  }
296  return false;
297  };
309  void EndpointXtract(uint8_t conf, uint8_t iface, uint8_t alt, uint8_t proto, const USB_ENDPOINT_DESCRIPTOR *ep);
313  void disconnect();
314 
320  int8_t registerBluetoothService(BluetoothService *pService) {
321  for(uint8_t i = 0; i < BTD_NUM_SERVICES; i++) {
322  if(!btService[i]) {
323  btService[i] = pService;
324  return i; // Return ID
325  }
326  }
327  return -1; // Error registering BluetoothService
328  };
329 
336  void HCI_Command(uint8_t* data, uint16_t nbytes);
338  void hci_reset();
340  void hci_read_bdaddr();
342  void hci_read_local_version_information();
344  void hci_read_local_extended_features(uint8_t page_number);
349  void hci_write_local_name(const char* name);
351  void hci_write_simple_pairing_mode(bool enable);
353  void hci_set_event_mask();
355  void hci_write_scan_enable();
357  void hci_write_scan_disable();
359  void hci_remote_name();
361  void hci_accept_connection();
366  void hci_disconnect(uint16_t handle);
372  void hci_pin_code_request_reply();
374  void hci_pin_code_negative_request_reply();
379  void hci_link_key_request_negative_reply();
381  void hci_user_confirmation_request_reply();
383  void hci_authentication_request();
385  void hci_inquiry();
387  void hci_inquiry_cancel();
389  void hci_connect();
391  void hci_io_capability_request_reply();
396  void hci_connect(uint8_t *bdaddr);
398  void hci_write_class_of_device();
410  void L2CAP_Command(uint16_t handle, uint8_t* data, uint8_t nbytes, uint8_t channelLow = 0x01, uint8_t channelHigh = 0x00);
418  void l2cap_connection_request(uint16_t handle, uint8_t rxid, uint8_t* scid, uint16_t psm);
427  void l2cap_connection_response(uint16_t handle, uint8_t rxid, uint8_t* dcid, uint8_t* scid, uint8_t result);
434  void l2cap_config_request(uint16_t handle, uint8_t rxid, uint8_t* dcid);
441  void l2cap_config_response(uint16_t handle, uint8_t rxid, uint8_t* scid);
449  void l2cap_disconnection_request(uint16_t handle, uint8_t rxid, uint8_t* dcid, uint8_t* scid);
457  void l2cap_disconnection_response(uint16_t handle, uint8_t rxid, uint8_t* dcid, uint8_t* scid);
464  void l2cap_information_response(uint16_t handle, uint8_t rxid, uint8_t infoTypeLow, uint8_t infoTypeHigh);
468  bool waitingForConnection;
470  bool l2capConnectionClaimed;
472  bool sdpConnectionClaimed;
474  bool rfcommConnectionClaimed;
475 
477  const char* btdName;
479  const char* btdPin;
480 
482  uint8_t my_bdaddr[6];
484  uint16_t hci_handle;
486  uint8_t disc_bdaddr[6];
488  char remote_name[30];
494  uint8_t hci_version;
495 
497  void pairWithWiimote() {
498  pairWithWii = true;
499  hci_state = HCI_CHECK_DEVICE_SERVICE;
500  };
502  bool connectToWii;
504  bool incomingWii;
506  bool pairWithWii;
508  bool motionPlusInside;
510  bool wiiUProController;
511 
513  void pairWithHID() {
514  waitingForConnection = false;
515  pairWithHIDDevice = true;
516  hci_state = HCI_CHECK_DEVICE_SERVICE;
517  };
519  bool connectToHIDDevice;
521  bool incomingHIDDevice;
523  bool pairWithHIDDevice;
524 
529  uint8_t readPollInterval() {
530  return pollInterval;
531  };
532 
534  bool useSimplePairing;
535 
536 protected:
538  USB *pUsb;
540  uint8_t bAddress;
542  EpInfo epInfo[BTD_MAX_ENDPOINTS];
543 
545  uint8_t bConfNum;
547  uint8_t bNumEP;
549  uint32_t qNextPollTime;
550 
552  static const uint8_t BTD_CONTROL_PIPE;
554  static const uint8_t BTD_EVENT_PIPE;
556  static const uint8_t BTD_DATAIN_PIPE;
558  static const uint8_t BTD_DATAOUT_PIPE;
559 
564  void PrintEndpointDescriptor(const USB_ENDPOINT_DESCRIPTOR* ep_ptr);
565 
566 private:
567  void Initialize(); // Set all variables, endpoint structs etc. to default values
568  BluetoothService *btService[BTD_NUM_SERVICES];
569 
570  uint16_t PID, VID; // PID and VID of device connected
571 
572  uint8_t pollInterval;
573  bool simple_pairing_supported;
574  bool bPollEnable;
575 
576  bool pairWiiUsingSync; // True if pairing was done using the Wii SYNC button.
577  bool checkRemoteName; // Used to check remote device's name before connecting.
578  bool incomingPS4; // True if a PS4 controller is connecting
579  uint8_t classOfDevice[3]; // Class of device of last device
580 
581  /* Variables used by high level HCI task */
582  uint8_t hci_state; // Current state of Bluetooth HCI connection
583  uint16_t hci_counter; // Counter used for Bluetooth HCI reset loops
584  uint16_t hci_num_reset_loops; // This value indicate how many times it should read before trying to reset
585  uint16_t hci_event_flag; // HCI flags of received Bluetooth events
586  uint8_t inquiry_counter;
587 
588  uint8_t hcibuf[BULK_MAXPKTSIZE]; // General purpose buffer for HCI data
589  uint8_t l2capinbuf[BULK_MAXPKTSIZE]; // General purpose buffer for L2CAP in data
590  uint8_t l2capoutbuf[14]; // General purpose buffer for L2CAP out data
591 
592  /* State machines */
593  void HCI_event_task(); // Poll the HCI event pipe
594  void HCI_task(); // HCI state machine
595  void ACL_event_task(); // ACL input pipe
596 
597  /* Used to set the Bluetooth Address internally to the PS3 Controllers */
598  void setBdaddr(uint8_t* BDADDR);
599  void setMoveBdaddr(uint8_t* BDADDR);
600 };
601 
603 class BluetoothService {
604 public:
605  BluetoothService(BTD *p) : pBtd(p) {
606  if(pBtd)
607  pBtd->registerBluetoothService(this); // Register it as a Bluetooth service
608  };
613  virtual void ACLData(uint8_t* ACLData) = 0;
615  virtual void Run() = 0;
617  virtual void Reset() = 0;
619  virtual void disconnect() = 0;
620 
625  void attachOnInit(void (*funcOnInit)(void)) {
626  pFuncOnInit = funcOnInit; // TODO: This really belong in a class of it's own as it is repeated several times
627  };
628 
629 protected:
635  virtual void onInit() = 0;
636 
638  bool checkHciHandle(uint8_t *buf, uint16_t handle) {
639  return (buf[0] == (handle & 0xFF)) && (buf[1] == ((handle >> 8) | 0x20));
640  }
641 
643  void (*pFuncOnInit)(void);
644 
646  BTD *pBtd;
647 
649  uint16_t hci_handle;
650 
652  uint32_t l2cap_event_flag;
653 
655  uint8_t identifier;
656 };
657 
658 #endif
BTD::BTD_DATAOUT_PIPE
static const uint8_t BTD_DATAOUT_PIPE
Definition: BTD.h:558
+Go to the documentation of this file.
1 /* Copyright (C) 2012 Kristian Lauszus, TKJ Electronics. All rights reserved.
2 
3  This software may be distributed and modified under the terms of the GNU
4  General Public License version 2 (GPL2) as published by the Free Software
5  Foundation and appearing in the file GPL2.TXT included in the packaging of
6  this file. Please note that GPL2 Section 2[b] requires that all works based
7  on this software must also be made publicly available under the terms of
8  the GPL2 ("Copyleft").
9 
10  Contact information
11  -------------------
12 
13  Kristian Lauszus, TKJ Electronics
14  Web : http://www.tkjelectronics.com
15  e-mail : kristianl@tkjelectronics.com
16  */
17 
18 #ifndef _btd_h_
19 #define _btd_h_
20 
21 #include "Usb.h"
22 #include "usbhid.h"
23 
24 //PID and VID of the Sony PS3 devices
25 #define PS3_VID 0x054C // Sony Corporation
26 #define PS3_PID 0x0268 // PS3 Controller DualShock 3
27 #define PS3NAVIGATION_PID 0x042F // Navigation controller
28 #define PS3MOVE_PID 0x03D5 // Motion controller
29 
30 // These dongles do not present themselves correctly, so we have to check for them manually
31 #define IOGEAR_GBU521_VID 0x0A5C
32 #define IOGEAR_GBU521_PID 0x21E8
33 #define BELKIN_F8T065BF_VID 0x050D
34 #define BELKIN_F8T065BF_PID 0x065A
35 
36 /* Bluetooth dongle data taken from descriptors */
37 #define BULK_MAXPKTSIZE 64 // Max size for ACL data
38 
39 // Used in control endpoint header for HCI Commands
40 #define bmREQ_HCI_OUT USB_SETUP_HOST_TO_DEVICE|USB_SETUP_TYPE_CLASS|USB_SETUP_RECIPIENT_DEVICE
41 
42 /* Bluetooth HCI states for hci_task() */
43 #define HCI_INIT_STATE 0
44 #define HCI_RESET_STATE 1
45 #define HCI_CLASS_STATE 2
46 #define HCI_BDADDR_STATE 3
47 #define HCI_LOCAL_VERSION_STATE 4
48 #define HCI_WRITE_NAME_STATE 5
49 #define HCI_CHECK_DEVICE_SERVICE 6
50 
51 #define HCI_INQUIRY_STATE 7 // These three states are only used if it should pair and connect to a device
52 #define HCI_CONNECT_DEVICE_STATE 8
53 #define HCI_CONNECTED_DEVICE_STATE 9
54 
55 #define HCI_SCANNING_STATE 10
56 #define HCI_CONNECT_IN_STATE 11
57 #define HCI_REMOTE_NAME_STATE 12
58 #define HCI_CONNECTED_STATE 13
59 #define HCI_DISABLE_SCAN_STATE 14
60 #define HCI_DONE_STATE 15
61 #define HCI_DISCONNECT_STATE 16
62 #define HCI_LOCAL_EXTENDED_FEATURES_STATE 17
63 #define HCI_WRITE_SIMPLE_PAIRING_STATE 18
64 #define HCI_SET_EVENT_MASK_STATE 19
65 
66 /* HCI event flags*/
67 #define HCI_FLAG_CMD_COMPLETE (1UL << 0)
68 #define HCI_FLAG_CONNECT_COMPLETE (1UL << 1)
69 #define HCI_FLAG_DISCONNECT_COMPLETE (1UL << 2)
70 #define HCI_FLAG_REMOTE_NAME_COMPLETE (1UL << 3)
71 #define HCI_FLAG_INCOMING_REQUEST (1UL << 4)
72 #define HCI_FLAG_READ_BDADDR (1UL << 5)
73 #define HCI_FLAG_READ_VERSION (1UL << 6)
74 #define HCI_FLAG_DEVICE_FOUND (1UL << 7)
75 #define HCI_FLAG_CONNECT_EVENT (1UL << 8)
76 #define HCI_FLAG_LOCAL_EXTENDED_FEATURES (1UL << 9)
77 
78 /* Macros for HCI event flag tests */
79 #define hci_check_flag(flag) (hci_event_flag & (flag))
80 #define hci_set_flag(flag) (hci_event_flag |= (flag))
81 #define hci_clear_flag(flag) (hci_event_flag &= ~(flag))
82 
83 /* HCI Events managed */
84 #define EV_INQUIRY_COMPLETE 0x01
85 #define EV_INQUIRY_RESULT 0x02
86 #define EV_CONNECT_COMPLETE 0x03
87 #define EV_INCOMING_CONNECT 0x04
88 #define EV_DISCONNECT_COMPLETE 0x05
89 #define EV_AUTHENTICATION_COMPLETE 0x06
90 #define EV_REMOTE_NAME_COMPLETE 0x07
91 #define EV_ENCRYPTION_CHANGE 0x08
92 #define EV_CHANGE_CONNECTION_LINK 0x09
93 #define EV_READ_REMOTE_VERSION_INFORMATION_COMPLETE 0x0C
94 #define EV_QOS_SETUP_COMPLETE 0x0D
95 #define EV_COMMAND_COMPLETE 0x0E
96 #define EV_COMMAND_STATUS 0x0F
97 #define EV_ROLE_CHANGED 0x12
98 #define EV_NUM_COMPLETE_PKT 0x13
99 #define EV_PIN_CODE_REQUEST 0x16
100 #define EV_LINK_KEY_REQUEST 0x17
101 #define EV_LINK_KEY_NOTIFICATION 0x18
102 #define EV_DATA_BUFFER_OVERFLOW 0x1A
103 #define EV_MAX_SLOTS_CHANGE 0x1B
104 #define EV_LOOPBACK_COMMAND 0x19
105 #define EV_PAGE_SCAN_REP_MODE 0x20
106 #define EV_READ_REMOTE_EXTENDED_FEATURES_COMPLETE 0x23
107 #define EV_IO_CAPABILITY_REQUEST 0x31
108 #define EV_IO_CAPABILITY_RESPONSE 0x32
109 #define EV_USER_CONFIRMATION_REQUEST 0x33
110 #define EV_SIMPLE_PAIRING_COMPLETE 0x36
111 
112 /* Bluetooth states for the different Bluetooth drivers */
113 #define L2CAP_WAIT 0
114 #define L2CAP_DONE 1
115 
116 /* Used for HID Control channel */
117 #define L2CAP_CONTROL_CONNECT_REQUEST 2
118 #define L2CAP_CONTROL_CONFIG_REQUEST 3
119 #define L2CAP_CONTROL_SUCCESS 4
120 #define L2CAP_CONTROL_DISCONNECT 5
121 
122 /* Used for HID Interrupt channel */
123 #define L2CAP_INTERRUPT_SETUP 6
124 #define L2CAP_INTERRUPT_CONNECT_REQUEST 7
125 #define L2CAP_INTERRUPT_CONFIG_REQUEST 8
126 #define L2CAP_INTERRUPT_DISCONNECT 9
127 
128 /* Used for SDP channel */
129 #define L2CAP_SDP_WAIT 10
130 #define L2CAP_SDP_SUCCESS 11
131 
132 /* Used for RFCOMM channel */
133 #define L2CAP_RFCOMM_WAIT 12
134 #define L2CAP_RFCOMM_SUCCESS 13
135 
136 #define L2CAP_DISCONNECT_RESPONSE 14 // Used for both SDP and RFCOMM channel
137 
138 /* Bluetooth states used by some drivers */
139 #define TURN_ON_LED 17
140 #define PS3_ENABLE_SIXAXIS 18
141 #define WII_CHECK_MOTION_PLUS_STATE 19
142 #define WII_CHECK_EXTENSION_STATE 20
143 #define WII_INIT_MOTION_PLUS_STATE 21
144 
145 /* L2CAP event flags for HID Control channel */
146 #define L2CAP_FLAG_CONNECTION_CONTROL_REQUEST (1UL << 0)
147 #define L2CAP_FLAG_CONFIG_CONTROL_SUCCESS (1UL << 1)
148 #define L2CAP_FLAG_CONTROL_CONNECTED (1UL << 2)
149 #define L2CAP_FLAG_DISCONNECT_CONTROL_RESPONSE (1UL << 3)
150 
151 /* L2CAP event flags for HID Interrupt channel */
152 #define L2CAP_FLAG_CONNECTION_INTERRUPT_REQUEST (1UL << 4)
153 #define L2CAP_FLAG_CONFIG_INTERRUPT_SUCCESS (1UL << 5)
154 #define L2CAP_FLAG_INTERRUPT_CONNECTED (1UL << 6)
155 #define L2CAP_FLAG_DISCONNECT_INTERRUPT_RESPONSE (1UL << 7)
156 
157 /* L2CAP event flags for SDP channel */
158 #define L2CAP_FLAG_CONNECTION_SDP_REQUEST (1UL << 8)
159 #define L2CAP_FLAG_CONFIG_SDP_SUCCESS (1UL << 9)
160 #define L2CAP_FLAG_DISCONNECT_SDP_REQUEST (1UL << 10)
161 
162 /* L2CAP event flags for RFCOMM channel */
163 #define L2CAP_FLAG_CONNECTION_RFCOMM_REQUEST (1UL << 11)
164 #define L2CAP_FLAG_CONFIG_RFCOMM_SUCCESS (1UL << 12)
165 #define L2CAP_FLAG_DISCONNECT_RFCOMM_REQUEST (1UL << 13)
166 
167 #define L2CAP_FLAG_DISCONNECT_RESPONSE (1UL << 14)
168 
169 /* Macros for L2CAP event flag tests */
170 #define l2cap_check_flag(flag) (l2cap_event_flag & (flag))
171 #define l2cap_set_flag(flag) (l2cap_event_flag |= (flag))
172 #define l2cap_clear_flag(flag) (l2cap_event_flag &= ~(flag))
173 
174 /* L2CAP signaling commands */
175 #define L2CAP_CMD_COMMAND_REJECT 0x01
176 #define L2CAP_CMD_CONNECTION_REQUEST 0x02
177 #define L2CAP_CMD_CONNECTION_RESPONSE 0x03
178 #define L2CAP_CMD_CONFIG_REQUEST 0x04
179 #define L2CAP_CMD_CONFIG_RESPONSE 0x05
180 #define L2CAP_CMD_DISCONNECT_REQUEST 0x06
181 #define L2CAP_CMD_DISCONNECT_RESPONSE 0x07
182 #define L2CAP_CMD_INFORMATION_REQUEST 0x0A
183 #define L2CAP_CMD_INFORMATION_RESPONSE 0x0B
184 
185 // Used For Connection Response - Remember to Include High Byte
186 #define PENDING 0x01
187 #define SUCCESSFUL 0x00
188 
189 /* Bluetooth L2CAP PSM - see http://www.bluetooth.org/Technical/AssignedNumbers/logical_link.htm */
190 #define SDP_PSM 0x01 // Service Discovery Protocol PSM Value
191 #define RFCOMM_PSM 0x03 // RFCOMM PSM Value
192 #define HID_CTRL_PSM 0x11 // HID_Control PSM Value
193 #define HID_INTR_PSM 0x13 // HID_Interrupt PSM Value
194 
195 /* Used for SDP */
196 #define SDP_SERVICE_SEARCH_REQUEST 0x02
197 #define SDP_SERVICE_SEARCH_RESPONSE 0x03
198 #define SDP_SERVICE_ATTRIBUTE_REQUEST 0x04
199 #define SDP_SERVICE_ATTRIBUTE_RESPONSE 0x05
200 #define SDP_SERVICE_SEARCH_ATTRIBUTE_REQUEST 0x06 // See the RFCOMM specs
201 #define SDP_SERVICE_SEARCH_ATTRIBUTE_RESPONSE 0x07 // See the RFCOMM specs
202 #define PNP_INFORMATION_UUID 0x1200
203 #define SERIALPORT_UUID 0x1101 // See http://www.bluetooth.org/Technical/AssignedNumbers/service_discovery.htm
204 #define L2CAP_UUID 0x0100
205 
206 // Used to determine if it is a Bluetooth dongle
207 #define WI_SUBCLASS_RF 0x01 // RF Controller
208 #define WI_PROTOCOL_BT 0x01 // Bluetooth Programming Interface
209 
210 #define BTD_MAX_ENDPOINTS 4
211 #define BTD_NUM_SERVICES 4 // Max number of Bluetooth services - if you need more than 4 simply increase this number
212 
213 #define PAIR 1
214 
215 class BluetoothService;
216 
221 class BTD : public USBDeviceConfig, public UsbConfigXtracter {
222 public:
227  BTD(USB *p);
228 
237  uint8_t ConfigureDevice(uint8_t parent, uint8_t port, bool lowspeed);
245  uint8_t Init(uint8_t parent, uint8_t port, bool lowspeed);
250  uint8_t Release();
255  uint8_t Poll();
256 
261  virtual uint8_t GetAddress() {
262  return bAddress;
263  };
264 
269  virtual bool isReady() {
270  return bPollEnable;
271  };
272 
278  virtual bool DEVCLASSOK(uint8_t klass) {
279  return (klass == USB_CLASS_WIRELESS_CTRL);
280  };
281 
289  virtual bool VIDPIDOK(uint16_t vid, uint16_t pid) {
290  if((vid == IOGEAR_GBU521_VID && pid == IOGEAR_GBU521_PID) || (vid == BELKIN_F8T065BF_VID && pid == BELKIN_F8T065BF_PID))
291  return true;
292  if(my_bdaddr[0] != 0x00 || my_bdaddr[1] != 0x00 || my_bdaddr[2] != 0x00 || my_bdaddr[3] != 0x00 || my_bdaddr[4] != 0x00 || my_bdaddr[5] != 0x00) { // Check if Bluetooth address is set
293  if(vid == PS3_VID && (pid == PS3_PID || pid == PS3NAVIGATION_PID || pid == PS3MOVE_PID))
294  return true;
295  }
296  return false;
297  };
309  void EndpointXtract(uint8_t conf, uint8_t iface, uint8_t alt, uint8_t proto, const USB_ENDPOINT_DESCRIPTOR *ep);
313  void disconnect();
314 
320  int8_t registerBluetoothService(BluetoothService *pService) {
321  for(uint8_t i = 0; i < BTD_NUM_SERVICES; i++) {
322  if(!btService[i]) {
323  btService[i] = pService;
324  return i; // Return ID
325  }
326  }
327  return -1; // Error registering BluetoothService
328  };
329 
336  void HCI_Command(uint8_t* data, uint16_t nbytes);
338  void hci_reset();
340  void hci_read_bdaddr();
342  void hci_read_local_version_information();
344  void hci_read_local_extended_features(uint8_t page_number);
349  void hci_write_local_name(const char* name);
351  void hci_write_simple_pairing_mode(bool enable);
353  void hci_set_event_mask();
355  void hci_write_scan_enable();
357  void hci_write_scan_disable();
359  void hci_remote_name();
361  void hci_accept_connection();
366  void hci_disconnect(uint16_t handle);
372  void hci_pin_code_request_reply();
374  void hci_pin_code_negative_request_reply();
379  void hci_link_key_request_negative_reply();
381  void hci_user_confirmation_request_reply();
383  void hci_authentication_request();
385  void hci_inquiry();
387  void hci_inquiry_cancel();
389  void hci_connect();
391  void hci_io_capability_request_reply();
396  void hci_connect(uint8_t *bdaddr);
398  void hci_write_class_of_device();
410  void L2CAP_Command(uint16_t handle, uint8_t* data, uint8_t nbytes, uint8_t channelLow = 0x01, uint8_t channelHigh = 0x00);
418  void l2cap_connection_request(uint16_t handle, uint8_t rxid, uint8_t* scid, uint16_t psm);
427  void l2cap_connection_response(uint16_t handle, uint8_t rxid, uint8_t* dcid, uint8_t* scid, uint8_t result);
434  void l2cap_config_request(uint16_t handle, uint8_t rxid, uint8_t* dcid);
441  void l2cap_config_response(uint16_t handle, uint8_t rxid, uint8_t* scid);
449  void l2cap_disconnection_request(uint16_t handle, uint8_t rxid, uint8_t* dcid, uint8_t* scid);
457  void l2cap_disconnection_response(uint16_t handle, uint8_t rxid, uint8_t* dcid, uint8_t* scid);
464  void l2cap_information_response(uint16_t handle, uint8_t rxid, uint8_t infoTypeLow, uint8_t infoTypeHigh);
468  bool waitingForConnection;
470  bool l2capConnectionClaimed;
472  bool sdpConnectionClaimed;
474  bool rfcommConnectionClaimed;
475 
477  const char* btdName;
479  const char* btdPin;
480 
482  uint8_t my_bdaddr[6];
484  uint16_t hci_handle;
486  uint8_t disc_bdaddr[6];
488  char remote_name[30];
494  uint8_t hci_version;
495 
497  void pairWithWiimote() {
498  pairWithWii = true;
499  hci_state = HCI_CHECK_DEVICE_SERVICE;
500  };
502  bool connectToWii;
504  bool incomingWii;
506  bool pairWithWii;
508  bool motionPlusInside;
510  bool wiiUProController;
511 
513  void pairWithHID() {
514  waitingForConnection = false;
515  pairWithHIDDevice = true;
516  hci_state = HCI_CHECK_DEVICE_SERVICE;
517  };
519  bool connectToHIDDevice;
521  bool incomingHIDDevice;
523  bool pairWithHIDDevice;
524 
529  uint8_t readPollInterval() {
530  return pollInterval;
531  };
532 
534  bool useSimplePairing;
535 
536 protected:
538  USB *pUsb;
540  uint8_t bAddress;
542  EpInfo epInfo[BTD_MAX_ENDPOINTS];
543 
545  uint8_t bConfNum;
547  uint8_t bNumEP;
549  uint32_t qNextPollTime;
550 
552  static const uint8_t BTD_CONTROL_PIPE;
554  static const uint8_t BTD_EVENT_PIPE;
556  static const uint8_t BTD_DATAIN_PIPE;
558  static const uint8_t BTD_DATAOUT_PIPE;
559 
564  void PrintEndpointDescriptor(const USB_ENDPOINT_DESCRIPTOR* ep_ptr);
565 
566 private:
567  void Initialize(); // Set all variables, endpoint structs etc. to default values
568  BluetoothService *btService[BTD_NUM_SERVICES];
569 
570  uint16_t PID, VID; // PID and VID of device connected
571 
572  uint8_t pollInterval;
573  bool simple_pairing_supported;
574  bool bPollEnable;
575 
576  bool pairWiiUsingSync; // True if pairing was done using the Wii SYNC button.
577  bool checkRemoteName; // Used to check remote device's name before connecting.
578  bool incomingPSController; // True if a PS4/PS5 controller is connecting
579  uint8_t classOfDevice[3]; // Class of device of last device
580 
581  /* Variables used by high level HCI task */
582  uint8_t hci_state; // Current state of Bluetooth HCI connection
583  uint16_t hci_counter; // Counter used for Bluetooth HCI reset loops
584  uint16_t hci_num_reset_loops; // This value indicate how many times it should read before trying to reset
585  uint16_t hci_event_flag; // HCI flags of received Bluetooth events
586  uint8_t inquiry_counter;
587 
588  uint8_t hcibuf[BULK_MAXPKTSIZE]; // General purpose buffer for HCI data
589  uint8_t l2capinbuf[BULK_MAXPKTSIZE]; // General purpose buffer for L2CAP in data
590  uint8_t l2capoutbuf[14]; // General purpose buffer for L2CAP out data
591 
592  /* State machines */
593  void HCI_event_task(); // Poll the HCI event pipe
594  void HCI_task(); // HCI state machine
595  void ACL_event_task(); // ACL input pipe
596 
597  /* Used to set the Bluetooth Address internally to the PS3 Controllers */
598  void setBdaddr(uint8_t* BDADDR);
599  void setMoveBdaddr(uint8_t* BDADDR);
600 };
601 
603 class BluetoothService {
604 public:
605  BluetoothService(BTD *p) : pBtd(p) {
606  if(pBtd)
607  pBtd->registerBluetoothService(this); // Register it as a Bluetooth service
608  };
613  virtual void ACLData(uint8_t* ACLData) = 0;
615  virtual void Run() = 0;
617  virtual void Reset() = 0;
619  virtual void disconnect() = 0;
620 
625  void attachOnInit(void (*funcOnInit)(void)) {
626  pFuncOnInit = funcOnInit; // TODO: This really belong in a class of it's own as it is repeated several times
627  };
628 
629 protected:
635  virtual void onInit() = 0;
636 
638  bool checkHciHandle(uint8_t *buf, uint16_t handle) {
639  return (buf[0] == (handle & 0xFF)) && (buf[1] == ((handle >> 8) | 0x20));
640  }
641 
643  void (*pFuncOnInit)(void);
644 
646  BTD *pBtd;
647 
649  uint16_t hci_handle;
650 
652  uint32_t l2cap_event_flag;
653 
655  uint8_t identifier;
656 };
657 
658 #endif
BTD::BTD_DATAOUT_PIPE
static const uint8_t BTD_DATAOUT_PIPE
Definition: BTD.h:558
BTD::incomingWii
bool incomingWii
Definition: BTD.h:504
BTD::useSimplePairing
bool useSimplePairing
Definition: BTD.h:531
BTD::hci_connect
void hci_connect()
Definition: BTD.cpp:1268
diff --git a/_b_t_h_i_d_8cpp_source.html b/_b_t_h_i_d_8cpp_source.html index f3ffeace..08e7cbc7 100644 --- a/_b_t_h_i_d_8cpp_source.html +++ b/_b_t_h_i_d_8cpp_source.html @@ -63,7 +63,7 @@ $(function() {
BTHID.cpp
-Go to the documentation of this file.
1 /* Copyright (C) 2013 Kristian Lauszus, TKJ Electronics. All rights reserved.
2 
3  This software may be distributed and modified under the terms of the GNU
4  General Public License version 2 (GPL2) as published by the Free Software
5  Foundation and appearing in the file GPL2.TXT included in the packaging of
6  this file. Please note that GPL2 Section 2[b] requires that all works based
7  on this software must also be made publicly available under the terms of
8  the GPL2 ("Copyleft").
9 
10  Contact information
11  -------------------
12 
13  Kristian Lauszus, TKJ Electronics
14  Web : http://www.tkjelectronics.com
15  e-mail : kristianl@tkjelectronics.com
16  */
17 
18 #include "BTHID.h"
19 // To enable serial debugging see "settings.h"
20 //#define EXTRADEBUG // Uncomment to get even more debugging data
21 //#define PRINTREPORT // Uncomment to print the report send by the HID device
22 
23 BTHID::BTHID(BTD *p, bool pair, const char *pin) :
24 BluetoothService(p), // Pointer to USB class instance - mandatory
25 protocolMode(USB_HID_BOOT_PROTOCOL) {
26  for(uint8_t i = 0; i < NUM_PARSERS; i++)
27  pRptParser[i] = NULL;
28 
29  pBtd->pairWithHIDDevice = pair;
30  pBtd->btdPin = pin;
31 
32  /* Set device cid for the control and intterrupt channelse - LSB */
33  sdp_dcid[0] = 0x50; // 0x0050
34  sdp_dcid[1] = 0x00;
35  control_dcid[0] = 0x70; // 0x0070
36  control_dcid[1] = 0x00;
37  interrupt_dcid[0] = 0x71; // 0x0071
38  interrupt_dcid[1] = 0x00;
39 
40  Reset();
41 }
42 
43 void BTHID::Reset() {
44  connected = false;
45  activeConnection = false;
46  SDPConnected = false;
47  l2cap_event_flag = 0; // Reset flags
48  l2cap_sdp_state = L2CAP_SDP_WAIT;
49  l2cap_state = L2CAP_WAIT;
50  ResetBTHID();
51 }
52 
53 void BTHID::disconnect() { // Use this void to disconnect the device
54  if(SDPConnected)
55  pBtd->l2cap_disconnection_request(hci_handle, ++identifier, sdp_scid, sdp_dcid);
56  // First the HID interrupt channel has to be disconnected, then the HID control channel and finally the HCI connection
57  pBtd->l2cap_disconnection_request(hci_handle, ++identifier, interrupt_scid, interrupt_dcid);
58  Reset();
59  l2cap_sdp_state = L2CAP_DISCONNECT_RESPONSE;
60  l2cap_state = L2CAP_INTERRUPT_DISCONNECT;
61 }
62 
63 void BTHID::ACLData(uint8_t* l2capinbuf) {
64  if(!connected) {
65  if(l2capinbuf[8] == L2CAP_CMD_CONNECTION_REQUEST) {
66  if((l2capinbuf[12] | (l2capinbuf[13] << 8)) == SDP_PSM && !pBtd->sdpConnectionClaimed) {
67  pBtd->sdpConnectionClaimed = true;
68  hci_handle = pBtd->hci_handle; // Store the HCI Handle for the connection
69  l2cap_sdp_state = L2CAP_SDP_WAIT; // Reset state
70  }
71  }
72  }
73 
74  if(!pBtd->l2capConnectionClaimed && pBtd->incomingHIDDevice && !connected && !activeConnection) {
75  if(l2capinbuf[8] == L2CAP_CMD_CONNECTION_REQUEST) {
76  if((l2capinbuf[12] | (l2capinbuf[13] << 8)) == HID_CTRL_PSM) {
77  pBtd->incomingHIDDevice = false;
78  pBtd->l2capConnectionClaimed = true; // Claim that the incoming connection belongs to this service
79  activeConnection = true;
80  hci_handle = pBtd->hci_handle; // Store the HCI Handle for the connection
81  l2cap_state = L2CAP_WAIT;
82  }
83  }
84  }
85 
86  if(checkHciHandle(l2capinbuf, hci_handle)) { // acl_handle_ok
87  if((l2capinbuf[6] | (l2capinbuf[7] << 8)) == 0x0001U) { // l2cap_control - Channel ID for ACL-U
88  if(l2capinbuf[8] == L2CAP_CMD_COMMAND_REJECT) {
89 #ifdef DEBUG_USB_HOST
90  Notify(PSTR("\r\nL2CAP Command Rejected - Reason: "), 0x80);
91  D_PrintHex<uint8_t > (l2capinbuf[13], 0x80);
92  Notify(PSTR(" "), 0x80);
93  D_PrintHex<uint8_t > (l2capinbuf[12], 0x80);
94  Notify(PSTR(" "), 0x80);
95  D_PrintHex<uint8_t > (l2capinbuf[17], 0x80);
96  Notify(PSTR(" "), 0x80);
97  D_PrintHex<uint8_t > (l2capinbuf[16], 0x80);
98  Notify(PSTR(" "), 0x80);
99  D_PrintHex<uint8_t > (l2capinbuf[15], 0x80);
100  Notify(PSTR(" "), 0x80);
101  D_PrintHex<uint8_t > (l2capinbuf[14], 0x80);
102 #endif
103  } else if(l2capinbuf[8] == L2CAP_CMD_CONNECTION_RESPONSE) {
104  if(((l2capinbuf[16] | (l2capinbuf[17] << 8)) == 0x0000) && ((l2capinbuf[18] | (l2capinbuf[19] << 8)) == SUCCESSFUL)) { // Success
105  if(l2capinbuf[14] == sdp_dcid[0] && l2capinbuf[15] == sdp_dcid[1]) {
106 #ifdef EXTRADEBUG
107  Notify(PSTR("\r\nSDP Connection Complete"), 0x80);
108 #endif
109  identifier = l2capinbuf[9];
110  sdp_scid[0] = l2capinbuf[12];
111  sdp_scid[1] = l2capinbuf[13];
112 #ifdef DEBUG_USB_HOST
113  Notify(PSTR("\r\nSend SDP Config Request"), 0x80);
114 #endif
115  identifier++;
116  pBtd->l2cap_config_request(hci_handle, identifier, sdp_scid);
117  } else if(l2capinbuf[14] == control_dcid[0] && l2capinbuf[15] == control_dcid[1]) {
118 #ifdef EXTRADEBUG
119  Notify(PSTR("\r\nHID Control Connection Complete"), 0x80);
120 #endif
121  identifier = l2capinbuf[9];
122  control_scid[0] = l2capinbuf[12];
123  control_scid[1] = l2capinbuf[13];
124  l2cap_set_flag(L2CAP_FLAG_CONTROL_CONNECTED);
125  } else if(l2capinbuf[14] == interrupt_dcid[0] && l2capinbuf[15] == interrupt_dcid[1]) {
126 #ifdef EXTRADEBUG
127  Notify(PSTR("\r\nHID Interrupt Connection Complete"), 0x80);
128 #endif
129  identifier = l2capinbuf[9];
130  interrupt_scid[0] = l2capinbuf[12];
131  interrupt_scid[1] = l2capinbuf[13];
132  l2cap_set_flag(L2CAP_FLAG_INTERRUPT_CONNECTED);
133  }
134  }
135  } else if(l2capinbuf[8] == L2CAP_CMD_CONNECTION_REQUEST) {
136 #ifdef EXTRADEBUG
137  Notify(PSTR("\r\nL2CAP Connection Request - PSM: "), 0x80);
138  D_PrintHex<uint8_t > (l2capinbuf[13], 0x80);
139  Notify(PSTR(" "), 0x80);
140  D_PrintHex<uint8_t > (l2capinbuf[12], 0x80);
141  Notify(PSTR(" SCID: "), 0x80);
142  D_PrintHex<uint8_t > (l2capinbuf[15], 0x80);
143  Notify(PSTR(" "), 0x80);
144  D_PrintHex<uint8_t > (l2capinbuf[14], 0x80);
145  Notify(PSTR(" Identifier: "), 0x80);
146  D_PrintHex<uint8_t > (l2capinbuf[9], 0x80);
147 #endif
148  if((l2capinbuf[12] | (l2capinbuf[13] << 8)) == SDP_PSM) {
149  identifier = l2capinbuf[9];
150  sdp_scid[0] = l2capinbuf[14];
151  sdp_scid[1] = l2capinbuf[15];
152  l2cap_set_flag(L2CAP_FLAG_CONNECTION_SDP_REQUEST);
153  } else if((l2capinbuf[12] | (l2capinbuf[13] << 8)) == HID_CTRL_PSM) {
154  identifier = l2capinbuf[9];
155  control_scid[0] = l2capinbuf[14];
156  control_scid[1] = l2capinbuf[15];
157  l2cap_set_flag(L2CAP_FLAG_CONNECTION_CONTROL_REQUEST);
158  } else if((l2capinbuf[12] | (l2capinbuf[13] << 8)) == HID_INTR_PSM) {
159  identifier = l2capinbuf[9];
160  interrupt_scid[0] = l2capinbuf[14];
161  interrupt_scid[1] = l2capinbuf[15];
162  l2cap_set_flag(L2CAP_FLAG_CONNECTION_INTERRUPT_REQUEST);
163  }
164  } else if(l2capinbuf[8] == L2CAP_CMD_CONFIG_RESPONSE) {
165  if((l2capinbuf[16] | (l2capinbuf[17] << 8)) == 0x0000) { // Success
166  if(l2capinbuf[12] == sdp_dcid[0] && l2capinbuf[13] == sdp_dcid[1]) {
167 #ifdef EXTRADEBUG
168  Notify(PSTR("\r\nSDP Configuration Complete"), 0x80);
169 #endif
170  identifier = l2capinbuf[9];
171  l2cap_set_flag(L2CAP_FLAG_CONFIG_SDP_SUCCESS);
172  } else if(l2capinbuf[12] == control_dcid[0] && l2capinbuf[13] == control_dcid[1]) {
173 #ifdef EXTRADEBUG
174  Notify(PSTR("\r\nHID Control Configuration Complete"), 0x80);
175 #endif
176  identifier = l2capinbuf[9];
177  l2cap_set_flag(L2CAP_FLAG_CONFIG_CONTROL_SUCCESS);
178  } else if(l2capinbuf[12] == interrupt_dcid[0] && l2capinbuf[13] == interrupt_dcid[1]) {
179 #ifdef EXTRADEBUG
180  Notify(PSTR("\r\nHID Interrupt Configuration Complete"), 0x80);
181 #endif
182  identifier = l2capinbuf[9];
183  l2cap_set_flag(L2CAP_FLAG_CONFIG_INTERRUPT_SUCCESS);
184  }
185  }
186  } else if(l2capinbuf[8] == L2CAP_CMD_CONFIG_REQUEST) {
187  if(l2capinbuf[12] == sdp_dcid[0] && l2capinbuf[13] == sdp_dcid[1]) {
188 #ifdef EXTRADEBUG
189  Notify(PSTR("\r\nSDP Configuration Request"), 0x80);
190 #endif
191  pBtd->l2cap_config_response(hci_handle, l2capinbuf[9], sdp_scid);
192  } else if(l2capinbuf[12] == control_dcid[0] && l2capinbuf[13] == control_dcid[1]) {
193 #ifdef EXTRADEBUG
194  Notify(PSTR("\r\nHID Control Configuration Request"), 0x80);
195 #endif
196  pBtd->l2cap_config_response(hci_handle, l2capinbuf[9], control_scid);
197  } else if(l2capinbuf[12] == interrupt_dcid[0] && l2capinbuf[13] == interrupt_dcid[1]) {
198 #ifdef EXTRADEBUG
199  Notify(PSTR("\r\nHID Interrupt Configuration Request"), 0x80);
200 #endif
201  pBtd->l2cap_config_response(hci_handle, l2capinbuf[9], interrupt_scid);
202  }
203  } else if(l2capinbuf[8] == L2CAP_CMD_DISCONNECT_REQUEST) {
204  if(l2capinbuf[12] == sdp_dcid[0] && l2capinbuf[13] == sdp_dcid[1]) {
205 #ifdef DEBUG_USB_HOST
206  Notify(PSTR("\r\nDisconnect Request: SDP Channel"), 0x80);
207 #endif
208  identifier = l2capinbuf[9];
209  l2cap_set_flag(L2CAP_FLAG_DISCONNECT_SDP_REQUEST);
210  } else if(l2capinbuf[12] == control_dcid[0] && l2capinbuf[13] == control_dcid[1]) {
211 #ifdef DEBUG_USB_HOST
212  Notify(PSTR("\r\nDisconnect Request: Control Channel"), 0x80);
213 #endif
214  identifier = l2capinbuf[9];
215  pBtd->l2cap_disconnection_response(hci_handle, identifier, control_dcid, control_scid);
216  Reset();
217  } else if(l2capinbuf[12] == interrupt_dcid[0] && l2capinbuf[13] == interrupt_dcid[1]) {
218 #ifdef DEBUG_USB_HOST
219  Notify(PSTR("\r\nDisconnect Request: Interrupt Channel"), 0x80);
220 #endif
221  identifier = l2capinbuf[9];
222  pBtd->l2cap_disconnection_response(hci_handle, identifier, interrupt_dcid, interrupt_scid);
223  Reset();
224  }
225  } else if(l2capinbuf[8] == L2CAP_CMD_DISCONNECT_RESPONSE) {
226  if(l2capinbuf[12] == sdp_scid[0] && l2capinbuf[13] == sdp_scid[1]) {
227 #ifdef EXTRADEBUG
228  Notify(PSTR("\r\nDisconnect Response: SDP Channel"), 0x80);
229 #endif
230  identifier = l2capinbuf[9];
231  l2cap_set_flag(L2CAP_FLAG_DISCONNECT_RESPONSE);
232  } else if(l2capinbuf[12] == control_scid[0] && l2capinbuf[13] == control_scid[1]) {
233 #ifdef EXTRADEBUG
234  Notify(PSTR("\r\nDisconnect Response: Control Channel"), 0x80);
235 #endif
236  identifier = l2capinbuf[9];
237  l2cap_set_flag(L2CAP_FLAG_DISCONNECT_CONTROL_RESPONSE);
238  } else if(l2capinbuf[12] == interrupt_scid[0] && l2capinbuf[13] == interrupt_scid[1]) {
239 #ifdef EXTRADEBUG
240  Notify(PSTR("\r\nDisconnect Response: Interrupt Channel"), 0x80);
241 #endif
242  identifier = l2capinbuf[9];
243  l2cap_set_flag(L2CAP_FLAG_DISCONNECT_INTERRUPT_RESPONSE);
244  }
245  } else if(l2capinbuf[8] == L2CAP_CMD_INFORMATION_REQUEST) {
246 #ifdef DEBUG_USB_HOST
247  Notify(PSTR("\r\nInformation request"), 0x80);
248 #endif
249  identifier = l2capinbuf[9];
250  pBtd->l2cap_information_response(hci_handle, identifier, l2capinbuf[12], l2capinbuf[13]);
251  }
252 #ifdef EXTRADEBUG
253  else {
254  identifier = l2capinbuf[9];
255  Notify(PSTR("\r\nL2CAP Unknown Signaling Command: "), 0x80);
256  D_PrintHex<uint8_t > (l2capinbuf[8], 0x80);
257  }
258 #endif
259  } else if(l2capinbuf[6] == sdp_dcid[0] && l2capinbuf[7] == sdp_dcid[1]) { // SDP
260  if(l2capinbuf[8] == SDP_SERVICE_SEARCH_REQUEST) {
261 #ifdef EXTRADEBUG
262  Notify(PSTR("\r\nSDP_SERVICE_SEARCH_REQUEST"), 0x80);
263 #endif
264  // Send response
265  l2capoutbuf[0] = SDP_SERVICE_SEARCH_RESPONSE;
266  l2capoutbuf[1] = l2capinbuf[9];//transactionIDHigh;
267  l2capoutbuf[2] = l2capinbuf[10];//transactionIDLow;
268 
269  l2capoutbuf[3] = 0x00; // MSB Parameter Length
270  l2capoutbuf[4] = 0x05; // LSB Parameter Length = 5
271 
272  l2capoutbuf[5] = 0x00; // MSB TotalServiceRecordCount
273  l2capoutbuf[6] = 0x00; // LSB TotalServiceRecordCount = 0
274 
275  l2capoutbuf[7] = 0x00; // MSB CurrentServiceRecordCount
276  l2capoutbuf[8] = 0x00; // LSB CurrentServiceRecordCount = 0
277 
278  l2capoutbuf[9] = 0x00; // No continuation state
279 
280  SDP_Command(l2capoutbuf, 10);
281  } else if(l2capinbuf[8] == SDP_SERVICE_ATTRIBUTE_REQUEST) {
282 #ifdef EXTRADEBUG
283  Notify(PSTR("\r\nSDP_SERVICE_ATTRIBUTE_REQUEST"), 0x80);
284 #endif
285  // Send response
286  l2capoutbuf[0] = SDP_SERVICE_ATTRIBUTE_RESPONSE;
287  l2capoutbuf[1] = l2capinbuf[9];//transactionIDHigh;
288  l2capoutbuf[2] = l2capinbuf[10];//transactionIDLow;
289 
290  l2capoutbuf[3] = 0x00; // MSB Parameter Length
291  l2capoutbuf[4] = 0x05; // LSB Parameter Length = 5
292 
293  l2capoutbuf[5] = 0x00; // MSB AttributeListByteCount
294  l2capoutbuf[6] = 0x02; // LSB AttributeListByteCount = 2
295 
296  // TODO: What to send?
297  l2capoutbuf[7] = 0x35; // Data element sequence - length in next byte
298  l2capoutbuf[8] = 0x00; // Length = 0
299 
300  l2capoutbuf[9] = 0x00; // No continuation state
301 
302  SDP_Command(l2capoutbuf, 10);
303  } else if(l2capinbuf[8] == SDP_SERVICE_SEARCH_ATTRIBUTE_REQUEST) {
304 #ifdef EXTRADEBUG
305  Notify(PSTR("\r\nSDP_SERVICE_SEARCH_ATTRIBUTE_REQUEST"), 0x80);
306  Notify(PSTR("\r\nUUID: "), 0x80);
307  uint16_t uuid;
308  if((l2capinbuf[16] << 8 | l2capinbuf[17]) == 0x0000) // Check if it's sending the UUID as a 128-bit UUID
309  uuid = (l2capinbuf[18] << 8 | l2capinbuf[19]);
310  else // Short UUID
311  uuid = (l2capinbuf[16] << 8 | l2capinbuf[17]);
312  D_PrintHex<uint16_t > (uuid, 0x80);
313 
314  Notify(PSTR("\r\nLength: "), 0x80);
315  uint16_t length = l2capinbuf[11] << 8 | l2capinbuf[12];
316  D_PrintHex<uint16_t > (length, 0x80);
317  Notify(PSTR("\r\nData: "), 0x80);
318  for(uint8_t i = 0; i < length; i++) {
319  D_PrintHex<uint8_t > (l2capinbuf[13 + i], 0x80);
320  Notify(PSTR(" "), 0x80);
321  }
322 #endif
323  serviceNotSupported(l2capinbuf[9], l2capinbuf[10]); // The service is not supported
324  }
325 #ifdef EXTRADEBUG
326  else {
327  Notify(PSTR("\r\nUnknown PDU: "), 0x80);
328  D_PrintHex<uint8_t > (l2capinbuf[8], 0x80);
329  }
330 #endif
331  } else if(l2capinbuf[6] == interrupt_dcid[0] && l2capinbuf[7] == interrupt_dcid[1]) { // l2cap_interrupt
332 #ifdef PRINTREPORT
333  Notify(PSTR("\r\nL2CAP Interrupt: "), 0x80);
334  for(uint16_t i = 0; i < ((uint16_t)l2capinbuf[5] << 8 | l2capinbuf[4]); i++) {
335  D_PrintHex<uint8_t > (l2capinbuf[i + 8], 0x80);
336  Notify(PSTR(" "), 0x80);
337  }
338 #endif
339  if(l2capinbuf[8] == 0xA1) { // HID_THDR_DATA_INPUT
340  uint16_t length = ((uint16_t)l2capinbuf[5] << 8 | l2capinbuf[4]);
341  ParseBTHIDData((uint8_t)(length - 1), &l2capinbuf[9]);
342 
343  switch(l2capinbuf[9]) {
344  case 0x01: // Keyboard or Joystick events
345  if(pRptParser[KEYBOARD_PARSER_ID])
346  pRptParser[KEYBOARD_PARSER_ID]->Parse(reinterpret_cast<USBHID *>(this), 0, (uint8_t)(length - 2), &l2capinbuf[10]); // Use reinterpret_cast again to extract the instance
347  break;
348 
349  case 0x02: // Mouse events
350  if(pRptParser[MOUSE_PARSER_ID])
351  pRptParser[MOUSE_PARSER_ID]->Parse(reinterpret_cast<USBHID *>(this), 0, (uint8_t)(length - 2), &l2capinbuf[10]); // Use reinterpret_cast again to extract the instance
352  break;
353 #ifdef EXTRADEBUG
354  default:
355  Notify(PSTR("\r\nUnknown Report type: "), 0x80);
356  D_PrintHex<uint8_t > (l2capinbuf[9], 0x80);
357  break;
358 #endif
359  }
360  }
361  } else if(l2capinbuf[6] == control_dcid[0] && l2capinbuf[7] == control_dcid[1]) { // l2cap_control
362 #ifdef PRINTREPORT
363  Notify(PSTR("\r\nL2CAP Control: "), 0x80);
364  for(uint16_t i = 0; i < ((uint16_t)l2capinbuf[5] << 8 | l2capinbuf[4]); i++) {
365  D_PrintHex<uint8_t > (l2capinbuf[i + 8], 0x80);
366  Notify(PSTR(" "), 0x80);
367  }
368 #endif
369  if(l2capinbuf[8] == 0xA3) {
370  uint16_t length = ((uint16_t)l2capinbuf[5] << 8 | l2capinbuf[4]);
371  ParseBTHIDControlData((uint8_t)(length - 1), &l2capinbuf[9]);
372  }
373  }
374 #ifdef EXTRADEBUG
375  else {
376  Notify(PSTR("\r\nUnsupported L2CAP Data - Channel ID: "), 0x80);
377  D_PrintHex<uint8_t > (l2capinbuf[7], 0x80);
378  Notify(PSTR(" "), 0x80);
379  D_PrintHex<uint8_t > (l2capinbuf[6], 0x80);
380 
381  Notify(PSTR("\r\nData: "), 0x80);
382  Notify(PSTR("\r\n"), 0x80);
383  for(uint16_t i = 0; i < ((uint16_t)l2capinbuf[5] << 8 | l2capinbuf[4]); i++) {
384  D_PrintHex<uint8_t > (l2capinbuf[i + 8], 0x80);
385  Notify(PSTR(" "), 0x80);
386  }
387  }
388 #endif
389  SDP_task();
390  L2CAP_task();
391  }
392 }
393 
394 void BTHID::SDP_task() {
395  switch(l2cap_sdp_state) {
396  case L2CAP_SDP_WAIT:
397  if(l2cap_check_flag(L2CAP_FLAG_CONNECTION_SDP_REQUEST)) {
398  l2cap_clear_flag(L2CAP_FLAG_CONNECTION_SDP_REQUEST); // Clear flag
399 #ifdef DEBUG_USB_HOST
400  Notify(PSTR("\r\nSDP Incoming Connection Request"), 0x80);
401 #endif
402  pBtd->l2cap_connection_response(hci_handle, identifier, sdp_dcid, sdp_scid, PENDING);
403  delay(1);
404  pBtd->l2cap_connection_response(hci_handle, identifier, sdp_dcid, sdp_scid, SUCCESSFUL);
405  identifier++;
406  delay(1);
407  pBtd->l2cap_config_request(hci_handle, identifier, sdp_scid);
408  l2cap_sdp_state = L2CAP_SDP_SUCCESS;
409  } else if(l2cap_check_flag(L2CAP_FLAG_DISCONNECT_SDP_REQUEST)) {
410  l2cap_clear_flag(L2CAP_FLAG_DISCONNECT_SDP_REQUEST); // Clear flag
411  SDPConnected = false;
412 #ifdef DEBUG_USB_HOST
413  Notify(PSTR("\r\nDisconnected SDP Channel"), 0x80);
414 #endif
415  pBtd->l2cap_disconnection_response(hci_handle, identifier, sdp_dcid, sdp_scid);
416  }
417  break;
418  case L2CAP_SDP_SUCCESS:
419  if(l2cap_check_flag(L2CAP_FLAG_CONFIG_SDP_SUCCESS)) {
420  l2cap_clear_flag(L2CAP_FLAG_CONFIG_SDP_SUCCESS); // Clear flag
421 #ifdef DEBUG_USB_HOST
422  Notify(PSTR("\r\nSDP Successfully Configured"), 0x80);
423 #endif
424  SDPConnected = true;
425  l2cap_sdp_state = L2CAP_SDP_WAIT;
426  }
427  break;
428 
429  case L2CAP_DISCONNECT_RESPONSE: // This is for both disconnection response from the RFCOMM and SDP channel if they were connected
430  if(l2cap_check_flag(L2CAP_FLAG_DISCONNECT_RESPONSE)) {
431 #ifdef DEBUG_USB_HOST
432  Notify(PSTR("\r\nDisconnected L2CAP Connection"), 0x80);
433 #endif
434  pBtd->hci_disconnect(hci_handle);
435  hci_handle = -1; // Reset handle
436  Reset();
437  }
438  break;
439  }
440 }
441 
442 void BTHID::L2CAP_task() {
443  switch(l2cap_state) {
444  /* These states are used if the HID device is the host */
445  case L2CAP_CONTROL_SUCCESS:
446  if(l2cap_check_flag(L2CAP_FLAG_CONFIG_CONTROL_SUCCESS)) {
447 #ifdef DEBUG_USB_HOST
448  Notify(PSTR("\r\nHID Control Successfully Configured"), 0x80);
449 #endif
450  setProtocol(); // Set protocol before establishing HID interrupt channel
451  l2cap_state = L2CAP_INTERRUPT_SETUP;
452  }
453  break;
454 
455  case L2CAP_INTERRUPT_SETUP:
456  if(l2cap_check_flag(L2CAP_FLAG_CONNECTION_INTERRUPT_REQUEST)) {
457 #ifdef DEBUG_USB_HOST
458  Notify(PSTR("\r\nHID Interrupt Incoming Connection Request"), 0x80);
459 #endif
460  pBtd->l2cap_connection_response(hci_handle, identifier, interrupt_dcid, interrupt_scid, PENDING);
461  delay(1);
462  pBtd->l2cap_connection_response(hci_handle, identifier, interrupt_dcid, interrupt_scid, SUCCESSFUL);
463  identifier++;
464  delay(1);
465  pBtd->l2cap_config_request(hci_handle, identifier, interrupt_scid);
466 
467  l2cap_state = L2CAP_INTERRUPT_CONFIG_REQUEST;
468  }
469  break;
470 
471  /* These states are used if the Arduino is the host */
472  case L2CAP_CONTROL_CONNECT_REQUEST:
473  if(l2cap_check_flag(L2CAP_FLAG_CONTROL_CONNECTED)) {
474 #ifdef DEBUG_USB_HOST
475  Notify(PSTR("\r\nSend HID Control Config Request"), 0x80);
476 #endif
477  identifier++;
478  pBtd->l2cap_config_request(hci_handle, identifier, control_scid);
479  l2cap_state = L2CAP_CONTROL_CONFIG_REQUEST;
480  }
481  break;
482 
483  case L2CAP_CONTROL_CONFIG_REQUEST:
484  if(l2cap_check_flag(L2CAP_FLAG_CONFIG_CONTROL_SUCCESS)) {
485  setProtocol(); // Set protocol before establishing HID interrupt channel
486  delay(1); // Short delay between commands - just to be sure
487 #ifdef DEBUG_USB_HOST
488  Notify(PSTR("\r\nSend HID Interrupt Connection Request"), 0x80);
489 #endif
490  identifier++;
491  pBtd->l2cap_connection_request(hci_handle, identifier, interrupt_dcid, HID_INTR_PSM);
492  l2cap_state = L2CAP_INTERRUPT_CONNECT_REQUEST;
493  }
494  break;
495 
496  case L2CAP_INTERRUPT_CONNECT_REQUEST:
497  if(l2cap_check_flag(L2CAP_FLAG_INTERRUPT_CONNECTED)) {
498 #ifdef DEBUG_USB_HOST
499  Notify(PSTR("\r\nSend HID Interrupt Config Request"), 0x80);
500 #endif
501  identifier++;
502  pBtd->l2cap_config_request(hci_handle, identifier, interrupt_scid);
503  l2cap_state = L2CAP_INTERRUPT_CONFIG_REQUEST;
504  }
505  break;
506 
507  case L2CAP_INTERRUPT_CONFIG_REQUEST:
508  if(l2cap_check_flag(L2CAP_FLAG_CONFIG_INTERRUPT_SUCCESS)) { // Now the HID channels is established
509 #ifdef DEBUG_USB_HOST
510  Notify(PSTR("\r\nHID Channels Established"), 0x80);
511 #endif
512  pBtd->connectToHIDDevice = false;
513  pBtd->pairWithHIDDevice = false;
514  connected = true;
515  onInit();
516  l2cap_state = L2CAP_DONE;
517  }
518  break;
519 
520  case L2CAP_DONE:
521  break;
522 
523  case L2CAP_INTERRUPT_DISCONNECT:
524  if(l2cap_check_flag(L2CAP_FLAG_DISCONNECT_INTERRUPT_RESPONSE)) {
525 #ifdef DEBUG_USB_HOST
526  Notify(PSTR("\r\nDisconnected Interrupt Channel"), 0x80);
527 #endif
528  identifier++;
529  pBtd->l2cap_disconnection_request(hci_handle, identifier, control_scid, control_dcid);
530  l2cap_state = L2CAP_CONTROL_DISCONNECT;
531  }
532  break;
533 
534  case L2CAP_CONTROL_DISCONNECT:
535  if(l2cap_check_flag(L2CAP_FLAG_DISCONNECT_CONTROL_RESPONSE)) {
536 #ifdef DEBUG_USB_HOST
537  Notify(PSTR("\r\nDisconnected Control Channel"), 0x80);
538 #endif
539  pBtd->hci_disconnect(hci_handle);
540  hci_handle = -1; // Reset handle
541  l2cap_event_flag = 0; // Reset flags
542  l2cap_state = L2CAP_WAIT;
543  }
544  break;
545  }
546 }
547 
548 void BTHID::Run() {
549  switch(l2cap_state) {
550  case L2CAP_WAIT:
551  if(pBtd->connectToHIDDevice && !pBtd->l2capConnectionClaimed && !connected && !activeConnection) {
552  pBtd->l2capConnectionClaimed = true;
553  activeConnection = true;
554 #ifdef DEBUG_USB_HOST
555  Notify(PSTR("\r\nSend HID Control Connection Request"), 0x80);
556 #endif
557  hci_handle = pBtd->hci_handle; // Store the HCI Handle for the connection
558  l2cap_event_flag = 0; // Reset flags
559  identifier = 0;
560  pBtd->l2cap_connection_request(hci_handle, identifier, control_dcid, HID_CTRL_PSM);
561  l2cap_state = L2CAP_CONTROL_CONNECT_REQUEST;
562  } else if(l2cap_check_flag(L2CAP_FLAG_CONNECTION_CONTROL_REQUEST)) {
563 #ifdef DEBUG_USB_HOST
564  Notify(PSTR("\r\nHID Control Incoming Connection Request"), 0x80);
565 #endif
566  pBtd->l2cap_connection_response(hci_handle, identifier, control_dcid, control_scid, PENDING);
567  delay(1);
568  pBtd->l2cap_connection_response(hci_handle, identifier, control_dcid, control_scid, SUCCESSFUL);
569  identifier++;
570  delay(1);
571  pBtd->l2cap_config_request(hci_handle, identifier, control_scid);
572  l2cap_state = L2CAP_CONTROL_SUCCESS;
573  }
574  break;
575  }
576 }
577 
578 void BTHID::SDP_Command(uint8_t* data, uint8_t nbytes) { // See page 223 in the Bluetooth specs
579  pBtd->L2CAP_Command(hci_handle, data, nbytes, sdp_scid[0], sdp_scid[1]);
580 }
581 
582 void BTHID::serviceNotSupported(uint8_t transactionIDHigh, uint8_t transactionIDLow) { // See page 235 in the Bluetooth specs
583  l2capoutbuf[0] = SDP_SERVICE_SEARCH_ATTRIBUTE_RESPONSE;
584  l2capoutbuf[1] = transactionIDHigh;
585  l2capoutbuf[2] = transactionIDLow;
586  l2capoutbuf[3] = 0x00; // MSB Parameter Length
587  l2capoutbuf[4] = 0x05; // LSB Parameter Length = 5
588  l2capoutbuf[5] = 0x00; // MSB AttributeListsByteCount
589  l2capoutbuf[6] = 0x02; // LSB AttributeListsByteCount = 2
590 
591  /* Attribute ID/Value Sequence: */
592  l2capoutbuf[7] = 0x35; // Data element sequence - length in next byte
593  l2capoutbuf[8] = 0x00; // Length = 0
594  l2capoutbuf[9] = 0x00; // No continuation state
595 
596  SDP_Command(l2capoutbuf, 10);
597 }
598 
599 /************************************************************/
600 /* HID Commands */
601 
602 /************************************************************/
603 void BTHID::setProtocol() {
604 #ifdef DEBUG_USB_HOST
605  Notify(PSTR("\r\nSet protocol mode: "), 0x80);
606  D_PrintHex<uint8_t > (protocolMode, 0x80);
607 #endif
608  if (protocolMode != USB_HID_BOOT_PROTOCOL && protocolMode != HID_RPT_PROTOCOL) {
609 #ifdef DEBUG_USB_HOST
610  Notify(PSTR("\r\nNot a valid protocol mode. Using Boot protocol instead."), 0x80);
611 #endif
612  protocolMode = USB_HID_BOOT_PROTOCOL; // Use Boot Protocol by default
613  }
614  uint8_t command = 0x70 | protocolMode; // Set Protocol, see Bluetooth HID specs page 33
615  pBtd->L2CAP_Command(hci_handle, &command, 1, control_scid[0], control_scid[1]);
616 }
617 
618 void BTHID::setLeds(uint8_t data) {
619  uint8_t buf[3];
620  buf[0] = 0xA2; // HID BT DATA_request (0xA0) | Report Type (Output 0x02)
621  buf[1] = 0x01; // Report ID
622  buf[2] = data;
623  pBtd->L2CAP_Command(hci_handle, buf, 3, interrupt_scid[0], interrupt_scid[1]);
624 }
L2CAP_FLAG_DISCONNECT_CONTROL_RESPONSE
#define L2CAP_FLAG_DISCONNECT_CONTROL_RESPONSE
Definition: BTD.h:149
+Go to the documentation of this file.
1 /* Copyright (C) 2013 Kristian Lauszus, TKJ Electronics. All rights reserved.
2 
3  This software may be distributed and modified under the terms of the GNU
4  General Public License version 2 (GPL2) as published by the Free Software
5  Foundation and appearing in the file GPL2.TXT included in the packaging of
6  this file. Please note that GPL2 Section 2[b] requires that all works based
7  on this software must also be made publicly available under the terms of
8  the GPL2 ("Copyleft").
9 
10  Contact information
11  -------------------
12 
13  Kristian Lauszus, TKJ Electronics
14  Web : http://www.tkjelectronics.com
15  e-mail : kristianl@tkjelectronics.com
16  */
17 
18 #include "BTHID.h"
19 // To enable serial debugging see "settings.h"
20 //#define EXTRADEBUG // Uncomment to get even more debugging data
21 //#define PRINTREPORT // Uncomment to print the report send by the HID device
22 
23 BTHID::BTHID(BTD *p, bool pair, const char *pin) :
24 BluetoothService(p), // Pointer to USB class instance - mandatory
25 protocolMode(USB_HID_BOOT_PROTOCOL) {
26  for(uint8_t i = 0; i < NUM_PARSERS; i++)
27  pRptParser[i] = NULL;
28 
29  pBtd->pairWithHIDDevice = pair;
30  pBtd->btdPin = pin;
31 
32  /* Set device cid for the control and intterrupt channelse - LSB */
33  sdp_dcid[0] = 0x50; // 0x0050
34  sdp_dcid[1] = 0x00;
35  control_dcid[0] = 0x70; // 0x0070
36  control_dcid[1] = 0x00;
37  interrupt_dcid[0] = 0x71; // 0x0071
38  interrupt_dcid[1] = 0x00;
39 
40  Reset();
41 }
42 
43 void BTHID::Reset() {
44  connected = false;
45  activeConnection = false;
46  SDPConnected = false;
47  l2cap_event_flag = 0; // Reset flags
48  l2cap_sdp_state = L2CAP_SDP_WAIT;
49  l2cap_state = L2CAP_WAIT;
50  ResetBTHID();
51 }
52 
53 void BTHID::disconnect() { // Use this void to disconnect the device
54  if(SDPConnected)
55  pBtd->l2cap_disconnection_request(hci_handle, ++identifier, sdp_scid, sdp_dcid);
56  // First the HID interrupt channel has to be disconnected, then the HID control channel and finally the HCI connection
57  pBtd->l2cap_disconnection_request(hci_handle, ++identifier, interrupt_scid, interrupt_dcid);
58  Reset();
59  l2cap_sdp_state = L2CAP_DISCONNECT_RESPONSE;
60  l2cap_state = L2CAP_INTERRUPT_DISCONNECT;
61 }
62 
63 void BTHID::ACLData(uint8_t* l2capinbuf) {
64  if(!connected) {
65  if(l2capinbuf[8] == L2CAP_CMD_CONNECTION_REQUEST) {
66  if((l2capinbuf[12] | (l2capinbuf[13] << 8)) == SDP_PSM && !pBtd->sdpConnectionClaimed) {
67  pBtd->sdpConnectionClaimed = true;
68  hci_handle = pBtd->hci_handle; // Store the HCI Handle for the connection
69  l2cap_sdp_state = L2CAP_SDP_WAIT; // Reset state
70  }
71  }
72  }
73 
74  if(!pBtd->l2capConnectionClaimed && pBtd->incomingHIDDevice && !connected && !activeConnection) {
75  if(l2capinbuf[8] == L2CAP_CMD_CONNECTION_REQUEST) {
76  if((l2capinbuf[12] | (l2capinbuf[13] << 8)) == HID_CTRL_PSM) {
77  pBtd->incomingHIDDevice = false;
78  pBtd->l2capConnectionClaimed = true; // Claim that the incoming connection belongs to this service
79  activeConnection = true;
80  hci_handle = pBtd->hci_handle; // Store the HCI Handle for the connection
81  l2cap_state = L2CAP_WAIT;
82  }
83  }
84  }
85 
86  if(checkHciHandle(l2capinbuf, hci_handle)) { // acl_handle_ok
87  if((l2capinbuf[6] | (l2capinbuf[7] << 8)) == 0x0001U) { // l2cap_control - Channel ID for ACL-U
88  if(l2capinbuf[8] == L2CAP_CMD_COMMAND_REJECT) {
89 #ifdef DEBUG_USB_HOST
90  Notify(PSTR("\r\nL2CAP Command Rejected - Reason: "), 0x80);
91  D_PrintHex<uint8_t > (l2capinbuf[13], 0x80);
92  Notify(PSTR(" "), 0x80);
93  D_PrintHex<uint8_t > (l2capinbuf[12], 0x80);
94  Notify(PSTR(" "), 0x80);
95  D_PrintHex<uint8_t > (l2capinbuf[17], 0x80);
96  Notify(PSTR(" "), 0x80);
97  D_PrintHex<uint8_t > (l2capinbuf[16], 0x80);
98  Notify(PSTR(" "), 0x80);
99  D_PrintHex<uint8_t > (l2capinbuf[15], 0x80);
100  Notify(PSTR(" "), 0x80);
101  D_PrintHex<uint8_t > (l2capinbuf[14], 0x80);
102 #endif
103  } else if(l2capinbuf[8] == L2CAP_CMD_CONNECTION_RESPONSE) {
104  if(((l2capinbuf[16] | (l2capinbuf[17] << 8)) == 0x0000) && ((l2capinbuf[18] | (l2capinbuf[19] << 8)) == SUCCESSFUL)) { // Success
105  if(l2capinbuf[14] == sdp_dcid[0] && l2capinbuf[15] == sdp_dcid[1]) {
106 #ifdef EXTRADEBUG
107  Notify(PSTR("\r\nSDP Connection Complete"), 0x80);
108 #endif
109  identifier = l2capinbuf[9];
110  sdp_scid[0] = l2capinbuf[12];
111  sdp_scid[1] = l2capinbuf[13];
112 #ifdef DEBUG_USB_HOST
113  Notify(PSTR("\r\nSend SDP Config Request"), 0x80);
114 #endif
115  identifier++;
116  pBtd->l2cap_config_request(hci_handle, identifier, sdp_scid);
117  } else if(l2capinbuf[14] == control_dcid[0] && l2capinbuf[15] == control_dcid[1]) {
118 #ifdef EXTRADEBUG
119  Notify(PSTR("\r\nHID Control Connection Complete"), 0x80);
120 #endif
121  identifier = l2capinbuf[9];
122  control_scid[0] = l2capinbuf[12];
123  control_scid[1] = l2capinbuf[13];
124  l2cap_set_flag(L2CAP_FLAG_CONTROL_CONNECTED);
125  } else if(l2capinbuf[14] == interrupt_dcid[0] && l2capinbuf[15] == interrupt_dcid[1]) {
126 #ifdef EXTRADEBUG
127  Notify(PSTR("\r\nHID Interrupt Connection Complete"), 0x80);
128 #endif
129  identifier = l2capinbuf[9];
130  interrupt_scid[0] = l2capinbuf[12];
131  interrupt_scid[1] = l2capinbuf[13];
132  l2cap_set_flag(L2CAP_FLAG_INTERRUPT_CONNECTED);
133  }
134  }
135  } else if(l2capinbuf[8] == L2CAP_CMD_CONNECTION_REQUEST) {
136 #ifdef EXTRADEBUG
137  Notify(PSTR("\r\nL2CAP Connection Request - PSM: "), 0x80);
138  D_PrintHex<uint8_t > (l2capinbuf[13], 0x80);
139  Notify(PSTR(" "), 0x80);
140  D_PrintHex<uint8_t > (l2capinbuf[12], 0x80);
141  Notify(PSTR(" SCID: "), 0x80);
142  D_PrintHex<uint8_t > (l2capinbuf[15], 0x80);
143  Notify(PSTR(" "), 0x80);
144  D_PrintHex<uint8_t > (l2capinbuf[14], 0x80);
145  Notify(PSTR(" Identifier: "), 0x80);
146  D_PrintHex<uint8_t > (l2capinbuf[9], 0x80);
147 #endif
148  if((l2capinbuf[12] | (l2capinbuf[13] << 8)) == SDP_PSM) {
149  identifier = l2capinbuf[9];
150  sdp_scid[0] = l2capinbuf[14];
151  sdp_scid[1] = l2capinbuf[15];
152  l2cap_set_flag(L2CAP_FLAG_CONNECTION_SDP_REQUEST);
153  } else if((l2capinbuf[12] | (l2capinbuf[13] << 8)) == HID_CTRL_PSM) {
154  identifier = l2capinbuf[9];
155  control_scid[0] = l2capinbuf[14];
156  control_scid[1] = l2capinbuf[15];
157  l2cap_set_flag(L2CAP_FLAG_CONNECTION_CONTROL_REQUEST);
158  } else if((l2capinbuf[12] | (l2capinbuf[13] << 8)) == HID_INTR_PSM) {
159  identifier = l2capinbuf[9];
160  interrupt_scid[0] = l2capinbuf[14];
161  interrupt_scid[1] = l2capinbuf[15];
162  l2cap_set_flag(L2CAP_FLAG_CONNECTION_INTERRUPT_REQUEST);
163  }
164  } else if(l2capinbuf[8] == L2CAP_CMD_CONFIG_RESPONSE) {
165  if((l2capinbuf[16] | (l2capinbuf[17] << 8)) == 0x0000) { // Success
166  if(l2capinbuf[12] == sdp_dcid[0] && l2capinbuf[13] == sdp_dcid[1]) {
167 #ifdef EXTRADEBUG
168  Notify(PSTR("\r\nSDP Configuration Complete"), 0x80);
169 #endif
170  identifier = l2capinbuf[9];
171  l2cap_set_flag(L2CAP_FLAG_CONFIG_SDP_SUCCESS);
172  } else if(l2capinbuf[12] == control_dcid[0] && l2capinbuf[13] == control_dcid[1]) {
173 #ifdef EXTRADEBUG
174  Notify(PSTR("\r\nHID Control Configuration Complete"), 0x80);
175 #endif
176  identifier = l2capinbuf[9];
177  l2cap_set_flag(L2CAP_FLAG_CONFIG_CONTROL_SUCCESS);
178  } else if(l2capinbuf[12] == interrupt_dcid[0] && l2capinbuf[13] == interrupt_dcid[1]) {
179 #ifdef EXTRADEBUG
180  Notify(PSTR("\r\nHID Interrupt Configuration Complete"), 0x80);
181 #endif
182  identifier = l2capinbuf[9];
183  l2cap_set_flag(L2CAP_FLAG_CONFIG_INTERRUPT_SUCCESS);
184  }
185  }
186  } else if(l2capinbuf[8] == L2CAP_CMD_CONFIG_REQUEST) {
187  if(l2capinbuf[12] == sdp_dcid[0] && l2capinbuf[13] == sdp_dcid[1]) {
188 #ifdef EXTRADEBUG
189  Notify(PSTR("\r\nSDP Configuration Request"), 0x80);
190 #endif
191  pBtd->l2cap_config_response(hci_handle, l2capinbuf[9], sdp_scid);
192  } else if(l2capinbuf[12] == control_dcid[0] && l2capinbuf[13] == control_dcid[1]) {
193 #ifdef EXTRADEBUG
194  Notify(PSTR("\r\nHID Control Configuration Request"), 0x80);
195 #endif
196  pBtd->l2cap_config_response(hci_handle, l2capinbuf[9], control_scid);
197  } else if(l2capinbuf[12] == interrupt_dcid[0] && l2capinbuf[13] == interrupt_dcid[1]) {
198 #ifdef EXTRADEBUG
199  Notify(PSTR("\r\nHID Interrupt Configuration Request"), 0x80);
200 #endif
201  pBtd->l2cap_config_response(hci_handle, l2capinbuf[9], interrupt_scid);
202  }
203  } else if(l2capinbuf[8] == L2CAP_CMD_DISCONNECT_REQUEST) {
204  if(l2capinbuf[12] == sdp_dcid[0] && l2capinbuf[13] == sdp_dcid[1]) {
205 #ifdef DEBUG_USB_HOST
206  Notify(PSTR("\r\nDisconnect Request: SDP Channel"), 0x80);
207 #endif
208  identifier = l2capinbuf[9];
209  l2cap_set_flag(L2CAP_FLAG_DISCONNECT_SDP_REQUEST);
210  } else if(l2capinbuf[12] == control_dcid[0] && l2capinbuf[13] == control_dcid[1]) {
211 #ifdef DEBUG_USB_HOST
212  Notify(PSTR("\r\nDisconnect Request: Control Channel"), 0x80);
213 #endif
214  identifier = l2capinbuf[9];
215  pBtd->l2cap_disconnection_response(hci_handle, identifier, control_dcid, control_scid);
216  Reset();
217  } else if(l2capinbuf[12] == interrupt_dcid[0] && l2capinbuf[13] == interrupt_dcid[1]) {
218 #ifdef DEBUG_USB_HOST
219  Notify(PSTR("\r\nDisconnect Request: Interrupt Channel"), 0x80);
220 #endif
221  identifier = l2capinbuf[9];
222  pBtd->l2cap_disconnection_response(hci_handle, identifier, interrupt_dcid, interrupt_scid);
223  Reset();
224  }
225  } else if(l2capinbuf[8] == L2CAP_CMD_DISCONNECT_RESPONSE) {
226  if(l2capinbuf[12] == sdp_scid[0] && l2capinbuf[13] == sdp_scid[1]) {
227 #ifdef EXTRADEBUG
228  Notify(PSTR("\r\nDisconnect Response: SDP Channel"), 0x80);
229 #endif
230  identifier = l2capinbuf[9];
231  l2cap_set_flag(L2CAP_FLAG_DISCONNECT_RESPONSE);
232  } else if(l2capinbuf[12] == control_scid[0] && l2capinbuf[13] == control_scid[1]) {
233 #ifdef EXTRADEBUG
234  Notify(PSTR("\r\nDisconnect Response: Control Channel"), 0x80);
235 #endif
236  identifier = l2capinbuf[9];
237  l2cap_set_flag(L2CAP_FLAG_DISCONNECT_CONTROL_RESPONSE);
238  } else if(l2capinbuf[12] == interrupt_scid[0] && l2capinbuf[13] == interrupt_scid[1]) {
239 #ifdef EXTRADEBUG
240  Notify(PSTR("\r\nDisconnect Response: Interrupt Channel"), 0x80);
241 #endif
242  identifier = l2capinbuf[9];
243  l2cap_set_flag(L2CAP_FLAG_DISCONNECT_INTERRUPT_RESPONSE);
244  }
245  } else if(l2capinbuf[8] == L2CAP_CMD_INFORMATION_REQUEST) {
246 #ifdef DEBUG_USB_HOST
247  Notify(PSTR("\r\nInformation request"), 0x80);
248 #endif
249  identifier = l2capinbuf[9];
250  pBtd->l2cap_information_response(hci_handle, identifier, l2capinbuf[12], l2capinbuf[13]);
251  }
252 #ifdef EXTRADEBUG
253  else {
254  identifier = l2capinbuf[9];
255  Notify(PSTR("\r\nL2CAP Unknown Signaling Command: "), 0x80);
256  D_PrintHex<uint8_t > (l2capinbuf[8], 0x80);
257  }
258 #endif
259  } else if(l2capinbuf[6] == sdp_dcid[0] && l2capinbuf[7] == sdp_dcid[1]) { // SDP
260  if(l2capinbuf[8] == SDP_SERVICE_SEARCH_REQUEST) {
261 #ifdef EXTRADEBUG
262  Notify(PSTR("\r\nSDP_SERVICE_SEARCH_REQUEST"), 0x80);
263 #endif
264  // Send response
265  l2capoutbuf[0] = SDP_SERVICE_SEARCH_RESPONSE;
266  l2capoutbuf[1] = l2capinbuf[9];//transactionIDHigh;
267  l2capoutbuf[2] = l2capinbuf[10];//transactionIDLow;
268 
269  l2capoutbuf[3] = 0x00; // MSB Parameter Length
270  l2capoutbuf[4] = 0x05; // LSB Parameter Length = 5
271 
272  l2capoutbuf[5] = 0x00; // MSB TotalServiceRecordCount
273  l2capoutbuf[6] = 0x00; // LSB TotalServiceRecordCount = 0
274 
275  l2capoutbuf[7] = 0x00; // MSB CurrentServiceRecordCount
276  l2capoutbuf[8] = 0x00; // LSB CurrentServiceRecordCount = 0
277 
278  l2capoutbuf[9] = 0x00; // No continuation state
279 
280  SDP_Command(l2capoutbuf, 10);
281  } else if(l2capinbuf[8] == SDP_SERVICE_ATTRIBUTE_REQUEST) {
282 #ifdef EXTRADEBUG
283  Notify(PSTR("\r\nSDP_SERVICE_ATTRIBUTE_REQUEST"), 0x80);
284 #endif
285  // Send response
286  l2capoutbuf[0] = SDP_SERVICE_ATTRIBUTE_RESPONSE;
287  l2capoutbuf[1] = l2capinbuf[9];//transactionIDHigh;
288  l2capoutbuf[2] = l2capinbuf[10];//transactionIDLow;
289 
290  l2capoutbuf[3] = 0x00; // MSB Parameter Length
291  l2capoutbuf[4] = 0x05; // LSB Parameter Length = 5
292 
293  l2capoutbuf[5] = 0x00; // MSB AttributeListByteCount
294  l2capoutbuf[6] = 0x02; // LSB AttributeListByteCount = 2
295 
296  // TODO: What to send?
297  l2capoutbuf[7] = 0x35; // Data element sequence - length in next byte
298  l2capoutbuf[8] = 0x00; // Length = 0
299 
300  l2capoutbuf[9] = 0x00; // No continuation state
301 
302  SDP_Command(l2capoutbuf, 10);
303  } else if(l2capinbuf[8] == SDP_SERVICE_SEARCH_ATTRIBUTE_REQUEST) {
304 #ifdef EXTRADEBUG
305  Notify(PSTR("\r\nSDP_SERVICE_SEARCH_ATTRIBUTE_REQUEST"), 0x80);
306  Notify(PSTR("\r\nUUID: "), 0x80);
307  uint16_t uuid;
308  if((l2capinbuf[16] << 8 | l2capinbuf[17]) == 0x0000) // Check if it's sending the UUID as a 128-bit UUID
309  uuid = (l2capinbuf[18] << 8 | l2capinbuf[19]);
310  else // Short UUID
311  uuid = (l2capinbuf[16] << 8 | l2capinbuf[17]);
312  D_PrintHex<uint16_t > (uuid, 0x80);
313 
314  Notify(PSTR("\r\nLength: "), 0x80);
315  uint16_t length = l2capinbuf[11] << 8 | l2capinbuf[12];
316  D_PrintHex<uint16_t > (length, 0x80);
317  Notify(PSTR("\r\nData: "), 0x80);
318  for(uint8_t i = 0; i < length; i++) {
319  D_PrintHex<uint8_t > (l2capinbuf[13 + i], 0x80);
320  Notify(PSTR(" "), 0x80);
321  }
322 #endif
323  serviceNotSupported(l2capinbuf[9], l2capinbuf[10]); // The service is not supported
324  }
325 #ifdef EXTRADEBUG
326  else {
327  Notify(PSTR("\r\nUnknown PDU: "), 0x80);
328  D_PrintHex<uint8_t > (l2capinbuf[8], 0x80);
329  }
330 #endif
331  } else if(l2capinbuf[6] == interrupt_dcid[0] && l2capinbuf[7] == interrupt_dcid[1]) { // l2cap_interrupt
332 #ifdef PRINTREPORT
333  Notify(PSTR("\r\nL2CAP Interrupt: "), 0x80);
334  for(uint16_t i = 0; i < ((uint16_t)l2capinbuf[5] << 8 | l2capinbuf[4]); i++) {
335  D_PrintHex<uint8_t > (l2capinbuf[i + 8], 0x80);
336  Notify(PSTR(" "), 0x80);
337  }
338 #endif
339  if(l2capinbuf[8] == 0xA1) { // HID BT DATA (0xA0) | Report Type (Input 0x01)
340  uint16_t length = ((uint16_t)l2capinbuf[5] << 8 | l2capinbuf[4]);
341  ParseBTHIDData((uint8_t)(length - 1), &l2capinbuf[9]); // First byte will be the report ID
342 
343  switch(l2capinbuf[9]) { // Report ID
344  case 0x01: // Keyboard or Joystick events
345  if(pRptParser[KEYBOARD_PARSER_ID])
346  pRptParser[KEYBOARD_PARSER_ID]->Parse(reinterpret_cast<USBHID *>(this), 0, (uint8_t)(length - 2), &l2capinbuf[10]); // Use reinterpret_cast again to extract the instance
347  break;
348 
349  case 0x02: // Mouse events
350  if(pRptParser[MOUSE_PARSER_ID])
351  pRptParser[MOUSE_PARSER_ID]->Parse(reinterpret_cast<USBHID *>(this), 0, (uint8_t)(length - 2), &l2capinbuf[10]); // Use reinterpret_cast again to extract the instance
352  break;
353 #ifdef EXTRADEBUG
354  default:
355  Notify(PSTR("\r\nUnknown Report type: "), 0x80);
356  D_PrintHex<uint8_t > (l2capinbuf[9], 0x80);
357  break;
358 #endif
359  }
360  } else {
361 #ifdef EXTRADEBUG
362  Notify(PSTR("\r\nUnhandled L2CAP interrupt report: "), 0x80);
363  D_PrintHex<uint8_t > (l2capinbuf[8], 0x80);
364 #endif
365  }
366  } else if(l2capinbuf[6] == control_dcid[0] && l2capinbuf[7] == control_dcid[1]) { // l2cap_control
367 #ifdef PRINTREPORT
368  Notify(PSTR("\r\nL2CAP Control: "), 0x80);
369  for(uint16_t i = 0; i < ((uint16_t)l2capinbuf[5] << 8 | l2capinbuf[4]); i++) {
370  D_PrintHex<uint8_t > (l2capinbuf[i + 8], 0x80);
371  Notify(PSTR(" "), 0x80);
372  }
373 #endif
374  if(l2capinbuf[8] == 0xA3) { // HID BT DATA (0xA0) | Report Type (Feature 0x03)
375  uint16_t length = ((uint16_t)l2capinbuf[5] << 8 | l2capinbuf[4]);
376  ParseBTHIDControlData((uint8_t)(length - 1), &l2capinbuf[9]); // First byte will be the report ID
377  } else {
378 #ifdef EXTRADEBUG
379  Notify(PSTR("\r\nUnhandled L2CAP control report: "), 0x80);
380  D_PrintHex<uint8_t > (l2capinbuf[8], 0x80);
381 #endif
382  }
383  }
384 #ifdef EXTRADEBUG
385  else {
386  Notify(PSTR("\r\nUnsupported L2CAP Data - Channel ID: "), 0x80);
387  D_PrintHex<uint8_t > (l2capinbuf[7], 0x80);
388  Notify(PSTR(" "), 0x80);
389  D_PrintHex<uint8_t > (l2capinbuf[6], 0x80);
390 
391  Notify(PSTR("\r\nData: "), 0x80);
392  Notify(PSTR("\r\n"), 0x80);
393  for(uint16_t i = 0; i < ((uint16_t)l2capinbuf[5] << 8 | l2capinbuf[4]); i++) {
394  D_PrintHex<uint8_t > (l2capinbuf[i + 8], 0x80);
395  Notify(PSTR(" "), 0x80);
396  }
397  }
398 #endif
399  SDP_task();
400  L2CAP_task();
401  }
402 }
403 
404 void BTHID::SDP_task() {
405  switch(l2cap_sdp_state) {
406  case L2CAP_SDP_WAIT:
407  if(l2cap_check_flag(L2CAP_FLAG_CONNECTION_SDP_REQUEST)) {
408  l2cap_clear_flag(L2CAP_FLAG_CONNECTION_SDP_REQUEST); // Clear flag
409 #ifdef DEBUG_USB_HOST
410  Notify(PSTR("\r\nSDP Incoming Connection Request"), 0x80);
411 #endif
412  pBtd->l2cap_connection_response(hci_handle, identifier, sdp_dcid, sdp_scid, PENDING);
413  delay(1);
414  pBtd->l2cap_connection_response(hci_handle, identifier, sdp_dcid, sdp_scid, SUCCESSFUL);
415  identifier++;
416  delay(1);
417  pBtd->l2cap_config_request(hci_handle, identifier, sdp_scid);
418  l2cap_sdp_state = L2CAP_SDP_SUCCESS;
419  } else if(l2cap_check_flag(L2CAP_FLAG_DISCONNECT_SDP_REQUEST)) {
420  l2cap_clear_flag(L2CAP_FLAG_DISCONNECT_SDP_REQUEST); // Clear flag
421  SDPConnected = false;
422 #ifdef DEBUG_USB_HOST
423  Notify(PSTR("\r\nDisconnected SDP Channel"), 0x80);
424 #endif
425  pBtd->l2cap_disconnection_response(hci_handle, identifier, sdp_dcid, sdp_scid);
426  }
427  break;
428  case L2CAP_SDP_SUCCESS:
429  if(l2cap_check_flag(L2CAP_FLAG_CONFIG_SDP_SUCCESS)) {
430  l2cap_clear_flag(L2CAP_FLAG_CONFIG_SDP_SUCCESS); // Clear flag
431 #ifdef DEBUG_USB_HOST
432  Notify(PSTR("\r\nSDP Successfully Configured"), 0x80);
433 #endif
434  SDPConnected = true;
435  l2cap_sdp_state = L2CAP_SDP_WAIT;
436  }
437  break;
438 
439  case L2CAP_DISCONNECT_RESPONSE: // This is for both disconnection response from the RFCOMM and SDP channel if they were connected
440  if(l2cap_check_flag(L2CAP_FLAG_DISCONNECT_RESPONSE)) {
441 #ifdef DEBUG_USB_HOST
442  Notify(PSTR("\r\nDisconnected L2CAP Connection"), 0x80);
443 #endif
444  pBtd->hci_disconnect(hci_handle);
445  hci_handle = -1; // Reset handle
446  Reset();
447  }
448  break;
449  }
450 }
451 
452 void BTHID::L2CAP_task() {
453  switch(l2cap_state) {
454  /* These states are used if the HID device is the host */
455  case L2CAP_CONTROL_SUCCESS:
456  if(l2cap_check_flag(L2CAP_FLAG_CONFIG_CONTROL_SUCCESS)) {
457 #ifdef DEBUG_USB_HOST
458  Notify(PSTR("\r\nHID Control Successfully Configured"), 0x80);
459 #endif
460  setProtocol(); // Set protocol before establishing HID interrupt channel
461  l2cap_state = L2CAP_INTERRUPT_SETUP;
462  }
463  break;
464 
465  case L2CAP_INTERRUPT_SETUP:
466  if(l2cap_check_flag(L2CAP_FLAG_CONNECTION_INTERRUPT_REQUEST)) {
467 #ifdef DEBUG_USB_HOST
468  Notify(PSTR("\r\nHID Interrupt Incoming Connection Request"), 0x80);
469 #endif
470  pBtd->l2cap_connection_response(hci_handle, identifier, interrupt_dcid, interrupt_scid, PENDING);
471  delay(1);
472  pBtd->l2cap_connection_response(hci_handle, identifier, interrupt_dcid, interrupt_scid, SUCCESSFUL);
473  identifier++;
474  delay(1);
475  pBtd->l2cap_config_request(hci_handle, identifier, interrupt_scid);
476 
477  l2cap_state = L2CAP_INTERRUPT_CONFIG_REQUEST;
478  }
479  break;
480 
481  /* These states are used if the Arduino is the host */
482  case L2CAP_CONTROL_CONNECT_REQUEST:
483  if(l2cap_check_flag(L2CAP_FLAG_CONTROL_CONNECTED)) {
484 #ifdef DEBUG_USB_HOST
485  Notify(PSTR("\r\nSend HID Control Config Request"), 0x80);
486 #endif
487  identifier++;
488  pBtd->l2cap_config_request(hci_handle, identifier, control_scid);
489  l2cap_state = L2CAP_CONTROL_CONFIG_REQUEST;
490  }
491  break;
492 
493  case L2CAP_CONTROL_CONFIG_REQUEST:
494  if(l2cap_check_flag(L2CAP_FLAG_CONFIG_CONTROL_SUCCESS)) {
495  setProtocol(); // Set protocol before establishing HID interrupt channel
496  delay(1); // Short delay between commands - just to be sure
497 #ifdef DEBUG_USB_HOST
498  Notify(PSTR("\r\nSend HID Interrupt Connection Request"), 0x80);
499 #endif
500  identifier++;
501  pBtd->l2cap_connection_request(hci_handle, identifier, interrupt_dcid, HID_INTR_PSM);
502  l2cap_state = L2CAP_INTERRUPT_CONNECT_REQUEST;
503  }
504  break;
505 
506  case L2CAP_INTERRUPT_CONNECT_REQUEST:
507  if(l2cap_check_flag(L2CAP_FLAG_INTERRUPT_CONNECTED)) {
508 #ifdef DEBUG_USB_HOST
509  Notify(PSTR("\r\nSend HID Interrupt Config Request"), 0x80);
510 #endif
511  identifier++;
512  pBtd->l2cap_config_request(hci_handle, identifier, interrupt_scid);
513  l2cap_state = L2CAP_INTERRUPT_CONFIG_REQUEST;
514  }
515  break;
516 
517  case L2CAP_INTERRUPT_CONFIG_REQUEST:
518  if(l2cap_check_flag(L2CAP_FLAG_CONFIG_INTERRUPT_SUCCESS)) { // Now the HID channels is established
519 #ifdef DEBUG_USB_HOST
520  Notify(PSTR("\r\nHID Channels Established"), 0x80);
521 #endif
522  pBtd->connectToHIDDevice = false;
523  pBtd->pairWithHIDDevice = false;
524  connected = true;
525  onInit();
526  l2cap_state = L2CAP_DONE;
527  }
528  break;
529 
530  case L2CAP_DONE:
531  break;
532 
533  case L2CAP_INTERRUPT_DISCONNECT:
534  if(l2cap_check_flag(L2CAP_FLAG_DISCONNECT_INTERRUPT_RESPONSE)) {
535 #ifdef DEBUG_USB_HOST
536  Notify(PSTR("\r\nDisconnected Interrupt Channel"), 0x80);
537 #endif
538  identifier++;
539  pBtd->l2cap_disconnection_request(hci_handle, identifier, control_scid, control_dcid);
540  l2cap_state = L2CAP_CONTROL_DISCONNECT;
541  }
542  break;
543 
544  case L2CAP_CONTROL_DISCONNECT:
545  if(l2cap_check_flag(L2CAP_FLAG_DISCONNECT_CONTROL_RESPONSE)) {
546 #ifdef DEBUG_USB_HOST
547  Notify(PSTR("\r\nDisconnected Control Channel"), 0x80);
548 #endif
549  pBtd->hci_disconnect(hci_handle);
550  hci_handle = -1; // Reset handle
551  l2cap_event_flag = 0; // Reset flags
552  l2cap_state = L2CAP_WAIT;
553  }
554  break;
555  }
556 }
557 
558 void BTHID::Run() {
559  switch(l2cap_state) {
560  case L2CAP_WAIT:
561  if(pBtd->connectToHIDDevice && !pBtd->l2capConnectionClaimed && !connected && !activeConnection) {
562  pBtd->l2capConnectionClaimed = true;
563  activeConnection = true;
564 #ifdef DEBUG_USB_HOST
565  Notify(PSTR("\r\nSend HID Control Connection Request"), 0x80);
566 #endif
567  hci_handle = pBtd->hci_handle; // Store the HCI Handle for the connection
568  l2cap_event_flag = 0; // Reset flags
569  identifier = 0;
570  pBtd->l2cap_connection_request(hci_handle, identifier, control_dcid, HID_CTRL_PSM);
571  l2cap_state = L2CAP_CONTROL_CONNECT_REQUEST;
572  } else if(l2cap_check_flag(L2CAP_FLAG_CONNECTION_CONTROL_REQUEST)) {
573 #ifdef DEBUG_USB_HOST
574  Notify(PSTR("\r\nHID Control Incoming Connection Request"), 0x80);
575 #endif
576  pBtd->l2cap_connection_response(hci_handle, identifier, control_dcid, control_scid, PENDING);
577  delay(1);
578  pBtd->l2cap_connection_response(hci_handle, identifier, control_dcid, control_scid, SUCCESSFUL);
579  identifier++;
580  delay(1);
581  pBtd->l2cap_config_request(hci_handle, identifier, control_scid);
582  l2cap_state = L2CAP_CONTROL_SUCCESS;
583  }
584  break;
585  }
586 }
587 
588 void BTHID::SDP_Command(uint8_t* data, uint8_t nbytes) { // See page 223 in the Bluetooth specs
589  pBtd->L2CAP_Command(hci_handle, data, nbytes, sdp_scid[0], sdp_scid[1]);
590 }
591 
592 void BTHID::serviceNotSupported(uint8_t transactionIDHigh, uint8_t transactionIDLow) { // See page 235 in the Bluetooth specs
593  l2capoutbuf[0] = SDP_SERVICE_SEARCH_ATTRIBUTE_RESPONSE;
594  l2capoutbuf[1] = transactionIDHigh;
595  l2capoutbuf[2] = transactionIDLow;
596  l2capoutbuf[3] = 0x00; // MSB Parameter Length
597  l2capoutbuf[4] = 0x05; // LSB Parameter Length = 5
598  l2capoutbuf[5] = 0x00; // MSB AttributeListsByteCount
599  l2capoutbuf[6] = 0x02; // LSB AttributeListsByteCount = 2
600 
601  /* Attribute ID/Value Sequence: */
602  l2capoutbuf[7] = 0x35; // Data element sequence - length in next byte
603  l2capoutbuf[8] = 0x00; // Length = 0
604  l2capoutbuf[9] = 0x00; // No continuation state
605 
606  SDP_Command(l2capoutbuf, 10);
607 }
608 
609 /************************************************************/
610 /* HID Commands */
611 
612 /************************************************************/
613 void BTHID::setProtocol() {
614 #ifdef DEBUG_USB_HOST
615  Notify(PSTR("\r\nSet protocol mode: "), 0x80);
616  D_PrintHex<uint8_t > (protocolMode, 0x80);
617 #endif
618  if (protocolMode != USB_HID_BOOT_PROTOCOL && protocolMode != HID_RPT_PROTOCOL) {
619 #ifdef DEBUG_USB_HOST
620  Notify(PSTR("\r\nNot a valid protocol mode. Using Boot protocol instead."), 0x80);
621 #endif
622  protocolMode = USB_HID_BOOT_PROTOCOL; // Use Boot Protocol by default
623  }
624  uint8_t command = 0x70 | protocolMode; // Set Protocol, see Bluetooth HID specs page 33
625  pBtd->L2CAP_Command(hci_handle, &command, 1, control_scid[0], control_scid[1]);
626 }
627 
628 void BTHID::setLeds(uint8_t data) {
629  uint8_t buf[3];
630  buf[0] = 0xA2; // HID BT DATA_request (0xA0) | Report Type (Output 0x02)
631  buf[1] = 0x01; // Report ID
632  buf[2] = data;
633  pBtd->L2CAP_Command(hci_handle, buf, 3, interrupt_scid[0], interrupt_scid[1]);
634 }
L2CAP_FLAG_DISCONNECT_CONTROL_RESPONSE
#define L2CAP_FLAG_DISCONNECT_CONTROL_RESPONSE
Definition: BTD.h:149
L2CAP_FLAG_CONFIG_INTERRUPT_SUCCESS
#define L2CAP_FLAG_CONFIG_INTERRUPT_SUCCESS
Definition: BTD.h:153
L2CAP_INTERRUPT_CONFIG_REQUEST
#define L2CAP_INTERRUPT_CONFIG_REQUEST
Definition: BTD.h:125
L2CAP_INTERRUPT_SETUP
#define L2CAP_INTERRUPT_SETUP
Definition: BTD.h:123
@@ -81,7 +81,7 @@ $(function() {
SDP_SERVICE_ATTRIBUTE_REQUEST
#define SDP_SERVICE_ATTRIBUTE_REQUEST
Definition: BTD.h:198
BTHID::connected
bool connected
Definition: BTHID.h:88
L2CAP_SDP_SUCCESS
#define L2CAP_SDP_SUCCESS
Definition: BTD.h:130
-
BTHID::Run
void Run()
Definition: BTHID.cpp:548
+
BTHID::Run
void Run()
Definition: BTHID.cpp:558
BTD::btdPin
const char * btdPin
Definition: BTD.h:479
L2CAP_DONE
#define L2CAP_DONE
Definition: BTD.h:114
L2CAP_CONTROL_SUCCESS
#define L2CAP_CONTROL_SUCCESS
Definition: BTD.h:119
diff --git a/_b_t_h_i_d_8h.html b/_b_t_h_i_d_8h.html index 7fe9dd9e..883475aa 100644 --- a/_b_t_h_i_d_8h.html +++ b/_b_t_h_i_d_8h.html @@ -87,7 +87,8 @@ This graph shows which files directly or indirectly include this file:
- + +
diff --git a/_b_t_h_i_d_8h__dep__incl.map b/_b_t_h_i_d_8h__dep__incl.map index a8f40d95..9357d95b 100644 --- a/_b_t_h_i_d_8h__dep__incl.map +++ b/_b_t_h_i_d_8h__dep__incl.map @@ -1,5 +1,6 @@ - + + diff --git a/_b_t_h_i_d_8h__dep__incl.md5 b/_b_t_h_i_d_8h__dep__incl.md5 index 6a659db3..fd41a5a7 100644 --- a/_b_t_h_i_d_8h__dep__incl.md5 +++ b/_b_t_h_i_d_8h__dep__incl.md5 @@ -1 +1 @@ -f5ffabeee933ef99da0ca226df2def53 \ No newline at end of file +23a000c41dd5dd0fa67a484993db484a \ No newline at end of file diff --git a/_b_t_h_i_d_8h__dep__incl.png b/_b_t_h_i_d_8h__dep__incl.png index 2b3e98b59c5633d52a69418bb6c150154244279c..f68eb584168d5ff87c00b23d753c7672b63d8883 100644 GIT binary patch literal 7455 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 literal 6746 zcmZ`;by$?$w;e)2N|2OpP-^HJQ3)wYr9oQhlPK2S0wq1rnopC zE6t)M$M4upy3F_4O36|W)QV*}x}XurFca3|e}ZKiUinmvm$i&m_$=CHn(!n!C@5}7E;JWCZkX8fo9sU$Mw zK}o#KVO$Us6b1=OSw*FDEjO@o8!8!lu+(dDy!mH^p6^3GLoSdv|Y=x+~gxJ_FxYeNZ_JqLE?o6}N6j3hKX=8rQV_);GDAKdDrG(KI zU(aZPn5_g7ZTbFG2&AL4bF@sCAKIg#p%GMF4c$i7;syr?SJ&6e+uQR%=25k8^}f0m z?F&HGH#YhUor0eR^(HVb{VsW_S7UyMm;r`IPyf-QUNx#TPY@FWvc9#|+1?I`h=`yT zwkCnWV9v*z+K`~)Vh%z=LQ_*yh`+x-ghW~t3WX%}CM(T7fBw80f#``KqWuZ1kW)}- zK)aI`JmNy#uW2;mYjWQzuDgCaoXP&;WcaJg63+DWG}LYN1)YSe+_OYdr075PcOiKN z1(*~R6kPoLy~&*F&hzaUFERv+R2_tkCQF^>TD>lgO1d17NF)gd>wgii7up1i!g z!)^kJ_oqx=3`k>ha|~>3Y%C%-*Q9yU`kqat&EDc7CND4Vi*zUkL_D~9~uWpHHX^|ZrGDTg^7e_V|6BCNl5lK87itBwK1^5I6qxE*W5cm4=i3vSwT3Qv@ zxb~Po0XF9H>MDz*B#pPXw_deruyfX4E1LM^p8w-q?QA_OGQNmK*J3%NJU3S zXklR?nVZIiIb)m#upIm!EVCQR;AujX5n&_+5D;f(ISh~$nJ7#RI6Jkg^+@R@Z!R#?%0=#|Mj<^ znwlDWOqRks|JX~Fj7X!))YbhPKes_KJABVue!9CdYH>^sAby6CqfZ`wPTpl^QEbzEPmSdj?_6%@F> z_}D}yA;JHB$%UB&ubn#Y^Ed^oLTk9@ry(<|W6JW1Ihh28Cc&+=528`UmSx4eGlR0` zi&cusO)*DDxFmSgUNAme+fCatKWVDf)yMl+rvdB8BL5r6*Jj3!uWoHmUnVC^HHgXR zHpK9}#)L3&uCW)Z5y>klQD9>R?|TzRVi6HBl$P3JK&fdq=c@vDaP91bVyVp{1T1*+ zs?^8zneb)%b&UT>(O&3f+*|4hH*vYXbRZ`u4;@*{N9Zt}$js2t7_qVWg)qzd)R)aI zF5(l?o;bbI9S`YTVB)bST^**KsT8Gc_LCrsq1=&ms8}u;T5)Y(a?vz4CU84sXnbcw zBrH6s8^a-|{LTT}{X?z^Hg_2lkFgJgQ|w&hN4{q(7dfd3a437+%0D+fNlvL(_(meJ2NvOA_Xv^N=6 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 R@MjT3NnTB^QpPmozW`C^52XMA diff --git a/_b_t_h_i_d_8h_source.html b/_b_t_h_i_d_8h_source.html index cc0f4445..7bbc038c 100644 --- a/_b_t_h_i_d_8h_source.html +++ b/_b_t_h_i_d_8h_source.html @@ -70,7 +70,7 @@ $(function() {
BTD
Definition: BTD.h:221
BTHID::interrupt_scid
uint8_t interrupt_scid[2]
Definition: BTHID.h:149
BTHID::connected
bool connected
Definition: BTHID.h:88
-
BTHID::Run
void Run()
Definition: BTHID.cpp:548
+
BTHID::Run
void Run()
Definition: BTHID.cpp:558
BTHID::ResetBTHID
virtual void ResetBTHID()
Definition: BTHID.h:140
BTHID::Reset
void Reset()
Definition: BTHID.cpp:43
BTHID::control_scid
uint8_t control_scid[2]
Definition: BTHID.h:146
diff --git a/_p_s3_b_t_8cpp_source.html b/_p_s3_b_t_8cpp_source.html index 960ac8ec..8dfcf971 100644 --- a/_p_s3_b_t_8cpp_source.html +++ b/_p_s3_b_t_8cpp_source.html @@ -86,20 +86,20 @@ $(function() {
MoveCharging
Definition: PS3Enums.h:127
CableRumble
Definition: PS3Enums.h:135
BTD::hci_version
uint8_t hci_version
Definition: BTD.h:494
- - + +
BTD::pairWithWii
bool pairWithWii
Definition: BTD.h:506
BluetoothService::identifier
uint8_t identifier
Definition: BTD.h:655
Bluetooth
Definition: PS3Enums.h:138
PS3BT::getTemperature
String getTemperature()
Definition: PS3BT.cpp:141
-
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:163
+
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:170
PS3BT::moveSetRumble
void moveSetRumble(uint8_t rumble)
Definition: PS3BT.cpp:617
TURN_ON_LED
#define TURN_ON_LED
Definition: BTD.h:139
- - + +
PS3BT::printStatusString
void printStatusString()
Definition: PS3BT.cpp:160
PS3BT::setAllOff
void setAllOff()
Definition: PS3BT.cpp:519
- +
L2CAP_DONE
#define L2CAP_DONE
Definition: BTD.h:114
Shutdown
Definition: PS3Enums.h:121
Charging
Definition: PS3Enums.h:119
@@ -109,9 +109,9 @@ $(function() {
HID_BUFFERSIZE
#define HID_BUFFERSIZE
Definition: PS3BT.h:24
PS3BT::Reset
void Reset()
Definition: PS3BT.cpp:204
pgm_read_byte
#define pgm_read_byte(addr)
Definition: version_helper.h:161
- +
BTD::remote_name
char remote_name[30]
Definition: BTD.h:488
- +
PS3_BUTTONS
const uint32_t PS3_BUTTONS[]
Definition: PS3Enums.h:62
PS3BT::getButtonPress
bool getButtonPress(ButtonEnum b)
Definition: PS3BT.cpp:49
LEDEnum
LEDEnum
Definition: controllerEnums.h:31
@@ -121,10 +121,10 @@ $(function() {
RumbleEnum
RumbleEnum
Definition: controllerEnums.h:72
USB_HOST_SERIAL
#define USB_HOST_SERIAL
Definition: settings.h:49
HID_CTRL_PSM
#define HID_CTRL_PSM
Definition: BTD.h:192
- +
Dying
Definition: PS3Enums.h:122
Low
Definition: PS3Enums.h:123
- +
BTD::connectToWii
bool connectToWii
Definition: BTD.h:500
PS3BT.h
PS3BT::getAnalogHat
uint8_t getAnalogHat(AnalogHatEnum a)
Definition: PS3BT.cpp:64
@@ -133,12 +133,12 @@ $(function() {
BTD::hci_disconnect
void hci_disconnect(uint16_t handle)
Definition: BTD.cpp:1399
L2CAP_FLAG_DISCONNECT_INTERRUPT_RESPONSE
#define L2CAP_FLAG_DISCONNECT_INTERRUPT_RESPONSE
Definition: BTD.h:155
- +
ButtonEnum
ButtonEnum
Definition: controllerEnums.h:78
PS3BT::moveSetBulb
void moveSetBulb(uint8_t r, uint8_t g, uint8_t b)
Definition: PS3BT.cpp:604
PS3BT::PS3MoveConnected
bool PS3MoveConnected
Definition: PS3BT.h:182
BTD::my_bdaddr
uint8_t my_bdaddr[6]
Definition: BTD.h:482
- +
PS3BT::setRumbleOn
void setRumbleOn(RumbleEnum mode)
Definition: PS3BT.cpp:540
BluetoothService::pFuncOnInit
void(* pFuncOnInit)(void)
Definition: BTD.h:643
PS3BT::get9DOFValues
float get9DOFValues(SensorEnum a)
Definition: PS3BT.cpp:112
@@ -154,13 +154,13 @@ $(function() {
ColorsEnum
ColorsEnum
Definition: controllerEnums.h:50
BluetoothService::pBtd
BTD * pBtd
Definition: BTD.h:646
BULK_MAXPKTSIZE
#define BULK_MAXPKTSIZE
Definition: BTD.h:37
- +
HID_INTR_PSM
#define HID_INTR_PSM
Definition: BTD.h:193
PS3_ANALOG_BUTTONS
const uint8_t PS3_ANALOG_BUTTONS[]
Definition: PS3Enums.h:92
- +
BTD::l2capConnectionClaimed
bool l2capConnectionClaimed
Definition: BTD.h:470
-
AngleEnum
AngleEnum
Definition: controllerEnums.h:211
+
AngleEnum
AngleEnum
Definition: controllerEnums.h:218
PS3_ENABLE_SIXAXIS
#define PS3_ENABLE_SIXAXIS
Definition: BTD.h:140
MoveShutdown
Definition: PS3Enums.h:129
L2CAP_CMD_DISCONNECT_RESPONSE
#define L2CAP_CMD_DISCONNECT_RESPONSE
Definition: BTD.h:181
@@ -186,15 +186,15 @@ $(function() {
l2cap_set_flag
#define l2cap_set_flag(flag)
Definition: BTD.h:171
BTD::l2cap_config_request
void l2cap_config_request(uint16_t handle, uint8_t rxid, uint8_t *dcid)
Definition: BTD.cpp:1505
L2CAP_FLAG_CONFIG_CONTROL_SUCCESS
#define L2CAP_FLAG_CONFIG_CONTROL_SUCCESS
Definition: BTD.h:147
-
SensorEnum
SensorEnum
Definition: controllerEnums.h:178
+
SensorEnum
SensorEnum
Definition: controllerEnums.h:185
MoveNotCharging
Definition: PS3Enums.h:128
L2CAP_CMD_CONNECTION_REQUEST
#define L2CAP_CMD_CONNECTION_REQUEST
Definition: BTD.h:176
PS3BT::getAnalogButton
uint8_t getAnalogButton(ButtonEnum a)
Definition: PS3BT.cpp:60
- +
PS3BT::getAngle
float getAngle(AngleEnum a)
Definition: PS3BT.cpp:85
PS3BT::setLedRaw
void setLedRaw(uint8_t value)
Definition: PS3BT.cpp:559
PS3BT::PS3BT
PS3BT(BTD *pBtd, uint8_t btadr5=0, uint8_t btadr4=0, uint8_t btadr3=0, uint8_t btadr2=0, uint8_t btadr1=0, uint8_t btadr0=0)
Definition: PS3BT.cpp:23
- +
BluetoothService::checkHciHandle
bool checkHciHandle(uint8_t *buf, uint16_t handle)
Definition: BTD.h:638
PS3BT::onInit
void onInit()
Definition: PS3BT.cpp:628
Full
Definition: PS3Enums.h:125
diff --git a/_p_s3_b_t_8h_source.html b/_p_s3_b_t_8h_source.html index 7cea80c8..b9159374 100644 --- a/_p_s3_b_t_8h_source.html +++ b/_p_s3_b_t_8h_source.html @@ -69,7 +69,7 @@ $(function() {
BTD
Definition: BTD.h:221
PS3BT::setLedOn
void setLedOn(LEDEnum a)
Definition: PS3BT.cpp:569
PS3BT::getTemperature
String getTemperature()
Definition: PS3BT.cpp:141
-
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:163
+
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:170
PS3BT::moveSetRumble
void moveSetRumble(uint8_t rumble)
Definition: PS3BT.cpp:617
PS3BT::printStatusString
void printStatusString()
Definition: PS3BT.cpp:160
PS3BT::setAllOff
void setAllOff()
Definition: PS3BT.cpp:519
@@ -93,12 +93,12 @@ $(function() {
ColorsEnum
ColorsEnum
Definition: controllerEnums.h:50
BluetoothService::pBtd
BTD * pBtd
Definition: BTD.h:646
BULK_MAXPKTSIZE
#define BULK_MAXPKTSIZE
Definition: BTD.h:37
-
AngleEnum
AngleEnum
Definition: controllerEnums.h:211
+
AngleEnum
AngleEnum
Definition: controllerEnums.h:218
PS3BT::ACLData
void ACLData(uint8_t *ACLData)
Definition: PS3BT.cpp:224
PS3BT::setLedOff
void setLedOff()
Definition: PS3BT.h:138
PS3BT::setLedToggle
void setLedToggle(LEDEnum a)
Definition: PS3BT.cpp:578
PS3BT::disconnect
void disconnect()
Definition: PS3BT.cpp:217
-
SensorEnum
SensorEnum
Definition: controllerEnums.h:178
+
SensorEnum
SensorEnum
Definition: controllerEnums.h:185
BTD.h
PS3BT::getAnalogButton
uint8_t getAnalogButton(ButtonEnum a)
Definition: PS3BT.cpp:60
PS3BT::getAngle
float getAngle(AngleEnum a)
Definition: PS3BT.cpp:85
diff --git a/_p_s3_u_s_b_8cpp_source.html b/_p_s3_u_s_b_8cpp_source.html index 35e51af7..4d8ed597 100644 --- a/_p_s3_u_s_b_8cpp_source.html +++ b/_p_s3_u_s_b_8cpp_source.html @@ -90,8 +90,8 @@ $(function() {
PS3_OUTPUT_PIPE
#define PS3_OUTPUT_PIPE
Definition: PS3USB.h:30
NotifyFail
#define NotifyFail(...)
Definition: message.h:62
PS3USB::PS3MoveConnected
bool PS3MoveConnected
Definition: PS3USB.h:262
-
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:163
- +
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:170
+
USB::setConf
uint8_t setConf(uint8_t addr, uint8_t ep, uint8_t conf_value)
Definition: Usb.cpp:840
Shutdown
Definition: PS3Enums.h:121
Charging
Definition: PS3Enums.h:119
@@ -103,7 +103,7 @@ $(function() {
pgm_read_byte
#define pgm_read_byte(addr)
Definition: version_helper.h:161
NotifyFailGetDevDescr
#define NotifyFailGetDevDescr(...)
Definition: message.h:57
PS3USB::getAnalogButton
uint8_t getAnalogButton(ButtonEnum a)
Definition: PS3USB.cpp:327
- +
PS3USB::getSensor
uint16_t getSensor(SensorEnum a)
Definition: PS3USB.cpp:335
USB::setEpInfoEntry
uint8_t setEpInfoEntry(uint8_t addr, uint8_t epcount, EpInfo *eprecord_ptr)
Definition: Usb.cpp:64
PS3USB::setRumbleOff
void setRumbleOff()
Definition: PS3USB.cpp:410
@@ -133,7 +133,7 @@ $(function() {
PS3USB::printStatusString
void printStatusString()
Definition: PS3USB.cpp:364
PS3USB::setAllOff
void setAllOff()
Definition: PS3USB.cpp:403
USB::outTransfer
uint8_t outTransfer(uint8_t addr, uint8_t ep, uint16_t nbytes, uint8_t *data)
Definition: Usb.cpp:303
- +
ButtonEnum
ButtonEnum
Definition: controllerEnums.h:78
PS3_LEDS
const uint8_t PS3_LEDS[]
Definition: PS3Enums.h:43
AddressPool::AllocAddress
virtual uint8_t AllocAddress(uint8_t parent, bool is_hub=false, uint8_t port=0)=0
@@ -147,7 +147,7 @@ $(function() {
PS3_ANALOG_BUTTONS
const uint8_t PS3_ANALOG_BUTTONS[]
Definition: PS3Enums.h:92
USB_NAK_NOWAIT
#define USB_NAK_NOWAIT
Definition: address.h:36
-
AngleEnum
AngleEnum
Definition: controllerEnums.h:211
+
AngleEnum
AngleEnum
Definition: controllerEnums.h:218
USB_ERROR_ADDRESS_NOT_FOUND_IN_POOL
#define USB_ERROR_ADDRESS_NOT_FOUND_IN_POOL
Definition: UsbCore.h:95
PS3_PID
#define PS3_PID
Definition: BTD.h:26
PS3NAVIGATION_PID
#define PS3NAVIGATION_PID
Definition: BTD.h:27
@@ -174,12 +174,12 @@ $(function() {
bmREQ_HID_IN
#define bmREQ_HID_IN
Definition: usbhid.h:64
PS3USB::getAngle
float getAngle(AngleEnum a)
Definition: PS3USB.cpp:339
-
SensorEnum
SensorEnum
Definition: controllerEnums.h:178
+
SensorEnum
SensorEnum
Definition: controllerEnums.h:185
HID_REQUEST_SET_REPORT
#define HID_REQUEST_SET_REPORT
Definition: usbhid.h:72
USB::RegisterDeviceClass
uint8_t RegisterDeviceClass(USBDeviceConfig *pdev)
Definition: UsbCore.h:230
NotifyFailSetConfDescr
#define NotifyFailSetConfDescr(...)
Definition: message.h:60
HID_REQUEST_GET_REPORT
#define HID_REQUEST_GET_REPORT
Definition: usbhid.h:69
- +
PS3USB::PS3USB
PS3USB(USB *pUsb, uint8_t btadr5=0, uint8_t btadr4=0, uint8_t btadr3=0, uint8_t btadr2=0, uint8_t btadr1=0, uint8_t btadr0=0)
Definition: PS3USB.cpp:23
PS3USB::getMoveCalibration
void getMoveCalibration(uint8_t *data)
Definition: PS3USB.cpp:553
Full
Definition: PS3Enums.h:125
diff --git a/_p_s3_u_s_b_8h_source.html b/_p_s3_u_s_b_8h_source.html index 3899d50d..cc03bb87 100644 --- a/_p_s3_u_s_b_8h_source.html +++ b/_p_s3_u_s_b_8h_source.html @@ -72,7 +72,7 @@ $(function() {
PS3USB::Release
uint8_t Release()
Definition: PS3USB.cpp:262
PS3USB::getButtonPress
bool getButtonPress(ButtonEnum b)
Definition: PS3USB.cpp:316
PS3USB::PS3MoveConnected
bool PS3MoveConnected
Definition: PS3USB.h:262
-
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:163
+
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:170
StatusEnum
StatusEnum
Definition: PS3Enums.h:113
PS3USB::getMoveBdaddr
void getMoveBdaddr(uint8_t *bdaddr)
Definition: PS3USB.cpp:543
@@ -99,7 +99,7 @@ $(function() {
PS3USB::getAnalogHat
uint8_t getAnalogHat(AnalogHatEnum a)
Definition: PS3USB.cpp:331
PS3USB::pUsb
USB * pUsb
Definition: PS3USB.h:268
ColorsEnum
ColorsEnum
Definition: controllerEnums.h:50
-
AngleEnum
AngleEnum
Definition: controllerEnums.h:211
+
AngleEnum
AngleEnum
Definition: controllerEnums.h:218
PS3USB::moveSetRumble
void moveSetRumble(uint8_t rumble)
Definition: PS3USB.cpp:517
PS3USB::Poll
uint8_t Poll()
Definition: PS3USB.cpp:272
PS3MOVE_PID
#define PS3MOVE_PID
Definition: PS3USB.h:37
@@ -114,7 +114,7 @@ $(function() {
PS3USB::setMoveBdaddr
void setMoveBdaddr(uint8_t *bdaddr)
Definition: PS3USB.cpp:527
USB
Definition: UsbCore.h:210
PS3USB::getAngle
float getAngle(AngleEnum a)
Definition: PS3USB.cpp:339
-
SensorEnum
SensorEnum
Definition: controllerEnums.h:178
+
SensorEnum
SensorEnum
Definition: controllerEnums.h:185
PS3USB::PS3USB
PS3USB(USB *pUsb, uint8_t btadr5=0, uint8_t btadr4=0, uint8_t btadr3=0, uint8_t btadr2=0, uint8_t btadr1=0, uint8_t btadr0=0)
Definition: PS3USB.cpp:23
PS3USB::getMoveCalibration
void getMoveCalibration(uint8_t *data)
Definition: PS3USB.cpp:553
PS3USB::getStatus
bool getStatus(StatusEnum c)
Definition: PS3USB.cpp:360
diff --git a/_p_s4_parser_8cpp.html b/_p_s4_parser_8cpp.html index 9a1f433f..2cd7cd32 100644 --- a/_p_s4_parser_8cpp.html +++ b/_p_s4_parser_8cpp.html @@ -93,16 +93,27 @@ Enumerations DPAD_LEFT_UP = 0x7,
  DPAD_OFF = 0x8, +DPAD_UP = 0x0, +DPAD_UP_RIGHT = 0x1, +DPAD_RIGHT = 0x2, +
+  DPAD_RIGHT_DOWN = 0x3, +DPAD_DOWN = 0x4, +DPAD_DOWN_LEFT = 0x5, +DPAD_LEFT = 0x6, +
+  DPAD_LEFT_UP = 0x7, +DPAD_OFF = 0x8, DPAD_OFF = 0x0, DPAD_UP = 0x1, -DPAD_UP_RIGHT = 0x2,
-  DPAD_RIGHT = 0x3, +  DPAD_UP_RIGHT = 0x2, +DPAD_RIGHT = 0x3, DPAD_RIGHT_DOWN = 0x4, DPAD_DOWN = 0x5, -DPAD_DOWN_LEFT = 0x6,
-  DPAD_LEFT = 0x7, +  DPAD_DOWN_LEFT = 0x6, +DPAD_LEFT = 0x7, DPAD_LEFT_UP = 0x8
} @@ -130,6 +141,15 @@ Enumerations DPAD_LEFT  DPAD_LEFT_UP  DPAD_OFF  +DPAD_UP  +DPAD_UP_RIGHT  +DPAD_RIGHT  +DPAD_RIGHT_DOWN  +DPAD_DOWN  +DPAD_DOWN_LEFT  +DPAD_LEFT  +DPAD_LEFT_UP  +DPAD_OFF  DPAD_OFF  DPAD_UP  DPAD_UP_RIGHT  diff --git a/_p_s4_parser_8cpp_source.html b/_p_s4_parser_8cpp_source.html index d4b23eea..c9d3f210 100644 --- a/_p_s4_parser_8cpp_source.html +++ b/_p_s4_parser_8cpp_source.html @@ -70,7 +70,7 @@ $(function() {
PS4Data::hatValue
uint8_t hatValue[4]
Definition: PS4Parser.h:94
PS4Output::b
uint8_t b
Definition: PS4Parser.h:118
PS4Parser::getButtonPress
bool getButtonPress(ButtonEnum b)
Definition: PS4Parser.cpp:50
-
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:163
+
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:170
DPADEnum
DPADEnum
Definition: PS4Parser.cpp:20
DPAD_RIGHT_DOWN
Definition: PS4Parser.cpp:24
touchpadXY::touching
uint8_t touching
Definition: PS4Parser.h:78
diff --git a/_p_s4_parser_8h_source.html b/_p_s4_parser_8h_source.html index df4083a6..a226603b 100644 --- a/_p_s4_parser_8h_source.html +++ b/_p_s4_parser_8h_source.html @@ -67,16 +67,16 @@ $(function() {
PS4Buttons::val
uint32_t val
Definition: PS4Parser.h:71
PS4Parser::getY
uint16_t getY(uint8_t finger=0, uint8_t xyId=0)
Definition: PS4Parser.h:182
PS4Status::usb
uint8_t usb
Definition: PS4Parser.h:86
- +
PS4Buttons::r1
uint8_t r1
Definition: PS4Parser.h:59
PS4Data::status
PS4Status status
Definition: PS4Parser.h:104
PS4Parser::setLed
void setLed(uint8_t r, uint8_t g, uint8_t b)
Definition: PS4Parser.h:320
PS4Status::mic
uint8_t mic
Definition: PS4Parser.h:88
-
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:163
+
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:170
PS4Buttons::reportCounter
uint8_t reportCounter
Definition: PS4Parser.h:69
- +
PS4Parser::setLed
void setLed(ColorsEnum color)
Definition: PS4Parser.h:331
PS4Status::audio
uint8_t audio
Definition: PS4Parser.h:87
PS4Parser::setRumbleOn
void setRumbleOn(uint8_t bigRumble, uint8_t smallRumble)
Definition: PS4Parser.h:305
@@ -85,7 +85,7 @@ $(function() {
PS4Parser::getSensor
int16_t getSensor(SensorEnum s)
Definition: PS4Parser.h:227
PS4Output::flashOn
uint8_t flashOn
Definition: PS4Parser.h:119
- +
PS4Buttons::share
uint8_t share
Definition: PS4Parser.h:62
PS4Status::unknown
uint8_t unknown
Definition: PS4Parser.h:89
@@ -105,7 +105,7 @@ $(function() {
touchpadXY::y
uint16_t y
Definition: PS4Parser.h:80
PS4_BUTTONS
const uint8_t PS4_BUTTONS[]
Definition: PS4Parser.h:25
- +
ButtonEnum
ButtonEnum
Definition: controllerEnums.h:78
PS4Output::r
uint8_t r
Definition: PS4Parser.h:118
PS4Parser::setRumbleOff
void setRumbleOff()
Definition: PS4Parser.h:285
@@ -118,8 +118,8 @@ $(function() {
PS4Buttons::dpad
uint8_t dpad
Definition: PS4Parser.h:52
ColorsEnum
ColorsEnum
Definition: controllerEnums.h:50
PS4Data::gyroZ
int16_t gyroZ
Definition: PS4Parser.h:100
- -
AngleEnum
AngleEnum
Definition: controllerEnums.h:211
+ +
AngleEnum
AngleEnum
Definition: controllerEnums.h:218
PS4Parser::getX
uint16_t getX(uint8_t finger=0, uint8_t xyId=0)
Definition: PS4Parser.h:170
@@ -133,13 +133,13 @@ $(function() {
PS4Status::battery
uint8_t battery
Definition: PS4Parser.h:85
PS4Buttons::l3
uint8_t l3
Definition: PS4Parser.h:64
PS4Data::btn
PS4Buttons btn
Definition: PS4Parser.h:95
-
SensorEnum
SensorEnum
Definition: controllerEnums.h:178
+
SensorEnum
SensorEnum
Definition: controllerEnums.h:185
PS4Buttons::circle
uint8_t circle
Definition: PS4Parser.h:55
touchpadXY::x
uint16_t x
Definition: PS4Parser.h:79
PS4Data::accZ
int16_t accZ
Definition: PS4Parser.h:101
- +
PS4Parser::setLedFlash
void setLedFlash(uint8_t flashOn, uint8_t flashOff)
Definition: PS4Parser.h:340
- +
PS4Parser::getUsbStatus
bool getUsbStatus()
Definition: PS4Parser.h:258
PS4Parser::getAudioStatus
bool getAudioStatus()
Definition: PS4Parser.h:266
diff --git a/_p_s5_b_t_8h.html b/_p_s5_b_t_8h.html new file mode 100644 index 00000000..36d586e0 --- /dev/null +++ b/_p_s5_b_t_8h.html @@ -0,0 +1,149 @@ + + + + + + + +USB Host Shield 2.0: PS5BT.h File Reference + + + + + + + + + + +
+
+ + + + + + +
+
USB Host Shield 2.0 +
+
+
+ + + + + + + + +
+
+ + +
+ +
+ +
+
+
+Classes | +Macros | +Variables
+
+
PS5BT.h File Reference
+
+
+
#include "BTHID.h"
+#include "PS5Parser.h"
+
+Include dependency graph for PS5BT.h:
+
+
+ + + + + + + + + + + +
+
+

Go to the source code of this file.

+ + + + +

+Classes

class  PS5BT
 
+ + + +

+Macros

#define CRC32_POLY_LE   0xedb88320
 
+ + + +

+Variables

const uint32_t crc32_table []
 
+

Macro Definition Documentation

+ +

◆ CRC32_POLY_LE

+ +
+
+ + + + +
#define CRC32_POLY_LE   0xedb88320
+
+ +

Definition at line 80 of file PS5BT.h.

+ +
+
+

Variable Documentation

+ +

◆ crc32_table

+ +
+
+ + + + +
const uint32_t crc32_table[]
+
+

Generated from the standard Ethernet CRC-32 polynomial: x^32+x^26+x^23+x^22+x^16+x^12+x^11+x^10+x^8+x^7+x^5+x^4+x^2+x^1+x^0 Source: http://www.opensource.apple.com/source/xnu/xnu-1456.1.26/bsd/libkern/crc32.c

+ +

Definition at line 29 of file PS5BT.h.

+ +
+
+
+ +
+Generated by   +doxygen + 1.8.13 +
+ + diff --git a/_p_s5_b_t_8h__incl.map b/_p_s5_b_t_8h__incl.map new file mode 100644 index 00000000..2f631df2 --- /dev/null +++ b/_p_s5_b_t_8h__incl.map @@ -0,0 +1,11 @@ + + + + + + + + + + + diff --git a/_p_s5_b_t_8h__incl.md5 b/_p_s5_b_t_8h__incl.md5 new file mode 100644 index 00000000..96eb877c --- /dev/null +++ b/_p_s5_b_t_8h__incl.md5 @@ -0,0 +1 @@ +1e5d5d372677845ed1b1074bd58a0189 \ No newline at end of file diff --git a/_p_s5_b_t_8h__incl.png b/_p_s5_b_t_8h__incl.png new file mode 100644 index 0000000000000000000000000000000000000000..ba671d7d74055c4f8ce8397a2f5b323639aa9b17 GIT binary patch literal 30714 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 + + + + + + +USB Host Shield 2.0: PS5BT.h Source File + + + + + + + + + + +
+
+ + + + + + +
+
USB Host Shield 2.0 +
+
+
+ + + + + + + +
+ +
+
+ + +
+ +
+ +
+
+
PS5BT.h
+
+
+Go to the documentation of this file.
1 /* Copyright (C) 2021 Kristian Sloth Lauszus. All rights reserved.
2 
3  This software may be distributed and modified under the terms of the GNU
4  General Public License version 2 (GPL2) as published by the Free Software
5  Foundation and appearing in the file GPL2.TXT included in the packaging of
6  this file. Please note that GPL2 Section 2[b] requires that all works based
7  on this software must also be made publicly available under the terms of
8  the GPL2 ("Copyleft").
9 
10  Contact information
11  -------------------
12 
13  Kristian Sloth Lauszus
14  Web : https://lauszus.com
15  e-mail : lauszus@gmail.com
16  */
17 
18 #ifndef _ps5bt_h_
19 #define _ps5bt_h_
20 
21 #include "BTHID.h"
22 #include "PS5Parser.h"
23 
29 const uint32_t crc32_table[] PROGMEM = {
30  0x00000000, 0x77073096, 0xee0e612c, 0x990951ba, 0x076dc419, 0x706af48f,
31  0xe963a535, 0x9e6495a3, 0x0edb8832, 0x79dcb8a4, 0xe0d5e91e, 0x97d2d988,
32  0x09b64c2b, 0x7eb17cbd, 0xe7b82d07, 0x90bf1d91, 0x1db71064, 0x6ab020f2,
33  0xf3b97148, 0x84be41de, 0x1adad47d, 0x6ddde4eb, 0xf4d4b551, 0x83d385c7,
34  0x136c9856, 0x646ba8c0, 0xfd62f97a, 0x8a65c9ec, 0x14015c4f, 0x63066cd9,
35  0xfa0f3d63, 0x8d080df5, 0x3b6e20c8, 0x4c69105e, 0xd56041e4, 0xa2677172,
36  0x3c03e4d1, 0x4b04d447, 0xd20d85fd, 0xa50ab56b, 0x35b5a8fa, 0x42b2986c,
37  0xdbbbc9d6, 0xacbcf940, 0x32d86ce3, 0x45df5c75, 0xdcd60dcf, 0xabd13d59,
38  0x26d930ac, 0x51de003a, 0xc8d75180, 0xbfd06116, 0x21b4f4b5, 0x56b3c423,
39  0xcfba9599, 0xb8bda50f, 0x2802b89e, 0x5f058808, 0xc60cd9b2, 0xb10be924,
40  0x2f6f7c87, 0x58684c11, 0xc1611dab, 0xb6662d3d, 0x76dc4190, 0x01db7106,
41  0x98d220bc, 0xefd5102a, 0x71b18589, 0x06b6b51f, 0x9fbfe4a5, 0xe8b8d433,
42  0x7807c9a2, 0x0f00f934, 0x9609a88e, 0xe10e9818, 0x7f6a0dbb, 0x086d3d2d,
43  0x91646c97, 0xe6635c01, 0x6b6b51f4, 0x1c6c6162, 0x856530d8, 0xf262004e,
44  0x6c0695ed, 0x1b01a57b, 0x8208f4c1, 0xf50fc457, 0x65b0d9c6, 0x12b7e950,
45  0x8bbeb8ea, 0xfcb9887c, 0x62dd1ddf, 0x15da2d49, 0x8cd37cf3, 0xfbd44c65,
46  0x4db26158, 0x3ab551ce, 0xa3bc0074, 0xd4bb30e2, 0x4adfa541, 0x3dd895d7,
47  0xa4d1c46d, 0xd3d6f4fb, 0x4369e96a, 0x346ed9fc, 0xad678846, 0xda60b8d0,
48  0x44042d73, 0x33031de5, 0xaa0a4c5f, 0xdd0d7cc9, 0x5005713c, 0x270241aa,
49  0xbe0b1010, 0xc90c2086, 0x5768b525, 0x206f85b3, 0xb966d409, 0xce61e49f,
50  0x5edef90e, 0x29d9c998, 0xb0d09822, 0xc7d7a8b4, 0x59b33d17, 0x2eb40d81,
51  0xb7bd5c3b, 0xc0ba6cad, 0xedb88320, 0x9abfb3b6, 0x03b6e20c, 0x74b1d29a,
52  0xead54739, 0x9dd277af, 0x04db2615, 0x73dc1683, 0xe3630b12, 0x94643b84,
53  0x0d6d6a3e, 0x7a6a5aa8, 0xe40ecf0b, 0x9309ff9d, 0x0a00ae27, 0x7d079eb1,
54  0xf00f9344, 0x8708a3d2, 0x1e01f268, 0x6906c2fe, 0xf762575d, 0x806567cb,
55  0x196c3671, 0x6e6b06e7, 0xfed41b76, 0x89d32be0, 0x10da7a5a, 0x67dd4acc,
56  0xf9b9df6f, 0x8ebeeff9, 0x17b7be43, 0x60b08ed5, 0xd6d6a3e8, 0xa1d1937e,
57  0x38d8c2c4, 0x4fdff252, 0xd1bb67f1, 0xa6bc5767, 0x3fb506dd, 0x48b2364b,
58  0xd80d2bda, 0xaf0a1b4c, 0x36034af6, 0x41047a60, 0xdf60efc3, 0xa867df55,
59  0x316e8eef, 0x4669be79, 0xcb61b38c, 0xbc66831a, 0x256fd2a0, 0x5268e236,
60  0xcc0c7795, 0xbb0b4703, 0x220216b9, 0x5505262f, 0xc5ba3bbe, 0xb2bd0b28,
61  0x2bb45a92, 0x5cb36a04, 0xc2d7ffa7, 0xb5d0cf31, 0x2cd99e8b, 0x5bdeae1d,
62  0x9b64c2b0, 0xec63f226, 0x756aa39c, 0x026d930a, 0x9c0906a9, 0xeb0e363f,
63  0x72076785, 0x05005713, 0x95bf4a82, 0xe2b87a14, 0x7bb12bae, 0x0cb61b38,
64  0x92d28e9b, 0xe5d5be0d, 0x7cdcefb7, 0x0bdbdf21, 0x86d3d2d4, 0xf1d4e242,
65  0x68ddb3f8, 0x1fda836e, 0x81be16cd, 0xf6b9265b, 0x6fb077e1, 0x18b74777,
66  0x88085ae6, 0xff0f6a70, 0x66063bca, 0x11010b5c, 0x8f659eff, 0xf862ae69,
67  0x616bffd3, 0x166ccf45, 0xa00ae278, 0xd70dd2ee, 0x4e048354, 0x3903b3c2,
68  0xa7672661, 0xd06016f7, 0x4969474d, 0x3e6e77db, 0xaed16a4a, 0xd9d65adc,
69  0x40df0b66, 0x37d83bf0, 0xa9bcae53, 0xdebb9ec5, 0x47b2cf7f, 0x30b5ffe9,
70  0xbdbdf21c, 0xcabac28a, 0x53b39330, 0x24b4a3a6, 0xbad03605, 0xcdd70693,
71  0x54de5729, 0x23d967bf, 0xb3667a2e, 0xc4614ab8, 0x5d681b02, 0x2a6f2b94,
72  0xb40bbe37, 0xc30c8ea1, 0x5a05df1b, 0x2d02ef8d
73 };
74 
75 /*
76  * There are multiple 16-bit CRC polynomials in common use, but this is
77  * *the* standard CRC-32 polynomial, first popularized by Ethernet.
78  * x^32+x^26+x^23+x^22+x^16+x^12+x^11+x^10+x^8+x^7+x^5+x^4+x^2+x^1+x^0
79  */
80 #define CRC32_POLY_LE 0xedb88320
81 
82 static inline uint32_t crc32_le_generic(uint32_t crc, uint8_t const *p, size_t len, uint32_t polynomial) {
83  // Source: https://github.com/torvalds/linux/blob/c4cf498dc0241fa2d758dba177634268446afb06/lib/crc32.c
84  int i;
85  while (len--) {
86  crc ^= *p++;
87  for (i = 0; i < 8; i++)
88  crc = (crc >> 1) ^ ((crc & 1) ? polynomial : 0);
89  }
90  return crc;
91 }
92 
93 static inline uint32_t crc32(uint32_t crc, const void *buf, size_t size) {
94 #if 1 // Use a table, as it's faster, but takes up more space
95  // Inspired by: http://www.opensource.apple.com/source/xnu/xnu-1456.1.26/bsd/libkern/crc32.c
96  const uint8_t *p = (const uint8_t*)buf;
97  while (size--)
98  crc = pgm_read_dword(&crc32_table[*p++ ^ (crc & 0xFF)]) ^ (crc >> 8);
99  return crc;
100 #else // Can be used to save flash, but is slower
101  return crc32_le_generic(crc, (uint8_t const*)buf, size, CRC32_POLY_LE);
102 #endif
103 };
104 
109 class PS5BT : public BTHID, public PS5Parser {
110 public:
117  PS5BT(BTD *p, bool pair = false, const char *pin = "0000") :
118  BTHID(p, pair, pin), output_sequence_counter(0) {
119  PS5Parser::Reset();
120  };
121 
126  bool connected() {
127  return BTHID::connected;
128  };
129 
130 protected:
137  virtual void ParseBTHIDData(uint8_t len, uint8_t *buf) {
138  PS5Parser::Parse(len, buf);
139  };
140 
146  virtual void OnInitBTHID() {
147  PS5Parser::Reset();
148  enable_sixaxis(); // Make the controller send out the entire output report
149 
150  // Only call this is a user function has not been set
151  if (!pFuncOnInit)
152  setLed(Red); // Set the LED to red, as the PS5 controller turns Bluetooth when searching for a device
153  };
154 
156  virtual void ResetBTHID() {
157  PS5Parser::Reset();
158  };
162  virtual void sendOutputReport(PS5Output *output) {
163  // See the series of patches here: https://patchwork.kernel.org/project/linux-input/cover/20201219062336.72568-1-roderick@gaikai.com/
164  uint8_t buf[1 /* BT DATA Output Report */ + 1 /* report id */ + 1 /* seq_tag */ + 1 /* tag */ + 47 /* common */ + 24 /* reserved */ + 4 /* crc32 */];
165  memset(buf, 0, sizeof(buf));
166 
167  // Send as a Bluetooth HID DATA output report on the interrupt channel
168  buf[0] = 0xA2; // HID BT DATA (0xA0) | Report Type (Output 0x02)
169 
170  buf[0x01] = 0x31; // Report ID
171  buf[0x02] = (output_sequence_counter << 4) | 0x0; // Highest 4-bit is a sequence number, which needs to be increased every report. Lowest 4-bit is tag and can be zero for now.
172  if(++output_sequence_counter == 15)
173  output_sequence_counter = 0;
174  buf[0x03] = 0x10; // Magic number must be set to 0x10
175 
176  buf[0x01 + 3] = 0xFF; // feature flags 1
177  buf[0x02 + 3]= 0xF7; // feature flags 2
178 
179  buf[0x03 + 3] = output->smallRumble; // Small Rumble
180  buf[0x04 + 3] = output->bigRumble; // Big rumble
181 
182  // 5-7 headphone, speaker, mic volume, audio flags
183 
184  buf[0x09 + 3] = (uint8_t)output->microphoneLed;
185 
186  // 0x0A mute flags
187 
188  // Adaptive Triggers: 0x0B-0x14 right, 0x15 unknown, 0x16-0x1F left
189  rightTrigger.processTrigger(&buf[0x0B + 3]); // right
190  leftTrigger.processTrigger(&buf[0x16 + 3]); // left
191 
192  // 0x20-0x24 unknown
193  // 0x25 trigger motor effect strengths
194  // 0x26 speaker volume
195 
196  // player LEDs
197  buf[0x27 + 3] = 0x03; // led brightness, pulse
198  buf[0x2A + 3] = output->disableLeds ? 0x01 : 0x2; // led pulse option
199  // buf[0x2B] LED brightness, 0 = full, 1= medium, 2 = low
200  buf[0x2C + 3] = output->playerLeds; // 5 white player LEDs
201 
202  // lightbar
203  buf[0x2D + 3] = output->r; // Red
204  buf[0x2E + 3] = output->g; // Green
205  buf[0x2F + 3] = output->b; // Blue
206 
207  uint32_t crc = ~crc32(0xFFFFFFFF, buf, sizeof(buf) - 4 /* Do not include the crc32 */); // Note how the report type is also included in the output report
208  buf[75] = crc & 0xFF;
209  buf[76] = (crc >> 8) & 0xFF;
210  buf[77] = (crc >> 16);
211  buf[78] = (crc >> 24);
212 
213  output->reportChanged = false;
214 
215  // Send the Bluetooth DATA output report on the interrupt channel
216  pBtd->L2CAP_Command(hci_handle, buf, sizeof(buf), interrupt_scid[0], interrupt_scid[1]);
217  };
220 private:
221  void enable_sixaxis() { // Command used to make the PS5 controller send out the entire output report
222  // Request the paring info. This makes the controller send out the full report - see: https://patchwork.kernel.org/project/linux-input/cover/20201219062336.72568-1-roderick@gaikai.com/
223  uint8_t buf[2];
224  buf[0] = 0x43; // HID BT Get_report (0x40) | Report Type (Feature 0x03)
225  buf[1] = 0x09; // Report ID for paring info
226 
227  // Send the Bluetooth Get_report Feature report on the control channel
228  pBtd->L2CAP_Command(hci_handle, buf, 2, control_scid[0], control_scid[1]);
229  };
230 
231  uint8_t output_sequence_counter;
232 };
233 #endif
+
pgm_read_dword
#define pgm_read_dword(addr)
Definition: version_helper.h:167
+
PS5Output::reportChanged
bool reportChanged
Definition: PS5Parser.h:145
+
BTD
Definition: BTD.h:221
+
PS5Output::disableLeds
uint8_t disableLeds
Definition: PS5Parser.h:142
+
PS5Output::playerLeds
uint8_t playerLeds
Definition: PS5Parser.h:143
+
BTHID::interrupt_scid
uint8_t interrupt_scid[2]
Definition: BTHID.h:149
+
PS5BT::connected
bool connected()
Definition: PS5BT.h:126
+
PS5Parser.h
+
BTHID::connected
bool connected
Definition: BTHID.h:88
+
PS5BT
Definition: PS5BT.h:109
+
PS5BT::PS5BT
PS5BT(BTD *p, bool pair=false, const char *pin="0000")
Definition: PS5BT.h:117
+
CRC32_POLY_LE
#define CRC32_POLY_LE
Definition: PS5BT.h:80
+
PS5Output::r
uint8_t r
Definition: PS5Parser.h:144
+ +
BTHID::control_scid
uint8_t control_scid[2]
Definition: BTHID.h:146
+
PS5BT::OnInitBTHID
virtual void OnInitBTHID()
Definition: PS5BT.h:146
+
PS5Parser::Parse
void Parse(uint8_t len, uint8_t *buf)
Definition: PS5Parser.cpp:80
+
PS5Parser::leftTrigger
PS5Trigger leftTrigger
Definition: PS5Parser.h:154
+
BTHID.h
+
PS5Parser::rightTrigger
PS5Trigger rightTrigger
Definition: PS5Parser.h:154
+
PS5BT::ParseBTHIDData
virtual void ParseBTHIDData(uint8_t len, uint8_t *buf)
Definition: PS5BT.h:137
+
BluetoothService::pFuncOnInit
void(* pFuncOnInit)(void)
Definition: BTD.h:643
+
BluetoothService::pBtd
BTD * pBtd
Definition: BTD.h:646
+
PS5Output::microphoneLed
uint8_t microphoneLed
Definition: PS5Parser.h:141
+
PS5Output::bigRumble
uint8_t bigRumble
Definition: PS5Parser.h:140
+
crc32_table
const uint32_t crc32_table[]
Definition: PS5BT.h:29
+
PS5Parser::setLed
void setLed(uint8_t r, uint8_t g, uint8_t b)
Definition: PS5Parser.h:339
+
PS5Output::b
uint8_t b
Definition: PS5Parser.h:144
+
BluetoothService::hci_handle
uint16_t hci_handle
Definition: BTD.h:649
+
PS5BT::sendOutputReport
virtual void sendOutputReport(PS5Output *output)
Definition: PS5BT.h:162
+
PS5Trigger::processTrigger
void processTrigger(uint8_t *buffer)
Apply the trigger data to a PS5 update buffer.
Definition: PS5Trigger.cpp:34
+
PS5Output::smallRumble
uint8_t smallRumble
Definition: PS5Parser.h:140
+ +
BTD::L2CAP_Command
void L2CAP_Command(uint16_t handle, uint8_t *data, uint8_t nbytes, uint8_t channelLow=0x01, uint8_t channelHigh=0x00)
Definition: BTD.cpp:1447
+
BTHID
Definition: BTHID.h:29
+
PS5Output::g
uint8_t g
Definition: PS5Parser.h:144
+
PS5BT::ResetBTHID
virtual void ResetBTHID()
Definition: PS5BT.h:156
+
PS5Parser::Reset
void Reset()
Definition: PS5Parser.cpp:140
+
BTHID::pair
void pair(void)
Definition: BTHID.h:91
+
+ +
+Generated by   +doxygen + 1.8.13 +
+ + diff --git a/_p_s5_parser_8cpp.html b/_p_s5_parser_8cpp.html new file mode 100644 index 00000000..9412a727 --- /dev/null +++ b/_p_s5_parser_8cpp.html @@ -0,0 +1,177 @@ + + + + + + + +USB Host Shield 2.0: PS5Parser.cpp File Reference + + + + + + + + + + +
+
+ + + + + + +
+
USB Host Shield 2.0 +
+
+
+ + + + + + + + +
+
+ + +
+ +
+ +
+
+
+Enumerations
+
+
PS5Parser.cpp File Reference
+
+
+
#include "PS5Parser.h"
+
+Include dependency graph for PS5Parser.cpp:
+
+
+ + + + + + +
+
+

Go to the source code of this file.

+ + + + +

+Enumerations

enum  DPADEnum {
+  DPAD_UP = 0x0, +DPAD_UP_RIGHT = 0x1, +DPAD_RIGHT = 0x2, +DPAD_RIGHT_DOWN = 0x3, +
+  DPAD_DOWN = 0x4, +DPAD_DOWN_LEFT = 0x5, +DPAD_LEFT = 0x6, +DPAD_LEFT_UP = 0x7, +
+  DPAD_OFF = 0x8, +DPAD_UP = 0x0, +DPAD_UP_RIGHT = 0x1, +DPAD_RIGHT = 0x2, +
+  DPAD_RIGHT_DOWN = 0x3, +DPAD_DOWN = 0x4, +DPAD_DOWN_LEFT = 0x5, +DPAD_LEFT = 0x6, +
+  DPAD_LEFT_UP = 0x7, +DPAD_OFF = 0x8, +DPAD_OFF = 0x0, +DPAD_UP = 0x1, +
+  DPAD_UP_RIGHT = 0x2, +DPAD_RIGHT = 0x3, +DPAD_RIGHT_DOWN = 0x4, +DPAD_DOWN = 0x5, +
+  DPAD_DOWN_LEFT = 0x6, +DPAD_LEFT = 0x7, +DPAD_LEFT_UP = 0x8 +
+ }
 
+

Enumeration Type Documentation

+ +

◆ DPADEnum

+ +
+
+ + + + +
enum DPADEnum
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Enumerator
DPAD_UP 
DPAD_UP_RIGHT 
DPAD_RIGHT 
DPAD_RIGHT_DOWN 
DPAD_DOWN 
DPAD_DOWN_LEFT 
DPAD_LEFT 
DPAD_LEFT_UP 
DPAD_OFF 
DPAD_UP 
DPAD_UP_RIGHT 
DPAD_RIGHT 
DPAD_RIGHT_DOWN 
DPAD_DOWN 
DPAD_DOWN_LEFT 
DPAD_LEFT 
DPAD_LEFT_UP 
DPAD_OFF 
DPAD_OFF 
DPAD_UP 
DPAD_UP_RIGHT 
DPAD_RIGHT 
DPAD_RIGHT_DOWN 
DPAD_DOWN 
DPAD_DOWN_LEFT 
DPAD_LEFT 
DPAD_LEFT_UP 
+ +

Definition at line 24 of file PS5Parser.cpp.

+ +
+
+
+ +
+Generated by   +doxygen + 1.8.13 +
+ + diff --git a/_p_s5_parser_8cpp__incl.map b/_p_s5_parser_8cpp__incl.map new file mode 100644 index 00000000..d5974310 --- /dev/null +++ b/_p_s5_parser_8cpp__incl.map @@ -0,0 +1,6 @@ + + + + + + diff --git a/_p_s5_parser_8cpp__incl.md5 b/_p_s5_parser_8cpp__incl.md5 new file mode 100644 index 00000000..f83a78ca --- /dev/null +++ b/_p_s5_parser_8cpp__incl.md5 @@ -0,0 +1 @@ +97c8c343dcbc6359725e2020c4a1f735 \ No newline at end of file diff --git a/_p_s5_parser_8cpp__incl.png b/_p_s5_parser_8cpp__incl.png new file mode 100644 index 0000000000000000000000000000000000000000..546ee2a8a1d51b8a5a89e58cb955565d99e0a04f GIT binary patch literal 10854 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 + + + + + + +USB Host Shield 2.0: PS5Parser.cpp Source File + + + + + + + + + + +
+
+ + + + + + +
+
USB Host Shield 2.0 +
+
+
+ + + + + + + +
+ +
+
+ + +
+ +
+ +
+
+
PS5Parser.cpp
+
+
+Go to the documentation of this file.
1 /* Copyright (C) 2021 Kristian Sloth Lauszus. All rights reserved.
2 
3  This software may be distributed and modified under the terms of the GNU
4  General Public License version 2 (GPL2) as published by the Free Software
5  Foundation and appearing in the file GPL2.TXT included in the packaging of
6  this file. Please note that GPL2 Section 2[b] requires that all works based
7  on this software must also be made publicly available under the terms of
8  the GPL2 ("Copyleft").
9 
10  Contact information
11  -------------------
12 
13  Kristian Sloth Lauszus
14  Web : https://lauszus.com
15  e-mail : lauszus@gmail.com
16 
17  Thanks to Joseph Duchesne for the initial code.
18  Based on Ludwig Füchsl's https://github.com/Ohjurot/DualSense-Windows PS5 port
19  and the series of patches found here: https://patchwork.kernel.org/project/linux-input/cover/20201219062336.72568-1-roderick@gaikai.com/
20  */
21 
22 #include "PS5Parser.h"
23 
24 enum DPADEnum {
25  DPAD_UP = 0x0,
26  DPAD_UP_RIGHT = 0x1,
27  DPAD_RIGHT = 0x2,
28  DPAD_RIGHT_DOWN = 0x3,
29  DPAD_DOWN = 0x4,
30  DPAD_DOWN_LEFT = 0x5,
31  DPAD_LEFT = 0x6,
32  DPAD_LEFT_UP = 0x7,
33  DPAD_OFF = 0x8,
34 };
35 
36 // To enable serial debugging see "settings.h"
37 //#define PRINTREPORT // Uncomment to print the report send by the PS5 Controller
38 
39 bool PS5Parser::checkDpad(ButtonEnum b) {
40  switch (b) {
41  case UP:
42  return ps5Data.btn.dpad == DPAD_LEFT_UP || ps5Data.btn.dpad == DPAD_UP || ps5Data.btn.dpad == DPAD_UP_RIGHT;
43  case RIGHT:
44  return ps5Data.btn.dpad == DPAD_UP_RIGHT || ps5Data.btn.dpad == DPAD_RIGHT || ps5Data.btn.dpad == DPAD_RIGHT_DOWN;
45  case DOWN:
46  return ps5Data.btn.dpad == DPAD_RIGHT_DOWN || ps5Data.btn.dpad == DPAD_DOWN || ps5Data.btn.dpad == DPAD_DOWN_LEFT;
47  case LEFT:
48  return ps5Data.btn.dpad == DPAD_DOWN_LEFT || ps5Data.btn.dpad == DPAD_LEFT || ps5Data.btn.dpad == DPAD_LEFT_UP;
49  default:
50  return false;
51  }
52 }
53 
54 bool PS5Parser::getButtonPress(ButtonEnum b) {
55  if (b <= LEFT) // Dpad
56  return checkDpad(b);
57  else
58  return ps5Data.btn.val & (1UL << pgm_read_byte(&PS5_BUTTONS[(uint8_t)b]));
59 }
60 
61 bool PS5Parser::getButtonClick(ButtonEnum b) {
62  uint32_t mask = 1UL << pgm_read_byte(&PS5_BUTTONS[(uint8_t)b]);
63  bool click = buttonClickState.val & mask;
64  buttonClickState.val &= ~mask; // Clear "click" event
65  return click;
66 }
67 
68 uint8_t PS5Parser::getAnalogButton(ButtonEnum b) {
69  if (b == L2) // These are the only analog buttons on the controller
70  return ps5Data.trigger[0];
71  else if (b == R2)
72  return ps5Data.trigger[1];
73  return 0;
74 }
75 
76 uint8_t PS5Parser::getAnalogHat(AnalogHatEnum a) {
77  return ps5Data.hatValue[(uint8_t)a];
78 }
79 
80 void PS5Parser::Parse(uint8_t len, uint8_t *buf) {
81  if (len > 1 && buf) {
82 #ifdef PRINTREPORT
83  Notify(PSTR("\r\nLen: "), 0x80); Notify(len, 0x80);
84  Notify(PSTR(", data: "), 0x80);
85  for (uint8_t i = 0; i < len; i++) {
86  D_PrintHex<uint8_t > (buf[i], 0x80);
87  Notify(PSTR(" "), 0x80);
88  }
89 #endif
90 
91  if (buf[0] == 0x01) // Check report ID
92  memcpy(&ps5Data, buf + 1, min((uint8_t)(len - 1), MFK_CASTUINT8T sizeof(ps5Data)));
93  else if (buf[0] == 0x31) { // This report is send via Bluetooth, it has an offset of 1 compared to the USB data
94  if (len < 3) {
95 #ifdef DEBUG_USB_HOST
96  Notify(PSTR("\r\nReport is too short: "), 0x80);
97  D_PrintHex<uint8_t > (len, 0x80);
98 #endif
99  return;
100  }
101  memcpy(&ps5Data, buf + 2, min((uint8_t)(len - 2), MFK_CASTUINT8T sizeof(ps5Data)));
102  } else {
103 #ifdef DEBUG_USB_HOST
104  Notify(PSTR("\r\nUnknown report id: "), 0x80);
105  D_PrintHex<uint8_t > (buf[0], 0x80);
106  Notify(PSTR(", len: "), 0x80);
107  D_PrintHex<uint8_t > (len, 0x80);
108 #endif
109  return;
110  }
111 
112  if (ps5Data.btn.val != oldButtonState.val) { // Check if anything has changed
113  buttonClickState.val = ps5Data.btn.val & ~oldButtonState.val; // Update click state variable
114  oldButtonState.val = ps5Data.btn.val;
115 
116  // The DPAD buttons does not set the different bits, but set a value corresponding to the buttons pressed, we will simply set the bits ourself
117  uint8_t newDpad = 0;
118  if (checkDpad(UP))
119  newDpad |= 1 << UP;
120  if (checkDpad(RIGHT))
121  newDpad |= 1 << RIGHT;
122  if (checkDpad(DOWN))
123  newDpad |= 1 << DOWN;
124  if (checkDpad(LEFT))
125  newDpad |= 1 << LEFT;
126  if (newDpad != oldDpad) {
127  buttonClickState.dpad = newDpad & ~oldDpad; // Override values
128  oldDpad = newDpad;
129  }
130  }
131 
132  message_counter++;
133  }
134 
135  if (ps5Output.reportChanged || leftTrigger.reportChanged || rightTrigger.reportChanged)
136  sendOutputReport(&ps5Output); // Send output report
137 }
138 
139 
140 void PS5Parser::Reset() {
141  uint8_t i;
142  for (i = 0; i < sizeof(ps5Data.hatValue); i++)
143  ps5Data.hatValue[i] = 127; // Center value
144  ps5Data.btn.val = 0;
145  oldButtonState.val = 0;
146  for (i = 0; i < sizeof(ps5Data.trigger); i++)
147  ps5Data.trigger[i] = 0;
148  for (i = 0; i < sizeof(ps5Data.xy.finger)/sizeof(ps5Data.xy.finger[0]); i++)
149  ps5Data.xy.finger[i].touching = 1; // The bit is cleared if the finger is touching the touchpad
150 
151  ps5Data.btn.dpad = DPAD_OFF;
152  oldButtonState.dpad = DPAD_OFF;
153  buttonClickState.dpad = 0;
154  oldDpad = 0;
155 
156  leftTrigger.Reset();
157  rightTrigger.Reset();
158 
159  ps5Output.bigRumble = ps5Output.smallRumble = 0;
160  ps5Output.microphoneLed = 0;
161  ps5Output.disableLeds = 0;
162  ps5Output.playerLeds = 0;
163  ps5Output.r = ps5Output.g = ps5Output.b = 0;
164  ps5Output.reportChanged = false;
165 };
PS5Output::reportChanged
bool reportChanged
Definition: PS5Parser.h:145
+
PS5Output::disableLeds
uint8_t disableLeds
Definition: PS5Parser.h:142
+
PS5Output::playerLeds
uint8_t playerLeds
Definition: PS5Parser.h:143
+
DPAD_DOWN
Definition: PS5Parser.cpp:29
+
DPAD_UP_RIGHT
Definition: PS5Parser.cpp:26
+
PS5Parser.h
+
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:170
+
PS5Data::hatValue
uint8_t hatValue[4]
Definition: PS5Parser.h:107
+
DPADEnum
DPADEnum
Definition: PS4Parser.cpp:20
+
pgm_read_byte
#define pgm_read_byte(addr)
Definition: version_helper.h:161
+
PS5Buttons::val
uint32_t val
Definition: PS5Parser.h:78
+ +
DPAD_DOWN_LEFT
Definition: PS5Parser.cpp:30
+
PS5Output::r
uint8_t r
Definition: PS5Parser.h:144
+
ps5TouchpadXY::touching
uint8_t touching
Definition: PS5Parser.h:84
+ +
PS5Data::trigger
uint8_t trigger[2]
Definition: PS5Parser.h:108
+
DPAD_RIGHT
Definition: PS5Parser.cpp:27
+
ps5TouchpadXY::finger
struct ps5TouchpadXY::@31 finger[2]
+
Notify
#define Notify(...)
Definition: message.h:51
+
PS5Parser::sendOutputReport
virtual void sendOutputReport(PS5Output *output)=0
+
PS5Parser::Parse
void Parse(uint8_t len, uint8_t *buf)
Definition: PS5Parser.cpp:80
+
DPAD_RIGHT_DOWN
Definition: PS5Parser.cpp:28
+
PS5Data::btn
PS5Buttons btn
Definition: PS5Parser.h:112
+
PS5_BUTTONS
const uint8_t PS5_BUTTONS[]
Definition: PS5Parser.h:30
+
PS5Parser::getButtonPress
bool getButtonPress(ButtonEnum b)
Definition: PS5Parser.cpp:54
+
PS5Parser::leftTrigger
PS5Trigger leftTrigger
Definition: PS5Parser.h:154
+
PS5Parser::getAnalogButton
uint8_t getAnalogButton(ButtonEnum b)
Definition: PS5Parser.cpp:68
+ +
ButtonEnum
ButtonEnum
Definition: controllerEnums.h:78
+
PS5Parser::rightTrigger
PS5Trigger rightTrigger
Definition: PS5Parser.h:154
+
PS5Buttons::dpad
uint8_t dpad
Definition: PS5Parser.h:58
+
PS5Trigger::reportChanged
bool reportChanged
Definition: PS5Trigger.h:88
+ +
DPAD_OFF
Definition: PS5Parser.cpp:33
+
PS5Parser::getAnalogHat
uint8_t getAnalogHat(AnalogHatEnum a)
Definition: PS5Parser.cpp:76
+
PSTR
#define PSTR(str)
Definition: version_helper.h:54
+
MFK_CASTUINT8T
#define MFK_CASTUINT8T
Definition: settings.h:194
+
DPAD_UP
Definition: PS5Parser.cpp:25
+
PS5Output::microphoneLed
uint8_t microphoneLed
Definition: PS5Parser.h:141
+
PS5Output::bigRumble
uint8_t bigRumble
Definition: PS5Parser.h:140
+
PS5Data::xy
ps5TouchpadXY xy
Definition: PS5Parser.h:125
+
PS5Output::b
uint8_t b
Definition: PS5Parser.h:144
+
DPAD_LEFT_UP
Definition: PS5Parser.cpp:32
+
PS5Parser::getButtonClick
bool getButtonClick(ButtonEnum b)
Definition: PS5Parser.cpp:61
+
DPAD_LEFT
Definition: PS5Parser.cpp:31
+
PS5Output::smallRumble
uint8_t smallRumble
Definition: PS5Parser.h:140
+
PS5Output::g
uint8_t g
Definition: PS5Parser.h:144
+ +
PS5Trigger::Reset
void Reset()
Definition: PS5Trigger.h:100
+
PS5Parser::Reset
void Reset()
Definition: PS5Parser.cpp:140
+ +
+ +
+Generated by   +doxygen + 1.8.13 +
+ + diff --git a/_p_s5_parser_8h.html b/_p_s5_parser_8h.html new file mode 100644 index 00000000..92fe0740 --- /dev/null +++ b/_p_s5_parser_8h.html @@ -0,0 +1,145 @@ + + + + + + + +USB Host Shield 2.0: PS5Parser.h File Reference + + + + + + + + + + +
+
+ + + + + + +
+
USB Host Shield 2.0 +
+
+
+ + + + + + + + +
+
+ + +
+ +
+ +
+
+
+Classes | +Variables
+
+
PS5Parser.h File Reference
+
+
+
#include "Usb.h"
+#include "controllerEnums.h"
+#include "PS5Trigger.h"
+
+Include dependency graph for PS5Parser.h:
+
+
+ + + + + +
+
+This graph shows which files directly or indirectly include this file:
+
+
+ + + + + +
+
+

Go to the source code of this file.

+ + + + + + + + + + + + + + +

+Classes

union  PS5Buttons
 
struct  ps5TouchpadXY
 
union  PS5Status
 
struct  PS5Data
 
struct  PS5Output
 
class  PS5Parser
 
+ + + +

+Variables

const uint8_t PS5_BUTTONS []
 
+

Variable Documentation

+ +

◆ PS5_BUTTONS

+ +
+
+ + + + +
const uint8_t PS5_BUTTONS[]
+
+Initial value:
= {
UP,
RIGHT,
DOWN,
LEFT,
0x0C,
0x0D,
0x0E,
0x0F,
0x0A,
0x0B,
0x08,
0x09,
0x07,
0x06,
0x05,
0x04,
0x10,
0x11,
0x12,
}
+ + + +

Buttons on the controller

+ +

Definition at line 30 of file PS5Parser.h.

+ +
+
+
+ +
+Generated by   +doxygen + 1.8.13 +
+ + diff --git a/_p_s5_parser_8h__dep__incl.map b/_p_s5_parser_8h__dep__incl.map new file mode 100644 index 00000000..deb25120 --- /dev/null +++ b/_p_s5_parser_8h__dep__incl.map @@ -0,0 +1,5 @@ + + + + + diff --git a/_p_s5_parser_8h__dep__incl.md5 b/_p_s5_parser_8h__dep__incl.md5 new file mode 100644 index 00000000..9d4bf899 --- /dev/null +++ b/_p_s5_parser_8h__dep__incl.md5 @@ -0,0 +1 @@ +fcee511d6736a910b5372bdfcac4f8bc \ No newline at end of file diff --git a/_p_s5_parser_8h__dep__incl.png b/_p_s5_parser_8h__dep__incl.png new file mode 100644 index 0000000000000000000000000000000000000000..3cbc7ff0eb9c278acb2e60f2232cbaeed5b1c7c4 GIT binary patch literal 5762 zcmZXY2{hF2_s3PrHuh~S$=2A*5(?RxB*c8l5@XAjY(v?%Vvy`4Te1!zJ3~U4ETgQE zEe3<^yRq|szQ6xD|8xHT|1;;ze9rlN=K0*`KKHrzzTS}t-3PSPoYZ7wWV8=8;re7` z7qr1Oit-}(hF)uD20vGxYCnLJo&WpEZYoS7BV&_)2v>XT^I>h$*TkT6oNNu-*aD7F9@H)MbYYq~=nb7d~Nliy- zEeo}1F5(|m@eBraO^;?3-HeQI241o7{e9!xKNOSh>@0{UQISJ%3}mX07!A!YkiEL7 z7Jezamlt;d;SfJV_DQCySS;I!v^LRcD{W{VCFQdI=Zj^~A*R?#Dpoc82Xhi${N~Lp zDVy+OF=>tAp`lL=)I>Vl`VT#+QUc1#7Q?mByllI7^y~jKUl)pOh{N_a*)rr~P0_28 zl9K6KEEe0;6liOkUs)-o{-(#?!NDOVC8e&eP6i5*m#=&EicBf)79FYv7A|ekTK4gS%?(bVx+sB|0WV~G{!<=7Betv$Ge1Uc#Ck4i;vIxa|uK#XbSGJ5Q*kB^ShGcpVe3|yR@ zH(z)lk$*xd=ub{gn$M0_LPA2=Z(2}#IX-{h5O7$Pk}@*e9`)^TfvdIf)hI%oO-xE^ zprZpOB;){`aWJgh9B5%-VPcY6ROG0x9ugO)=j!T;Kp;FkJc5H&nz2PiA~G^E5)y0s zgkTlF-A|hqzY6u(eFb!2JN-HLxa3`x+-Kq5-gUVXw9#xxOo_&`XToP8Im3|SY=6oa3BQq2g2Bv#vAq0NrSEtq;u?sK zz1>|Xq@%%eg^ow5-WJc)Y7t84ddn(yOI9{BGm}yM?%lf$4Gq-JvXXuv%=k!*FN1^6 z_f|&Ck;u>g87HTw)nHUrZ9)j&z{=CGSW>#I6WDb@G=CDlw6xUG(J?SE(4atv(ZbHv zHI`v;aIm|pOITRAtG5>fJRKz^3WZXotgWpLJlX0Di2)a3`pTFCg|ybSrz$g|1g zXKX05`UuT|U&F%Mhl&iguE)m4wzs!a=BS*XRM*rDb#_L;`T5Xq;JI@Sj>sGGH*VZe zR-VG+9j&ag^Yh^q)Nw5{sH5X!d6#jtwF$83@#CR183&k7s+E;hd}3lquc4&!K*MxD987u>?CkB8{Yk3> zc@LgEdGhh&M<(^Xy*>Ba+)R-}1VZracPcbPR6ElcOjLAv5Tm`ewq|Z_4(CtMfeE1h zOilu)fpFyF;@Wb!!0(^@?j3~ga))@=X61DltfRes9t28GP7atEEcPH1tJQrvIy!9PCJfBX0*x1vwPGS8@3_x?7s?9I zMHW{E@&h(=IQGstVPEqA!dJg;!jy;2B;P^f19pA6ZB^6Z%3{(@{ScDnGGs<~Fw z!NtYJ&d$yQ()BkFD_54o=liBSMr&~Nwkj{f&mPR3Zf?5YlRYCNLX7j?Y|osWY$Tx` zG!z8LrAwvUx-xM>D<_BpZ$_;v1V=8h^mGN+NxzrJBw|)jaY?xwP7)4d{(_wP zaK~V0M@1;Gg4i00QPDv~e zIz_7O)B4iwl->DH5`UUdaFj_0C>t4%_<`v&nH;TNMY*Z+Gtxp} zCkHmsIXPICt*E!_L1%|`lsP|tW@EG+9vb8S_F4M*GP^f=~bX zXYTWpSs{CRG09Do?_nT1J}RoGj!>4+fc%#@rfiC}L?y}7-FSk)`K^76S?wW}N zcpB+%XAI>qs4FYG1)hD$K#%KYxw3F8>AmNF6#^C(9vf?~pO`gj$U^OS^pZF?H(&Mr zd?VP6#=-^)J1KnGeCAh~kwF{AUx3^68Ep;}!}zdKz9Wl$+bwQt>)@oArgPRQDW9O( zKa_9pQ2u);U-Rmh+S--g%qz<0f(igXOG!R2t5+MeIIvDPmvr^WF8;?|kZBwuKly26VEc8*Y@QK_HXyq3_#3lr52VcBgR9SuuM7Y+}z}fFIq2jf zpH#$fTiYvqbW#%~y1#|2{L^At7GdJ4v7N(tjnl}Nhe@#YKTC?i&7bA3s9;O(!{NE5FUDkC) zd-a+OR6$Fa1#*R>OgKQ9ly&|`Q%79-*3d&;i}h7!3|d`VD~LJB-oktm&EU7wbB@^^ z#8fLEv{+EdwwgEW`a3(TdCMz`J|A$%xCeJGJ2&WI1Fs+Hx6trlB zvT_~g6c74GXAgX`46I%3PKE{su3gt2ftJF45!3KWqJKV9{_EFO7yK9DJX%4^}d162l zTd!kk+F(?wz{BP>*xp|7dDW@XX3|R1Yy#ijZn--7wW?zC@8OO&ex9pVRlEx&vUNCG zWbpHFCux1ssrSdRv7g_o+|Gt!$ZJ&->}sadh+ObN4lbOQAYu0YiSbDBvQ`ma7s_$y zx3XE4poAQjSMd9n&(3)s9Sy@wnPs)Ws-<5uYimvG>mtCaDidx)W35uv@Hje1xJcXT zn88itoAD|;{62wTTEWW!`-Eq-JrHiON}X*Xm%aQNa*YuRF`!G$hI#itil7L!){=9Z z+PxMWJyqkl)f$R%b;Yx??gJMXLv8B?C7}hPAVq;QlXA1u#FVoPnO5s+?qxQiZD_ol zOwMtG2NE80nT_oVA?T}|qW|9H*O-l_l$X2D+7aI*=)*7ey>5pJ$l%C&ak$@OW6LeC z#T30hfP`Qsspj%{n){4i5-KOxN-kTZ7Jg0-rgE25djvXs%2umUvCFVeG1R*@P>BB? zJlx#{br4C;AM9^K!iy+Uv*kW-rOrso==6Y9Qgs-E=TbRC zsh&TL$%90+O4d>^4_)D6=b#IDC}s-~llyw+Hm z*-8?k>F_}Z;U6Y*vh*vqr3GhgE!5PwDkdt2vx3Hll&;O?=5}3G44|Q2udiRdA#(U= zST<2!N7KUMV{wTLwXJk!D`mcZk49}uR@OBbJ++^~Hm2y#BZC*|fVudqt}$}>-%R*a zRI-wrw^Pe-cPFB ze+t#$4d5&97A8#d+<@UyZd#VT>;9w)x*YDjo=ipKmJ`L7^^4K2=!k6xM|+Lt@E{ye$U;fn2;}-B`=?nob3MP4}iY_U(m7v9H615K06@B*>uLTva^FWkXRCXRS|a5A?GqK$g~W& zCGMI^Y;-i7Qo_8U2JjmO6Nb0tN1LA6J2{CFxs0Um-+HGhENSYYB+R7wCOmwRL@jlo zcuC-}suLGMe>qq=@Q8(PXmT>fI`!knsh$k^%O#?sqT=G>n;Cp-(bIYE zEgJ$tn5p7X4iL`K;{Qtjqpwddmf(Z`@q^2Y>$2=S)Fg5UH{uBlE~BnD zy{Z$Se{l1tYr3Essv~c(^T7*$(O*><8XJo&_uFXN=j7zv9HHk?N|kYlO$OXkySGyQ zt=CHOd-&kU$ThPtOH8o{pV*`jwnR9gH zckwmC)KtN)`(0Mh(bCT}880udTbwTAHI9Y4nQa27FMmcyO#r6>+}+$n(M1SUrDTiq z#Iawy=4NeeZEMTI#56cOd|i0<&zBbfRWvj-W@ctiPfwq+ix$hy!(%D#qtVYoS0o?T zrQF+R)7?)9rZzG%BJJ)r0)%XCo*EhPCasPgh{BSVrl+$pn7vktYxxBQapltHldRmi((!VF5 z7$KIMgTCkK?QJ0ZuD`z@++LWQ<3*28Ol)cFY;Sk}_~GQ@g3&JmlMzx-;5sK(iP6`h&phA}m?}{hR-^w*w0>d3nUvP>P*}9vV8jjw^v*&5Vufnw$S! zuuNlPBlpdhs26c_r`j%PjWPkq z1Y`hpK{+eVI<>aeQ(K$HViu#F!p+T%-e8iPA8Fs6(fLD4ii4fq zb+4HUiJ}uo3Q;W~eugQRc4F;vMoh84jmJ+^W!N5xw6L%Ms$6U0!GVvAOm(Z7(c{O9 zD=SgxrZaLh_^0MHFR_gN&++|y5VMg{FNR+p?w}%HcEiG&B=IhrN z0zwtN*U2wm=HTQ6y2|_HrTj?kvpnCB8Q}sWqSzdmg5O&bvEXQ@eQ%4BO8+i7V zUCWsdVz3uj|LP^h{r*#Uh<2=;a~-?0T=9C0$f7dxRo~y^<72Q>H17e6(nBD;=>JwV zw!U6PGbCsZ4Gb`jWoqQzhr@5(x}_9+7BCmaL`j||R^}`%_fC>7f=DD*2c7!ClG4)B zL>k}zOQWOCUY3>we3FovnVHJz?yoQ!_F4Hs7z`G|^J{F(m)Jo&(}Ye-O{H|@1uBsD z`X3P!5GxVid^V?FM@B}X!)&rxDB9cFE}kQB!@qy)3$uVzg&%-xu9K>~-F)rqu~;tz zq8|tgy;&;fn=?3|h6L{o8y_IhIXN?6f90J=5tf#ghK8)n%*@=}(Hmfv-+(~J$Bz!S zhyZxg)6=zrqTN?VE7#Xu?--dK<~s>j`uY0;>!jg*UaD|K)#8IiMh`yAtcl}IH-T` z9`5&V?59tZmR5E9$Ag2A&_sTnw7(B(0uaB_bPGYC5b4u4V?aT0 zb#%mAN%Hgak2+&V!*JL+=ohU{jbKDQ(p5|AZA=Vpb08AQ9o5eH@D|mi#ryRb{EG6) zFlG*7Z1XfLPBZA4G|P2|dOw5Je~aPg*AR-q{^4O-8X7LVdbVl&j4CJO3URtMRNx8a zV;brIuM&JeN#6#d!aGa)`FeL^cv4bQW9}NL(9J4+O3J|bc&T*G{i%No!+FAty}f-< zP*8ViqW+ybcknC0&`;j?M3Rb%ijbTJYyKOWpeU2CvK~_0B_k7Q0ro6I{`VVCRfrS! V4#=x9eLz$udw5?LUZ!pp@?TB1MwkEq literal 0 HcmV?d00001 diff --git a/_p_s5_parser_8h__incl.map b/_p_s5_parser_8h__incl.map new file mode 100644 index 00000000..713c9b1f --- /dev/null +++ b/_p_s5_parser_8h__incl.map @@ -0,0 +1,5 @@ + + + + + diff --git a/_p_s5_parser_8h__incl.md5 b/_p_s5_parser_8h__incl.md5 new file mode 100644 index 00000000..6c2415a3 --- /dev/null +++ b/_p_s5_parser_8h__incl.md5 @@ -0,0 +1 @@ +cde57ab91e7f48eccb70d2bfffb8cf36 \ No newline at end of file diff --git a/_p_s5_parser_8h__incl.png b/_p_s5_parser_8h__incl.png new file mode 100644 index 0000000000000000000000000000000000000000..9eac82860a1f0f7589944937a59c7bec3de4a485 GIT binary patch literal 9787 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 INt*}%7e=MKTmS$7 literal 0 HcmV?d00001 diff --git a/_p_s5_parser_8h_source.html b/_p_s5_parser_8h_source.html new file mode 100644 index 00000000..0b92f0e4 --- /dev/null +++ b/_p_s5_parser_8h_source.html @@ -0,0 +1,165 @@ + + + + + + + +USB Host Shield 2.0: PS5Parser.h Source File + + + + + + + + + + +
+
+ + + + + + +
+
USB Host Shield 2.0 +
+
+
+ + + + + + + +
+ +
+
+ + +
+ +
+ +
+
+
PS5Parser.h
+
+
+Go to the documentation of this file.
1 /* Copyright (C) 2021 Kristian Sloth Lauszus. All rights reserved.
2 
3  This software may be distributed and modified under the terms of the GNU
4  General Public License version 2 (GPL2) as published by the Free Software
5  Foundation and appearing in the file GPL2.TXT included in the packaging of
6  this file. Please note that GPL2 Section 2[b] requires that all works based
7  on this software must also be made publicly available under the terms of
8  the GPL2 ("Copyleft").
9 
10  Contact information
11  -------------------
12 
13  Kristian Sloth Lauszus
14  Web : https://lauszus.com
15  e-mail : lauszus@gmail.com
16 
17  Thanks to Joseph Duchesne for the initial code.
18  Based on Ludwig Füchsl's https://github.com/Ohjurot/DualSense-Windows PS5 port
19  and the series of patches found here: https://patchwork.kernel.org/project/linux-input/cover/20201219062336.72568-1-roderick@gaikai.com/
20  */
21 
22 #ifndef _ps5parser_h_
23 #define _ps5parser_h_
24 
25 #include "Usb.h"
26 #include "controllerEnums.h"
27 #include "PS5Trigger.h"
28 
30 const uint8_t PS5_BUTTONS[] PROGMEM = {
31  UP, // UP
32  RIGHT, // RIGHT
33  DOWN, // DOWN
34  LEFT, // LEFT
35 
36  0x0C, // CREATE
37  0x0D, // OPTIONS
38  0x0E, // L3
39  0x0F, // R3
40 
41  0x0A, // L2
42  0x0B, // R2
43  0x08, // L1
44  0x09, // R1
45 
46  0x07, // TRIANGLE
47  0x06, // CIRCLE
48  0x05, // CROSS
49  0x04, // SQUARE
50 
51  0x10, // PS
52  0x11, // TOUCHPAD
53  0x12, // MICROPHONE
54 };
55 
56 union PS5Buttons {
57  struct {
58  uint8_t dpad : 4;
59  uint8_t square : 1;
60  uint8_t cross : 1;
61  uint8_t circle : 1;
62  uint8_t triangle : 1;
63 
64  uint8_t l1 : 1;
65  uint8_t r1 : 1;
66  uint8_t l2 : 1;
67  uint8_t r2 : 1;
68  uint8_t create : 1;
69  uint8_t menu : 1;
70  uint8_t l3 : 1;
71  uint8_t r3 : 1;
72 
73  uint8_t ps : 1;
74  uint8_t touchpad : 1;
75  uint8_t mic : 1;
76  uint8_t dummy : 5;
77  } __attribute__((packed));
78  uint32_t val : 24;
79 } __attribute__((packed));
80 
81 struct ps5TouchpadXY {
82  struct {
83  uint8_t counter : 7; // Increments every time a finger is touching the touchpad
84  uint8_t touching : 1; // The top bit is cleared if the finger is touching the touchpad
85  uint16_t x : 12;
86  uint16_t y : 12;
87  } __attribute__((packed)) finger[2]; // 0 = first finger, 1 = second finger
88 } __attribute__((packed));
89 
90 union PS5Status {
91  struct {
92  // first byte
93  uint8_t headphone : 1;
94  uint8_t dummy : 2; // Seems to change when a jack is plugged in. First bit stays on when a mic is plugged in.
95  uint8_t usb : 1; // charging
96  uint8_t dummy2: 4;
97 
98  // second byte
99  uint8_t mic : 1;
100  uint8_t dummy3 : 3;
101  } __attribute__((packed));
102  uint16_t val;
103 } __attribute__((packed));
104 
105 struct PS5Data {
106  /* Button and joystick values */
107  uint8_t hatValue[4]; // 0-3 bytes
108  uint8_t trigger[2]; // 4-5
109 
110  uint8_t sequence_number; // 6
111 
112  PS5Buttons btn; // 7-9
113 
114  uint8_t reserved[5]; // 0xA-0xD
115 
116  /* Gyro and accelerometer values */
117  int16_t gyroX, gyroZ, gyroY; // 0x0F - 0x14
118  int16_t accX, accZ, accY; // 0x15-0x1A
119  int32_t sensor_timestamp;
120 
121  uint8_t reserved2;
122 
123  // 0x20 - 0x23 touchpad point 1
124  // 0x24 - 0x27 touchpad point 2
125  ps5TouchpadXY xy;
126 
127 #if 0 // The status byte depends on if it's sent via USB or Bluetooth, so is not parsed for now
128  uint8_t reserved3; // 0x28
129 
130  uint8_t rightTriggerFeedback; // 0x29
131  uint8_t leftTriggerFeedback; // 0x2A
132  uint8_t reserved4[10]; // 0x2B - 0x34
133 
134  // status bytes 0x35-0x36
135  PS5Status status;
136 #endif
137 } __attribute__((packed));
138 
139 struct PS5Output {
140  uint8_t bigRumble, smallRumble; // Rumble
141  uint8_t microphoneLed;
142  uint8_t disableLeds;
143  uint8_t playerLeds;
144  uint8_t r, g, b; // RGB for lightbar
145  bool reportChanged; // The data is send when data is received from the controller
146 } __attribute__((packed));
147 
149 class PS5Parser {
150 public:
152  PS5Parser() : leftTrigger(), rightTrigger() {
153  Reset();
154  };
155 
157  PS5Trigger leftTrigger, rightTrigger;
158 
170  bool getButtonPress(ButtonEnum b);
171  bool getButtonClick(ButtonEnum b);
181  uint8_t getAnalogButton(ButtonEnum b);
182 
188  uint8_t getAnalogHat(AnalogHatEnum a);
189 
194  uint16_t getX(uint8_t finger = 0) {
195  return ps5Data.xy.finger[finger].x;
196  };
197 
203  uint16_t getY(uint8_t finger = 0) {
204  return ps5Data.xy.finger[finger].y;
205  };
206 
212  bool isTouching(uint8_t finger = 0) {
213  return !(ps5Data.xy.finger[finger].touching); // The bit is cleared when a finger is touching the touchpad
214  };
215 
221  uint8_t getTouchCounter(uint8_t finger = 00) {
222  return ps5Data.xy.finger[finger].counter;
223  };
224 
230  float getAngle(AngleEnum a) {
231  if (a == Pitch)
232  return (atan2f(-ps5Data.accY, -ps5Data.accZ) + PI) * RAD_TO_DEG;
233  else
234  return (atan2f(ps5Data.accX, -ps5Data.accZ) + PI) * RAD_TO_DEG;
235  };
236 
242  int16_t getSensor(SensorEnum s) {
243  switch(s) {
244  case gX:
245  return ps5Data.gyroX;
246  case gY:
247  return ps5Data.gyroY;
248  case gZ:
249  return ps5Data.gyroZ;
250  case aX:
251  return ps5Data.accX;
252  case aY:
253  return ps5Data.accY;
254  case aZ:
255  return ps5Data.accZ;
256  default:
257  return 0;
258  }
259  };
260 
261 #if 0 // Seems to only be available via Bluetooth, so have been disabled for now
262 
266  uint8_t getBatteryLevel() {
267  return ps5Data.status.battery;
268  };
269 #endif
270 
271 #if 0 // These are only valid via USB, so have been commented out for now
272 
276  bool getUsbStatus() {
277  return ps5Data.status.usb;
278  };
279 
284  bool getAudioStatus() {
285  return ps5Data.status.headphone;
286  };
287 
292  bool getMicStatus() {
293  return ps5Data.status.mic;
294  };
295 #endif
296 
298  void setAllOff() {
299  setRumbleOff();
300  setLedOff();
301  };
302 
304  void setRumbleOff() {
305  setRumbleOn(0, 0);
306  };
307 
312  void setRumbleOn(RumbleEnum mode) {
313  if (mode == RumbleLow)
314  setRumbleOn(0x00, 0xFF);
315  else
316  setRumbleOn(0xFF, 0x00);
317  };
318 
324  void setRumbleOn(uint8_t bigRumble, uint8_t smallRumble) {
325  ps5Output.bigRumble = bigRumble;
326  ps5Output.smallRumble = smallRumble;
327  ps5Output.reportChanged = true;
328  };
329 
331  void setLedOff() {
332  setLed(0, 0, 0);
333  };
334 
339  void setLed(uint8_t r, uint8_t g, uint8_t b) {
340  ps5Output.r = r;
341  ps5Output.g = g;
342  ps5Output.b = b;
343  ps5Output.reportChanged = true;
344  };
345 
350  void setLed(ColorsEnum color) {
351  setLed((uint8_t)(color >> 16), (uint8_t)(color >> 8), (uint8_t)(color));
352  };
353 
355  void setPlayerLedOff() {
356  setPlayerLed(0);
357  }
358 
363  void setPlayerLed(uint8_t mask) {
364  ps5Output.playerLeds = mask;
365  ps5Output.reportChanged = true;
366  }
367 
369  void setMicLedOff() {
370  setMicLed(0);
371  }
372 
377  void setMicLed(bool on) {
378  ps5Output.microphoneLed = on ? 1 : 0;
379  ps5Output.reportChanged = true;
380  }
381 
383  uint16_t getMessageCounter(){
384  return message_counter;
385  }
386 
387 protected:
393  void Parse(uint8_t len, uint8_t *buf);
394 
396  void Reset();
397 
402  virtual void sendOutputReport(PS5Output *output) = 0;
403 
404 
405 private:
406  bool checkDpad(ButtonEnum b); // Used to check PS5 DPAD buttons
407 
408  PS5Data ps5Data;
409  PS5Buttons oldButtonState, buttonClickState;
410  PS5Output ps5Output;
411  uint8_t oldDpad;
412  uint16_t message_counter = 0;
413 };
414 #endif
PS5Parser::getTouchCounter
uint8_t getTouchCounter(uint8_t finger=00)
Definition: PS5Parser.h:221
+ +
PS5Buttons::cross
uint8_t cross
Definition: PS5Parser.h:60
+
PS5Parser::getX
uint16_t getX(uint8_t finger=0)
Definition: PS5Parser.h:194
+ +
PS5Output::reportChanged
bool reportChanged
Definition: PS5Parser.h:145
+
PS5Buttons::dummy
uint8_t dummy
Definition: PS5Parser.h:76
+
PS5Data::reserved2
uint8_t reserved2
Definition: PS5Parser.h:121
+ +
PS5Buttons::circle
uint8_t circle
Definition: PS5Parser.h:61
+
PS5Parser::setLed
void setLed(ColorsEnum color)
Definition: PS5Parser.h:350
+
PS5Output::disableLeds
uint8_t disableLeds
Definition: PS5Parser.h:142
+
PS5Output::playerLeds
uint8_t playerLeds
Definition: PS5Parser.h:143
+
PS5Buttons::l2
uint8_t l2
Definition: PS5Parser.h:66
+
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:170
+
PS5Parser::getY
uint16_t getY(uint8_t finger=0)
Definition: PS5Parser.h:203
+
PS5Parser::setMicLed
void setMicLed(bool on)
Definition: PS5Parser.h:377
+ +
Usb.h
+ +
PS5Trigger.h
Based on Ludwig Füchsl&#39;s DualSense Windows driver https://github.com/Ohjurot/DualSense-Windows.
+
PS5Parser::setLedOff
void setLedOff()
Definition: PS5Parser.h:331
+ +
ps5TouchpadXY::x
uint16_t x
Definition: PS5Parser.h:85
+
PS5Buttons::val
uint32_t val
Definition: PS5Parser.h:78
+ +
PS5Status::val
uint16_t val
Definition: PS5Parser.h:102
+
PS5Buttons::r2
uint8_t r2
Definition: PS5Parser.h:67
+
PS5Buttons::mic
uint8_t mic
Definition: PS5Parser.h:75
+
PS5Parser::setRumbleOn
void setRumbleOn(uint8_t bigRumble, uint8_t smallRumble)
Definition: PS5Parser.h:324
+
PS5Output::r
uint8_t r
Definition: PS5Parser.h:144
+
ps5TouchpadXY::touching
uint8_t touching
Definition: PS5Parser.h:84
+ + +
PS5Parser::setMicLedOff
void setMicLedOff()
Definition: PS5Parser.h:369
+ +
RumbleEnum
RumbleEnum
Definition: controllerEnums.h:72
+
PS5Status::dummy3
uint8_t dummy3
Definition: PS5Parser.h:100
+
PS5Status::headphone
uint8_t headphone
Definition: PS5Parser.h:93
+
PS5Buttons::touchpad
uint8_t touchpad
Definition: PS5Parser.h:74
+
PS5Data::btn
PS5Buttons btn
Definition: PS5Parser.h:112
+
PS5Buttons::l1
uint8_t l1
Definition: PS5Parser.h:64
+
PS5_BUTTONS
const uint8_t PS5_BUTTONS[]
Definition: PS5Parser.h:30
+
PS5Buttons::square
uint8_t square
Definition: PS5Parser.h:59
+ +
PS5Parser::setRumbleOn
void setRumbleOn(RumbleEnum mode)
Definition: PS5Parser.h:312
+ +
ButtonEnum
ButtonEnum
Definition: controllerEnums.h:78
+
PS5Parser::getSensor
int16_t getSensor(SensorEnum s)
Definition: PS5Parser.h:242
+
PS5Parser::rightTrigger
PS5Trigger rightTrigger
Definition: PS5Parser.h:154
+
PS5Buttons::dpad
uint8_t dpad
Definition: PS5Parser.h:58
+
PS5Parser::setRumbleOff
void setRumbleOff()
Definition: PS5Parser.h:304
+
PS5Buttons::r1
uint8_t r1
Definition: PS5Parser.h:65
+
PS5Status::usb
uint8_t usb
Definition: PS5Parser.h:95
+
PS5Parser::setPlayerLed
void setPlayerLed(uint8_t mask)
Definition: PS5Parser.h:363
+
PS5Parser::getAngle
float getAngle(AngleEnum a)
Definition: PS5Parser.h:230
+
PS5Data::gyroZ
int16_t gyroZ
Definition: PS5Parser.h:117
+
ColorsEnum
ColorsEnum
Definition: controllerEnums.h:50
+
PS5Output::microphoneLed
uint8_t microphoneLed
Definition: PS5Parser.h:141
+ + +
PS5Status::mic
uint8_t mic
Definition: PS5Parser.h:99
+
PS5Data::accZ
int16_t accZ
Definition: PS5Parser.h:118
+
AngleEnum
AngleEnum
Definition: controllerEnums.h:218
+
PS5Data::xy
ps5TouchpadXY xy
Definition: PS5Parser.h:125
+
PS5Buttons::r3
uint8_t r3
Definition: PS5Parser.h:71
+ +
PS5Buttons::create
uint8_t create
Definition: PS5Parser.h:68
+
PS5Parser::setLed
void setLed(uint8_t r, uint8_t g, uint8_t b)
Definition: PS5Parser.h:339
+ +
ps5TouchpadXY::y
uint16_t y
Definition: PS5Parser.h:86
+
PS5Buttons::menu
uint8_t menu
Definition: PS5Parser.h:69
+
ps5TouchpadXY::counter
uint8_t counter
Definition: PS5Parser.h:83
+
PS5Data::sequence_number
uint8_t sequence_number
Definition: PS5Parser.h:110
+
PS5Buttons::triangle
uint8_t triangle
Definition: PS5Parser.h:62
+
PS5Parser::getMessageCounter
uint16_t getMessageCounter()
Definition: PS5Parser.h:383
+
PS5Status::dummy2
uint8_t dummy2
Definition: PS5Parser.h:96
+
PS5Output::smallRumble
uint8_t smallRumble
Definition: PS5Parser.h:140
+
PS5Parser::isTouching
bool isTouching(uint8_t finger=0)
Definition: PS5Parser.h:212
+
PS5Parser::setAllOff
void setAllOff()
Definition: PS5Parser.h:298
+
PS5Data::sensor_timestamp
int32_t sensor_timestamp
Definition: PS5Parser.h:119
+
SensorEnum
SensorEnum
Definition: controllerEnums.h:185
+
PS5Status::dummy
uint8_t dummy
Definition: PS5Parser.h:94
+ + +
PS5Parser::setPlayerLedOff
void setPlayerLedOff()
Definition: PS5Parser.h:355
+ +
PS5Buttons::l3
uint8_t l3
Definition: PS5Parser.h:70
+ +
PS5Buttons::ps
uint8_t ps
Definition: PS5Parser.h:73
+ +
+ +
+Generated by   +doxygen + 1.8.13 +
+ + diff --git a/_p_s5_trigger_8cpp.html b/_p_s5_trigger_8cpp.html new file mode 100644 index 00000000..09814a14 --- /dev/null +++ b/_p_s5_trigger_8cpp.html @@ -0,0 +1,100 @@ + + + + + + + +USB Host Shield 2.0: PS5Trigger.cpp File Reference + + + + + + + + + + +
+
+ + + + + + +
+
USB Host Shield 2.0 +
+
+
+ + + + + + + + +
+
+ + +
+ +
+ +
+
+
+
PS5Trigger.cpp File Reference
+
+
+ +

Based on Ludwig Füchsl's DualSense Windows driver https://github.com/Ohjurot/DualSense-Windows. +More...

+
#include "PS5Trigger.h"
+
+Include dependency graph for PS5Trigger.cpp:
+
+
+ + + +
+
+

Go to the source code of this file.

+

Detailed Description

+

Based on Ludwig Füchsl's DualSense Windows driver https://github.com/Ohjurot/DualSense-Windows.

+
Author
Ludwig Füchsl, adapted for USB_Host_Library SAMD by Joseph Duchesne
+
Date
2020-11-25
+
Copyright
Copyright (c) 2020 Ludwig Füchsl
+

MIT License

+

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

+

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

+

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

+

Minor updates by Kristian Sloth Lauszus.

+ +

Definition in file PS5Trigger.cpp.

+
+ +
+Generated by   +doxygen + 1.8.13 +
+ + diff --git a/_p_s5_trigger_8cpp__incl.map b/_p_s5_trigger_8cpp__incl.map new file mode 100644 index 00000000..42d95d5f --- /dev/null +++ b/_p_s5_trigger_8cpp__incl.map @@ -0,0 +1,3 @@ + + + diff --git a/_p_s5_trigger_8cpp__incl.md5 b/_p_s5_trigger_8cpp__incl.md5 new file mode 100644 index 00000000..5dd45910 --- /dev/null +++ b/_p_s5_trigger_8cpp__incl.md5 @@ -0,0 +1 @@ +4d8a1847a0c39433a111a80b8167f291 \ No newline at end of file diff --git a/_p_s5_trigger_8cpp__incl.png b/_p_s5_trigger_8cpp__incl.png new file mode 100644 index 0000000000000000000000000000000000000000..880838ba3da438308991802a1bf32a8e2a9a4360 GIT binary patch literal 5379 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 R0;Zafih_oGg{*n#e*nXsev$wH literal 0 HcmV?d00001 diff --git a/_p_s5_trigger_8cpp_source.html b/_p_s5_trigger_8cpp_source.html new file mode 100644 index 00000000..58487b47 --- /dev/null +++ b/_p_s5_trigger_8cpp_source.html @@ -0,0 +1,77 @@ + + + + + + + +USB Host Shield 2.0: PS5Trigger.cpp Source File + + + + + + + + + + +
+
+ + + + + + +
+
USB Host Shield 2.0 +
+
+
+ + + + + + + +
+ +
+
+ + +
+ +
+ +
+
+
PS5Trigger.cpp
+
+
+Go to the documentation of this file.
1 
32 #include "PS5Trigger.h"
33 
34 void PS5Trigger::processTrigger(uint8_t* buffer) {
35  // Switch on effect
36  switch (data.effectType) {
37  // Continious
38  case EffectType::ContinuousResitance:
39  // Mode
40  buffer[0x00] = 0x01;
41  // Parameters
42  buffer[0x01] = data.Continuous.startPosition;
43  buffer[0x02] = data.Continuous.force;
44 
45  break;
46 
47  // Section
48  case EffectType::SectionResitance:
49  // Mode
50  buffer[0x00] = 0x02;
51  // Parameters
52  buffer[0x01] = data.Section.startPosition;
53  buffer[0x02] = data.Section.endPosition;
54 
55  break;
56 
57  // EffectEx
58  case EffectType::EffectEx:
59  // Mode
60  buffer[0x00] = 0x02 | 0x20 | 0x04;
61  // Parameters
62  buffer[0x01] = 0xFF - data.EffectEx.startPosition;
63  // Keep flag
64  if (data.EffectEx.keepEffect)
65  buffer[0x02] = 0x02;
66  // Forces
67  buffer[0x04] = data.EffectEx.beginForce;
68  buffer[0x05] = data.EffectEx.middleForce;
69  buffer[0x06] = data.EffectEx.endForce;
70  // Frequency
71  buffer[0x09] = data.EffectEx.frequency / 2;
72  if(buffer[0x09] < 1) buffer[0x09] = 1; // minimum frequency
73 
74  break;
75 
76  // Calibrate
77  case EffectType::Calibrate:
78  // Mode
79  buffer[0x00] = 0xFC;
80 
81  break;
82 
83  // No resistance / default
84  case EffectType::NoResitance:
85  default:
86  // All zero
87  buffer[0x00] = 0x00;
88  buffer[0x01] = 0x00;
89  buffer[0x02] = 0x00;
90 
91  break;
92  }
93  reportChanged = false;
94 }
PS5Trigger.h
Based on Ludwig Füchsl&#39;s DualSense Windows driver https://github.com/Ohjurot/DualSense-Windows.
+
PS5Trigger::reportChanged
bool reportChanged
Definition: PS5Trigger.h:88
+
PS5Trigger::processTrigger
void processTrigger(uint8_t *buffer)
Apply the trigger data to a PS5 update buffer.
Definition: PS5Trigger.cpp:34
+
+ +
+Generated by   +doxygen + 1.8.13 +
+ + diff --git a/_p_s5_trigger_8h.html b/_p_s5_trigger_8h.html new file mode 100644 index 00000000..9d315360 --- /dev/null +++ b/_p_s5_trigger_8h.html @@ -0,0 +1,120 @@ + + + + + + + +USB Host Shield 2.0: PS5Trigger.h File Reference + + + + + + + + + + +
+
+ + + + + + +
+
USB Host Shield 2.0 +
+
+
+ + + + + + + + +
+
+ + +
+ +
+ +
+
+
+Classes
+
+
PS5Trigger.h File Reference
+
+
+ +

Based on Ludwig Füchsl's DualSense Windows driver https://github.com/Ohjurot/DualSense-Windows. +More...

+
#include <inttypes.h>
+
+Include dependency graph for PS5Trigger.h:
+
+
+ + +
+
+This graph shows which files directly or indirectly include this file:
+
+
+ + + + + + + +
+
+

Go to the source code of this file.

+ + + + +

+Classes

class  PS5Trigger
 
+

Detailed Description

+

Based on Ludwig Füchsl's DualSense Windows driver https://github.com/Ohjurot/DualSense-Windows.

+
Author
Ludwig Füchsl, adapted for USB_Host_Library SAMD by Joseph Duchesne
+
Version
0.1
+
Date
2020-11-25
+
Copyright
Copyright (c) 2020 Ludwig Füchsl
+

MIT License

+

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

+

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

+

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

+

Minor updates by Kristian Sloth Lauszus.

+ +

Definition in file PS5Trigger.h.

+
+ +
+Generated by   +doxygen + 1.8.13 +
+ + diff --git a/_p_s5_trigger_8h__dep__incl.map b/_p_s5_trigger_8h__dep__incl.map new file mode 100644 index 00000000..4f43eed1 --- /dev/null +++ b/_p_s5_trigger_8h__dep__incl.map @@ -0,0 +1,7 @@ + + + + + + + diff --git a/_p_s5_trigger_8h__dep__incl.md5 b/_p_s5_trigger_8h__dep__incl.md5 new file mode 100644 index 00000000..302208f1 --- /dev/null +++ b/_p_s5_trigger_8h__dep__incl.md5 @@ -0,0 +1 @@ +819587c266e34a5fdeb368f8f4a05d54 \ No newline at end of file diff --git a/_p_s5_trigger_8h__dep__incl.png b/_p_s5_trigger_8h__dep__incl.png new file mode 100644 index 0000000000000000000000000000000000000000..b3f38ec43fc0ac5cec0cf45b262af4abe15f0862 GIT binary patch literal 10349 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 DIhT3m literal 0 HcmV?d00001 diff --git a/_p_s5_trigger_8h__incl.map b/_p_s5_trigger_8h__incl.map new file mode 100644 index 00000000..c7e6e901 --- /dev/null +++ b/_p_s5_trigger_8h__incl.map @@ -0,0 +1,2 @@ + + diff --git a/_p_s5_trigger_8h__incl.md5 b/_p_s5_trigger_8h__incl.md5 new file mode 100644 index 00000000..a3c38e2e --- /dev/null +++ b/_p_s5_trigger_8h__incl.md5 @@ -0,0 +1 @@ +933b51d2a99b1ab644e570075ab908af \ No newline at end of file diff --git a/_p_s5_trigger_8h__incl.png b/_p_s5_trigger_8h__incl.png new file mode 100644 index 0000000000000000000000000000000000000000..ef677ba90639bdc8a1fe3402d4a9199576c5b6e3 GIT binary patch literal 2986 zcmb_eXIK+k0v#V!dQn752t`l`y@*JaCcPt|6a`TqAXPy~jG}2DV`B z2c7}Ue}LD_;Rgm_#dyce*Z?^B`^af2d<_7s?j{C$_F_6 zkqR+o_hTM6N401O|G_FEO?TN*wp1jMW)<626Wbqy-M(>Rlt`jJW6( zU;DdfAVZ(R4Csj5>@(=Jii(QHMh&ZcY>iXfQ`$}c7DI;Bnt!}HBoj9uaazPIkJncCX&ICxhRcw#@6 zm94ZMuF(N4ZnML~L6j9jZ0u?6?6yFn5$@I+ne0<7oMu`ZvA2c`%(p#%{=5lVRUq+} z+>K&;%SD`SYHF&>&71oA`sYSoDML=>NW6r;LLO5Ki;I_A_GU^eE190rF>xd$ zBz*t=otZu|H#hg-;2=Fc9g9^0)F1u+eoQ+o=G)rdW@TZ~(9i(px)KHbn>QJq83B$M zeZMa6>h10AEN!j&`H#kOZw2}JnE^dLz4hkpBy-88M`Uz%_AGUKX>WB>iYFG(6-)7* zZAGllw0tzKb;(Li-CBs3PnD&or{6y~NOj$%tWE;DYWEpp+Am2<2g#X)MtVH$2owU$ zC3%6r2rK@rRHMR?6nPVg)IpsS46JnY&nhP&zJC@7WPlX3`#eeiRDDMR;?I z)XTuYkg4XU5x!Ft%!64$g}1m>j`PwhUb#|ieG&3>fBxAs04ORcDJd;|-Q%UGs7M|w zH@kkFnS(qD*D;R-f{q=HW`Ue9O*oUtb^C-o2lp>XVU?@taJ(z|*rlQn=xC+> zCy8{|`7BEmlD2!!L0CZG?*TO-m9@1F`L@OOCH`$R%C}s7waJf833@zlAaCW}-)CgF z*x3ay59gD|E3>bLu7T}6Jw3o*cRJ$+wGYd3bM^9ujzHG1M2X4D_UCq0W3d8)f=x|L z_q@F;ZsCF!yHluv3MSaXCA2z-6OR^2B=9-N@#5l3xz_J67|iR}FNph7ImW{` zl^}sa^02>4P240~WA+8*iU%B^{3RHxfLiE5)EFTUmMJP|eh^@|_KCabm&m$0HO>p( zoP1`Bq_cC&u(FgMFZ6GP1LTRKN=VE#o8L*$kjS}-+W9rB<%(}Z;(#wfEGtXZnE?TB4hlYL+OL(kb;?33t}{0!T1b} zd9aPQFg}fZHqUVDGlCy-FbUX0In_(2bD?92O@R{wsS>&KAetMLio*w}Z zsQNKWD?PJ8J^JJC)Twth`mHuz>hp#XaLxR z^>=@N$h7<8$2>l@I~!X=1)>82`rJU) z)uo6>0RhP_(LGo==d&N;D7^TMqS{!3FGNHn`(`UszH( zbT|M}QBg+{7K^>%j!2s#|Lo5^K0dxt>2@JgR3OGcx|#>Yc9 z7YtLb+q=42a2bFb-ds`;0$E#LPBF~~#jDP;aC>*x;o=!_aq<5Cer;{-%lZkugcsGQk9wsbmx zvf>;G?ekVnPoVJze$Vq+kLbR~6c#Z{nwCl;g3>K4EbLNF!HXbk;B#zLW2R zW`6#5uJxI977FXMn~JWJO~Qf`Vz$&-f|2^1Y;BgoEkwT zy|uHmD=aAZ3Hg$L*$dLZSr5-)bVx#>E~lF}g|64REVVW_!#zB5nwk!$Lub=^NkDRT zw!4juqPlw6>O?KLE@1KjbWKgaR(ax$jE(Vle4vn&2U_ z3`{VwYnMD;P4JC`!g?ht+m0K-WV5qVbJq^Uhnt%lu8lmTtS<8U?}XDb{aY`cVWFd= z12YqdmL6Amc{$jn7cCo~lmt3?<&v4l!zbFB@GNJxv^0>gm=c#`lPOdl}XwXqnQL(YH_Q~z@Z{EBKle>h^F+{?D7Z=vJlshC3 zE+LOL@sJ+;>H9+>>!<#sm@$>gpc`h&Y~=`!jErz-u@65#?!HsCmT&dfYWsYE(AIVQ m>>$kW9rfQ54#wH`6JT70&dg+8ksl1-fQg}{LB%zX$bSHso!Nx| literal 0 HcmV?d00001 diff --git a/_p_s5_trigger_8h_source.html b/_p_s5_trigger_8h_source.html new file mode 100644 index 00000000..54c60998 --- /dev/null +++ b/_p_s5_trigger_8h_source.html @@ -0,0 +1,82 @@ + + + + + + + +USB Host Shield 2.0: PS5Trigger.h Source File + + + + + + + + + + +
+
+ + + + + + +
+
USB Host Shield 2.0 +
+
+
+ + + + + + + +
+ +
+
+ + +
+ +
+ +
+
+
PS5Trigger.h
+
+
+Go to the documentation of this file.
1 
33 #ifndef _ps5trigger_h_
34 #define _ps5trigger_h_
35 
36 #include <inttypes.h>
37 
38 class PS5Trigger {
39 private:
40  // Type of trigger effect
41  typedef enum _EffectType : uint8_t {
42  NoResitance = 0x00, // No resistance is applied
43  ContinuousResitance = 0x01, // Continuous Resitance is applied
44  SectionResitance = 0x02, // Seciton resistance is appleyed
45  EffectEx = 0x26, // Extended trigger effect
46  Calibrate = 0xFC, // Calibrate triggers
47  } EffectType;
48 
49  // Trigger effect
50  typedef struct _EffectData {
51  // Trigger effect type
52  EffectType effectType;
53 
54  // Union for effect parameters
55  union {
56  // Union one raw data
57  uint8_t _u1_raw[6];
58 
59  // For type == ContinuousResitance
60  struct {
61  uint8_t startPosition; // Start position of resistance
62  uint8_t force; // Force of resistance
63  uint8_t _pad[4]; // PAD / UNUSED
64  } __attribute__((packed)) Continuous;
65 
66  // For type == SectionResitance
67  struct {
68  uint8_t startPosition; // Start position of resistance
69  uint8_t endPosition; // End position of resistance (>= start)
70  uint8_t _pad[4]; // PAD / UNUSED
71  } __attribute__((packed)) Section;
72 
73  // For type == EffectEx
74  struct {
75  uint8_t startPosition; // Position at witch the effect starts
76  bool keepEffect; // Wher the effect should keep playing when trigger goes beyond 255
77  uint8_t beginForce; // Force applied when trigger >= (255 / 2)
78  uint8_t middleForce; // Force applied when trigger <= (255 / 2)
79  uint8_t endForce; // Force applied when trigger is beyond 255
80  uint8_t frequency; // Vibration frequency of the trigger
81  } __attribute__((packed)) EffectEx;
82  } __attribute__((packed));
83  } __attribute__((packed)) EffectData;
84 
85  EffectData data;
86 
87 public:
88  bool reportChanged = false;
89 
95  void processTrigger(uint8_t* buffer);
96 
100  void Reset() {
101  data.effectType = EffectType::NoResitance;
102 
103  reportChanged = false;
104  };
105 
109  void clearTriggerForce() {
110  data.effectType = EffectType::NoResitance;
111 
112  reportChanged = true;
113  };
114 
120  void setTriggerForce(uint8_t start, uint8_t force) {
121  if (force == 0)
122  data.effectType = EffectType::NoResitance;
123  else {
124  data.effectType = EffectType::ContinuousResitance;
125  data.Continuous.startPosition = start;
126  data.Continuous.force = force;
127  }
128 
129  reportChanged = true;
130  };
131 
137  void setTriggerForceSection(uint8_t start, uint8_t end) {
138  data.effectType = EffectType::SectionResitance;
139  data.Section.startPosition = start;
140  data.Section.endPosition = end;
141 
142  reportChanged = true;
143  };
144 
154  void setTriggerForceEffect(uint8_t start, bool keep, uint8_t begin_force, uint8_t mid_force, uint8_t end_force, uint8_t frequency) {
155  data.effectType = EffectType::SectionResitance;
156  data.EffectEx.startPosition = start;
157  data.EffectEx.keepEffect = keep;
158  data.EffectEx.beginForce = begin_force;
159  data.EffectEx.middleForce = mid_force;
160  data.EffectEx.endForce = end_force;
161  data.EffectEx.frequency = frequency;
162 
163  reportChanged = true;
164  };
165 
166 };
167 
168 #endif
PS5Trigger::clearTriggerForce
void clearTriggerForce()
Definition: PS5Trigger.h:109
+
PS5Trigger::setTriggerForceEffect
void setTriggerForceEffect(uint8_t start, bool keep, uint8_t begin_force, uint8_t mid_force, uint8_t end_force, uint8_t frequency)
Definition: PS5Trigger.h:154
+
PS5Trigger::reportChanged
bool reportChanged
Definition: PS5Trigger.h:88
+ +
PS5Trigger::processTrigger
void processTrigger(uint8_t *buffer)
Apply the trigger data to a PS5 update buffer.
Definition: PS5Trigger.cpp:34
+
PS5Trigger::Reset
void Reset()
Definition: PS5Trigger.h:100
+
PS5Trigger::setTriggerForceSection
void setTriggerForceSection(uint8_t start, uint8_t end)
Definition: PS5Trigger.h:137
+
PS5Trigger::setTriggerForce
void setTriggerForce(uint8_t start, uint8_t force)
Definition: PS5Trigger.h:120
+
+ +
+Generated by   +doxygen + 1.8.13 +
+ + diff --git a/_p_s5_u_s_b_8h.html b/_p_s5_u_s_b_8h.html new file mode 100644 index 00000000..7fee2703 --- /dev/null +++ b/_p_s5_u_s_b_8h.html @@ -0,0 +1,142 @@ + + + + + + + +USB Host Shield 2.0: PS5USB.h File Reference + + + + + + + + + + +
+
+ + + + + + +
+
USB Host Shield 2.0 +
+
+
+ + + + + + + + +
+
+ + +
+ +
+ +
+
+
+Classes | +Macros
+
+
PS5USB.h File Reference
+
+
+
#include "hiduniversal.h"
+#include "PS5Parser.h"
+
+Include dependency graph for PS5USB.h:
+
+
+ + + + + + + + + + +
+
+

Go to the source code of this file.

+ + + + +

+Classes

class  PS5USB
 
+ + + + + +

+Macros

#define PS5_VID   0x054C
 
#define PS5_PID   0x0CE6
 
+

Macro Definition Documentation

+ +

◆ PS5_VID

+ +
+
+ + + + +
#define PS5_VID   0x054C
+
+ +

Definition at line 27 of file PS5USB.h.

+ +
+
+ +

◆ PS5_PID

+ +
+
+ + + + +
#define PS5_PID   0x0CE6
+
+ +

Definition at line 28 of file PS5USB.h.

+ +
+
+
+ +
+Generated by   +doxygen + 1.8.13 +
+ + diff --git a/_p_s5_u_s_b_8h__incl.map b/_p_s5_u_s_b_8h__incl.map new file mode 100644 index 00000000..bf9d475f --- /dev/null +++ b/_p_s5_u_s_b_8h__incl.map @@ -0,0 +1,10 @@ + + + + + + + + + + diff --git a/_p_s5_u_s_b_8h__incl.md5 b/_p_s5_u_s_b_8h__incl.md5 new file mode 100644 index 00000000..fe18e879 --- /dev/null +++ b/_p_s5_u_s_b_8h__incl.md5 @@ -0,0 +1 @@ +3be065c8ceb7b72bb0cc17dc2e48f08f \ No newline at end of file diff --git a/_p_s5_u_s_b_8h__incl.png b/_p_s5_u_s_b_8h__incl.png new file mode 100644 index 0000000000000000000000000000000000000000..11e3ef3f1c1f3208a7420b629775336fb5796fb7 GIT binary patch literal 25117 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 literal 0 HcmV?d00001 diff --git a/_p_s5_u_s_b_8h_source.html b/_p_s5_u_s_b_8h_source.html new file mode 100644 index 00000000..804a3faf --- /dev/null +++ b/_p_s5_u_s_b_8h_source.html @@ -0,0 +1,116 @@ + + + + + + + +USB Host Shield 2.0: PS5USB.h Source File + + + + + + + + + + +
+
+ + + + + + +
+
USB Host Shield 2.0 +
+
+
+ + + + + + + +
+ +
+
+ + +
+ +
+ +
+
+
PS5USB.h
+
+
+Go to the documentation of this file.
1 /* Copyright (C) 2021 Kristian Sloth Lauszus. All rights reserved.
2 
3  This software may be distributed and modified under the terms of the GNU
4  General Public License version 2 (GPL2) as published by the Free Software
5  Foundation and appearing in the file GPL2.TXT included in the packaging of
6  this file. Please note that GPL2 Section 2[b] requires that all works based
7  on this software must also be made publicly available under the terms of
8  the GPL2 ("Copyleft").
9 
10  Contact information
11  -------------------
12 
13  Kristian Sloth Lauszus
14  Web : https://lauszus.com
15  e-mail : lauszus@gmail.com
16 
17  Thanks to Joseph Duchesne for the initial port. Data structure mapping partially based
18  on values from Ludwig Füchsl's https://github.com/Ohjurot/DualSense-Windows
19  */
20 
21 #ifndef _ps5usb_h_
22 #define _ps5usb_h_
23 
24 #include "hiduniversal.h"
25 #include "PS5Parser.h"
26 
27 #define PS5_VID 0x054C // Sony Corporation
28 #define PS5_PID 0x0CE6 // PS5 Controller
29 
34 class PS5USB : public HIDUniversal, public PS5Parser {
35 public:
40  PS5USB(USB *p) :
41  HIDUniversal(p) {
42  PS5Parser::Reset();
43  };
44 
49  bool connected() {
50  return HIDUniversal::isReady() && HIDUniversal::VID == PS5_VID && HIDUniversal::PID == PS5_PID;
51  };
52 
57  void attachOnInit(void (*funcOnInit)(void)) {
58  pFuncOnInit = funcOnInit;
59  };
60 
61 protected:
70  virtual void ParseHIDData(USBHID *hid __attribute__((unused)), bool is_rpt_id __attribute__((unused)), uint8_t len, uint8_t *buf) {
71  if (HIDUniversal::VID == PS5_VID && HIDUniversal::PID == PS5_PID)
72  PS5Parser::Parse(len, buf);
73  };
74 
80  virtual uint8_t OnInitSuccessful() {
81  if (HIDUniversal::VID == PS5_VID && HIDUniversal::PID == PS5_PID) {
82  PS5Parser::Reset();
83  if (pFuncOnInit)
84  pFuncOnInit(); // Call the user function
85  else
86  setLed(Red); // Set the LED to red, so it is consistent with the PS5BT driver
87  };
88  return 0;
89  };
93  virtual void sendOutputReport(PS5Output *output) { // Source: https://github.com/chrippa/ds4drv
94  // PS4 Source: https://github.com/chrippa/ds4drv
95  // PS5 values from https://www.reddit.com/r/gamedev/comments/jumvi5/dualsense_haptics_leds_and_more_hid_output_report/,
96  // Ludwig Füchsl's https://github.com/Ohjurot/DualSense-Windows and
97  // the series of patches found here: https://patchwork.kernel.org/project/linux-input/cover/20201219062336.72568-1-roderick@gaikai.com/
98  uint8_t buf[1 /* report id */ + 47 /* common */];
99  memset(buf, 0, sizeof(buf));
100 
101  buf[0x00] = 0x02; // Report ID
102 
103  buf[0x01] = 0xFF; // feature flags 1
104  buf[0x02]= 0xF7; // feature flags 2
105 
106  buf[0x03] = output->smallRumble; // Small Rumble
107  buf[0x04] = output->bigRumble; // Big rumble
108 
109  // 5-7 headphone, speaker, mic volume, audio flags
110 
111  buf[0x09] = (uint8_t)output->microphoneLed;
112 
113  // 0x0A mute flags
114 
115  // Adaptive Triggers: 0x0B-0x14 right, 0x15 unknown, 0x16-0x1F left
116  rightTrigger.processTrigger(&buf[0x0B]); // right
117  leftTrigger.processTrigger(&buf[0x16]); // left
118 
119  // 0x20-0x24 unknown
120  // 0x25 trigger motor effect strengths
121  // 0x26 speaker volume
122 
123  // player LEDs
124  buf[0x27] = 0x03; // led brightness, pulse
125  buf[0x2A] = output->disableLeds ? 0x01 : 0x2; // led pulse option
126  // buf[0x2B] LED brightness, 0 = full, 1= medium, 2 = low
127  buf[0x2C] = output->playerLeds; // 5 white player LEDs
128 
129  // lightbar
130  buf[0x2D] = output->r; // Red
131  buf[0x2E] = output->g; // Green
132  buf[0x2F] = output->b; // Blue
133 
134  output->reportChanged = false;
135 
136  // There is no need to calculate a crc32 when the controller is connected via USB
137 
138  pUsb->outTransfer(bAddress, epInfo[ hidInterfaces[0].epIndex[epInterruptOutIndex] ].epAddr, sizeof(buf), buf);
139  };
149  virtual bool VIDPIDOK(uint16_t vid, uint16_t pid) {
150  return (vid == PS5_VID && pid == PS5_PID);
151  };
154 private:
155  void (*pFuncOnInit)(void); // Pointer to function called in onInit()
156 };
157 #endif
+
USBHID
Definition: usbhid.h:143
+
PS5USB::ParseHIDData
virtual void ParseHIDData(USBHID *hid, bool is_rpt_id, uint8_t len, uint8_t *buf)
Definition: PS5USB.h:70
+
USBHID::pUsb
USB * pUsb
Definition: usbhid.h:145
+
PS5Output::reportChanged
bool reportChanged
Definition: PS5Parser.h:145
+
PS5Output::disableLeds
uint8_t disableLeds
Definition: PS5Parser.h:142
+
PS5Output::playerLeds
uint8_t playerLeds
Definition: PS5Parser.h:143
+
PS5Parser.h
+
HIDComposite::isReady
virtual bool isReady()
Definition: hidcomposite.h:99
+
HIDComposite::hidInterfaces
HIDInterface hidInterfaces[maxHidInterfaces]
Definition: hidcomposite.h:64
+
HIDComposite::epInfo
EpInfo epInfo[totalEndpoints]
Definition: hidcomposite.h:63
+
PS5USB::OnInitSuccessful
virtual uint8_t OnInitSuccessful()
Definition: PS5USB.h:80
+
PS5Output::r
uint8_t r
Definition: PS5Parser.h:144
+ +
PS5USB::VIDPIDOK
virtual bool VIDPIDOK(uint16_t vid, uint16_t pid)
Definition: PS5USB.h:149
+
PS5USB::PS5USB
PS5USB(USB *p)
Definition: PS5USB.h:40
+
PS5Parser::Parse
void Parse(uint8_t len, uint8_t *buf)
Definition: PS5Parser.cpp:80
+
PS5USB::attachOnInit
void attachOnInit(void(*funcOnInit)(void))
Definition: PS5USB.h:57
+
PS5Parser::leftTrigger
PS5Trigger leftTrigger
Definition: PS5Parser.h:154
+
USB::outTransfer
uint8_t outTransfer(uint8_t addr, uint8_t ep, uint16_t nbytes, uint8_t *data)
Definition: Usb.cpp:303
+
USBHID::epInterruptOutIndex
static const uint8_t epInterruptOutIndex
Definition: usbhid.h:150
+
USBHID::bAddress
uint8_t bAddress
Definition: usbhid.h:146
+
PS5Parser::rightTrigger
PS5Trigger rightTrigger
Definition: PS5Parser.h:154
+
HIDComposite::PID
uint16_t PID
Definition: hidcomposite.h:71
+
PS5USB
Definition: PS5USB.h:34
+ +
PS5Output::microphoneLed
uint8_t microphoneLed
Definition: PS5Parser.h:141
+
HIDComposite::VID
uint16_t VID
Definition: hidcomposite.h:71
+
PS5_PID
#define PS5_PID
Definition: PS5USB.h:28
+
PS5Output::bigRumble
uint8_t bigRumble
Definition: PS5Parser.h:140
+
PS5Parser::setLed
void setLed(uint8_t r, uint8_t g, uint8_t b)
Definition: PS5Parser.h:339
+
PS5Output::b
uint8_t b
Definition: PS5Parser.h:144
+
PS5USB::connected
bool connected()
Definition: PS5USB.h:49
+
PS5Trigger::processTrigger
void processTrigger(uint8_t *buffer)
Apply the trigger data to a PS5 update buffer.
Definition: PS5Trigger.cpp:34
+
USB
Definition: UsbCore.h:210
+
PS5Output::smallRumble
uint8_t smallRumble
Definition: PS5Parser.h:140
+ +
PS5Output::g
uint8_t g
Definition: PS5Parser.h:144
+
PS5Parser::Reset
void Reset()
Definition: PS5Parser.cpp:140
+
PS5_VID
#define PS5_VID
Definition: PS5USB.h:27
+
PS5USB::sendOutputReport
virtual void sendOutputReport(PS5Output *output)
Definition: PS5USB.h:93
+ +
+ +
+Generated by   +doxygen + 1.8.13 +
+ + diff --git a/_p_s_buzz_8h_source.html b/_p_s_buzz_8h_source.html index 4761be98..7bbcda36 100644 --- a/_p_s_buzz_8h_source.html +++ b/_p_s_buzz_8h_source.html @@ -63,9 +63,8 @@ $(function() {
PSBuzz.h
-Go to the documentation of this file.
1 /* Copyright (C) 2014 Kristian Lauszus, TKJ Electronics. All rights reserved.
2 
3  This software may be distributed and modified under the terms of the GNU
4  General Public License version 2 (GPL2) as published by the Free Software
5  Foundation and appearing in the file GPL2.TXT included in the packaging of
6  this file. Please note that GPL2 Section 2[b] requires that all works based
7  on this software must also be made publicly available under the terms of
8  the GPL2 ("Copyleft").
9 
10  Contact information
11  -------------------
12 
13  Kristian Lauszus, TKJ Electronics
14  Web : http://www.tkjelectronics.com
15  e-mail : kristianl@tkjelectronics.com
16  */
17 
18 #ifndef _psbuzz_h_
19 #define _psbuzz_h_
20 
21 #include "hiduniversal.h"
22 #include "controllerEnums.h"
23 
24 #define PSBUZZ_VID 0x054C // Sony Corporation
25 #define PSBUZZ_PID 0x1000 // PS Buzz Controller
26 
28 union PSBUZZButtons {
29  struct {
30  uint8_t red : 1;
31  uint8_t yellow : 1;
32  uint8_t green : 1;
33  uint8_t orange : 1;
34  uint8_t blue : 1;
35  } __attribute__((packed)) btn[4];
36  uint32_t val : 20;
37 } __attribute__((packed));
38 
43 class PSBuzz : public HIDUniversal {
44 public:
49  PSBuzz(USB *p) :
50  HIDUniversal(p) {
51  Reset();
52  };
53 
58  bool connected() {
59  return HIDUniversal::isReady() && HIDUniversal::VID == PSBUZZ_VID && HIDUniversal::PID == PSBUZZ_PID;
60  };
61 
66  void attachOnInit(void (*funcOnInit)(void)) {
67  pFuncOnInit = funcOnInit;
68  };
69 
82  bool getButtonPress(ButtonEnum b, uint8_t controller = 0);
83  bool getButtonClick(ButtonEnum b, uint8_t controller = 0);
95  void setLedRaw(bool value, uint8_t controller = 0);
96 
98  void setLedOffAll() {
99  for (uint8_t i = 1; i < 4; i++) // Skip first as it will be set in setLedRaw
100  ledState[i] = false; // Just an easy way to set all four off at the same time
101  setLedRaw(false); // Turn the LED off, on all four controllers
102  };
103 
108  void setLedOff(uint8_t controller = 0) {
109  setLedRaw(false, controller);
110  };
111 
112 
114  void setLedOnAll() {
115  for (uint8_t i = 1; i < 4; i++) // Skip first as it will be set in setLedRaw
116  ledState[i] = true; // Just an easy way to set all four off at the same time
117  setLedRaw(true); // Turn the LED on, on all four controllers
118  };
119 
124  void setLedOn(uint8_t controller = 0) {
125  setLedRaw(true, controller);
126  };
127 
132  void setLedToggle(uint8_t controller = 0) {
133  setLedRaw(!ledState[controller], controller);
134  };
137 protected:
146  void ParseHIDData(USBHID *hid, bool is_rpt_id, uint8_t len, uint8_t *buf);
147 
153  uint8_t OnInitSuccessful();
157  void Reset() {
158  psbuzzButtons.val = 0;
159  oldButtonState.val = 0;
160  buttonClickState.val = 0;
161  for (uint8_t i = 0; i < sizeof(ledState); i++)
162  ledState[i] = 0;
163  };
164 
172  virtual bool VIDPIDOK(uint16_t vid, uint16_t pid) {
173  return (vid == PSBUZZ_VID && pid == PSBUZZ_PID);
174  };
177 private:
178  void (*pFuncOnInit)(void); // Pointer to function called in onInit()
179 
180  void PSBuzz_Command(uint8_t *data, uint16_t nbytes);
181 
182  PSBUZZButtons psbuzzButtons, oldButtonState, buttonClickState;
183  bool ledState[4];
184 };
185 #endif
USBHID
Definition: usbhid.h:143
+Go to the documentation of this file.
1 /* Copyright (C) 2014 Kristian Lauszus, TKJ Electronics. All rights reserved.
2 
3  This software may be distributed and modified under the terms of the GNU
4  General Public License version 2 (GPL2) as published by the Free Software
5  Foundation and appearing in the file GPL2.TXT included in the packaging of
6  this file. Please note that GPL2 Section 2[b] requires that all works based
7  on this software must also be made publicly available under the terms of
8  the GPL2 ("Copyleft").
9 
10  Contact information
11  -------------------
12 
13  Kristian Lauszus, TKJ Electronics
14  Web : http://www.tkjelectronics.com
15  e-mail : kristianl@tkjelectronics.com
16  */
17 
18 #ifndef _psbuzz_h_
19 #define _psbuzz_h_
20 
21 #include "hiduniversal.h"
22 #include "controllerEnums.h"
23 
24 #define PSBUZZ_VID 0x054C // Sony Corporation
25 #define PSBUZZ_PID 0x1000 // PS Buzz Controller
26 
28 union PSBUZZButtons {
29  struct {
30  uint8_t red : 1;
31  uint8_t yellow : 1;
32  uint8_t green : 1;
33  uint8_t orange : 1;
34  uint8_t blue : 1;
35  } __attribute__((packed)) btn[4];
36  uint32_t val : 20;
37 } __attribute__((packed));
38 
43 class PSBuzz : public HIDUniversal {
44 public:
49  PSBuzz(USB *p) :
50  HIDUniversal(p) {
51  Reset();
52  };
53 
58  bool connected() {
59  return HIDUniversal::isReady() && HIDUniversal::VID == PSBUZZ_VID && HIDUniversal::PID == PSBUZZ_PID;
60  };
61 
66  void attachOnInit(void (*funcOnInit)(void)) {
67  pFuncOnInit = funcOnInit;
68  };
69 
82  bool getButtonPress(ButtonEnum b, uint8_t controller = 0);
83  bool getButtonClick(ButtonEnum b, uint8_t controller = 0);
95  void setLedRaw(bool value, uint8_t controller = 0);
96 
98  void setLedOffAll() {
99  for (uint8_t i = 1; i < 4; i++) // Skip first as it will be set in setLedRaw
100  ledState[i] = false; // Just an easy way to set all four off at the same time
101  setLedRaw(false); // Turn the LED off, on all four controllers
102  };
103 
108  void setLedOff(uint8_t controller = 0) {
109  setLedRaw(false, controller);
110  };
111 
112 
114  void setLedOnAll() {
115  for (uint8_t i = 1; i < 4; i++) // Skip first as it will be set in setLedRaw
116  ledState[i] = true; // Just an easy way to set all four off at the same time
117  setLedRaw(true); // Turn the LED on, on all four controllers
118  };
119 
124  void setLedOn(uint8_t controller = 0) {
125  setLedRaw(true, controller);
126  };
127 
132  void setLedToggle(uint8_t controller = 0) {
133  setLedRaw(!ledState[controller], controller);
134  };
137 protected:
146  void ParseHIDData(USBHID *hid, bool is_rpt_id, uint8_t len, uint8_t *buf);
147 
153  uint8_t OnInitSuccessful();
157  void Reset() {
158  psbuzzButtons.val = 0;
159  oldButtonState.val = 0;
160  buttonClickState.val = 0;
161  for (uint8_t i = 0; i < sizeof(ledState); i++)
162  ledState[i] = 0;
163  };
164 
172  virtual bool VIDPIDOK(uint16_t vid, uint16_t pid) {
173  return (vid == PSBUZZ_VID && pid == PSBUZZ_PID);
174  };
177 private:
178  void (*pFuncOnInit)(void); // Pointer to function called in onInit()
179 
180  void PSBuzz_Command(uint8_t *data, uint16_t nbytes);
181 
182  PSBUZZButtons psbuzzButtons, oldButtonState, buttonClickState;
183  bool ledState[4];
184 };
185 #endif
USBHID
Definition: usbhid.h:143
PSBUZZButtons::red
uint8_t red
Definition: PSBuzz.h:30
-
PSBUZZButtons::btn
struct PSBUZZButtons::@29 btn[4]
PSBuzz::setLedToggle
void setLedToggle(uint8_t controller=0)
Definition: PSBuzz.h:132
PSBuzz::attachOnInit
void attachOnInit(void(*funcOnInit)(void))
Definition: PSBuzz.h:66
PSBuzz::Reset
void Reset()
Definition: PSBuzz.h:157
@@ -86,6 +85,7 @@ $(function() {
HIDComposite::VID
uint16_t VID
Definition: hidcomposite.h:71
PSBuzz::PSBuzz
PSBuzz(USB *p)
Definition: PSBuzz.h:49
+
PSBUZZButtons::btn
struct PSBUZZButtons::@39 btn[4]
PSBuzz::setLedOnAll
void setLedOnAll()
Definition: PSBuzz.h:114
USB
Definition: UsbCore.h:210
PSBuzz::setLedOn
void setLedOn(uint8_t controller=0)
Definition: PSBuzz.h:124
diff --git a/_r_e_a_d_m_e_8md_source.html b/_r_e_a_d_m_e_8md_source.html index 8518808d..bf006baf 100644 --- a/_r_e_a_d_m_e_8md_source.html +++ b/_r_e_a_d_m_e_8md_source.html @@ -63,7 +63,7 @@ $(function() {
README.md
-Go to the documentation of this file.
1 # USB Host Library Rev. 2.0
2 
3 The code is released under the GNU General Public License.
4 __________
5 [![](https://github.com/felis/USB_Host_Shield_2.0/workflows/CI/badge.svg)](https://github.com/felis/USB_Host_Shield_2.0/actions?query=branch%3Amaster)
6 
7 # Summary
8 This is Revision 2.0 of MAX3421E-based USB Host Shield Library for AVR's.
9 
10 Project main web site is: <https://chome.nerpa.tech/arduino_usb_host_shield_projects/>.
11 
12 Some information can also be found at: <http://blog.tkjelectronics.dk/>.
13 
14 The shield can be purchased from [TKJ Electronics](http://tkjelectronics.com/): <http://shop.tkjelectronics.dk/product_info.php?products_id=43>.
15 
16 ![USB Host Shield](http://shop.tkjelectronics.dk/images/USB_Host_Shield1.jpg)
17 
18 For more information about the hardware see the [Hardware Manual](https://chome.nerpa.tech/usb-host-shield-hardware-manual/).
19 
20 # Developed By
21 
22 * __Oleg Mazurov__ - <mazurov@gmail.com>
23 * __Alexei Glushchenko__ - <alex-gl@mail.ru>
24  * Developers of the USB Core, HID, FTDI, ADK, ACM, and PL2303 libraries
25 * __Kristian Sloth Lauszus__ - <lauszus@gmail.com>
26  * Developer of the [BTD](#bluetooth-libraries), [BTHID](#bthid-library), [SPP](#spp-library), [PS4](#ps4-library), [PS3](#ps3-library), [Wii](#wii-library), [Xbox](#xbox-library), and [PSBuzz](#ps-buzz-library) libraries
27 * __Andrew Kroll__ - <xxxajk@gmail.com>
28  * Major contributor to mass storage code
29 * __guruthree__
30  * [Xbox ONE](#xbox-one-library) controller support
31 * __Yuuichi Akagawa__ - [\@YuuichiAkagawa](https://twitter.com/yuuichiakagawa)
32  * Developer of the [MIDI](#midi-library) library
33 
34 
35 # Table of Contents
36 
37 * [How to include the library](#how-to-include-the-library)
38  * [Arduino Library Manager](#arduino-library-manager)
39  * [Manual installation](#manual-installation)
40 * [How to use the library](#how-to-use-the-library)
41  * [Documentation](#documentation)
42  * [Enable debugging](#enable-debugging)
43  * [Boards](#boards)
44  * [Bluetooth libraries](#bluetooth-libraries)
45  * [BTHID library](#bthid-library)
46  * [SPP library](#spp-library)
47  * [PS4 Library](#ps4-library)
48  * [PS3 Library](#ps3-library)
49  * [Xbox Libraries](#xbox-libraries)
50  * [Xbox library](#xbox-library)
51  * [Xbox 360 Library](#xbox-360-library)
52  * [Xbox ONE Library](#xbox-one-library)
53  * [Xbox ONE S Library](#xbox-one-s-library)
54  * [Wii library](#wii-library)
55  * [PS Buzz Library](#ps-buzz-library)
56  * [HID Libraries](#hid-libraries)
57  * [MIDI Library](#midi-library)
58 * [Interface modifications](#interface-modifications)
59 * [FAQ](#faq)
60 
61 # How to include the library
62 
63 ### Arduino Library Manager
64 
65 First install Arduino IDE version 1.6.2 or newer, then simply use the Arduino Library Manager to install the library.
66 
67 Please see the following page for instructions: <http://www.arduino.cc/en/Guide/Libraries#toc3>.
68 
69 ### Manual installation
70 
71 First download the library by clicking on the following link: <https://github.com/felis/USB_Host_Shield_2.0/archive/master.zip>.
72 
73 Then uncompress the zip folder and rename the directory to "USB\_Host\_Shield\_20", as any special characters are not supported by the Arduino IDE.
74 
75 Now open up the Arduino IDE and open "File>Preferences". There you will see the location of your sketchbook. Open that directory and create a directory called "libraries" inside that directory.
76 Now move the "USB\_Host\_Shield\_20" directory to the "libraries" directory.
77 
78 The final structure should look like this:
79 
80 * Arduino/
81  * libraries/
82  * USB\_Host\_Shield\_20/
83 
84 Now quit the Arduino IDE and reopen it.
85 
86 Now you should be able to go open all the examples codes by navigating to "File>Examples>USB\_Host\_Shield\_20" and then select the example you will like to open.
87 
88 For more information visit the following sites: <http://arduino.cc/en/Guide/Libraries> and <https://learn.adafruit.com/adafruit-all-about-arduino-libraries-install-use>.
89 
90 # How to use the library
91 
92 ### Documentation
93 
94 Documentation for the library can be found at the following link: <https://felis.github.io/USB_Host_Shield_2.0/>.
95 
96 ### Enable debugging
97 
98 By default serial debugging is disabled. To turn it on simply change ```ENABLE_UHS_DEBUGGING``` to 1 in [settings.h](settings.h) like so:
99 
100 ```C++
101 #define ENABLE_UHS_DEBUGGING 1
102 ```
103 
104 ### Boards
105 
106 Currently the following boards are supported by the library:
107 
108 * All official Arduino AVR boards (Uno, Duemilanove, Mega, Mega 2560, Mega ADK, Leonardo etc.)
109 * Arduino Due, Intel Galileo, Intel Galileo 2, and Intel Edison
110  * Note that the Intel Galileo uses pin 2 and 3 as INT and SS pin respectively by default, so some modifications to the shield are needed. See the "Interface modifications" section in the [hardware manual](https://chome.nerpa.tech/usb-host-shield-hardware-manual) for more information.
111  * Note native USB host is not supported on any of these platforms. You will have to use the shield for now.
112 * Teensy (Teensy++ 1.0, Teensy 2.0, Teensy++ 2.0, Teensy 3.x, Teensy LC and Teensy 4.x)
113  * Note if you are using the Teensy 3.x you should download this SPI library as well: <https://github.com/xxxajk/spi4teensy3>. You should then add ```#include <spi4teensy3.h>``` to your .ino file.
114 * Balanduino
115 * Sanguino
116 * Black Widdow
117 * RedBearLab nRF51822
118 * Digilent chipKIT
119  * Please see: <https://chome.nerpa.tech/mcu/usb/running-usb-host-code-on-digilent-chipkit-board>.
120 * STM32F4
121  * Currently the [NUCLEO-F446RE](http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1847/PF262063) is supported featuring the STM32F446. Take a look at the following example code: <https://github.com/Lauszus/Nucleo_F446RE_USBHost>.
122 * ESP8266 is supported using the [ESP8266 Arduino core](https://github.com/esp8266/Arduino)
123  * Note it uses pin 15 and 5 for SS and INT respectively
124  * Also please be aware that:
125  * GPIO16 is **NOT** usable, as it will be used for some other purposes. For example, reset the SoC itself from sleep mode.
126  * GPIO6 to 11 is also **NOT** usable, as they are used to connect SPI flash chip and it is used for storing the executable binary content.
127 * ESP32 is supported using the [arduino-esp32](https://github.com/espressif/arduino-esp32/)
128  * GPIO5 : SS, GPIO17 : INT, GPIO18 : SCK, GPIO19 : MISO, GPIO23 : MOSI
129 
130 The following boards need to be activated manually in [settings.h](settings.h):
131 
132 * Arduino Mega ADK
133  * If you are using Arduino 1.5.5 or newer there is no need to activate the Arduino Mega ADK manually
134 * Black Widdow
135 
136 Simply set the corresponding value to 1 instead of 0.
137 
138 ### [Bluetooth libraries](BTD.cpp)
139 
140 The [BTD library](BTD.cpp) is a general purpose library for an ordinary Bluetooth dongle.
141 This library make it easy to add support for different Bluetooth services like a PS3 or a Wii controller or SPP which is a virtual serial port via Bluetooth.
142 Some different examples can be found in the [example directory](examples/Bluetooth).
143 
144 The BTD library also makes it possible to use multiple services at once, the following example sketch is an example of this:
145 [PS3SPP.ino](examples/Bluetooth/PS3SPP/PS3SPP.ino).
146 
147 ### [BTHID library](BTHID.cpp)
148 
149 The [Bluetooth HID library](BTHID.cpp) allows you to connect HID devices via Bluetooth to the USB Host Shield.
150 
151 Currently HID mice and keyboards are supported.
152 
153 It uses the standard Boot protocol by default, but it is also able to use the Report protocol as well. You would simply have to call ```setProtocolMode()``` and then parse ```HID_RPT_PROTOCOL``` as an argument. You will then have to modify the parser for your device. See the example: [BTHID.ino](examples/Bluetooth/BTHID/BTHID.ino) for more information.
154 
155 The [PS4 library](#ps4-library) also uses this class to handle all Bluetooth communication.
156 
157 For information see the following blog post: <http://blog.tkjelectronics.dk/2013/12/bluetooth-hid-devices-now-supported-by-the-usb-host-library/>.
158 
159 ### [SPP library](SPP.cpp)
160 
161 SPP stands for "Serial Port Profile" and is a Bluetooth protocol that implements a virtual comport which allows you to send data back and forth from your computer/phone to your Arduino via Bluetooth.
162 It has been tested successfully on Windows, Mac OS X, Linux, and Android.
163 
164 Take a look at the [SPP.ino](examples/Bluetooth/SPP/SPP.ino) example for more information.
165 
166 More information can be found at these blog posts:
167 
168 * <http://chome.nerpa.tech/mcu/bluetooth-rfcommspp-service-support-for-usb-host-2-0-library-released>
169 * <http://blog.tkjelectronics.dk/2012/07/rfcommspp-library-for-arduino/>
170 
171 To implement the SPP protocol I used a Bluetooth sniffing tool called [PacketLogger](http://www.tkjelectronics.com/uploads/PacketLogger.zip) developed by Apple.
172 It enables me to see the Bluetooth communication between my Mac and any device.
173 
174 ### PS4 Library
175 
176 The PS4BT library is split up into the [PS4BT](PS4BT.h) and the [PS4USB](PS4USB.h) library. These allow you to use the Sony PS4 controller via Bluetooth and USB.
177 
178 The [PS4BT.ino](examples/Bluetooth/PS4BT/PS4BT.ino) and [PS4USB.ino](examples/PS4USB/PS4USB.ino) examples shows how to easily read the buttons, joysticks, touchpad and IMU on the controller via Bluetooth and USB respectively. It is also possible to control the rumble and light on the controller and get the battery level.
179 
180 Before you can use the PS4 controller via Bluetooth you will need to pair with it.
181 
182 Simply create the PS4BT instance like so: ```PS4BT PS4(&Btd, PAIR);``` and then hold down the Share button and then hold down the PS without releasing the Share button. The PS4 controller will then start to blink rapidly indicating that it is in pairing mode.
183 
184 It should then automatically pair the dongle with your controller. This only have to be done once.
185 
186 For information see the following blog post: <http://blog.tkjelectronics.dk/2014/01/ps4-controller-now-supported-by-the-usb-host-library/>.
187 
188 Also check out this excellent Wiki by Frank Zhao about the PS4 controller: <http://eleccelerator.com/wiki/index.php?title=DualShock_4> and this Linux driver: <https://github.com/chrippa/ds4drv>.
189 
190 Several guides on how to use the PS4 library has been written by Dr. James E. Barger and are available at the following link: <https://sites.google.com/view/crosswaystation/ps4-tutorials>.
191 
192 ### PS3 Library
193 
194 These libraries consist of the [PS3BT](PS3BT.cpp) and [PS3USB](PS3USB.cpp). These libraries allows you to use a Dualshock 3, Navigation or a Motion controller with the USB Host Shield both via Bluetooth and USB.
195 
196 In order to use your Playstation controller via Bluetooth you have to set the Bluetooth address of the dongle internally to your PS3 Controller. This can be achieved by first plugging in the Bluetooth dongle and wait a few seconds. Now plug in the controller via USB and wait until the LEDs start to flash. The library has now written the Bluetooth address of the dongle to the PS3 controller.
197 
198 Finally simply plug in the Bluetooth dongle again and press PS on the PS3 controller. After a few seconds it should be connected to the dongle and ready to use.
199 
200 __Note:__ You will have to plug in the Bluetooth dongle before connecting the controller, as the library needs to read the address of the dongle. Alternatively you could set it in code like so: [PS3BT.ino#L20](examples/Bluetooth/PS3BT/PS3BT.ino#L20).
201 
202 For more information about the PS3 protocol see the official wiki: <https://github.com/felis/USB_Host_Shield_2.0/wiki/PS3-Information>.
203 
204 Also take a look at the blog posts:
205 
206 * <http://blog.tkjelectronics.dk/2012/01/ps3-controller-bt-library-for-arduino/>
207 * <http://chome.nerpa.tech/mcu/sony-ps3-controller-support-added-to-usb-host-library>
208 * <http://chome.nerpa.tech/mcu/arduino/interfacing-ps3-controllers-via-usb>
209 
210 A special thanks go to the following people:
211 
212 1. _Richard Ibbotson_ who made this excellent guide: <http://chome.nerpa.tech/mcu/ps3-and-wiimote-game-controllers-on-the-arduino-host-shield-part>
213 2. _Tomoyuki Tanaka_ for releasing his code for the Arduino USB Host shield connected to the wiimote: <http://chome.nerpa.tech/mcu/rc-car-controlled-by-wii-remote-on-arduino>
214 
215 Also a big thanks all the people behind these sites about the Motion controller:
216 
217 * <http://thp.io/2010/psmove/>
218 * <http://www.copenhagengamecollective.org/unimove/>
219 * <https://github.com/thp/psmoveapi>
220 * <http://code.google.com/p/moveonpc/>
221 
222 ### Xbox Libraries
223 
224 The library supports both the original Xbox controller via USB and the Xbox 360 controller both via USB and wirelessly.
225 
226 #### Xbox library
227 
228 The [XBOXOLD](XBOXOLD.cpp) class implements support for the original Xbox controller via USB.
229 
230 All the information are from the following sites:
231 
232 * <https://github.com/torvalds/linux/blob/master/Documentation/input/xpad.txt>
233 * <https://github.com/torvalds/linux/blob/master/drivers/input/joystick/xpad.c>
234 * <http://euc.jp/periphs/xbox-controller.ja.html>
235 * <https://github.com/Grumbel/xboxdrv/blob/master/PROTOCOL#L15>
236 
237 #### Xbox 360 Library
238 
239 The library support one Xbox 360 via USB or up to four Xbox 360 controllers wirelessly by using a [Xbox 360 wireless receiver](http://blog.tkjelectronics.dk/wp-content/uploads/xbox360-wireless-receiver.jpg).
240 
241 To use it via USB use the [XBOXUSB](XBOXUSB.cpp) library or to use it wirelessly use the [XBOXRECV](XBOXRECV.cpp) library.
242 
243 __Note that a Wireless controller can NOT be used via USB!__
244 
245 Examples code can be found in the [examples directory](examples/Xbox).
246 
247 Also see the following blog posts:
248 
249 * <http://chome.nerpa.tech/mcu/xbox360-controller-support-added-to-usb-host-shield-2-0-library>
250 * <http://blog.tkjelectronics.dk/2012/07/xbox-360-controller-support-added-to-the-usb-host-library/>
251 * <http://blog.tkjelectronics.dk/2012/12/xbox-360-receiver-added-to-the-usb-host-library/>
252 
253 All the information regarding the Xbox 360 controller protocol are form these sites:
254 
255 * <http://tattiebogle.net/index.php/ProjectRoot/Xbox360Controller/UsbInfo>
256 * <http://tattiebogle.net/index.php/ProjectRoot/Xbox360Controller/WirelessUsbInfo>
257 * <https://github.com/Grumbel/xboxdrv/blob/master/PROTOCOL>
258 
259 #### Xbox ONE Library
260 
261 A Xbox ONE controller is supported via USB in the [XBOXONE](XBOXONE.cpp) class. It is heavily based on the 360 library above. In addition to cross referencing the above, information on the protocol was found at:
262 
263 * <https://github.com/quantus/xbox-one-controller-protocol>
264 * <https://github.com/torvalds/linux/blob/master/drivers/input/joystick/xpad.c>
265 * <https://github.com/kylelemons/xbox/blob/master/xbox.go>
266 
267 #### Xbox ONE S Library
268 
269 A Xbox ONE controller is supported via Bluetooth in the [XBOXONESBT](XBOXONESBT.cpp) class.
270 
271 Special thanks to [HisashiKato](https://github.com/HisashiKato) for his help: <https://github.com/felis/USB_Host_Shield_2.0/issues/252#issuecomment-716912362>.
272 
273 ### [Wii library](Wii.cpp)
274 
275 The [Wii](Wii.cpp) library support the Wiimote, but also the Nunchuch and Motion Plus extensions via Bluetooth. The Wii U Pro Controller and Wii Balance Board are also supported via Bluetooth.
276 
277 First you have to pair with the controller, this is done automatically by the library if you create the instance like so:
278 
279 ```C++
280 WII Wii(&Btd, PAIR);
281 ```
282 
283 And then press 1 & 2 at once on the Wiimote or the SYNC buttons if you are using a Wii U Pro Controller or a Wii Balance Board.
284 
285 After that you can simply create the instance like so:
286 
287 ```C++
288 WII Wii(&Btd);
289 ```
290 
291 Then just press any button on the Wiimote and it will then connect to the dongle.
292 
293 Take a look at the example for more information: [Wii.ino](examples/Bluetooth/Wii/Wii.ino).
294 
295 Also take a look at the blog post:
296 
297 * <http://blog.tkjelectronics.dk/2012/08/wiimote-added-to-usb-host-library/>
298 
299 The Wii IR camera can also be used, but you will have to activate the code for it manually as it is quite large. Simply set ```ENABLE_WII_IR_CAMERA``` to 1 in [settings.h](settings.h).
300 
301 The [WiiIRCamera.ino](examples/Bluetooth/WiiIRCamera/WiiIRCamera.ino) example shows how it can be used.
302 
303 All the information about the Wii controllers are from these sites:
304 
305 * <http://wiibrew.org/wiki/Wiimote>
306 * <http://wiibrew.org/wiki/Wiimote/Extension_Controllers>
307 * <http://wiibrew.org/wiki/Wiimote/Extension_Controllers/Nunchuck>
308 * <http://wiibrew.org/wiki/Wiimote/Extension_Controllers/Wii_Motion_Plus>
309 * <http://wiibrew.org/wiki/Wii_Balance_Board>
310 * The old library created by _Tomoyuki Tanaka_: <https://github.com/moyuchin/WiiRemote_on_Arduino> also helped a lot.
311 
312 ### [PS Buzz Library](PSBuzz.cpp)
313 
314 This library implements support for the Playstation Buzz controllers via USB.
315 
316 It is essentially just a wrapper around the [HIDUniversal](hiduniversal.cpp) which takes care of the initializing and reading of the controllers. The [PSBuzz](PSBuzz.cpp) class simply inherits this and parses the data, so it is easy for users to read the buttons and turn the big red button on the controllers on and off.
317 
318 The example [PSBuzz.ino](examples/PSBuzz/PSBuzz.ino) shows how one can do this with just a few lines of code.
319 
320 More information about the controller can be found at the following sites:
321 
322 * http://www.developerfusion.com/article/84338/making-usb-c-friendly/
323 * https://github.com/torvalds/linux/blob/master/drivers/hid/hid-sony.c
324 
325 ### HID Libraries
326 
327 HID devices are also supported by the library. However these require you to write your own driver. A few example are provided in the [examples/HID](examples/HID) directory. Including an example for the [SteelSeries SRW-S1 Steering Wheel](examples/HID/SRWS1/SRWS1.ino).
328 
329 ### [MIDI Library](usbh_midi.cpp)
330 
331 The library support MIDI devices.
332 You can convert USB MIDI keyboard to legacy serial MIDI.
333 
334 * [USB_MIDI_converter.ino](examples/USBH_MIDI/USB_MIDI_converter/USB_MIDI_converter.ino)
335 * [USB_MIDI_converter_multi.ino](examples/USBH_MIDI/USB_MIDI_converter_multi/USB_MIDI_converter_multi.ino)
336 
337 For information see the following page: <http://yuuichiakagawa.github.io/USBH_MIDI/>.
338 
339 # Interface modifications
340 
341 The shield is using SPI for communicating with the MAX3421E USB host controller. It uses the SCK, MISO and MOSI pins via the ICSP on your board.
342 
343 Note this means that it uses pin 13, 12, 11 on an Arduino Uno, so these pins can not be used for anything else than SPI communication!
344 
345 Furthermore it uses one pin as SS and one INT pin. These are by default located on pin 10 and 9 respectively. They can easily be reconfigured in case you need to use them for something else by cutting the jumper on the shield and then solder a wire from the pad to the new pin.
346 
347 After that you need modify the following entry in [UsbCore.h](UsbCore.h):
348 
349 ```C++
350 typedef MAX3421e<P10, P9> MAX3421E;
351 ```
352 
353 For instance if you have rerouted SS to pin 7 it should read:
354 
355 ```C++
356 typedef MAX3421e<P7, P9> MAX3421E;
357 ```
358 
359 See the "Interface modifications" section in the [hardware manual](https://chome.nerpa.tech/usb-host-shield-hardware-manual) for more information.
360 
361 # FAQ
362 
363 > When I plug my device into the USB connector nothing happens?
364 
365 * Try to connect a external power supply to the Arduino - this solves the problem in most cases.
366 * You can also use a powered hub between the device and the USB Host Shield. You should then include the USB hub library: ```#include <usbhub.h>``` and create the instance like so: ```USBHub Hub1(&Usb);```.
367 
368 > When I connecting my PS3 controller I get a output like this:
369 
370 ```
371 Dualshock 3 Controller Enabled
372 
373 LeftHatX: 0 LeftHatY: 0 RightHatX: 0 RightHatY: 0
374 LeftHatX: 0 LeftHatY: 0 RightHatX: 0 RightHatY: 0
375 LeftHatX: 0 LeftHatY: 0 RightHatX: 0 RightHatY: 0
376 LeftHatX: 0 LeftHatY: 0 RightHatX: 0 RightHatY: 0
377 LeftHatX: 0 LeftHatY: 0 RightHatX: 0 RightHatY: 0
378 ```
379 
380 * This means that your dongle does not support 2.0+EDR, so you will need another dongle. Please see the following [list](https://github.com/felis/USB_Host_Shield_2.0/wiki/Bluetooth-dongles) for tested working dongles.
381 
382 > When compiling I am getting the following error: "fatal error: SPI.h: No such file or directory".
383 
384 * Please make sure to include the SPI library like so: ```#include <SPI.h>``` in your .ino file.
+Go to the documentation of this file.
1 # USB Host Library Rev. 2.0
2 
3 The code is released under the GNU General Public License.
4 __________
5 [![](https://github.com/felis/USB_Host_Shield_2.0/workflows/CI/badge.svg)](https://github.com/felis/USB_Host_Shield_2.0/actions?query=branch%3Amaster)
6 
7 # Summary
8 This is Revision 2.0 of MAX3421E-based USB Host Shield Library for AVR's.
9 
10 Project main web site is: <https://chome.nerpa.tech/arduino_usb_host_shield_projects/>.
11 
12 Some information can also be found at: <http://blog.tkjelectronics.dk/>.
13 
14 The shield can be purchased from [TKJ Electronics](http://tkjelectronics.com/): <http://shop.tkjelectronics.dk/product_info.php?products_id=43>.
15 
16 ![USB Host Shield](http://shop.tkjelectronics.dk/images/USB_Host_Shield1.jpg)
17 
18 For more information about the hardware see the [Hardware Manual](https://chome.nerpa.tech/usb-host-shield-hardware-manual/).
19 
20 # Developed By
21 
22 * __Oleg Mazurov__ - <mazurov@gmail.com>
23 * __Alexei Glushchenko__ - <alex-gl@mail.ru>
24  * Developers of the USB Core, HID, FTDI, ADK, ACM, and PL2303 libraries
25 * __Kristian Sloth Lauszus__ - <lauszus@gmail.com>
26  * Developer of the [BTD](#bluetooth-libraries), [BTHID](#bthid-library), [SPP](#spp-library), [PS5](#ps5-library), [PS4](#ps4-library), [PS3](#ps3-library), [Wii](#wii-library), [Xbox](#xbox-library), and [PSBuzz](#ps-buzz-library) libraries
27 * __Andrew Kroll__ - <xxxajk@gmail.com>
28  * Major contributor to mass storage code
29 * __guruthree__
30  * [Xbox ONE](#xbox-one-library) controller support
31 * __Yuuichi Akagawa__ - [\@YuuichiAkagawa](https://twitter.com/yuuichiakagawa)
32  * Developer of the [MIDI](#midi-library) library
33 
34 
35 # Table of Contents
36 
37 * [How to include the library](#how-to-include-the-library)
38  * [Arduino Library Manager](#arduino-library-manager)
39  * [Manual installation](#manual-installation)
40 * [How to use the library](#how-to-use-the-library)
41  * [Documentation](#documentation)
42  * [Enable debugging](#enable-debugging)
43  * [Boards](#boards)
44  * [Bluetooth libraries](#bluetooth-libraries)
45  * [BTHID library](#bthid-library)
46  * [SPP library](#spp-library)
47  * [PS5 Library](#ps5-library)
48  * [PS4 Library](#ps4-library)
49  * [PS3 Library](#ps3-library)
50  * [Xbox Libraries](#xbox-libraries)
51  * [Xbox library](#xbox-library)
52  * [Xbox 360 Library](#xbox-360-library)
53  * [Xbox ONE Library](#xbox-one-library)
54  * [Xbox ONE S Library](#xbox-one-s-library)
55  * [Wii library](#wii-library)
56  * [PS Buzz Library](#ps-buzz-library)
57  * [HID Libraries](#hid-libraries)
58  * [MIDI Library](#midi-library)
59 * [Interface modifications](#interface-modifications)
60 * [FAQ](#faq)
61 
62 # How to include the library
63 
64 ### Arduino Library Manager
65 
66 First install Arduino IDE version 1.6.2 or newer, then simply use the Arduino Library Manager to install the library.
67 
68 Please see the following page for instructions: <http://www.arduino.cc/en/Guide/Libraries#toc3>.
69 
70 ### Manual installation
71 
72 First download the library by clicking on the following link: <https://github.com/felis/USB_Host_Shield_2.0/archive/master.zip>.
73 
74 Then uncompress the zip folder and rename the directory to "USB\_Host\_Shield\_20", as any special characters are not supported by the Arduino IDE.
75 
76 Now open up the Arduino IDE and open "File>Preferences". There you will see the location of your sketchbook. Open that directory and create a directory called "libraries" inside that directory.
77 Now move the "USB\_Host\_Shield\_20" directory to the "libraries" directory.
78 
79 The final structure should look like this:
80 
81 * Arduino/
82  * libraries/
83  * USB\_Host\_Shield\_20/
84 
85 Now quit the Arduino IDE and reopen it.
86 
87 Now you should be able to go open all the examples codes by navigating to "File>Examples>USB\_Host\_Shield\_20" and then select the example you will like to open.
88 
89 For more information visit the following sites: <http://arduino.cc/en/Guide/Libraries> and <https://learn.adafruit.com/adafruit-all-about-arduino-libraries-install-use>.
90 
91 # How to use the library
92 
93 ### Documentation
94 
95 Documentation for the library can be found at the following link: <https://felis.github.io/USB_Host_Shield_2.0/>.
96 
97 ### Enable debugging
98 
99 By default serial debugging is disabled. To turn it on simply change ```ENABLE_UHS_DEBUGGING``` to 1 in [settings.h](settings.h) like so:
100 
101 ```C++
102 #define ENABLE_UHS_DEBUGGING 1
103 ```
104 
105 ### Boards
106 
107 Currently the following boards are supported by the library:
108 
109 * All official Arduino AVR boards (Uno, Duemilanove, Mega, Mega 2560, Mega ADK, Leonardo etc.)
110 * Arduino Due, Intel Galileo, Intel Galileo 2, and Intel Edison
111  * Note that the Intel Galileo uses pin 2 and 3 as INT and SS pin respectively by default, so some modifications to the shield are needed. See the "Interface modifications" section in the [hardware manual](https://chome.nerpa.tech/usb-host-shield-hardware-manual) for more information.
112  * Note native USB host is not supported on any of these platforms. You will have to use the shield for now.
113 * Teensy (Teensy++ 1.0, Teensy 2.0, Teensy++ 2.0, Teensy 3.x, Teensy LC and Teensy 4.x)
114  * Note if you are using the Teensy 3.x you should download this SPI library as well: <https://github.com/xxxajk/spi4teensy3>. You should then add ```#include <spi4teensy3.h>``` to your .ino file.
115 * Balanduino
116 * Sanguino
117 * Black Widdow
118 * RedBearLab nRF51822
119 * Digilent chipKIT
120  * Please see: <https://chome.nerpa.tech/mcu/usb/running-usb-host-code-on-digilent-chipkit-board>.
121 * STM32F4
122  * Currently the [NUCLEO-F446RE](http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1847/PF262063) is supported featuring the STM32F446. Take a look at the following example code: <https://github.com/Lauszus/Nucleo_F446RE_USBHost>.
123 * ESP8266 is supported using the [ESP8266 Arduino core](https://github.com/esp8266/Arduino)
124  * Note it uses pin 15 and 5 for SS and INT respectively
125  * Also please be aware that:
126  * GPIO16 is **NOT** usable, as it will be used for some other purposes. For example, reset the SoC itself from sleep mode.
127  * GPIO6 to 11 is also **NOT** usable, as they are used to connect SPI flash chip and it is used for storing the executable binary content.
128 * ESP32 is supported using the [arduino-esp32](https://github.com/espressif/arduino-esp32/)
129  * GPIO5 : SS, GPIO17 : INT, GPIO18 : SCK, GPIO19 : MISO, GPIO23 : MOSI
130 
131 The following boards need to be activated manually in [settings.h](settings.h):
132 
133 * Arduino Mega ADK
134  * If you are using Arduino 1.5.5 or newer there is no need to activate the Arduino Mega ADK manually
135 * Black Widdow
136 
137 Simply set the corresponding value to 1 instead of 0.
138 
139 ### [Bluetooth libraries](BTD.cpp)
140 
141 The [BTD library](BTD.cpp) is a general purpose library for an ordinary Bluetooth dongle.
142 This library make it easy to add support for different Bluetooth services like a PS3 or a Wii controller or SPP which is a virtual serial port via Bluetooth.
143 Some different examples can be found in the [example directory](examples/Bluetooth).
144 
145 The BTD library also makes it possible to use multiple services at once, the following example sketch is an example of this:
146 [PS3SPP.ino](examples/Bluetooth/PS3SPP/PS3SPP.ino).
147 
148 ### [BTHID library](BTHID.cpp)
149 
150 The [Bluetooth HID library](BTHID.cpp) allows you to connect HID devices via Bluetooth to the USB Host Shield.
151 
152 Currently HID mice and keyboards are supported.
153 
154 It uses the standard Boot protocol by default, but it is also able to use the Report protocol as well. You would simply have to call ```setProtocolMode()``` and then parse ```HID_RPT_PROTOCOL``` as an argument. You will then have to modify the parser for your device. See the example: [BTHID.ino](examples/Bluetooth/BTHID/BTHID.ino) for more information.
155 
156 The [PS4 library](#ps4-library) also uses this class to handle all Bluetooth communication.
157 
158 For information see the following blog post: <http://blog.tkjelectronics.dk/2013/12/bluetooth-hid-devices-now-supported-by-the-usb-host-library/>.
159 
160 ### [SPP library](SPP.cpp)
161 
162 SPP stands for "Serial Port Profile" and is a Bluetooth protocol that implements a virtual comport which allows you to send data back and forth from your computer/phone to your Arduino via Bluetooth.
163 It has been tested successfully on Windows, Mac OS X, Linux, and Android.
164 
165 Take a look at the [SPP.ino](examples/Bluetooth/SPP/SPP.ino) example for more information.
166 
167 More information can be found at these blog posts:
168 
169 * <http://chome.nerpa.tech/mcu/bluetooth-rfcommspp-service-support-for-usb-host-2-0-library-released>
170 * <http://blog.tkjelectronics.dk/2012/07/rfcommspp-library-for-arduino/>
171 
172 To implement the SPP protocol I used a Bluetooth sniffing tool called [PacketLogger](http://www.tkjelectronics.com/uploads/PacketLogger.zip) developed by Apple.
173 It enables me to see the Bluetooth communication between my Mac and any device.
174 
175 ### PS5 Library
176 
177 The PS5 library is split up into the [PS5BT](PS5BT.h) and the [PS5USB](PS5USB.h) library. These allow you to use the Sony PS5 controller via Bluetooth and USB.
178 
179 The [PS5BT.ino](examples/Bluetooth/PS5BT/PS5BT.ino) and [PS5USB.ino](examples/PS5USB/PS5USB.ino) examples shows how to easily read the buttons, joysticks, touchpad and IMU on the controller via Bluetooth and USB respectively. It is also possible to control the rumble, lightbar, microphone LED and player LEDs on the controller. Furthermore the new haptic trigger effects are also supported.
180 
181 To pair with the PS5 controller via Bluetooth you need create the PS5BT instance like so: ```PS5BT PS5(&Btd, PAIR);``` and then hold down the Create button and then hold down the PS without releasing the Create button. The PS5 controller will then start to blink blue indicating that it is in pairing mode.
182 
183 It should then automatically pair the dongle with your controller. This only have to be done once.
184 
185 Thanks to Joseph Duchesne for the initial USB code.
186 
187 The driver is based on the official Sony driver for Linux: <https://patchwork.kernel.org/project/linux-input/cover/20201219062336.72568-1-roderick@gaikai.com/>.
188 
189 Also thanks to Ludwig Füchsl's <https://github.com/Ohjurot/DualSense-Windows> for his work on the haptic triggers.
190 
191 ### PS4 Library
192 
193 The PS4 library is split up into the [PS4BT](PS4BT.h) and the [PS4USB](PS4USB.h) library. These allow you to use the Sony PS4 controller via Bluetooth and USB.
194 
195 The [PS4BT.ino](examples/Bluetooth/PS4BT/PS4BT.ino) and [PS4USB.ino](examples/PS4USB/PS4USB.ino) examples shows how to easily read the buttons, joysticks, touchpad and IMU on the controller via Bluetooth and USB respectively. It is also possible to control the rumble and light on the controller and get the battery level.
196 
197 Before you can use the PS4 controller via Bluetooth you will need to pair with it.
198 
199 Simply create the PS4BT instance like so: ```PS4BT PS4(&Btd, PAIR);``` and then hold down the Share button and then hold down the PS without releasing the Share button. The PS4 controller will then start to blink rapidly indicating that it is in pairing mode.
200 
201 It should then automatically pair the dongle with your controller. This only have to be done once.
202 
203 For information see the following blog post: <http://blog.tkjelectronics.dk/2014/01/ps4-controller-now-supported-by-the-usb-host-library/>.
204 
205 Also check out this excellent Wiki by Frank Zhao about the PS4 controller: <http://eleccelerator.com/wiki/index.php?title=DualShock_4> and this Linux driver: <https://github.com/chrippa/ds4drv>.
206 
207 Several guides on how to use the PS4 library has been written by Dr. James E. Barger and are available at the following link: <https://sites.google.com/view/crosswaystation/ps4-tutorials>.
208 
209 ### PS3 Library
210 
211 These libraries consist of the [PS3BT](PS3BT.cpp) and [PS3USB](PS3USB.cpp). These libraries allows you to use a Dualshock 3, Navigation or a Motion controller with the USB Host Shield both via Bluetooth and USB.
212 
213 In order to use your Playstation controller via Bluetooth you have to set the Bluetooth address of the dongle internally to your PS3 Controller. This can be achieved by first plugging in the Bluetooth dongle and wait a few seconds. Now plug in the controller via USB and wait until the LEDs start to flash. The library has now written the Bluetooth address of the dongle to the PS3 controller.
214 
215 Finally simply plug in the Bluetooth dongle again and press PS on the PS3 controller. After a few seconds it should be connected to the dongle and ready to use.
216 
217 __Note:__ You will have to plug in the Bluetooth dongle before connecting the controller, as the library needs to read the address of the dongle. Alternatively you could set it in code like so: [PS3BT.ino#L20](examples/Bluetooth/PS3BT/PS3BT.ino#L20).
218 
219 For more information about the PS3 protocol see the official wiki: <https://github.com/felis/USB_Host_Shield_2.0/wiki/PS3-Information>.
220 
221 Also take a look at the blog posts:
222 
223 * <http://blog.tkjelectronics.dk/2012/01/ps3-controller-bt-library-for-arduino/>
224 * <http://chome.nerpa.tech/mcu/sony-ps3-controller-support-added-to-usb-host-library>
225 * <http://chome.nerpa.tech/mcu/arduino/interfacing-ps3-controllers-via-usb>
226 
227 A special thanks go to the following people:
228 
229 1. _Richard Ibbotson_ who made this excellent guide: <http://chome.nerpa.tech/mcu/ps3-and-wiimote-game-controllers-on-the-arduino-host-shield-part>
230 2. _Tomoyuki Tanaka_ for releasing his code for the Arduino USB Host shield connected to the wiimote: <http://chome.nerpa.tech/mcu/rc-car-controlled-by-wii-remote-on-arduino>
231 
232 Also a big thanks all the people behind these sites about the Motion controller:
233 
234 * <http://thp.io/2010/psmove/>
235 * <http://www.copenhagengamecollective.org/unimove/>
236 * <https://github.com/thp/psmoveapi>
237 * <http://code.google.com/p/moveonpc/>
238 
239 ### Xbox Libraries
240 
241 The library supports both the original Xbox controller via USB and the Xbox 360 controller both via USB and wirelessly.
242 
243 #### Xbox library
244 
245 The [XBOXOLD](XBOXOLD.cpp) class implements support for the original Xbox controller via USB.
246 
247 All the information are from the following sites:
248 
249 * <https://github.com/torvalds/linux/blob/master/Documentation/input/xpad.txt>
250 * <https://github.com/torvalds/linux/blob/master/drivers/input/joystick/xpad.c>
251 * <http://euc.jp/periphs/xbox-controller.ja.html>
252 * <https://github.com/Grumbel/xboxdrv/blob/master/PROTOCOL#L15>
253 
254 #### Xbox 360 Library
255 
256 The library support one Xbox 360 via USB or up to four Xbox 360 controllers wirelessly by using a [Xbox 360 wireless receiver](http://blog.tkjelectronics.dk/wp-content/uploads/xbox360-wireless-receiver.jpg).
257 
258 To use it via USB use the [XBOXUSB](XBOXUSB.cpp) library or to use it wirelessly use the [XBOXRECV](XBOXRECV.cpp) library.
259 
260 __Note that a Wireless controller can NOT be used via USB!__
261 
262 Examples code can be found in the [examples directory](examples/Xbox).
263 
264 Also see the following blog posts:
265 
266 * <http://chome.nerpa.tech/mcu/xbox360-controller-support-added-to-usb-host-shield-2-0-library>
267 * <http://blog.tkjelectronics.dk/2012/07/xbox-360-controller-support-added-to-the-usb-host-library/>
268 * <http://blog.tkjelectronics.dk/2012/12/xbox-360-receiver-added-to-the-usb-host-library/>
269 
270 All the information regarding the Xbox 360 controller protocol are form these sites:
271 
272 * <http://tattiebogle.net/index.php/ProjectRoot/Xbox360Controller/UsbInfo>
273 * <http://tattiebogle.net/index.php/ProjectRoot/Xbox360Controller/WirelessUsbInfo>
274 * <https://github.com/Grumbel/xboxdrv/blob/master/PROTOCOL>
275 
276 #### Xbox ONE Library
277 
278 A Xbox ONE controller is supported via USB in the [XBOXONE](XBOXONE.cpp) class. It is heavily based on the 360 library above. In addition to cross referencing the above, information on the protocol was found at:
279 
280 * <https://github.com/quantus/xbox-one-controller-protocol>
281 * <https://github.com/torvalds/linux/blob/master/drivers/input/joystick/xpad.c>
282 * <https://github.com/kylelemons/xbox/blob/master/xbox.go>
283 
284 #### Xbox ONE S Library
285 
286 A Xbox ONE controller is supported via Bluetooth in the [XBOXONESBT](XBOXONESBT.cpp) class.
287 
288 Special thanks to [HisashiKato](https://github.com/HisashiKato) for his help: <https://github.com/felis/USB_Host_Shield_2.0/issues/252#issuecomment-716912362>.
289 
290 ### [Wii library](Wii.cpp)
291 
292 The [Wii](Wii.cpp) library support the Wiimote, but also the Nunchuch and Motion Plus extensions via Bluetooth. The Wii U Pro Controller and Wii Balance Board are also supported via Bluetooth.
293 
294 First you have to pair with the controller, this is done automatically by the library if you create the instance like so:
295 
296 ```C++
297 WII Wii(&Btd, PAIR);
298 ```
299 
300 And then press 1 & 2 at once on the Wiimote or the SYNC buttons if you are using a Wii U Pro Controller or a Wii Balance Board.
301 
302 After that you can simply create the instance like so:
303 
304 ```C++
305 WII Wii(&Btd);
306 ```
307 
308 Then just press any button on the Wiimote and it will then connect to the dongle.
309 
310 Take a look at the example for more information: [Wii.ino](examples/Bluetooth/Wii/Wii.ino).
311 
312 Also take a look at the blog post:
313 
314 * <http://blog.tkjelectronics.dk/2012/08/wiimote-added-to-usb-host-library/>
315 
316 The Wii IR camera can also be used, but you will have to activate the code for it manually as it is quite large. Simply set ```ENABLE_WII_IR_CAMERA``` to 1 in [settings.h](settings.h).
317 
318 The [WiiIRCamera.ino](examples/Bluetooth/WiiIRCamera/WiiIRCamera.ino) example shows how it can be used.
319 
320 All the information about the Wii controllers are from these sites:
321 
322 * <http://wiibrew.org/wiki/Wiimote>
323 * <http://wiibrew.org/wiki/Wiimote/Extension_Controllers>
324 * <http://wiibrew.org/wiki/Wiimote/Extension_Controllers/Nunchuck>
325 * <http://wiibrew.org/wiki/Wiimote/Extension_Controllers/Wii_Motion_Plus>
326 * <http://wiibrew.org/wiki/Wii_Balance_Board>
327 * The old library created by _Tomoyuki Tanaka_: <https://github.com/moyuchin/WiiRemote_on_Arduino> also helped a lot.
328 
329 ### [PS Buzz Library](PSBuzz.cpp)
330 
331 This library implements support for the Playstation Buzz controllers via USB.
332 
333 It is essentially just a wrapper around the [HIDUniversal](hiduniversal.cpp) which takes care of the initializing and reading of the controllers. The [PSBuzz](PSBuzz.cpp) class simply inherits this and parses the data, so it is easy for users to read the buttons and turn the big red button on the controllers on and off.
334 
335 The example [PSBuzz.ino](examples/PSBuzz/PSBuzz.ino) shows how one can do this with just a few lines of code.
336 
337 More information about the controller can be found at the following sites:
338 
339 * http://www.developerfusion.com/article/84338/making-usb-c-friendly/
340 * https://github.com/torvalds/linux/blob/master/drivers/hid/hid-sony.c
341 
342 ### HID Libraries
343 
344 HID devices are also supported by the library. However these require you to write your own driver. A few example are provided in the [examples/HID](examples/HID) directory. Including an example for the [SteelSeries SRW-S1 Steering Wheel](examples/HID/SRWS1/SRWS1.ino).
345 
346 ### [MIDI Library](usbh_midi.cpp)
347 
348 The library support MIDI devices.
349 You can convert USB MIDI keyboard to legacy serial MIDI.
350 
351 * [USB_MIDI_converter.ino](examples/USBH_MIDI/USB_MIDI_converter/USB_MIDI_converter.ino)
352 * [USB_MIDI_converter_multi.ino](examples/USBH_MIDI/USB_MIDI_converter_multi/USB_MIDI_converter_multi.ino)
353 
354 For information see the following page: <http://yuuichiakagawa.github.io/USBH_MIDI/>.
355 
356 # Interface modifications
357 
358 The shield is using SPI for communicating with the MAX3421E USB host controller. It uses the SCK, MISO and MOSI pins via the ICSP on your board.
359 
360 Note this means that it uses pin 13, 12, 11 on an Arduino Uno, so these pins can not be used for anything else than SPI communication!
361 
362 Furthermore it uses one pin as SS and one INT pin. These are by default located on pin 10 and 9 respectively. They can easily be reconfigured in case you need to use them for something else by cutting the jumper on the shield and then solder a wire from the pad to the new pin.
363 
364 After that you need modify the following entry in [UsbCore.h](UsbCore.h):
365 
366 ```C++
367 typedef MAX3421e<P10, P9> MAX3421E;
368 ```
369 
370 For instance if you have rerouted SS to pin 7 it should read:
371 
372 ```C++
373 typedef MAX3421e<P7, P9> MAX3421E;
374 ```
375 
376 See the "Interface modifications" section in the [hardware manual](https://chome.nerpa.tech/usb-host-shield-hardware-manual) for more information.
377 
378 # FAQ
379 
380 > When I plug my device into the USB connector nothing happens?
381 
382 * Try to connect a external power supply to the Arduino - this solves the problem in most cases.
383 * You can also use a powered hub between the device and the USB Host Shield. You should then include the USB hub library: ```#include <usbhub.h>``` and create the instance like so: ```USBHub Hub1(&Usb);```.
384 
385 > When I connecting my PS3 controller I get a output like this:
386 
387 ```
388 Dualshock 3 Controller Enabled
389 
390 LeftHatX: 0 LeftHatY: 0 RightHatX: 0 RightHatY: 0
391 LeftHatX: 0 LeftHatY: 0 RightHatX: 0 RightHatY: 0
392 LeftHatX: 0 LeftHatY: 0 RightHatX: 0 RightHatY: 0
393 LeftHatX: 0 LeftHatY: 0 RightHatX: 0 RightHatY: 0
394 LeftHatX: 0 LeftHatY: 0 RightHatX: 0 RightHatY: 0
395 ```
396 
397 * This means that your dongle does not support 2.0+EDR, so you will need another dongle. Please see the following [list](https://github.com/felis/USB_Host_Shield_2.0/wiki/Bluetooth-dongles) for tested working dongles.
398 
399 > When compiling I am getting the following error: "fatal error: SPI.h: No such file or directory".
400 
401 * Please make sure to include the SPI library like so: ```#include <SPI.h>``` in your .ino file.
Generated by   diff --git a/_usb_8cpp_source.html b/_usb_8cpp_source.html index dbed5ff7..c2022198 100644 --- a/_usb_8cpp_source.html +++ b/_usb_8cpp_source.html @@ -63,7 +63,7 @@ $(function() {
Usb.cpp
-Go to the documentation of this file.
1 /* Copyright (C) 2011 Circuits At Home, LTD. All rights reserved.
2 
3 This software may be distributed and modified under the terms of the GNU
4 General Public License version 2 (GPL2) as published by the Free Software
5 Foundation and appearing in the file GPL2.TXT included in the packaging of
6 this file. Please note that GPL2 Section 2[b] requires that all works based
7 on this software must also be made publicly available under the terms of
8 the GPL2 ("Copyleft").
9 
10 Contact information
11 -------------------
12 
13 Circuits At Home, LTD
14 Web : http://www.circuitsathome.com
15 e-mail : support@circuitsathome.com
16  */
17 /* USB functions */
18 
19 #include "Usb.h"
20 
21 static uint8_t usb_error = 0;
22 static uint8_t usb_task_state;
23 
24 /* constructor */
25 USB::USB() : bmHubPre(0) {
26  usb_task_state = USB_DETACHED_SUBSTATE_INITIALIZE; //set up state machine
27  init();
28 }
29 
30 /* Initialize data structures */
31 void USB::init() {
32  //devConfigIndex = 0;
33  bmHubPre = 0;
34 }
35 
36 uint8_t USB::getUsbTaskState(void) {
37  return ( usb_task_state);
38 }
39 
40 void USB::setUsbTaskState(uint8_t state) {
41  usb_task_state = state;
42 }
43 
44 EpInfo* USB::getEpInfoEntry(uint8_t addr, uint8_t ep) {
45  UsbDevice *p = addrPool.GetUsbDevicePtr(addr);
46 
47  if(!p || !p->epinfo)
48  return NULL;
49 
50  EpInfo *pep = p->epinfo;
51 
52  for(uint8_t i = 0; i < p->epcount; i++) {
53  if((pep)->epAddr == ep)
54  return pep;
55 
56  pep++;
57  }
58  return NULL;
59 }
60 
61 /* set device table entry */
62 
63 /* each device is different and has different number of endpoints. This function plugs endpoint record structure, defined in application, to devtable */
64 uint8_t USB::setEpInfoEntry(uint8_t addr, uint8_t epcount, EpInfo* eprecord_ptr) {
65  if(!eprecord_ptr)
66  return USB_ERROR_INVALID_ARGUMENT;
67 
68  UsbDevice *p = addrPool.GetUsbDevicePtr(addr);
69 
70  if(!p)
71  return USB_ERROR_ADDRESS_NOT_FOUND_IN_POOL;
72 
73  p->address.devAddress = addr;
74  p->epinfo = eprecord_ptr;
75  p->epcount = epcount;
76 
77  return 0;
78 }
79 
80 uint8_t USB::SetAddress(uint8_t addr, uint8_t ep, EpInfo **ppep, uint16_t *nak_limit) {
81  UsbDevice *p = addrPool.GetUsbDevicePtr(addr);
82 
83  if(!p)
84  return USB_ERROR_ADDRESS_NOT_FOUND_IN_POOL;
85 
86  if(!p->epinfo)
87  return USB_ERROR_EPINFO_IS_NULL;
88 
89  *ppep = getEpInfoEntry(addr, ep);
90 
91  if(!*ppep)
92  return USB_ERROR_EP_NOT_FOUND_IN_TBL;
93 
94  *nak_limit = (0x0001UL << (((*ppep)->bmNakPower > USB_NAK_MAX_POWER) ? USB_NAK_MAX_POWER : (*ppep)->bmNakPower));
95  (*nak_limit)--;
96  /*
97  USBTRACE2("\r\nAddress: ", addr);
98  USBTRACE2(" EP: ", ep);
99  USBTRACE2(" NAK Power: ",(*ppep)->bmNakPower);
100  USBTRACE2(" NAK Limit: ", nak_limit);
101  USBTRACE("\r\n");
102  */
103  regWr(rPERADDR, addr); //set peripheral address
104 
105  uint8_t mode = regRd(rMODE);
106 
107  //Serial.print("\r\nMode: ");
108  //Serial.println( mode, HEX);
109  //Serial.print("\r\nLS: ");
110  //Serial.println(p->lowspeed, HEX);
111 
112 
113 
114  // Set bmLOWSPEED and bmHUBPRE in case of low-speed device, reset them otherwise
115  regWr(rMODE, (p->lowspeed) ? mode | bmLOWSPEED | bmHubPre : mode & ~(bmHUBPRE | bmLOWSPEED));
116 
117  return 0;
118 }
119 
120 /* Control transfer. Sets address, endpoint, fills control packet with necessary data, dispatches control packet, and initiates bulk IN transfer, */
121 /* depending on request. Actual requests are defined as inlines */
122 /* return codes: */
123 /* 00 = success */
124 
125 /* 01-0f = non-zero HRSLT */
126 uint8_t USB::ctrlReq(uint8_t addr, uint8_t ep, uint8_t bmReqType, uint8_t bRequest, uint8_t wValLo, uint8_t wValHi,
127  uint16_t wInd, uint16_t total, uint16_t nbytes, uint8_t* dataptr, USBReadParser *p) {
128  bool direction = false; //request direction, IN or OUT
129  uint8_t rcode;
130  SETUP_PKT setup_pkt;
131 
132  EpInfo *pep = NULL;
133  uint16_t nak_limit = 0;
134 
135  rcode = SetAddress(addr, ep, &pep, &nak_limit);
136 
137  if(rcode)
138  return rcode;
139 
140  direction = ((bmReqType & 0x80) > 0);
141 
142  /* fill in setup packet */
143  setup_pkt.ReqType_u.bmRequestType = bmReqType;
144  setup_pkt.bRequest = bRequest;
145  setup_pkt.wVal_u.wValueLo = wValLo;
146  setup_pkt.wVal_u.wValueHi = wValHi;
147  setup_pkt.wIndex = wInd;
148  setup_pkt.wLength = total;
149 
150  bytesWr(rSUDFIFO, 8, (uint8_t*) & setup_pkt); //transfer to setup packet FIFO
151 
152  rcode = dispatchPkt(tokSETUP, ep, nak_limit); //dispatch packet
153 
154  if(rcode) //return HRSLT if not zero
155  return ( rcode);
156 
157  if(dataptr != NULL) //data stage, if present
158  {
159  if(direction) //IN transfer
160  {
161  uint16_t left = total;
162 
163  pep->bmRcvToggle = 1; //bmRCVTOG1;
164 
165  while(left) {
166  // Bytes read into buffer
167 #if defined(ESP8266) || defined(ESP32)
168  yield(); // needed in order to reset the watchdog timer on the ESP8266
169 #endif
170  uint16_t read = nbytes;
171  //uint16_t read = (left<nbytes) ? left : nbytes;
172 
173  rcode = InTransfer(pep, nak_limit, &read, dataptr);
174  if(rcode == hrTOGERR) {
175  // yes, we flip it wrong here so that next time it is actually correct!
176  pep->bmRcvToggle = (regRd(rHRSL) & bmSNDTOGRD) ? 0 : 1;
177  continue;
178  }
179 
180  if(rcode)
181  return rcode;
182 
183  // Invoke callback function if inTransfer completed successfully and callback function pointer is specified
184  if(!rcode && p)
185  ((USBReadParser*)p)->Parse(read, dataptr, total - left);
186 
187  left -= read;
188 
189  if(read < nbytes)
190  break;
191  }
192  } else //OUT transfer
193  {
194  pep->bmSndToggle = 1; //bmSNDTOG1;
195  rcode = OutTransfer(pep, nak_limit, nbytes, dataptr);
196  }
197  if(rcode) //return error
198  return ( rcode);
199  }
200  // Status stage
201  return dispatchPkt((direction) ? tokOUTHS : tokINHS, ep, nak_limit); //GET if direction
202 }
203 
204 /* IN transfer to arbitrary endpoint. Assumes PERADDR is set. Handles multiple packets if necessary. Transfers 'nbytes' bytes. */
205 /* Keep sending INs and writes data to memory area pointed by 'data' */
206 
207 /* rcode 0 if no errors. rcode 01-0f is relayed from dispatchPkt(). Rcode f0 means RCVDAVIRQ error,
208  fe USB xfer timeout */
209 uint8_t USB::inTransfer(uint8_t addr, uint8_t ep, uint16_t *nbytesptr, uint8_t* data, uint8_t bInterval /*= 0*/) {
210  EpInfo *pep = NULL;
211  uint16_t nak_limit = 0;
212 
213  uint8_t rcode = SetAddress(addr, ep, &pep, &nak_limit);
214 
215  if(rcode) {
216  USBTRACE3("(USB::InTransfer) SetAddress Failed ", rcode, 0x81);
217  USBTRACE3("(USB::InTransfer) addr requested ", addr, 0x81);
218  USBTRACE3("(USB::InTransfer) ep requested ", ep, 0x81);
219  return rcode;
220  }
221  return InTransfer(pep, nak_limit, nbytesptr, data, bInterval);
222 }
223 
224 uint8_t USB::InTransfer(EpInfo *pep, uint16_t nak_limit, uint16_t *nbytesptr, uint8_t* data, uint8_t bInterval /*= 0*/) {
225  uint8_t rcode = 0;
226  uint8_t pktsize;
227 
228  uint16_t nbytes = *nbytesptr;
229  //printf("Requesting %i bytes ", nbytes);
230  uint8_t maxpktsize = pep->maxPktSize;
231 
232  *nbytesptr = 0;
233  regWr(rHCTL, (pep->bmRcvToggle) ? bmRCVTOG1 : bmRCVTOG0); //set toggle value
234 
235  // use a 'break' to exit this loop
236  while(1) {
237 #if defined(ESP8266) || defined(ESP32)
238  yield(); // needed in order to reset the watchdog timer on the ESP8266
239 #endif
240  rcode = dispatchPkt(tokIN, pep->epAddr, nak_limit); //IN packet to EP-'endpoint'. Function takes care of NAKS.
241  if(rcode == hrTOGERR) {
242  // yes, we flip it wrong here so that next time it is actually correct!
243  pep->bmRcvToggle = (regRd(rHRSL) & bmRCVTOGRD) ? 0 : 1;
244  regWr(rHCTL, (pep->bmRcvToggle) ? bmRCVTOG1 : bmRCVTOG0); //set toggle value
245  continue;
246  }
247  if(rcode) {
248  //printf(">>>>>>>> Problem! dispatchPkt %2.2x\r\n", rcode);
249  break; //should be 0, indicating ACK. Else return error code.
250  }
251  /* check for RCVDAVIRQ and generate error if not present
252  * the only case when absence of RCVDAVIRQ makes sense is when toggle error occurred.
253  * Need to add handling for that
254  *
255  * NOTE: I've seen this happen with SPI corruption -- xxxajk
256  */
257  if((regRd(rHIRQ) & bmRCVDAVIRQ) == 0) {
258  //printf(">>>>>>>> Problem! NO RCVDAVIRQ!\r\n");
259  rcode = 0xf0; //receive error
260  break;
261  }
262  pktsize = regRd(rRCVBC); //number of received bytes
263  //printf("Got %i bytes \r\n", pktsize);
264  // This would be OK, but...
265  //assert(pktsize <= nbytes);
266  if(pktsize > nbytes) {
267  // This can happen. Use of assert on Arduino locks up the Arduino.
268  // So I will trim the value, and hope for the best.
269  //printf(">>>>>>>> Problem! Wanted %i bytes but got %i.\r\n", nbytes, pktsize);
270  pktsize = nbytes;
271  }
272 
273  int16_t mem_left = (int16_t)nbytes - *((int16_t*)nbytesptr);
274 
275  if(mem_left < 0)
276  mem_left = 0;
277 
278  data = bytesRd(rRCVFIFO, ((pktsize > mem_left) ? mem_left : pktsize), data);
279 
280  regWr(rHIRQ, bmRCVDAVIRQ); // Clear the IRQ & free the buffer
281  *nbytesptr += pktsize; // add this packet's byte count to total transfer length
282 
283  /* The transfer is complete under two conditions: */
284  /* 1. The device sent a short packet (L.T. maxPacketSize) */
285  /* 2. 'nbytes' have been transferred. */
286  if((pktsize < maxpktsize) || (*nbytesptr >= nbytes)) // have we transferred 'nbytes' bytes?
287  {
288  // Save toggle value
289  pep->bmRcvToggle = ((regRd(rHRSL) & bmRCVTOGRD)) ? 1 : 0;
290  //printf("\r\n");
291  rcode = 0;
292  break;
293  } else if(bInterval > 0)
294  delay(bInterval); // Delay according to polling interval
295  } //while( 1 )
296  return ( rcode);
297 }
298 
299 /* OUT transfer to arbitrary endpoint. Handles multiple packets if necessary. Transfers 'nbytes' bytes. */
300 /* Handles NAK bug per Maxim Application Note 4000 for single buffer transfer */
301 
302 /* rcode 0 if no errors. rcode 01-0f is relayed from HRSL */
303 uint8_t USB::outTransfer(uint8_t addr, uint8_t ep, uint16_t nbytes, uint8_t* data) {
304  EpInfo *pep = NULL;
305  uint16_t nak_limit = 0;
306 
307  uint8_t rcode = SetAddress(addr, ep, &pep, &nak_limit);
308 
309  if(rcode)
310  return rcode;
311 
312  return OutTransfer(pep, nak_limit, nbytes, data);
313 }
314 
315 uint8_t USB::OutTransfer(EpInfo *pep, uint16_t nak_limit, uint16_t nbytes, uint8_t *data) {
316  uint8_t rcode = hrSUCCESS, retry_count;
317  uint8_t *data_p = data; //local copy of the data pointer
318  uint16_t bytes_tosend, nak_count;
319  uint16_t bytes_left = nbytes;
320 
321  uint8_t maxpktsize = pep->maxPktSize;
322 
323  if(maxpktsize < 1 || maxpktsize > 64)
324  return USB_ERROR_INVALID_MAX_PKT_SIZE;
325 
326  uint32_t timeout = (uint32_t)millis() + USB_XFER_TIMEOUT;
327 
328  regWr(rHCTL, (pep->bmSndToggle) ? bmSNDTOG1 : bmSNDTOG0); //set toggle value
329 
330  while(bytes_left) {
331 #if defined(ESP8266) || defined(ESP32)
332  yield(); // needed in order to reset the watchdog timer on the ESP8266
333 #endif
334  retry_count = 0;
335  nak_count = 0;
336  bytes_tosend = (bytes_left >= maxpktsize) ? maxpktsize : bytes_left;
337  bytesWr(rSNDFIFO, bytes_tosend, data_p); //filling output FIFO
338  regWr(rSNDBC, bytes_tosend); //set number of bytes
339  regWr(rHXFR, (tokOUT | pep->epAddr)); //dispatch packet
340  while(!(regRd(rHIRQ) & bmHXFRDNIRQ)){
341 #if defined(ESP8266) || defined(ESP32)
342  yield(); // needed in order to reset the watchdog timer on the ESP8266
343 #endif
344  } //wait for the completion IRQ
345  regWr(rHIRQ, bmHXFRDNIRQ); //clear IRQ
346  rcode = (regRd(rHRSL) & 0x0f);
347 
348  while(rcode && ((int32_t)((uint32_t)millis() - timeout) < 0L)) {
349 #if defined(ESP8266) || defined(ESP32)
350  yield(); // needed in order to reset the watchdog timer on the ESP8266
351 #endif
352  switch(rcode) {
353  case hrNAK:
354  nak_count++;
355  if(nak_limit && (nak_count == nak_limit))
356  goto breakout;
357  //return ( rcode);
358  break;
359  case hrTIMEOUT:
360  retry_count++;
361  if(retry_count == USB_RETRY_LIMIT)
362  goto breakout;
363  //return ( rcode);
364  break;
365  case hrTOGERR:
366  // yes, we flip it wrong here so that next time it is actually correct!
367  pep->bmSndToggle = (regRd(rHRSL) & bmSNDTOGRD) ? 0 : 1;
368  regWr(rHCTL, (pep->bmSndToggle) ? bmSNDTOG1 : bmSNDTOG0); //set toggle value
369  break;
370  default:
371  goto breakout;
372  }//switch( rcode
373 
374  /* process NAK according to Host out NAK bug */
375  regWr(rSNDBC, 0);
376  regWr(rSNDFIFO, *data_p);
377  regWr(rSNDBC, bytes_tosend);
378  regWr(rHXFR, (tokOUT | pep->epAddr)); //dispatch packet
379  while(!(regRd(rHIRQ) & bmHXFRDNIRQ)){
380 #if defined(ESP8266) || defined(ESP32)
381  yield(); // needed in order to reset the watchdog timer on the ESP8266
382 #endif
383  } //wait for the completion IRQ
384  regWr(rHIRQ, bmHXFRDNIRQ); //clear IRQ
385  rcode = (regRd(rHRSL) & 0x0f);
386  }//while( rcode && ....
387  bytes_left -= bytes_tosend;
388  data_p += bytes_tosend;
389  }//while( bytes_left...
390 breakout:
391 
392  pep->bmSndToggle = (regRd(rHRSL) & bmSNDTOGRD) ? 1 : 0; //bmSNDTOG1 : bmSNDTOG0; //update toggle
393  return ( rcode); //should be 0 in all cases
394 }
395 /* dispatch USB packet. Assumes peripheral address is set and relevant buffer is loaded/empty */
396 /* If NAK, tries to re-send up to nak_limit times */
397 /* If nak_limit == 0, do not count NAKs, exit after timeout */
398 /* If bus timeout, re-sends up to USB_RETRY_LIMIT times */
399 
400 /* return codes 0x00-0x0f are HRSLT( 0x00 being success ), 0xff means timeout */
401 uint8_t USB::dispatchPkt(uint8_t token, uint8_t ep, uint16_t nak_limit) {
402  uint32_t timeout = (uint32_t)millis() + USB_XFER_TIMEOUT;
403  uint8_t tmpdata;
404  uint8_t rcode = hrSUCCESS;
405  uint8_t retry_count = 0;
406  uint16_t nak_count = 0;
407 
408  while((int32_t)((uint32_t)millis() - timeout) < 0L) {
409 #if defined(ESP8266) || defined(ESP32)
410  yield(); // needed in order to reset the watchdog timer on the ESP8266
411 #endif
412  regWr(rHXFR, (token | ep)); //launch the transfer
413  rcode = USB_ERROR_TRANSFER_TIMEOUT;
414 
415  while((int32_t)((uint32_t)millis() - timeout) < 0L) //wait for transfer completion
416  {
417 #if defined(ESP8266) || defined(ESP32)
418  yield(); // needed in order to reset the watchdog timer on the ESP8266
419 #endif
420  tmpdata = regRd(rHIRQ);
421 
422  if(tmpdata & bmHXFRDNIRQ) {
423  regWr(rHIRQ, bmHXFRDNIRQ); //clear the interrupt
424  rcode = 0x00;
425  break;
426  }//if( tmpdata & bmHXFRDNIRQ
427 
428  }//while ( millis() < timeout
429 
430  //if (rcode != 0x00) //exit if timeout
431  // return ( rcode);
432 
433  rcode = (regRd(rHRSL) & 0x0f); //analyze transfer result
434 
435  switch(rcode) {
436  case hrNAK:
437  nak_count++;
438  if(nak_limit && (nak_count == nak_limit))
439  return (rcode);
440  break;
441  case hrTIMEOUT:
442  retry_count++;
443  if(retry_count == USB_RETRY_LIMIT)
444  return (rcode);
445  break;
446  default:
447  return (rcode);
448  }//switch( rcode
449 
450  }//while( timeout > millis()
451  return ( rcode);
452 }
453 
454 /* USB main task. Performs enumeration/cleanup */
455 void USB::Task(void) //USB state machine
456 {
457  uint8_t rcode;
458  uint8_t tmpdata;
459  static uint32_t delay = 0;
460  //USB_DEVICE_DESCRIPTOR buf;
461  bool lowspeed = false;
462 
463  MAX3421E::Task();
464 
465  tmpdata = getVbusState();
466 
467  /* modify USB task state if Vbus changed */
468  switch(tmpdata) {
469  case SE1: //illegal state
470  usb_task_state = USB_DETACHED_SUBSTATE_ILLEGAL;
471  lowspeed = false;
472  break;
473  case SE0: //disconnected
474  if((usb_task_state & USB_STATE_MASK) != USB_STATE_DETACHED)
475  usb_task_state = USB_DETACHED_SUBSTATE_INITIALIZE;
476  lowspeed = false;
477  break;
478  case LSHOST:
479 
480  lowspeed = true;
481  //intentional fallthrough
482  case FSHOST: //attached
483  if((usb_task_state & USB_STATE_MASK) == USB_STATE_DETACHED) {
484  delay = (uint32_t)millis() + USB_SETTLE_DELAY;
485  usb_task_state = USB_ATTACHED_SUBSTATE_SETTLE;
486  }
487  break;
488  }// switch( tmpdata
489 
490  for(uint8_t i = 0; i < USB_NUMDEVICES; i++)
491  if(devConfig[i])
492  rcode = devConfig[i]->Poll();
493 
494  switch(usb_task_state) {
495  case USB_DETACHED_SUBSTATE_INITIALIZE:
496  init();
497 
498  for(uint8_t i = 0; i < USB_NUMDEVICES; i++)
499  if(devConfig[i])
500  rcode = devConfig[i]->Release();
501 
502  usb_task_state = USB_DETACHED_SUBSTATE_WAIT_FOR_DEVICE;
503  break;
504  case USB_DETACHED_SUBSTATE_WAIT_FOR_DEVICE: //just sit here
505  break;
506  case USB_DETACHED_SUBSTATE_ILLEGAL: //just sit here
507  break;
508  case USB_ATTACHED_SUBSTATE_SETTLE: //settle time for just attached device
509  if((int32_t)((uint32_t)millis() - delay) >= 0L)
510  usb_task_state = USB_ATTACHED_SUBSTATE_RESET_DEVICE;
511  else break; // don't fall through
512  case USB_ATTACHED_SUBSTATE_RESET_DEVICE:
513  regWr(rHCTL, bmBUSRST); //issue bus reset
514  usb_task_state = USB_ATTACHED_SUBSTATE_WAIT_RESET_COMPLETE;
515  break;
516  case USB_ATTACHED_SUBSTATE_WAIT_RESET_COMPLETE:
517  if((regRd(rHCTL) & bmBUSRST) == 0) {
518  tmpdata = regRd(rMODE) | bmSOFKAENAB; //start SOF generation
519  regWr(rMODE, tmpdata);
520  usb_task_state = USB_ATTACHED_SUBSTATE_WAIT_SOF;
521  //delay = (uint32_t)millis() + 20; //20ms wait after reset per USB spec
522  }
523  break;
524  case USB_ATTACHED_SUBSTATE_WAIT_SOF: //todo: change check order
525  if(regRd(rHIRQ) & bmFRAMEIRQ) {
526  //when first SOF received _and_ 20ms has passed we can continue
527  /*
528  if (delay < (uint32_t)millis()) //20ms passed
529  usb_task_state = USB_STATE_CONFIGURING;
530  */
531  usb_task_state = USB_ATTACHED_SUBSTATE_WAIT_RESET;
532  delay = (uint32_t)millis() + 20;
533  }
534  break;
535  case USB_ATTACHED_SUBSTATE_WAIT_RESET:
536  if((int32_t)((uint32_t)millis() - delay) >= 0L) usb_task_state = USB_STATE_CONFIGURING;
537  else break; // don't fall through
538  case USB_STATE_CONFIGURING:
539 
540  //Serial.print("\r\nConf.LS: ");
541  //Serial.println(lowspeed, HEX);
542 
543  rcode = Configuring(0, 0, lowspeed);
544 
545  if(rcode) {
546  if(rcode != USB_DEV_CONFIG_ERROR_DEVICE_INIT_INCOMPLETE) {
547  usb_error = rcode;
548  usb_task_state = USB_STATE_ERROR;
549  }
550  } else
551  usb_task_state = USB_STATE_RUNNING;
552  break;
553  case USB_STATE_RUNNING:
554  break;
555  case USB_STATE_ERROR:
556  //MAX3421E::Init();
557  break;
558  } // switch( usb_task_state )
559 }
560 
561 uint8_t USB::DefaultAddressing(uint8_t parent, uint8_t port, bool lowspeed) {
562  //uint8_t buf[12];
563  uint8_t rcode;
564  UsbDevice *p0 = NULL, *p = NULL;
565 
566  // Get pointer to pseudo device with address 0 assigned
567  p0 = addrPool.GetUsbDevicePtr(0);
568 
569  if(!p0)
570  return USB_ERROR_ADDRESS_NOT_FOUND_IN_POOL;
571 
572  if(!p0->epinfo)
573  return USB_ERROR_EPINFO_IS_NULL;
574 
575  p0->lowspeed = (lowspeed) ? true : false;
576 
577  // Allocate new address according to device class
578  uint8_t bAddress = addrPool.AllocAddress(parent, false, port);
579 
580  if(!bAddress)
581  return USB_ERROR_OUT_OF_ADDRESS_SPACE_IN_POOL;
582 
583  p = addrPool.GetUsbDevicePtr(bAddress);
584 
585  if(!p)
586  return USB_ERROR_ADDRESS_NOT_FOUND_IN_POOL;
587 
588  p->lowspeed = lowspeed;
589 
590  // Assign new address to the device
591  rcode = setAddr(0, 0, bAddress);
592 
593  if(rcode) {
594  addrPool.FreeAddress(bAddress);
595  bAddress = 0;
596  return rcode;
597  }
598  return 0;
599 };
600 
601 uint8_t USB::AttemptConfig(uint8_t driver, uint8_t parent, uint8_t port, bool lowspeed) {
602  //printf("AttemptConfig: parent = %i, port = %i\r\n", parent, port);
603  uint8_t retries = 0;
604 
605 again:
606  uint8_t rcode = devConfig[driver]->ConfigureDevice(parent, port, lowspeed);
607  if(rcode == USB_ERROR_CONFIG_REQUIRES_ADDITIONAL_RESET) {
608  if(parent == 0) {
609  // Send a bus reset on the root interface.
610  regWr(rHCTL, bmBUSRST); //issue bus reset
611  delay(102); // delay 102ms, compensate for clock inaccuracy.
612  } else {
613  // reset parent port
614  devConfig[parent]->ResetHubPort(port);
615  }
616  } else if(rcode == hrJERR && retries < 3) { // Some devices returns this when plugged in - trying to initialize the device again usually works
617  delay(100);
618  retries++;
619  goto again;
620  } else if(rcode)
621  return rcode;
622 
623  rcode = devConfig[driver]->Init(parent, port, lowspeed);
624  if(rcode == hrJERR && retries < 3) { // Some devices returns this when plugged in - trying to initialize the device again usually works
625  delay(100);
626  retries++;
627  goto again;
628  }
629  if(rcode) {
630  // Issue a bus reset, because the device may be in a limbo state
631  if(parent == 0) {
632  // Send a bus reset on the root interface.
633  regWr(rHCTL, bmBUSRST); //issue bus reset
634  delay(102); // delay 102ms, compensate for clock inaccuracy.
635  } else {
636  // reset parent port
637  devConfig[parent]->ResetHubPort(port);
638  }
639  }
640  return rcode;
641 }
642 
643 /*
644  * This is broken. We need to enumerate differently.
645  * It causes major problems with several devices if detected in an unexpected order.
646  *
647  *
648  * Oleg - I wouldn't do anything before the newly connected device is considered sane.
649  * i.e.(delays are not indicated for brevity):
650  * 1. reset
651  * 2. GetDevDescr();
652  * 3a. If ACK, continue with allocating address, addressing, etc.
653  * 3b. Else reset again, count resets, stop at some number (5?).
654  * 4. When max.number of resets is reached, toggle power/fail
655  * If desired, this could be modified by performing two resets with GetDevDescr() in the middle - however, from my experience, if a device answers to GDD()
656  * it doesn't need to be reset again
657  * New steps proposal:
658  * 1: get address pool instance. exit on fail
659  * 2: pUsb->getDevDescr(0, 0, constBufSize, (uint8_t*)buf). exit on fail.
660  * 3: bus reset, 100ms delay
661  * 4: set address
662  * 5: pUsb->setEpInfoEntry(bAddress, 1, epInfo), exit on fail
663  * 6: while (configurations) {
664  * for(each configuration) {
665  * for (each driver) {
666  * 6a: Ask device if it likes configuration. Returns 0 on OK.
667  * If successful, the driver configured device.
668  * The driver now owns the endpoints, and takes over managing them.
669  * The following will need codes:
670  * Everything went well, instance consumed, exit with success.
671  * Instance already in use, ignore it, try next driver.
672  * Not a supported device, ignore it, try next driver.
673  * Not a supported configuration for this device, ignore it, try next driver.
674  * Could not configure device, fatal, exit with fail.
675  * }
676  * }
677  * }
678  * 7: for(each driver) {
679  * 7a: Ask device if it knows this VID/PID. Acts exactly like 6a, but using VID/PID
680  * 8: if we get here, no driver likes the device plugged in, so exit failure.
681  *
682  */
683 uint8_t USB::Configuring(uint8_t parent, uint8_t port, bool lowspeed) {
684  //uint8_t bAddress = 0;
685  //printf("Configuring: parent = %i, port = %i\r\n", parent, port);
686  uint8_t devConfigIndex;
687  uint8_t rcode = 0;
688  uint8_t buf[sizeof (USB_DEVICE_DESCRIPTOR)];
689  USB_DEVICE_DESCRIPTOR *udd = reinterpret_cast<USB_DEVICE_DESCRIPTOR *>(buf);
690  UsbDevice *p = NULL;
691  EpInfo *oldep_ptr = NULL;
692  EpInfo epInfo;
693 
694  epInfo.epAddr = 0;
695  epInfo.maxPktSize = 8;
696  epInfo.bmSndToggle = 0;
697  epInfo.bmRcvToggle = 0;
698  epInfo.bmNakPower = USB_NAK_MAX_POWER;
699 
700  //delay(2000);
701  AddressPool &addrPool = GetAddressPool();
702  // Get pointer to pseudo device with address 0 assigned
703  p = addrPool.GetUsbDevicePtr(0);
704  if(!p) {
705  //printf("Configuring error: USB_ERROR_ADDRESS_NOT_FOUND_IN_POOL\r\n");
706  return USB_ERROR_ADDRESS_NOT_FOUND_IN_POOL;
707  }
708 
709  // Save old pointer to EP_RECORD of address 0
710  oldep_ptr = p->epinfo;
711 
712  // Temporary assign new pointer to epInfo to p->epinfo in order to
713  // avoid toggle inconsistence
714 
715  p->epinfo = &epInfo;
716 
717  p->lowspeed = lowspeed;
718  // Get device descriptor
719  rcode = getDevDescr(0, 0, sizeof (USB_DEVICE_DESCRIPTOR), (uint8_t*)buf);
720 
721  // Restore p->epinfo
722  p->epinfo = oldep_ptr;
723 
724  if(rcode) {
725  //printf("Configuring error: Can't get USB_DEVICE_DESCRIPTOR\r\n");
726  return rcode;
727  }
728 
729  // to-do?
730  // Allocate new address according to device class
731  //bAddress = addrPool.AllocAddress(parent, false, port);
732 
733  uint16_t vid = udd->idVendor;
734  uint16_t pid = udd->idProduct;
735  uint8_t klass = udd->bDeviceClass;
736  uint8_t subklass = udd->bDeviceSubClass;
737  // Attempt to configure if VID/PID or device class matches with a driver
738  // Qualify with subclass too.
739  //
740  // VID/PID & class tests default to false for drivers not yet ported
741  // subclass defaults to true, so you don't have to define it if you don't have to.
742  //
743  for(devConfigIndex = 0; devConfigIndex < USB_NUMDEVICES; devConfigIndex++) {
744  if(!devConfig[devConfigIndex]) continue; // no driver
745  if(devConfig[devConfigIndex]->GetAddress()) continue; // consumed
746  if(devConfig[devConfigIndex]->DEVSUBCLASSOK(subklass) && (devConfig[devConfigIndex]->VIDPIDOK(vid, pid) || devConfig[devConfigIndex]->DEVCLASSOK(klass))) {
747  rcode = AttemptConfig(devConfigIndex, parent, port, lowspeed);
748  if(rcode != USB_DEV_CONFIG_ERROR_DEVICE_NOT_SUPPORTED)
749  break;
750  }
751  }
752 
753  if(devConfigIndex < USB_NUMDEVICES) {
754  return rcode;
755  }
756 
757 
758  // blindly attempt to configure
759  for(devConfigIndex = 0; devConfigIndex < USB_NUMDEVICES; devConfigIndex++) {
760  if(!devConfig[devConfigIndex]) continue;
761  if(devConfig[devConfigIndex]->GetAddress()) continue; // consumed
762  if(devConfig[devConfigIndex]->DEVSUBCLASSOK(subklass) && (devConfig[devConfigIndex]->VIDPIDOK(vid, pid) || devConfig[devConfigIndex]->DEVCLASSOK(klass))) continue; // If this is true it means it must have returned USB_DEV_CONFIG_ERROR_DEVICE_NOT_SUPPORTED above
763  rcode = AttemptConfig(devConfigIndex, parent, port, lowspeed);
764 
765  //printf("ERROR ENUMERATING %2.2x\r\n", rcode);
766  if(!(rcode == USB_DEV_CONFIG_ERROR_DEVICE_NOT_SUPPORTED || rcode == USB_ERROR_CLASS_INSTANCE_ALREADY_IN_USE)) {
767  // in case of an error dev_index should be reset to 0
768  // in order to start from the very beginning the
769  // next time the program gets here
770  //if (rcode != USB_DEV_CONFIG_ERROR_DEVICE_INIT_INCOMPLETE)
771  // devConfigIndex = 0;
772  return rcode;
773  }
774  }
775  // if we get here that means that the device class is not supported by any of registered classes
776  rcode = DefaultAddressing(parent, port, lowspeed);
777 
778  return rcode;
779 }
780 
781 uint8_t USB::ReleaseDevice(uint8_t addr) {
782  if(!addr)
783  return 0;
784 
785  for(uint8_t i = 0; i < USB_NUMDEVICES; i++) {
786  if(!devConfig[i]) continue;
787  if(devConfig[i]->GetAddress() == addr)
788  return devConfig[i]->Release();
789  }
790  return 0;
791 }
792 
793 #if 1
794 //get device descriptor
795 
796 uint8_t USB::getDevDescr(uint8_t addr, uint8_t ep, uint16_t nbytes, uint8_t* dataptr) {
797  return ( ctrlReq(addr, ep, bmREQ_GET_DESCR, USB_REQUEST_GET_DESCRIPTOR, 0x00, USB_DESCRIPTOR_DEVICE, 0x0000, nbytes, nbytes, dataptr, NULL));
798 }
799 //get configuration descriptor
800 
801 uint8_t USB::getConfDescr(uint8_t addr, uint8_t ep, uint16_t nbytes, uint8_t conf, uint8_t* dataptr) {
802  return ( ctrlReq(addr, ep, bmREQ_GET_DESCR, USB_REQUEST_GET_DESCRIPTOR, conf, USB_DESCRIPTOR_CONFIGURATION, 0x0000, nbytes, nbytes, dataptr, NULL));
803 }
804 
805 /* Requests Configuration Descriptor. Sends two Get Conf Descr requests. The first one gets the total length of all descriptors, then the second one requests this
806  total length. The length of the first request can be shorter ( 4 bytes ), however, there are devices which won't work unless this length is set to 9 */
807 uint8_t USB::getConfDescr(uint8_t addr, uint8_t ep, uint8_t conf, USBReadParser *p) {
808  const uint8_t bufSize = 64;
809  uint8_t buf[bufSize];
810  USB_CONFIGURATION_DESCRIPTOR *ucd = reinterpret_cast<USB_CONFIGURATION_DESCRIPTOR *>(buf);
811 
812  uint8_t ret = getConfDescr(addr, ep, 9, conf, buf);
813 
814  if(ret)
815  return ret;
816 
817  uint16_t total = ucd->wTotalLength;
818 
819  //USBTRACE2("\r\ntotal conf.size:", total);
820 
821  return ( ctrlReq(addr, ep, bmREQ_GET_DESCR, USB_REQUEST_GET_DESCRIPTOR, conf, USB_DESCRIPTOR_CONFIGURATION, 0x0000, total, bufSize, buf, p));
822 }
823 
824 //get string descriptor
825 
826 uint8_t USB::getStrDescr(uint8_t addr, uint8_t ep, uint16_t ns, uint8_t index, uint16_t langid, uint8_t* dataptr) {
827  return ( ctrlReq(addr, ep, bmREQ_GET_DESCR, USB_REQUEST_GET_DESCRIPTOR, index, USB_DESCRIPTOR_STRING, langid, ns, ns, dataptr, NULL));
828 }
829 //set address
830 
831 uint8_t USB::setAddr(uint8_t oldaddr, uint8_t ep, uint8_t newaddr) {
832  uint8_t rcode = ctrlReq(oldaddr, ep, bmREQ_SET, USB_REQUEST_SET_ADDRESS, newaddr, 0x00, 0x0000, 0x0000, 0x0000, NULL, NULL);
833  //delay(2); //per USB 2.0 sect.9.2.6.3
834  delay(300); // Older spec says you should wait at least 200ms
835  return rcode;
836  //return ( ctrlReq(oldaddr, ep, bmREQ_SET, USB_REQUEST_SET_ADDRESS, newaddr, 0x00, 0x0000, 0x0000, 0x0000, NULL, NULL));
837 }
838 //set configuration
839 
840 uint8_t USB::setConf(uint8_t addr, uint8_t ep, uint8_t conf_value) {
841  return ( ctrlReq(addr, ep, bmREQ_SET, USB_REQUEST_SET_CONFIGURATION, conf_value, 0x00, 0x0000, 0x0000, 0x0000, NULL, NULL));
842 }
843 
844 #endif // defined(USB_METHODS_INLINE)
USB::getConfDescr
uint8_t getConfDescr(uint8_t addr, uint8_t ep, uint16_t nbytes, uint8_t conf, uint8_t *dataptr)
Definition: Usb.cpp:801
+Go to the documentation of this file.
1 /* Copyright (C) 2011 Circuits At Home, LTD. All rights reserved.
2 
3 This software may be distributed and modified under the terms of the GNU
4 General Public License version 2 (GPL2) as published by the Free Software
5 Foundation and appearing in the file GPL2.TXT included in the packaging of
6 this file. Please note that GPL2 Section 2[b] requires that all works based
7 on this software must also be made publicly available under the terms of
8 the GPL2 ("Copyleft").
9 
10 Contact information
11 -------------------
12 
13 Circuits At Home, LTD
14 Web : http://www.circuitsathome.com
15 e-mail : support@circuitsathome.com
16  */
17 /* USB functions */
18 
19 #include "Usb.h"
20 
21 static uint8_t usb_error = 0;
22 static uint8_t usb_task_state;
23 
24 /* constructor */
25 USB::USB() : bmHubPre(0) {
26  usb_task_state = USB_DETACHED_SUBSTATE_INITIALIZE; //set up state machine
27  init();
28 }
29 
30 /* Initialize data structures */
31 void USB::init() {
32  //devConfigIndex = 0;
33  bmHubPre = 0;
34 }
35 
36 uint8_t USB::getUsbTaskState(void) {
37  return ( usb_task_state);
38 }
39 
40 void USB::setUsbTaskState(uint8_t state) {
41  usb_task_state = state;
42 }
43 
44 EpInfo* USB::getEpInfoEntry(uint8_t addr, uint8_t ep) {
45  UsbDevice *p = addrPool.GetUsbDevicePtr(addr);
46 
47  if(!p || !p->epinfo)
48  return NULL;
49 
50  EpInfo *pep = p->epinfo;
51 
52  for(uint8_t i = 0; i < p->epcount; i++) {
53  if((pep)->epAddr == ep)
54  return pep;
55 
56  pep++;
57  }
58  return NULL;
59 }
60 
61 /* set device table entry */
62 
63 /* each device is different and has different number of endpoints. This function plugs endpoint record structure, defined in application, to devtable */
64 uint8_t USB::setEpInfoEntry(uint8_t addr, uint8_t epcount, EpInfo* eprecord_ptr) {
65  if(!eprecord_ptr)
66  return USB_ERROR_INVALID_ARGUMENT;
67 
68  UsbDevice *p = addrPool.GetUsbDevicePtr(addr);
69 
70  if(!p)
71  return USB_ERROR_ADDRESS_NOT_FOUND_IN_POOL;
72 
73  p->address.devAddress = addr;
74  p->epinfo = eprecord_ptr;
75  p->epcount = epcount;
76 
77  return 0;
78 }
79 
80 uint8_t USB::SetAddress(uint8_t addr, uint8_t ep, EpInfo **ppep, uint16_t *nak_limit) {
81  UsbDevice *p = addrPool.GetUsbDevicePtr(addr);
82 
83  if(!p)
84  return USB_ERROR_ADDRESS_NOT_FOUND_IN_POOL;
85 
86  if(!p->epinfo)
87  return USB_ERROR_EPINFO_IS_NULL;
88 
89  *ppep = getEpInfoEntry(addr, ep);
90 
91  if(!*ppep)
92  return USB_ERROR_EP_NOT_FOUND_IN_TBL;
93 
94  *nak_limit = (0x0001UL << (((*ppep)->bmNakPower > USB_NAK_MAX_POWER) ? USB_NAK_MAX_POWER : (*ppep)->bmNakPower));
95  (*nak_limit)--;
96  /*
97  USBTRACE2("\r\nAddress: ", addr);
98  USBTRACE2(" EP: ", ep);
99  USBTRACE2(" NAK Power: ",(*ppep)->bmNakPower);
100  USBTRACE2(" NAK Limit: ", nak_limit);
101  USBTRACE("\r\n");
102  */
103  regWr(rPERADDR, addr); //set peripheral address
104 
105  uint8_t mode = regRd(rMODE);
106 
107  //Serial.print("\r\nMode: ");
108  //Serial.println( mode, HEX);
109  //Serial.print("\r\nLS: ");
110  //Serial.println(p->lowspeed, HEX);
111 
112 
113 
114  // Set bmLOWSPEED and bmHUBPRE in case of low-speed device, reset them otherwise
115  regWr(rMODE, (p->lowspeed) ? mode | bmLOWSPEED | bmHubPre : mode & ~(bmHUBPRE | bmLOWSPEED));
116 
117  return 0;
118 }
119 
120 /* Control transfer. Sets address, endpoint, fills control packet with necessary data, dispatches control packet, and initiates bulk IN transfer, */
121 /* depending on request. Actual requests are defined as inlines */
122 /* return codes: */
123 /* 00 = success */
124 
125 /* 01-0f = non-zero HRSLT */
126 uint8_t USB::ctrlReq(uint8_t addr, uint8_t ep, uint8_t bmReqType, uint8_t bRequest, uint8_t wValLo, uint8_t wValHi,
127  uint16_t wInd, uint16_t total, uint16_t nbytes, uint8_t* dataptr, USBReadParser *p) {
128  bool direction = false; //request direction, IN or OUT
129  uint8_t rcode;
130  SETUP_PKT setup_pkt;
131 
132  EpInfo *pep = NULL;
133  uint16_t nak_limit = 0;
134 
135  rcode = SetAddress(addr, ep, &pep, &nak_limit);
136 
137  if(rcode)
138  return rcode;
139 
140  direction = ((bmReqType & 0x80) > 0);
141 
142  /* fill in setup packet */
143  setup_pkt.ReqType_u.bmRequestType = bmReqType;
144  setup_pkt.bRequest = bRequest;
145  setup_pkt.wVal_u.wValueLo = wValLo;
146  setup_pkt.wVal_u.wValueHi = wValHi;
147  setup_pkt.wIndex = wInd;
148  setup_pkt.wLength = total;
149 
150  bytesWr(rSUDFIFO, 8, (uint8_t*) & setup_pkt); //transfer to setup packet FIFO
151 
152  rcode = dispatchPkt(tokSETUP, ep, nak_limit); //dispatch packet
153 
154  if(rcode) //return HRSLT if not zero
155  return ( rcode);
156 
157  if(dataptr != NULL) //data stage, if present
158  {
159  if(direction) //IN transfer
160  {
161  uint16_t left = total;
162 
163  pep->bmRcvToggle = 1; //bmRCVTOG1;
164 
165  while(left) {
166  // Bytes read into buffer
167 #if defined(ESP8266) || defined(ESP32)
168  yield(); // needed in order to reset the watchdog timer on the ESP8266
169 #endif
170  uint16_t read = nbytes;
171  //uint16_t read = (left<nbytes) ? left : nbytes;
172 
173  rcode = InTransfer(pep, nak_limit, &read, dataptr);
174  if(rcode == hrTOGERR) {
175  // yes, we flip it wrong here so that next time it is actually correct!
176  pep->bmRcvToggle = (regRd(rHRSL) & bmSNDTOGRD) ? 0 : 1;
177  continue;
178  }
179 
180  if(rcode)
181  return rcode;
182 
183  // Invoke callback function if inTransfer completed successfully and callback function pointer is specified
184  if(!rcode && p)
185  ((USBReadParser*)p)->Parse(read, dataptr, total - left);
186 
187  left -= read;
188 
189  if(read < nbytes)
190  break;
191  }
192  } else //OUT transfer
193  {
194  pep->bmSndToggle = 1; //bmSNDTOG1;
195  rcode = OutTransfer(pep, nak_limit, nbytes, dataptr);
196  }
197  if(rcode) //return error
198  return ( rcode);
199  }
200  // Status stage
201  return dispatchPkt((direction) ? tokOUTHS : tokINHS, ep, nak_limit); //GET if direction
202 }
203 
204 /* IN transfer to arbitrary endpoint. Assumes PERADDR is set. Handles multiple packets if necessary. Transfers 'nbytes' bytes. */
205 /* Keep sending INs and writes data to memory area pointed by 'data' */
206 
207 /* rcode 0 if no errors. rcode 01-0f is relayed from dispatchPkt(). Rcode f0 means RCVDAVIRQ error,
208  fe USB xfer timeout */
209 uint8_t USB::inTransfer(uint8_t addr, uint8_t ep, uint16_t *nbytesptr, uint8_t* data, uint8_t bInterval /*= 0*/) {
210  EpInfo *pep = NULL;
211  uint16_t nak_limit = 0;
212 
213  uint8_t rcode = SetAddress(addr, ep, &pep, &nak_limit);
214 
215  if(rcode) {
216  USBTRACE3("(USB::InTransfer) SetAddress Failed ", rcode, 0x81);
217  USBTRACE3("(USB::InTransfer) addr requested ", addr, 0x81);
218  USBTRACE3("(USB::InTransfer) ep requested ", ep, 0x81);
219  return rcode;
220  }
221  return InTransfer(pep, nak_limit, nbytesptr, data, bInterval);
222 }
223 
224 uint8_t USB::InTransfer(EpInfo *pep, uint16_t nak_limit, uint16_t *nbytesptr, uint8_t* data, uint8_t bInterval /*= 0*/) {
225  uint8_t rcode = 0;
226  uint8_t pktsize;
227 
228  uint16_t nbytes = *nbytesptr;
229  //printf("Requesting %i bytes ", nbytes);
230  uint8_t maxpktsize = pep->maxPktSize;
231 
232  *nbytesptr = 0;
233  regWr(rHCTL, (pep->bmRcvToggle) ? bmRCVTOG1 : bmRCVTOG0); //set toggle value
234 
235  // use a 'break' to exit this loop
236  while(1) {
237 #if defined(ESP8266) || defined(ESP32)
238  yield(); // needed in order to reset the watchdog timer on the ESP8266
239 #endif
240  rcode = dispatchPkt(tokIN, pep->epAddr, nak_limit); //IN packet to EP-'endpoint'. Function takes care of NAKS.
241  if(rcode == hrTOGERR) {
242  // yes, we flip it wrong here so that next time it is actually correct!
243  pep->bmRcvToggle = (regRd(rHRSL) & bmRCVTOGRD) ? 0 : 1;
244  regWr(rHCTL, (pep->bmRcvToggle) ? bmRCVTOG1 : bmRCVTOG0); //set toggle value
245  continue;
246  }
247  if(rcode) {
248  //printf(">>>>>>>> Problem! dispatchPkt %2.2x\r\n", rcode);
249  break; //should be 0, indicating ACK. Else return error code.
250  }
251  /* check for RCVDAVIRQ and generate error if not present
252  * the only case when absence of RCVDAVIRQ makes sense is when toggle error occurred.
253  * Need to add handling for that
254  *
255  * NOTE: I've seen this happen with SPI corruption -- xxxajk
256  */
257  if((regRd(rHIRQ) & bmRCVDAVIRQ) == 0) {
258  //printf(">>>>>>>> Problem! NO RCVDAVIRQ!\r\n");
259  rcode = 0xf0; //receive error
260  break;
261  }
262  pktsize = regRd(rRCVBC); //number of received bytes
263  //printf("Got %i bytes \r\n", pktsize);
264  // This would be OK, but...
265  //assert(pktsize <= nbytes);
266  if(pktsize > nbytes) {
267  // This can happen. Use of assert on Arduino locks up the Arduino.
268  // So I will trim the value, and hope for the best.
269  //printf(">>>>>>>> Problem! Wanted %i bytes but got %i.\r\n", nbytes, pktsize);
270  pktsize = nbytes;
271  }
272 
273  int16_t mem_left = (int16_t)nbytes - *((int16_t*)nbytesptr);
274 
275  if(mem_left < 0)
276  mem_left = 0;
277 
278  data = bytesRd(rRCVFIFO, ((pktsize > mem_left) ? mem_left : pktsize), data);
279 
280  regWr(rHIRQ, bmRCVDAVIRQ); // Clear the IRQ & free the buffer
281  *nbytesptr += pktsize; // add this packet's byte count to total transfer length
282 
283  /* The transfer is complete under two conditions: */
284  /* 1. The device sent a short packet (L.T. maxPacketSize) */
285  /* 2. 'nbytes' have been transferred. */
286  if((pktsize < maxpktsize) || (*nbytesptr >= nbytes)) // have we transferred 'nbytes' bytes?
287  {
288  // Save toggle value
289  pep->bmRcvToggle = ((regRd(rHRSL) & bmRCVTOGRD)) ? 1 : 0;
290  //printf("\r\n");
291  rcode = 0;
292  break;
293  } else if(bInterval > 0)
294  delay(bInterval); // Delay according to polling interval
295  } //while( 1 )
296  return ( rcode);
297 }
298 
299 /* OUT transfer to arbitrary endpoint. Handles multiple packets if necessary. Transfers 'nbytes' bytes. */
300 /* Handles NAK bug per Maxim Application Note 4000 for single buffer transfer */
301 
302 /* rcode 0 if no errors. rcode 01-0f is relayed from HRSL */
303 uint8_t USB::outTransfer(uint8_t addr, uint8_t ep, uint16_t nbytes, uint8_t* data) {
304  EpInfo *pep = NULL;
305  uint16_t nak_limit = 0;
306 
307  uint8_t rcode = SetAddress(addr, ep, &pep, &nak_limit);
308 
309  if(rcode)
310  return rcode;
311 
312  return OutTransfer(pep, nak_limit, nbytes, data);
313 }
314 
315 uint8_t USB::OutTransfer(EpInfo *pep, uint16_t nak_limit, uint16_t nbytes, uint8_t *data) {
316  uint8_t rcode = hrSUCCESS, retry_count;
317  uint8_t *data_p = data; //local copy of the data pointer
318  uint16_t bytes_tosend, nak_count;
319  uint16_t bytes_left = nbytes;
320 
321  uint8_t maxpktsize = pep->maxPktSize;
322 
323  if(maxpktsize < 1 || maxpktsize > 64)
324  return USB_ERROR_INVALID_MAX_PKT_SIZE;
325 
326  uint32_t timeout = (uint32_t)millis() + USB_XFER_TIMEOUT;
327 
328  regWr(rHCTL, (pep->bmSndToggle) ? bmSNDTOG1 : bmSNDTOG0); //set toggle value
329 
330  while(bytes_left) {
331 #if defined(ESP8266) || defined(ESP32)
332  yield(); // needed in order to reset the watchdog timer on the ESP8266
333 #endif
334  retry_count = 0;
335  nak_count = 0;
336  bytes_tosend = (bytes_left >= maxpktsize) ? maxpktsize : bytes_left;
337  bytesWr(rSNDFIFO, bytes_tosend, data_p); //filling output FIFO
338  regWr(rSNDBC, bytes_tosend); //set number of bytes
339  regWr(rHXFR, (tokOUT | pep->epAddr)); //dispatch packet
340  while(!(regRd(rHIRQ) & bmHXFRDNIRQ)){
341 #if defined(ESP8266) || defined(ESP32)
342  yield(); // needed in order to reset the watchdog timer on the ESP8266
343 #endif
344  } //wait for the completion IRQ
345  regWr(rHIRQ, bmHXFRDNIRQ); //clear IRQ
346  rcode = (regRd(rHRSL) & 0x0f);
347 
348  while(rcode && ((int32_t)((uint32_t)millis() - timeout) < 0L)) {
349 #if defined(ESP8266) || defined(ESP32)
350  yield(); // needed in order to reset the watchdog timer on the ESP8266
351 #endif
352  switch(rcode) {
353  case hrNAK:
354  nak_count++;
355  if(nak_limit && (nak_count == nak_limit))
356  goto breakout;
357  //return ( rcode);
358  break;
359  case hrTIMEOUT:
360  retry_count++;
361  if(retry_count == USB_RETRY_LIMIT)
362  goto breakout;
363  //return ( rcode);
364  break;
365  case hrTOGERR:
366  // yes, we flip it wrong here so that next time it is actually correct!
367  pep->bmSndToggle = (regRd(rHRSL) & bmSNDTOGRD) ? 0 : 1;
368  regWr(rHCTL, (pep->bmSndToggle) ? bmSNDTOG1 : bmSNDTOG0); //set toggle value
369  break;
370  default:
371  goto breakout;
372  }//switch( rcode
373 
374  /* process NAK according to Host out NAK bug */
375  regWr(rSNDBC, 0);
376  regWr(rSNDFIFO, *data_p);
377  regWr(rSNDBC, bytes_tosend);
378  regWr(rHXFR, (tokOUT | pep->epAddr)); //dispatch packet
379  while(!(regRd(rHIRQ) & bmHXFRDNIRQ)){
380 #if defined(ESP8266) || defined(ESP32)
381  yield(); // needed in order to reset the watchdog timer on the ESP8266
382 #endif
383  } //wait for the completion IRQ
384  regWr(rHIRQ, bmHXFRDNIRQ); //clear IRQ
385  rcode = (regRd(rHRSL) & 0x0f);
386  }//while( rcode && ....
387  bytes_left -= bytes_tosend;
388  data_p += bytes_tosend;
389  }//while( bytes_left...
390 breakout:
391 
392  pep->bmSndToggle = (regRd(rHRSL) & bmSNDTOGRD) ? 1 : 0; //bmSNDTOG1 : bmSNDTOG0; //update toggle
393  return ( rcode); //should be 0 in all cases
394 }
395 /* dispatch USB packet. Assumes peripheral address is set and relevant buffer is loaded/empty */
396 /* If NAK, tries to re-send up to nak_limit times */
397 /* If nak_limit == 0, do not count NAKs, exit after timeout */
398 /* If bus timeout, re-sends up to USB_RETRY_LIMIT times */
399 
400 /* return codes 0x00-0x0f are HRSLT( 0x00 being success ), 0xff means timeout */
401 uint8_t USB::dispatchPkt(uint8_t token, uint8_t ep, uint16_t nak_limit) {
402  uint32_t timeout = (uint32_t)millis() + USB_XFER_TIMEOUT;
403  uint8_t tmpdata;
404  uint8_t rcode = hrSUCCESS;
405  uint8_t retry_count = 0;
406  uint16_t nak_count = 0;
407 
408  while((int32_t)((uint32_t)millis() - timeout) < 0L) {
409 #if defined(ESP8266) || defined(ESP32)
410  yield(); // needed in order to reset the watchdog timer on the ESP8266
411 #endif
412  regWr(rHXFR, (token | ep)); //launch the transfer
413  rcode = USB_ERROR_TRANSFER_TIMEOUT;
414 
415  while((int32_t)((uint32_t)millis() - timeout) < 0L) //wait for transfer completion
416  {
417 #if defined(ESP8266) || defined(ESP32)
418  yield(); // needed in order to reset the watchdog timer on the ESP8266
419 #endif
420  tmpdata = regRd(rHIRQ);
421 
422  if(tmpdata & bmHXFRDNIRQ) {
423  regWr(rHIRQ, bmHXFRDNIRQ); //clear the interrupt
424  rcode = 0x00;
425  break;
426  }//if( tmpdata & bmHXFRDNIRQ
427 
428  }//while ( millis() < timeout
429 
430  //if (rcode != 0x00) //exit if timeout
431  // return ( rcode);
432 
433  rcode = (regRd(rHRSL) & 0x0f); //analyze transfer result
434 
435  switch(rcode) {
436  case hrNAK:
437  nak_count++;
438  if(nak_limit && (nak_count == nak_limit))
439  return (rcode);
440  break;
441  case hrTIMEOUT:
442  retry_count++;
443  if(retry_count == USB_RETRY_LIMIT)
444  return (rcode);
445  break;
446  default:
447  return (rcode);
448  }//switch( rcode
449 
450  }//while( timeout > millis()
451  return ( rcode);
452 }
453 
454 /* USB main task. Performs enumeration/cleanup */
455 void USB::Task(void) //USB state machine
456 {
457  uint8_t rcode;
458  uint8_t tmpdata;
459  static uint32_t delay = 0;
460  //USB_DEVICE_DESCRIPTOR buf;
461  bool lowspeed = false;
462 
463  MAX3421E::Task();
464 
465  tmpdata = getVbusState();
466 
467  /* modify USB task state if Vbus changed */
468  switch(tmpdata) {
469  case SE1: //illegal state
470  usb_task_state = USB_DETACHED_SUBSTATE_ILLEGAL;
471  lowspeed = false;
472  break;
473  case SE0: //disconnected
474  if((usb_task_state & USB_STATE_MASK) != USB_STATE_DETACHED)
475  usb_task_state = USB_DETACHED_SUBSTATE_INITIALIZE;
476  lowspeed = false;
477  break;
478  case LSHOST:
479 
480  lowspeed = true;
481  //intentional fallthrough
482  case FSHOST: //attached
483  if((usb_task_state & USB_STATE_MASK) == USB_STATE_DETACHED) {
484  delay = (uint32_t)millis() + USB_SETTLE_DELAY;
485  usb_task_state = USB_ATTACHED_SUBSTATE_SETTLE;
486  }
487  break;
488  }// switch( tmpdata
489 
490  for(uint8_t i = 0; i < USB_NUMDEVICES; i++)
491  if(devConfig[i])
492  rcode = devConfig[i]->Poll();
493 
494  switch(usb_task_state) {
495  case USB_DETACHED_SUBSTATE_INITIALIZE:
496  init();
497 
498  for(uint8_t i = 0; i < USB_NUMDEVICES; i++)
499  if(devConfig[i])
500  rcode = devConfig[i]->Release();
501 
502  usb_task_state = USB_DETACHED_SUBSTATE_WAIT_FOR_DEVICE;
503  break;
504  case USB_DETACHED_SUBSTATE_WAIT_FOR_DEVICE: //just sit here
505  break;
506  case USB_DETACHED_SUBSTATE_ILLEGAL: //just sit here
507  break;
508  case USB_ATTACHED_SUBSTATE_SETTLE: //settle time for just attached device
509  if((int32_t)((uint32_t)millis() - delay) >= 0L)
510  usb_task_state = USB_ATTACHED_SUBSTATE_RESET_DEVICE;
511  else break; // don't fall through
512  case USB_ATTACHED_SUBSTATE_RESET_DEVICE:
513  regWr(rHCTL, bmBUSRST); //issue bus reset
514  usb_task_state = USB_ATTACHED_SUBSTATE_WAIT_RESET_COMPLETE;
515  break;
516  case USB_ATTACHED_SUBSTATE_WAIT_RESET_COMPLETE:
517  if((regRd(rHCTL) & bmBUSRST) == 0) {
518  tmpdata = regRd(rMODE) | bmSOFKAENAB; //start SOF generation
519  regWr(rMODE, tmpdata);
520  usb_task_state = USB_ATTACHED_SUBSTATE_WAIT_SOF;
521  //delay = (uint32_t)millis() + 20; //20ms wait after reset per USB spec
522  }
523  break;
524  case USB_ATTACHED_SUBSTATE_WAIT_SOF: //todo: change check order
525  if(regRd(rHIRQ) & bmFRAMEIRQ) {
526  //when first SOF received _and_ 20ms has passed we can continue
527  /*
528  if (delay < (uint32_t)millis()) //20ms passed
529  usb_task_state = USB_STATE_CONFIGURING;
530  */
531  usb_task_state = USB_ATTACHED_SUBSTATE_WAIT_RESET;
532  delay = (uint32_t)millis() + 20;
533  }
534  break;
535  case USB_ATTACHED_SUBSTATE_WAIT_RESET:
536  if((int32_t)((uint32_t)millis() - delay) >= 0L) usb_task_state = USB_STATE_CONFIGURING;
537  else break; // don't fall through
538  case USB_STATE_CONFIGURING:
539 
540  //Serial.print("\r\nConf.LS: ");
541  //Serial.println(lowspeed, HEX);
542 
543  rcode = Configuring(0, 0, lowspeed);
544 
545  if(rcode) {
546  if(rcode != USB_DEV_CONFIG_ERROR_DEVICE_INIT_INCOMPLETE) {
547  usb_error = rcode;
548  usb_task_state = USB_STATE_ERROR;
549  }
550  } else
551  usb_task_state = USB_STATE_RUNNING;
552  break;
553  case USB_STATE_RUNNING:
554  break;
555  case USB_STATE_ERROR:
556  //MAX3421E::Init();
557  break;
558  } // switch( usb_task_state )
559 }
560 
561 uint8_t USB::DefaultAddressing(uint8_t parent, uint8_t port, bool lowspeed) {
562  //uint8_t buf[12];
563  uint8_t rcode;
564  UsbDevice *p0 = NULL, *p = NULL;
565 
566  // Get pointer to pseudo device with address 0 assigned
567  p0 = addrPool.GetUsbDevicePtr(0);
568 
569  if(!p0)
570  return USB_ERROR_ADDRESS_NOT_FOUND_IN_POOL;
571 
572  if(!p0->epinfo)
573  return USB_ERROR_EPINFO_IS_NULL;
574 
575  p0->lowspeed = (lowspeed) ? true : false;
576 
577  // Allocate new address according to device class
578  uint8_t bAddress = addrPool.AllocAddress(parent, false, port);
579 
580  if(!bAddress)
581  return USB_ERROR_OUT_OF_ADDRESS_SPACE_IN_POOL;
582 
583  p = addrPool.GetUsbDevicePtr(bAddress);
584 
585  if(!p)
586  return USB_ERROR_ADDRESS_NOT_FOUND_IN_POOL;
587 
588  p->lowspeed = lowspeed;
589 
590  // Assign new address to the device
591  rcode = setAddr(0, 0, bAddress);
592 
593  if(rcode) {
594  addrPool.FreeAddress(bAddress);
595  bAddress = 0;
596  return rcode;
597  }
598  return 0;
599 };
600 
601 uint8_t USB::AttemptConfig(uint8_t driver, uint8_t parent, uint8_t port, bool lowspeed) {
602  //printf("AttemptConfig: parent = %i, port = %i\r\n", parent, port);
603  uint8_t retries = 0;
604 
605 again:
606  uint8_t rcode = devConfig[driver]->ConfigureDevice(parent, port, lowspeed);
607  if(rcode == USB_ERROR_CONFIG_REQUIRES_ADDITIONAL_RESET) {
608  if(parent == 0) {
609  // Send a bus reset on the root interface.
610  regWr(rHCTL, bmBUSRST); //issue bus reset
611  delay(102); // delay 102ms, compensate for clock inaccuracy.
612  } else {
613  // reset parent port
614  devConfig[parent]->ResetHubPort(port);
615  }
616  } else if(rcode == hrJERR && retries < 3) { // Some devices returns this when plugged in - trying to initialize the device again usually works
617  delay(100);
618  retries++;
619  goto again;
620  } else if(rcode)
621  return rcode;
622 
623  rcode = devConfig[driver]->Init(parent, port, lowspeed);
624  if(rcode == hrJERR && retries < 3) { // Some devices returns this when plugged in - trying to initialize the device again usually works
625  delay(100);
626  retries++;
627  goto again;
628  }
629  if(rcode) {
630  // Issue a bus reset, because the device may be in a limbo state
631  if(parent == 0) {
632  // Send a bus reset on the root interface.
633  regWr(rHCTL, bmBUSRST); //issue bus reset
634  delay(102); // delay 102ms, compensate for clock inaccuracy.
635  } else {
636  // reset parent port
637  devConfig[parent]->ResetHubPort(port);
638  }
639  }
640  return rcode;
641 }
642 
643 /*
644  * This is broken. We need to enumerate differently.
645  * It causes major problems with several devices if detected in an unexpected order.
646  *
647  *
648  * Oleg - I wouldn't do anything before the newly connected device is considered sane.
649  * i.e.(delays are not indicated for brevity):
650  * 1. reset
651  * 2. GetDevDescr();
652  * 3a. If ACK, continue with allocating address, addressing, etc.
653  * 3b. Else reset again, count resets, stop at some number (5?).
654  * 4. When max.number of resets is reached, toggle power/fail
655  * If desired, this could be modified by performing two resets with GetDevDescr() in the middle - however, from my experience, if a device answers to GDD()
656  * it doesn't need to be reset again
657  * New steps proposal:
658  * 1: get address pool instance. exit on fail
659  * 2: pUsb->getDevDescr(0, 0, constBufSize, (uint8_t*)buf). exit on fail.
660  * 3: bus reset, 100ms delay
661  * 4: set address
662  * 5: pUsb->setEpInfoEntry(bAddress, 1, epInfo), exit on fail
663  * 6: while (configurations) {
664  * for(each configuration) {
665  * for (each driver) {
666  * 6a: Ask device if it likes configuration. Returns 0 on OK.
667  * If successful, the driver configured device.
668  * The driver now owns the endpoints, and takes over managing them.
669  * The following will need codes:
670  * Everything went well, instance consumed, exit with success.
671  * Instance already in use, ignore it, try next driver.
672  * Not a supported device, ignore it, try next driver.
673  * Not a supported configuration for this device, ignore it, try next driver.
674  * Could not configure device, fatal, exit with fail.
675  * }
676  * }
677  * }
678  * 7: for(each driver) {
679  * 7a: Ask device if it knows this VID/PID. Acts exactly like 6a, but using VID/PID
680  * 8: if we get here, no driver likes the device plugged in, so exit failure.
681  *
682  */
683 uint8_t USB::Configuring(uint8_t parent, uint8_t port, bool lowspeed) {
684  //uint8_t bAddress = 0;
685  //printf("Configuring: parent = %i, port = %i\r\n", parent, port);
686  uint8_t devConfigIndex;
687  uint8_t rcode = 0;
688  uint8_t buf[sizeof (USB_DEVICE_DESCRIPTOR)];
689  USB_DEVICE_DESCRIPTOR *udd = reinterpret_cast<USB_DEVICE_DESCRIPTOR *>(buf);
690  UsbDevice *p = NULL;
691  EpInfo *oldep_ptr = NULL;
692  EpInfo epInfo;
693 
694  epInfo.epAddr = 0;
695  epInfo.maxPktSize = 8;
696  epInfo.bmSndToggle = 0;
697  epInfo.bmRcvToggle = 0;
698  epInfo.bmNakPower = USB_NAK_MAX_POWER;
699 
700  //delay(2000);
701  AddressPool &addrPool = GetAddressPool();
702  // Get pointer to pseudo device with address 0 assigned
703  p = addrPool.GetUsbDevicePtr(0);
704  if(!p) {
705  //printf("Configuring error: USB_ERROR_ADDRESS_NOT_FOUND_IN_POOL\r\n");
706  return USB_ERROR_ADDRESS_NOT_FOUND_IN_POOL;
707  }
708 
709  // Save old pointer to EP_RECORD of address 0
710  oldep_ptr = p->epinfo;
711 
712  // Temporary assign new pointer to epInfo to p->epinfo in order to
713  // avoid toggle inconsistence
714 
715  p->epinfo = &epInfo;
716 
717  p->lowspeed = lowspeed;
718  // Get device descriptor
719  rcode = getDevDescr(0, 0, sizeof (USB_DEVICE_DESCRIPTOR), (uint8_t*)buf);
720 
721  // Restore p->epinfo
722  p->epinfo = oldep_ptr;
723 
724  if(rcode) {
725  //printf("Configuring error: Can't get USB_DEVICE_DESCRIPTOR\r\n");
726  return rcode;
727  }
728 
729  // to-do?
730  // Allocate new address according to device class
731  //bAddress = addrPool.AllocAddress(parent, false, port);
732 
733  uint16_t vid = udd->idVendor;
734  uint16_t pid = udd->idProduct;
735  uint8_t klass = udd->bDeviceClass;
736  uint8_t subklass = udd->bDeviceSubClass;
737  // Attempt to configure if VID/PID or device class matches with a driver
738  // Qualify with subclass too.
739  //
740  // VID/PID & class tests default to false for drivers not yet ported
741  // subclass defaults to true, so you don't have to define it if you don't have to.
742  //
743  for(devConfigIndex = 0; devConfigIndex < USB_NUMDEVICES; devConfigIndex++) {
744  if(!devConfig[devConfigIndex]) continue; // no driver
745  if(devConfig[devConfigIndex]->GetAddress()) continue; // consumed
746  if(devConfig[devConfigIndex]->DEVSUBCLASSOK(subklass) && (devConfig[devConfigIndex]->VIDPIDOK(vid, pid) || devConfig[devConfigIndex]->DEVCLASSOK(klass))) {
747  rcode = AttemptConfig(devConfigIndex, parent, port, lowspeed);
748  if(rcode != USB_DEV_CONFIG_ERROR_DEVICE_NOT_SUPPORTED)
749  break;
750  }
751  }
752 
753  if(devConfigIndex < USB_NUMDEVICES) {
754  return rcode;
755  }
756 
757 
758  // blindly attempt to configure
759  for(devConfigIndex = 0; devConfigIndex < USB_NUMDEVICES; devConfigIndex++) {
760  if(!devConfig[devConfigIndex]) continue;
761  if(devConfig[devConfigIndex]->GetAddress()) continue; // consumed
762  if(devConfig[devConfigIndex]->DEVSUBCLASSOK(subklass) && (devConfig[devConfigIndex]->VIDPIDOK(vid, pid) || devConfig[devConfigIndex]->DEVCLASSOK(klass))) continue; // If this is true it means it must have returned USB_DEV_CONFIG_ERROR_DEVICE_NOT_SUPPORTED above
763  rcode = AttemptConfig(devConfigIndex, parent, port, lowspeed);
764 
765  //printf("ERROR ENUMERATING %2.2x\r\n", rcode);
766  if(!(rcode == USB_DEV_CONFIG_ERROR_DEVICE_NOT_SUPPORTED || rcode == USB_ERROR_CLASS_INSTANCE_ALREADY_IN_USE)) {
767  // in case of an error dev_index should be reset to 0
768  // in order to start from the very beginning the
769  // next time the program gets here
770  //if (rcode != USB_DEV_CONFIG_ERROR_DEVICE_INIT_INCOMPLETE)
771  // devConfigIndex = 0;
772  return rcode;
773  }
774  }
775  // if we get here that means that the device class is not supported by any of registered classes
776  rcode = DefaultAddressing(parent, port, lowspeed);
777 
778  return rcode;
779 }
780 
781 uint8_t USB::ReleaseDevice(uint8_t addr) {
782  if(!addr)
783  return 0;
784 
785  for(uint8_t i = 0; i < USB_NUMDEVICES; i++) {
786  if(!devConfig[i]) continue;
787  if(devConfig[i]->GetAddress() == addr)
788  return devConfig[i]->Release();
789  }
790  return 0;
791 }
792 
793 #if 1
794 //get device descriptor
795 
796 uint8_t USB::getDevDescr(uint8_t addr, uint8_t ep, uint16_t nbytes, uint8_t* dataptr) {
797  return ( ctrlReq(addr, ep, bmREQ_GET_DESCR, USB_REQUEST_GET_DESCRIPTOR, 0x00, USB_DESCRIPTOR_DEVICE, 0x0000, nbytes, nbytes, dataptr, NULL));
798 }
799 //get configuration descriptor
800 
801 uint8_t USB::getConfDescr(uint8_t addr, uint8_t ep, uint16_t nbytes, uint8_t conf, uint8_t* dataptr) {
802  return ( ctrlReq(addr, ep, bmREQ_GET_DESCR, USB_REQUEST_GET_DESCRIPTOR, conf, USB_DESCRIPTOR_CONFIGURATION, 0x0000, nbytes, nbytes, dataptr, NULL));
803 }
804 
805 /* Requests Configuration Descriptor. Sends two Get Conf Descr requests. The first one gets the total length of all descriptors, then the second one requests this
806  total length. The length of the first request can be shorter ( 4 bytes ), however, there are devices which won't work unless this length is set to 9 */
807 uint8_t USB::getConfDescr(uint8_t addr, uint8_t ep, uint8_t conf, USBReadParser *p) {
808  const uint8_t bufSize = 64;
809  uint8_t buf[bufSize];
810  USB_CONFIGURATION_DESCRIPTOR *ucd = reinterpret_cast<USB_CONFIGURATION_DESCRIPTOR *>(buf);
811 
812  uint8_t ret = getConfDescr(addr, ep, 9, conf, buf);
813 
814  if(ret)
815  return ret;
816 
817  uint16_t total = ucd->wTotalLength;
818 
819  //USBTRACE2("\r\ntotal conf.size:", total);
820 
821  return ( ctrlReq(addr, ep, bmREQ_GET_DESCR, USB_REQUEST_GET_DESCRIPTOR, conf, USB_DESCRIPTOR_CONFIGURATION, 0x0000, total, bufSize, buf, p));
822 }
823 
824 //get string descriptor
825 
826 uint8_t USB::getStrDescr(uint8_t addr, uint8_t ep, uint16_t ns, uint8_t index, uint16_t langid, uint8_t* dataptr) {
827  return ( ctrlReq(addr, ep, bmREQ_GET_DESCR, USB_REQUEST_GET_DESCRIPTOR, index, USB_DESCRIPTOR_STRING, langid, ns, ns, dataptr, NULL));
828 }
829 //set address
830 
831 uint8_t USB::setAddr(uint8_t oldaddr, uint8_t ep, uint8_t newaddr) {
832  uint8_t rcode = ctrlReq(oldaddr, ep, bmREQ_SET, USB_REQUEST_SET_ADDRESS, newaddr, 0x00, 0x0000, 0x0000, 0x0000, NULL, NULL);
833  //delay(2); //per USB 2.0 sect.9.2.6.3
834  delay(300); // Older spec says you should wait at least 200ms
835  return rcode;
836  //return ( ctrlReq(oldaddr, ep, bmREQ_SET, USB_REQUEST_SET_ADDRESS, newaddr, 0x00, 0x0000, 0x0000, 0x0000, NULL, NULL));
837 }
838 //set configuration
839 
840 uint8_t USB::setConf(uint8_t addr, uint8_t ep, uint8_t conf_value) {
841  return ( ctrlReq(addr, ep, bmREQ_SET, USB_REQUEST_SET_CONFIGURATION, conf_value, 0x00, 0x0000, 0x0000, 0x0000, NULL, NULL));
842 }
843 
844 #endif // defined(USB_METHODS_INLINE)
USB::getConfDescr
uint8_t getConfDescr(uint8_t addr, uint8_t ep, uint16_t nbytes, uint8_t conf, uint8_t *dataptr)
Definition: Usb.cpp:801
EpInfo::bmRcvToggle
uint8_t bmRcvToggle
Definition: address.h:48
USBDeviceConfig::Poll
virtual uint8_t Poll()
Definition: UsbCore.h:149
@@ -72,7 +72,6 @@ $(function() {
USB_ATTACHED_SUBSTATE_WAIT_RESET
#define USB_ATTACHED_SUBSTATE_WAIT_RESET
Definition: UsbCore.h:127
FSHOST
#define FSHOST
Definition: max3421e.h:37
rHCTL
#define rHCTL
Definition: max3421e.h:181
-
SETUP_PKT::wVal_u
union SETUP_PKT::@31 wVal_u
UsbDevice::epinfo
EpInfo * epinfo
Definition: address.h:83
UsbDevice::lowspeed
bool lowspeed
Definition: address.h:86
USB_ERROR_EPINFO_IS_NULL
#define USB_ERROR_EPINFO_IS_NULL
Definition: UsbCore.h:96
@@ -132,6 +131,7 @@ $(function() {
bmREQ_GET_DESCR
#define bmREQ_GET_DESCR
Definition: UsbCore.h:60
rSNDBC
#define rSNDBC
Definition: max3421e.h:48
rHRSL
#define rHRSL
Definition: max3421e.h:203
+
SETUP_PKT::wVal_u
union SETUP_PKT::@41 wVal_u
USB_ATTACHED_SUBSTATE_RESET_DEVICE
#define USB_ATTACHED_SUBSTATE_RESET_DEVICE
Definition: UsbCore.h:124
MAX3421e::bytesRd
uint8_t * bytesRd(uint8_t reg, uint8_t nbytes, uint8_t *data_p)
Definition: usbhost.h:317
tokINHS
#define tokINHS
Definition: max3421e.h:198
@@ -155,7 +155,6 @@ $(function() {
USB_ERROR_ADDRESS_NOT_FOUND_IN_POOL
#define USB_ERROR_ADDRESS_NOT_FOUND_IN_POOL
Definition: UsbCore.h:95
USB_STATE_MASK
#define USB_STATE_MASK
Definition: UsbCore.h:117
USB_DEV_CONFIG_ERROR_DEVICE_NOT_SUPPORTED
#define USB_DEV_CONFIG_ERROR_DEVICE_NOT_SUPPORTED
Definition: UsbCore.h:90
-
SETUP_PKT::ReqType_u
union SETUP_PKT::@30 ReqType_u
USB::Task
void Task(void)
Definition: Usb.cpp:455
USB_DETACHED_SUBSTATE_ILLEGAL
#define USB_DETACHED_SUBSTATE_ILLEGAL
Definition: UsbCore.h:122
hrTIMEOUT
#define hrTIMEOUT
Definition: max3421e.h:228
@@ -176,6 +175,7 @@ $(function() {
USB::GetAddressPool
AddressPool & GetAddressPool()
Definition: UsbCore.h:226
USB_ERROR_INVALID_ARGUMENT
#define USB_ERROR_INVALID_ARGUMENT
Definition: UsbCore.h:97
USB::Configuring
uint8_t Configuring(uint8_t parent, uint8_t port, bool lowspeed)
Definition: Usb.cpp:683
+
SETUP_PKT::ReqType_u
union SETUP_PKT::@40 ReqType_u
USBTRACE3
#define USBTRACE3(s, r, l)
Definition: macros.h:85
SETUP_PKT::bRequest
uint8_t bRequest
Definition: UsbCore.h:187
SE0
#define SE0
Definition: max3421e.h:35
diff --git a/_usb_8h.html b/_usb_8h.html index 8d834f9b..4f2ac3d8 100644 --- a/_usb_8h.html +++ b/_usb_8h.html @@ -68,55 +68,55 @@ This graph shows which files directly or indirectly include this file:
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
diff --git a/_usb_8h__dep__incl.map b/_usb_8h__dep__incl.map index 81721e44..327517f6 100644 --- a/_usb_8h__dep__incl.map +++ b/_usb_8h__dep__incl.map @@ -1,51 +1,51 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/_usb_8h__dep__incl.md5 b/_usb_8h__dep__incl.md5 index 9ba6286c..2090dff1 100644 --- a/_usb_8h__dep__incl.md5 +++ b/_usb_8h__dep__incl.md5 @@ -1 +1 @@ -7630a82c45bf91c05f165eb324a51752 \ No newline at end of file +80fb4f558ce4bafa813aa31a77ddfc5a \ No newline at end of file diff --git a/_usb_8h__dep__incl.png b/_usb_8h__dep__incl.png index fc1043e50c33769120696340b7ea9aca00a24868..96238d0e126ee3bcb78cefa3b5525927d3fe3118 100644 GIT binary patch literal 157594 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 t%2r* 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

It-MhX-F- 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 D1%knV literal 155656 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

L2CAP_FLAG_DISCONNECT_CONTROL_RESPONSE
#define L2CAP_FLAG_DISCONNECT_CONTROL_RESPONSE
Definition: BTD.h:149
BTD::incomingWii
bool incomingWii
Definition: BTD.h:504
WII::onInit
void onInit()
Definition: Wii.cpp:1139
- +
WII::gyroPitchRaw
int16_t gyroPitchRaw
Definition: Wii.h:265
pgm_read_dword
#define pgm_read_dword(addr)
Definition: version_helper.h:167
wii_clear_flag
#define wii_clear_flag(flag)
Definition: Wii.h:33
@@ -93,7 +93,7 @@ $(function() {
WII::pitchGyroSpeed
float pitchGyroSpeed
Definition: Wii.h:249
WII::setRumbleOn
void setRumbleOn()
Definition: Wii.cpp:915
WII::Reset
void Reset()
Definition: Wii.cpp:101
-
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:163
+
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:170
TURN_ON_LED
#define TURN_ON_LED
Definition: BTD.h:139
WII::accZnunchuck
int16_t accZnunchuck
Definition: Wii.h:236
BotLeft
Definition: Wii.h:48
@@ -122,7 +122,7 @@ $(function() {
HID_CTRL_PSM
#define HID_CTRL_PSM
Definition: BTD.h:192
WII::WII
WII(BTD *p, bool pair=false)
Definition: Wii.cpp:85
WII_CHECK_EXTENSION_STATE
#define WII_CHECK_EXTENSION_STATE
Definition: BTD.h:142
- +
WII::rollGyroSpeed
float rollGyroSpeed
Definition: Wii.h:250
BTD::connectToWii
bool connectToWii
Definition: BTD.h:500
BTD::wiiUProController
bool wiiUProController
Definition: BTD.h:510
@@ -187,10 +187,10 @@ $(function() {
L2CAP_FLAG_INTERRUPT_CONNECTED
#define L2CAP_FLAG_INTERRUPT_CONNECTED
Definition: BTD.h:154
l2cap_set_flag
#define l2cap_set_flag(flag)
Definition: BTD.h:171
BTD::l2cap_config_request
void l2cap_config_request(uint16_t handle, uint8_t rxid, uint8_t *dcid)
Definition: BTD.cpp:1505
- +
WII::getButtonPress
bool getButtonPress(ButtonEnum b)
Definition: Wii.cpp:1097
L2CAP_FLAG_CONFIG_CONTROL_SUCCESS
#define L2CAP_FLAG_CONFIG_CONTROL_SUCCESS
Definition: BTD.h:147
- +
L2CAP_CMD_CONNECTION_REQUEST
#define L2CAP_CMD_CONNECTION_REQUEST
Definition: BTD.h:176
WII::getWiimotePitch
float getWiimotePitch()
Definition: Wii.h:212
WII::motionPlusConnected
bool motionPlusConnected
Definition: Wii.h:200
diff --git a/_wii_8h_source.html b/_wii_8h_source.html index 52520de9..1ffacfb1 100644 --- a/_wii_8h_source.html +++ b/_wii_8h_source.html @@ -80,7 +80,7 @@ $(function() {
WII::pitchGyroSpeed
float pitchGyroSpeed
Definition: Wii.h:249
WII::setRumbleOn
void setRumbleOn()
Definition: Wii.cpp:915
WII::Reset
void Reset()
Definition: Wii.cpp:101
-
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:163
+
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:170
WII::accZnunchuck
int16_t accZnunchuck
Definition: Wii.h:236
BotLeft
Definition: Wii.h:48
WII::getBatteryLevel
uint8_t getBatteryLevel()
Definition: Wii.cpp:968
diff --git a/_x_b_o_x_o_l_d_8cpp_source.html b/_x_b_o_x_o_l_d_8cpp_source.html index 40e46e45..dac657e6 100644 --- a/_x_b_o_x_o_l_d_8cpp_source.html +++ b/_x_b_o_x_o_l_d_8cpp_source.html @@ -66,7 +66,7 @@ $(function() { Go to the documentation of this file.
1 /* Copyright (C) 2013 Kristian Lauszus, TKJ Electronics. All rights reserved.
2 
3  This software may be distributed and modified under the terms of the GNU
4  General Public License version 2 (GPL2) as published by the Free Software
5  Foundation and appearing in the file GPL2.TXT included in the packaging of
6  this file. Please note that GPL2 Section 2[b] requires that all works based
7  on this software must also be made publicly available under the terms of
8  the GPL2 ("Copyleft").
9 
10  Contact information
11  -------------------
12 
13  Kristian Lauszus, TKJ Electronics
14  Web : http://www.tkjelectronics.com
15  e-mail : kristianl@tkjelectronics.com
16  */
17 
18 #include "XBOXOLD.h"
19 // To enable serial debugging see "settings.h"
20 //#define EXTRADEBUG // Uncomment to get even more debugging data
21 //#define PRINTREPORT // Uncomment to print the report send by the Xbox controller
22 
24 const uint8_t XBOXOLD_BUTTONS[] PROGMEM = {
25  0x01, // UP
26  0x08, // RIGHT
27  0x02, // DOWN
28  0x04, // LEFT
29 
30  0x20, // BACK
31  0x10, // START
32  0x40, // L3
33  0x80, // R3
34 
35  // A, B, X, Y, BLACK, WHITE, L1, and R1 are analog buttons
36  4, // BLACK
37  5, // WHTIE
38  6, // L1
39  7, // R1
40 
41  1, // B
42  0, // A
43  2, // X
44  3, // Y
45 };
46 
47 XBOXOLD::XBOXOLD(USB *p) :
48 pUsb(p), // pointer to USB class instance - mandatory
49 bAddress(0), // device address - mandatory
50 bPollEnable(false) { // don't start polling before dongle is connected
51  for(uint8_t i = 0; i < XBOX_MAX_ENDPOINTS; i++) {
52  epInfo[i].epAddr = 0;
53  epInfo[i].maxPktSize = (i) ? 0 : 8;
54  epInfo[i].bmSndToggle = 0;
55  epInfo[i].bmRcvToggle = 0;
56  epInfo[i].bmNakPower = (i) ? USB_NAK_NOWAIT : USB_NAK_MAX_POWER;
57  }
58 
59  if(pUsb) // register in USB subsystem
60  pUsb->RegisterDeviceClass(this); //set devConfig[] entry
61 }
62 
63 uint8_t XBOXOLD::Init(uint8_t parent, uint8_t port, bool lowspeed) {
64  uint8_t buf[sizeof (USB_DEVICE_DESCRIPTOR)];
65  USB_DEVICE_DESCRIPTOR * udd = reinterpret_cast<USB_DEVICE_DESCRIPTOR*>(buf);
66  uint8_t rcode;
67  UsbDevice *p = NULL;
68  EpInfo *oldep_ptr = NULL;
69  uint16_t PID;
70  uint16_t VID;
71 
72  // get memory address of USB device address pool
73  AddressPool &addrPool = pUsb->GetAddressPool();
74 #ifdef EXTRADEBUG
75  Notify(PSTR("\r\nXBOXUSB Init"), 0x80);
76 #endif
77  // check if address has already been assigned to an instance
78  if(bAddress) {
79 #ifdef DEBUG_USB_HOST
80  Notify(PSTR("\r\nAddress in use"), 0x80);
81 #endif
82  return USB_ERROR_CLASS_INSTANCE_ALREADY_IN_USE;
83  }
84 
85  // Get pointer to pseudo device with address 0 assigned
86  p = addrPool.GetUsbDevicePtr(0);
87 
88  if(!p) {
89 #ifdef DEBUG_USB_HOST
90  Notify(PSTR("\r\nAddress not found"), 0x80);
91 #endif
92  return USB_ERROR_ADDRESS_NOT_FOUND_IN_POOL;
93  }
94 
95  if(!p->epinfo) {
96 #ifdef DEBUG_USB_HOST
97  Notify(PSTR("\r\nepinfo is null"), 0x80);
98 #endif
99  return USB_ERROR_EPINFO_IS_NULL;
100  }
101 
102  // Save old pointer to EP_RECORD of address 0
103  oldep_ptr = p->epinfo;
104 
105  // Temporary assign new pointer to epInfo to p->epinfo in order to avoid toggle inconsistence
106  p->epinfo = epInfo;
107 
108  p->lowspeed = lowspeed;
109 
110  // Get device descriptor
111  rcode = pUsb->getDevDescr(0, 0, sizeof (USB_DEVICE_DESCRIPTOR), (uint8_t*)buf); // Get device descriptor - addr, ep, nbytes, data
112  // Restore p->epinfo
113  p->epinfo = oldep_ptr;
114 
115  if(rcode)
116  goto FailGetDevDescr;
117 
118  VID = udd->idVendor;
119  PID = udd->idProduct;
120 
121  if((VID != XBOX_VID && VID != MADCATZ_VID && VID != JOYTECH_VID) || (PID != XBOX_OLD_PID1 && PID != XBOX_OLD_PID2 && PID != XBOX_OLD_PID3 && PID != XBOX_OLD_PID4)) // Check if VID and PID match
122  goto FailUnknownDevice;
123 
124  // Allocate new address according to device class
125  bAddress = addrPool.AllocAddress(parent, false, port);
126 
127  if(!bAddress)
128  return USB_ERROR_OUT_OF_ADDRESS_SPACE_IN_POOL;
129 
130  // Extract Max Packet Size from device descriptor
131  epInfo[0].maxPktSize = udd->bMaxPacketSize0;
132 
133  // Assign new address to the device
134  rcode = pUsb->setAddr(0, 0, bAddress);
135  if(rcode) {
136  p->lowspeed = false;
137  addrPool.FreeAddress(bAddress);
138  bAddress = 0;
139 #ifdef DEBUG_USB_HOST
140  Notify(PSTR("\r\nsetAddr: "), 0x80);
141  D_PrintHex<uint8_t > (rcode, 0x80);
142 #endif
143  return rcode;
144  }
145 #ifdef EXTRADEBUG
146  Notify(PSTR("\r\nAddr: "), 0x80);
147  D_PrintHex<uint8_t > (bAddress, 0x80);
148 #endif
149  //delay(300); // Spec says you should wait at least 200ms
150 
151  p->lowspeed = false;
152 
153  //get pointer to assigned address record
154  p = addrPool.GetUsbDevicePtr(bAddress);
155  if(!p)
156  return USB_ERROR_ADDRESS_NOT_FOUND_IN_POOL;
157 
158  p->lowspeed = lowspeed;
159 
160  // Assign epInfo to epinfo pointer - only EP0 is known
161  rcode = pUsb->setEpInfoEntry(bAddress, 1, epInfo);
162  if(rcode)
163  goto FailSetDevTblEntry;
164 
165  /* The application will work in reduced host mode, so we can save program and data
166  memory space. After verifying the VID we will use known values for the
167  configuration values for device, interface, endpoints and HID for the XBOX controllers */
168 
169  /* Initialize data structures for endpoints of device */
170  epInfo[ XBOX_INPUT_PIPE ].epAddr = 0x01; // XBOX report endpoint
171  epInfo[ XBOX_INPUT_PIPE ].epAttribs = USB_TRANSFER_TYPE_INTERRUPT;
172  epInfo[ XBOX_INPUT_PIPE ].bmNakPower = USB_NAK_NOWAIT; // Only poll once for interrupt endpoints
173  epInfo[ XBOX_INPUT_PIPE ].maxPktSize = EP_MAXPKTSIZE;
174  epInfo[ XBOX_INPUT_PIPE ].bmSndToggle = 0;
175  epInfo[ XBOX_INPUT_PIPE ].bmRcvToggle = 0;
176  epInfo[ XBOX_OUTPUT_PIPE ].epAddr = 0x02; // XBOX output endpoint
177  epInfo[ XBOX_OUTPUT_PIPE ].epAttribs = USB_TRANSFER_TYPE_INTERRUPT;
178  epInfo[ XBOX_OUTPUT_PIPE ].bmNakPower = USB_NAK_NOWAIT; // Only poll once for interrupt endpoints
179  epInfo[ XBOX_OUTPUT_PIPE ].maxPktSize = EP_MAXPKTSIZE;
180  epInfo[ XBOX_OUTPUT_PIPE ].bmSndToggle = 0;
181  epInfo[ XBOX_OUTPUT_PIPE ].bmRcvToggle = 0;
182 
183  rcode = pUsb->setEpInfoEntry(bAddress, 3, epInfo);
184  if(rcode)
185  goto FailSetDevTblEntry;
186 
187  delay(200); // Give time for address change
188 
189  rcode = pUsb->setConf(bAddress, epInfo[ XBOX_CONTROL_PIPE ].epAddr, 1);
190  if(rcode)
191  goto FailSetConfDescr;
192 
193 #ifdef DEBUG_USB_HOST
194  Notify(PSTR("\r\nXbox Controller Connected\r\n"), 0x80);
195 #endif
196  if(pFuncOnInit)
197  pFuncOnInit(); // Call the user function
198  XboxConnected = true;
199  bPollEnable = true;
200  return 0; // Successful configuration
201 
202  /* Diagnostic messages */
203 FailGetDevDescr:
204 #ifdef DEBUG_USB_HOST
205  NotifyFailGetDevDescr();
206  goto Fail;
207 #endif
208 
209 FailSetDevTblEntry:
210 #ifdef DEBUG_USB_HOST
211  NotifyFailSetDevTblEntry();
212  goto Fail;
213 #endif
214 
215 FailSetConfDescr:
216 #ifdef DEBUG_USB_HOST
217  NotifyFailSetConfDescr();
218 #endif
219  goto Fail;
220 
221 FailUnknownDevice:
222 #ifdef DEBUG_USB_HOST
223  NotifyFailUnknownDevice(VID, PID);
224 #endif
225  rcode = USB_DEV_CONFIG_ERROR_DEVICE_NOT_SUPPORTED;
226 
227 Fail:
228 #ifdef DEBUG_USB_HOST
229  Notify(PSTR("\r\nXbox Init Failed, error code: "), 0x80);
230  NotifyFail(rcode);
231 #endif
232  Release();
233  return rcode;
234 }
235 
236 /* Performs a cleanup after failed Init() attempt */
237 uint8_t XBOXOLD::Release() {
238  XboxConnected = false;
239  pUsb->GetAddressPool().FreeAddress(bAddress);
240  bAddress = 0;
241  bPollEnable = false;
242  return 0;
243 }
244 
245 uint8_t XBOXOLD::Poll() {
246  if(!bPollEnable)
247  return 0;
248  uint16_t BUFFER_SIZE = EP_MAXPKTSIZE;
249  pUsb->inTransfer(bAddress, epInfo[ XBOX_INPUT_PIPE ].epAddr, &BUFFER_SIZE, readBuf); // input on endpoint 1
250  readReport();
251 #ifdef PRINTREPORT
252  printReport(BUFFER_SIZE); // Uncomment "#define PRINTREPORT" to print the report send by the Xbox controller
253 #endif
254  return 0;
255 }
256 
257 void XBOXOLD::readReport() {
258  ButtonState = readBuf[2];
259 
260  for(uint8_t i = 0; i < sizeof (buttonValues); i++)
261  buttonValues[i] = readBuf[i + 4]; // A, B, X, Y, BLACK, WHITE, L1, and R1
262 
263  hatValue[LeftHatX] = (int16_t)(((uint16_t)readBuf[12] << 8) | readBuf[13]);
264  hatValue[LeftHatY] = (int16_t)(((uint16_t)readBuf[14] << 8) | readBuf[15]);
265  hatValue[RightHatX] = (int16_t)(((uint16_t)readBuf[16] << 8) | readBuf[17]);
266  hatValue[RightHatY] = (int16_t)(((uint16_t)readBuf[18] << 8) | readBuf[19]);
267 
268  //Notify(PSTR("\r\nButtonState"), 0x80);
269  //PrintHex<uint8_t>(ButtonState, 0x80);
270 
271  if(ButtonState != OldButtonState || memcmp(buttonValues, oldButtonValues, sizeof (buttonValues)) != 0) {
272  ButtonClickState = ButtonState & ~OldButtonState; // Update click state variable
273  OldButtonState = ButtonState;
274 
275  for(uint8_t i = 0; i < sizeof (buttonValues); i++) {
276  if(oldButtonValues[i] == 0 && buttonValues[i] != 0)
277  buttonClicked[i] = true; // Update A, B, X, Y, BLACK, WHITE, L1, and R1 click state
278  oldButtonValues[i] = buttonValues[i];
279  }
280  }
281 }
282 
283 void XBOXOLD::printReport(uint16_t length __attribute__((unused))) { //Uncomment "#define PRINTREPORT" to print the report send by the Xbox controller
284 #ifdef PRINTREPORT
285  if(readBuf == NULL)
286  return;
287  for(uint8_t i = 0; i < length; i++) {
288  D_PrintHex<uint8_t > (readBuf[i], 0x80);
289  Notify(PSTR(" "), 0x80);
290  }
291  Notify(PSTR("\r\n"), 0x80);
292 #endif
293 }
294 
295 uint8_t XBOXOLD::getButtonPress(ButtonEnum b) {
296  uint8_t button = pgm_read_byte(&XBOXOLD_BUTTONS[(uint8_t)b]);
297  if(b == A || b == B || b == X || b == Y || b == BLACK || b == WHITE || b == L1 || b == R1) // A, B, X, Y, BLACK, WHITE, L1, and R1 are analog buttons
298  return buttonValues[button]; // Analog buttons
299  return (ButtonState & button); // Digital buttons
300 }
301 
302 bool XBOXOLD::getButtonClick(ButtonEnum b) {
303  uint8_t button = pgm_read_byte(&XBOXOLD_BUTTONS[(uint8_t)b]);
304  if(b == A || b == B || b == X || b == Y || b == BLACK || b == WHITE || b == L1 || b == R1) { // A, B, X, Y, BLACK, WHITE, L1, and R1 are analog buttons
305  if(buttonClicked[button]) {
306  buttonClicked[button] = false;
307  return true;
308  }
309  return false;
310  }
311 
312  bool click = (ButtonClickState & button);
313  ButtonClickState &= ~button; // clear "click" event
314  return click;
315 }
316 
317 int16_t XBOXOLD::getAnalogHat(AnalogHatEnum a) {
318  return hatValue[a];
319 }
320 
321 /* Xbox Controller commands */
322 void XBOXOLD::XboxCommand(uint8_t* data, uint16_t nbytes) {
323  //bmRequest = Host to device (0x00) | Class (0x20) | Interface (0x01) = 0x21, bRequest = Set Report (0x09), Report ID (0x00), Report Type (Output 0x02), interface (0x00), datalength, datalength, data)
324  pUsb->ctrlReq(bAddress, epInfo[XBOX_CONTROL_PIPE].epAddr, bmREQ_HID_OUT, HID_REQUEST_SET_REPORT, 0x00, 0x02, 0x00, nbytes, nbytes, data, NULL);
325 }
326 
327 void XBOXOLD::setRumbleOn(uint8_t lValue, uint8_t rValue) {
328  uint8_t writeBuf[6];
329 
330  writeBuf[0] = 0x00;
331  writeBuf[1] = 0x06;
332  writeBuf[2] = 0x00;
333  writeBuf[3] = rValue; // small weight
334  writeBuf[4] = 0x00;
335  writeBuf[5] = lValue; // big weight
336 
337  XboxCommand(writeBuf, 6);
338 }
XBOXOLD.h
EpInfo::bmRcvToggle
uint8_t bmRcvToggle
Definition: address.h:48
- +
UsbDevice::epinfo
EpInfo * epinfo
Definition: address.h:83
UsbDevice::lowspeed
bool lowspeed
Definition: address.h:86
USB_ERROR_EPINFO_IS_NULL
#define USB_ERROR_EPINFO_IS_NULL
Definition: UsbCore.h:96
@@ -75,7 +75,7 @@ $(function() {
XBOXOLD::Release
uint8_t Release()
Definition: XBOXOLD.cpp:237
NotifyFail
#define NotifyFail(...)
Definition: message.h:62
-
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:163
+
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:170
USB::setConf
uint8_t setConf(uint8_t addr, uint8_t ep, uint8_t conf_value)
Definition: Usb.cpp:840
USB_TRANSFER_TYPE_INTERRUPT
#define USB_TRANSFER_TYPE_INTERRUPT
Definition: usb_ch9.h:93
@@ -105,7 +105,7 @@ $(function() {
XBOXOLD::getAnalogHat
int16_t getAnalogHat(AnalogHatEnum a)
Definition: XBOXOLD.cpp:317
XBOX_VID
#define XBOX_VID
Definition: XBOXOLD.h:34
XBOX_INPUT_PIPE
#define XBOX_INPUT_PIPE
Definition: XBOXOLD.h:30
- +
XBOXOLD::XBOXOLD
XBOXOLD(USB *pUsb)
Definition: XBOXOLD.cpp:47
XBOX_OLD_PID1
#define XBOX_OLD_PID1
Definition: XBOXOLD.h:38
EpInfo
Definition: address.h:39
@@ -137,8 +137,8 @@ $(function() {
XBOXOLD::getButtonPress
uint8_t getButtonPress(ButtonEnum b)
Definition: XBOXOLD.cpp:295
XBOX_CONTROL_PIPE
#define XBOX_CONTROL_PIPE
Definition: XBOXOLD.h:29
XBOXOLD::bAddress
uint8_t bAddress
Definition: XBOXOLD.h:151
- - + +
HID_REQUEST_SET_REPORT
#define HID_REQUEST_SET_REPORT
Definition: usbhid.h:72
USB::RegisterDeviceClass
uint8_t RegisterDeviceClass(USBDeviceConfig *pdev)
Definition: UsbCore.h:230
NotifyFailSetConfDescr
#define NotifyFailSetConfDescr(...)
Definition: message.h:60
diff --git a/_x_b_o_x_o_l_d_8h_source.html b/_x_b_o_x_o_l_d_8h_source.html index 2da6ff64..73a2c304 100644 --- a/_x_b_o_x_o_l_d_8h_source.html +++ b/_x_b_o_x_o_l_d_8h_source.html @@ -65,7 +65,7 @@ $(function() {
Go to the documentation of this file.
1 /* Copyright (C) 2013 Kristian Lauszus, TKJ Electronics. All rights reserved.
2 
3  This software may be distributed and modified under the terms of the GNU
4  General Public License version 2 (GPL2) as published by the Free Software
5  Foundation and appearing in the file GPL2.TXT included in the packaging of
6  this file. Please note that GPL2 Section 2[b] requires that all works based
7  on this software must also be made publicly available under the terms of
8  the GPL2 ("Copyleft").
9 
10  Contact information
11  -------------------
12 
13  Kristian Lauszus, TKJ Electronics
14  Web : http://www.tkjelectronics.com
15  e-mail : kristianl@tkjelectronics.com
16  */
17 
18 #ifndef _xboxold_h_
19 #define _xboxold_h_
20 
21 #include "Usb.h"
22 #include "usbhid.h"
23 #include "controllerEnums.h"
24 
25 /* Data Xbox taken from descriptors */
26 #define EP_MAXPKTSIZE 32 // Max size for data via USB
27 
28 /* Names we give to the 3 Xbox pipes */
29 #define XBOX_CONTROL_PIPE 0
30 #define XBOX_INPUT_PIPE 1
31 #define XBOX_OUTPUT_PIPE 2
32 
33 // PID and VID of the different devices
34 #define XBOX_VID 0x045E // Microsoft Corporation
35 #define MADCATZ_VID 0x1BAD // For unofficial Mad Catz controllers
36 #define JOYTECH_VID 0x162E // For unofficial Joytech controllers
37 
38 #define XBOX_OLD_PID1 0x0202 // Original Microsoft Xbox controller (US)
39 #define XBOX_OLD_PID2 0x0285 // Original Microsoft Xbox controller (Japan)
40 #define XBOX_OLD_PID3 0x0287 // Microsoft Microsoft Xbox Controller S
41 #define XBOX_OLD_PID4 0x0289 // Smaller Microsoft Xbox controller (US)
42 
43 #define XBOX_MAX_ENDPOINTS 3
44 
46 class XBOXOLD : public USBDeviceConfig {
47 public:
52  XBOXOLD(USB *pUsb);
53 
62  uint8_t Init(uint8_t parent, uint8_t port, bool lowspeed);
67  uint8_t Release();
72  uint8_t Poll();
73 
78  virtual uint8_t GetAddress() {
79  return bAddress;
80  };
81 
86  virtual bool isReady() {
87  return bPollEnable;
88  };
89 
96  virtual bool VIDPIDOK(uint16_t vid, uint16_t pid) {
97  return ((vid == XBOX_VID || vid == MADCATZ_VID || vid == JOYTECH_VID) && (pid == XBOX_OLD_PID1 || pid == XBOX_OLD_PID2 || pid == XBOX_OLD_PID3 || pid == XBOX_OLD_PID4));
98  };
112  uint8_t getButtonPress(ButtonEnum b);
113  bool getButtonClick(ButtonEnum b);
122  int16_t getAnalogHat(AnalogHatEnum a);
123 
125  void setRumbleOff() {
126  setRumbleOn(0, 0);
127  };
133  void setRumbleOn(uint8_t lValue, uint8_t rValue);
134 
139  void attachOnInit(void (*funcOnInit)(void)) {
140  pFuncOnInit = funcOnInit;
141  };
145  bool XboxConnected;
146 
147 protected:
149  USB *pUsb;
151  uint8_t bAddress;
153  EpInfo epInfo[XBOX_MAX_ENDPOINTS];
154 
155 private:
161  void (*pFuncOnInit)(void); // Pointer to function called in onInit()
162 
163  bool bPollEnable;
164 
165  /* Variables to store the digital buttons */
166  uint8_t ButtonState;
167  uint8_t OldButtonState;
168  uint8_t ButtonClickState;
169 
170  /* Variables to store the analog buttons */
171  uint8_t buttonValues[8]; // A, B, X, Y, BLACK, WHITE, L1, and R1
172  uint8_t oldButtonValues[8];
173  bool buttonClicked[8];
174 
175  int16_t hatValue[4]; // Joystick values
176 
177  uint8_t readBuf[EP_MAXPKTSIZE]; // General purpose buffer for input data
178 
179  void readReport(); // Read incoming data
180  void printReport(uint16_t length); // Print incoming date
181 
182  /* Private commands */
183  void XboxCommand(uint8_t* data, uint16_t nbytes);
184 };
185 #endif
XBOXOLD::Release
uint8_t Release()
Definition: XBOXOLD.cpp:237
XBOXOLD::attachOnInit
void attachOnInit(void(*funcOnInit)(void))
Definition: XBOXOLD.h:139
-
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:163
+
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:170
XBOXOLD::GetAddress
virtual uint8_t GetAddress()
Definition: XBOXOLD.h:78
Usb.h
diff --git a/_x_b_o_x_o_n_e_8cpp_source.html b/_x_b_o_x_o_n_e_8cpp_source.html index 0305a52b..d03bb4bd 100644 --- a/_x_b_o_x_o_n_e_8cpp_source.html +++ b/_x_b_o_x_o_n_e_8cpp_source.html @@ -67,7 +67,7 @@ $(function() {
USB::getConfDescr
uint8_t getConfDescr(uint8_t addr, uint8_t ep, uint16_t nbytes, uint8_t conf, uint8_t *dataptr)
Definition: Usb.cpp:801
EpInfo::bmRcvToggle
uint8_t bmRcvToggle
Definition: address.h:48
- +
UsbDevice::epinfo
EpInfo * epinfo
Definition: address.h:83
UsbDevice::lowspeed
bool lowspeed
Definition: address.h:86
USB_ERROR_EPINFO_IS_NULL
#define USB_ERROR_EPINFO_IS_NULL
Definition: UsbCore.h:96
@@ -78,7 +78,7 @@ $(function() {
USB_ENDPOINT_DESCRIPTOR::bInterval
uint8_t bInterval
Definition: usb_ch9.h:154
XBOXONE::pUsb
USB * pUsb
Definition: XBOXONE.h:181
NotifyFail
#define NotifyFail(...)
Definition: message.h:62
-
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:163
+
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:170
USB::setConf
uint8_t setConf(uint8_t addr, uint8_t ep, uint8_t conf_value)
Definition: Usb.cpp:840
XBOXONE::bAddress
uint8_t bAddress
Definition: XBOXONE.h:183
XBOXONE::XBOXONE
XBOXONE(USB *pUsb)
Definition: XBOXONE.cpp:27
@@ -103,7 +103,7 @@ $(function() {
XBOXONE::setRumbleOff
void setRumbleOff()
Definition: XBOXONE.cpp:450
USB_NAK_MAX_POWER
#define USB_NAK_MAX_POWER
Definition: address.h:34
XBOXONE::Release
virtual uint8_t Release()
Definition: XBOXONE.cpp:286
- +
EpInfo
Definition: address.h:39
USB::outTransfer
uint8_t outTransfer(uint8_t addr, uint8_t ep, uint16_t nbytes, uint8_t *data)
Definition: Usb.cpp:303
hrNAK
#define hrNAK
Definition: max3421e.h:218
@@ -135,9 +135,9 @@ $(function() {
USB
Definition: UsbCore.h:210
XBOX_ONE_CONTROL_PIPE
#define XBOX_ONE_CONTROL_PIPE
Definition: XBOXONE.h:33
XBOX_ONE_OUTPUT_PIPE
#define XBOX_ONE_OUTPUT_PIPE
Definition: XBOXONE.h:34
- +
XBOXONE::getAnalogHat
int16_t getAnalogHat(AnalogHatEnum a)
Definition: XBOXONE.cpp:408
- +
XBOX_BUTTONS
const uint16_t XBOX_BUTTONS[]
Definition: xboxEnums.h:41
USB::RegisterDeviceClass
uint8_t RegisterDeviceClass(USBDeviceConfig *pdev)
Definition: UsbCore.h:230
diff --git a/_x_b_o_x_o_n_e_8h_source.html b/_x_b_o_x_o_n_e_8h_source.html index 8f6660af..537e3e2a 100644 --- a/_x_b_o_x_o_n_e_8h_source.html +++ b/_x_b_o_x_o_n_e_8h_source.html @@ -73,7 +73,7 @@ $(function() {
USB_ENDPOINT_DESCRIPTOR
Definition: usb_ch9.h:148
XBOXONE::pUsb
USB * pUsb
Definition: XBOXONE.h:181
XBOXONE::attachOnInit
void attachOnInit(void(*funcOnInit)(void))
Definition: XBOXONE.h:159
-
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:163
+
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:170
XBOXONE::bAddress
uint8_t bAddress
Definition: XBOXONE.h:183
XBOXONE::XBOXONE
XBOXONE(USB *pUsb)
Definition: XBOXONE.cpp:27
diff --git a/_x_b_o_x_o_n_e_s_parser_8cpp.html b/_x_b_o_x_o_n_e_s_parser_8cpp.html index ab878d37..2f1f2219 100644 --- a/_x_b_o_x_o_n_e_s_parser_8cpp.html +++ b/_x_b_o_x_o_n_e_s_parser_8cpp.html @@ -94,16 +94,27 @@ Enumerations DPAD_LEFT_UP = 0x7,
  DPAD_OFF = 0x8, +DPAD_UP = 0x0, +DPAD_UP_RIGHT = 0x1, +DPAD_RIGHT = 0x2, +
+  DPAD_RIGHT_DOWN = 0x3, +DPAD_DOWN = 0x4, +DPAD_DOWN_LEFT = 0x5, +DPAD_LEFT = 0x6, +
+  DPAD_LEFT_UP = 0x7, +DPAD_OFF = 0x8, DPAD_OFF = 0x0, DPAD_UP = 0x1, -DPAD_UP_RIGHT = 0x2,
-  DPAD_RIGHT = 0x3, +  DPAD_UP_RIGHT = 0x2, +DPAD_RIGHT = 0x3, DPAD_RIGHT_DOWN = 0x4, DPAD_DOWN = 0x5, -DPAD_DOWN_LEFT = 0x6,
-  DPAD_LEFT = 0x7, +  DPAD_DOWN_LEFT = 0x6, +DPAD_LEFT = 0x7, DPAD_LEFT_UP = 0x8
} @@ -136,6 +147,15 @@ Variables DPAD_LEFT  DPAD_LEFT_UP  DPAD_OFF  +DPAD_UP  +DPAD_UP_RIGHT  +DPAD_RIGHT  +DPAD_RIGHT_DOWN  +DPAD_DOWN  +DPAD_DOWN_LEFT  +DPAD_LEFT  +DPAD_LEFT_UP  +DPAD_OFF  DPAD_OFF  DPAD_UP  DPAD_UP_RIGHT  diff --git a/_x_b_o_x_o_n_e_s_parser_8cpp_source.html b/_x_b_o_x_o_n_e_s_parser_8cpp_source.html index aa8c0e6f..3dc2ef51 100644 --- a/_x_b_o_x_o_n_e_s_parser_8cpp_source.html +++ b/_x_b_o_x_o_n_e_s_parser_8cpp_source.html @@ -67,7 +67,7 @@ $(function() {
DPAD_LEFT
Definition: XBOXONESParser.cpp:53
XBOXONESParser::getButtonClick
bool getButtonClick(ButtonEnum b)
Definition: XBOXONESParser.cpp:84
-
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:163
+
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:170
DPADEnum
DPADEnum
Definition: PS4Parser.cpp:20
XBOXONESParser::getAnalogHat
int16_t getAnalogHat(AnalogHatEnum a)
Definition: XBOXONESParser.cpp:108
pgm_read_byte
#define pgm_read_byte(addr)
Definition: version_helper.h:161
diff --git a/_x_b_o_x_o_n_e_s_parser_8h_source.html b/_x_b_o_x_o_n_e_s_parser_8h_source.html index 212f152b..af89b6b8 100644 --- a/_x_b_o_x_o_n_e_s_parser_8h_source.html +++ b/_x_b_o_x_o_n_e_s_parser_8h_source.html @@ -68,7 +68,7 @@ $(function() { -
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:163
+
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:170
Usb.h
XboxOneSData::btn
XboxOneSButtons btn
Definition: XBOXONESParser.h:50
diff --git a/_x_b_o_x_r_e_c_v_8cpp_source.html b/_x_b_o_x_r_e_c_v_8cpp_source.html index 47090f9b..ea9ed427 100644 --- a/_x_b_o_x_r_e_c_v_8cpp_source.html +++ b/_x_b_o_x_r_e_c_v_8cpp_source.html @@ -66,7 +66,7 @@ $(function() { Go to the documentation of this file.
1 /* Copyright (C) 2012 Kristian Lauszus, TKJ Electronics. All rights reserved.
2 
3  This software may be distributed and modified under the terms of the GNU
4  General Public License version 2 (GPL2) as published by the Free Software
5  Foundation and appearing in the file GPL2.TXT included in the packaging of
6  this file. Please note that GPL2 Section 2[b] requires that all works based
7  on this software must also be made publicly available under the terms of
8  the GPL2 ("Copyleft").
9 
10  Contact information
11  -------------------
12 
13  Kristian Lauszus, TKJ Electronics
14  Web : http://www.tkjelectronics.com
15  e-mail : kristianl@tkjelectronics.com
16 
17  getBatteryLevel and checkStatus functions made by timstamp.co.uk found using BusHound from Perisoft.net
18  */
19 
20 #include "XBOXRECV.h"
21 // To enable serial debugging see "settings.h"
22 //#define EXTRADEBUG // Uncomment to get even more debugging data
23 //#define PRINTREPORT // Uncomment to print the report send by the Xbox 360 Controller
24 
25 XBOXRECV::XBOXRECV(USB *p) :
26 pUsb(p), // pointer to USB class instance - mandatory
27 bAddress(0), // device address - mandatory
28 bPollEnable(false) { // don't start polling before dongle is connected
29  for(uint8_t i = 0; i < XBOX_MAX_ENDPOINTS; i++) {
30  epInfo[i].epAddr = 0;
31  epInfo[i].maxPktSize = (i) ? 0 : 8;
32  epInfo[i].bmSndToggle = 0;
33  epInfo[i].bmRcvToggle = 0;
34  epInfo[i].bmNakPower = (i) ? USB_NAK_NOWAIT : USB_NAK_MAX_POWER;
35  }
36 
37  if(pUsb) // register in USB subsystem
38  pUsb->RegisterDeviceClass(this); //set devConfig[] entry
39 }
40 
41 uint8_t XBOXRECV::ConfigureDevice(uint8_t parent, uint8_t port, bool lowspeed) {
42  const uint8_t constBufSize = sizeof (USB_DEVICE_DESCRIPTOR);
43  uint8_t buf[constBufSize];
44  USB_DEVICE_DESCRIPTOR * udd = reinterpret_cast<USB_DEVICE_DESCRIPTOR*>(buf);
45  uint8_t rcode;
46  UsbDevice *p = NULL;
47  EpInfo *oldep_ptr = NULL;
48  uint16_t PID, VID;
49 
50  AddressPool &addrPool = pUsb->GetAddressPool(); // Get memory address of USB device address pool
51 #ifdef EXTRADEBUG
52  Notify(PSTR("\r\nXBOXRECV Init"), 0x80);
53 #endif
54 
55  if(bAddress) { // Check if address has already been assigned to an instance
56 #ifdef DEBUG_USB_HOST
57  Notify(PSTR("\r\nAddress in use"), 0x80);
58 #endif
59  return USB_ERROR_CLASS_INSTANCE_ALREADY_IN_USE;
60  }
61 
62  p = addrPool.GetUsbDevicePtr(0); // Get pointer to pseudo device with address 0 assigned
63 
64  if(!p) {
65 #ifdef DEBUG_USB_HOST
66  Notify(PSTR("\r\nAddress not found"), 0x80);
67 #endif
68  return USB_ERROR_ADDRESS_NOT_FOUND_IN_POOL;
69  }
70 
71  if(!p->epinfo) {
72 #ifdef DEBUG_USB_HOST
73  Notify(PSTR("\r\nepinfo is null"), 0x80);
74 #endif
75  return USB_ERROR_EPINFO_IS_NULL;
76  }
77 
78  oldep_ptr = p->epinfo; // Save old pointer to EP_RECORD of address 0
79  p->epinfo = epInfo; // Temporary assign new pointer to epInfo to p->epinfo in order to avoid toggle inconsistence
80  p->lowspeed = lowspeed;
81 
82  rcode = pUsb->getDevDescr(0, 0, constBufSize, (uint8_t*)buf); // Get device descriptor - addr, ep, nbytes, data
83 
84  p->epinfo = oldep_ptr; // Restore p->epinfo
85 
86  if(rcode)
87  goto FailGetDevDescr;
88 
89  VID = udd->idVendor;
90  PID = udd->idProduct;
91 
92  if((VID != XBOX_VID && VID != MADCATZ_VID && VID != JOYTECH_VID) || (PID != XBOX_WIRELESS_RECEIVER_PID && PID != XBOX_WIRELESS_RECEIVER_THIRD_PARTY_PID)) { // Check if it's a Xbox receiver using the Vendor ID and Product ID
93 #ifdef DEBUG_USB_HOST
94  Notify(PSTR("\r\nYou'll need a wireless receiver for this libary to work"), 0x80);
95 #endif
96  goto FailUnknownDevice;
97  }
98 
99  bAddress = addrPool.AllocAddress(parent, false, port); // Allocate new address according to device class
100 
101  if(!bAddress) {
102 #ifdef DEBUG_USB_HOST
103  Notify(PSTR("\r\nOut of address space"), 0x80);
104 #endif
105  return USB_ERROR_OUT_OF_ADDRESS_SPACE_IN_POOL;
106  }
107 
108  epInfo[0].maxPktSize = udd->bMaxPacketSize0; // Extract Max Packet Size from device descriptor
109 
110  delay(20); // Wait a little before resetting device
111 
112  return USB_ERROR_CONFIG_REQUIRES_ADDITIONAL_RESET;
113 
114  /* Diagnostic messages */
115 FailGetDevDescr:
116 #ifdef DEBUG_USB_HOST
117  NotifyFailGetDevDescr(rcode);
118 #endif
119  if(rcode != hrJERR)
120  rcode = USB_ERROR_FailGetDevDescr;
121  goto Fail;
122 
123 FailUnknownDevice:
124 #ifdef DEBUG_USB_HOST
125  NotifyFailUnknownDevice(VID, PID);
126 #endif
127  rcode = USB_DEV_CONFIG_ERROR_DEVICE_NOT_SUPPORTED;
128 
129 Fail:
130 #ifdef DEBUG_USB_HOST
131  Notify(PSTR("\r\nXbox 360 Init Failed, error code: "), 0x80);
132  NotifyFail(rcode);
133 #endif
134  Release();
135  return rcode;
136 };
137 
138 uint8_t XBOXRECV::Init(uint8_t parent __attribute__((unused)), uint8_t port __attribute__((unused)), bool lowspeed) {
139  uint8_t rcode;
140 
141  AddressPool &addrPool = pUsb->GetAddressPool();
142 #ifdef EXTRADEBUG
143  Notify(PSTR("\r\nBTD Init"), 0x80);
144 #endif
145  UsbDevice *p = addrPool.GetUsbDevicePtr(bAddress); // Get pointer to assigned address record
146 
147  if(!p) {
148 #ifdef DEBUG_USB_HOST
149  Notify(PSTR("\r\nAddress not found"), 0x80);
150 #endif
151  return USB_ERROR_ADDRESS_NOT_FOUND_IN_POOL;
152  }
153 
154  delay(300); // Assign new address to the device
155 
156  rcode = pUsb->setAddr(0, 0, bAddress); // Assign new address to the device
157  if(rcode) {
158 #ifdef DEBUG_USB_HOST
159  Notify(PSTR("\r\nsetAddr: "), 0x80);
160  D_PrintHex<uint8_t > (rcode, 0x80);
161 #endif
162  p->lowspeed = false;
163  goto Fail;
164  }
165 #ifdef EXTRADEBUG
166  Notify(PSTR("\r\nAddr: "), 0x80);
167  D_PrintHex<uint8_t > (bAddress, 0x80);
168 #endif
169 
170  p->lowspeed = false;
171 
172  p = addrPool.GetUsbDevicePtr(bAddress); // Get pointer to assigned address record
173  if(!p) {
174 #ifdef DEBUG_USB_HOST
175  Notify(PSTR("\r\nAddress not found"), 0x80);
176 #endif
177  return USB_ERROR_ADDRESS_NOT_FOUND_IN_POOL;
178  }
179 
180  p->lowspeed = lowspeed;
181 
182  rcode = pUsb->setEpInfoEntry(bAddress, 1, epInfo); // Assign epInfo to epinfo pointer - only EP0 is known
183  if(rcode)
184  goto FailSetDevTblEntry;
185 
186  /* The application will work in reduced host mode, so we can save program and data
187  memory space. After verifying the VID we will use known values for the
188  configuration values for device, interface, endpoints and HID for the XBOX360 Wireless receiver */
189 
190  /* Initialize data structures for endpoints of device */
191  epInfo[ XBOX_INPUT_PIPE_1 ].epAddr = 0x01; // XBOX 360 report endpoint - poll interval 1ms
192  epInfo[ XBOX_INPUT_PIPE_1 ].epAttribs = USB_TRANSFER_TYPE_INTERRUPT;
193  epInfo[ XBOX_INPUT_PIPE_1 ].bmNakPower = USB_NAK_NOWAIT; // Only poll once for interrupt endpoints
194  epInfo[ XBOX_INPUT_PIPE_1 ].maxPktSize = EP_MAXPKTSIZE;
195  epInfo[ XBOX_INPUT_PIPE_1 ].bmSndToggle = 0;
196  epInfo[ XBOX_INPUT_PIPE_1 ].bmRcvToggle = 0;
197  epInfo[ XBOX_OUTPUT_PIPE_1 ].epAddr = 0x01; // XBOX 360 output endpoint - poll interval 8ms
198  epInfo[ XBOX_OUTPUT_PIPE_1 ].epAttribs = USB_TRANSFER_TYPE_INTERRUPT;
199  epInfo[ XBOX_OUTPUT_PIPE_1 ].bmNakPower = USB_NAK_NOWAIT; // Only poll once for interrupt endpoints
200  epInfo[ XBOX_OUTPUT_PIPE_1 ].maxPktSize = EP_MAXPKTSIZE;
201  epInfo[ XBOX_OUTPUT_PIPE_1 ].bmSndToggle = 0;
202  epInfo[ XBOX_OUTPUT_PIPE_1 ].bmRcvToggle = 0;
203 
204  epInfo[ XBOX_INPUT_PIPE_2 ].epAddr = 0x03; // XBOX 360 report endpoint - poll interval 1ms
205  epInfo[ XBOX_INPUT_PIPE_2 ].epAttribs = USB_TRANSFER_TYPE_INTERRUPT;
206  epInfo[ XBOX_INPUT_PIPE_2 ].bmNakPower = USB_NAK_NOWAIT; // Only poll once for interrupt endpoints
207  epInfo[ XBOX_INPUT_PIPE_2 ].maxPktSize = EP_MAXPKTSIZE;
208  epInfo[ XBOX_INPUT_PIPE_2 ].bmSndToggle = 0;
209  epInfo[ XBOX_INPUT_PIPE_2 ].bmRcvToggle = 0;
210  epInfo[ XBOX_OUTPUT_PIPE_2 ].epAddr = 0x03; // XBOX 360 output endpoint - poll interval 8ms
211  epInfo[ XBOX_OUTPUT_PIPE_2 ].epAttribs = USB_TRANSFER_TYPE_INTERRUPT;
212  epInfo[ XBOX_OUTPUT_PIPE_2 ].bmNakPower = USB_NAK_NOWAIT; // Only poll once for interrupt endpoints
213  epInfo[ XBOX_OUTPUT_PIPE_2 ].maxPktSize = EP_MAXPKTSIZE;
214  epInfo[ XBOX_OUTPUT_PIPE_2 ].bmSndToggle = 0;
215  epInfo[ XBOX_OUTPUT_PIPE_2 ].bmRcvToggle = 0;
216 
217  epInfo[ XBOX_INPUT_PIPE_3 ].epAddr = 0x05; // XBOX 360 report endpoint - poll interval 1ms
218  epInfo[ XBOX_INPUT_PIPE_3 ].epAttribs = USB_TRANSFER_TYPE_INTERRUPT;
219  epInfo[ XBOX_INPUT_PIPE_3 ].bmNakPower = USB_NAK_NOWAIT; // Only poll once for interrupt endpoints
220  epInfo[ XBOX_INPUT_PIPE_3 ].maxPktSize = EP_MAXPKTSIZE;
221  epInfo[ XBOX_INPUT_PIPE_3 ].bmSndToggle = 0;
222  epInfo[ XBOX_INPUT_PIPE_3 ].bmRcvToggle = 0;
223  epInfo[ XBOX_OUTPUT_PIPE_3 ].epAddr = 0x05; // XBOX 360 output endpoint - poll interval 8ms
224  epInfo[ XBOX_OUTPUT_PIPE_3 ].epAttribs = USB_TRANSFER_TYPE_INTERRUPT;
225  epInfo[ XBOX_OUTPUT_PIPE_3 ].bmNakPower = USB_NAK_NOWAIT; // Only poll once for interrupt endpoints
226  epInfo[ XBOX_OUTPUT_PIPE_3 ].maxPktSize = EP_MAXPKTSIZE;
227  epInfo[ XBOX_OUTPUT_PIPE_3 ].bmSndToggle = 0;
228  epInfo[ XBOX_OUTPUT_PIPE_3 ].bmRcvToggle = 0;
229 
230  epInfo[ XBOX_INPUT_PIPE_4 ].epAddr = 0x07; // XBOX 360 report endpoint - poll interval 1ms
231  epInfo[ XBOX_INPUT_PIPE_4 ].epAttribs = USB_TRANSFER_TYPE_INTERRUPT;
232  epInfo[ XBOX_INPUT_PIPE_4 ].bmNakPower = USB_NAK_NOWAIT; // Only poll once for interrupt endpoints
233  epInfo[ XBOX_INPUT_PIPE_4 ].maxPktSize = EP_MAXPKTSIZE;
234  epInfo[ XBOX_INPUT_PIPE_4 ].bmSndToggle = 0;
235  epInfo[ XBOX_INPUT_PIPE_4 ].bmRcvToggle = 0;
236  epInfo[ XBOX_OUTPUT_PIPE_4 ].epAddr = 0x07; // XBOX 360 output endpoint - poll interval 8ms
237  epInfo[ XBOX_OUTPUT_PIPE_4 ].epAttribs = USB_TRANSFER_TYPE_INTERRUPT;
238  epInfo[ XBOX_OUTPUT_PIPE_4 ].bmNakPower = USB_NAK_NOWAIT; // Only poll once for interrupt endpoints
239  epInfo[ XBOX_OUTPUT_PIPE_4 ].maxPktSize = EP_MAXPKTSIZE;
240  epInfo[ XBOX_OUTPUT_PIPE_4 ].bmSndToggle = 0;
241  epInfo[ XBOX_OUTPUT_PIPE_4 ].bmRcvToggle = 0;
242 
243  rcode = pUsb->setEpInfoEntry(bAddress, 9, epInfo);
244  if(rcode)
245  goto FailSetDevTblEntry;
246 
247  delay(200); //Give time for address change
248 
249  rcode = pUsb->setConf(bAddress, epInfo[ XBOX_CONTROL_PIPE ].epAddr, 1);
250  if(rcode)
251  goto FailSetConfDescr;
252 
253 #ifdef DEBUG_USB_HOST
254  Notify(PSTR("\r\nXbox Wireless Receiver Connected\r\n"), 0x80);
255 #endif
256  XboxReceiverConnected = true;
257  bPollEnable = true;
258  checkStatusTimer = 0; // Reset timer
259  return 0; // Successful configuration
260 
261  /* Diagnostic messages */
262 FailSetDevTblEntry:
263 #ifdef DEBUG_USB_HOST
264  NotifyFailSetDevTblEntry();
265  goto Fail;
266 #endif
267 
268 FailSetConfDescr:
269 #ifdef DEBUG_USB_HOST
270  NotifyFailSetConfDescr();
271 #endif
272 
273 Fail:
274 #ifdef DEBUG_USB_HOST
275  Notify(PSTR("\r\nXbox 360 Init Failed, error code: "), 0x80);
276  NotifyFail(rcode);
277 #endif
278  Release();
279  return rcode;
280 }
281 
282 /* Performs a cleanup after failed Init() attempt */
283 uint8_t XBOXRECV::Release() {
284  XboxReceiverConnected = false;
285  for(uint8_t i = 0; i < 4; i++)
286  Xbox360Connected[i] = 0x00;
287  pUsb->GetAddressPool().FreeAddress(bAddress);
288  bAddress = 0;
289  bPollEnable = false;
290  return 0;
291 }
292 
293 uint8_t XBOXRECV::Poll() {
294  if(!bPollEnable)
295  return 0;
296  if(!checkStatusTimer || ((int32_t)((uint32_t)millis() - checkStatusTimer) > 3000)) { // Run checkStatus every 3 seconds
297  checkStatusTimer = (uint32_t)millis();
298  checkStatus();
299  }
300 
301  uint8_t inputPipe;
302  uint16_t bufferSize;
303  for(uint8_t i = 0; i < 4; i++) {
304  if(i == 0)
305  inputPipe = XBOX_INPUT_PIPE_1;
306  else if(i == 1)
307  inputPipe = XBOX_INPUT_PIPE_2;
308  else if(i == 2)
309  inputPipe = XBOX_INPUT_PIPE_3;
310  else
311  inputPipe = XBOX_INPUT_PIPE_4;
312 
313  bufferSize = EP_MAXPKTSIZE; // This is the maximum number of bytes we want to receive
314  pUsb->inTransfer(bAddress, epInfo[ inputPipe ].epAddr, &bufferSize, readBuf);
315  if(bufferSize > 0) { // The number of received bytes
316 #ifdef EXTRADEBUG
317  Notify(PSTR("Bytes Received: "), 0x80);
318  D_PrintHex<uint16_t > (bufferSize, 0x80);
319  Notify(PSTR("\r\n"), 0x80);
320 #endif
321  readReport(i);
322 #ifdef PRINTREPORT
323  printReport(i, bufferSize); // Uncomment "#define PRINTREPORT" to print the report send by the Xbox 360 Controller
324 #endif
325  }
326  }
327  return 0;
328 }
329 
330 void XBOXRECV::readReport(uint8_t controller) {
331  if(readBuf == NULL)
332  return;
333  // This report is send when a controller is connected and disconnected
334  if(readBuf[0] == 0x08 && readBuf[1] != Xbox360Connected[controller]) {
335  Xbox360Connected[controller] = readBuf[1];
336 #ifdef DEBUG_USB_HOST
337  Notify(PSTR("Controller "), 0x80);
338  Notify(controller, 0x80);
339 #endif
340  if(Xbox360Connected[controller]) {
341 #ifdef DEBUG_USB_HOST
342  const char* str = 0;
343  switch(readBuf[1]) {
344  case 0x80: str = PSTR(" as controller\r\n");
345  break;
346  case 0x40: str = PSTR(" as headset\r\n");
347  break;
348  case 0xC0: str = PSTR(" as controller+headset\r\n");
349  break;
350  }
351  Notify(PSTR(": connected"), 0x80);
352  Notify(str, 0x80);
353 #endif
354  onInit(controller);
355  }
356 #ifdef DEBUG_USB_HOST
357  else
358  Notify(PSTR(": disconnected\r\n"), 0x80);
359 #endif
360  return;
361  }
362  // Controller status report
363  if(readBuf[1] == 0x00 && readBuf[3] & 0x13 && readBuf[4] >= 0x22) {
364  controllerStatus[controller] = ((uint16_t)readBuf[3] << 8) | readBuf[4];
365  return;
366  }
367  if(readBuf[1] != 0x01) // Check if it's the correct report - the receiver also sends different status reports
368  return;
369 
370  // A controller must be connected if it's sending data
371  if(!Xbox360Connected[controller])
372  Xbox360Connected[controller] |= 0x80;
373 
374  ButtonState[controller] = (uint32_t)(readBuf[9] | ((uint16_t)readBuf[8] << 8) | ((uint32_t)readBuf[7] << 16) | ((uint32_t)readBuf[6] << 24));
375 
376  hatValue[controller][LeftHatX] = (int16_t)(((uint16_t)readBuf[11] << 8) | readBuf[10]);
377  hatValue[controller][LeftHatY] = (int16_t)(((uint16_t)readBuf[13] << 8) | readBuf[12]);
378  hatValue[controller][RightHatX] = (int16_t)(((uint16_t)readBuf[15] << 8) | readBuf[14]);
379  hatValue[controller][RightHatY] = (int16_t)(((uint16_t)readBuf[17] << 8) | readBuf[16]);
380 
381  //Notify(PSTR("\r\nButtonState: "), 0x80);
382  //PrintHex<uint32_t>(ButtonState[controller], 0x80);
383 
384  if(ButtonState[controller] != OldButtonState[controller]) {
385  buttonStateChanged[controller] = true;
386  ButtonClickState[controller] = (ButtonState[controller] >> 16) & ((~OldButtonState[controller]) >> 16); // Update click state variable, but don't include the two trigger buttons L2 and R2
387  if(((uint8_t)OldButtonState[controller]) == 0 && ((uint8_t)ButtonState[controller]) != 0) // The L2 and R2 buttons are special as they are analog buttons
388  R2Clicked[controller] = true;
389  if((uint8_t)(OldButtonState[controller] >> 8) == 0 && (uint8_t)(ButtonState[controller] >> 8) != 0)
390  L2Clicked[controller] = true;
391  OldButtonState[controller] = ButtonState[controller];
392  }
393 }
394 
395 void XBOXRECV::printReport(uint8_t controller __attribute__((unused)), uint8_t nBytes __attribute__((unused))) { //Uncomment "#define PRINTREPORT" to print the report send by the Xbox 360 Controller
396 #ifdef PRINTREPORT
397  if(readBuf == NULL)
398  return;
399  Notify(PSTR("Controller "), 0x80);
400  Notify(controller, 0x80);
401  Notify(PSTR(": "), 0x80);
402  for(uint8_t i = 0; i < nBytes; i++) {
403  D_PrintHex<uint8_t > (readBuf[i], 0x80);
404  Notify(PSTR(" "), 0x80);
405  }
406  Notify(PSTR("\r\n"), 0x80);
407 #endif
408 }
409 
410 uint8_t XBOXRECV::getButtonPress(ButtonEnum b, uint8_t controller) {
411  if(b == L2) // These are analog buttons
412  return (uint8_t)(ButtonState[controller] >> 8);
413  else if(b == R2)
414  return (uint8_t)ButtonState[controller];
415  return (bool)(ButtonState[controller] & ((uint32_t)pgm_read_word(&XBOX_BUTTONS[(uint8_t)b]) << 16));
416 }
417 
418 bool XBOXRECV::getButtonClick(ButtonEnum b, uint8_t controller) {
419  if(b == L2) {
420  if(L2Clicked[controller]) {
421  L2Clicked[controller] = false;
422  return true;
423  }
424  return false;
425  } else if(b == R2) {
426  if(R2Clicked[controller]) {
427  R2Clicked[controller] = false;
428  return true;
429  }
430  return false;
431  }
432  uint16_t button = pgm_read_word(&XBOX_BUTTONS[(uint8_t)b]);
433  bool click = (ButtonClickState[controller] & button);
434  ButtonClickState[controller] &= ~button; // clear "click" event
435  return click;
436 }
437 
438 int16_t XBOXRECV::getAnalogHat(AnalogHatEnum a, uint8_t controller) {
439  return hatValue[controller][a];
440 }
441 
442 bool XBOXRECV::buttonChanged(uint8_t controller) {
443  bool state = buttonStateChanged[controller];
444  buttonStateChanged[controller] = false;
445  return state;
446 }
447 
448 /*
449 ControllerStatus Breakdown
450 ControllerStatus[controller] & 0x0001 // 0
451 ControllerStatus[controller] & 0x0002 // normal batteries, no rechargeable battery pack
452 ControllerStatus[controller] & 0x0004 // controller starting up / settling
453 ControllerStatus[controller] & 0x0008 // headset adapter plugged in, but no headphones connected (mute?)
454 ControllerStatus[controller] & 0x0010 // 0
455 ControllerStatus[controller] & 0x0020 // 1
456 ControllerStatus[controller] & 0x0040 // battery level (high bit)
457 ControllerStatus[controller] & 0x0080 // battery level (low bit)
458 ControllerStatus[controller] & 0x0100 // 1
459 ControllerStatus[controller] & 0x0200 // 1
460 ControllerStatus[controller] & 0x0400 // headset adapter plugged in
461 ControllerStatus[controller] & 0x0800 // 0
462 ControllerStatus[controller] & 0x1000 // 1
463 ControllerStatus[controller] & 0x2000 // 0
464 ControllerStatus[controller] & 0x4000 // 0
465 ControllerStatus[controller] & 0x8000 // 0
466  */
467 uint8_t XBOXRECV::getBatteryLevel(uint8_t controller) {
468  return ((controllerStatus[controller] & 0x00C0) >> 6);
469 }
470 
471 void XBOXRECV::XboxCommand(uint8_t controller, uint8_t* data, uint16_t nbytes) {
472 #ifdef EXTRADEBUG
473  uint8_t rcode;
474 #endif
475  uint8_t outputPipe;
476  switch(controller) {
477  case 0: outputPipe = XBOX_OUTPUT_PIPE_1;
478  break;
479  case 1: outputPipe = XBOX_OUTPUT_PIPE_2;
480  break;
481  case 2: outputPipe = XBOX_OUTPUT_PIPE_3;
482  break;
483  case 3: outputPipe = XBOX_OUTPUT_PIPE_4;
484  break;
485  default:
486  return;
487  }
488 #ifdef EXTRADEBUG
489  rcode =
490 #endif
491  pUsb->outTransfer(bAddress, epInfo[ outputPipe ].epAddr, nbytes, data);
492 #ifdef EXTRADEBUG
493  if(rcode)
494  Notify(PSTR("Error sending Xbox message\r\n"), 0x80);
495 #endif
496 }
497 
498 void XBOXRECV::disconnect(uint8_t controller) {
499  writeBuf[0] = 0x00;
500  writeBuf[1] = 0x00;
501  writeBuf[2] = 0x08;
502  writeBuf[3] = 0xC0;
503 
504  XboxCommand(controller, writeBuf, 4);
505 }
506 
507 void XBOXRECV::setLedRaw(uint8_t value, uint8_t controller) {
508  writeBuf[0] = 0x00;
509  writeBuf[1] = 0x00;
510  writeBuf[2] = 0x08;
511  writeBuf[3] = value | 0x40;
512 
513  XboxCommand(controller, writeBuf, 4);
514 }
515 
516 void XBOXRECV::setLedOn(LEDEnum led, uint8_t controller) {
517  if(led == OFF)
518  setLedRaw(0, controller);
519  else if(led != ALL) // All LEDs can't be on a the same time
520  setLedRaw(pgm_read_byte(&XBOX_LEDS[(uint8_t)led]) + 4, controller);
521 }
522 
523 void XBOXRECV::setLedBlink(LEDEnum led, uint8_t controller) {
524  setLedRaw(pgm_read_byte(&XBOX_LEDS[(uint8_t)led]), controller);
525 }
526 
527 void XBOXRECV::setLedMode(LEDModeEnum ledMode, uint8_t controller) { // This function is used to do some speciel LED stuff the controller supports
528  setLedRaw((uint8_t)ledMode, controller);
529 }
530 
531 /* PC runs this at interval of approx 2 seconds
532 Thanks to BusHound from Perisoft.net for the Windows USB Analysis output
533 Found by timstamp.co.uk
534  */
535 void XBOXRECV::checkStatus() {
536  if(!bPollEnable)
537  return;
538  // Get controller info
539  writeBuf[0] = 0x08;
540  writeBuf[1] = 0x00;
541  writeBuf[2] = 0x0f;
542  writeBuf[3] = 0xc0;
543  for(uint8_t i = 0; i < 4; i++) {
544  XboxCommand(i, writeBuf, 4);
545  }
546  // Get battery status
547  writeBuf[0] = 0x00;
548  writeBuf[1] = 0x00;
549  writeBuf[2] = 0x00;
550  writeBuf[3] = 0x40;
551  for(uint8_t i = 0; i < 4; i++) {
552  if(Xbox360Connected[i])
553  XboxCommand(i, writeBuf, 4);
554  }
555 }
556 
557 void XBOXRECV::setRumbleOn(uint8_t lValue, uint8_t rValue, uint8_t controller) {
558  writeBuf[0] = 0x00;
559  writeBuf[1] = 0x01;
560  writeBuf[2] = 0x0f;
561  writeBuf[3] = 0xc0;
562  writeBuf[4] = 0x00;
563  writeBuf[5] = lValue; // big weight
564  writeBuf[6] = rValue; // small weight
565 
566  XboxCommand(controller, writeBuf, 7);
567 }
568 
569 void XBOXRECV::onInit(uint8_t controller) {
570  if(pFuncOnInit)
571  pFuncOnInit(); // Call the user function
572  else {
573  LEDEnum led;
574  if(controller == 0)
575  led = static_cast<LEDEnum>(LED1);
576  else if(controller == 1)
577  led = static_cast<LEDEnum>(LED2);
578  else if(controller == 2)
579  led = static_cast<LEDEnum>(LED3);
580  else
581  led = static_cast<LEDEnum>(LED4);
582  setLedOn(led, controller);
583  }
584 }
EpInfo::bmRcvToggle
uint8_t bmRcvToggle
Definition: address.h:48
XBOX_WIRELESS_RECEIVER_THIRD_PARTY_PID
#define XBOX_WIRELESS_RECEIVER_THIRD_PARTY_PID
Definition: XBOXRECV.h:46
- +
LEDModeEnum
LEDModeEnum
Definition: xboxEnums.h:24
UsbDevice::epinfo
EpInfo * epinfo
Definition: address.h:83
UsbDevice::lowspeed
bool lowspeed
Definition: address.h:86
@@ -85,7 +85,7 @@ $(function() {
NotifyFail
#define NotifyFail(...)
Definition: message.h:62
XBOXRECV::Xbox360Connected
uint8_t Xbox360Connected[4]
Definition: XBOXRECV.h:231
XBOXRECV::setLedMode
void setLedMode(LEDModeEnum lm, uint8_t controller=0)
Definition: XBOXRECV.cpp:527
-
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:163
+
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:170
USB::setConf
uint8_t setConf(uint8_t addr, uint8_t ep, uint8_t conf_value)
Definition: Usb.cpp:840
XBOXRECV::buttonChanged
bool buttonChanged(uint8_t controller=0)
Definition: XBOXRECV.cpp:442
XBOX_OUTPUT_PIPE_3
#define XBOX_OUTPUT_PIPE_3
Definition: XBOXRECV.h:36
@@ -109,7 +109,7 @@ $(function() {
USB_NAK_MAX_POWER
#define USB_NAK_MAX_POWER
Definition: address.h:34
XBOX_VID
#define XBOX_VID
Definition: XBOXOLD.h:34
- +
XBOXRECV::Release
uint8_t Release()
Definition: XBOXRECV.cpp:283
EpInfo
Definition: address.h:39
XBOXRECV::getButtonClick
bool getButtonClick(ButtonEnum b, uint8_t controller=0)
Definition: XBOXRECV.cpp:418
@@ -150,8 +150,8 @@ $(function() {
XBOX_INPUT_PIPE_3
#define XBOX_INPUT_PIPE_3
Definition: XBOXRECV.h:35
XBOX_CONTROL_PIPE
#define XBOX_CONTROL_PIPE
Definition: XBOXOLD.h:29
- - + +
XBOX_INPUT_PIPE_4
#define XBOX_INPUT_PIPE_4
Definition: XBOXRECV.h:37
XBOX_BUTTONS
const uint16_t XBOX_BUTTONS[]
Definition: xboxEnums.h:41
diff --git a/_x_b_o_x_r_e_c_v_8h_source.html b/_x_b_o_x_r_e_c_v_8h_source.html index 1f4abffe..7bae4dec 100644 --- a/_x_b_o_x_r_e_c_v_8h_source.html +++ b/_x_b_o_x_r_e_c_v_8h_source.html @@ -76,7 +76,7 @@ $(function() {
XBOXRECV::GetAddress
virtual uint8_t GetAddress()
Definition: XBOXRECV.h:95
XBOXRECV::Xbox360Connected
uint8_t Xbox360Connected[4]
Definition: XBOXRECV.h:231
XBOXRECV::setLedMode
void setLedMode(LEDModeEnum lm, uint8_t controller=0)
Definition: XBOXRECV.cpp:527
-
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:163
+
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:170
XBOXRECV::buttonChanged
bool buttonChanged(uint8_t controller=0)
Definition: XBOXRECV.cpp:442
XBOXRECV::setRumbleOff
void setRumbleOff(uint8_t controller=0)
Definition: XBOXRECV.h:162
XBOXRECV::ConfigureDevice
uint8_t ConfigureDevice(uint8_t parent, uint8_t port, bool lowspeed)
Definition: XBOXRECV.cpp:41
diff --git a/_x_b_o_x_u_s_b_8cpp_source.html b/_x_b_o_x_u_s_b_8cpp_source.html index 848b025e..8e234a3e 100644 --- a/_x_b_o_x_u_s_b_8cpp_source.html +++ b/_x_b_o_x_u_s_b_8cpp_source.html @@ -67,7 +67,7 @@ $(function() {
EpInfo::bmRcvToggle
uint8_t bmRcvToggle
Definition: address.h:48
XBOX_WIRELESS_RECEIVER_THIRD_PARTY_PID
#define XBOX_WIRELESS_RECEIVER_THIRD_PARTY_PID
Definition: XBOXRECV.h:46
- +
LEDModeEnum
LEDModeEnum
Definition: xboxEnums.h:24
UsbDevice::epinfo
EpInfo * epinfo
Definition: address.h:83
UsbDevice::lowspeed
bool lowspeed
Definition: address.h:86
@@ -80,7 +80,7 @@ $(function() {
pgm_read_word
#define pgm_read_word(addr)
Definition: version_helper.h:164
JOYTECH_WIRED_PID
#define JOYTECH_WIRED_PID
Definition: XBOXUSB.h:44
NotifyFail
#define NotifyFail(...)
Definition: message.h:62
-
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:163
+
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:170
XBOXUSB::pUsb
USB * pUsb
Definition: XBOXUSB.h:189
XBOX_REPORT_BUFFER_SIZE
#define XBOX_REPORT_BUFFER_SIZE
Definition: XBOXUSB.h:48
USB::setConf
uint8_t setConf(uint8_t addr, uint8_t ep, uint8_t conf_value)
Definition: Usb.cpp:840
@@ -106,7 +106,7 @@ $(function() {
USB_NAK_MAX_POWER
#define USB_NAK_MAX_POWER
Definition: address.h:34
XBOX_VID
#define XBOX_VID
Definition: XBOXOLD.h:34
XBOX_INPUT_PIPE
#define XBOX_INPUT_PIPE
Definition: XBOXOLD.h:30
- +
XBOXUSB::bAddress
uint8_t bAddress
Definition: XBOXUSB.h:191
XBOXUSB::getButtonPress
uint8_t getButtonPress(ButtonEnum b)
Definition: XBOXUSB.cpp:283
EpInfo
Definition: address.h:39
@@ -142,8 +142,8 @@ $(function() {
USB::GetAddressPool
AddressPool & GetAddressPool()
Definition: UsbCore.h:226
USB
Definition: UsbCore.h:210
XBOX_CONTROL_PIPE
#define XBOX_CONTROL_PIPE
Definition: XBOXOLD.h:29
- - + +
XBOXUSB::Release
uint8_t Release()
Definition: XBOXUSB.cpp:224
HID_REQUEST_SET_REPORT
#define HID_REQUEST_SET_REPORT
Definition: usbhid.h:72
diff --git a/_x_b_o_x_u_s_b_8h_source.html b/_x_b_o_x_u_s_b_8h_source.html index e90738b3..cc0b2be5 100644 --- a/_x_b_o_x_u_s_b_8h_source.html +++ b/_x_b_o_x_u_s_b_8h_source.html @@ -72,7 +72,7 @@ $(function() {
XBOXUSB::VIDPIDOK
virtual bool VIDPIDOK(uint16_t vid, uint16_t pid)
Definition: XBOXUSB.h:103
JOYTECH_WIRED_PID
#define JOYTECH_WIRED_PID
Definition: XBOXUSB.h:44
-
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:163
+
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:170
XBOXUSB::pUsb
USB * pUsb
Definition: XBOXUSB.h:189
XBOXUSB::setLedOff
void setLedOff()
Definition: XBOXUSB.h:156
XBOXUSB::Init
uint8_t Init(uint8_t parent, uint8_t port, bool lowspeed)
Definition: XBOXUSB.cpp:39
diff --git a/annotated.html b/annotated.html index 2e403adb..1c08fa43 100644 --- a/annotated.html +++ b/annotated.html @@ -126,46 +126,55 @@ $(function() {  CPS4Parser  CPS4Status  CPS4USB - CPSBuzz - CPSBUZZButtons - CPTPListParser - CReportDescParser - CReportDescParser2 - CReportDescParserBase - CRequestSenseResponce - CSETUP_PKT - CSinkParser - CSPi - CSPP - CTEL_RINGER_FUNC_DESCR - CtouchpadXY - Ctty_features - CUHS2_GPIO - CUniversalReportParser - CUSB - CUSB_CONFIGURATION_DESCRIPTOR - CUSB_DEVICE_DESCRIPTOR - CUSB_ENDPOINT_DESCRIPTOR - CUSB_HID_DESCRIPTOR - CUSB_INTERFACE_DESCRIPTOR - CUsbConfigXtracter - CUsbDevice - CUsbDeviceAddress - CUSBDeviceConfig - CUSBH_MIDI - CUSBHID - CUSBHub - CUSBReadParser - CWII - CXBOXOLD - CXBOXONE - CXBOXONESBT - CXboxOneSButtons - CXboxOneSData - CXBOXONESParser - CXBOXRECV - CXBOXUSB - CXR21B1411 + CPS5BT + CPS5Buttons + CPS5Data + CPS5Output + CPS5Parser + CPS5Status + Cps5TouchpadXY + CPS5Trigger + CPS5USB + CPSBuzz + CPSBUZZButtons + CPTPListParser + CReportDescParser + CReportDescParser2 + CReportDescParserBase + CRequestSenseResponce + CSETUP_PKT + CSinkParser + CSPi + CSPP + CTEL_RINGER_FUNC_DESCR + CtouchpadXY + Ctty_features + CUHS2_GPIO + CUniversalReportParser + CUSB + CUSB_CONFIGURATION_DESCRIPTOR + CUSB_DEVICE_DESCRIPTOR + CUSB_ENDPOINT_DESCRIPTOR + CUSB_HID_DESCRIPTOR + CUSB_INTERFACE_DESCRIPTOR + CUsbConfigXtracter + CUsbDevice + CUsbDeviceAddress + CUSBDeviceConfig + CUSBH_MIDI + CUSBHID + CUSBHub + CUSBReadParser + CWII + CXBOXOLD + CXBOXONE + CXBOXONESBT + CXboxOneSButtons + CXboxOneSData + CXBOXONESParser + CXBOXRECV + CXBOXUSB + CXR21B1411
diff --git a/class_b_t_h_i_d.html b/class_b_t_h_i_d.html index e121eb48..a797a011 100644 --- a/class_b_t_h_i_d.html +++ b/class_b_t_h_i_d.html @@ -76,8 +76,9 @@ Inheritance diagram for BTHID:
Inheritance graph
- - + + +
[legend]
@@ -424,7 +425,7 @@ BluetoothService implementation -

Definition at line 618 of file BTHID.cpp.

+

Definition at line 628 of file BTHID.cpp.

@@ -519,7 +520,7 @@ BluetoothService implementation

Implements BluetoothService.

-

Definition at line 548 of file BTHID.cpp.

+

Definition at line 558 of file BTHID.cpp.

@@ -624,7 +625,7 @@ BluetoothService implementation -

Reimplemented in PS4BT, and XBOXONESBT.

+

Reimplemented in PS5BT, PS4BT, and XBOXONESBT.

Definition at line 125 of file BTHID.h.

@@ -693,7 +694,7 @@ BluetoothService implementation

Called when a device is connected

-

Reimplemented in PS4BT, and XBOXONESBT.

+

Reimplemented in PS5BT, PS4BT, and XBOXONESBT.

Definition at line 136 of file BTHID.h.

@@ -723,7 +724,7 @@ BluetoothService implementation

Used to reset any buffers in the class that inherits this

-

Reimplemented in PS4BT, and XBOXONESBT.

+

Reimplemented in PS5BT, PS4BT, and XBOXONESBT.

Definition at line 140 of file BTHID.h.

diff --git a/class_b_t_h_i_d__coll__graph.md5 b/class_b_t_h_i_d__coll__graph.md5 index 2121b658..475f1fad 100644 --- a/class_b_t_h_i_d__coll__graph.md5 +++ b/class_b_t_h_i_d__coll__graph.md5 @@ -1 +1 @@ -3b8278cef06a7b1a6670fd63f49235a9 \ No newline at end of file +0dcdeceb9387731aac17c1e2f7f1d503 \ No newline at end of file diff --git a/class_b_t_h_i_d__inherit__graph.map b/class_b_t_h_i_d__inherit__graph.map index 31e785f3..f292d8a1 100644 --- a/class_b_t_h_i_d__inherit__graph.map +++ b/class_b_t_h_i_d__inherit__graph.map @@ -1,5 +1,6 @@ - - + + + diff --git a/class_b_t_h_i_d__inherit__graph.md5 b/class_b_t_h_i_d__inherit__graph.md5 index 01278e42..0842c1ce 100644 --- a/class_b_t_h_i_d__inherit__graph.md5 +++ b/class_b_t_h_i_d__inherit__graph.md5 @@ -1 +1 @@ -eee85effef418f7404da53bc61be5232 \ No newline at end of file +7c5c383d684ddc1c68899fd7e2fecd45 \ No newline at end of file diff --git a/class_b_t_h_i_d__inherit__graph.png b/class_b_t_h_i_d__inherit__graph.png index 9f3c31d59a1a3194c419b581e49381f9baf991b2..b3e7c36c533fbf2e59dc7dbacd0b021fb2e4ea30 100644 GIT binary patch literal 8167 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 ABLDyZ literal 6556 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
Inheritance graph
- - - - + + + + - + +
[legend]
diff --git a/class_bluetooth_service__coll__graph.md5 b/class_bluetooth_service__coll__graph.md5 index b708cfc1..d681de2d 100644 --- a/class_bluetooth_service__coll__graph.md5 +++ b/class_bluetooth_service__coll__graph.md5 @@ -1 +1 @@ -070e1cbbcad92a5495383b260ea40bb9 \ No newline at end of file +1458829d23999de6738942751cd378d6 \ No newline at end of file diff --git a/class_bluetooth_service__inherit__graph.map b/class_bluetooth_service__inherit__graph.map index af5dc499..5bf55b01 100644 --- a/class_bluetooth_service__inherit__graph.map +++ b/class_bluetooth_service__inherit__graph.map @@ -1,8 +1,9 @@ - - - - + + + + - + + diff --git a/class_bluetooth_service__inherit__graph.md5 b/class_bluetooth_service__inherit__graph.md5 index 75c38a7a..29361cd2 100644 --- a/class_bluetooth_service__inherit__graph.md5 +++ b/class_bluetooth_service__inherit__graph.md5 @@ -1 +1 @@ -da327df8fa48213df2fe2fc9ea014911 \ No newline at end of file +9ca9f3b6eda18c247fba2e07d0b24c2a \ No newline at end of file diff --git a/class_bluetooth_service__inherit__graph.png b/class_bluetooth_service__inherit__graph.png index f7e60f6f95d604b27025fb4455c108133871a48a..cb0dc804f6c414795b68417c1c4f76ad5793244e 100644 GIT binary patch literal 12702 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 literal 11182 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 diff --git a/class_h_i_d_composite.html b/class_h_i_d_composite.html index 8221c97e..25522091 100644 --- a/class_h_i_d_composite.html +++ b/class_h_i_d_composite.html @@ -81,8 +81,9 @@ Inheritance diagram for HIDComposite:
- - + + +
[legend]
@@ -462,7 +463,7 @@ Static Protected Attributes
-

Reimplemented in PSBuzz, and PS4USB.

+

Reimplemented in PSBuzz, PS5USB, and PS4USB.

Definition at line 76 of file hidcomposite.h.

diff --git a/class_h_i_d_composite__coll__graph.md5 b/class_h_i_d_composite__coll__graph.md5 index e821c52e..a1856a0f 100644 --- a/class_h_i_d_composite__coll__graph.md5 +++ b/class_h_i_d_composite__coll__graph.md5 @@ -1 +1 @@ -3f9346dcd1abe9337a6e311a46ba14f4 \ No newline at end of file +bba65447c66e197356858048d3a33867 \ No newline at end of file diff --git a/class_h_i_d_composite__inherit__graph.map b/class_h_i_d_composite__inherit__graph.map index 4959edcc..0896727c 100644 --- a/class_h_i_d_composite__inherit__graph.map +++ b/class_h_i_d_composite__inherit__graph.map @@ -3,6 +3,7 @@ - - + + + diff --git a/class_h_i_d_composite__inherit__graph.md5 b/class_h_i_d_composite__inherit__graph.md5 index 995c3b05..e325aad5 100644 --- a/class_h_i_d_composite__inherit__graph.md5 +++ b/class_h_i_d_composite__inherit__graph.md5 @@ -1 +1 @@ -55a554165c31a4332eebfdfa1938f9a4 \ No newline at end of file +121deb64a898bf7777edfbd49227f25d \ No newline at end of file diff --git a/class_h_i_d_composite__inherit__graph.png b/class_h_i_d_composite__inherit__graph.png index a67d180a373a53e91d76ec2b1a8c8ad660d465b3..b324eb4bece4ea73b5ed9b0b700247298b3b5e39 100644 GIT binary patch literal 13591 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

1c%(vgT?6R3WtW| zRVbL4nEtX$kS!I*#>W1osU?hJzZMt4#^O<#fnK;u`R`?A%qW35g@rSo*5&`MvlyiF zX~X)<(2)>>;^5>Apf;ZgAZP!h7fQbQP06g#VaK+xlBq1xS?ZYVf ztzHwHQ6fkAKa?JPvH!^NQE^BCopS+gf!F7|ON)yD^8G3QtI8c=IX5kWN(ej&0Gr%D z+Kdy!FOp>?&@%bm0fl1)0?io^N)F!xq5gDOYV?n7;|B_H*^F* zKT*cof{|Yn`S%Ue6g>=HB{V7i|F)@P;9uc0;6Cw~k`=7q$=Akg!G7du;kqi81 P0R$NdMezzTqk#VfWu;?j diff --git a/class_h_i_d_universal.html b/class_h_i_d_universal.html index 43e2c78a..21105a21 100644 --- a/class_h_i_d_universal.html +++ b/class_h_i_d_universal.html @@ -74,8 +74,9 @@ Inheritance diagram for HIDUniversal:

Inheritance graph
- - + + + @@ -308,7 +309,7 @@ Additional Inherited Members
-

Reimplemented in PSBuzz, and PS4USB.

+

Reimplemented in PSBuzz, PS5USB, and PS4USB.

Definition at line 40 of file hiduniversal.h.

diff --git a/class_h_i_d_universal__coll__graph.md5 b/class_h_i_d_universal__coll__graph.md5 index a5ed026f..a9b09f79 100644 --- a/class_h_i_d_universal__coll__graph.md5 +++ b/class_h_i_d_universal__coll__graph.md5 @@ -1 +1 @@ -ecd3f12eeb58ce1f19000e71f580891e \ No newline at end of file +1bf60b9ec91960e1a472f3a6a127cdfa \ No newline at end of file diff --git a/class_h_i_d_universal__inherit__graph.map b/class_h_i_d_universal__inherit__graph.map index 3c2dd8ab..655565f3 100644 --- a/class_h_i_d_universal__inherit__graph.map +++ b/class_h_i_d_universal__inherit__graph.map @@ -1,6 +1,7 @@ - - + + + diff --git a/class_h_i_d_universal__inherit__graph.md5 b/class_h_i_d_universal__inherit__graph.md5 index 54f50712..10234994 100644 --- a/class_h_i_d_universal__inherit__graph.md5 +++ b/class_h_i_d_universal__inherit__graph.md5 @@ -1 +1 @@ -14906f1d880ac0d2789e2bbb92aecbdb \ No newline at end of file +c3328294c7d15e9e9cfb7501c6db37af \ No newline at end of file diff --git a/class_h_i_d_universal__inherit__graph.png b/class_h_i_d_universal__inherit__graph.png index 7b7a7b229e76e2ed18aa9eec891a475cadd77323..39549e49f9e1c352341b83e6d64e0a8e2beff86d 100644 GIT binary patch literal 13573 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 Ta38+cg!D*OMW$5hx&QwH>#&mW literal 12365 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 + + + + + + +USB Host Shield 2.0: Member List + + + + + + + + + + +
+
+ + + + + + +
+
USB Host Shield 2.0 +
+
+
+ + + + + + + + +
+
+ + +
+ +
+ +
+
+
+
PS5BT Member List
+
+
+ +

This is the complete list of members for PS5BT, including all inherited members.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ACLData(uint8_t *ACLData)BTHIDprotectedvirtual
attachOnInit(void(*funcOnInit)(void))BluetoothServiceinline
BluetoothService(BTD *p)BluetoothServiceinline
BTHID(BTD *p, bool pair=false, const char *pin="0000")BTHID
checkHciHandle(uint8_t *buf, uint16_t handle)BluetoothServiceinlineprotected
connected()PS5BTinline
BTHID::connectedBTHID
control_scidBTHIDprotected
disconnect()BTHIDvirtual
getAnalogButton(ButtonEnum b)PS5Parser
getAnalogHat(AnalogHatEnum a)PS5Parser
getAngle(AngleEnum a)PS5Parserinline
getButtonClick(ButtonEnum b)PS5Parser
getButtonPress(ButtonEnum b)PS5Parser
getMessageCounter()PS5Parserinline
GetReportParser(uint8_t id)BTHIDinline
getSensor(SensorEnum s)PS5Parserinline
getTouchCounter(uint8_t finger=00)PS5Parserinline
getX(uint8_t finger=0)PS5Parserinline
getY(uint8_t finger=0)PS5Parserinline
hci_handleBluetoothServiceprotected
identifierBluetoothServiceprotected
interrupt_scidBTHIDprotected
isTouching(uint8_t finger=0)PS5Parserinline
l2cap_event_flagBluetoothServiceprotected
l2cap_sdp_stateBTHIDprotected
leftTriggerPS5Parser
onInit()BTHIDinlineprotectedvirtual
OnInitBTHID()PS5BTinlineprotectedvirtual
pair(void)BTHIDinline
Parse(uint8_t len, uint8_t *buf)PS5Parserprotected
ParseBTHIDControlData(uint8_t len, uint8_t *buf)BTHIDinlineprotectedvirtual
ParseBTHIDData(uint8_t len, uint8_t *buf)PS5BTinlineprotectedvirtual
pBtdBluetoothServiceprotected
pFuncOnInitBluetoothServiceprotected
PS5BT(BTD *p, bool pair=false, const char *pin="0000")PS5BTinline
PS5Parser()PS5Parserinline
BTHID::Reset()BTHIDprotectedvirtual
PS5Parser::Reset()PS5Parserprotected
ResetBTHID()PS5BTinlineprotectedvirtual
rightTriggerPS5Parser
Run()BTHIDprotectedvirtual
sdp_scidBTHIDprotected
sendOutputReport(PS5Output *output)PS5BTinlineprotectedvirtual
setAllOff()PS5Parserinline
setLed(uint8_t r, uint8_t g, uint8_t b)PS5Parserinline
setLed(ColorsEnum color)PS5Parserinline
setLedOff()PS5Parserinline
setLeds(struct KBDLEDS data)BTHIDinline
setLeds(uint8_t data)BTHID
setMicLed(bool on)PS5Parserinline
setMicLedOff()PS5Parserinline
setPlayerLed(uint8_t mask)PS5Parserinline
setPlayerLedOff()PS5Parserinline
setProtocolMode(uint8_t mode)BTHIDinline
SetReportParser(uint8_t id, HIDReportParser *prs)BTHIDinline
setRumbleOff()PS5Parserinline
setRumbleOn(RumbleEnum mode)PS5Parserinline
setRumbleOn(uint8_t bigRumble, uint8_t smallRumble)PS5Parserinline
+ +
+Generated by   +doxygen + 1.8.13 +
+ + diff --git a/class_p_s5_b_t.html b/class_p_s5_b_t.html new file mode 100644 index 00000000..46c4366e --- /dev/null +++ b/class_p_s5_b_t.html @@ -0,0 +1,478 @@ + + + + + + + +USB Host Shield 2.0: PS5BT Class Reference + + + + + + + + + + +
+
+ + + + + + +
+
USB Host Shield 2.0 +
+
+
+ + + + + + + + +
+
+ + +
+ +
+ +
+
+
+Public Member Functions | +List of all members
+
+
PS5BT Class Reference
+
+
+ +

#include <PS5BT.h>

+
+Inheritance diagram for PS5BT:
+
+
Inheritance graph
+ + + + + +
[legend]
+
+Collaboration diagram for PS5BT:
+
+
Collaboration graph
+ + + + + + + + + + + + +
[legend]
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+Public Member Functions

 PS5BT (BTD *p, bool pair=false, const char *pin="0000")
 
bool connected ()
 
- Public Member Functions inherited from BTHID
 BTHID (BTD *p, bool pair=false, const char *pin="0000")
 
HIDReportParser * GetReportParser (uint8_t id)
 
bool SetReportParser (uint8_t id, HIDReportParser *prs)
 
void setProtocolMode (uint8_t mode)
 
void pair (void)
 
void setLeds (struct KBDLEDS data)
 
void setLeds (uint8_t data)
 
void disconnect ()
 
- Public Member Functions inherited from BluetoothService
 BluetoothService (BTD *p)
 
void attachOnInit (void(*funcOnInit)(void))
 
- Public Member Functions inherited from PS5Parser
 PS5Parser ()
 
bool getButtonPress (ButtonEnum b)
 
bool getButtonClick (ButtonEnum b)
 
uint8_t getAnalogButton (ButtonEnum b)
 
uint8_t getAnalogHat (AnalogHatEnum a)
 
uint16_t getX (uint8_t finger=0)
 
uint16_t getY (uint8_t finger=0)
 
bool isTouching (uint8_t finger=0)
 
uint8_t getTouchCounter (uint8_t finger=00)
 
float getAngle (AngleEnum a)
 
int16_t getSensor (SensorEnum s)
 
void setAllOff ()
 
void setRumbleOff ()
 
void setRumbleOn (RumbleEnum mode)
 
void setRumbleOn (uint8_t bigRumble, uint8_t smallRumble)
 
void setLedOff ()
 
void setLed (uint8_t r, uint8_t g, uint8_t b)
 
void setLed (ColorsEnum color)
 
void setPlayerLedOff ()
 
void setPlayerLed (uint8_t mask)
 
void setMicLedOff ()
 
void setMicLed (bool on)
 
uint16_t getMessageCounter ()
 
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+Protected Member Functions

BTHID implementation
virtual void ParseBTHIDData (uint8_t len, uint8_t *buf)
 
virtual void OnInitBTHID ()
 
virtual void ResetBTHID ()
 
PS5Parser implementation
virtual void sendOutputReport (PS5Output *output)
 
- Protected Member Functions inherited from BTHID
virtual void ParseBTHIDControlData (uint8_t len, uint8_t *buf)
 
void ACLData (uint8_t *ACLData)
 
void Run ()
 
void Reset ()
 
void onInit ()
 
- Protected Member Functions inherited from BluetoothService
bool checkHciHandle (uint8_t *buf, uint16_t handle)
 
- Protected Member Functions inherited from PS5Parser
void Parse (uint8_t len, uint8_t *buf)
 
void Reset ()
 
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+Additional Inherited Members

- Public Attributes inherited from BTHID
bool connected
 
- Public Attributes inherited from PS5Parser
PS5Trigger leftTrigger
 
PS5Trigger rightTrigger
 
- Protected Attributes inherited from BTHID
uint8_t control_scid [2]
 
uint8_t interrupt_scid [2]
 
uint8_t l2cap_sdp_state
 
uint8_t sdp_scid [2]
 
- Protected Attributes inherited from BluetoothService
void(* pFuncOnInit )(void)
 
BTD * pBtd
 
uint16_t hci_handle
 
uint32_t l2cap_event_flag
 
uint8_t identifier
 
+

Detailed Description

+

This class implements support for the PS5 controller via Bluetooth. It uses the BTHID class for all the Bluetooth communication.

+ +

Definition at line 109 of file PS5BT.h.

+

Constructor & Destructor Documentation

+ +

◆ PS5BT()

+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + +
PS5BT::PS5BT (BTD * p,
bool pair = false,
const char * pin = "0000" 
)
+ 		+inline
+
+

Constructor for the PS5BT class.

Parameters
+ + + + +
pPointer to the BTD class instance.
pairSet this to true in order to pair with the device. If the argument is omitted then it will not pair with it. One can use PAIR to set it to true.
pinWrite the pin to BTD::btdPin. If argument is omitted, then "0000" will be used.
+
+
+ +

Definition at line 117 of file PS5BT.h.

+ +
+
+

Member Function Documentation

+ +

◆ connected()

+ +
+
+ + + + + +
+ + + + + + + +
bool PS5BT::connected ()
+ 		+inline
+
+

Used to check if a PS5 controller is connected.

Returns
Returns true if it is connected.
+ +

Definition at line 126 of file PS5BT.h.

+ +
+
+ +

◆ ParseBTHIDData()

+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + +
virtual void PS5BT::ParseBTHIDData (uint8_t len,
uint8_t * buf 
)
+ 		+inlineprotectedvirtual
+
+

Used to parse Bluetooth HID data.

Parameters
+ + + +
lenThe length of the incoming data.
bufPointer to the data buffer.
+
+
+ +

Reimplemented from BTHID.

+ +

Definition at line 137 of file PS5BT.h.

+ +
+
+ +

◆ OnInitBTHID()

+ +
+
+ + + + + +
+ + + + + + + +
virtual void PS5BT::OnInitBTHID ()
+ 		+inlineprotectedvirtual
+
+

Called when a device is successfully initialized. Use attachOnInit(void (*funcOnInit)(void)) to call your own function. This is useful for instance if you want to set the LEDs in a specific way.

+ +

Reimplemented from BTHID.

+ +

Definition at line 146 of file PS5BT.h.

+ +
+
+ +

◆ ResetBTHID()

+ +
+
+ + + + + +
+ + + + + + + +
virtual void PS5BT::ResetBTHID ()
+ 		+inlineprotectedvirtual
+
+

Used to reset the different buffers to there default values

+ +

Reimplemented from BTHID.

+ +

Definition at line 156 of file PS5BT.h.

+ +
+
+ +

◆ sendOutputReport()

+ +
+
+ + + + + +
+ + + + + + + + +
virtual void PS5BT::sendOutputReport (PS5Output * output)
+ 		+inlineprotectedvirtual
+
+

Send the output to the PS5 controller. This is implemented in PS5BT.h and PS5USB.h.

Parameters
+ + +
outputPointer to PS5Output buffer;
+
+
+ +

Implements PS5Parser.

+ +

Definition at line 162 of file PS5BT.h.

+ +
+
+
The documentation for this class was generated from the following file: +
+ +
+Generated by   +doxygen + 1.8.13 +
+ + diff --git a/class_p_s5_b_t__coll__graph.map b/class_p_s5_b_t__coll__graph.map new file mode 100644 index 00000000..7add036b --- /dev/null +++ b/class_p_s5_b_t__coll__graph.map @@ -0,0 +1,12 @@ + + + + + + + + + + + + diff --git a/class_p_s5_b_t__coll__graph.md5 b/class_p_s5_b_t__coll__graph.md5 new file mode 100644 index 00000000..c90aff1c --- /dev/null +++ b/class_p_s5_b_t__coll__graph.md5 @@ -0,0 +1 @@ +af22375d62e5abbbf4890280f6d371fc \ No newline at end of file diff --git a/class_p_s5_b_t__coll__graph.png b/class_p_s5_b_t__coll__graph.png new file mode 100644 index 0000000000000000000000000000000000000000..6eac1546d085270f3c0f4a6afcce57ea91780356 GIT binary patch literal 22955 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 literal 0 HcmV?d00001 diff --git a/class_p_s5_b_t__inherit__graph.map b/class_p_s5_b_t__inherit__graph.map new file mode 100644 index 00000000..d723c4be --- /dev/null +++ b/class_p_s5_b_t__inherit__graph.map @@ -0,0 +1,5 @@ + + + + + diff --git a/class_p_s5_b_t__inherit__graph.md5 b/class_p_s5_b_t__inherit__graph.md5 new file mode 100644 index 00000000..cf3701a8 --- /dev/null +++ b/class_p_s5_b_t__inherit__graph.md5 @@ -0,0 +1 @@ +683164d8f857d8b5e186ee09c0ee9d33 \ No newline at end of file diff --git a/class_p_s5_b_t__inherit__graph.png b/class_p_s5_b_t__inherit__graph.png new file mode 100644 index 0000000000000000000000000000000000000000..4e26ef65cf5a86bb375a67c38e837b1be6561e0b GIT binary patch literal 7171 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 X3j1$GS)YTadJqj29axEy)vNypfWgV> literal 0 HcmV?d00001 diff --git a/class_p_s5_parser-members.html b/class_p_s5_parser-members.html new file mode 100644 index 00000000..a6abaa46 --- /dev/null +++ b/class_p_s5_parser-members.html @@ -0,0 +1,105 @@ + + + + + + + +USB Host Shield 2.0: Member List + + + + + + + + + + +
+
+ + + + + + +
+
USB Host Shield 2.0 +
+
+
+ + + + + + + + +
+
+ + +
+ +
+ +
+
+
+
PS5Parser Member List
+
+
+ +

This is the complete list of members for PS5Parser, including all inherited members.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
getAnalogButton(ButtonEnum b)PS5Parser
getAnalogHat(AnalogHatEnum a)PS5Parser
getAngle(AngleEnum a)PS5Parserinline
getButtonClick(ButtonEnum b)PS5Parser
getButtonPress(ButtonEnum b)PS5Parser
getMessageCounter()PS5Parserinline
getSensor(SensorEnum s)PS5Parserinline
getTouchCounter(uint8_t finger=00)PS5Parserinline
getX(uint8_t finger=0)PS5Parserinline
getY(uint8_t finger=0)PS5Parserinline
isTouching(uint8_t finger=0)PS5Parserinline
leftTriggerPS5Parser
Parse(uint8_t len, uint8_t *buf)PS5Parserprotected
PS5Parser()PS5Parserinline
Reset()PS5Parserprotected
rightTriggerPS5Parser
sendOutputReport(PS5Output *output)=0PS5Parserprotectedpure virtual
setAllOff()PS5Parserinline
setLed(uint8_t r, uint8_t g, uint8_t b)PS5Parserinline
setLed(ColorsEnum color)PS5Parserinline
setLedOff()PS5Parserinline
setMicLed(bool on)PS5Parserinline
setMicLedOff()PS5Parserinline
setPlayerLed(uint8_t mask)PS5Parserinline
setPlayerLedOff()PS5Parserinline
setRumbleOff()PS5Parserinline
setRumbleOn(RumbleEnum mode)PS5Parserinline
setRumbleOn(uint8_t bigRumble, uint8_t smallRumble)PS5Parserinline
+ +
+Generated by   +doxygen + 1.8.13 +
+ + diff --git a/class_p_s5_parser.html b/class_p_s5_parser.html new file mode 100644 index 00000000..22e44088 --- /dev/null +++ b/class_p_s5_parser.html @@ -0,0 +1,1062 @@ + + + + + + + +USB Host Shield 2.0: PS5Parser Class Reference + + + + + + + + + + +
+
+ + + + + + +
+
USB Host Shield 2.0 +
+
+
+ + + + + + + + +
+
+ + +
+ +
+ +
+
+
+Public Member Functions | +Public Attributes | +List of all members
+
+
PS5Parser Class Referenceabstract
+
+
+ +

#include <PS5Parser.h>

+
+Inheritance diagram for PS5Parser:
+
+
Inheritance graph
+ + + + +
[legend]
+
+Collaboration diagram for PS5Parser:
+
+
Collaboration graph
+ + + +
[legend]
+ + + + +

+Public Member Functions

 PS5Parser ()
 
+ + + + + +

+Public Attributes

PS5Trigger leftTrigger
 
PS5Trigger rightTrigger
 
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+PS5 Controller functions

bool getButtonPress (ButtonEnum b)
 
bool getButtonClick (ButtonEnum b)
 
uint8_t getAnalogButton (ButtonEnum b)
 
uint8_t getAnalogHat (AnalogHatEnum a)
 
uint16_t getX (uint8_t finger=0)
 
uint16_t getY (uint8_t finger=0)
 
bool isTouching (uint8_t finger=0)
 
uint8_t getTouchCounter (uint8_t finger=00)
 
float getAngle (AngleEnum a)
 
int16_t getSensor (SensorEnum s)
 
void setAllOff ()
 
void setRumbleOff ()
 
void setRumbleOn (RumbleEnum mode)
 
void setRumbleOn (uint8_t bigRumble, uint8_t smallRumble)
 
void setLedOff ()
 
void setLed (uint8_t r, uint8_t g, uint8_t b)
 
void setLed (ColorsEnum color)
 
void setPlayerLedOff ()
 
void setPlayerLed (uint8_t mask)
 
void setMicLedOff ()
 
void setMicLed (bool on)
 
uint16_t getMessageCounter ()
 
void Parse (uint8_t len, uint8_t *buf)
 
void Reset ()
 
virtual void sendOutputReport (PS5Output *output)=0
 
+

Detailed Description

+

This class parses all the data sent by the PS5 controller

+ +

Definition at line 149 of file PS5Parser.h.

+

Constructor & Destructor Documentation

+ +

◆ PS5Parser()

+ +
+
+ + + + + +
+ + + + + + + +
PS5Parser::PS5Parser ()
+ 		+inline
+
+

Constructor for the PS5Parser class.

+ +

Definition at line 152 of file PS5Parser.h.

+ +
+
+

Member Function Documentation

+ +

◆ getButtonPress()

+ +
+
+ + + + + + + + +
bool PS5Parser::getButtonPress (ButtonEnum b)
+
+

getButtonPress(ButtonEnum b) will return true as long as the button is held down.

+

While getButtonClick(ButtonEnum b) will only return it once.

+

So you instance if you need to increase a variable once you would use getButtonClick(ButtonEnum b), but if you need to drive a robot forward you would use getButtonPress(ButtonEnum b).

Parameters
+ + +
bButtonEnum to read.
+
+
+
Returns
getButtonPress(ButtonEnum b) will return a true as long as a button is held down, while getButtonClick(ButtonEnum b) will return true once for each button press.
+ +

Definition at line 54 of file PS5Parser.cpp.

+ +
+
+ +

◆ getButtonClick()

+ +
+
+ + + + + + + + +
bool PS5Parser::getButtonClick (ButtonEnum b)
+
+

getButtonPress(ButtonEnum b) will return true as long as the button is held down.

+

While getButtonClick(ButtonEnum b) will only return it once.

+

So you instance if you need to increase a variable once you would use getButtonClick(ButtonEnum b), but if you need to drive a robot forward you would use getButtonPress(ButtonEnum b).

Parameters
+ + +
bButtonEnum to read.
+
+
+
Returns
getButtonPress(ButtonEnum b) will return a true as long as a button is held down, while getButtonClick(ButtonEnum b) will return true once for each button press.
+ +

Definition at line 61 of file PS5Parser.cpp.

+ +
+
+ +

◆ getAnalogButton()

+ +
+
+ + + + + + + + +
uint8_t PS5Parser::getAnalogButton (ButtonEnum b)
+
+

Used to get the analog value from button presses.

Parameters
+ + +
bThe ButtonEnum to read. The supported buttons are: L2 and R2.
+
+
+
Returns
Analog value in the range of 0-255.
+ +

Definition at line 68 of file PS5Parser.cpp.

+ +
+
+ +

◆ getAnalogHat()

+ +
+
+ + + + + + + + +
uint8_t PS5Parser::getAnalogHat (AnalogHatEnum a)
+
+

Used to read the analog joystick.

Parameters
+ + +
aLeftHatX, LeftHatY, RightHatX, and RightHatY.
+
+
+
Returns
Return the analog value in the range of 0-255.
+ +

Definition at line 76 of file PS5Parser.cpp.

+ +
+
+ +

◆ getX()

+ +
+
+ + + + + +
+ + + + + + + + +
uint16_t PS5Parser::getX (uint8_t finger = 0)
+ 		+inline
+
+

Get the x-coordinate of the touchpad. Position 0 is in the top left.

Parameters
+ + +
finger0 = first finger, 1 = second finger. If omitted, then 0 will be used.
+
+
+ +

Definition at line 194 of file PS5Parser.h.

+ +
+
+ +

◆ getY()

+ +
+
+ + + + + +
+ + + + + + + + +
uint16_t PS5Parser::getY (uint8_t finger = 0)
+ 		+inline
+
+

Get the y-coordinate of the touchpad. Position 0 is in the top left.

Parameters
+ + +
finger0 = first finger, 1 = second finger. If omitted, then 0 will be used.
+
+
+
Returns
Returns the y-coordinate of the finger.
+ +

Definition at line 203 of file PS5Parser.h.

+ +
+
+ +

◆ isTouching()

+ +
+
+ + + + + +
+ + + + + + + + +
bool PS5Parser::isTouching (uint8_t finger = 0)
+ 		+inline
+
+

Returns whenever the user is toucing the touchpad.

Parameters
+ + +
finger0 = first finger, 1 = second finger. If omitted, then 0 will be used.
+
+
+
Returns
Returns true if the specific finger is touching the touchpad.
+ +

Definition at line 212 of file PS5Parser.h.

+ +
+
+ +

◆ getTouchCounter()

+ +
+
+ + + + + +
+ + + + + + + + +
uint8_t PS5Parser::getTouchCounter (uint8_t finger = 00)
+ 		+inline
+
+

This counter increments every time a finger touches the touchpad.

Parameters
+ + +
finger0 = first finger, 1 = second finger. If omitted, then 0 will be used.
+
+
+
Returns
Return the value of the counter, note that it is only a 7-bit value.
+ +

Definition at line 221 of file PS5Parser.h.

+ +
+
+ +

◆ getAngle()

+ +
+
+ + + + + +
+ + + + + + + + +
float PS5Parser::getAngle (AngleEnum a)
+ 		+inline
+
+

Get the angle of the controller calculated using the accelerometer.

Parameters
+ + +
aEither Pitch or Roll.
+
+
+
Returns
Return the angle in the range of 0-360.
+ +

Definition at line 230 of file PS5Parser.h.

+ +
+
+ +

◆ getSensor()

+ +
+
+ + + + + +
+ + + + + + + + +
int16_t PS5Parser::getSensor (SensorEnum s)
+ 		+inline
+
+

Used to get the raw values from the 3-axis gyroscope and 3-axis accelerometer inside the PS5 controller.

Parameters
+ + +
sThe sensor to read.
+
+
+
Returns
Returns the raw sensor reading.
+ +

Definition at line 242 of file PS5Parser.h.

+ +
+
+ +

◆ setAllOff()

+ +
+
+ + + + + +
+ + + + + + + +
void PS5Parser::setAllOff ()
+ 		+inline
+
+

Turn both rumble and the LEDs off.

+ +

Definition at line 298 of file PS5Parser.h.

+ +
+
+ +

◆ setRumbleOff()

+ +
+
+ + + + + +
+ + + + + + + +
void PS5Parser::setRumbleOff ()
+ 		+inline
+
+

Set rumble off.

+ +

Definition at line 304 of file PS5Parser.h.

+ +
+
+ +

◆ setRumbleOn() [1/2]

+ +
+
+ + + + + +
+ + + + + + + + +
void PS5Parser::setRumbleOn (RumbleEnum mode)
+ 		+inline
+
+

Turn on rumble.

Parameters
+ + +
modeEither RumbleHigh or RumbleLow.
+
+
+ +

Definition at line 312 of file PS5Parser.h.

+ +
+
+ +

◆ setRumbleOn() [2/2]

+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + +
void PS5Parser::setRumbleOn (uint8_t bigRumble,
uint8_t smallRumble 
)
+ 		+inline
+
+

Turn on rumble.

Parameters
+ + + +
bigRumbleValue for big motor.
smallRumbleValue for small motor.
+
+
+ +

Definition at line 324 of file PS5Parser.h.

+ +
+
+ +

◆ setLedOff()

+ +
+
+ + + + + +
+ + + + + + + +
void PS5Parser::setLedOff ()
+ 		+inline
+
+

Turn all LEDs off.

+ +

Definition at line 331 of file PS5Parser.h.

+ +
+
+ +

◆ setLed() [1/2]

+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + +
void PS5Parser::setLed (uint8_t r,
uint8_t g,
uint8_t b 
)
+ 		+inline
+
+

Use this to set the color using RGB values.

Parameters
+ + +
r,g,bRGB value.
+
+
+ +

Definition at line 339 of file PS5Parser.h.

+ +
+
+ +

◆ setLed() [2/2]

+ +
+
+ + + + + +
+ + + + + + + + +
void PS5Parser::setLed (ColorsEnum color)
+ 		+inline
+
+

Use this to set the color using the predefined colors in ColorsEnum.

Parameters
+ + +
colorThe desired color.
+
+
+ +

Definition at line 350 of file PS5Parser.h.

+ +
+
+ +

◆ setPlayerLedOff()

+ +
+
+ + + + + +
+ + + + + + + +
void PS5Parser::setPlayerLedOff ()
+ 		+inline
+
+

Turn all player LEDs off.

+ +

Definition at line 355 of file PS5Parser.h.

+ +
+
+ +

◆ setPlayerLed()

+ +
+
+ + + + + +
+ + + + + + + + +
void PS5Parser::setPlayerLed (uint8_t mask)
+ 		+inline
+
+

Use this to set five player LEDs.

Parameters
+ + +
maskBit mask to set the five player LEDs. The first 5 bits represent a LED each.
+
+
+ +

Definition at line 363 of file PS5Parser.h.

+ +
+
+ +

◆ setMicLedOff()

+ +
+
+ + + + + +
+ + + + + + + +
void PS5Parser::setMicLedOff ()
+ 		+inline
+
+

Use to turn the microphone LED off.

+ +

Definition at line 369 of file PS5Parser.h.

+ +
+
+ +

◆ setMicLed()

+ +
+
+ + + + + +
+ + + + + + + + +
void PS5Parser::setMicLed (bool on)
+ 		+inline
+
+

Use this to turn the microphone LED on/off.

Parameters
+ + +
onTurn the microphone LED on/off.
+
+
+ +

Definition at line 377 of file PS5Parser.h.

+ +
+
+ +

◆ getMessageCounter()

+ +
+
+ + + + + +
+ + + + + + + +
uint16_t PS5Parser::getMessageCounter ()
+ 		+inline
+
+

Get the incoming message count.

+ +

Definition at line 383 of file PS5Parser.h.

+ +
+
+ +

◆ Parse()

+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + +
void PS5Parser::Parse (uint8_t len,
uint8_t * buf 
)
+ 		+protected
+
+

Used to parse data sent from the PS5 controller.

Parameters
+ + + +
lenLength of the data.
bufPointer to the data buffer.
+
+
+ +

Definition at line 80 of file PS5Parser.cpp.

+ +
+
+ +

◆ Reset()

+ +
+
+ + + + + +
+ + + + + + + +
void PS5Parser::Reset ()
+ 		+protected
+
+

Used to reset the different buffers to their default values

+ +

Definition at line 140 of file PS5Parser.cpp.

+ +
+
+ +

◆ sendOutputReport()

+ +
+
+ + + + + +
+ + + + + + + + +
virtual void PS5Parser::sendOutputReport (PS5Output * output)
+ 		+protectedpure virtual
+
+

Send the output to the PS5 controller. This is implemented in PS5BT.h and PS5USB.h.

Parameters
+ + +
outputPointer to PS5Output buffer;
+
+
+ +

Implemented in PS5BT, and PS5USB.

+ +
+
+

Member Data Documentation

+ +

◆ leftTrigger

+ +
+
+ + + + +
PS5Trigger PS5Parser::leftTrigger
+
+

Used these to manipulate the haptic triggers

+ +

Definition at line 154 of file PS5Parser.h.

+ +
+
+ +

◆ rightTrigger

+ +
+
+ + + + +
PS5Trigger PS5Parser::rightTrigger
+
+ +

Definition at line 154 of file PS5Parser.h.

+ +
+
+
The documentation for this class was generated from the following files: +
+ +
+Generated by   +doxygen + 1.8.13 +
+ + diff --git a/class_p_s5_parser__coll__graph.map b/class_p_s5_parser__coll__graph.map new file mode 100644 index 00000000..48e7161e --- /dev/null +++ b/class_p_s5_parser__coll__graph.map @@ -0,0 +1,3 @@ + + + diff --git a/class_p_s5_parser__coll__graph.md5 b/class_p_s5_parser__coll__graph.md5 new file mode 100644 index 00000000..33743451 --- /dev/null +++ b/class_p_s5_parser__coll__graph.md5 @@ -0,0 +1 @@ +55bc739695663b1262b61ae35595de68 \ No newline at end of file diff --git a/class_p_s5_parser__coll__graph.png b/class_p_s5_parser__coll__graph.png new file mode 100644 index 0000000000000000000000000000000000000000..79056b8dd6c28b2c8da72e21a79826bd53c302ee GIT binary patch literal 3689 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 + + + diff --git a/class_p_s5_parser__inherit__graph.md5 b/class_p_s5_parser__inherit__graph.md5 new file mode 100644 index 00000000..ec39f442 --- /dev/null +++ b/class_p_s5_parser__inherit__graph.md5 @@ -0,0 +1 @@ +d87407f36f9af571e0f891b33de205b9 \ No newline at end of file diff --git a/class_p_s5_parser__inherit__graph.png b/class_p_s5_parser__inherit__graph.png new file mode 100644 index 0000000000000000000000000000000000000000..e901c8e21121757234778f0f5071d327c4ff30ae GIT binary patch literal 3798 zcmYjU2Q*w;7rvs5UK2#L7i2uqMG3+XogjLR-lO*tMsLwG2pL9sLG%cT7K7*{N*JR@ zZ=-j?fAg2M{&Uy8XWz5--ly#Lop^0cWeQRzQUCxbR8l(85gsJk&3Bqng6w0Lbp*HXp|x~f#B~At6V8OA`|pF91lK%hfh+3 zPXqviX5wy+juJlWsf|0DbPcZ44FUVs-VS({N-REpexX;#827fThDKUJDNL0)85Pw{ z-4>kl$&=X@lI%1z8s=TH7nXg6hYx_tXq6!3z-vlImBAJ*X8PHo+bKPVr>9yfD%q00 zJODSMe{^)z1ygl=eEe8S3PMPzsHo`KI3pBgjcTR@P$(37d>p|ZcYS@m)RVG1-zF<7 z%LW`A90UaiiwFywnVCsSN*){@=F5iVrKSSF+K>D!70xN*w6wHbargJcU2r(%S;$uy zI{+vv_Y@a%)*A6<4Y<0xR$H{?A(6PHC42zXy}!SoA96ra7FktQm71EGoy{m5fkd+S zavw?yNrq2e!-wqg(F+Ugz+OPhhYueZ1YV??gJLTyE6You2)53FELy%mdwq4ad+o67 z={N@CKJ&%1E8z|e4NZwwJ`w!#bQeNIbbYpzvitRN2RHp0od2s;XUy>MaBpvKP7afB z$HIc;^XDTM$6J^RV-AFxCo|@r-GLV)6@d>*j|ZXlk9@)U#zx=J(DC6RhsC^;lhe@9 zkaaDnQMRh0BINg3t)GgaAqMf#(4fk!G3a=6a8RStfIKFBU?uo;2NZhv@Zse`BvtQm zbj#PmLhFG{KKTMc4h|dKR6V#4At50w7R!T3*v4&c@^Evfs{P}?GxIkO&nU|Z4)>(M zj){%9g6y8S8z-A3qnP_#%WSiMhV1vZB5P;+OMHBMNl8fz{AS#|yfd{nkjA?{9v;;3 z3J^->fP-aK0|SH5&`@XR%>jAPwCU-z3=9k|E?Z7x@A2RU5Km9fI{P7TnJ>le^>~_^ zPJ>$@A|gs}9@*U7Y-y1Whb?SxGcz!pp0DLs8`mjGIp0@*6iPiTXKai;+88@#(&rif zJRjQp5-ZI1r{#kO3i?z>hrABt@#DwKcG9fwhpR*2f!!_;BoE$O2-oA$=f2I#%GzWu z;_#gS0H^%@`*(jo=!rTO7W1X0rRRrh_~;_#l!;2ylGf~=rHy2HG6Ek<>LjH)_jwtA ze}644t&eu?5rq2s`oP|_d)xTLM3s4SX6G*e$Q^n=N3tl9mzkNFm&Z>V|I_&xR9A0q z8xJKu&Ao%xGClI3A+SnQxn)m@qIhVq{`cqfsl+CMPHNkYGlr z9d|KU0B|#YOtbyv2~Jd0^wq0ZTKO_|by&t2JeY@vhn1BTxCdorNTae4c1-kf>30Z_ z`tF^XiAm7W`pC|X8x&ds2H)viFclz3F6Fa6{Hrr|X>sv^Rvt4G(}yekQFcE+zg#ib zsb>FbB+}g0cKKjsAR{A#icO}X6+W=?015@Itj?K!SHylBTh}u+#RL=<6{WC9HTZ5B z)SI;0_NDWgHaM0LEL*iGZs z1f~>DFr@&DEP|=oSmmam;}2!-1qO7V-O65sy&5I1c7Lh&JzsWXr6-4%PGpOngQK%} zU+A>}brc1;Pu`QuT^dSH4`Sz+K3lst49T)WPHsmLHD>%4Uzc#m#m$_6O}(XFWu)Zz z`ex4h3c~CBfMsk&Nu1X^3`QNLXF_++lrxJ8K;Lr@cpbtUSSw$Uko1HfF+m-cd_!j) zE}7b=mn$CjcbZ;?n!iWQ{$955!7o-;U4mPt5kLeGUo81x^{mc8ZOl%cj`tY^hf6W6 zlJ?mcbxn!^0I^&y+Q1~S-j3+J_;_e}xjW?*mlb1k z<2kxm)u4#9RPV#95E)kHpX>E?*a|ePjYHWQx2?3Pgt~QbC>MOWq+d>H-V!jq@X+^U zd!y(M9-xt9E9#JZ?P&lEJI1+Saty1#JGqBRe`0VNo@gH{@v8l@FxMI@AtUh#)1M#` z^Xz`S%CeoE-NKi@lc^d$N#9N+%aa+G?TmZmxP@+SKgo5cHLS>n058SVtNlH+MPi2V z`XUHfi7&@GXC^X4Tt-|X`8w=pTfsu60NiS|Opx+8if za+|~R2Az%hf&RrP`SxtO_t0LjcyZe9TwiTfR0@gZMqAzJMkXdA%ge*H#FC@RbXndZ zaeY0E-S)NUe$s(KGX~bL!xDGL$jL^+<%Md(Zm|00tH>w0>nkfA_H{OHUlwtES8@i{M z$cPy+vE=x-?2S!roSa6Rq4b$Zrhfuu`H28kh5#sK7H>ugbd3L4&DKUbY zp2T7?Sgd$n%~Osy2vOqbX}7s;W-X(jh?bP%5o#+d9rC4jGOdWN(VL9+FVqCJp;u`P z0(xuTxx6Ikg%RoOH@0eOo9=Vl{r#lk^~3>O*Ni2s=B&buC597$KP0L?lGdX1hQHV z`acyGhG|Sbdq&Z5*p7JU4|ISuan;@)X1P5b~@X-)U z{!Td4Kn-2$NO&LxzB4ac6Q%^Q7bh>3o7IFph4={mhqBC9VFMY9aRdaT|D;&KC`SEm z&HBQ`!7(2kK~pu^qemd)PfgTu2uuqcRKO8jY{I{TtKgm@IU2_s0(Ga>(K&v=zqm*A zlidM2?3o{z0O~REyTx+&v`Y|0#3vQ*CkYz>slPyK>y{TNTslc|ltZQcM|YPdDvfej z6r?)-P^n_%r3GzB7y}E+jZyn)m{d6ZrNRKX+Ja^z>QYOHhlgh{9X~M|JKYv-m8=vm zb{$4(T_|apUDSGI%1h7JfVQqRI{o`zZ=abnqbvmlMPp-QcY^&#$q?I|nj&^6RJpnf zPU(1%)M?WhCkbn!{P|AOSFJialKB?xy zZ+W@6y2i%FCMG5@82=x6Pt>@^v&=SPyu7>;l9P9KcOmeE1k%jELN7K-gg9T`e{C8I zvS!t5D+C+kDGxBNMaIO$%+1Z^<>i$dRxe7h-npaL(9_c+E+z&7iR+84>aMOXu<)v? zs@fWQde*v)mX(zS74Vxk9SsPyadL73Fe4))_kXviPw|1H>+ds--aVN$@q*SY+^9Gr zfxj0@?{4OkyVL3D)0$!kD!eReP3>0 z_fmI~mh9EhxS>V;$B#S$0?_F!KGO$jDi@cRxw*OXA%{bglSbCPre-H6CzX|zO{azD zO_tvzwJXT}v*Va5GNnm2$Fx3M5I{yoMowiO9r=ihe=abb7$1KuDY+R9qPn+l-~NGG zhNET>rHanh;8SvZ%+k5+?G(yRgx z9z3{z|2`DjGd+E|I+P2d+U0y5-S--O{r%3auFo_y-VCht_4R=OYq=CO(SCq5kUFpu z7#JvDFbp!s89$S@DeVN^;18C}&6NUSFldV6;$rYH__NemlD&ISvqP0p=RbvX(H0|6QO!v;zoA zTC!XHH~PN8^BGxLW%dIZqpSFBLY>KHCCLZ;=U+i-<9$r81=+qdHpX`?#y{)JCXSXb zT22XKiBaUF<$KX$^f{V7-`!SFYVi91E`5JM)eWJLw`&eX_4S{dE1;^VsZb?v8SyVr Cs7vtx literal 0 HcmV?d00001 diff --git a/class_p_s5_trigger-members.html b/class_p_s5_trigger-members.html new file mode 100644 index 00000000..a68250c3 --- /dev/null +++ b/class_p_s5_trigger-members.html @@ -0,0 +1,84 @@ + + + + + + + +USB Host Shield 2.0: Member List + + + + + + + + + + +
+
+ + + + + + +
+
USB Host Shield 2.0 +
+
+
+ + + + + + + + +
+
+ + +
+ +
+ +
+
+
+
PS5Trigger Member List
+
+
+ +

This is the complete list of members for PS5Trigger, including all inherited members.

+ + + + + + + + +
clearTriggerForce()PS5Triggerinline
processTrigger(uint8_t *buffer)PS5Trigger
reportChangedPS5Trigger
Reset()PS5Triggerinline
setTriggerForce(uint8_t start, uint8_t force)PS5Triggerinline
setTriggerForceEffect(uint8_t start, bool keep, uint8_t begin_force, uint8_t mid_force, uint8_t end_force, uint8_t frequency)PS5Triggerinline
setTriggerForceSection(uint8_t start, uint8_t end)PS5Triggerinline
+ +
+Generated by   +doxygen + 1.8.13 +
+ + diff --git a/class_p_s5_trigger.html b/class_p_s5_trigger.html new file mode 100644 index 00000000..51ec064d --- /dev/null +++ b/class_p_s5_trigger.html @@ -0,0 +1,375 @@ + + + + + + + +USB Host Shield 2.0: PS5Trigger Class Reference + + + + + + + + + + +
+
+ + + + + + +
+
USB Host Shield 2.0 +
+
+
+ + + + + + + + +
+
+ + +
+ +
+ +
+
+
+Classes | +Public Member Functions | +Public Attributes | +List of all members
+
+
PS5Trigger Class Reference
+
+
+ +

#include <PS5Trigger.h>

+ + + + + + + + + + + + + + + +

+Public Member Functions

void processTrigger (uint8_t *buffer)
 Apply the trigger data to a PS5 update buffer. More...
 
void Reset ()
 
void clearTriggerForce ()
 
void setTriggerForce (uint8_t start, uint8_t force)
 
void setTriggerForceSection (uint8_t start, uint8_t end)
 
void setTriggerForceEffect (uint8_t start, bool keep, uint8_t begin_force, uint8_t mid_force, uint8_t end_force, uint8_t frequency)
 
+ + + +

+Public Attributes

bool reportChanged = false
 
+

Detailed Description

+
+

Definition at line 38 of file PS5Trigger.h.

+

Member Function Documentation

+ +

◆ processTrigger()

+ +
+
+ + + + + + + + +
void PS5Trigger::processTrigger (uint8_t * buffer)
+
+ +

Apply the trigger data to a PS5 update buffer.

+
Parameters
+ + +
bufferThe buffer at the start offset for this trigger data
+
+
+ +

Definition at line 34 of file PS5Trigger.cpp.

+ +
+
+ +

◆ Reset()

+ +
+
+ + + + + +
+ + + + + + + +
void PS5Trigger::Reset ()
+ 		+inline
+
+

Clear force feedback on trigger without report changed

+ +

Definition at line 100 of file PS5Trigger.h.

+ +
+
+ +

◆ clearTriggerForce()

+ +
+
+ + + + + +
+ + + + + + + +
void PS5Trigger::clearTriggerForce ()
+ 		+inline
+
+

Clear force feedback on trigger

+ +

Definition at line 109 of file PS5Trigger.h.

+ +
+
+ +

◆ setTriggerForce()

+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + +
void PS5Trigger::setTriggerForce (uint8_t start,
uint8_t force 
)
+ 		+inline
+
+

Set continuous force feedback on trigger

Parameters
+ + + +
start0-255 trigger pull to start resisting
forceThe force amount
+
+
+ +

Definition at line 120 of file PS5Trigger.h.

+ +
+
+ +

◆ setTriggerForceSection()

+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + +
void PS5Trigger::setTriggerForceSection (uint8_t start,
uint8_t end 
)
+ 		+inline
+
+

Set section force feedback on trigger

Parameters
+ + + +
starttrigger pull to start resisting
endtrigger pull to stop resisting
+
+
+ +

Definition at line 137 of file PS5Trigger.h.

+ +
+
+ +

◆ setTriggerForceEffect()

+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
void PS5Trigger::setTriggerForceEffect (uint8_t start,
bool keep,
uint8_t begin_force,
uint8_t mid_force,
uint8_t end_force,
uint8_t frequency 
)
+ 		+inline
+
+

Set effect force feedback on trigger

Parameters
+ + + + + + + +
starttrigger pull to start resisting
keepKeep effect active after max trigger pull
begin_force0-255 force at start position
mid_force0-255 force half way between start and max pull
end_force0-255 force at max pull
frequencyVibration frequency of the trigger
+
+
+ +

Definition at line 154 of file PS5Trigger.h.

+ +
+
+

Member Data Documentation

+ +

◆ reportChanged

+ +
+
+ + + + +
bool PS5Trigger::reportChanged = false
+
+ +

Definition at line 88 of file PS5Trigger.h.

+ +
+
+
The documentation for this class was generated from the following files: +
+ +
+Generated by   +doxygen + 1.8.13 +
+ + diff --git a/class_p_s5_u_s_b-members.html b/class_p_s5_u_s_b-members.html new file mode 100644 index 00000000..8b39ccb5 --- /dev/null +++ b/class_p_s5_u_s_b-members.html @@ -0,0 +1,163 @@ + + + + + + + +USB Host Shield 2.0: Member List + + + + + + + + + + +
+
+ + + + + + +
+
USB Host Shield 2.0 +
+
+
+ + + + + + + + +
+
+ + +
+ +
+ +
+
+
+
PS5USB Member List
+
+
+ +

This is the complete list of members for PS5USB, including all inherited members.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
attachOnInit(void(*funcOnInit)(void))PS5USBinline
bAddressUSBHIDprotected
bConfNumHIDCompositeprotected
bHasReportIdHIDCompositeprotected
bNumEPHIDCompositeprotected
bNumIfaceHIDCompositeprotected
bPollEnableHIDCompositeprotected
ConfigureDevice(uint8_t parent, uint8_t port, bool lowspeed)USBDeviceConfiginlinevirtual
connected()PS5USBinline
constBuffLenHIDCompositeprotectedstatic
descrInfoHIDCompositeprotected
DEVCLASSOK(uint8_t klass)USBDeviceConfiginlinevirtual
DEVSUBCLASSOK(uint8_t subklass)USBDeviceConfiginlinevirtual
EndpointXtract(uint8_t conf, uint8_t iface, uint8_t alt, uint8_t proto, const USB_ENDPOINT_DESCRIPTOR *ep) overrideHIDUniversalinlinevirtual
epInfoHIDCompositeprotected
epInterruptInIndexUSBHIDprotectedstatic
epInterruptOutIndexUSBHIDprotectedstatic
FindInterface(uint8_t iface, uint8_t alt, uint8_t proto)HIDCompositeprotected
GetAddress()HIDCompositeinlinevirtual
getAnalogButton(ButtonEnum b)PS5Parser
getAnalogHat(AnalogHatEnum a)PS5Parser
getAngle(AngleEnum a)PS5Parserinline
getButtonClick(ButtonEnum b)PS5Parser
getButtonPress(ButtonEnum b)PS5Parser
GetHidClassDescrLen(uint8_t type, uint8_t num)HIDCompositeprotected
GetHidDescr(uint8_t ep, uint16_t nbytes, uint8_t *dataptr)USBHID
GetIdle(uint8_t iface, uint8_t reportID, uint8_t *dataptr)USBHID
getMessageCounter()PS5Parserinline
GetProtocol(uint8_t iface, uint8_t *dataptr)USBHID
GetReport(uint8_t ep, uint8_t iface, uint8_t report_type, uint8_t report_id, uint16_t nbytes, uint8_t *dataptr)USBHID
GetReportDescr(uint16_t wIndex, USBReadParser *parser=NULL)USBHID
GetReportParser(uint8_t id)HIDCompositeprotectedvirtual
getSensor(SensorEnum s)PS5Parserinline
getTouchCounter(uint8_t finger=00)PS5Parserinline
GetUsb()USBHIDinline
getX(uint8_t finger=0)PS5Parserinline
getY(uint8_t finger=0)PS5Parserinline
HIDComposite(USB *p)HIDComposite
hidInterfacesHIDCompositeprotected
HIDUniversal(USB *p)HIDUniversalinline
Init(uint8_t parent, uint8_t port, bool lowspeed)HIDCompositevirtual
Initialize()HIDCompositeprotected
isReady()HIDCompositeinlinevirtual
isTouching(uint8_t finger=0)PS5Parserinline
leftTriggerPS5Parser
maxEpPerInterfaceUSBHIDprotectedstatic
maxHidInterfacesUSBHIDprotectedstatic
OnInitSuccessful()PS5USBinlineprotectedvirtual
Parse(uint8_t len, uint8_t *buf)PS5Parserprotected
ParseHIDData(USBHID *hid, bool is_rpt_id, uint8_t len, uint8_t *buf)PS5USBinlineprotectedvirtual
PIDHIDCompositeprotected
Poll() overrideHIDUniversalvirtual
pollIntervalHIDCompositeprotected
PrintEndpointDescriptor(const USB_ENDPOINT_DESCRIPTOR *ep_ptr)USBHIDprotected
PrintHidDescriptor(const USB_HID_DESCRIPTOR *pDesc)USBHIDprotected
PS5Parser()PS5Parserinline
PS5USB(USB *p)PS5USBinline
pUsbUSBHIDprotected
qNextPollTimeHIDCompositeprotected
Release()HIDCompositevirtual
Reset()PS5Parserprotected
ResetHubPort(uint8_t port)USBDeviceConfiginlinevirtual
rightTriggerPS5Parser
rptParsersHIDCompositeprotected
sendOutputReport(PS5Output *output)PS5USBinlineprotectedvirtual
setAllOff()PS5Parserinline
SetIdle(uint8_t iface, uint8_t reportID, uint8_t duration)USBHID
setLed(uint8_t r, uint8_t g, uint8_t b)PS5Parserinline
setLed(ColorsEnum color)PS5Parserinline
setLedOff()PS5Parserinline
setMicLed(bool on)PS5Parserinline
setMicLedOff()PS5Parserinline
setPlayerLed(uint8_t mask)PS5Parserinline
setPlayerLedOff()PS5Parserinline
SetProtocol(uint8_t iface, uint8_t protocol)USBHID
SetReport(uint8_t ep, uint8_t iface, uint8_t report_type, uint8_t report_id, uint16_t nbytes, uint8_t *dataptr)USBHID
SetReportParser(uint8_t id, HIDReportParser *prs)HIDCompositevirtual
setRumbleOff()PS5Parserinline
setRumbleOn(RumbleEnum mode)PS5Parserinline
setRumbleOn(uint8_t bigRumble, uint8_t smallRumble)PS5Parserinline
SndRpt(uint16_t nbytes, uint8_t *dataptr)HIDComposite
totalEndpointsUSBHIDprotectedstatic
USBHID(USB *pusb)USBHIDinline
VIDHIDCompositeprotected
VIDPIDOK(uint16_t vid, uint16_t pid)PS5USBinlineprotectedvirtual
ZeroMemory(uint8_t len, uint8_t *buf)HIDCompositeprotected
+ +
+Generated by   +doxygen + 1.8.13 +
+ + diff --git a/class_p_s5_u_s_b.html b/class_p_s5_u_s_b.html new file mode 100644 index 00000000..f2258d2a --- /dev/null +++ b/class_p_s5_u_s_b.html @@ -0,0 +1,591 @@ + + + + + + + +USB Host Shield 2.0: PS5USB Class Reference + + + + + + + + + + +
+
+ + + + + + +
+
USB Host Shield 2.0 +
+
+
+ + + + + + + + +
+
+ + +
+ +
+ +
+
+
+Public Member Functions | +List of all members
+
+
PS5USB Class Reference
+
+
+ +

#include <PS5USB.h>

+
+Inheritance diagram for PS5USB:
+
+
Inheritance graph
+ + + + + + + + +
[legend]
+
+Collaboration diagram for PS5USB:
+
+
Collaboration graph
+ + + + + + + + + + + + + + + + +
[legend]
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+Public Member Functions

 PS5USB (USB *p)
 
bool connected ()
 
void attachOnInit (void(*funcOnInit)(void))
 
- Public Member Functions inherited from HIDUniversal
 HIDUniversal (USB *p)
 
uint8_t Poll () override
 
void EndpointXtract (uint8_t conf, uint8_t iface, uint8_t alt, uint8_t proto, const USB_ENDPOINT_DESCRIPTOR *ep) override
 
- Public Member Functions inherited from HIDComposite
 HIDComposite (USB *p)
 
bool SetReportParser (uint8_t id, HIDReportParser *prs)
 
uint8_t Init (uint8_t parent, uint8_t port, bool lowspeed)
 
uint8_t Release ()
 
virtual uint8_t GetAddress ()
 
virtual bool isReady ()
 
uint8_t SndRpt (uint16_t nbytes, uint8_t *dataptr)
 
- Public Member Functions inherited from USBHID
 USBHID (USB *pusb)
 
const USB * GetUsb ()
 
uint8_t SetProtocol (uint8_t iface, uint8_t protocol)
 
uint8_t GetProtocol (uint8_t iface, uint8_t *dataptr)
 
uint8_t GetIdle (uint8_t iface, uint8_t reportID, uint8_t *dataptr)
 
uint8_t SetIdle (uint8_t iface, uint8_t reportID, uint8_t duration)
 
uint8_t GetReportDescr (uint16_t wIndex, USBReadParser *parser=NULL)
 
uint8_t GetHidDescr (uint8_t ep, uint16_t nbytes, uint8_t *dataptr)
 
uint8_t GetReport (uint8_t ep, uint8_t iface, uint8_t report_type, uint8_t report_id, uint16_t nbytes, uint8_t *dataptr)
 
uint8_t SetReport (uint8_t ep, uint8_t iface, uint8_t report_type, uint8_t report_id, uint16_t nbytes, uint8_t *dataptr)
 
- Public Member Functions inherited from USBDeviceConfig
virtual uint8_t ConfigureDevice (uint8_t parent, uint8_t port, bool lowspeed)
 
virtual void ResetHubPort (uint8_t port)
 
virtual bool DEVCLASSOK (uint8_t klass)
 
virtual bool DEVSUBCLASSOK (uint8_t subklass)
 
- Public Member Functions inherited from PS5Parser
 PS5Parser ()
 
bool getButtonPress (ButtonEnum b)
 
bool getButtonClick (ButtonEnum b)
 
uint8_t getAnalogButton (ButtonEnum b)
 
uint8_t getAnalogHat (AnalogHatEnum a)
 
uint16_t getX (uint8_t finger=0)
 
uint16_t getY (uint8_t finger=0)
 
bool isTouching (uint8_t finger=0)
 
uint8_t getTouchCounter (uint8_t finger=00)
 
float getAngle (AngleEnum a)
 
int16_t getSensor (SensorEnum s)
 
void setAllOff ()
 
void setRumbleOff ()
 
void setRumbleOn (RumbleEnum mode)
 
void setRumbleOn (uint8_t bigRumble, uint8_t smallRumble)
 
void setLedOff ()
 
void setLed (uint8_t r, uint8_t g, uint8_t b)
 
void setLed (ColorsEnum color)
 
void setPlayerLedOff ()
 
void setPlayerLed (uint8_t mask)
 
void setMicLedOff ()
 
void setMicLed (bool on)
 
uint16_t getMessageCounter ()
 
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+Protected Member Functions

HIDUniversal implementation
virtual void ParseHIDData (USBHID *hid, bool is_rpt_id, uint8_t len, uint8_t *buf)
 
virtual uint8_t OnInitSuccessful ()
 
PS5Parser implementation
virtual void sendOutputReport (PS5Output *output)
 
USBDeviceConfig implementation
virtual bool VIDPIDOK (uint16_t vid, uint16_t pid)
 
- Protected Member Functions inherited from HIDComposite
uint16_t GetHidClassDescrLen (uint8_t type, uint8_t num)
 
void Initialize ()
 
HIDInterface * FindInterface (uint8_t iface, uint8_t alt, uint8_t proto)
 
void ZeroMemory (uint8_t len, uint8_t *buf)
 
HIDReportParser * GetReportParser (uint8_t id)
 
- Protected Member Functions inherited from USBHID
void PrintEndpointDescriptor (const USB_ENDPOINT_DESCRIPTOR *ep_ptr)
 
void PrintHidDescriptor (const USB_HID_DESCRIPTOR *pDesc)
 
- Protected Member Functions inherited from PS5Parser
void Parse (uint8_t len, uint8_t *buf)
 
void Reset ()
 
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+Additional Inherited Members

- Public Attributes inherited from PS5Parser
PS5Trigger leftTrigger
 
PS5Trigger rightTrigger
 
- Protected Attributes inherited from HIDComposite
struct HIDComposite::ReportParser rptParsers [MAX_REPORT_PARSERS]
 
HID_CLASS_DESCRIPTOR_LEN_AND_TYPE descrInfo [HID_MAX_HID_CLASS_DESCRIPTORS]
 
uint8_t bConfNum
 
uint8_t bNumIface
 
uint8_t bNumEP
 
uint32_t qNextPollTime
 
uint8_t pollInterval
 
bool bPollEnable
 
EpInfo epInfo [totalEndpoints]
 
HIDInterface hidInterfaces [maxHidInterfaces]
 
bool bHasReportId
 
uint16_t PID
 
uint16_t VID
 
- Protected Attributes inherited from USBHID
USB * pUsb
 
uint8_t bAddress
 
- Static Protected Attributes inherited from HIDComposite
static const uint16_t constBuffLen = 64
 
- Static Protected Attributes inherited from USBHID
static const uint8_t epInterruptInIndex = 1
 
static const uint8_t epInterruptOutIndex = 2
 
static const uint8_t maxHidInterfaces = 5
 
static const uint8_t maxEpPerInterface = 2
 
static const uint8_t totalEndpoints = (maxHidInterfaces * maxEpPerInterface + 1)
 
+

Detailed Description

+

This class implements support for the PS5 controller via USB. It uses the HIDUniversal class for all the USB communication.

+ +

Definition at line 34 of file PS5USB.h.

+

Constructor & Destructor Documentation

+ +

◆ PS5USB()

+ +
+
+ + + + + +
+ + + + + + + + +
PS5USB::PS5USB (USB * p)
+ 		+inline
+
+

Constructor for the PS5USB class.

Parameters
+ + +
pPointer to the USB class instance.
+
+
+ +

Definition at line 40 of file PS5USB.h.

+ +
+
+

Member Function Documentation

+ +

◆ connected()

+ +
+
+ + + + + +
+ + + + + + + +
bool PS5USB::connected ()
+ 		+inline
+
+

Used to check if a PS5 controller is connected.

Returns
Returns true if it is connected.
+ +

Definition at line 49 of file PS5USB.h.

+ +
+
+ +

◆ attachOnInit()

+ +
+
+ + + + + +
+ + + + + + + + +
void PS5USB::attachOnInit (void(*)(void) funcOnInit)
+ 		+inline
+
+

Used to call your own function when the device is successfully initialized.

Parameters
+ + +
funcOnInitFunction to call.
+
+
+ +

Definition at line 57 of file PS5USB.h.

+ +
+
+ +

◆ ParseHIDData()

+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
virtual void PS5USB::ParseHIDData (USBHID * hid,
bool is_rpt_id,
uint8_t len,
uint8_t * buf 
)
+ 		+inlineprotectedvirtual
+
+

Used to parse USB HID data.

Parameters
+ + + + + +
hidPointer to the HID class.
is_rpt_idOnly used for Hubs.
lenThe length of the incoming data.
bufPointer to the data buffer.
+
+
+ +

Reimplemented from HIDUniversal.

+ +

Definition at line 70 of file PS5USB.h.

+ +
+
+ +

◆ OnInitSuccessful()

+ +
+
+ + + + + +
+ + + + + + + +
virtual uint8_t PS5USB::OnInitSuccessful ()
+ 		+inlineprotectedvirtual
+
+

Called when a device is successfully initialized. Use attachOnInit(void (*funcOnInit)(void)) to call your own function. This is useful for instance if you want to set the LEDs in a specific way.

+ +

Reimplemented from HIDComposite.

+ +

Definition at line 80 of file PS5USB.h.

+ +
+
+ +

◆ sendOutputReport()

+ +
+
+ + + + + +
+ + + + + + + + +
virtual void PS5USB::sendOutputReport (PS5Output * output)
+ 		+inlineprotectedvirtual
+
+

Send the output to the PS5 controller. This is implemented in PS5BT.h and PS5USB.h.

Parameters
+ + +
outputPointer to PS5Output buffer;
+
+
+ +

Implements PS5Parser.

+ +

Definition at line 93 of file PS5USB.h.

+ +
+
+ +

◆ VIDPIDOK()

+ +
+
+ + + + + +
+ + + + + + + + + + + + + + + + + + +
virtual bool PS5USB::VIDPIDOK (uint16_t vid,
uint16_t pid 
)
+ 		+inlineprotectedvirtual
+
+

Used by the USB core to check what this driver support.

Parameters
+ + + +
vidThe device's VID.
pidThe device's PID.
+
+
+
Returns
Returns true if the device's VID and PID matches this driver.
+ +

Reimplemented from USBDeviceConfig.

+ +

Definition at line 149 of file PS5USB.h.

+ +
+
+
The documentation for this class was generated from the following file: +
+ +
+Generated by   +doxygen + 1.8.13 +
+ + diff --git a/class_p_s5_u_s_b__coll__graph.map b/class_p_s5_u_s_b__coll__graph.map new file mode 100644 index 00000000..8d90f23f --- /dev/null +++ b/class_p_s5_u_s_b__coll__graph.map @@ -0,0 +1,16 @@ + + + + + + + + + + + + + + + + diff --git a/class_p_s5_u_s_b__coll__graph.md5 b/class_p_s5_u_s_b__coll__graph.md5 new file mode 100644 index 00000000..dc0c2034 --- /dev/null +++ b/class_p_s5_u_s_b__coll__graph.md5 @@ -0,0 +1 @@ +4bdeef9556556cafd909ab2ee4f9ab40 \ No newline at end of file diff --git a/class_p_s5_u_s_b__coll__graph.png b/class_p_s5_u_s_b__coll__graph.png new file mode 100644 index 0000000000000000000000000000000000000000..31df349aab4ecf107618d0d9e01ff2dcf85856b4 GIT binary patch literal 44442 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

+ + + + + + + diff --git a/class_p_s5_u_s_b__inherit__graph.md5 b/class_p_s5_u_s_b__inherit__graph.md5 new file mode 100644 index 00000000..91ec4561 --- /dev/null +++ b/class_p_s5_u_s_b__inherit__graph.md5 @@ -0,0 +1 @@ +1a88ae431660c7ffde1ff536d6ddaeaa \ No newline at end of file diff --git a/class_p_s5_u_s_b__inherit__graph.png b/class_p_s5_u_s_b__inherit__graph.png new file mode 100644 index 0000000000000000000000000000000000000000..99f8a55e1b3be3072e3d893b534f44fe08177175 GIT binary patch literal 14472 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 - - - - - + + + + + - - + + +

[legend]
@@ -364,7 +365,7 @@ Public Member Functions
-

Reimplemented in BTD, PSBuzz, FTDI, XBOXONE, PS4USB, ADK, XR21B1411, XBOXRECV, XBOXUSB, PS3USB, and XBOXOLD.

+

Reimplemented in BTD, PSBuzz, PS5USB, FTDI, XBOXONE, PS4USB, ADK, XR21B1411, XBOXRECV, XBOXUSB, PS3USB, and XBOXOLD.

Definition at line 161 of file UsbCore.h.

diff --git a/class_u_s_b_device_config__inherit__graph.map b/class_u_s_b_device_config__inherit__graph.map index 9261e3b5..dfd04beb 100644 --- a/class_u_s_b_device_config__inherit__graph.map +++ b/class_u_s_b_device_config__inherit__graph.map @@ -7,16 +7,17 @@ - - - - - + + + + + - - + + + diff --git a/class_u_s_b_device_config__inherit__graph.md5 b/class_u_s_b_device_config__inherit__graph.md5 index 6c0ff0f9..c01c8565 100644 --- a/class_u_s_b_device_config__inherit__graph.md5 +++ b/class_u_s_b_device_config__inherit__graph.md5 @@ -1 +1 @@ -58fed4c590771d3386dcf73496e9fd5a \ No newline at end of file +ba54b174687399479489b51a7249a07c \ No newline at end of file diff --git a/class_u_s_b_device_config__inherit__graph.png b/class_u_s_b_device_config__inherit__graph.png index fa7216585fcf9c045bf1a08993b89942d3d39da7..72ef651f9e2cd250df8b1833bd49a03e3afcbc35 100644 GIT binary patch delta 8885 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 delta 7656 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 EUwpZmNdN!< diff --git a/class_u_s_b_h_i_d.html b/class_u_s_b_h_i_d.html index b3c9fc86..1511f4ce 100644 --- a/class_u_s_b_h_i_d.html +++ b/class_u_s_b_h_i_d.html @@ -81,8 +81,9 @@ Inheritance diagram for USBHID:
- - + + +
[legend]
diff --git a/class_u_s_b_h_i_d__coll__graph.md5 b/class_u_s_b_h_i_d__coll__graph.md5 index b8d9dc3c..c75d9468 100644 --- a/class_u_s_b_h_i_d__coll__graph.md5 +++ b/class_u_s_b_h_i_d__coll__graph.md5 @@ -1 +1 @@ -55575cb1417a298be7b19ac4ba5cc390 \ No newline at end of file +2fff1d890aadada057b438fb5a7e92c2 \ No newline at end of file diff --git a/class_u_s_b_h_i_d__inherit__graph.map b/class_u_s_b_h_i_d__inherit__graph.map index 47877bbf..089241f8 100644 --- a/class_u_s_b_h_i_d__inherit__graph.map +++ b/class_u_s_b_h_i_d__inherit__graph.map @@ -4,6 +4,7 @@ - - + + + diff --git a/class_u_s_b_h_i_d__inherit__graph.md5 b/class_u_s_b_h_i_d__inherit__graph.md5 index bd49afc0..61ef41f8 100644 --- a/class_u_s_b_h_i_d__inherit__graph.md5 +++ b/class_u_s_b_h_i_d__inherit__graph.md5 @@ -1 +1 @@ -7bfb672c3c1e40e70ecb6fe55c14f1c7 \ No newline at end of file +48efb331de46d34d39981cc9ecb13ef5 \ No newline at end of file diff --git a/class_u_s_b_h_i_d__inherit__graph.png b/class_u_s_b_h_i_d__inherit__graph.png index 515b489b1d6cceeb2c43403fd4242e30730dac0b..a2a2c211d09a204b29ed2c68beb7c3e7f3b5fbe6 100644 GIT binary patch literal 16205 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 literal 14836 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 diff --git a/class_usb_config_xtracter.html b/class_usb_config_xtracter.html index b3f12b2f..69a3d8e0 100644 --- a/class_usb_config_xtracter.html +++ b/class_usb_config_xtracter.html @@ -79,14 +79,15 @@ Inheritance diagram for UsbConfigXtracter:
- + - - + + +
[legend]
diff --git a/class_usb_config_xtracter__inherit__graph.map b/class_usb_config_xtracter__inherit__graph.map index f6b1e283..a0df358a 100644 --- a/class_usb_config_xtracter__inherit__graph.map +++ b/class_usb_config_xtracter__inherit__graph.map @@ -5,12 +5,13 @@ - + - - + + + diff --git a/class_usb_config_xtracter__inherit__graph.md5 b/class_usb_config_xtracter__inherit__graph.md5 index 4a083d31..e8253759 100644 --- a/class_usb_config_xtracter__inherit__graph.md5 +++ b/class_usb_config_xtracter__inherit__graph.md5 @@ -1 +1 @@ -294766cf04c9d4f794492aadced45b07 \ No newline at end of file +446fe74447324181311c93aeec67e483 \ No newline at end of file diff --git a/class_usb_config_xtracter__inherit__graph.png b/class_usb_config_xtracter__inherit__graph.png index 44e0ab849e1d2dc6c3dcf1d6d7239469b05bcbb3..55dddaba47be6caddb6a022af0df594bde6e3371 100644 GIT binary patch literal 27897 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 LstTEBu6h0k5*Avg diff --git a/classes.html b/classes.html index 04ecb65b..645caa8c 100644 --- a/classes.html +++ b/classes.html @@ -66,50 +66,53 @@ $(function() {
a | b | c | e | f | h | i | k | l | m | p | r | s | t | u | w | x
- - - - - - + + + + + + + - - - - - + + + + + - - + + - - - - - - - - - - - - + + + + + + + + + + + + + + +
  a  
-		CommandBlockWrapperBase   KBDLEDS   PSBuzz   USB_DEVICE_DESCRIPTOR   
CommandStatusWrapper   KeyboardReportParser   PSBUZZButtons   USB_ENDPOINT_DESCRIPTOR   
ACM   ConfigDescParser   
  l  
-		PTPListParser   USB_HID_DESCRIPTOR   
ACM_FUNC_DESCR   
  e  
-
  r  
-		USB_INTERFACE_DESCRIPTOR   
AddressPool   LINE_CODING   UsbConfigXtracter   
AddressPoolImpl   EpInfo   
  m  
-		ReportDescParser   UsbDevice   
ADK   
  f  
-		ReportDescParser2   UsbDeviceAddress   
ConfigDescParser   
  m  
+		PS5Trigger   USB_DEVICE_DESCRIPTOR   
  e  
+		PS5USB   USB_ENDPOINT_DESCRIPTOR   
ACM   MainItemIOFeature   PSBuzz   USB_HID_DESCRIPTOR   
ACM_FUNC_DESCR   EpInfo   MAX3421e   PSBUZZButtons   USB_INTERFACE_DESCRIPTOR   
AddressPool   
  f  
+		Max_LCD   PTPListParser   UsbConfigXtracter   
AddressPoolImpl   MODIFIERKEYS   
  r  
+		UsbDevice   
ADK   FTDI   MOUSEINFO   UsbDeviceAddress   
  b  
-		MainItemIOFeature   ReportDescParserBase   USBDeviceConfig   
FTDI   MAX3421e   HIDComposite::ReportParser   USBH_MIDI   
BASICCDB   FTDIAsyncOper   Max_LCD   RequestSenseResponce   USBHID   
BluetoothService   
  h  
-		MODIFIERKEYS   
  s  
-		USBHub   
BTD   MOUSEINFO   USBReadParser   
BTHID   HexDumper   MouseReportParser   SETUP_PKT   
  w  
+		FTDIAsyncOper   MouseReportParser   ReportDescParser   USBDeviceConfig   
  h  
+		MultiByteValueParser   ReportDescParser2   USBH_MIDI   
BASICCDB   MultiValueBuffer   ReportDescParserBase   USBHID   
BluetoothService   HexDumper   
  p  
+		HIDComposite::ReportParser   USBHub   
BTD   HID_CLASS_DESCRIPTOR_LEN_AND_TYPE   RequestSenseResponce   USBReadParser   
BTHID   HIDBoot   PL2303   
  s  
+
  w  
BulkOnly   HID_CLASS_DESCRIPTOR_LEN_AND_TYPE   MultiByteValueParser   SinkParser   
ByteSkipper   HIDBoot   MultiValueBuffer   SPi   WII   
BulkOnly   HIDComposite   PS3BT   
ByteSkipper   HIDComposite::HIDInterface   PS3USB   SETUP_PKT   WII   
  c  
-		HIDComposite   
  p  
-		SPP   
  x  
+		HidItemPrefix   PS4BT   SinkParser   
  x  
HIDComposite::HIDInterface   
  t  
-
CALL_MGMNT_FUNC_DESCR   HidItemPrefix   PL2303   XBOXOLD   
Capacity   HIDReportParser   PS3BT   TEL_RINGER_FUNC_DESCR   XBOXONE   
CDB10   HIDUniversal   PS3USB   touchpadXY   XBOXONESBT   
CDB12   HubDescriptor   PS4BT   tty_features   XboxOneSButtons   
CDB6   HubEvent   PS4Buttons   
  u  
-		XboxOneSData   
CDB_LBA32_16   
  i  
-		PS4Data   XBOXONESParser   
CDB_LBA64_16   PS4Output   UHS2_GPIO   XBOXRECV   
CDCAsyncOper   InquiryResponse   PS4Parser   UniversalReportParser   XBOXUSB   
CLASS_NOTIFICATION   
  k  
-		PS4Status   USB   XR21B1411   
CommandBlockWrapper   PS4USB   USB_CONFIGURATION_DESCRIPTOR   
KBDINFO   
HIDReportParser   PS4Buttons   SPi   
CALL_MGMNT_FUNC_DESCR   HIDUniversal   PS4Data   SPP   XBOXOLD   
Capacity   HubDescriptor   PS4Output   
  t  
+		XBOXONE   
CDB10   HubEvent   PS4Parser   XBOXONESBT   
CDB12   
  i  
+		PS4Status   TEL_RINGER_FUNC_DESCR   XboxOneSButtons   
CDB6   PS4USB   touchpadXY   XboxOneSData   
CDB_LBA32_16   InquiryResponse   PS5BT   tty_features   XBOXONESParser   
CDB_LBA64_16   
  k  
+		PS5Buttons   
  u  
+		XBOXRECV   
CDCAsyncOper   PS5Data   XBOXUSB   
CLASS_NOTIFICATION   KBDINFO   PS5Output   UHS2_GPIO   XR21B1411   
CommandBlockWrapper   KBDLEDS   PS5Parser   UniversalReportParser   
CommandBlockWrapperBase   KeyboardReportParser   PS5Status   USB   
CommandStatusWrapper   
  l  
+		ps5TouchpadXY   USB_CONFIGURATION_DESCRIPTOR   
LINE_CODING   
a | b | c | e | f | h | i | k | l | m | p | r | s | t | u | w | x
diff --git a/controller_enums_8h.html b/controller_enums_8h.html index 96bee170..0fbae403 100644 --- a/controller_enums_8h.html +++ b/controller_enums_8h.html @@ -72,11 +72,12 @@ This graph shows which files directly or indirectly include this file: - - - - - + + + + + + @@ -84,17 +85,20 @@ This graph shows which files directly or indirectly include this file: - - - - - - - - - - - + + + + + + + + + + + + + + @@ -200,7 +204,9 @@ Enumerations GREEN = 2, ORANGE = 3,
-  BLUE = 4 +  BLUE = 4, +CREATE = 4, +MICROPHONE = 18
}   @@ -428,10 +434,18 @@ Enumerations RED 

PS Buzz controllers

-YELLOW  -GREEN  -ORANGE  -BLUE  +YELLOW 

PS Buzz controllers

+ +GREEN 

PS Buzz controllers

+ +ORANGE 

PS Buzz controllers

+ +BLUE 

PS Buzz controllers

+ +CREATE 

PS5 buttons

+ +MICROPHONE 

PS5 buttons

+

Definition at line 78 of file controllerEnums.h.

@@ -461,7 +475,7 @@ Enumerations -

Definition at line 163 of file controllerEnums.h.

+

Definition at line 170 of file controllerEnums.h.

@@ -508,7 +522,7 @@ Enumerations -

Definition at line 178 of file controllerEnums.h.

+

Definition at line 185 of file controllerEnums.h.

@@ -529,7 +543,7 @@ Enumerations Roll  -

Definition at line 211 of file controllerEnums.h.

+

Definition at line 218 of file controllerEnums.h.

diff --git a/controller_enums_8h__dep__incl.map b/controller_enums_8h__dep__incl.map index 24accfbc..6ba6f28a 100644 --- a/controller_enums_8h__dep__incl.map +++ b/controller_enums_8h__dep__incl.map @@ -1,11 +1,12 @@ - - - - - + + + + + + @@ -13,15 +14,18 @@ - - - - - - - - - - - + + + + + + + + + + + + + + diff --git a/controller_enums_8h__dep__incl.md5 b/controller_enums_8h__dep__incl.md5 index cc839815..ba8cdb9e 100644 --- a/controller_enums_8h__dep__incl.md5 +++ b/controller_enums_8h__dep__incl.md5 @@ -1 +1 @@ -2e296c5175604ba0c5623d3e39b3d337 \ No newline at end of file +02423e448b3a5b8660f72ad29baeb536 \ No newline at end of file diff --git a/controller_enums_8h__dep__incl.png b/controller_enums_8h__dep__incl.png index 9a37cf5d045ad7e7971dd9e00407cdb8dc0aee75..4d0cd8ec1fcbdb65958aae95076d9c573697f6d8 100644 GIT binary patch literal 48877 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 XgEaNk{y}00?MF3bO{HQ5%SZnMwfX+( literal 45011 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�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�c!DSEEF-SbMP*i@hbU1O;}fxOk}`@OIk3 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 diff --git a/controller_enums_8h_source.html b/controller_enums_8h_source.html index d5a42900..d0b92110 100644 --- a/controller_enums_8h_source.html +++ b/controller_enums_8h_source.html @@ -63,36 +63,36 @@ $(function() {
controllerEnums.h
-Go to the documentation of this file.
1 /* Copyright (C) 2013 Kristian Lauszus, TKJ Electronics. All rights reserved.
2 
3  This software may be distributed and modified under the terms of the GNU
4  General Public License version 2 (GPL2) as published by the Free Software
5  Foundation and appearing in the file GPL2.TXT included in the packaging of
6  this file. Please note that GPL2 Section 2[b] requires that all works based
7  on this software must also be made publicly available under the terms of
8  the GPL2 ("Copyleft").
9 
10  Contact information
11  -------------------
12 
13  Kristian Lauszus, TKJ Electronics
14  Web : http://www.tkjelectronics.com
15  e-mail : kristianl@tkjelectronics.com
16  */
17 
18 #ifndef _controllerenums_h
19 #define _controllerenums_h
20 
21 #if defined(ESP32)
22 #undef PS
23 #endif
24 
31 enum LEDEnum {
32  OFF = 0,
33 #ifndef RBL_NRF51822
34  LED1 = 1,
35  LED2 = 2,
36  LED3 = 3,
37  LED4 = 4,
38 #endif
39  LED5 = 5,
40  LED6 = 6,
41  LED7 = 7,
42  LED8 = 8,
43  LED9 = 9,
44  LED10 = 10,
46  ALL = 5,
47 };
48 
50 enum ColorsEnum {
52  Red = 0xFF0000,
54  Green = 0xFF00,
56  Blue = 0xFF,
57 
59  Yellow = 0xFFEB04,
61  Lightblue = 0xFFFF,
63  Purple = 0xFF00FF,
64  Purble = 0xFF00FF,
65 
67  White = 0xFFFFFF,
69  Off = 0x00,
70 };
71 
72 enum RumbleEnum {
73  RumbleHigh = 0x10,
74  RumbleLow = 0x20,
75 };
76 
78 enum ButtonEnum {
81  UP = 0,
82  RIGHT = 1,
83  DOWN = 2,
84  LEFT = 3,
89  PLUS = 5,
90  TWO = 6,
91  ONE = 7,
92  MINUS = 8,
93  HOME = 9,
94  Z = 10,
95  C = 11,
96  B = 12,
97  A = 13,
102  L = 16,
103  R = 17,
104  ZL = 18,
105  ZR = 19,
110  SELECT = 4,
111  START = 5,
112  L3 = 6,
113  R3 = 7,
114 
115  L2 = 8,
116  R2 = 9,
117  L1 = 10,
118  R1 = 11,
119  TRIANGLE = 12,
120  CIRCLE = 13,
121  CROSS = 14,
122  SQUARE = 15,
123 
124  PS = 16,
125 
126  MOVE = 17, // Covers 12 bits - we only need to read the top 8
127  T = 18, // Covers 12 bits - we only need to read the top 8
131  SHARE = 4,
132  OPTIONS = 5,
133  TOUCHPAD = 17,
138  BACK = 4,
139  X = 14,
140  Y = 15,
141  XBOX = 16,
142  SYNC = 17,
143  BLACK = 8, // Available on the original Xbox controller
144  WHITE = 9, // Available on the original Xbox controller
149  VIEW = 4,
150  MENU = 5,
154  RED = 0,
155  YELLOW = 1,
156  GREEN = 2,
157  ORANGE = 3,
158  BLUE = 4,
160 };
161 
163 enum AnalogHatEnum {
165  LeftHatX = 0,
167  LeftHatY = 1,
169  RightHatX = 2,
171  RightHatY = 3,
172 };
173 
178 enum SensorEnum {
180  aX = 50, aY = 52, aZ = 54,
182  gZ = 56,
183  gX, gY, // These are not available on the PS3 controller
184 
186  aXmove = 28,
188  aZmove = 30,
190  aYmove = 32,
191 
193  gXmove = 40,
195  gZmove = 42,
197  gYmove = 44,
198 
200  tempMove = 46,
201 
203  mXmove = 47,
205  mZmove = 49,
207  mYmove = 50,
208 };
209 
211 enum AngleEnum {
212  Pitch = 0x01,
213  Roll = 0x02,
214 };
215 
216 #endif
- +Go to the documentation of this file.
1 /* Copyright (C) 2013 Kristian Lauszus, TKJ Electronics. All rights reserved.
2 
3  This software may be distributed and modified under the terms of the GNU
4  General Public License version 2 (GPL2) as published by the Free Software
5  Foundation and appearing in the file GPL2.TXT included in the packaging of
6  this file. Please note that GPL2 Section 2[b] requires that all works based
7  on this software must also be made publicly available under the terms of
8  the GPL2 ("Copyleft").
9 
10  Contact information
11  -------------------
12 
13  Kristian Lauszus, TKJ Electronics
14  Web : http://www.tkjelectronics.com
15  e-mail : kristianl@tkjelectronics.com
16  */
17 
18 #ifndef _controllerenums_h
19 #define _controllerenums_h
20 
21 #if defined(ESP32)
22 #undef PS
23 #endif
24 
31 enum LEDEnum {
32  OFF = 0,
33 #ifndef RBL_NRF51822
34  LED1 = 1,
35  LED2 = 2,
36  LED3 = 3,
37  LED4 = 4,
38 #endif
39  LED5 = 5,
40  LED6 = 6,
41  LED7 = 7,
42  LED8 = 8,
43  LED9 = 9,
44  LED10 = 10,
46  ALL = 5,
47 };
48 
50 enum ColorsEnum {
52  Red = 0xFF0000,
54  Green = 0xFF00,
56  Blue = 0xFF,
57 
59  Yellow = 0xFFEB04,
61  Lightblue = 0xFFFF,
63  Purple = 0xFF00FF,
64  Purble = 0xFF00FF,
65 
67  White = 0xFFFFFF,
69  Off = 0x00,
70 };
71 
72 enum RumbleEnum {
73  RumbleHigh = 0x10,
74  RumbleLow = 0x20,
75 };
76 
78 enum ButtonEnum {
81  UP = 0,
82  RIGHT = 1,
83  DOWN = 2,
84  LEFT = 3,
89  PLUS = 5,
90  TWO = 6,
91  ONE = 7,
92  MINUS = 8,
93  HOME = 9,
94  Z = 10,
95  C = 11,
96  B = 12,
97  A = 13,
102  L = 16,
103  R = 17,
104  ZL = 18,
105  ZR = 19,
110  SELECT = 4,
111  START = 5,
112  L3 = 6,
113  R3 = 7,
114 
115  L2 = 8,
116  R2 = 9,
117  L1 = 10,
118  R1 = 11,
119  TRIANGLE = 12,
120  CIRCLE = 13,
121  CROSS = 14,
122  SQUARE = 15,
123 
124  PS = 16,
125 
126  MOVE = 17, // Covers 12 bits - we only need to read the top 8
127  T = 18, // Covers 12 bits - we only need to read the top 8
131  SHARE = 4,
132  OPTIONS = 5,
133  TOUCHPAD = 17,
138  BACK = 4,
139  X = 14,
140  Y = 15,
141  XBOX = 16,
142  SYNC = 17,
143  BLACK = 8, // Available on the original Xbox controller
144  WHITE = 9, // Available on the original Xbox controller
149  VIEW = 4,
150  MENU = 5,
155  RED = 0,
156  YELLOW = 1,
157  GREEN = 2,
158  ORANGE = 3,
159  BLUE = 4,
164  CREATE = 4,
165  MICROPHONE = 18,
167 };
168 
170 enum AnalogHatEnum {
172  LeftHatX = 0,
174  LeftHatY = 1,
176  RightHatX = 2,
178  RightHatY = 3,
179 };
180 
185 enum SensorEnum {
187  aX = 50, aY = 52, aZ = 54,
189  gZ = 56,
190  gX, gY, // These are not available on the PS3 controller
191 
193  aXmove = 28,
195  aZmove = 30,
197  aYmove = 32,
198 
200  gXmove = 40,
202  gZmove = 42,
204  gYmove = 44,
205 
207  tempMove = 46,
208 
210  mXmove = 47,
212  mZmove = 49,
214  mYmove = 50,
215 };
216 
218 enum AngleEnum {
219  Pitch = 0x01,
220  Roll = 0x02,
221 };
222 
223 #endif
+ - + - - + + - + -
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:163
+
AnalogHatEnum
AnalogHatEnum
Definition: controllerEnums.h:170
- + - - + + - + - +
LEDEnum
LEDEnum
Definition: controllerEnums.h:31
@@ -100,22 +100,23 @@ $(function() {
RumbleEnum
RumbleEnum
Definition: controllerEnums.h:72
- + + - - - + + + - +
ButtonEnum
ButtonEnum
Definition: controllerEnums.h:78
- - + + @@ -125,21 +126,22 @@ $(function() { - - + +
ColorsEnum
ColorsEnum
Definition: controllerEnums.h:50
- + - -
AngleEnum
AngleEnum
Definition: controllerEnums.h:211
+ + +
AngleEnum
AngleEnum
Definition: controllerEnums.h:218
- + @@ -152,15 +154,15 @@ $(function() { - - -
SensorEnum
SensorEnum
Definition: controllerEnums.h:178
+ + +
SensorEnum
SensorEnum
Definition: controllerEnums.h:185
- + - - + + diff --git a/files.html b/files.html index b314a375..a4eac75b 100644 --- a/files.html +++ b/files.html @@ -114,40 +114,46 @@ $(function() {  PS4Parser.cpp  PS4Parser.h  PS4USB.h - PSBuzz.cpp - PSBuzz.h - settings.h - sink_parser.h - SPP.cpp - SPP.h - UHS2_gpio.cpp - UHS2_gpio.h - Usb.cpp - Usb.h - usb_ch9.h - UsbCore.h - usbh_midi.cpp - usbh_midi.h - usbhid.cpp - usbhid.h - usbhost.h - usbhub.cpp - usbhub.h - version_helper.h - Wii.cpp - Wii.h - xboxEnums.h - XBOXOLD.cpp - XBOXOLD.h - XBOXONE.cpp - XBOXONE.h - XBOXONESBT.h - XBOXONESParser.cpp - XBOXONESParser.h - XBOXRECV.cpp - XBOXRECV.h - XBOXUSB.cpp - XBOXUSB.h + PS5BT.h + PS5Parser.cpp + PS5Parser.h + PS5Trigger.cppBased on Ludwig Füchsl's DualSense Windows driver https://github.com/Ohjurot/DualSense-Windows + PS5Trigger.hBased on Ludwig Füchsl's DualSense Windows driver https://github.com/Ohjurot/DualSense-Windows + PS5USB.h + PSBuzz.cpp + PSBuzz.h + settings.h + sink_parser.h + SPP.cpp + SPP.h + UHS2_gpio.cpp + UHS2_gpio.h + Usb.cpp + Usb.h + usb_ch9.h + UsbCore.h + usbh_midi.cpp + usbh_midi.h + usbhid.cpp + usbhid.h + usbhost.h + usbhub.cpp + usbhub.h + version_helper.h + Wii.cpp + Wii.h + xboxEnums.h + XBOXOLD.cpp + XBOXOLD.h + XBOXONE.cpp + XBOXONE.h + XBOXONESBT.h + XBOXONESParser.cpp + XBOXONESParser.h + XBOXRECV.cpp + XBOXRECV.h + XBOXUSB.cpp + XBOXUSB.h
diff --git a/functions_a.html b/functions_a.html index ae46aef7..951de0ac 100644 --- a/functions_a.html +++ b/functions_a.html @@ -82,6 +82,7 @@ $(function() {
  • accX : PS4Data +, PS5Data
  • accXnunchuck : WII @@ -91,6 +92,7 @@ $(function() {
  • accY : PS4Data +, PS5Data
  • accYnunchuck : WII @@ -100,6 +102,7 @@ $(function() {
  • accZ : PS4Data +, PS5Data
  • accZnunchuck : WII @@ -180,6 +183,7 @@ $(function() { : BluetoothService , PS3USB , PS4USB +, PS5USB , PSBuzz , XBOXOLD , XBOXONE diff --git a/functions_b.html b/functions_b.html index 656faba2..9dd91d9f 100644 --- a/functions_b.html +++ b/functions_b.html @@ -64,6 +64,7 @@ $(function() {

    - b -

    • diff --git a/functions_func_o.html b/functions_func_o.html index fe43341e..9c851105 100644 --- a/functions_func_o.html +++ b/functions_func_o.html @@ -85,11 +85,13 @@ $(function() {
  • OnInitBTHID() : BTHID , PS4BT +, PS5BT , XBOXONESBT
  • OnInitSuccessful() : HIDComposite , PS4USB +, PS5USB , PSBuzz
  • OnKeyDown() diff --git a/functions_func_p.html b/functions_func_p.html index 62775637..dce6103a 100644 --- a/functions_func_p.html +++ b/functions_func_p.html @@ -80,6 +80,7 @@ $(function() { , MouseReportParser , MultiByteValueParser , PS4Parser +, PS5Parser , PTPListParser , ReportDescParserBase , SinkParser< BASE_CLASS, LEN_TYPE, OFFSET_TYPE > @@ -93,6 +94,7 @@ $(function() {
  • ParseBTHIDData() : BTHID , PS4BT +, PS5BT , XBOXONESBT
  • parseConfigDescr() @@ -102,6 +104,7 @@ $(function() { : HIDComposite , HIDUniversal , PS4USB +, PS5USB , PSBuzz
  • ParseItem() @@ -203,6 +206,9 @@ $(function() {
  • PrintVRControlsPageUsage() : ReportDescParserBase
    • +
  • processTrigger() +: PS5Trigger +
  • PS3BT() : PS3BT
    • @@ -218,6 +224,15 @@ $(function() {
  • PS4USB() : PS4USB
    • +
  • PS5BT() +: PS5BT +
    • +
  • PS5Parser() +: PS5Parser +
    • +
  • PS5USB() +: PS5USB +
  • PSBuzz() : PSBuzz
    • diff --git a/functions_func_r.html b/functions_func_r.html index 42d7a4db..ce7b4a41 100644 --- a/functions_func_r.html +++ b/functions_func_r.html @@ -69,7 +69,7 @@ $(function() { , USBH_MIDI
  • Read() -: BulkOnly +: BulkOnly
  • read() : SPP @@ -135,6 +135,8 @@ $(function() {
  • Reset() : PS3BT , PS4Parser +, PS5Parser +, PS5Trigger , PSBuzz , SPP , WII @@ -143,6 +145,7 @@ $(function() {
  • ResetBTHID() : BTHID , PS4BT +, PS5BT , XBOXONESBT
  • ResetHubPort() diff --git a/functions_func_s.html b/functions_func_s.html index 43bda504..2f7f5ee5 100644 --- a/functions_func_s.html +++ b/functions_func_s.html @@ -90,6 +90,9 @@ $(function() { : PS4BT , PS4Parser , PS4USB +, PS5BT +, PS5Parser +, PS5USB
  • SendRawData() : USBH_MIDI @@ -104,6 +107,7 @@ $(function() { : PS3BT , PS3USB , PS4Parser +, PS5Parser , WII , XBOXRECV , XBOXUSB @@ -152,6 +156,7 @@ $(function() {
  • setLed() : PS4Parser +, PS5Parser
  • setLedBlink() : XBOXRECV @@ -168,6 +173,7 @@ $(function() { : PS3BT , PS3USB , PS4Parser +, PS5Parser , PSBuzz , WII , XBOXRECV @@ -210,6 +216,12 @@ $(function() {
  • SetLineCoding() : ACM
    • +
  • setMicLed() +: PS5Parser +
    • +
  • setMicLedOff() +: PS5Parser +
  • SetModemControl() : FTDI
    • @@ -219,6 +231,12 @@ $(function() {
  • SetOR() : ConfigDescParser< CLASS_ID, SUBCLASS_ID, PROTOCOL_ID, MASK >
    • +
  • setPlayerLed() +: PS5Parser +
    • +
  • setPlayerLedOff() +: PS5Parser +
  • SetPortFeature() : USBHub
    • @@ -241,6 +259,7 @@ $(function() { : PS3BT , PS3USB , PS4Parser +, PS5Parser , WII , XBOXOLD , XBOXONE @@ -249,8 +268,9 @@ $(function() {
  • setRumbleOn() : PS3BT -, PS3USB -, PS4Parser +, PS3USB +, PS4Parser +, PS5Parser , WII , XBOXOLD , XBOXONE @@ -260,6 +280,15 @@ $(function() {
  • setRumbleToggle() : WII
    • +
  • setTriggerForce() +: PS5Trigger +
    • +
  • setTriggerForceEffect() +: PS5Trigger +
    • +
  • setTriggerForceSection() +: PS5Trigger +
  • setupDeviceSpecific() : USBH_MIDI
    • diff --git a/functions_func_v.html b/functions_func_v.html index 0a8378f1..d1e6fa56 100644 --- a/functions_func_v.html +++ b/functions_func_v.html @@ -71,6 +71,7 @@ $(function() { , FTDI , PS3USB , PS4USB +, PS5USB , PSBuzz , USBDeviceConfig , XBOXOLD diff --git a/functions_func_w.html b/functions_func_w.html index 2a49e15e..c0bd16b1 100644 --- a/functions_func_w.html +++ b/functions_func_w.html @@ -73,7 +73,7 @@ $(function() {
  • write() : Max_LCD -, SPP +, SPP
  • write_register() : XR21B1411 diff --git a/functions_g.html b/functions_g.html index 03818d59..c3556b48 100644 --- a/functions_g.html +++ b/functions_g.html @@ -64,6 +64,7 @@ $(function() {

    - g -

    diff --git a/functions_h.html b/functions_h.html index af4d6162..dca7c733 100644 --- a/functions_h.html +++ b/functions_h.html @@ -72,6 +72,7 @@ $(function() {
  • hatValue : PS4Data +, PS5Data , XboxOneSData
  • hci_accept_connection() @@ -150,6 +151,9 @@ $(function() {
  • hci_write_simple_pairing_mode() : BTD
    • +
  • headphone +: PS5Status +
  • HexDumper() : HexDumper< BASE_CLASS, LEN_TYPE, OFFSET_TYPE >
    • diff --git a/functions_i.html b/functions_i.html index f73f4ad6..652cfdd3 100644 --- a/functions_i.html +++ b/functions_i.html @@ -171,6 +171,7 @@ $(function() {
  • isTouching() : PS4Parser +, PS5Parser
  • itemParseState : ReportDescParserBase diff --git a/functions_l.html b/functions_l.html index 8b142587..b1e755a6 100644 --- a/functions_l.html +++ b/functions_l.html @@ -64,10 +64,12 @@ $(function() {

    - l -