হোস্ট কন্ট্রোলার ইন্টারফেস (HCI) একটি ব্লুটুথ কন্ট্রোলারের সাথে ইন্টারঅ্যাক্ট করার জন্য ব্যবহৃত হয়।
এই নথিতে ব্লুটুথ (BT) এবং ব্লুটুথ লো এনার্জি (BLE) HCI প্রয়োজনীয়তার একটি তালিকা রয়েছে। লক্ষ্য হল হোস্ট BT স্ট্যাক বিক্রেতা এবং BT কন্ট্রোলার বিক্রেতাদের নীচে বর্ণিত বৈশিষ্ট্য সেটটি ব্যবহার করার জন্য এই প্ল্যাটফর্ম প্রয়োজনীয়তাগুলি মেনে চলা।
এই নথিতে ব্লুটুথ কোর ৫.২ স্পেসিফিকেশনকে "স্পেক" হিসেবে উল্লেখ করা হয়েছে। ব্লুটুথ কোর ৫.২ স্পেসিফিকেশনটি ব্লুটুথ এসআইজি ওয়েবসাইটে অন্যান্য গৃহীত নথির সাথে পাওয়া যায়।
সাধারণ নকশা ওভারভিউ
চিপ ক্ষমতা এবং কনফিগারেশন
একটি উন্মুক্ত প্ল্যাটফর্ম হিসেবে, অ্যান্ড্রয়েডের সফ্টওয়্যার রিলিজ, OEM, বিক্রেতা এবং প্ল্যাটফর্ম এবং চিপ ক্ষমতার একটি ম্যাট্রিক্স রয়েছে।
বিভিন্ন ধরণের ভূদৃশ্য পরিচালনা এবং স্থানান্তর পরিচালনা করার জন্য, এই নথিতে BT কন্ট্রোলারদের তাদের ক্ষমতা (স্ট্যান্ডার্ড ব্লুটুথ কোর 5.2 স্পেসিফিকেশনের বাইরে) প্রকাশ করার অনুমতি দেওয়ার একটি নকশা দর্শন বর্ণনা করা হয়েছে। হোস্ট BT স্ট্যাক তারপর এই ক্ষমতাগুলি ব্যবহার করে কোন বৈশিষ্ট্যগুলি সক্ষম করতে হবে তা নির্ধারণ করতে পারে।
উন্মুক্ত মান সমর্থন করুন
অ্যান্ড্রয়েডের একটি লক্ষ্য হল ব্লুটুথ স্পেসিফিকেশনে অনুমোদনের পর ওপেন স্ট্যান্ডার্ডগুলিকে সমর্থন করা। যদি ভবিষ্যতের ব্লুটুথ স্পেসিফিকেশনে স্ট্যান্ডার্ড HCI পদ্ধতিতে নীচে বর্ণিত কোনও বৈশিষ্ট্য উপলব্ধ হয়, তাহলে আমরা সেই পদ্ধতিটিকে ডিফল্ট করার দিকে ঝুঁকব।
বিক্রেতা-নির্দিষ্ট ক্ষমতা
বিক্রেতা-নির্দিষ্ট কমান্ড: LE_Get_Vendor_Capabilities_Command
অপকোড কমান্ড ফিল্ড (OCF): 0x153
| কমান্ড প্যারামিটার | আকার | উদ্দেশ্য |
|---|---|---|
| এন.এ. | খালি কমান্ড প্যারামিটার তালিকা |
এই কমান্ডের জন্য একটি Command Complete ইভেন্ট তৈরি করা হবে।
| প্যারামিটার ফেরত দিন | আকার | উদ্দেশ্য |
|---|---|---|
Status | ১ অক্টেট | কমান্ড সম্পূর্ণ অবস্থা |
max_advt_instances(অবঞ্চিত) | ১ অক্টেট | সমর্থিত বিজ্ঞাপনের সংখ্যা। v0.98 এর পরে সংরক্ষিত। এই প্যারামিটারটি Google ফিচার স্পেক v0.98 এবং উচ্চতর সংস্করণে অবচিত, যা BT স্পেক সংস্করণ 5.0 এবং উচ্চতর সংস্করণে উপলব্ধ LE এক্সটেন্ডেড অ্যাডভারটাইজিংয়ের পক্ষে। |
offloaded_resolution_of_private-address(অবঞ্চিত) | ১ অক্টেট | RPA এর BT চিপ ক্ষমতা। যদি একটি চিপ দ্বারা সমর্থিত হয়, তাহলে এটি হোস্ট দ্বারা সক্রিয়করণের প্রয়োজন। ০ = সক্ষম নয় ১ = সক্ষম v0.98 এর পরে সংরক্ষিত। এই প্যারামিটারটি Google ফিচার স্পেক v0.98 এবং উচ্চতর সংস্করণে অবচিত, যা BT স্পেক সংস্করণ 4.2 এবং উচ্চতর সংস্করণে উপলব্ধ গোপনীয়তা বৈশিষ্ট্যের পক্ষে। |
total_scan_results_storage | ২ অক্টেট | স্ক্যান ফলাফলের জন্য বাইটে স্টোরেজ |
max_irk_list_sz | ১ অক্টেট | ফার্মওয়্যারে সমর্থিত IRK এন্ট্রির সংখ্যা |
filtering_support | ১ অক্টেট | কন্ট্রোলারে ফিল্টারিংয়ের জন্য সমর্থন ০ = সমর্থিত নয় ১ = সমর্থিত |
max_filter | ১ অক্টেট | সমর্থিত ফিল্টারের সংখ্যা |
activity_energy_info_support | ১ অক্টেট | কার্যকলাপ এবং শক্তি তথ্যের প্রতিবেদন সমর্থন করে ০ = সক্ষম নয় ১ = সক্ষম |
version_supported | ২ অক্টেট | সমর্থিত Google বৈশিষ্ট্যের নির্দিষ্টকরণের সংস্করণ নির্দিষ্ট করে বাইট[0] = মেজর সংখ্যা বাইট[1] = ক্ষুদ্র সংখ্যা v1.05 সম্পর্কে বাইট[0] = 0x01 বাইট[1] = 0x05 নিম্নলিখিত সংস্করণগুলিতে বৈশিষ্ট্য সংযোজন: সংস্করণ ১.০৫:
|
total_num_of_advt_tracked | ২ অক্টেট | OnLost / OnFound এর জন্য ট্র্যাক করা মোট বিজ্ঞাপনদাতার সংখ্যা |
extended_scan_support | ১ অক্টেট | বর্ধিত স্ক্যান উইন্ডো এবং ব্যবধান সমর্থন করে |
debug_logging_supported | ১ অক্টেট | কন্ট্রোলার থেকে বাইনারি ডিবাগ তথ্য লগিং সমর্থন করে |
LE_address_generation_offloading_support(অবঞ্চিত) | ১ অক্টেট | ০ = সমর্থিত নয় ১ = সমর্থিত v0.98 এর পরে সংরক্ষিত। এই প্যারামিটারটি Google ফিচার স্পেক v0.98 এবং উচ্চতর সংস্করণে অবচিত, যা BT স্পেক সংস্করণ 4.2 এবং উচ্চতর সংস্করণে উপলব্ধ গোপনীয়তা বৈশিষ্ট্যের পক্ষে। |
A2DP_source_offload_capability_mask | ৪ অক্টেট | কোডেক ধরণের জন্য বিট মাস্ক সমর্থিত বিট ০ - এসবিসি বিট ১ - AAC বিট ২ - APTX বিট ৩ - APTX HD বিট ৪ - এলডিএসি বিট ৫-৩১ সংরক্ষিত আছে |
bluetooth_quality_report_support | ১ অক্টেট | ব্লুটুথ মানের ইভেন্টের রিপোর্টিং সমর্থন করে ০ = সক্ষম নয় ১ = সক্ষম |
dynamic_audio_buffer_support | ৪ অক্টেট | ব্লুটুথ কন্ট্রোলারে ডায়নামিক অডিও বাফার সমর্থন করে কোডেক ধরণের জন্য বিট মাস্ক সমর্থিত বিট ০ - এসবিসি বিট ১ - AAC বিট ২ - APTX বিট ৩ - APTX HD বিট ৪ - এলডিএসি বিট ৫-৩১ সংরক্ষিত আছে |
a2dp_offload_v2_support | ১ অক্টেট | ব্লুটুথ কন্ট্রোলারে A2DP অফলোড v2 কমান্ড সমর্থন করে ( A2DP অফলোড শুরু করুন , A2DP অফলোড বন্ধ করুন দেখুন) ০ = সমর্থিত নয় ১ = সমর্থিত |
iso_link_feedback_support | ১ অক্টেট | ISO লিঙ্ক ফিডব্যাক ইভেন্ট সমর্থন করে ০ = সমর্থিত নয় ১ = সমর্থিত |
sniff_offload_support | ১ অক্টেট | ব্লুটুথ কন্ট্রোলারে স্নিফ অফলোড কমান্ড সমর্থন করে ০ = সমর্থিত নয় ১ = সমর্থিত |
ব্যাচ স্ক্যান ফলাফল
একটি ডিজাইনের লক্ষ্য হল হোস্টে বিদ্যুৎ সাশ্রয় করার জন্য ব্লুটুথ LE স্ক্যান রেসপন্স ইভেন্টের বিজ্ঞপ্তিগুলি হোস্টে কীভাবে সরবরাহ করা হয় তা উন্নত করা।
কন্ট্রোলার হোস্ট অ্যাপ প্রসেসরকে ফলাফল স্ক্যান করার জন্য কতবার অবহিত করে তা কমিয়ে, হোস্ট অ্যাপ প্রসেসরটি বেশিক্ষণ নিষ্ক্রিয়/ঘুমন্ত অবস্থায় থাকতে পারে। এটি হোস্টে বিদ্যুৎ খরচ কমায়। LE_Get_Vendor_Capabilities_Command এর রিটার্ন প্যারামিটার total_scan_results_storage স্ক্যান ফলাফল সংরক্ষণের জন্য চিপের ক্ষমতা নির্দেশ করে।
এই বৈশিষ্ট্যটি ব্লুটুথ কন্ট্রোলারে LE স্ক্যান ফলাফল স্টোরেজ সুবিধার ব্যবস্থাপনা এবং কনফিগারেশনের উপর দৃষ্টি নিবদ্ধ করে। স্টোরেজটি অস্থায়ীভাবে বিজ্ঞাপনের ডেটা ব্যাচ করতে এবং হোস্টে পরবর্তীতে ডেলিভারির জন্য কন্ট্রোলার দ্বারা প্রাপ্ত ডেটা এবং মেটাডেটা স্ক্যান করতে ব্যবহৃত হয়।
ফার্মওয়্যার দুটি ধরণের ব্যাচিং সমর্থন করবে, যা একই সাথে নিযুক্ত করা যেতে পারে:
- ছাঁটা। নিম্নলিখিত তথ্য উপাদানগুলি রয়েছে: {MAC, TX Power, RSSI, Timestamp}
- সম্পূর্ণ। নিম্নলিখিত তথ্য উপাদানগুলি রয়েছে: {MAC, TX Power, RSSI, টাইমস্ট্যাম্প, অ্যাডভান্স ডেটা, স্ক্যান রেসপন্স}
LE_Batch_Scan_Command সম্পর্কে
ওসিএফ: ০x১৫৬
| কমান্ড প্যারামিটার | আকার | উদ্দেশ্য |
|---|---|---|
Batch_Scan_opcode | ১ অক্টেট | 0x1 - গ্রাহক-নির্দিষ্ট বৈশিষ্ট্য সক্ষম করুন 0x2 - ব্যাচ স্ক্যান স্টোরেজ প্যারামিটার সেট করুন 0x3 - ব্যাচ স্ক্যান প্যারামিটার সেট করুন 0x4 - ব্যাচ স্ক্যান ফলাফলের প্যারামিটার পড়ুন |
এই কমান্ডের জন্য একটি কমান্ড কমপ্লিট ইভেন্ট তৈরি করা হবে। গ্রাহক-নির্দিষ্ট বৈশিষ্ট্যটি সক্ষম করলে স্ক্যান শুরু হয় না।
| প্যারামিটার ফেরত দিন | আকার | উদ্দেশ্য |
|---|---|---|
Status | ১ অক্টেট | কমান্ড সম্পূর্ণ অবস্থা |
Batch_Scan_opcode | ১ অক্টেট | 0x1 - গ্রাহক-নির্দিষ্ট বৈশিষ্ট্য সক্ষম করুন 0x2 - ব্যাচ স্ক্যান স্টোরেজ প্যারামিটার সেট করুন 0x3 - ব্যাচ স্ক্যান প্যারামিটার সেট করুন 0x4 - ব্যাচ স্ক্যান ফলাফলের প্যারামিটার পড়ুন |
LE_Batch_Scan_Command: গ্রাহক-নির্দিষ্ট বৈশিষ্ট্য সক্ষম করুন
সাব ওসিএফ: ০x০১
| সাবকমান্ড প্যারামিটার | আকার | উদ্দেশ্য |
|---|---|---|
enable_customer_specific_feature_set | ১ অক্টেট | 0x01 - ব্যাচ স্ক্যান বৈশিষ্ট্য সক্ষম করুন 0x00 - ব্যাচ স্ক্যান বৈশিষ্ট্যটি অক্ষম করুন |
এই কমান্ডের জন্য একটি Command Complete ইভেন্ট তৈরি করা হবে।
| প্যারামিটার ফেরত দিন | আকার | উদ্দেশ্য |
|---|---|---|
Status | ১ অক্টেট | কমান্ড সম্পূর্ণ অবস্থা |
Batch_Scan_opcode | ১ অক্টেট | 0x1 - গ্রাহক-নির্দিষ্ট বৈশিষ্ট্য সক্ষম করুন 0x2 - ব্যাচ স্ক্যান স্টোরেজ প্যারামিটার সেট করুন 0x3 - ব্যাচ স্ক্যান প্যারামিটার সেট করুন 0x4 - ব্যাচ স্ক্যান ফলাফলের প্যারামিটার পড়ুন |
LE_Batch_Scan_Command: ব্যাচ স্ক্যান স্টোরেজ প্যারামিটার সাবকমান্ড সেট করুন
সাব ওসিএফ: ০x০২
| সাবকমান্ড প্যারামিটার | আকার | উদ্দেশ্য |
|---|---|---|
Batch_Scan_Full_Max | ১ অক্টেট | পূর্ণাঙ্গ স্টাইলের জন্য বরাদ্দকৃত সর্বোচ্চ সঞ্চয় স্থান (% এ) [পরিসর: ০-১০০] |
Batch_Scan_Truncated_Max | ১ অক্টেট | ছাঁটা স্টাইলে বরাদ্দকৃত সর্বোচ্চ স্টোরেজ স্পেস (% এ) [পরিসর: ০-১০০] |
Batch_Scan_Notify_Threshold | ১ অক্টেট | পৃথক স্টোরেজ পুলের জন্য বিজ্ঞপ্তি স্তর (% এ) সেটআপ করুন [পরিসর: ০-১০০] ০ তে সেট করলে বিজ্ঞপ্তি বন্ধ হয়ে যাবে। বিক্রেতা-নির্দিষ্ট HCI ইভেন্ট তৈরি হয় (স্টোরেজ থ্রেশহোল্ড লঙ্ঘন সাবইভেন্ট) |
এই কমান্ডের জন্য একটি Command Complete ইভেন্ট তৈরি করা হবে।
| প্যারামিটার ফেরত দিন | আকার | উদ্দেশ্য |
|---|---|---|
Status | ১ অক্টেট | কমান্ড সম্পূর্ণ অবস্থা |
Batch_scan_opcode | ১ অক্টেট | 0x02 [Set Batch Scan parameters] |
LE_Batch_Scan_Command: ব্যাচ স্ক্যান প্যারামিটার সাবকমান্ড সেট করুন
সাব ওসিএফ: ০x০৩
| সাবকমান্ড প্যারামিটার | আকার | উদ্দেশ্য |
|---|---|---|
Batch_Scan_Mode | ১ অক্টেট | 0x00 - ব্যাচ স্ক্যান অক্ষম করা হয়েছে 0x01 - কাটা মোড সক্রিয় করা হয়েছে 0x02 - পূর্ণ মোড সক্রিয় করা হয়েছে 0x03 - কাটা এবং পূর্ণ মোড সক্রিয় করা হয়েছে |
Duty_cycle_scan_window | ৪ অক্টেট | ব্যাচ স্ক্যান স্ক্যান সময় (স্লটের সংখ্যা) |
Duty_cyle_scan_interval | ৪ অক্টেট | ব্যাচ স্ক্যান ব্যবধানের সময়কাল (স্লটের সংখ্যা) |
own_address_type | ১ অক্টেট | 0x00 - পাবলিক ডিভাইসের ঠিকানা 0x01 - এলোমেলো ডিভাইসের ঠিকানা |
Batch_scan_Discard_Rule | ১ অক্টেট | ০ - পুরনো বিজ্ঞাপনটি বাতিল করুন ১ - দুর্বলতম RSSI সহ বিজ্ঞাপন বাতিল করুন |
এই সাবকমান্ডটি ব্যাচ স্ক্যানিং শুরু করবে, যদি এটি সক্রিয় থাকে। ট্রানকেটেড স্ক্যানিং-এ, ফলাফলগুলি ট্রানকেটেড আকারে সংরক্ষণ করা হয় যেখানে ট্রানকেটেড স্টাইল = { BD_ADDR, scan_interval} এর জন্য অনন্য কী থাকে। এর অর্থ হল প্রতিটি স্ক্যান ব্যবধানের জন্য শুধুমাত্র একটি BD_ADDR will । ট্রানকেটেড মোডের জন্য যে রেকর্ডটি রাখতে হবে তা হল: { BD_ADDR , Tx Power, RSSI, Timestamp}
যখন ফুল মোড সক্রিয় থাকে, তখন সক্রিয় স্ক্যানিং ব্যবহার করা হবে এবং স্ক্যান প্রতিক্রিয়া রেকর্ড করা হবে। স্ক্যান ব্যবধান নির্বিশেষে ফুল স্টাইলের অনন্য কী = {MAC, বিজ্ঞাপন প্যাকেট}। ফুল মোডের জন্য যে রেকর্ডটি রাখতে হবে তা হল { BD_ADDR , Tx Power, RSSI, টাইমস্ট্যাম্প, বিজ্ঞাপন প্যাকেট, স্ক্যান প্রতিক্রিয়া}। ফুল স্টাইলে, একই AD প্যাকেট, যখন বিভিন্ন স্ক্যান ব্যবধানে একাধিকবার দেখা যায়, তখন কেবল একবার রেকর্ড করা হয়। তবে, ট্রঙ্কেটেড মোডে, বিভিন্ন স্ক্যান ব্যবধানে BA_ADDR এর দৃশ্যমানতা আগ্রহের বিষয় (প্রতি স্ক্যান ব্যবধানে একবার)। RSSI হল একটি স্ক্যান ব্যবধানের মধ্যে একটি অনন্য বিজ্ঞাপনের সমস্ত ডুপ্লিকেটের গড় মান।
এই কমান্ডের জন্য একটি Command Complete ইভেন্ট তৈরি করা হবে।
| প্যারামিটার ফেরত দিন | আকার | উদ্দেশ্য |
|---|---|---|
Status | ১ অক্টেট | কমান্ড সম্পূর্ণ অবস্থা |
Batch_scan_opcode | ১ অক্টেট | 0x03 [ব্যাচ স্ক্যান প্যারামিটার সেট করুন] |
LE_Batch_Scan_Command: ব্যাচ স্ক্যানের ফলাফল পড়ার সাবকমান্ড
সাব ওসিএফ: ০x০৪
| সাবকমান্ড প্যারামিটার | আকার | উদ্দেশ্য |
|---|---|---|
Batch_Scan_Data_read | ১ অক্টেট | 0x01 - ছাঁটাই করা মোড ডেটা 0x02 - পূর্ণ মোড ডেটা |
এই কমান্ডের জন্য একটি Command Complete ইভেন্ট তৈরি করা হবে। যখন হোস্ট এই কমান্ডটি জারি করে, তখন কন্ট্রোলারের সমস্ত ফলাফল একটি Command Complete ইভেন্টে নাও থাকতে পারে। হোস্ট এই কমান্ডটি জারি করে পুনরাবৃত্তি করবে যতক্ষণ না Command Complete ইভেন্টের সংশ্লিষ্ট ফলাফল রেকর্ডের সংখ্যায় 0 নির্দেশ করে, যা নির্দেশ করে যে কন্ট্রোলারের হোস্টের সাথে যোগাযোগ করার জন্য আর কোনও রেকর্ড নেই। প্রতিটি Command Complete ইভেন্টে শুধুমাত্র এক ধরণের ডেটার একাধিক রেকর্ড থাকতে পারে (পূর্ণ বা ছাঁটা)।
কন্ট্রোলার এবং হোস্ট টাইম রেফারেন্স সিঙ্ক্রোনাইজ করা হয় না। টাইমস্ট্যাম্পের একক হল 50ms। হোস্ট যখন Read_Batch_Scan_Results_Sub_cmd প্রদান করে তখন টাইমস্ট্যাম্পের মান বন্ধ থাকে। যদি ফার্মওয়্যারে কমান্ডের আগমনের সময় T_c হয়, তাহলে ফার্মওয়্যারে টাইমস্ট্যাম্পটি নেওয়ার প্রকৃত সময় হল T_fw । রিপোর্টিং সময় হবে: ( T_c - T_fw )। T_c এবং T_fw ফার্মওয়্যার টাইম ডোমেইনে রয়েছে। এটি হোস্টকে গণনা করতে দেয় যে ঘটনাটি কত আগে ঘটেছে।
| প্যারামিটার ফেরত দিন | আকার | উদ্দেশ্য |
|---|---|---|
Status | ১ অক্টেট | কমান্ড সম্পূর্ণ অবস্থা |
Batch_scan_opcode | ১ অক্টেট | 0x03 [ব্যাচ স্ক্যান প্যারামিটার সেট করুন] |
Batch_Scan_data_read | ১ অক্টেট | বিন্যাস সনাক্ত করে (ছাঁটা বা পূর্ণ) |
num_of_records | ১ অক্টেট | Batch_Scan_data_read এর রেকর্ডের সংখ্যা |
format_of_data | পরিবর্তনশীল | ছাঁটাই মোড: ঠিকানা[0]: ৬ অক্টেট ঠিকানা_প্রকার[0]: ১ অক্টেট Tx_Pwr[0]: ১ অক্টেট RSSI[0] : ১ অক্টেট টাইমস্ট্যাম্প[0]: ২ অক্টেট [উপরের ফর্ম্যাট সহ একাধিক রেকর্ড ( num_of_records )]পূর্ণ মোড: ঠিকানা[0]: ৬ অক্টেট ঠিকানা_প্রকার[0]: ১ অক্টেট Tx_Pwr[0]: ১ অক্টেট RSSI[0]: ১ অক্টেট টাইমস্ট্যাম্প[0]: ২ অক্টেট অ্যাড প্যাকেট_লেন[0]: ১ অক্টেট অ্যাড_প্যাকেট[0]: অ্যাড_প্যাকেট_লেন অক্টেট স্ক্যান_ডেটা_রেসপ_লেন[0]: ১ অক্টেট স্ক্যান_ডেটা_রেস্প[0]: Scan_data_resp অক্টেট[উপরের ফর্ম্যাট সহ একাধিক রেকর্ড ( num_of_records )] |
বিজ্ঞাপন প্যাকেট কন্টেন্ট ফিল্টার
কন্ট্রোলারে অ্যাডভার্টাইজিং প্যাকেট কন্টেন্ট ফিল্টার (APCF) সক্রিয়/অক্ষম/সেটআপ করতে এটি ব্যবহার করুন। APCF কন্ট্রোলারে বিজ্ঞাপনের প্রতিবেদন ফিল্টার করে কিন্তু পর্যায়ক্রমিক বিজ্ঞাপন ফিল্টার করে না।
LE_APCF_কমান্ড
ওসিএফ: ০x১৫৭
| কমান্ড প্যারামিটার | আকার | উদ্দেশ্য |
|---|---|---|
APCF_opcode | ১ অক্টেট | 0x00 - APCF সক্ষম করুন 0x01 - APCF ফিল্টারিং প্যারামিটার সেট করুন 0x02 - APCF ব্রডকাস্টার ঠিকানা 0x03 - APCF পরিষেবা UUID 0x04 - APCF পরিষেবা অনুরোধ UUID 0x05 - APCF স্থানীয় নাম 0x06 - APCF প্রস্তুতকারকের ডেটা 0x07 - APCF পরিষেবা ডেটা 0x08 - APCF ট্রান্সপোর্ট ডিসকভারি সার্ভিস 0x09 - APCF AD টাইপ ফিল্টার 0x10 ~ 0xAF - ভবিষ্যতে ব্যবহারের জন্য সংরক্ষিত 0xB0 ~ 0xDF - বিক্রেতার জন্য সংরক্ষিত 0xE0 ~ 0xFE - ভবিষ্যতে ব্যবহারের জন্য সংরক্ষিত 0xFF - APCF রিড এক্সটেন্ডেড ফিচার |
এই কমান্ডের জন্য একটি Command Complete ইভেন্ট তৈরি করা হবে।
| প্যারামিটার ফেরত দিন | আকার | উদ্দেশ্য |
|---|---|---|
Status | ১ অক্টেট | ফেরতের অবস্থা |
APCF_opcode | ১ অক্টেট | 0x00 - APCF সক্ষম করুন 0x01 - APCF ফিল্টারিং প্যারামিটার সেট করুন 0x02 - APCF ব্রডকাস্টার ঠিকানা 0x03 - APCF পরিষেবা UUID 0x04 - APCF পরিষেবা অনুরোধ UUID 0x05 - APCF স্থানীয় নাম 0x06 - APCF প্রস্তুতকারকের ডেটা 0x07 - APCF পরিষেবা ডেটা 0x08 - APCF ট্রান্সপোর্ট ডিসকভারি সার্ভিস 0x09 - APCF AD টাইপ ফিল্টার 0x10 ~ 0xAF - ভবিষ্যতে ব্যবহারের জন্য সংরক্ষিত 0xB0 ~ 0xDF - বিক্রেতার জন্য সংরক্ষিত 0xE0 ~ 0xFE - ভবিষ্যতে ব্যবহারের জন্য সংরক্ষিত 0xFF - APCF রিড এক্সটেন্ডেড ফিচার |
LE_APCF_কমান্ড: সাব_সিএমডি_সক্রিয় করুন
সাব ওসিএফ: ০x০০
| সাবকমান্ড প্যারামিটার | আকার | উদ্দেশ্য |
|---|---|---|
APCF_enable | ১ অক্টেট | 0x01 - APCF বৈশিষ্ট্য সক্রিয় করুন 0x00 - APCF বৈশিষ্ট্যটি অক্ষম করুন |
এই কমান্ডের জন্য একটি Command Complete ইভেন্ট তৈরি করা হবে।
| প্যারামিটার ফেরত দিন | আকার | উদ্দেশ্য |
|---|---|---|
Status | ১ অক্টেট | কমান্ড সম্পূর্ণ অবস্থা |
APCF_opcode | ১ অক্টেট | 0x0 - APCF সক্ষম করুন |
APCF_Enable | ১ অক্টেট | APCF_enable এর মাধ্যমে সক্ষম/অক্ষম করা সেট করা আছে |
LE_APCF_কমান্ড: সেট_ফিল্টারিং_প্যারামিটার_সাব_সিএমডি
এই সাবকমান্ডটি একটি ফিল্টার স্পেসিফিকেশন যোগ করতে বা মুছে ফেলতে অথবা অন-চিপ ফিল্টারিংয়ের জন্য একটি ফিল্টার তালিকা সাফ করতে ব্যবহৃত হয়।
সাব ওসিএফ: ০x০১
| সাবকমান্ড প্যারামিটার | আকার | উদ্দেশ্য |
|---|---|---|
APCF_Action | ১ অক্টেট | 0x00 - যোগ করুন 0x01 - মুছুন 0x02 - পরিষ্কার ডিলিট করলে অন্যান্য টেবিলের সংশ্লিষ্ট বৈশিষ্ট্য এন্ট্রি সহ নির্দিষ্ট ফিল্টারটি মুছে যাবে। Clear অন্যান্য টেবিলের সমস্ত ফিল্টার এবং সংশ্লিষ্ট এন্ট্রি মুছে ফেলবে। |
APCF_Filter_Index | ১ অক্টেট | ফিল্টার সূচক (0, max_filter-1 ) |
APCF_Feature_Selection | ২ অক্টেট | নির্বাচিত বৈশিষ্ট্যগুলির জন্য বিট মাস্ক: বিট ০: ব্রডকাস্ট অ্যাড্রেস ফিল্টার সক্রিয় করতে সেট করুন বিট ১: সার্ভিস ডেটা পরিবর্তন ফিল্টার সক্রিয় করতে সেট করুন বিট ২: পরিষেবা UUID চেক সক্ষম করতে সেট করুন বিট ৩: সার্ভিস সলিসিটেশন UUID চেক সক্রিয় করতে সেট করুন Bit 4: Set to enable Local Name check বিট ৫: প্রস্তুতকারকের ডেটা চেক সক্ষম করতে সেট করুন বিট ৬: সার্ভিস ডেটা চেক সক্ষম করতে সেট করুন বিট ৭: ট্রান্সপোর্ট ডিসকভারি সার্ভিস চেক সক্ষম করার জন্য সেট করুন বিট ৮: AD টাইপ চেক সক্ষম করতে সেট করুন |
APCF_List_Logic_Type | ২ অক্টেট | APCF_Feature_Selection এ উল্লেখিত প্রতিটি বৈশিষ্ট্য নির্বাচনের (প্রতি-বিট অবস্থান) জন্য লজিক অপারেশন।শুধুমাত্র তখনই বৈধ যখন কোনও বৈশিষ্ট্য সক্রিয় থাকে। বিট পজিশন মান: ০: অথবা ১: এবং যদি "AND" লজিক নির্বাচন করা হয়, তাহলে একটি ADV প্যাকেট শুধুমাত্র তখনই ফিল্টারটি পাস করবে যদি এতে তালিকার সমস্ত এন্ট্রি থাকে। যদি "OR" লজিক নির্বাচন করা হয়, তাহলে তালিকার যেকোনো এন্ট্রি থাকলে একটি ADV প্যাকেট ফিল্টারটি পাস করবে। |
APCF_Filter_Logic_Type | ১ অক্টেট | ০x০০: অথবা ০x০১: এবং দ্রষ্টব্য: APCF_Feature_Selection এর প্রথম তিনটি ক্ষেত্রের জন্য লজিক টাইপ N/A, যা সর্বদা "AND" লজিক। এগুলি শুধুমাত্র APCF_Feature_Selection এর (বিট 3 - বিট 6) চারটি ক্ষেত্রের জন্য প্রযোজ্য। |
rssi_high_thresh | ১ অক্টেট | [dBm তে] বিজ্ঞাপনদাতাকে তখনই দেখা হয়েছে বলে মনে করা হবে যদি সিগন্যালটি RSSI-এর উচ্চ থ্রেশহোল্ডের চেয়ে বেশি থাকে। অন্যথায়, ফার্মওয়্যারটিকে এমন আচরণ করতে হবে যেন সে কখনও দেখেনি। |
delivery_mode | ১ অক্টেট | 0x00 - immediate০x০১ - on_found0x02 - batched |
onfound_timeout | ২ অক্টেট | delivery_mode on_found থাকলেই কেবল বৈধ।[মিলিসেকেন্ডে] ফার্মওয়্যারের জন্য অপেক্ষা করার এবং রিপোর্ট করার আগে অতিরিক্ত বিজ্ঞাপন সংগ্রহ করার সময় এসেছে। |
onfound_timeout_cnt | ১ অক্টেট | delivery_mode on_found থাকলেই কেবল বৈধ।[গণনা] যদি onFound এর কোনও বিজ্ঞাপন onfound_timeout সময়কালের জন্য ফার্মওয়্যারে থাকে, তাহলে এটি কয়েকটি বিজ্ঞাপন সংগ্রহ করবে এবং গণনাটি পরীক্ষা করা হবে। যদি গণনাটি onfound_timeout_cnt অতিক্রম করে, তাহলে তা অবিলম্বে OnFound রিপোর্ট করা হবে। |
rssi_low_thresh | ১ অক্টেট | delivery_mode on_found থাকলেই কেবল বৈধ।[dBm তে] প্রাপ্ত প্যাকেটের RSSI RSSI নিম্ন থ্রেশহোল্ডের উপরে না থাকলে বিজ্ঞাপনদাতার প্যাকেটটি দেখা যায়নি বলে বিবেচিত হবে। |
onlost_timeout | ২ অক্টেট | delivery_mode on_found থাকলেই কেবল বৈধ।[মিলিসেকেন্ডে] যদি কোনও বিজ্ঞাপন, খুঁজে পাওয়ার পর, lost_timeout সময়ের জন্য সংলগ্নভাবে দেখা না যায়, তাহলে তা অবিলম্বে হারিয়ে গেছে বলে রিপোর্ট করা হবে। |
num_of_tracking_entries | ২ অক্টেট | delivery_mode on_found থাকলেই কেবল বৈধ।[গণনা] প্রতি ফিল্টারে ট্র্যাক করার জন্য মোট বিজ্ঞাপনদাতার সংখ্যা। |
RSSI মানগুলিকে ঋণাত্মক মান উপস্থাপনের জন্য 2 এর পরিপূরক ব্যবহার করতে হবে।
হোস্ট বিভিন্ন ফিল্টার সমন্বয় পরিচালনা করার জন্য APCF_Application_Address_type 0x02 (সকল ব্রডকাস্টার ঠিকানার জন্য) তে সেট করে একাধিক ফিল্টার কনফিগার করতে সক্ষম হবে।
ফিল্টারিং, ব্যাচিং এবং রিপোর্টিং আন্তঃসম্পর্কিত ধারণা। প্রতিটি বিজ্ঞাপন এবং সম্পর্কিত স্ক্যান প্রতিক্রিয়াকে একের পর এক সমস্ত ফিল্টারের মধ্য দিয়ে যেতে হবে। সুতরাং, ফলাফলের ক্রিয়াগুলি ( delivery_mode ) ফিল্টারিংয়ের সাথে ঘনিষ্ঠভাবে সম্পর্কিত। ডেলিভারি মোডগুলি হল: report_immediately , batch , এবং onFound । OnLost মানটি OnFound সাথে সম্পর্কিত এই অর্থে যে এটি হারিয়ে গেলে OnFound পরে আসবে।
এই প্রক্রিয়াকরণ প্রবাহটি ধারণাগত মডেলটি চিত্রিত করে:

যখন একটি বিজ্ঞাপন (অথবা স্ক্যান প্রতিক্রিয়া) ফ্রেম পাওয়া যায়, তখন এটি সমস্ত ফিল্টারে ধারাবাহিকভাবে প্রয়োগ করা হয়। এটি সম্ভব যে একটি বিজ্ঞাপন একটি ফিল্টারের উপর ভিত্তি করে তাৎক্ষণিক প্রতিবেদন তৈরি করতে পারে এবং ভিন্ন ফিল্টার অ্যাকশনের কারণে একই ফিল্টারের ব্যাচিং হতে পারে।
RSSI স্তরের থ্রেশহোল্ড (উচ্চ এবং নিম্ন) ফিল্টার প্রক্রিয়াকরণের জন্য ফ্রেমটি কখন দৃশ্যমান তা নিয়ন্ত্রণ করার ক্ষমতা দেয়, এমনকি যখন নিয়ামক দ্বারা একটি বৈধ প্যাকেট প্রাপ্ত হয়। ডেলিভারি মোড তাৎক্ষণিক বা ব্যাচড-এ সেট করা হলে, আরও নিয়ন্ত্রক প্রক্রিয়াকরণের জন্য একটি ফ্রেমের RSSI বিবেচনা করা হয়। বিভিন্ন অ্যাপের বিভিন্ন রিপোর্টিং এবং ব্যাচিং আচরণের প্রয়োজন হয়। এটি একাধিক অ্যাপকে একই সাথে ফার্মওয়্যারে ফলাফলের সরাসরি রিপোর্টিং এবং/অথবা ব্যাচিং করার অনুমতি দেয়। একটি উদাহরণ হল এমন একটি ঘটনা যখন একটি ব্যাচ স্ক্যান একটি অ্যাপ থেকে সক্রিয় থাকে এবং পরে অন্য অ্যাপ দ্বারা একটি নিয়মিত LE স্ক্যান জারি করা হয়। একটি ব্যাচ স্ক্যান জারি করার আগে, ফ্রেমওয়ার্ক/অ্যাপ উপযুক্ত ফিল্টার সেট করে। পরে, যখন দ্বিতীয় অ্যাপটি একটি নিয়মিত স্ক্যান জারি করে, পূর্ববর্তী ব্যাচিং অব্যাহত থাকে। তবে, নিয়মিত স্ক্যানের কারণে, এটি ধারণাগতভাবে LE স্ক্যান কমান্ডের সাথে একটি নাল ফিল্টার (সমস্ত বিদ্যমান ফিল্টার সহ) যোগ করার অনুরূপ। সক্রিয় থাকাকালীন LE স্ক্যান কমান্ড প্যারামিটারগুলি প্রাধান্য পায়। যখন নিয়মিত LE স্ক্যান অক্ষম করা হয়, তখন কন্ট্রোলারটি পূর্ববর্তী ব্যাচ স্ক্যানে ফিরে যাবে, যদি এটি বিদ্যমান থাকে।
OnFound ডেলিভারি মোড কনফিগার করা ফিল্টারের উপর ভিত্তি করে তৈরি। যে সংমিশ্রণটি ফিল্টারের ক্রিয়াকে সফল করতে ট্রিগার করে তাকে onLost এর জন্য ট্র্যাক করার সত্তা হিসেবে বিবেচনা করা হয়। সংশ্লিষ্ট ইভেন্টটি হল LE Advt ট্র্যাকিং সাবইভেন্ট।
একটি ফিল্টারের জন্য OnFound/OnLost ট্রানজিশন (যদি সক্রিয় থাকে) নিম্নলিখিতটির মতো দেখাবে:

এই কমান্ডের জন্য একটি Command Complete ইভেন্ট তৈরি করা হবে।
| প্যারামিটার ফেরত দিন | আকার | উদ্দেশ্য |
|---|---|---|
Status | ১ অক্টেট | কমান্ড সম্পূর্ণ অবস্থা |
APCF_opcode | ১ অক্টেট | 0x01 - APCF সেট ফিল্টারিং প্যারামিটার |
APCF_Action | ১ অক্টেট | ইকো ব্যাক কমান্ডের APCF_Action |
APCF_AvailableSpaces | ১ অক্টেট | ফিল্টার টেবিলে উপলব্ধ এন্ট্রির সংখ্যা |
LE_APCF_কমান্ড: সম্প্রচার_ঠিকানা_সাব_সিএমডি
এই সাবকমান্ডটি বিজ্ঞাপনদাতার ঠিকানা যোগ করতে বা মুছে ফেলতে অথবা অন-চিপ ফিল্টারিংয়ের জন্য বিজ্ঞাপনদাতার ঠিকানা তালিকা সাফ করতে ব্যবহৃত হয়।
সাব ওসিএফ: ০x০২
| সাবকমান্ড প্যারামিটার | আকার | উদ্দেশ্য |
|---|---|---|
APCF_Action | ১ অক্টেট | 0x00 - যোগ করুন 0x01 - মুছুন 0x02 - পরিষ্কার ডিলিট করলে নির্দিষ্ট ফিল্টারে থাকা নির্দিষ্ট ব্রডকাস্টার ঠিকানা মুছে যাবে। Clear নির্দিষ্ট ফিল্টারের সমস্ত ব্রডকাস্টার ঠিকানা মুছে ফেলবে। |
APCF_Filter_Index | ১ অক্টেট | ফিল্টার সূচক (0, max_filter-1 ) |
APCF_Broadcaster_Address | ৬ অক্টেট | সম্প্রচারকারী ঠিকানা তালিকায় যোগ করতে বা মুছে ফেলতে 6-বাইট ডিভাইস ঠিকানা |
APCF_Application_Address_type | ১ অক্টেট | ০x০০: সর্বজনীন 0x01: এলোমেলো 0x02: NA (ঠিকানার ধরণ উপেক্ষা করুন) পরিচয় ঠিকানার ধরণ (0x02, 0x03) সহ বিজ্ঞাপন প্রতিবেদনগুলি ফিল্টার করতে। 0x02 এবং 0x03 ঠিকানার ধরণ সহ বিজ্ঞাপন প্রতিবেদনগুলি পেতে, এই ক্ষেত্রটি 0x02 এ সেট করুন: NA (ঠিকানার ধরণ উপেক্ষা করুন)। |
এই কমান্ডের জন্য একটি Command Complete ইভেন্ট তৈরি করা হবে।
| প্যারামিটার ফেরত দিন | আকার | উদ্দেশ্য |
|---|---|---|
Status | ১ অক্টেট | কমান্ড সম্পূর্ণ অবস্থা |
APCF_opcode | ১ অক্টেট | 0x02 - APCF ব্রডকাস্টার ঠিকানা |
APCF_Action | ১ অক্টেট | ইকো ব্যাক কমান্ডের APCF_Action |
APCF_AvailableSpaces | ১ অক্টেট | সম্প্রচার ঠিকানা সারণীতে এখনও কতগুলি বিনামূল্যের এন্ট্রি উপলব্ধ রয়েছে |
LE_APCF_কমান্ড: service_uuid_sub_cmd
এই সাবকমান্ডটি একটি পরিষেবা UUID যোগ করতে বা মুছে ফেলতে অথবা অন-চিপ ফিল্টারিংয়ের জন্য একটি পরিষেবা UUID তালিকা সাফ করতে ব্যবহৃত হয়।
সাব ওসিএফ: ০x০৩
| সাবকমান্ড প্যারামিটার | আকার | উদ্দেশ্য |
|---|---|---|
APCF_Action | ১ অক্টেট | 0x00 - যোগ করুন 0x01 - মুছুন 0x02 - পরিষ্কার Delete নির্দিষ্ট ফিল্টারে নির্দিষ্ট পরিষেবা UUID ঠিকানা মুছে ফেলবে। Clear নির্দিষ্ট ফিল্টারের সমস্ত পরিষেবা UUID মুছে ফেলবে। |
APCF_Filter_Index | ১ অক্টেট | ফিল্টার সূচক (0, max_filter -1) |
APCF_UUID | ২,৪,১৬ অক্টেট | তালিকায় যোগ করার জন্য বা মুছে ফেলার জন্য পরিষেবা UUID (১৬-বিট, ৩২-বিট, অথবা ১২৮-বিট)। |
APCF_UUID_MASK | ২,৪,১৬ অক্টেট | তালিকায় যোগ করার জন্য সার্ভিস UUID মাস্ক (১৬-বিট, ৩২-বিট, অথবা ১২৮-বিট)। এর দৈর্ঘ্য APCF_UUID. |
এই কমান্ডের জন্য একটি Command Complete ইভেন্ট তৈরি করা হবে।
| প্যারামিটার ফেরত দিন | আকার | উদ্দেশ্য |
|---|---|---|
Status | ১ অক্টেট | কমান্ড সম্পূর্ণ অবস্থা |
APCF_opcode | ১ অক্টেট | 0x03 - APCF পরিষেবা UUID |
APCF_Action | ১ অক্টেট | ইকো ব্যাক কমান্ডের APCF_Action |
APCF_AvailableSpaces | ১ অক্টেট | পরিষেবা UUID টেবিলে এখনও কতগুলি বিনামূল্যের এন্ট্রি উপলব্ধ রয়েছে |
LE_APCF_কমান্ড: অনুরোধ_uuid_sub_cmd
এই সাবকমান্ডটি একটি সলিসিটেশন UUID যোগ করতে বা মুছে ফেলতে অথবা অন-চিপ ফিল্টারিংয়ের জন্য একটি সলিসিটেশন UUID তালিকা সাফ করতে ব্যবহৃত হয়।
সাব ওসিএফ: ০x০৪
| সাবকমান্ড প্যারামিটার | আকার | উদ্দেশ্য |
|---|---|---|
APCF_Action | ১ অক্টেট | 0x00 - যোগ করুন 0x01 - মুছুন 0x02 - পরিষ্কার Delete নির্দিষ্ট ফিল্টারে থাকা অনুরোধ UUID ঠিকানাটি মুছে ফেলবে। Clear নির্দিষ্ট ফিল্টারের সমস্ত সলিসিটেশন UUID মুছে ফেলবে। |
APCF_Filter_Index | ১ অক্টেট | Filter index (0, max_filter -1) |
APCF_UUID | 2,4,16 octet | তালিকায় যোগ করতে বা মুছে ফেলতে সলিসিটেশন UUID (১৬-বিট, ৩২-বিট, অথবা ১২৮-বিট)। |
APCF_UUID_MASK | ২,৪,১৬ অক্টেট | তালিকায় যোগ করার জন্য Solicitation UUID মাস্ক (১৬-বিট, ৩২-বিট, অথবা ১২৮-বিট)। এর দৈর্ঘ্য APCF_UUID এর সমান হওয়া উচিত। |
এই কমান্ডের জন্য একটি Command Complete ইভেন্ট তৈরি করা হবে।
| প্যারামিটার ফেরত দিন | আকার | উদ্দেশ্য |
|---|---|---|
Status | ১ অক্টেট | কমান্ড সম্পূর্ণ অবস্থা |
APCF_opcode | ১ অক্টেট | 0x04 - APCF সলিসিটেশন UUID |
APCF_Action | ১ অক্টেট | ইকো ব্যাক কমান্ডের APCF_Action |
APCF_AvailableSpaces | ১ অক্টেট | সলিসিটেশন UUID টেবিলে এখনও কতগুলি বিনামূল্যের এন্ট্রি উপলব্ধ রয়েছে |
LE_APCF_কমান্ড: স্থানীয়_নাম_সাব_সিএমডি
এই সাবকমান্ডটি স্থানীয় নামের স্ট্রিং যোগ করতে বা মুছে ফেলতে অথবা অন-চিপ ফিল্টারিংয়ের জন্য স্থানীয় নামের স্ট্রিং তালিকা সাফ করতে ব্যবহৃত হয়।
সাব ওসিএফ: ০x০৫
| সাবকমান্ড প্যারামিটার | আকার | উদ্দেশ্য |
|---|---|---|
APCF_Action | ১ অক্টেট | 0x00 - যোগ করুন 0x01 - মুছুন 0x02 - পরিষ্কার Delete নির্দিষ্ট ফিল্টারে নির্দিষ্ট স্থানীয় নামের স্ট্রিংটি মুছে ফেলবে। Clear নির্দিষ্ট ফিল্টারের সমস্ত স্থানীয় নামের স্ট্রিং মুছে ফেলবে। |
APCF_Filter_Index | ১ অক্টেট | ফিল্টার সূচক (0, max_filter -1) |
APCF_LocName_Mandata_or_SerData | পরিবর্তনশীল আকার | স্থানীয় নামের জন্য একটি অক্ষর স্ট্রিং। নোট:
|
এই কমান্ডের জন্য একটি Command Complete ইভেন্ট তৈরি করা হবে।
| প্যারামিটার ফেরত দিন | আকার | উদ্দেশ্য |
|---|---|---|
Status | ১ অক্টেট | কমান্ড সম্পূর্ণ অবস্থা |
APCF_opcode | ১ অক্টেট | 0x05 - APCF স্থানীয় নাম |
APCF_Action | ১ অক্টেট | ইকো ব্যাক কমান্ডের APCF_Action |
APCF_AvailableSpaces | ১ অক্টেট | স্থানীয় নামের টেবিলে এখনও কতগুলি বিনামূল্যের এন্ট্রি পাওয়া যাচ্ছে |
LE_APCF_কমান্ড: manf_data_sub_cmd
এই সাবকমান্ডটি একটি প্রস্তুতকারকের ডেটা স্ট্রিং যোগ করতে বা মুছে ফেলতে অথবা অন-চিপ ফিল্টারিংয়ের জন্য প্রস্তুতকারকের ডেটা স্ট্রিং তালিকা সাফ করতে ব্যবহৃত হয়।
সাব ওসিএফ: ০x০৬
| সাবকমান্ড প্যারামিটার | আকার | উদ্দেশ্য |
|---|---|---|
APCF_Action | ১ অক্টেট | 0x00 - যোগ করুন 0x01 - মুছুন 0x02 - পরিষ্কার Delete নির্দিষ্ট ফিল্টারে নির্দিষ্ট প্রস্তুতকারকের ডেটা স্ট্রিং মুছে ফেলবে। Clear নির্দিষ্ট ফিল্টারের সমস্ত প্রস্তুতকারকের ডেটা স্ট্রিং মুছে ফেলবে। |
APCF_Filter_Index | ১ অক্টেট | ফিল্টার সূচক (0, max_filter -1) |
APCF_LocName_Mandata_or_SerData | পরিবর্তনশীল আকার | প্রস্তুতকারকের ডেটার জন্য একটি অক্ষর স্ট্রিং। নোট:
|
APCF_ManData_Mask | পরিবর্তনশীল আকার | তালিকায় যোগ করার জন্য ম্যানুফ্যাকচার ডেটা মাস্ক। এর দৈর্ঘ্য APCF_LocName_or_ManData_or_SerData এর সমান হওয়া উচিত। |
এই কমান্ডের জন্য একটি Command Complete ইভেন্ট তৈরি করা হবে।
| প্যারামিটার ফেরত দিন | আকার | উদ্দেশ্য |
|---|---|---|
Status | ১ অক্টেট | কমান্ড সম্পূর্ণ অবস্থা |
APCF_opcode | ১ অক্টেট | 0x06 - APCF প্রস্তুতকারকের ডেটা |
APCF_Action | ১ অক্টেট | ইকো ব্যাক কমান্ডের APCF_Action |
APCF_AvailableSpaces | ১ অক্টেট | প্রস্তুতকারকের ডেটা টেবিলে এখনও উপলব্ধ বিনামূল্যের এন্ট্রির সংখ্যা |
LE_APCF_কমান্ড: service_data_sub_cmd
এই সাবকমান্ডটি একটি পরিষেবা ডেটা স্ট্রিং যোগ করতে বা মুছে ফেলতে অথবা অন-চিপ ফিল্টারিংয়ের জন্য পরিষেবা ডেটা স্ট্রিং তালিকা সাফ করতে ব্যবহৃত হয়।
সাব ওসিএফ: ০x০৭
| সাবকমান্ড প্যারামিটার | আকার | উদ্দেশ্য |
|---|---|---|
APCF_Action | ১ অক্টেট | 0x00 - যোগ করুন 0x01 - মুছুন 0x02 - পরিষ্কার ডিলিট করলে নির্দিষ্ট ফিল্টারে নির্দিষ্ট পরিষেবা ডেটা স্ট্রিং মুছে যাবে। Clear নির্দিষ্ট ফিল্টারের সমস্ত পরিষেবা ডেটা স্ট্রিং সাফ করবে। |
APCF_Filter_Index | ১ অক্টেট | ফিল্টার সূচক (0, max_filter -1) |
APCF_LocName_Mandata_or_SerData | পরিবর্তনশীল আকার | পরিষেবা ডেটার জন্য একটি অক্ষর স্ট্রিং। নোট:
|
APCF_LocName_Mandata_or_SerData_Mask | পরিবর্তনশীল আকার | তালিকায় যোগ করার জন্য পরিষেবা ডেটা মাস্ক। এটির দৈর্ঘ্য APCF_LocName_or_ManData_or_SerData. |
এই কমান্ডের জন্য একটি Command Complete ইভেন্ট তৈরি করা হবে।
| প্যারামিটার ফেরত দিন | আকার | উদ্দেশ্য |
|---|---|---|
Status | ১ অক্টেট | কমান্ড সম্পূর্ণ অবস্থা |
APCF_opcode | ১ অক্টেট | 0x07 - APCF পরিষেবা ডেটা |
APCF_Action | ১ অক্টেট | ইকো ব্যাক কমান্ডের APCF_Action |
APCF_AvailableSpaces | ১ অক্টেট | পরিষেবা ডেটা টেবিলের জন্য এখনও উপলব্ধ বিনামূল্যের এন্ট্রির সংখ্যা |
LE_APCF_কমান্ড: ad_type_sub_cmd
এই সাবকমান্ডটি একটি AD টাইপ যোগ বা মুছে ফেলার জন্য অথবা অন-চিপ ফিল্টারিংয়ের জন্য একটি AD টাইপ তালিকা সাফ করার জন্য ব্যবহৃত হয়। এই কমান্ডটি সমর্থিত কিনা তা পরীক্ষা করতে read_extended_features_sub_cmd ব্যবহার করুন।
যখন APCF_AD_DATA_Length 0 হয়, তখন AD ডেটা এবং AD ডেটা মাস্কের তুলনা না করে APCF_AD_TYPE ফিল্টার করুন। যদি প্রাপ্ত ADV প্যাকেটের ডেটা দৈর্ঘ্য AD_DATA_LENGTH অতিক্রম করে, তাহলে শুধুমাত্র AD ডেটার প্রথম AD_DATA_LENGTH বাইট তুলনা করুন এবং অবশিষ্ট ডেটা উপেক্ষা করুন।
সাব ওসিএফ: ০x০৯
| সাবকমান্ড প্যারামিটার | আকার | উদ্দেশ্য |
|---|---|---|
APCF_Action | ১ অক্টেট | 0x00 - যোগ করুন 0x01 - মুছুন 0x02 - পরিষ্কার Delete নির্দিষ্ট ফিল্টারে নির্দিষ্ট AD টাইপ মুছে ফেলবে। Clear নির্দিষ্ট ফিল্টারের সকল AD প্রকার মুছে ফেলবে। |
APCF_Filter_Index | ১ অক্টেট | ফিল্টার সূচক (0, max_filter -1) |
APCF_AD_TYPE | ১ অক্টেট | তালিকায় যোগ করার জন্য বা মুছে ফেলার জন্য AD টাইপ। APCF_Action 0x02 (পরিষ্কার) হলে উপেক্ষা করুন। |
APCF_AD_DATA_Length | ১ অক্টেট | 0x00 - মানে ডেটা কন্টেন্ট ফিল্টার করবেন নাAPCF_Action 0x02 হলে উপেক্ষা করুন (পরিষ্কার) |
APCF_AD_DATA | পরিবর্তনশীল আকার | APCF_AD_DATA_Length উপর ভিত্তি করে পরিবর্তনশীল আকারেরAPCF_Action 0x02 হলে উপেক্ষা করুন (পরিষ্কার) |
APCF_AD_DATA_MASK | পরিবর্তনশীল আকার | APCF_AD_DATA_Length উপর ভিত্তি করে পরিবর্তনশীল আকারেরAPCF_Action 0x02 হলে উপেক্ষা করুন (পরিষ্কার)এর দৈর্ঘ্য APCF_AD_DATA এর সমান হওয়া উচিত। |
এই কমান্ডের জন্য একটি Command Complete ইভেন্ট তৈরি করা হবে।
| Return parameter | আকার | উদ্দেশ্য |
|---|---|---|
Status | ১ অক্টেট | কমান্ড সম্পূর্ণ অবস্থা |
APCF_opcode | ১ অক্টেট | ০x০৯ - APCF AD টাইপ |
APCF_Action | ১ অক্টেট | ইকো ব্যাক কমান্ডের APCF_Action |
APCF_AvailableSpaces | ১ অক্টেট | AD টাইপ টেবিলে এখনও উপলব্ধ বিনামূল্যের এন্ট্রির সংখ্যা |
LE_APCF_কমান্ড: রিড_এক্সটেন্ডেড_ফিচারস_সাব_সিএমডি
এই সাবকমান্ডটি বর্ধিত APCF বৈশিষ্ট্যগুলি পড়ার জন্য ব্যবহৃত হয়।
সাব ওসিএফ: ০xএফএফ
| সাবকমান্ড প্যারামিটার | আকার | উদ্দেশ্য |
|---|---|---|
| প্রযোজ্য নয় | খালি কমান্ড প্যারামিটার। |
এই কমান্ডের জন্য একটি Command Complete ইভেন্ট তৈরি করা হবে।
| প্যারামিটার ফেরত দিন | আকার | উদ্দেশ্য |
|---|---|---|
Status | ১ অক্টেট | কমান্ড সম্পূর্ণ অবস্থা |
APCF_opcode | ১ অক্টেট | 0xFF - APCF_Read_Extended_Features |
APCF_extended_features | ২ অক্টেট | বর্ধিত বৈশিষ্ট্যগুলির জন্য বিট মাস্ক সমর্থিত:
বিটের মান
|
কন্ট্রোলার কার্যকলাপ এবং শক্তি তথ্য কমান্ড
এই তথ্যের উদ্দেশ্য হল উচ্চতর হোস্ট সিস্টেম ফাংশনগুলি অ্যাপ এবং ফ্রেমওয়ার্কে কী ঘটছে তার সাথে মিল রেখে BT কন্ট্রোলার এবং এর ম্যাক্রো স্টেট সহ সমস্ত উপাদানের মোট কার্যকলাপ বিশ্লেষণ করা। এটি করার জন্য, BT স্ট্যাক এবং কন্ট্রোলার থেকে নিম্নলিখিত তথ্য প্রয়োজন:
- বিটি স্ট্যাক: কন্ট্রোলারের বর্তমান ম্যাক্রো-অপারেশনাল অবস্থা রিপোর্ট করা
- ফার্মওয়্যার: সামগ্রিক কার্যকলাপ এবং শক্তির তথ্য রিপোর্ট করা
ব্যবহারকারী স্তরে নির্ধারিত বিটি হোস্ট স্ট্যাক ম্যাক্রো অবস্থা:
- নিষ্ক্রিয়: [পৃষ্ঠা স্ক্যান, LE বিজ্ঞাপন, অনুসন্ধান স্ক্যান, LE স্ক্যান]
- স্ক্যান: [পেজিং/তদন্ত/সংযোগের চেষ্টা করা হচ্ছে]
- সক্রিয়: [ACL লিঙ্ক চালু আছে, SCO লিঙ্ক চলছে, স্নিফ মোড]
কন্ট্রোলার তার জীবনকাল ধরে যেসব কার্যকলাপ ট্র্যাক করে তা হল Tx সময়, Rx সময়, নিষ্ক্রিয় সময় এবং মোট ব্যবহৃত শক্তি। হোস্ট থেকে পড়ার সময় এগুলি সাফ হয়ে যায়।
LE_Get_Controller_Activity_Energy_Info
এটি একটি বিক্রেতা-নির্দিষ্ট কমান্ড।
ওসিএফ: ০x১৫৯
| সাবকমান্ড প্যারামিটার | আকার | উদ্দেশ্য |
|---|---|---|
| এন.এ. | খালি কমান্ড প্যারামিটার |
এই কমান্ডের জন্য একটি Command Complete ইভেন্ট তৈরি করা হবে।
| প্যারামিটার ফেরত দিন | আকার | উদ্দেশ্য |
|---|---|---|
Status | ১ অক্টেট | কমান্ড সম্পূর্ণ অবস্থা |
total_tx_time_ms | ৪ অক্টেট | মোট সময় পারফর্ম করার সময় |
total_rx_time_ms | ৪ অক্টেট | Rx সম্পাদনের মোট সময় |
total_idle_time_ms | ৪ অক্টেট | নিষ্ক্রিয় অবস্থায় মোট সময় (ঘুম ছাড়া কম শক্তির অবস্থা) |
total_energy_used | ৪ অক্টেট | মোট ব্যবহৃত শক্তি [কারেন্ট (mA), ভোল্টেজ (V) এবং সময় (ms) এর গুণফল] |
LE বর্ধিত সেট স্ক্যান প্যারামিটার কমান্ড
এই কমান্ডটি কন্ট্রোলারে একটি বৃহত্তর স্ক্যান উইন্ডো এবং ব্যবধান সক্ষম করতে ব্যবহার করা যেতে পারে। BT Core 5.2 স্পেসিফিকেশন অনুসারে, একটি স্ক্যান উইন্ডো এবং ব্যবধানের সর্বোচ্চ সীমা 10.24 সেকেন্ড, যা অ্যাপগুলির জন্য স্ক্যান ব্যবধান 10.24 সেকেন্ডের বেশি বাধাগ্রস্ত করে।
বেস রেফারেন্স: বিটি কোর ৫.২ স্পেসিফিকেশন, পৃষ্ঠা ২৪৯৩ (এলই সেট স্ক্যান প্যারামিটার কমান্ড)
ওসিএফ: ০x১৫এ
| কমান্ড প্যারামিটার | আকার | উদ্দেশ্য |
|---|---|---|
LE_Ex_Scan_Type | ১ অক্টেট | 0x00 - প্যাসিভ স্ক্যানিং। কোনও SCAN_REQ প্যাকেট পাঠানো হবে না (ডিফল্ট)।0x01 - সক্রিয় স্ক্যানিং। SCAN_REQ প্যাকেট পাঠানো হতে পারে। |
LE_Ex_Scan_Interval | ৪ অক্টেট | কন্ট্রোলার যখন তার শেষ LE স্ক্যান শুরু করেছিল তখন থেকে পরবর্তী LE স্ক্যান শুরু করা পর্যন্ত সময়ের ব্যবধান হিসাবে সংজ্ঞায়িত করা হয়। পরিসর: 0x0004 থেকে 0x00FFFFFF ডিফল্ট: 0x0010 (10 মিলিসেকেন্ড) সময় = N * 0.625 মিলিসেকেন্ড সময়সীমা: ২.৫ মিলিসেকেন্ড থেকে ১০৪৪২.২৫ সেকেন্ড |
LE_Ex_Scan_Window | ৪ অক্টেট | LE স্ক্যানের সময়কাল। LE_Scan_Window LE_Scan_Interval এর চেয়ে কম বা সমান হবে।পরিসর: 0x0004 থেকে 0xFFFF ডিফল্ট: 0x0010 (10 মিলিসেকেন্ড) সময় = N * 0.625 মিলিসেকেন্ড সময়সীমা: ২.৫ মিলিসেকেন্ড থেকে ৪০.৯৫ সেকেন্ড |
Own_Address_Type | ১ অক্টেট | 0x00 - পাবলিক ডিভাইস ঠিকানা (ডিফল্ট) 0x01 - র্যান্ডম ডিভাইস ঠিকানা |
LE_Ex_Scan_Filter_Policy | 0x00 - সমস্ত বিজ্ঞাপন প্যাকেট গ্রহণ করুন (ডিফল্ট)। এই ডিভাইসের জন্য ঠিকানা দেওয়া হয়নি এমন নির্দেশিত বিজ্ঞাপন প্যাকেটগুলি উপেক্ষা করা হবে। 0x01 - শুধুমাত্র হোয়াইট লিস্ট তালিকায় নেই এমন ডিভাইসগুলির বিজ্ঞাপন প্যাকেটগুলি উপেক্ষা করুন। এই ডিভাইসের জন্য ঠিকানা দেওয়া হয়নি এমন নির্দেশিত বিজ্ঞাপন প্যাকেটগুলি উপেক্ষা করা হবে। |
এই কমান্ডের জন্য একটি Command Complete ইভেন্ট তৈরি করা হবে।
| প্যারামিটার ফেরত দিন | আকার | উদ্দেশ্য |
|---|---|---|
Status | ১ অক্টেট | কমান্ড সম্পূর্ণ অবস্থা |
কন্ট্রোলার ডিবাগ তথ্য কমান্ড পান
এই তথ্য উপাদানটির উদ্দেশ্য হল পোস্ট-প্রসেসিং এবং বিশ্লেষণের জন্য বাইনারি আকারে একটি হোস্ট দ্বারা কন্ট্রোলার ডিবাগ তথ্য অর্জন করা। এটি মাঠের সমস্যাগুলি ডিবাগ করতে সাহায্য করে এবং বিশ্লেষণের জন্য তথ্য লগ করার জন্য ইঞ্জিনিয়ারদের একটি টুলকিট প্রদান করে। একজন কন্ট্রোলার ইভেন্টের মাধ্যমে (কন্ট্রোলার ডিবাগ ইনফো সাবইভেন্ট) অথবা কন্ট্রোলার যখন ইচ্ছা তখন স্বয়ংক্রিয়ভাবে তথ্য সরবরাহ করতে পারে। উদাহরণস্বরূপ, ফার্মওয়্যার স্টেট তথ্য, ক্র্যাশ ডাম্প তথ্য, লগিং তথ্য ইত্যাদি রিপোর্ট করা যেতে পারে।
ওসিএফ: ০x১৫বি
| কমান্ড প্যারামিটার | আকার | উদ্দেশ্য |
|---|---|---|
| নিষিদ্ধ | খালি কমান্ড প্যারামিটার তালিকা |
এই কমান্ডের জন্য একটি Command Complete ইভেন্ট তৈরি করা হবে।
| প্যারামিটার ফেরত দিন | আকার | উদ্দেশ্য |
|---|---|---|
Status | ১ অক্টেট | কমান্ড সম্পূর্ণ অবস্থা |
A2DP হার্ডওয়্যার অফলোড সাপোর্ট
A2DP অফলোড বৈশিষ্ট্যটি BT কন্ট্রোলারের সাথে সংযুক্ত একটি অডিও প্রসেসরে A2DP অডিও এনকোডিং প্রক্রিয়ার অফলোড সমর্থন করে। এনকোডেড অডিও ডেটা স্ট্রিম BT হোস্টের জড়িততা ছাড়াই অডিও প্রসেসর থেকে সরাসরি BT কন্ট্রোলারে চলে যায়। BT হোস্ট এখনও A2DP সেশনের কনফিগারেশন এবং নিয়ন্ত্রণের জন্য দায়ী। কমান্ডের দুটি সংস্করণ উপলব্ধ। Sub OCF 0x01-0x02 সহ লিগ্যাসি কমান্ডগুলি কেবল ওপেন-সোর্স কোডেক সমর্থন করে। Sub-OCF 0x03-0x04 সহ সংস্করণগুলি কনফিগার করা কোডেকের জন্য অজ্ঞেয়বাদী।
ওসিএফ: ০x১৫ডি
A2DP অফলোড শুরু করুন (লিগেসি)
সাব ওসিএফ: ০x০১
A2DP অফলোড প্রক্রিয়া কনফিগার করতে এবং A2DP স্ট্রিম শুরু করতে উভয় ক্ষেত্রেই এই কমান্ডটি ব্যবহার করুন।
| কমান্ড প্যারামিটার | আকার | উদ্দেশ্য |
|---|---|---|
Codec | ৪ অক্টেট | কোডেক টাইপ নির্দিষ্ট করে ০x০১ - এসবিসি ০x০২ - এএসি ০x০৪ - এপিটিএক্স ০x০৮ - এপিটিএক্স এইচডি ০x১০ - এলডিএসি |
Max_Latency | ২ অক্টেট | সর্বাধিক অনুমোদিত লেটেন্সি (মিলিসেকেন্ডে)। শূন্য মান ফ্লাশ অক্ষম করে। |
SCMS-T_Enable | ২ অক্টেট | অক্টোবর ০: এমন পতাকা যা SCMS-T হেডার যোগ করতে সক্ষম করে।
অক্টোবর ১: SCMS-T হেডারের মান, যখন এটি সক্রিয় থাকে। |
Sampling_Frequency | ৪ অক্টেট | ০x০১ - ৪৪১০০ হার্জেড ০x০২ - ৪৮০০০ হার্জেড ০x০৪ - ৮৮২০০ হার্জেড ০x০৮ - ৯৬০০০ হার্জেড |
Bits_Per_Sample | ১ অক্টেট | 0x01 - প্রতি নমুনায় 16 বিট 0x02 - প্রতি নমুনায় 24 বিট 0x04 - 32 bits per sample |
Channel_Mode | ১ অক্টেট | 0x01 - মনো 0x02 - স্টেরিও |
Encoded_Audio_Bitrate | ৪ অক্টেট | প্রতি সেকেন্ডে বিট হিসাবে এনকোডেড অডিও বিটরেট। 0x00000000 - অডিও বিটরেট নির্দিষ্ট করা নেই / অব্যবহৃত। 0x00000001 - 0x00FFFFFF - প্রতি সেকেন্ডে বিটগুলিতে এনকোড করা অডিও বিটরেট। 0x01000000 - 0xFFFFFFFF - সংরক্ষিত। |
Connection_Handle | ২ অক্টেট | A2DP সংযোগের সংযোগ হ্যান্ডেল কনফিগার করা হচ্ছে |
L2CAP_Channel_ID | ২ অক্টেট | এই A2DP সংযোগের জন্য L2CAP চ্যানেল আইডি ব্যবহার করা হবে |
L2CAP_MTU_Size | ২ অক্টেট | এনকোডেড অডিও প্যাকেট ধারণকারী L2CAP MTU-এর সর্বোচ্চ আকার |
Codec_Information | ৩২ অক্টেট | কোডেক-নির্দিষ্ট তথ্য। এসবিসি কোডেক: A2DP v1.3-এ SBC কোডেক নির্দিষ্ট তথ্য উপাদানগুলি দেখুন। AAC কোডেক: A2DP v1.3-এ AAC কোডেক নির্দিষ্ট তথ্য উপাদানগুলি দেখুন। LDAC কোডেক: অক্টোবর ০-৩: বিক্রেতা আইডি অক্টোবর ৪-৫: কোডেক আইডি ৬ অক্টোবর: বিটরেট সূচক: অক্টোবর ৭: LDAC চ্যানেল মোড ৮-৩১ অক্টোবর: সংরক্ষিত অন্যান্য সকল কোডেক: অক্টোবর ০-৩১: সংরক্ষিত |
এই কমান্ডের জন্য একটি Command Complete ইভেন্ট তৈরি করা হবে।
| প্যারামিটার ফেরত দিন | আকার | উদ্দেশ্য |
|---|---|---|
Status | ১ অক্টেট | কমান্ড সম্পূর্ণ অবস্থা |
Sub_Opcode | ১ অক্টেট | 0x01 - A2DP অফলোড শুরু করুন |
A2DP অফলোড শুরু করুন
সাব ওসিএফ: ০x০৩
A2DP অফলোড প্রক্রিয়া কনফিগার করতে এবং A2DP স্ট্রিম শুরু করতে উভয় ক্ষেত্রেই এই কমান্ডটি ব্যবহার করুন।
| কমান্ড প্যারামিটার | আকার | উদ্দেশ্য |
|---|---|---|
Connection Handle | ২ অক্টেট | সক্রিয় HCI সংযোগের হ্যান্ডেল |
L2CAP_Channel_ID | 2 octets | A2DP স্ট্রিমিংয়ের জন্য L2CAP চ্যানেলের শনাক্তকারী খোলা হয়েছে |
Data_Path_Direction | ১ অক্টেট | 0x00 - আউটপুট (AVDTP উৎস/মার্জ) 0x01 - ইনপুট (AVDTP সিঙ্ক/স্প্লিট) |
Peer_MTU | ২ অক্টেট | L2CAP প্যাকেটের সর্বোচ্চ আকার, সমকক্ষের সাথে আলোচনা করা হয়েছে। |
CP_Enable_SCMS_T | ১ অক্টেট | 0x00 - SCMS-T কন্টেন্ট সুরক্ষা হেডার অক্ষম করুন 0x01 - SCMS-T কন্টেন্ট সুরক্ষা হেডার সক্ষম করুন |
CP_Header_SCMS_T | ১ অক্টেট | যখন SCMS-T কন্টেন্ট প্রোটেকশন হেডার সক্রিয় থাকে ( CP_SCMS_T_Enable 0x01 তে সেট করা), তখন ব্লুটুথ অ্যাসাইনড নম্বর, সেকশন 6.3.2 দ্বারা সংজ্ঞায়িত অডিও কন্টেন্টের আগে থাকা হেডার মান (A2DP, সেকশন 3.2.1-2 দেখুন) সংজ্ঞায়িত করে।SCMS-T কন্টেন্ট সুরক্ষা সক্ষম না থাকলে উপেক্ষা করা হয়। |
Vendor_Specific_Parameters_Length | ১ অক্টেট | বিক্রেতা নির্দিষ্ট পরামিতিগুলির দৈর্ঘ্য, 0 থেকে 128 এর মধ্যে। The value 0 is used when no additional parameters are provided. |
Vendor_Specific_Parameters | 0-128 octets | Vendor Specific Parameters provided by the Bluetooth Audio HAL, CodecParameters.vendorSpecificParameters[] . |
A Command Complete event will be generated for this command.
| Return parameter | আকার | উদ্দেশ্য |
|---|---|---|
Status | 1 octet | Command Complete status |
Sub_Opcode | 1 octet | 0x03 - Start A2DP offload |
Stop A2DP offload (legacy)
Sub OCF: 0x02
This command is used to stop the A2DP offload stream.
| Command parameter | আকার | উদ্দেশ্য |
|---|---|---|
| নিষিদ্ধ | Empty command parameter list. |
No parameters are defined for this command.
A Command Complete event will be generated for this command.
| Return parameter | আকার | উদ্দেশ্য |
|---|---|---|
Status | 1 octet | Command Complete status |
Sub_Opcode | 1 octet | 0x02 - Stop A2DP offload |
Stop A2DP offload
Sub OCF: 0x04
This command is used to stop the A2DP offload stream.
| Command parameter | আকার | উদ্দেশ্য |
|---|---|---|
Connection Handle | 2 octets | Handle of the active HCI connection |
L2CAP_Channel_ID | 2 octets | Identifier of the L2CAP Channel opened for A2DP streaming |
Data_Path_Direction | 1 octet | 0x00 - Output (AVDTP Source/Merge) 0x01 - Input (AVDTP Sink/Split) |
A Command Complete event will be generated for this command.
| Return parameter | আকার | উদ্দেশ্য |
|---|---|---|
Status | 1 octet | Command Complete status |
Sub_Opcode | 1 octet | 0x04 - Stop A2DP offload |
Bluetooth Quality Report command
The BT Quality Report command feature starts the mechanism in the Bluetooth controller to report Bluetooth Quality events to the host. You can enable four options:
- Quality Monitoring Mode: The controller periodically sends a Link Quality related BQR subevent to the host.
- Approaching LSTO: If no packets are received from the connected BT device for longer than half of the Link Supervision TimeOut (LSTO) value, the controller reports an Approaching LSTO event to the host.
- A2DP Audio Choppy: When the controller detects factors that cause choppy audio, the controller reports an A2DP Audio Choppy event to the host.
- (e)SCO Voice Choppy: When the controller detects factors that cause choppy voice, the controller reports an (e)SCO Voice Choppy event to the host.
- Root Inflammation: This event is sent by the controller to the stack when the HAL or the controller encounters a fatal error and needs to restart Bluetooth.
- LMP/LL message trace: The controller sends the LMP/LL message handshaking with the remote device to the host.
- Bluetooth Multi-profile/Coex scheduling trace: The controller sends its scheduling information on handling multiple Bluetooth profiles and wireless coexistence in the 2.4 Ghz band to the host.
- Controller Debug Information mechanism: When enabled, the controller can autonomously report debug logging information through the Controller debug info subevent to the host.
- LE Audio Choppy: When the controller detects factors that cause choppy audio, the controller reports an LE Audio Choppy event to the host.
- Advance RF Stats mode: The controller reports its RF stats related information to the host, supporting two report use cases:
- পর্যায়ক্রমিক প্রতিবেদন
- Event triggers (stream start/stop and link quality event trigger).
- The controller health monitoring mechanism provides the host with health-related information through two types of events: periodic reports and event-triggered reports.
- BQR_Report_Action of Bluetooth Quality Report Command: The host can use this HCI command to get a one time query for quality monitoring mode, energy monitor mode, or an advance RF stats mode.
OCF: 0x15E
| Command parameter | আকার | উদ্দেশ্য |
|---|---|---|
BQR_Report_Action | 1 octet | Action to add / delete reporting of quality event(s) set in BQR_Quality_Event_Mask parameter, or clear all. 0x00 - Add Delete will clear specific quality event(s) reporting. |
BQR_Quality_Event_Mask | 4 octets | Bit masks for the selected quality event reporting. Bit 0: Set to enable quality monitoring mode. |
BQR_Minimum_Report_Interval | 2 octets | Define the minimum time interval of quality event reporting for the selected quality event(s). The controller Firmware should not report the next event within the defined time interval. The interval setting shall be respective and dedicated for the quality event(s) which are being added. Unit: ms |
BQR_Vendor_Specific_Quality_Event_Mask | 4 octets | Bit masks for the selected vendor-specific quality event reporting. This parameter is valid only when bit 15 of BQR_Quality_Event_Mask is set.Bit 0 ~ 31: Reserved. |
BQR_Vendor_Specific_Trace_Mask | 4 octets | Bit masks for the selected vendor-specific trace reporting. This parameter is valid only when bit 31 of BQR_Quality_Event_Mask is set.Bit 0 ~ 31: Reserved. |
Report_interval_multiple | 4 octets | The multiplier for BQR_Minimum_Report_Interval . When this value >= 1, the BQR Report Interval follows the formatBQR Report Interval = BQR_Minimum_Report_Interval x Report_interval_multiple. The controller Firmware must not report the next event within the defined time interval. The interval setting is specifically dedicated for the added quality event(s). Unit: ms BQR_Report_Interval is larger than the ability of the controller, the controller must return the maximum BQR_Report_Interval time on the completion of the command. |
A Command Complete event will be generated for this command.
| Return parameter | আকার | উদ্দেশ্য |
|---|---|---|
Status | 1 octet | Command Complete status |
Current_Quality_Event_Mask | 4 octets | Indicates current bit mask setting. Bit 0: Quality monitoring mode is enabled. Bit 1: Approaching LSTO event reporting is enabled. Bit 2: A2DP Audio Choppy event reporting is enabled. Bit 3: (e)SCO Voice Choppy event reporting is enabled. Bit 4: Root inflammation event reporting is enabled. Bit 5: Energy monitoring mode is enabled. Bit 6: LE audio choppy event reporting is enabled. Bit 7: Connect fail event. Bit 8: Set to enable Advance RF Stats mode event trigger. Bit 9: Set to enable Advance RF Stats periodically report. Bit 10: Set to enabled controller health monitoring mechanism event trigger. Bit 11: Set to enabled controller health monitoring mechanism periodically report. Bit 12 ~ 14: Reserved. Bit 15: Vendor-specific quality event reporting is enabled. Bit 16: LMP/LL message trace is enabled. Bit 17: Bluetooth Multi-link/Coex scheduling trace is enabled. Bit 18: Controller Debug Information mechanism is enabled. Bit 19: Reserved for offload debug information Bit 20: UART History Dump Event trigger Bit 21 ~ 30: Reserved. Bit 31: Vendor-specific trace is enabled. |
Current_Vendor_Specific_Quality_Event_Mask | 4 octets | Indicates current bit mask setting. |
Current_Vendor_Specific_Trace_Mask | 4 octets | Indicates current bit mask setting. |
BQR_Report_interval | 4 octets | Indicates current bit mask setting. |
Current_Vendor_Specific_Trace_Mask | 4 octets | The setting of BQR_Report_interval . It must be the minimum value between BQR_Minimum_Report_Interval * Report_interval_multiple or the maximum support interval of the controller. |
Dynamic audio buffer command
The dynamic audio buffer reduces audio glitching by changing the audio buffer size in the Bluetooth controller based on various scenarios.
OCF: 0x15F
Get audio buffer time capability
Sub OCF: 0x01
Use this command to get the audio buffer time capability from the Bluetooth controller.
| Command parameter | আকার | উদ্দেশ্য |
|---|---|---|
| নিষিদ্ধ | Empty Command parameter list |
A Command Complete event will be generated for this command.
| Return parameter | আকার | উদ্দেশ্য |
|---|---|---|
Status | 1 octet | Command Complete status |
Dynamic_Audio_Buffer_opcode | 1 octet | 0x01 - Get audio buffer time |
Audio_Codec_Type_Supported | 4 octets | Bit masks for the supported codec types Bit 0 - SBC Bit 1 - AAC Bit 2 - APTX Bit 3 - APTX HD Bit 4 - LDAC Bit 5-31 are reserved |
Audio_Codec_Buffer_Default_Time_For_Bit_0 | 2 octets | Default buffer time of the Bit 0 codec type specified in Audio_Codec_Type_Supported. This value shall be 0 if the Bit 0 codec type is not supported. Unit: ms |
Audio_Codec_Buffer_Maximum_Time_For_Bit_0 | 2 octets | Maximum buffer time of the Bit 0 codec type specified in Audio_Codec_Type_Supported. This value shall be 0 if the Bit 0 codec type is not supported. Unit: ms |
Audio_Codec_Buffer_Minimum_Time_For_Bit_0 | 2 octets | Minimum buffer time of the Bit 0 codec type specified in Audio_Codec_Type_Supported. This value shall be 0 if the Bit 0 codec type is not supported. Unit: ms |
Audio_Codec_Buffer_Default_Time_For_Bit_1 | 2 octets | Default buffer time of the Bit 1 codec type specified in Audio_Codec_Type_Supported. This value shall be 0 if the Bit 1 codec type is not supported. Unit: ms |
Audio_Codec_Buffer_Maximum_Time_For_Bit_1 | 2 octets | Maximum buffer time of the Bit 1 codec type specified in Audio_Codec_Type_Supported. This value shall be 0 if the Bit 1 codec type is not supported. Unit: ms |
Audio_Codec_Buffer_Minimum_Time_For_Bit_1 | 2 octets | Minimum buffer time of the Bit 1 codec type specified in Audio_Codec_Type_Supported. This value shall be 0 if the Bit 1 codec type is not supported. Unit: ms |
| ...... | ...... | ...... |
Audio_Codec_Buffer_Default_Time_For_Bit_31 | 2 octets | Default buffer time of the Bit 31 codec type specified in Audio_Codec_Type_Supported. This value shall be 0 if the Bit 31 codec type is not supported. Unit: ms |
Audio_Codec_Buffer_Maximum_Time_For_Bit_31 | 2 octets | Maximum buffer time of the Bit 31 codec type specified in Audio_Codec_Type_Supported. This value shall be 0 if the Bit 31 codec type is not supported. Unit: ms |
Audio_Codec_Buffer_Minimum_Time_For_Bit_31 | 2 octets | Minimum buffer time of the Bit 31 codec type specified in Audio_Codec_Type_Supported. This value shall be 0 if the Bit 31 codec type is not supported. Unit: ms |
Set audio buffer time
Sub OCF: 0x02
Use this command to set the audio buffer time to the Bluetooth controller.
| Command parameter | আকার | উদ্দেশ্য |
|---|---|---|
Audio_Codec_Buffer_Time | 2 octets | Requested audio buffer time for the current used codec. Unit: ms |
A Command Complete event will be generated for this command.
| Return parameter | আকার | উদ্দেশ্য |
|---|---|---|
Status | 1 octet | Command Complete status |
Dynamic_Audio_Buffer_opcode | 1 octet | 0x02 - Set audio buffer time |
Audio_Codec_Buffer_Time | 2 octets | Current audio buffer time in the Bluetooth controller. Unit: ms |
HCI event (vendor-specific)
Vendor-specific HCI events are required in some cases. Refer to Figure 5.4 on page 1897 of the BT Core 5.2 Specification. Event parameter 0 will always contain the first subevent code, based on which the rest of the HCI event is decoded.
| Event Parameter | আকার | উদ্দেশ্য |
|---|---|---|
HCI_vendor_specific_event_code | 1 octet | ০xএফএফ |
sub_event_code | 1 octet | A subevent code will be 1 octet in size, the byte immediately following Parameter Length in the HCI event packet. |
Storage threshold breach subevent
This event indicates that the storage threshold has been breached.
Subevent code = 0x54
| Subevent Parameter | আকার | উদ্দেশ্য |
|---|---|---|
| কোনটিই নয় |
LE multi-advertising state change subevent
This event indicates that an advertising instance has changed its state. At this time, this event is only used to indicate which advertising instance was stopped as a result of a connection.
Subevent code = 0x55
| Subevent parameter | আকার | উদ্দেশ্য |
|---|---|---|
Advertising_instance | 1 octet | Identifies the specific advertising instance Valid values are 0 through max_advt_instances -1 |
State_Change_Reason | 1 octet | 0x00: Connection received |
Connection_handle | 2 octets | Identifies the connection that caused the advt instance to be disabled (0xFFFF if invalid) |
LE advertisement tracking subevent
This event indicates when an advertiser is found or lost.
Sub event code = 0x56
| Subevent Parameter | আকার | উদ্দেশ্য |
|---|---|---|
APCF_Filter_Index | 1 octet | Filter Index (0, max_filter -1) |
Advertiser_State | 1 octet | 0x00: Advertiser found 0x01: Advertiser lost |
Advt_Info_Present | 1 octet | 0x00: Advertiser information ( Advt_Info ) present0x01: Advertiser information ( Advt_Info ) not present |
Advertiser_Address | 6 octets | Public or random address |
Advertiser_Address_Type | 1 octet | 0x00: Public address 0x01: Random address |
Advt_Info | Tx_Pwr[0] : 1 octetRSSI[0] : 1 octetTimestamp[0] : 2 octetsAdv packet_len[0] : 1 octetAdv_packet[0] : Adv_packet_len octetsScan_data_resp_len[0] : 1 octetScan_data_resp[0] : Scan_data_resp octets |
Controller debug info subevent
This event is used by a Controller to provide binary debug information to a host.
Subevent code = 0x57
| Subevent Parameter | আকার | উদ্দেশ্য |
|---|---|---|
debug_block_byte_offset_start | 2 octets | Debug block byte offset from the start |
last_block | 1 octet | 0x00: More debug data present 0x01: Last binary block; no more debug data |
cur_pay_load_sz | 2 octets | Binary block size in a current event |
Debug_Data | পরিবর্তনশীল | Debug data of cur_payload_sz |
Bluetooth Quality Report subevent
This event indicates one of the following: a Bluetooth quality event occurred, the controller uploaded the LMP/LL message trace and Bluetooth Multi-link/Coex scheduling trace, or the controller dumped debug information data.
Subevent code = 0x58 [Quality_Report_Id = 0x01 ~ 0x04, Link Quality related event]
| Subevent Parameter | আকার | উদ্দেশ্য |
|---|---|---|
Quality_Report_Id | 1 octet | 0x01: Quality reporting on the monitoring mode. 0x02: Approaching LSTO. 0x03: A2DP Audio Choppy. 0x04: (e)SCO Voice Choppy. 0x05 ~ 0x06: Reserved. 0x07: LE audio choppy. 0x08: Connect fail. 0x09 ~ 0xFF: Reserved. |
Packet_Types | 1 octet | 0x01: ID 0x02: NULL 0x03: POLL 0x04: FHS 0x05: HV1 0x06: HV2 0x07: HV3 0x08: DV 0x09: EV3 0x0A: EV4 0x0B: EV5 0x0C: 2-EV3 0x0D: 2-EV5 0x0E: 3-EV3 0x0F: 3-EV5 0x10: DM1 0x11: DH1 0x12: DM3 0x13: DH3 0x14: DM5 0x15: DH5 0x16: AUX1 0x17: 2-DH1 0x18: 2-DH3 0x19: 2-DH5 0x1A: 3-DH1 0x1B: 3-DH3 0x1C: 3-DH5 0x1D ~ 0x50: Reserved 0x51: ISO packet 0x52: 1M PHY 0x53: 2M PHY 0x54: Codec PHY S=2 0x55: Codec PHY S=8 0x56 ~ 0xFF: Reserved |
Connection_Handle | 2 octets | ACL/(e)SCO/ISO connection handle. |
Connection_Role | 1 octet | Performing Role for the connection. 0x00: Central 0x01: Peripheral 0x02 ~ 0xFF: Reserved. |
TX_Power_Level | 1 octet | Current transmit power level for the specified Connection_Handle. This value shall be the same as the controller's responding to the HCI_Read_Transmit_Power_Level HCI command. |
RSSI | 1 octet | [in dBm] Received Signal Strength Indication (RSSI) value for the specified Connection_Handle. |
SNR | 1 octet | [in dB] Signal-to-Noise Ratio (SNR) value for the specified Connection_Handle. |
Unused_AFH_Channel_Count | 1 octet | Indicates the number of unused channels in AFH_channel_map. 0x4F ~ 0xFF: Reserved. |
AFH_Select_Unideal_Channel_Count | 1 octet | Indicates the number of the channels which are interfered and have bad quality, but they are still selected for AFH. The minimum number of channels allowed by the Bluetooth specification is 20, so even if all 79 channels are interfered and have bad quality, the controller still needs to choose at least 20 channels for AFH. |
LSTO | 2 octets | Current Link Supervision Timeout Setting. Time = N * 0.625 ms Time Range: 0.625 ms to 40.9 s |
Connection_Piconet_Clock | 4 octets | Piconet Clock for the specified Connection_Handle. This value shall be the same as the controller's responding to HCI_Read_Clock HCI command with parameter "Which_Clock" of 0x01 (Piconet Clock). Unit: N * 0.3125 ms (1 Bluetooth Clock) |
Retransmission_Count | 4 octets | The number of retransmissions since the last event. This count shall be reset after reporting to the host. |
No_RX_Count | 4 octets | No RX count since the last event. The count increases when no packet is received at the scheduled time slot or the received packet is corrupted. This count shall be reset after reporting to the host. |
NAK_Count | 4 octets | NAK (Negative Acknowledge) count since the last event. This count shall be reset after reporting to the host. |
Last_TX_ACK_Timestamp | 4 octets | Timestamp of last TX ACK. It is based on the Bluetooth Clock of the piconet central (CLK). Unit: N * 0.3125 ms (1 Bluetooth Clock) |
Flow_Off_Count | 4 octets | The number of times the controller receives Flow-off (STOP) since the last event. This count shall be reset after reporting to the host. |
Last_Flow_On_Timestamp | 4 octets | Timestamp of last Flow-on (GO). It is based on the Bluetooth Clock of the piconet central (CLK). Unit: N * 0.3125 ms (1 Bluetooth Clock) |
Buffer_Overflow_Bytes | 4 octets | [in Byte] Buffer overflow count since the last event. |
Buffer_Underflow_Bytes | 4 octets | [in Byte] Buffer underflow count since the last event. |
bdaddr | 6 octets | Remote device address |
cal_failed_item_count | 1 octet | The count of calibration failed items |
TX_Total_Packets | 4 octets | The number of packets that are sent out. |
TX_UnAcked_Packets | 4 octets | The number of packets that don't receive an acknowledgment. This count is reset after reporting to the host. |
TX_Flushed_Packets | 4 octets | The number of packets that aren't sent out by its flush point. This count is reset after reporting to the host. |
TX_Last_Subevent_Packets | 4 octets | The number of packets that Link Layer transmits a CIS data PDU in the last subevent of a CIS event. This count is reset after reporting to the host. The value is zero if there's no valid value for the link. |
CRC_Error_Packets | 4 octets | The number of received packages with CRC error since the last event. This count is reset after reporting to the host. |
RX_Duplicate_Packets | 4 octets | The number of duplicate (retransmission) packages received since the last event. This count is reset after reporting to the host. |
RX_Unreceived_Packets | 4 octets | The number of unreceived packets is the same as the parameter of the LE READ ISO Link Quality command (see Bluetooth core Specification Version 5.4). The associated streams are CIS and BIS. When this value is incremented, the Link Layer doesn't receive a specific payload by its flush point (on a CIS) or at the end of the event it is associated with (on a BIS; see Bluetooth core Specification Version 5.4 Vol 6 Part B, Section 4.4.6.6). |
Coex_Info_Mask | 2 octets | Bit 0 - CoexInvolvement: Set to indicate coex activities are suspected to be involved when this report is generated (for example, A2DP Chops and Approaching LSTO). Bit 1 - WL 2G Radio Active: Set to indicate WLAN 2G Radio is active. Bit 2 - WL 2G Connected: Set to indicate WLAN 2G Radio is active and connected. Bit 3 - WL 5G/6G Radio Active: Set to indicate WLAN 5G/6G Radio is active. Bit 4-15 - Reserved |
| Vendor Specific Parameter | (parameter total length - TBD) * octets | For the controller vendor to obtain more vendor specific parameters. |
Subevent code = 0x58 [Quality_Report_Id = 0x05, Root Inflammation event]
This event indicates that Bluetooth HAL or the controller encountered a fatal error and needs Bluetooth stack to record this situation and restart. The controller must send a Root_Inflammation_Event to Bluetooth stack before sending the first fragment of the debug info events in any case.
The Error_Code parameter contains an error code reported from HAL/Controller, 0 if it is a chipset vendor specific error. The Vendor_Specific_Error_Code contains a chipset vendor specific error code from HAL/Controller. It should set as 0 if the parameter Error_Code is not 0. The parameters Error_Code and Vendor_Specific_Error_Code should not both be 0.
| Subevent Parameter | আকার | উদ্দেশ্য |
|---|---|---|
Quality_Report_Id | 1 octet | 0x00 ~ 0x04: Reserved. 0x05: Root inflammation. 0x06 ~ 0xFF: Reserved. |
Error_Code | 1 octet | 0x00: Chipset vendor specific error code is included. 0x01 ~ 0xFF: Controller failure occurred. See Bluetooth Spec [Vol 2] Part D, Error Codes for a list of error codes and descriptions. |
Vendor_Specific_Error_Code | 1 octet | 0x00: No chipset vendor specific error code is included. 0x01 ~ 0xFF: Chipset vendor specific error code. |
| Vendor Specific Parameter | (Parameter Total Length - 4) * octets | For the controller vendor to obtain more vendor specific parameters. |
সাবইভেন্ট কোড = 0x58 [Quality_Report_Id = 0x06, এনার্জি মনিটর ইভেন্ট]
This event provides a snapshot of the Bluetooth controller's power consumption and operational states over a specific time period. This event helps developers and engineers analyze how the controller manages power, identify which activities consume the most energy, and troubleshoot power-related issues.
The parameters in the report track key metrics, including:
- Average current consumption: The overall current used by the controller.
- Time spent in different states: The total time (in milliseconds) the controller spends in an idle (sleep/low power) state versus an active state (connecting, transmitting, or receiving data).
- State transition counts: The number of times the controller switches between idle and active states.
- Time spent in specific radio states: Separate metrics for time spent transmitting (Tx) and receiving (Rx) for both BR/EDR (Bluetooth Classic) and LE (Bluetooth Low Energy) links.
- Average transmit power levels: The average power (in dBm) used for transmissions on BR/EDR and LE links.
- Detailed chain activity: Reports on time spent with active transmit or receive chains, distinguishing between one-chain and two-chain operations, and between internal (iPA) and external (ePA) power amplifiers.
- Scan activity time: The time the controller spends actively scanning for BR/EDR and LE devices.
By examining these parameters, engineers can gain insight into the controller's power efficiency and optimize its performance.
| Subevent Parameter | আকার | উদ্দেশ্য |
|---|---|---|
Quality_Report_Id | 1 octet | 0x06: Energy Monitoring |
Average_Current_Consumption | 2 octets | [in mA] Average current consumption of all activities consumed by the controller |
Idle_Total_Time (sleep) | 4 octets | [in ms] Total time in the idle (low power states, sleep) state. |
Idle_Sate_Enter_Count | 4 octets | Indicates how many times the controller enters the idle state. |
Active_Total_Time | 4 octets | [in ms] Total time in the active (inquiring, paging, ACL/SCO/eSCO/BIS/CIS traffic, processing any task) state. |
Active_State_Enter_Count | 4 octets | Indicates how many times the controller enters the active states. |
BR_RDR_Tx_Total_Time | 4 octets | [in ms] Total time in the BR/EDR specific Tx(Transmitting for ACL/SCO/eSCO traffic)state. |
BR_RDR_Tx_State_Enter_Count | 4 octets | Indicates how many times the controller enters the BR/EDR specific Tx state. |
BR_RDR_Tx_Average_Power_Level | 1 octets | [in dBm] Average Tx power level of all the BR/EDR link(s) |
BR_RDR_Rx_Total_Time | 4 octets | [in ms] Total time in the BR/EDR specific Rx (Receiving from ACL/SCO/eSCO traffic) state. |
BR_RDR_Rx_State_Enter_Count | 4 octets | [in ms] Indicates how many times the controller enters the BR/EDR specific Rx state. |
LE_Tx_Total_Time | 4 octets | [in ms] Total time in the LE specific Tx (Transmitting for either ACL/BIS/CIS or LE advertising traffic) state. |
LE_Tx_State_Enter_Count | 4 octets | Indicates how many times the controller enters the BR/EDR specific Rx state. |
LE_Tx_Average_Power_Level | 1 octets | [in dBm] Average Tx power level of all the LE link(s). |
LE_Rx_Total_Time | 4 octets | [in ms] Total time in the LE specific Rx (Receiving from either ACL/BIS/CIS or LE scanning traffic) state. |
LE_Rx_State_Enter_Count | 4 octets | [in ms] Indicates how many times the controller enters the LE specific Rx state |
Report_Time_Duration (Total time) | 4 octets | [in ms] The total time duration to collect power related information. |
RX_Active_One_Chain_Time | 4 octets | [in ms] The time duration of RX active in one chain |
RX_Active_Two_Chain_Time | 4 octets | [in ms] The time duration of RX active in two chain |
TX_iPA_Active_One_Chain_Time | 4 octets | [in ms] The time duration of internal TX active in one chain |
TX_iPA_Active_Two_Chain_Time | 4 octets | [in ms] The time duration of internal TX active in two chain |
TX_ePA_Active_One_Chain_Time | 4 octets | [in ms] The time duration of external TX active in one chain |
TX_ePA_Active_Two_Chain_Time | 4 octets | [in ms] The time duration of external TX active in two chain |
BREDR_RX_Active_Scan_total_Time | 4 octets | [in ms] Time period (ms) on BR/EDR scan RX active time |
LE_RX_Active_Scan_total_Time | 4 octets | [in ms] Time period (ms) on LE scan RX active time |
সাবইভেন্ট কোড = 0x58 [Quality_Report_Id = 0x09~0x0A, অ্যাডভান্সড আরএফ স্ট্যাটাস ইভেন্ট]
The Bluetooth Advanced RF (Radio Frequency) Stats event provides detailed performance metrics about the Bluetooth controller's radio behavior. The event can be triggered in two ways:
- By Trigger (0x09): A one-time report is sent in response to a specific command.
- By Monitor (0x0A): The controller periodically sends reports at a specified interval.
The event's parameters are essentially packet counters that track various radio behaviors over a specified time period.
মূল সূচক এবং তাদের উদ্দেশ্য
- Transmit power statistics: These counters track packets sent using different power configurations, distinguishing between internal (iPA) and external (ePA) power amplifiers and various antenna diversity (Div) or beamforming (BF) modes. This helps determine which power and antenna settings are being used most frequently.
- Received signal strength indicator (RSSI) bins: These parameters categorize received packets based on their signal strength. By providing a count of packets within specific RSSI ranges (eg, less than -90 dBm, -70 to -75 dBm), the report gives a clear picture of the link quality. A high count in the "weak" signal bins (for example, < -90 dBm) indicates a poor connection.
- RSSI delta: This metric measures the difference in signal strength between the two receive antennas (if applicable). Counters track how many packets have an RSSI delta within different ranges. A large delta (eg, >11 dBm) can suggest interference or a physical obstruction, as one antenna is receiving a much stronger signal than the other.
- Antenna switching and re-transmissions: The report counts how often the controller switches between antennas and tracks re-transmitted (ReTX) packets. A high number of re-transmissions often points to a weak or unreliable connection, requiring packets to be resent.
- Channel quality: These parameters provide a high-level summary of the health of different communication channels, categorizing them as "Good," "OK," "Bad," or "Very Bad" based on their RSSI. This gives an immediate overview of the RF environment.
- TX buffer queue: This section monitors the number of packets waiting in the controller's transmit buffer for different link types, such as ACL (Asynchronous Connection-oriented Logical link), LECONN (LE Connection), and LEISOC (LE Isochronous). High buffer counts can indicate a bottleneck or a problem with data flowing from the host to the controller.
| Subevent parameter | আকার | উদ্দেশ্য |
|---|---|---|
Quality_Report_Id | 1 octet | 0x09: Advance RF Stats By Trigger 0x0A: Advance RF Stats By Monitor |
Extension_info | 1 octet | BQR version information. 0x01 for BQRv6 0x02 for BQRv7 |
Report_Time_Period | 4 octets | The time period to collect performance information. Unit: ms |
TX_Power_iPA_BF | 4 octets | Packet counter of iPA BF |
TX_Power_ePA_BF | 4 octets | Packet counter of ePA BF |
TX_Power_iPA_Div | 4 octets | Packet counter of ePA Div |
TX_Power_ePA_Div | 4 octets | Packet counter of ePA Div |
RSSI_chain_50 | 4 octets | Packet counter of RSSI chain > -50 dBm |
RSSI_chain_50_55 | 4 octets | Packet counter of RSSI chain between -50 dBm ~ >-55 dBm |
RSSI_chain_55_60 | 4 octets | Packet counter of RSSI chain between -55 dBm ~ >-60 dBm |
RSSI_chain_60_65 | 4 octets | Packet counter of RSSI chain between -60 dBm ~ >-65 dBm |
RSSI_chain_65_70 | 4 octets | Packet counter of RSSI chain between -65 dBm ~ >-70 dBm |
RSSI_chain_70_75 | 4 octets | Packet counter of RSSI chain between -70 dBm ~ >-75 dBm |
RSSI_chain_75_80 | 4 octets | Packet counter of RSSI chain between -75 dBm ~ >-80 dBm |
RSSI_chain_80_85 | 4 octets | Packet counter of RSSI chain between -80 dBm ~ >-85 dBm |
RSSI_chain_85_90 | 4 octets | Packet counter of RSSI chain between -85 dBm ~ >-90 dBm |
RSSI_chain_90 | 4 octets | Packet counter of RSSI chain < -90 dBm |
RSSI_delta_2 | 4 octets | Packet counter of RSSI delta < 2 dBm |
RSSI_delta_2_5 | 4 octets | Packet counter of RSSI delta between 2 dBm ~ 5 dBm |
RSSI_delta_5_8 | 4 octets | Packet counter of RSSI delta between 5 dBm ~ 8 dBm |
RSSI_delta_8_11 | 4 octets | Packet counter of RSSI delta between 8 dBm ~ 11 dBm |
RSSI_delta_11 | 4 octets | Packet counter of RSSI delta > 11 dBm |
Antenna_Switch_Count | 4 octets | Packet counter of antenna switching event |
ReTX_iPA_BF | 4 octets | Packet counter of ReTX_iPA_BF in the latest time period |
ReTX_ePA_BF | 4 octets | Packet counter of ReTX_ePA_BF in the latest time period |
ReTX_iPA_Div | 4 octets | Packet counter of ReTX_iPA_Div in the latest time period |
ReTX_ePA_Div | 4 octets | Packet counter of ReTX_ePA_Div in the latest time period |
Channel_count_Good | 1 octets | Number of channels whose RSSI falls within Bin-1 (<-90) |
Channel_count_OK | 1 octets | Number of channels whose RSSI falls within Bin-2 (-90~-76) |
Channel_count_Bad | 1 octets | Number of channels whose RSSI falls within Bin-3 (-76~-50) |
Channel_count_VeryBad | 1 octets | Number of channels whose RSSI falls within Bin-4 (>-50) |
TX_buffer_Queue_Count | 4 octets | Counter of buffer queue status-controller TX buffer in the latest time period [0:3] ACL_1 [4:7] ACL_2 [8:11] LECONN_1 [12:15] LECONN_2 [16:19] LEISOC_1 [20:23] LEISOC_2 [24:27] LEBroadcast [28:31] rsvd |
সাবইভেন্ট কোড = 0x58 [Quality_Report_Id = 0x0B~0x0C, কন্ট্রোলার হেলথ মনিটরিং ইভেন্ট]
The Bluetooth Controller Health Monitoring event provides a summary of the controller's operational status. The event can be triggered in two ways:
- By Trigger (0x09): A one-time report is sent in response to a specific command.
- By Monitor (0x0A): The controller periodically sends reports at a specified interval.
The Bluetooth Controller Health Monitoring event is a diagnostic tool that provides a summary of the controller's operational status. This event is part of the Bluetooth Quality Report (BQR) framework and is used for debugging connectivity, power management, and timing issues. It can be sent as a one-time report or periodically to provide continuous monitoring.
মূল সূচক এবং তাদের উদ্দেশ্য
- HCI Packet Counters: The event tracks the total number of packets sent from the Host to the Controller and vice versa. These counters are essential for debugging issues with the Host Controller Interface (HCI) transport, which is the communication channel between the software stack and the Bluetooth controller chip.
- Packet Lengths: The event reports the length of the last HCI packet sent and received. This helps verify that data is being transmitted correctly and that there are no unexpected size issues.
- Wake-up Signal Counts: The report includes the total number of times the BT_Wake and HOST_Wake pins have been asserted. These physical signals are critical for power management, as they are used to wake the respective entities from low-power states. Monitoring these counts helps debug power-related problems, such as unexpected wake-ups or failures to enter sleep mode.
- Timestamps: The event provides several timestamps, including the time of the last wake-up signal and the last HCI reset. These timestamps help troubleshoot timing-related issues and provide a reference point for when certain events occurred.
- Watchdog Timer: A specific flag indicates if the event was generated as an early warning that the controller's watchdog timer is about to expire. This is a critical alert for potential controller freezes or malfunctions.
- Link Status: The report summarizes the current state of active connections, including the total count of BR/EDR , LE , and CIS (Connected Isochronous Stream) links. It also indicates if any SCO (Synchronous Connection-Oriented) links are active. This information provides a snapshot of the controller's current connection load.
| Subevent parameter | আকার | উদ্দেশ্য |
|---|---|---|
Quality_Report_Id | 1 Octet | 0xB~0xC 0x0B: one-time or event-triggered reports 0x0C: periodic reports. |
Packet_Count_Host_to_Controller | 4 Octets | Total count of packets sent from Host to Controller over HCI transport. This field is employed for the purpose of debugging HCI (for example, UART) issues. Behavior: the counters reset when the controller received HCI reset. |
Packet_Count_Controller_to_Host | 4 Octets | Total count of HCI Event packets sent to Host. This field is employed for the purpose of debugging HCI (eg, UART) issues. Behavior: the counters reset when the controller received HCI reset. |
Last_Packet_Length_Host_to_Controller | 2 Octets | Length of the last HCI packet sent to Host UART. Note: HCI Packet Length max 2 octet (Include HCI, ACL, SCO, ISO) |
Last_Packet_Length_Controller_To_host | 2 Octets | Length of the last HCI packet received from Host UART. Note: HCI Packet Length max 2 octet (Include HCI, ACL, SCO, ISO) |
Total_BT_Wake_Count | 4 Octets | The aggregate tally of BT_Wake pin assertions by the Host entity. This field serves as a diagnostic tool for debugging power-related issues. Behavior: the counters reset when the controller received HCI reset. |
Total_HOST_Wake_Count | 4 Octets | Aggregate calculation of Host_Wake pin assertions initiated by the Controller. This field serves as a diagnostic tool for debugging power-related issues. Behavior: the counters reset when the controller received HCI reset. |
Last_BT_Wake_TimeStamp | 4 Octets | Last Timestamp when Host Asserted BT_Wake Pin.This field is implemented for the purpose of debugging Power issues. |
Last_HOST_Wake_TimeStamp | 4 Octets | The most recent timestamp when the controller asserted the Host_Wake pin. This field is used for debugging power issues. |
Reset_Timestamp | 4 Octets | Timestamp indicating the completion of the most recent HCI Reset. This field is utilized for the express purpose of facilitating the resolution of timing-related issues. It should serve as the initial recording point against which all other items are referenced. |
Current_Timestamp | 4 Octets | The present time when this event is generated. This field is utilized for the purpose of troubleshooting timing discrepancies. It should serve as the trigger recording point that all other elements reference. |
Is_WatchDog_Timer_About_To_Expire | 4 Octets | Flag to denote that this health status event is generated by the controller as an early warning of watch dog expiration. The current timestamp serves to indicate the time of occurrence. |
Coex_Status_Mask | 2 Octets | Bit 0 - Reserved |
Total_Links_BR_EDR_LE_Active | 1 Octet | Total link count of BR/EDR/LE in Active state. |
Total_Links_BR_EDR_Sniff | 1 Octet | Total link count of BR/EDR in Sniff/Idle state. |
Total_Links_CIS | 1 Octet | Total link count of ISO. |
Is_SCO_Active | 1 Octet | Indicator to check if the SCO link is currently activated. |
Subevent code = 0x58 [Quality_Report_Id = 0x11 ~ 0x13, Log Dump related event]
| Subevent Parameter | আকার | উদ্দেশ্য |
|---|---|---|
Quality_Report_Id | 1 octet | 0x00 ~ 0x10: Reserved. 0x11: LMP/LL message trace. 0x12: Bluetooth Multi-link/Coex scheduling trace. 0x13: Controller Debug Information data dump. 0x14 ~ 0xFF: Reserved. |
Connection_Handle | 2 octets | Connection Handle. |
| Vendor Specific Parameter | (Parameter Total Length - 4) * octets | Vendor Specific format of LMP message trace, Bluetooth Multi-link/Coex scheduling trace and Controller Debug Information data dump. |
ISO Link Feedback subevent
Sub event code = 0x5C
When activated, this event must be generated during each ISO interval.
সক্রিয়করণ
The activation is performed by selecting the vendorData_Path_ID code 0x19 in the HCI_LE_Setup_ISO_Data_Path standard command. The HCI_Configure_Data_Path command with the Data_Path_ID set to 0x19 and Vendor_Specific_Config_Length set to 0 , must be accepted, even if no action is expected from the controller upon reception of this command.Dispatching time point
The event is emitted from the start of an ISO interval (CIG or BIG anchor point), to the following ISO interval. The controller indicates the delay with the effective start of the ISO interval usingAnchor_Point_Delay .Controller synchronization
At the start of an ISO interval, the controller computes Stream SN by incrementing the current value by the configuredISO_Interval ÷ SDU_Interval ; on the first interval, it's initialized to 0.Then, for each packet in the ISO FIFO, the following applies:
- The controller calculates the wrapping difference SN diff between the two sequence numbers:
SN diff = (SDU SN - Stream SN + 0x10000) mod 0x10000 - When
(SN diff + (FT-1) × ISO_Interval ÷ SDU_Interval) mod 0x10000 <= (FT-1) × ISO_Interval ÷ SDU_Interval:
The packet is in the re-transmission window. It should have been scheduled for transmission at previous intervals and is now available for re-transmission. If this isn't the case (it hasn't been scheduled for transmission), it has been late received . This must be signaled to the host using theIn_Status. Such packets can be discarded or scheduled for transmission; the choice is implementation-defined. - Or when
SN diff < ISO_Interval ÷ SDU_Interval:
The packet is scheduled for transmission from this event until the flush timeout occurs. - Or when
SN diff >= ISO_Interval ÷ SDU_IntervalandSN diff <= Max_Forward_Buffers:
The packet is in the future; it will be transmitted with a subsequent event. As the packets are sent in order, this condition ends the search for packets for this interval.
The buffers used by the host isn't communicated to the controller, but is limited toMax_Forward_Buffers = 16. - Or when none of the above conditions are met:
The packet is discarded, the flush timeout limit is reached, or a malformed packet has been received.
| Subevent parameter | আকার | উদ্দেশ্য |
|---|---|---|
Connection_Handle | 2 octets | Connection handle of the CIS or BIS Range: 0x0000 to 0x0EFF |
Sequence_Number | 2 octets | Sequence number of the stream, managed by the controller. Initialized to 0 when the CIS or BIS is created, and incremented by the number of SDUs by ISO Isochronous interval, defined as ISO_interval ÷ SDU_Interval , at each ISO interval. |
Anchor_Point_Delay | 2 octets | Delay in microseconds between the generation of the event and the effective BIG or CIG anchor point or start of the ISO interval. The effective anchor point timestamp is defined by:Event generation time - Anchor_Point_DelayRange: 0 to ISO interval in microseconds |
In_Status | 2 octets | Controller ISO buffer status At the start of an ISO interval, each bit b i is set when the SDU (Sequence_Number + i) mod 0x10000 is available. When not available, the SDU is identified as Not received from the host .The value i ranges from 0 to ISO_Interval ÷ SDU_Interval - 1 . For other values of i , the bits are set to 0. | Tx_Status | 2 octets | Transmission status, relative to the SDUs with sequence numbers:(Sequence_Number - Flush_Timeout × ISO_Interval ÷ SDU_Interval + i + 0x10000) mod 0x10000Each bit b i is set when all the PDUs of the identified SDU, by its sequence number, have been successfully transmitted, and acknowledged. The value i ranges from 0 to ISO_Interval ÷ SDU_Interval - 1 . For other values of i , the bits are set to 0.On a broadcast group, the transmission is always supposed to be acknowledged. |
Multi-advertiser support
The objectives of multi-advertiser support are the following:
- Ability to support multiple advertisements (
max_advt_instances) - Different transmit powers to allow for a varying range
- Different advertising content
- An individualized response for each advertiser
- Privacy (non-trackable) for each advertiser
- সংযোগযোগ্য
To keep this specification close to existing standards, the following vendor-specific commands are provided. They are derived from the Bluetooth Core 4.1 Specification.
LE_Multi_Advt_Command
OCF: 0x154
| Command parameter | আকার | উদ্দেশ্য |
|---|---|---|
Multi_advt_opcode | 1 octet | 0x01 - Set_Advt_Param_Multi_Sub_Cmd0x02 - Set_Advt_Data_Multi_Sub_Cmd0x03 - Set_Scan_Resp_Data_Multi_Sub_Cmd0x04 - Set_Random_Addr_Multi_Sub_Cmd0x05 - Set_Advt_Enable_Multi_Sub_Cmd |
A Command Complete event will be generated for this command.
| Return parameter | আকার | উদ্দেশ্য |
|---|---|---|
Status | 1 octet | Command Complete status |
Multi_advt_opcode | 1 octet | 0x01 - Set_Advt_Param_Multi_Command0x02 - Set_Advt_Data_Multi_Command0x03 - Set_Scan_Resp_Data_Multi_Command0x04 - Set_Random_Addr_Multi_Command0x05 - Set_Advt_Enable_Multi_Command |
LE_Multi_Advt_Command: Set_Advt_Param_Multi_Sub_Cmd
Base reference: Bluetooth Core 4.1 Specification, page 964 (LE Set Advertising Parameter Command)
Sub OCF: 0x01
| Subcommand parameter | আকার | উদ্দেশ্য |
|---|---|---|
Advertising_Interval_Min | Per spec | Per spec |
Advertising_Interval_Max | Per spec | Per spec |
Advertising_Type | Per spec | Per spec |
Own_Address_Type | Per spec | Per spec |
Own_Address | Per spec | Per spec |
Direct_Address_Type | Per spec | Per spec |
Direct_Address | Per spec | Per spec |
Advertising_Channel_Map | Per spec | Per spec |
Adverstising_Filter_Policy | Per spec | Per spec |
Advertising_Instance | 1 octet | Specifies the applicability of the above parameters to an instance |
Tx_power | 1 octet | Transmit_Power Unit - in dBm (signed integer) Range (-70 to +20) |
The Own_Address parameter could be a host-configured address at the time of setting up this multi-advertisement instance. This provides the ability to have a resolvable private address at the time of the transmit of the first beacon. Advertisement on an instance will continue irrespective of the connection. The host BT stack could issue a command to start advertisement on an instance, post connection.
A Command Complete event will be generated for this command as specified in the Bluetooth Core 4.1 Specification, per the above command. The controller will respond with a non-success (invalid parameter) code if the advertising instance or Tx_Power parameters are invalid.
| Return parameter | আকার | উদ্দেশ্য |
|---|---|---|
Status | 1 octet | Command Complete status |
Multi_advt_opcode | 1 octet | 0x01 [ Set_Advt_Param_Multi_Sub_Cmd] |
LE_Multi_Advt_Command: Set_Advt_Data_Multi_Sub_Cmd
Base reference: Bluetooth Core 4.1 Specification, page 969 (LE Set Advertising Data Command)
Sub OCF: 0x02
| Subcommand parameter | আকার | উদ্দেশ্য |
|---|---|---|
Advertising_Data_Length | Per spec | Per spec |
Advertising_Data | Per spec | Per spec |
Advertising_Instance | 1 octet | Specifies the applicability of the above parameters to an instance |
A Command Complete event will be generated for this command as specified in the Bluetooth Core 4.1 Specification, per the above command. The controller will respond with a non-success code if the advertising instance or Tx_Power parameters are invalid.
| Return parameter | আকার | উদ্দেশ্য |
|---|---|---|
Status | 1 octet | Command Complete status |
Multi_advt_opcode | 1 octet | 0x02 [ Set_Advt_Data_Multi_Sub_Cmd] |
LE_Multi_Advt_Command: Set_Scan_Resp_Data_Multi_Sub_Cmd
Base reference: Bluetooth Core 4.1 Specification, page 970 (LE Set Scan Response Data Command)
Sub OCF: 0x03
| Subcommand parameter | আকার | উদ্দেশ্য |
|---|---|---|
Scan_Response_Data_Length | Per spec | Per spec |
Scan_Response_Data | Per spec | Per spec |
Advertising_Instance | 1 octet | Specifies the applicability of the above parameters to an instance |
A Command Complete event will be generated for this command as specified in the Bluetooth Core 4.1 Specification, per the above command. The controller will respond with a non-success code (invalid parameter) if the advertising instance or Tx_Power parameters are invalid.
| Return parameter | আকার | উদ্দেশ্য |
|---|---|---|
Status | 1 octet | Command Complete status |
Multi_advt_opcode | 1 octet | 0x03 [ Set_Scan_Resp_Data_Multi_Sub_Cmd] |
LE_Multi_Advt_Command: Set_Random_Addr_Multi_Sub_Cmd
Base reference: Bluetooth Core 4.1 Specification, page 963 (LE Set Random Address Command)
Sub OCF: 0x04
| Subcommand parameter | আকার | উদ্দেশ্য |
|---|---|---|
| এলোমেলো ঠিকানা | Per spec | Per spec |
Advertising_Instance | 1 octet | Specifies the applicability of the above parameters to an instance |
A Command Complete event will be generated for this command.
| Return parameter | আকার | উদ্দেশ্য |
|---|---|---|
Status | 1 octet | Command Complete status |
Multi_advt_opcode | 1 octet | 0x04 [ Set_Random_Addr_Multi_Sub_Cmd] |
LE_Multi_Advt_Command: Set_Advt_Enable_Multi_Sub_Cmd
Base reference: Bluetooth Core 4.1 Specification, page 971 (LE Set Advertise Enable Command in that core specification)
OCF: 0x05
| Subcommand parameter | আকার | উদ্দেশ্য |
|---|---|---|
Advertising_Enable | 1 octet | A value of 1 means enable. Any other value means disable. |
Advertising_Instance | 1 octet | Specifies the applicability of the above parameters to an instance. Instance 0 means a standard HCI instance. |
A Command Complete event will be generated for this command.
| Return parameter | আকার | উদ্দেশ্য |
|---|---|---|
Status | 1 octet | Command Complete status |
Multi_advt_opcode | 1 octet | 0x05 [ Set_Advt_Enable_Multi_Sub_Cmd] |
Offloaded resolution of private address
This feature resolves a private address in the controller firmware or hardware, which provides the following benefits:
- Latency involved with the host in resolving a private address
- Saving power by refraining from waking up the host
LE_Set_RPA_Timeout
OCF: 0x15C
| Command parameter | আকার | উদ্দেশ্য |
|---|---|---|
LE_local_IRK | 16 octet | The local device IRK used to generate the random resolvable address(es). |
tRPA_min | 2 octets | The minimum RPA generation timeout in seconds. The controller must generate new resolvable addresses for any advertising/scanning/connection events on or after this timeout. Valid range: 300-1800 |
tRPA_max | 2 octets | The maximum RPA generation timeout in seconds. The controller must generate new resolvable addresses for any advertising/scanning/connection events on or before this timeout. Valid range: tRPA_min -1800 |
| Return parameter | আকার | উদ্দেশ্য |
|---|---|---|
Status | 1 octet | The status of the command. Suggested HCI status values: 0x00 Success 0x01 Unknown command (if not supported) 0x12 Invalid command parameters (if any parameters are outside the given range) |
LE_RPA_offload_Command
OCF: 0x155
| Command parameter | আকার | উদ্দেশ্য |
|---|---|---|
RPA_offload_opcode | 1 octet | 0x1 - Enable customer specific feature 0x2 - Add IRK to the list 0x3 - Remove IRK from the list 0x4 - Clear IRK list 0x5 - Read IRK list entry |
A Command Complete event will be generated for this command.
| Return parameter | আকার | উদ্দেশ্য |
|---|---|---|
Status | 1 octet | Command Complete status |
Event_RPA_offload_opcode | 1 octet | 0x1 - Enable customer specific feature 0x2 - Add IRK to the list 0x3 - Remove IRK from the list 0x4 - Clear IRK list 0x5 - Read IRK list entry |
LE_RPA_offload: Enable_cust_specific_sub_Command
Sub OCF: 0x01
| Subcommand parameter | আকার | উদ্দেশ্য |
|---|---|---|
enable_customer_specific_feature_set | 1 octet | 0x01 - Enable offloaded RPA feature 0x00 - Disable offloaded RPA feature |
RPA offload is required to be enabled by the host, based on the chip capability. Refer to the LE_Get_Vendor_Capabilities_Command . Each chip can have a varying max_irk_list_sz in the firmware.
A Command Complete event will be generated for this command.
| Return parameter | আকার | উদ্দেশ্য |
|---|---|---|
Status | 1 octet | Command Complete status |
Event_cust_specific_feature_opcode | 1 octet | 0x01 [Enable customer-specific feature] |
LE_RPA_offload: Add_IRK_to_list_sub_Command
Sub OCF: 0x02
| Subcommand parameter | আকার | উদ্দেশ্য |
|---|---|---|
LE_IRK | 16 octets | LE IRK (1st byte LSB) |
Address_Type | 1 octet | 0: Public address 1: Random address |
LE_Device_Address | 6 octets | Public or random address associated to the IRK (1st byte LSB) |
A Command Complete event will be generated for this command.
| Return parameter | আকার | উদ্দেশ্য |
|---|---|---|
Status | 1 octet | Command Complete status |
Event_cust_specific_feature_opcode | 1 octet | 0x02 [Add IRK to the list] |
LE_IrkList_AvailableSpaces | 1 octet | Available IRL list entries after current operation |
LE_RPA_offload: Remove_IRK_to_list_sub_Command
Sub OCF: 0x03
| Subcommand parameter | আকার | উদ্দেশ্য |
|---|---|---|
Address_Type | 1 octet | 0: Public address 1: Random address |
LE_Device_Address | 6 octets | Public or random address that associates to the IRK |
A Command Complete event will be generated for this command.
| Return parameter | আকার | উদ্দেশ্য |
|---|---|---|
Status | 1 octet | Command Complete status |
Event_cust_specific_feature_opcode | 1 octet | 0x03 [Remove IRK from the list] |
LE_IrkList_AvailableSpaces | 1 octet | Available IRL list entries after current operation |
LE_RPA_offload: Clear_IRK_list_sub_Command
Sub OCF: 0x04
| Subcommand parameter | আকার | উদ্দেশ্য |
|---|---|---|
| কোনটিই নয় |
A Command Complete event will be generated for this command.
| Return parameter | আকার | উদ্দেশ্য |
|---|---|---|
Status | 1 octet | Command Complete status |
Event_cust_specific_feature_opcode | 1 octet | 0x04 [Clear IRK List] |
LE_IrkList_AvailableSpaces | 1 octet | Available IRL list entries after current operation [ max_irk_list_sz] |
LE_RPA_offload: Read_IRK_list_sub_Command
Sub OCF: 0x05
| Subcommand parameter | আকার | উদ্দেশ্য |
|---|---|---|
LE_read_IRK_list_entry-index | 1 octet | Index of the IRK list [0, max_irk_list_sz-1] |
A Command Complete event will be generated for this command.
| Return parameter | আকার | উদ্দেশ্য |
|---|---|---|
Status | 1 octet | Command Complete status |
Event_cust_specific_feature_opcode | 1 octet | 0x05 [Read IRK List Entry] |
LE_Read_IRK_List_entry | 1 octet | Index of the IRK that the host wants to read back (maximum IRK list size is 32) |
LE_IRK | 16 octets | IRK value |
Address_Type | 1 octet | 0: Public address 1: Random address |
LE_Device_Address | 6 octets | Public or random address associated to the IRK |
LE_Resolved_Private_Address | 6 octets | Current resolved resolvable private address of this IRK |
Sniff Offload
The Sniff Offload feature offloads Sniff mode management from the Bluetooth host stack to the Bluetooth controller. This allows the controller to manage the timing of entering/exiting Sniff mode and applying configurable Sniff and Sniff sub-rating parameters, while the host retains control over parameter selection based on Bluetooth profile activity changes.
Sniff Offload States
This section defines the states within a Bluetooth controller with respect to the Sniff Offload function. Two global states have been defined to identify a Bluetooth controller's status with respect to Sniff Offload enablement. Two connection specific states have been defined to identify a BR/EDR connection's status when the Bluetooth controller is in Sniff Offload Enabled state.
বিশ্বব্যাপী রাষ্ট্রসমূহ
Two global states have been defined to identify a Bluetooth controller's status with respect to Sniff Offload enablement.
স্নিফ অফলোড অক্ষম অবস্থা
A Bluetooth controller is considered to be in a 'Sniff Offload Disabled' state by default. It is expected that the Bluetooth controller shall handle the HCI_Sniff_Mode, HCI_Exit_Sniff_Mode and HCI_Sniff_Subrating commands issued from a Bluetooth host. The Bluetooth controller shall also forward the HCI_Mode_Change and HCI_Sniff_Subrating events to a Bluetooth host as per the event mask set by the Bluetooth host.
Sniff Offload Enabled State
A Bluetooth controller is considered to be in a 'Sniff Offload Enabled' state after it has successfully handled a 'WriteSniffOffloadEnable' to enable Sniff Offload. In this state the Bluetooth controller is expected to forward the HCI_Mode_Change and HCI_Sniff_Subrating events to a Bluetooth host as decided by a logical-AND function of the event mask set by the Bluetooth host and the Event Suppression Flags.
সংযোগ নির্দিষ্ট অবস্থা
When a Bluetooth controller is in a 'Sniff Offload Enabled' state, each active ACL can be in one of the two described below states.
Pending-Parameter State
An ACL is considered to be in a 'Pending-Parameters' state when the Bluetooth controller is in 'Sniff Offload Enabled' state, but a 'WriteSniffOffloadParameters' vendor specific command has not been issued at least once by the Bluetooth host for the present ACL.
Control-Started State
An ACL is considered to be in a 'Control-Started'' state when the Bluetooth controller is in 'Sniff Offload Enabled' state, and a 'WriteSniffOffloadParameters' vendor specific command has been issued at least once by the Bluetooth host for the present ACL.
WriteSniffOffloadসক্রিয় করুন
OCF: 0x310
| Command parameter | আকার | উদ্দেশ্য |
|---|---|---|
Enable_Sniff_Offload | 1 octet | 0x00 : Disable 0x01 : Enable |
Subrating_Max_Latency | 2 octets | The Maximum Latency parameter shall be used to calculate the maximum sniff subrate that the remote device may use. Default: T*sniff* Latency = N × 0.625 ms (1 Baseband slot) Range: 0x0002 to 0xFFFE Time Range: 1.25 ms to 40.9 s |
Subrating_Min_Remote_Timeout | 2 octets | Minimum sniff mode timeout (T*sniff_mode_timeout*) that the remote device may use Default: 0x0000 Timeout = N × 0.625 ms (1 Baseband slot) Range: 0x0000 to 0xFFFE Time Range: 0 s to 40.9 s |
Subrating_Min_Local_Timeout | 2 octets | Minimum sniff mode timeout (T*sniff_mode_timeout*) that the local device may use. Default: 0x0000 Timeout = N × 0.625 ms (1 Baseband slot) Range: 0x0000 to 0xFFFE Time Range: 0 s to 40.9 s |
Suppress_Mode_Change_Event | 1 octet | 0x00 : The Bluetooth controller shall report the HCI Mode_Change event to the host subject to the configuration set in HCI_Set_Event_Mask command. 0x01 : The Bluetooth controller shall not report the HCI Mode_Change event to the host. |
Suppress_Sniff_Subrating_Event | 1 octet | 0x00 : The Bluetooth controller shall report the HCI Sniff_Subrating event to the host subject to the configuration set in HCI_Set_Event_Mask command. 0x01 : The Bluetooth controller shall not report the HCI Sniff_Subrating event to the host. |
WriteSniffOffloadParameters সম্পর্কে
OCF: 0x311
| Command parameter | আকার | উদ্দেশ্য |
|---|---|---|
Connection_Handle | 2 octets | 16-bit BR/EDR ACL connection handle. Range: 0x0000 to 0x0EFF |
Sniff_Max_Interval | 2 octets | –Bluetooth SIG Defined range, ordinarily used for entry to Sniff mode. Range: 0x0002 to 0xFFFE; only even values are valid Mandatory Range: 0x0006 to 0x0540 Time = N × 0.625 ms Time Range: 1.25 ms to 40.9 s –Special Cases 0x0000 : Used to select “Push-Active” Sniff-Offload Mode. 0x0001 : Used to select “Prefer-Active” Sniff-Offload Mode. |
Sniff_Min_Interval | 2 octets | Range: 0x0002 to 0xFFFE; only even values are valid Mandatory Range: 0x0006 to 0x0540 Time = N × 0.625 ms Time Range: 1.25 ms to 40.9 s |
Sniff_Attempts | 2 octets | Number of Baseband receive slots for sniff attempt. Length = N × 1.25 ms Range: 0x0001 to 0x7FFF Time Range: 1.25 ms to 40.9 s Mandatory Range for Controller: 1 to T*sniff* ÷ 2 |
Sniff_Timeout | 2 octets | Number of Baseband receive slots for sniff timeout. Length = N × 1.25 ms Range: 0x0000 to 0x7FFF Time Range: 0 ms to 40.9 s Mandatory Range for Controller: 0 to 0x0028 |
Link_Inactivity_Timeout | 2 octets | Timeout value in milliseconds. Link_Inactivity Timer started/reset at every HCI-ACL transaction. At the expiry of this timer, the controller shall initiate entry to Sniff mode. |
Subrating_Max_Latency | 2 octets | The Maximum Latency parameter shall be used to calculate the maximum sniff subrate that the remote device may use. Default: T*sniff* Latency = N × 0.625 ms (1 Baseband slot) Range: 0x0002 to 0xFFFE Time Range: 1.25 ms to 40.9 s |
Subrating_Min_Remote_Timeout | 2 octets | Minimum sniff mode timeout (T*sniff_mode_timeout*) that the remote device may use Default: 0x0000 Timeout = N × 0.625 ms (1 Baseband slot) Range: 0x0000 to 0xFFFE Time Range: 0 s to 40.9 s |
Subrating_Min_Local_Timeout | 2 octets | Minimum sniff mode timeout (T*sniff_mode_timeout*) that the local device may use. Default: 0x0000 Timeout = N × 0.625 ms (1 Baseband slot) Range: 0x0000 to 0xFFFE Time Range: 0 s to 40.9 s |
Allow_Exit_Sniff_On_Rx | 1 octet | Flag to control exit of Sniff mode on receive-direction HCI-ACL transaction. 0x00 : Do not exit sniff on Rx. 0x01 : Exit Sniff on Rx Receive-direction HCI-ACL is defined as ACL packet transmission from controller to host over HCI. |
Allow_Exit_Sniff_On_Tx | 1 octet | Flag to control exit of Sniff mode on transmit-direction HCI-ACL transaction. 0x00 : Do not exit sniff on Tx. 0x01 : Exit Sniff on Tx Transmit-direction HCI-ACL is defined as ACL packet transmission from host to controller over HCI. |