HCI প্রয়োজনীয়তা

হোস্ট কন্ট্রোলার ইন্টারফেস (HCI) একটি ব্লুটুথ কন্ট্রোলারের সাথে ইন্টারঅ্যাক্ট করার জন্য ব্যবহৃত হয়।

এই নথিটি ব্লুটুথ (বিটি) এবং ব্লুটুথ লো এনার্জি (বিএলই) এইচসিআই প্রয়োজনীয়তার একটি তালিকা প্রদান করে। লক্ষ্য হল হোস্ট BT স্ট্যাক বিক্রেতা এবং BT কন্ট্রোলার বিক্রেতাদের এই প্ল্যাটফর্মের প্রয়োজনীয়তাগুলি মেনে চলার জন্য নীচে বর্ণিত বৈশিষ্ট্য সেট ব্যবহার করার জন্য।

এই নথিটি ব্লুটুথ কোর 5.2 স্পেসিফিকেশনকে "স্পেক" হিসাবে উল্লেখ করে। ব্লুটুথ কোর 5.2 স্পেসিফিকেশন ব্লুটুথ এসআইজি ওয়েবসাইটে অন্যান্য গৃহীত নথির সাথে উপলব্ধ।

সাধারণ নকশা ওভারভিউ

চিপ ক্ষমতা এবং কনফিগারেশন

একটি উন্মুক্ত প্ল্যাটফর্ম হিসাবে, অ্যান্ড্রয়েডে সফ্টওয়্যার রিলিজ, OEM, বিক্রেতা এবং প্ল্যাটফর্ম এবং চিপ ক্ষমতাগুলির একটি ম্যাট্রিক্স রয়েছে৷

পরিবর্তিত ল্যান্ডস্কেপ পরিচালনা করতে এবং মাইগ্রেশন পরিচালনা করতে, বিটি কন্ট্রোলারদের তাদের ক্ষমতা (স্ট্যান্ডার্ড ব্লুটুথ কোর 5.2 স্পেসিফিকেশনের বাইরে) প্রকাশ করার অনুমতি দেওয়ার একটি নকশা দর্শন এই নথিতে বর্ণনা করা হয়েছে। হোস্ট বিটি স্ট্যাক তারপরে কোন বৈশিষ্ট্যগুলি সক্ষম করতে হবে তা নির্ধারণ করতে এই ক্ষমতাগুলি ব্যবহার করতে পারে।

খোলা মান সমর্থন

অ্যান্ড্রয়েডের একটি লক্ষ্য হল একটি ব্লুটুথ স্পেসিফিকেশনে অনুমোদনের পরে উন্মুক্ত মানগুলিকে সমর্থন করা। যদি নীচে বর্ণিত একটি বৈশিষ্ট্য ভবিষ্যতের ব্লুটুথ স্পেসিফিকেশনে স্ট্যান্ডার্ড HCI পদ্ধতিতে উপলব্ধ হয়, আমরা সেই পদ্ধতিটিকে ডিফল্ট করার দিকে ঝুঁকব।

বিক্রেতা-নির্দিষ্ট ক্ষমতা

বিক্রেতা-নির্দিষ্ট কমান্ড: LE_Get_Vendor_Capabilities_Command

OpCode কমান্ড ক্ষেত্র (OCF): 0x153

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

ব্যাচ স্ক্যান ফলাফল

একটি ডিজাইন লক্ষ্য হল ব্লুটুথ LE স্ক্যান রেসপন্স ইভেন্ট বিজ্ঞপ্তিগুলি হোস্টের কাছে কীভাবে বিতরণ করা হয় তা উন্নত করা, যাতে হোস্টে শক্তি সঞ্চয় করা যায়।

ফলাফল স্ক্যান করার জন্য কন্ট্রোলার হোস্ট অ্যাপ প্রসেসরকে কত ঘনঘন অবহিত করে তা কমিয়ে, হোস্ট অ্যাপ প্রসেসর বেশিক্ষণ নিষ্ক্রিয়/নিদ্রায় থাকতে পারে। এটি হোস্টে শক্তি খরচ হ্রাস করে। LE_Get_Vendor_Capabilities_Command এর রিটার্ন প্যারামিটার total_scan_results_storage স্ক্যান ফলাফলের স্টোরেজের জন্য চিপের ক্ষমতা নির্দেশ করে।

এই বৈশিষ্ট্যটি ব্লুটুথ কন্ট্রোলারে LE স্ক্যান ফলাফল স্টোরেজ সুবিধার ব্যবস্থাপনা এবং কনফিগারেশনের উপর দৃষ্টি নিবদ্ধ করে। স্টোরেজটি অস্থায়ীভাবে বিজ্ঞাপনের ডেটা ব্যাচ করতে এবং হোস্টে পরবর্তী ডেলিভারির জন্য নিয়ামক দ্বারা প্রাপ্ত ডেটা এবং মেটাডেটা স্ক্যান করতে ব্যবহৃত হয়।

ফার্মওয়্যার দুটি ধরণের ব্যাচিং সমর্থন করবে, যা একই সাথে নিযুক্ত হতে পারে:

• ছাঁটা। নিম্নলিখিত তথ্য উপাদান রয়েছে: {MAC, TX Power, RSSI, Timestamp}
• পূর্ণ। নিম্নলিখিত তথ্য উপাদান রয়েছে: {MAC, TX Power, RSSI, Timestamp, Adv Data, Scan Response}

LE_Batch_Scan_Command

OCF: 0x156

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে। গ্রাহক-নির্দিষ্ট বৈশিষ্ট্য সক্রিয় করা স্ক্যান শুরু করে না।

LE_Batch_Scan_Command: গ্রাহক-নির্দিষ্ট বৈশিষ্ট্য সক্ষম করুন

সাব OCF: 0x01

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

LE_Batch_Scan_Command: ব্যাচ স্ক্যান স্টোরেজ প্যারামিটার সাবকমান্ড সেট করুন

সাব OCF: 0x02

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

LE_Batch_Scan_Command: ব্যাচ স্ক্যান প্যারামিটার সাবকমান্ড সেট করুন

সাব OCF: 0x03

সক্রিয় থাকলে এই সাবকমান্ড ব্যাচ স্ক্যানিং শুরু করবে। ছেঁটে যাওয়া স্ক্যানিং-এ, ফলাফলগুলি ছেঁটে দেওয়া আকারে সংরক্ষণ করা হয় যেখানে ছেঁটে দেওয়া শৈলীর অনন্য কী = { BD_ADDR, scan_interval}। এর মানে প্রতিটি স্ক্যান ব্যবধানের জন্য শুধুমাত্র একটি BD_ADDR will । ট্রাঙ্কেটেড মোডের জন্য যে রেকর্ড রাখতে হবে তা হল: { BD_ADDR , Tx Power, RSSI, Timestamp}

যখন সম্পূর্ণ মোড সক্ষম হয়, সক্রিয় স্ক্যানিং ব্যবহার করা হবে এবং স্ক্যান প্রতিক্রিয়া রেকর্ড করা হবে। সম্পূর্ণ শৈলী অনন্য কী = {MAC, বিজ্ঞাপন প্যাকেট}, স্ক্যানের ব্যবধান নির্বিশেষে। ফুল মোডের জন্য যে রেকর্ড রাখতে হবে তা হল { BD_ADDR , Tx Power, RSSI, টাইমস্ট্যাম্প, অ্যাড প্যাকেট, স্ক্যান রেসপন্স}। সম্পূর্ণ শৈলীতে, একই AD প্যাকেট, যখন বিভিন্ন স্ক্যান ব্যবধানে একাধিকবার দেখা যায়, শুধুমাত্র একবার রেকর্ড করা হয়। যাইহোক, ছেঁড়া মোডে, এটি বিভিন্ন স্ক্যান ব্যবধানে BA_ADDR এর দৃশ্যমানতা যা আগ্রহের বিষয় (একবার প্রতি স্ক্যান অন্তর)। RSSI হল একটি স্ক্যান ব্যবধানের মধ্যে একটি অনন্য বিজ্ঞাপনের সমস্ত নকলের গড় মান৷

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

LE_Batch_Scan_Command: ব্যাচ স্ক্যান ফলাফল সাবকমান্ড পড়ুন

সাব OCF: 0x04

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে। হোস্ট যখন এই কমান্ডটি জারি করে, তখন কন্ট্রোলারের সমস্ত ফলাফল একটি কমান্ড সম্পূর্ণ ইভেন্টে মাপসই নাও হতে পারে। হোস্ট এই কমান্ডটি জারি করার পুনরাবৃত্তি করবে যতক্ষণ না কমান্ড কমপ্লিট ইভেন্টে সংশ্লিষ্ট ফলাফল রেকর্ডের সংখ্যায় 0 নির্দেশ করে, যা নির্দেশ করে যে হোস্টের সাথে যোগাযোগ করার জন্য কন্ট্রোলারের আর কোন রেকর্ড নেই। প্রতিটি কমান্ড সম্পূর্ণ ইভেন্টে শুধুমাত্র এক ধরনের ডেটার একাধিক রেকর্ড থাকতে পারে (সম্পূর্ণ বা কাটা)।

কন্ট্রোলার এবং হোস্ট টাইম রেফারেন্স সিঙ্ক্রোনাইজ করা হয় না। টাইমস্ট্যাম্পের একক হল 50ms। হোস্ট দ্বারা Read_Batch_Scan_Results_Sub_cmd দেওয়া হলে টাইমস্ট্যাম্পের মান বন্ধ হয়। যদি ফার্মওয়্যারে একটি কমান্ডের আগমনের সময় T_c হয়, তাহলে ফার্মওয়্যারে টাইমস্ট্যাম্প নেওয়ার প্রকৃত সময় হল T_fw । রিপোর্টিং সময় হবে: ( T_c - T_fw )। T_c এবং T_fw ফার্মওয়্যার টাইম ডোমেনে রয়েছে। এটি হোস্টকে গণনা করতে দেয় কতদিন আগে ঘটনাটি ঘটেছে৷

বিজ্ঞাপন প্যাকেট বিষয়বস্তু ফিল্টার

কন্ট্রোলারে বিজ্ঞাপন প্যাকেট কন্টেন্ট ফিল্টার (APCF) সক্ষম/অক্ষম/সেটআপ করতে এটি ব্যবহার করুন। APCF কন্ট্রোলারে বিজ্ঞাপনের রিপোর্ট ফিল্টার করে কিন্তু পর্যায়ক্রমিক বিজ্ঞাপন ফিল্টার করে না।

LE_APCF_Command

OCF: 0x157

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

LE_APCF_Command: Enable_sub_cmd

সাব OCF: 0x00

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

LE_APCF_Command: set_filtering_parameters_sub_cmd

এই সাবকমান্ডটি একটি ফিল্টার স্পেসিফিকেশন যোগ করতে বা মুছতে বা অন-চিপ ফিল্টারিংয়ের জন্য একটি ফিল্টার তালিকা পরিষ্কার করতে ব্যবহৃত হয়।

সাব OCF: 0x01

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 ট্র্যাকিং subevent।

একটি ফিল্টারের জন্য OnFound/OnLost ট্রানজিশন (যদি সক্ষম করা থাকে) নিচের মত দেখাবে:

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

LE_APCF_Command: broadcast_address_sub_cmd

এই সাবকমান্ডটি বিজ্ঞাপনদাতার ঠিকানা যোগ করতে বা মুছতে বা অন-চিপ ফিল্টারিংয়ের জন্য বিজ্ঞাপনদাতার ঠিকানা তালিকা সাফ করতে ব্যবহৃত হয়।

সাব OCF: 0x02

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

LE_APCF_Command: service_uuid_sub_cmd

এই সাবকমান্ডটি একটি পরিষেবা UUID যোগ করতে বা মুছতে বা অন-চিপ ফিল্টারিংয়ের জন্য একটি পরিষেবা UUID তালিকা সাফ করতে ব্যবহৃত হয়।

সাব OCF: 0x03

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

LE_APCF_Command: solicitation_uuid_sub_cmd

এই সাবকমান্ডটি একটি সলিসিটেশন UUID যোগ করতে বা মুছতে বা অন-চিপ ফিল্টারিংয়ের জন্য একটি সলিসিটেশন UUID তালিকা সাফ করতে ব্যবহৃত হয়।

সাব OCF: 0x04

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

LE_APCF_Command: local_name_sub_cmd

এই সাবকমান্ডটি স্থানীয় নামের স্ট্রিং যোগ করতে বা মুছে ফেলতে বা অন-চিপ ফিল্টারিংয়ের জন্য স্থানীয় নামের স্ট্রিং তালিকাটি পরিষ্কার করতে ব্যবহৃত হয়।

সাব OCF: 0x05

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

LE_APCF_Command: manf_data_sub_cmd

এই সাবকমান্ডটি একটি প্রস্তুতকারকের ডেটা স্ট্রিং যোগ করতে বা মুছতে বা অন-চিপ ফিল্টারিংয়ের জন্য প্রস্তুতকারকের ডেটা স্ট্রিং তালিকা সাফ করতে ব্যবহৃত হয়।

সাব OCF: 0x06

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

LE_APCF_Command: service_data_sub_cmd

এই সাবকমান্ডটি একটি পরিষেবা ডেটা স্ট্রিং যোগ করতে বা মুছতে বা অন-চিপ ফিল্টারিংয়ের জন্য পরিষেবা ডেটা স্ট্রিং তালিকা সাফ করতে ব্যবহৃত হয়।

সাব OCF: 0x07

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

LE_APCF_Command: 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 বাইটের তুলনা করুন এবং অবশিষ্ট ডেটা উপেক্ষা করুন৷

সাব OCF: 0x09

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

LE_APCF_Command: read_extended_features_sub_cmd

এই সাবকমান্ডটি বর্ধিত APCF বৈশিষ্ট্যগুলি পড়তে ব্যবহৃত হয়।

সাব OCF: 0xFF

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

কন্ট্রোলার কার্যকলাপ এবং শক্তি তথ্য কমান্ড

এই তথ্যের উদ্দেশ্য হল উচ্চতর হোস্ট সিস্টেম ফাংশনগুলির জন্য BT কন্ট্রোলার এবং এর ম্যাক্রো স্টেট সহ সমস্ত উপাদানগুলির মোট ক্রিয়াকলাপ বিশ্লেষণ করা, অ্যাপস এবং ফ্রেমওয়ার্কে যা ঘটছে তার সাথে একত্রে। এটি করার জন্য, BT স্ট্যাক এবং কন্ট্রোলার থেকে নিম্নলিখিত তথ্য প্রয়োজন:

• BT স্ট্যাক: কন্ট্রোলারের বর্তমান ম্যাক্রো-অপারেশনাল অবস্থার প্রতিবেদন করা
• ফার্মওয়্যার: সামগ্রিক কার্যকলাপ এবং শক্তি তথ্য প্রতিবেদন করা

BT হোস্ট স্ট্যাক ম্যাক্রো অবস্থা, যেমন ব্যবহারকারীর স্তরে নির্ধারিত হয়:

• নিষ্ক্রিয়: [পৃষ্ঠা স্ক্যান, LE বিজ্ঞাপন, অনুসন্ধান স্ক্যান, LE স্ক্যান]
• স্ক্যান: [পেজিং/তদন্ত/সংযোগ করার চেষ্টা করা হচ্ছে]
• সক্রিয়: [ACL লিঙ্ক চালু, SCO লিঙ্ক চলমান, স্নিফ মোড]

নিয়ন্ত্রক তার জীবনের উপর যে কার্যকলাপগুলি ট্র্যাক রাখে তা হল Tx সময়, Rx সময়, নিষ্ক্রিয় সময়, এবং মোট শক্তি খরচ হয়। হোস্ট থেকে পড়া যখন তারা সাফ করা হয়.

LE_Get_Controller_Activity_Energy_Info

এটি একটি বিক্রেতা-নির্দিষ্ট কমান্ড।

OCF: 0x159

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

LE বর্ধিত সেট স্ক্যান প্যারামিটার কমান্ড

এই কমান্ডটি কন্ট্রোলারে একটি বড় স্ক্যান উইন্ডো এবং ব্যবধান সক্রিয় করতে ব্যবহার করা যেতে পারে। বিটি কোর 5.2 স্পেসিফিকেশন অনুসারে, একটি স্ক্যান উইন্ডো এবং ব্যবধানের 10.24 সেকেন্ডের ঊর্ধ্বসীমা সীমা থাকে, যা অ্যাপগুলির জন্য 10.24 সেকেন্ডের বেশি স্ক্যানের ব্যবধানকে বাধা দেয়।

বেস রেফারেন্স: বিটি কোর 5.2 স্পেসিফিকেশন, পৃষ্ঠা 2493 (এলই সেট স্ক্যান প্যারামিটার কমান্ড)

OCF: 0x15A

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

কন্ট্রোলার ডিবাগ তথ্য কমান্ড পান

এই তথ্য উপাদানটির উদ্দেশ্য হল পোস্ট-প্রসেসিং এবং বিশ্লেষণের জন্য বাইনারি আকারে একটি হোস্টের দ্বারা কন্ট্রোলার ডিবাগ তথ্য অর্জন করা। এটি মাঠের সমস্যাগুলি ডিবাগ করতে সহায়তা করে এবং বিশ্লেষণের জন্য তথ্য লগ করার জন্য ইঞ্জিনিয়ারদের একটি টুলকিট প্রদান করে। একটি কন্ট্রোলার ইভেন্টের (কন্ট্রোলার ডিবাগ ইনফো সাব-ইভেন্ট) মাধ্যমে বা স্বায়ত্তশাসিতভাবে যখন কন্ট্রোলারের ইচ্ছা অনুযায়ী হোস্ট দ্বারা অনুরোধ করা হয় তখন তথ্য প্রদান করতে পারে। উদাহরণ ব্যবহার ফার্মওয়্যার স্টেট তথ্য, ক্র্যাশ ডাম্প তথ্য, লগিং তথ্য ইত্যাদি রিপোর্ট করা হতে পারে।

OCF: 0x15B

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

A2DP হার্ডওয়্যার অফলোড সমর্থন

A2DP অফলোড বৈশিষ্ট্যটি BT কন্ট্রোলারের সাথে সংযুক্ত একটি অডিও প্রসেসরে A2DP অডিও এনকোডিং প্রক্রিয়ার অফলোড সমর্থন করে। এনকোড করা অডিও ডাটা স্ট্রীম সরাসরি অডিও প্রসেসর থেকে বিটি কন্ট্রোলারে চলে যায় বিটি হোস্টের অংশগ্রহণ ছাড়াই। BT হোস্ট এখনও A2DP সেশনের কনফিগারেশন এবং নিয়ন্ত্রণের জন্য দায়ী। কমান্ডের দুটি সংস্করণ উপলব্ধ। সাব OCF 0x01-0x02 সহ লিগ্যাসি কমান্ডগুলি শুধুমাত্র ওপেন সোর্স কোডেক সমর্থন করে৷ Sub-OCF 0x03-0x04 সহ সংস্করণগুলি কনফিগার করা কোডেকের কাছে অজ্ঞেয়বাদী৷

OCF: 0x15D

A2DP অফলোড শুরু করুন (উত্তরাধিকার)

সাব OCF: 0x01

A2DP অফলোড প্রক্রিয়া কনফিগার করতে এবং A2DP স্ট্রীম শুরু করতে উভয়ই এই কমান্ডটি ব্যবহার করুন।

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

A2DP অফলোড শুরু করুন

সাব OCF: 0x03

A2DP অফলোড প্রক্রিয়া কনফিগার করতে এবং A2DP স্ট্রীম শুরু করতে উভয়ই এই কমান্ডটি ব্যবহার করুন।

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

A2DP অফলোড বন্ধ করুন (উত্তরাধিকার)

সাব OCF: 0x02

এই কমান্ডটি A2DP অফলোড স্ট্রীম বন্ধ করতে ব্যবহৃত হয়।

এই কমান্ডের জন্য কোন পরামিতি সংজ্ঞায়িত করা হয় না।

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

A2DP অফলোড বন্ধ করুন

সাব OCF: 0x04

এই কমান্ডটি A2DP অফলোড স্ট্রীম বন্ধ করতে ব্যবহৃত হয়।

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

ব্লুটুথ কোয়ালিটি রিপোর্ট কমান্ড

বিটি কোয়ালিটি রিপোর্ট কমান্ড ফিচারটি ব্লুটুথ কন্ট্রোলারে মেকানিজম শুরু করে যাতে হোস্টকে ব্লুটুথ কোয়ালিটি ইভেন্ট রিপোর্ট করা যায়। আপনি চারটি বিকল্প সক্ষম করতে পারেন:

• কোয়ালিটি মনিটরিং মোড: কন্ট্রোলার পর্যায়ক্রমে হোস্টের কাছে একটি লিঙ্ক কোয়ালিটি সম্পর্কিত বিকিউআর সাবইভেন্ট পাঠায়।
• অ্যাপ্রোচিং এলএসটিও: লিঙ্ক সুপারভিশন টাইমআউট (এলএসটিও) মানের অর্ধেকের বেশি সময় ধরে সংযুক্ত বিটি ডিভাইস থেকে কোনও প্যাকেট না পাওয়া গেলে, নিয়ন্ত্রক হোস্টের কাছে একটি এলএসটিও ইভেন্টের কাছে রিপোর্ট করে।
• এ 2 ডিপি অডিও চপ্পি: যখন নিয়ামক চপ্পি অডিওর কারণগুলির কারণগুলি সনাক্ত করে, তখন নিয়ামক হোস্টের কাছে একটি এ 2 ডিপি অডিও চপ্পি ইভেন্টের প্রতিবেদন করে।
• )
• রুট প্রদাহ: এইচএল বা নিয়ামক যখন মারাত্মক ত্রুটির মুখোমুখি হয় এবং ব্লুটুথ পুনরায় চালু করতে হয় তখন এই ইভেন্টটি কন্ট্রোলার দ্বারা স্ট্যাকের কাছে প্রেরণ করা হয়।
• এলএমপি/এলএল বার্তা ট্রেস: কন্ট্রোলার এলএমপি/এলএল বার্তা হ্যান্ডশেকিংকে দূরবর্তী ডিভাইস সহ হোস্টের কাছে প্রেরণ করে।
• ব্লুটুথ মাল্টি-প্রোফাইল/কোয়েক্স শিডিয়ুলিং ট্রেস: কন্ট্রোলার তার সময়সূচী তথ্য একাধিক ব্লুটুথ প্রোফাইল এবং ওয়্যারলেস সহাবস্থান পরিচালনা করার বিষয়ে 2.4 গিগাহার্টজ ব্যান্ডে হোস্টের কাছে প্রেরণ করে।
• কন্ট্রোলার ডিবাগ ইনফরমেশন মেকানিজম: সক্ষম করা হলে, নিয়ামক স্বায়ত্তশাসিতভাবে ডিবাগ লগিং তথ্যটি কন্ট্রোলার ডিবাগ তথ্যের মাধ্যমে হোস্টের কাছে সাবভেন্টের মাধ্যমে প্রতিবেদন করতে পারে।
• লে অডিও চপ্পি: যখন নিয়ামক চপ্পি অডিওর কারণগুলি সনাক্ত করে, তখন নিয়ামক হোস্টকে একটি লে অডিও চপ্পি ইভেন্টের প্রতিবেদন করে।
• অগ্রিম আরএফ স্ট্যাটাস মোড: কন্ট্রোলার তার আরএফ পরিসংখ্যান সম্পর্কিত তথ্য হোস্টের কাছে রিপোর্ট করে, দুটি প্রতিবেদনের ব্যবহারের ক্ষেত্রে সমর্থন করে:
  • পর্যায়ক্রমিক প্রতিবেদন
  • ইভেন্ট ট্রিগারস (স্ট্রিম স্টার্ট/স্টপ এবং লিঙ্ক মানের ইভেন্ট ট্রিগার)।
• ব্লুটুথ কোয়ালিটি রিপোর্ট কমান্ডের বিকিউআর_আরপোর্ট_অ্যাকশন: হোস্ট এই এইচসিআই কমান্ডটি গুণমান মনিটরিং মোড, এনার্জি মনিটর মোড বা অ্যাডভান্স আরএফ স্ট্যাটাস মোডের জন্য এক সময়ের ক্যোয়ারী পেতে ব্যবহার করতে পারে।

ওসিএফ: 0x15e

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

গতিশীল অডিও বাফার কমান্ড

গতিশীল অডিও বাফার বিভিন্ন পরিস্থিতিতে ভিত্তিতে ব্লুটুথ কন্ট্রোলারে অডিও বাফার আকার পরিবর্তন করে অডিও গ্লিচিং হ্রাস করে।

ওসিএফ: 0x15f

অডিও বাফার সময় সক্ষমতা পান

সাব ওসিএফ: 0x01

ব্লুটুথ কন্ট্রোলার থেকে অডিও বাফার সময় সক্ষমতা পেতে এই কমান্ডটি ব্যবহার করুন।

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

অডিও বাফার সময় সেট করুন

সাব ওসিএফ: 0x02

ব্লুটুথ কন্ট্রোলারে অডিও বাফার সময় সেট করতে এই কমান্ডটি ব্যবহার করুন।

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

এইচসিআই ইভেন্ট (বিক্রেতা-নির্দিষ্ট)

কিছু ক্ষেত্রে বিক্রেতা-নির্দিষ্ট এইচসিআই ইভেন্টগুলির প্রয়োজন। বিটি কোর 5.2 স্পেসিফিকেশনের 1897 পৃষ্ঠায় চিত্র 5.4 দেখুন। ইভেন্ট প্যারামিটার 0 এ সর্বদা প্রথম সাবভেন্ট কোড থাকবে, যার ভিত্তিতে এইচসিআই ইভেন্টের বাকি অংশটি ডিকোড করা হয়েছে।

স্টোরেজ থ্রেশহোল্ড লঙ্ঘন সাবভেন্ট

এই ইভেন্টটি ইঙ্গিত দেয় যে স্টোরেজ থ্রেশহোল্ডটি লঙ্ঘন করা হয়েছে।

সাবভেন্ট কোড = 0x54

লে মাল্টি-অ্যাডভার্টাইজিং রাষ্ট্র পরিবর্তন সাবভেন্ট

এই ইভেন্টটি ইঙ্গিত দেয় যে একটি বিজ্ঞাপনের উদাহরণ তার অবস্থা পরিবর্তন করেছে। এই মুহুর্তে, এই ইভেন্টটি কেবল সংযোগের ফলে কোন বিজ্ঞাপনের উদাহরণটি বন্ধ করা হয়েছিল তা নির্দেশ করতে ব্যবহৃত হয়।

সাবভেন্ট কোড = 0x55

লে বিজ্ঞাপন ট্র্যাকিং সাবভেন্ট

এই ইভেন্টটি নির্দেশ করে যখন কোনও বিজ্ঞাপনদাতাকে পাওয়া যায় বা হারিয়ে যায়।

সাব ইভেন্ট কোড = 0x56

নিয়ামক ডিবাগ তথ্য সাবভেন্ট

এই ইভেন্টটি কোনও হোস্টকে বাইনারি ডিবাগের তথ্য সরবরাহ করতে একজন নিয়ামক ব্যবহার করেন।

সাবভেন্ট কোড = 0x57

ব্লুটুথ মানের রিপোর্ট সাবভেন্ট

এই ইভেন্টটি নিম্নলিখিতগুলির মধ্যে একটিকে নির্দেশ করে: একটি ব্লুটুথ মানের ইভেন্ট ঘটেছে, নিয়ামক এলএমপি/এলএল বার্তা ট্রেস এবং ব্লুটুথ মাল্টি-লিংক/কোয়েক্স শিডিয়ুলিং ট্রেস, বা কন্ট্রোলার ডাম্পড ডিবাগ তথ্য ডেটা আপলোড করেছে।

সাবভেন্ট কোড = 0x58 [কোয়ালিটি_আরপোর্ট_আইডি = 0x01 ~ 0x04, লিঙ্ক মানের সম্পর্কিত ইভেন্ট]

সাবভেন্ট কোড = 0x58 [কোয়ালিটি_আরপোর্ট_আইডি = 0x05, রুট প্রদাহ ইভেন্ট]

এই ইভেন্টটি ইঙ্গিত দেয় যে ব্লুটুথ এইচএল বা নিয়ামক একটি মারাত্মক ত্রুটির মুখোমুখি হয়েছিল এবং এই পরিস্থিতিটি রেকর্ড করতে এবং পুনরায় চালু করতে ব্লুটুথ স্ট্যাকের প্রয়োজন হয়। কন্ট্রোলারকে অবশ্যই যে কোনও ক্ষেত্রে ডিবাগ তথ্য ইভেন্টগুলির প্রথম খণ্ডটি প্রেরণের আগে ব্লুটুথ স্ট্যাকের জন্য একটি ROOT_INFLAMMATION_EVENT প্রেরণ করতে হবে।

ত্রুটি_কোড প্যারামিটারে এইচএল/কন্ট্রোলার থেকে রিপোর্ট করা একটি ত্রুটি কোড রয়েছে, 0 যদি এটি চিপসেট বিক্রেতার নির্দিষ্ট ত্রুটি হয়। বিক্রেতা_স্পেসিফিক_আরআর_কোডে এইচএল/কন্ট্রোলার থেকে একটি চিপসেট বিক্রেতার নির্দিষ্ট ত্রুটি কোড রয়েছে। এটি 0 হিসাবে সেট করা উচিত যদি প্যারামিটার ত্রুটি_কোড 0 না থাকে তবে প্যারামিটারগুলি ত্রুটি_কোড এবং বিক্রেতা_স্পেসিফিক_আরআর_কোড উভয়ই 0 হওয়া উচিত নয়।

সাবভেন্ট কোড = 0x58 [কোয়ালিটি_আরপোর্ট_আইডি = 0x11 ~ 0x13, লগ ডাম্প সম্পর্কিত ইভেন্ট]

মাল্টি-অ্যাডভার্টাইজার সমর্থন

মাল্টি-অ্যাডভার্টাইজার সমর্থনের উদ্দেশ্যগুলি নিম্নলিখিত:

• একাধিক বিজ্ঞাপন সমর্থন করার ক্ষমতা ( max_advt_instances )
• বিভিন্ন পরিসরের জন্য অনুমতি দেওয়ার জন্য বিভিন্ন প্রেরণ ক্ষমতা
• বিভিন্ন বিজ্ঞাপন সামগ্রী
• প্রতিটি বিজ্ঞাপনদাতার জন্য একটি পৃথক প্রতিক্রিয়া
• প্রতিটি বিজ্ঞাপনদাতার জন্য গোপনীয়তা (অ-ট্র্যাকযোগ্য)
• সংযোগযোগ্য

এই স্পেসিফিকেশনটি বিদ্যমান মানগুলির কাছাকাছি রাখতে, নিম্নলিখিত বিক্রেতা-নির্দিষ্ট কমান্ডগুলি সরবরাহ করা হয়। এগুলি ব্লুটুথ কোর 4.1 স্পেসিফিকেশন থেকে প্রাপ্ত।

Le_multi_advt_command

ওসিএফ: 0x154

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

Le_Multi_advt_command: set_advt_param_multi_sub_cmd

বেস রেফারেন্স: ব্লুটুথ কোর 4.1 স্পেসিফিকেশন, পৃষ্ঠা 964 (লে সেট বিজ্ঞাপন প্যারামিটার কমান্ড)

সাব ওসিএফ: 0x01

Own_Address প্যারামিটারটি এই বহু-বিজ্ঞাপনের উদাহরণটি স্থাপনের সময় একটি হোস্ট-কনফিগার করা ঠিকানা হতে পারে। এটি প্রথম বেকন প্রেরণের সময় একটি সমাধানযোগ্য ব্যক্তিগত ঠিকানা থাকার ক্ষমতা সরবরাহ করে। একটি উদাহরণে বিজ্ঞাপন সংযোগ নির্বিশেষে অব্যাহত থাকবে। হোস্ট বিটি স্ট্যাক একটি উদাহরণ, পোস্ট সংযোগে বিজ্ঞাপন শুরু করার জন্য একটি কমান্ড জারি করতে পারে।

উপরের কমান্ড অনুসারে ব্লুটুথ কোর 4.1 স্পেসিফিকেশন হিসাবে উল্লিখিত এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে। যদি বিজ্ঞাপনের উদাহরণ বা Tx_Power পরামিতিগুলি অবৈধ থাকে তবে কন্ট্রোলার একটি নন-সাবসেস (অবৈধ প্যারামিটার) কোডের সাথে প্রতিক্রিয়া জানাবে।

Le_Multi_advt_command: set_advt_data_multi_sub_cmd

বেস রেফারেন্স: ব্লুটুথ কোর 4.1 স্পেসিফিকেশন, পৃষ্ঠা 969 (লে সেট বিজ্ঞাপন ডেটা কমান্ড)

সাব ওসিএফ: 0x02

উপরের কমান্ড অনুসারে ব্লুটুথ কোর 4.1 স্পেসিফিকেশন হিসাবে উল্লিখিত এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে। বিজ্ঞাপনের উদাহরণ বা Tx_Power পরামিতিগুলি অবৈধ থাকলে কন্ট্রোলার একটি নন-সাবসেস কোডের সাথে সাড়া দেবে।

Le_Multi_advt_command: set_scan_resp_data_multi_sub_cmd

বেস রেফারেন্স: ব্লুটুথ কোর 4.1 স্পেসিফিকেশন, পৃষ্ঠা 970 (এলই সেট স্ক্যান প্রতিক্রিয়া ডেটা কমান্ড)

সাব ওসিএফ: 0x03

উপরের কমান্ড অনুসারে ব্লুটুথ কোর 4.1 স্পেসিফিকেশন হিসাবে উল্লিখিত এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে। যদি বিজ্ঞাপনের উদাহরণ বা Tx_Power পরামিতিগুলি অবৈধ থাকে তবে কন্ট্রোলার একটি নন-সাবসেস কোড (অবৈধ প্যারামিটার) দিয়ে প্রতিক্রিয়া জানাবে।

Le_Multi_advt_command: set_random_addr_multi_sub_cmd

বেস রেফারেন্স: ব্লুটুথ কোর 4.1 স্পেসিফিকেশন, পৃষ্ঠা 963 (এলই এলোমেলো ঠিকানা কমান্ড সেট করুন)

সাব ওসিএফ: 0x04

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

Le_Multi_advt_command: set_advt_enable_multi_sub_cmd

বেস রেফারেন্স: ব্লুটুথ কোর 4.1 স্পেসিফিকেশন, পৃষ্ঠা 971 (লে সেট বিজ্ঞাপনটি সেই মূল স্পেসিফিকেশনে কমান্ড সক্ষম করুন)

ওসিএফ: 0x05

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

বেসরকারী ঠিকানার অফলোড রেজোলিউশন

এই বৈশিষ্ট্যটি নিয়ামক ফার্মওয়্যার বা হার্ডওয়্যারে একটি ব্যক্তিগত ঠিকানা সমাধান করে, যা নিম্নলিখিত সুবিধাগুলি সরবরাহ করে:

• একটি ব্যক্তিগত ঠিকানা সমাধানে হোস্টের সাথে জড়িত বিলম্ব
• হোস্ট জাগ্রত করা থেকে বিরত হয়ে শক্তি সঞ্চয় করা

Le_set_rpa_timeout

ওসিএফ: 0x15 সি

Le_rpa_offload_command

ওসিএফ: 0x155

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

Le_rpa_offload: সক্ষম_কাস্ট_স্পেসিফিক_সুব_কম্যান্ড সক্ষম করুন

সাব ওসিএফ: 0x01

আরপিএ অফলোড চিপ সক্ষমতার উপর ভিত্তি করে হোস্ট দ্বারা সক্ষম করা প্রয়োজন। LE_Get_Vendor_Capabilities_Command দেখুন। প্রতিটি চিপে ফার্মওয়্যারে একটি বিভিন্ন max_irk_list_sz থাকতে পারে।

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

Le_rpa_offload: add_irk_to_list_sub_command

সাব ওসিএফ: 0x02

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

Le_rpa_offload: সরান_আরকে_টো_লিস্ট_সুব_কম্যান্ড

সাব ওসিএফ: 0x03

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

Le_rpa_offload: Clear_irk_list_sub_command

সাব ওসিএফ: 0x04

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

LE_RPA_OFFLALD: READ_IRK_LIST_SUB_COMMAND

সাব ওসিএফ: 0x05

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

হোস্ট কন্ট্রোলার ইন্টারফেস (এইচসিআই) একটি ব্লুটুথ কন্ট্রোলারের সাথে কথোপকথনের জন্য ব্যবহৃত হয়।

এই দস্তাবেজটি ব্লুটুথ (বিটি) এবং ব্লুটুথ লো এনার্জি (বিএলই) এইচসিআই প্রয়োজনীয়তার একটি তালিকা সরবরাহ করে। লক্ষ্যটি হোস্ট বিটি স্ট্যাক বিক্রেতাদের এবং বিটি নিয়ামক বিক্রেতাদের জন্য নীচে বর্ণিত বৈশিষ্ট্য সেটটি ব্যবহার করার জন্য এই প্ল্যাটফর্মের প্রয়োজনীয়তাগুলি মেনে চলার জন্য।

এই দস্তাবেজটি ব্লুটুথ কোর 5.2 স্পেসিফিকেশনটিকে "স্পেস" হিসাবে উল্লেখ করে। ব্লুটুথ কোর 5.2 স্পেসিফিকেশন অন্যান্য গৃহীত নথিগুলির সাথে ব্লুটুথ সিগ ওয়েবসাইটে উপলব্ধ।

সাধারণ নকশা ওভারভিউ

চিপ ক্ষমতা এবং কনফিগারেশন

একটি উন্মুক্ত প্ল্যাটফর্ম হিসাবে, অ্যান্ড্রয়েডে সফ্টওয়্যার রিলিজ, ওএমএস, বিক্রেতারা এবং প্ল্যাটফর্ম এবং চিপ ক্ষমতাগুলির একটি ম্যাট্রিক্স রয়েছে।

বিভিন্ন ল্যান্ডস্কেপ পরিচালনা করতে এবং মাইগ্রেশনগুলি পরিচালনা করতে, বিটি কন্ট্রোলারদের তাদের ক্ষমতাগুলি (স্ট্যান্ডার্ড ব্লুটুথ কোর 5.2 স্পেসিফিকেশন ছাড়িয়ে) প্রকাশের অনুমতি দেওয়ার একটি নকশা দর্শন এই নথিতে বর্ণিত হয়েছে। হোস্ট বিটি স্ট্যাক তারপরে কোন বৈশিষ্ট্যগুলি সক্ষম করতে নির্ধারণ করতে এই ক্ষমতাগুলি ব্যবহার করতে পারে।

উন্মুক্ত মান সমর্থন করুন

অ্যান্ড্রয়েডের একটি লক্ষ্য হ'ল ব্লুটুথ স্পেসিফিকেশনে অনুমোদনের পরে উন্মুক্ত মানকে সমর্থন করা। যদি নীচে বর্ণিত কোনও বৈশিষ্ট্য ভবিষ্যতের ব্লুটুথ স্পেসিফিকেশনে স্ট্যান্ডার্ড এইচসিআই পদ্ধতিতে উপলভ্য হয়ে যায় তবে আমরা সেই ডিফল্টটি তৈরি করার দিকে ঝুঁকছি।

বিক্রেতা-নির্দিষ্ট ক্ষমতা

বিক্রেতা-নির্দিষ্ট কমান্ড: LE_Get_Vendor_Capabilities_Command

ওপকোড কমান্ড ফিল্ড (ওসিএফ): 0x153

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

ব্যাচ স্ক্যান ফলাফল

একটি নকশার লক্ষ্য হ'ল হোস্টে শক্তি বাঁচাতে কীভাবে ব্লুটুথ লে স্ক্যান প্রতিক্রিয়া ইভেন্টের বিজ্ঞপ্তিগুলি হোস্টকে সরবরাহ করা হয় তা বাড়ানো।

কন্ট্রোলার কত ঘন ঘন হোস্ট অ্যাপ প্রসেসরকে স্ক্যান ফলাফলের জন্য অবহিত করে তা হ্রাস করে, হোস্ট অ্যাপ প্রসেসর অলস/ঘুমাতে আরও বেশি সময় থাকতে পারে। এটি হোস্টে বিদ্যুৎ খরচ হ্রাস করে। রিটার্ন প্যারামিটার total_scan_results_storage LE_Get_Vendor_Capabilities_Command স্ক্যান ফলাফল সংরক্ষণের জন্য চিপ সক্ষমতা নির্দেশ করে।

এই বৈশিষ্ট্যটি ব্লুটুথ কন্ট্রোলারে এলই স্ক্যান ফলাফল স্টোরেজ সুবিধার পরিচালনা এবং কনফিগারেশনের উপর দৃষ্টি নিবদ্ধ করে। স্টোরেজটি অস্থায়ীভাবে ব্যাচের বিজ্ঞাপনের ডেটা এবং স্ক্যান ডেটা এবং মেটাডেটা যা নিয়ন্ত্রণকারী দ্বারা পরে হোস্টের কাছে প্রসবের জন্য প্রাপ্ত হয়।

ফার্মওয়্যার দুটি ধরণের ব্যাচিং সমর্থন করবে, যা একই সাথে নিযুক্ত হতে পারে:

• ছাঁটা। নিম্নলিখিত তথ্য উপাদান রয়েছে: {ম্যাক, টিএক্স পাওয়ার, আরএসএসআই, টাইমস্ট্যাম্প}
• পূর্ণ। নিম্নলিখিত তথ্য উপাদান রয়েছে: {ম্যাক, টিএক্স পাওয়ার, আরএসএসআই, টাইমস্ট্যাম্প, এডিভি ডেটা, স্ক্যান প্রতিক্রিয়া}

Le_batch_scan_command

ওসিএফ: 0x156

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে। গ্রাহক-নির্দিষ্ট বৈশিষ্ট্য সক্ষম করা স্ক্যান শুরু করে না।

Le_batch_scan_command: গ্রাহক-নির্দিষ্ট বৈশিষ্ট্য সক্ষম করুন

সাব ওসিএফ: 0x01

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

Le_batch_scan_command: ব্যাচ স্ক্যান স্টোরেজ প্যারামিটার সাবকম্যান্ড সেট করুন

সাব ওসিএফ: 0x02

এই কমান্ডের জন্য একটি কমান্ড সম্পূর্ণ ইভেন্ট তৈরি করা হবে।

Le_batch_scan_command: ব্যাচ স্ক্যান প্যারামিটার সাবকম্যান্ড সেট করুন

সাব ওসিএফ: 0x03

This subcommand will start batch scanning, if enabled. In Truncated scanning, results are stored in truncated form where the unique key for Truncated style = { BD_ADDR, scan_interval}. This means only one BD_ADDR will be recorded for each scan interval. The record to keep for Truncated mode is the following: { BD_ADDR , Tx Power, RSSI, Timestamp}

When Full mode is enabled, active scanning will be used and Scan Responses will be recorded. The Full style unique key = {MAC, Ad packet}, irrespective of scan interval. The record to keep for Full mode is { BD_ADDR , Tx Power, RSSI, Timestamp, Ad packet, Scan Response}. In Full style, the same AD packet, when seen multiple times across different scan intervals, is recorded only once. However, in Truncated mode, it is the visibility of BA_ADDR across different scan intervals that is of interest (once per scan interval). The RSSI is the averaged value of all duplicates of a unique advertisement within a scan interval.

A Command Complete event will be generated for this command.

LE_Batch_Scan_Command: Read batch scan results subcommand

Sub OCF: 0x04

A Command Complete event will be generated for this command. When the host issues this command, all the results in the controller may not fit in one Command Complete event. The host will iterate issuing this command until the corresponding results in the Command Complete event indicate 0 in the number of records, which indicates the controller has no more records to communicate to the host. Each Command Complete event could contain multiple records of only one type of data (Full or Truncated).

Controller and host time references are not synchronized. The unit of the timestamp is 50ms. The value of the timestamp is based off when the Read_Batch_Scan_Results_Sub_cmd is given by the host. If a command arrival time is T_c in the firmware, then the actual time the timestamp was taken in the firmware is T_fw . The reporting time will be: ( T_c - T_fw ). T_c and T_fw are in the firmware time domain. This lets the host compute how long ago the event happened.

Advertising Packet Content Filter

Use this to enable/disable/setup the Advertising Packet Content Filter (APCF) in the controller. APCF filters advertising reports in the controller but doesn't filter periodic advertising.

LE_APCF_Command

OCF: 0x157

A Command Complete event will be generated for this command.

LE_APCF_Command: Enable_sub_cmd

Sub OCF: 0x00

A Command Complete event will be generated for this command.

LE_APCF_Command: set_filtering_parameters_sub_cmd

This subcommand is used to add or delete a filter specification or clear a filter list for on-chip filtering.

Sub OCF: 0x01

RSSI values must use 2's complement to represent negative values.

Host shall be able to configure multiple filters with APCF_Application_Address_type set to 0x02 (for all broadcaster addresses) to manage various filter combinations.

Filtering, batching and reporting are inter-related concepts. Every advertisement and related scan response will have to go through all the filters, one after the other. Thus, resulting actions ( delivery_mode ) are closely tied to filtering. The delivery modes are the following: report_immediately , batch , and onFound . The OnLost value is related to OnFound in the sense that it will come after OnFound when lost.

This processing flow depicts the conceptual model:

When an advertisement (or scan response) frame is received, it is applied to all the filters in serial order. It's possible that an advertisement can cause immediate reporting based on one filter and batching of the same due to a different filter action.

RSSI level thresholds (high and low) give the ability to control when the frame is visible for filter processing, even when a valid packet is received by the controller. In case of delivery mode being set to immediate or batched, the RSSI of a frame is considered for further controller processing. Different apps need different reporting and batching behavior. This allows multiple apps to have direct reporting and/or batching of results in firmware, concurrently. An example is a case when a batch scan is active from one app and later a regular LE scan is issued by another app. Before a batch scan is issued, the framework/app sets appropriate filters. Later, when the second app issues a regular scan, previous batching continues. However, due to the regular scan, it is akin to conceptually adding a null filter (along with all the existing filters) along with the LE scan command. The LE scan command parameters take precedence when active. When the regular LE scan is disabled, the controller will revert back to a previous batch scan, if it existed.

The OnFound delivery mode is based on configured filters. A combination that triggers a filter's action to succeed is considered the entity to track for onLost . The corresponding event is the LE Advt tracking subevent.

The OnFound/OnLost transition for a filter (if enabled) will look like the following:

A Command Complete event will be generated for this command.

LE_APCF_Command: broadcast_address_sub_cmd

This subcommand is used to add or delete an advertiser address or to clear the advertiser address list for on-chip filtering.

Sub OCF: 0x02

A Command Complete event will be generated for this command.

LE_APCF_Command: service_uuid_sub_cmd

This subcommand is used to add or delete a service UUID or to clear a service UUID list for on-chip filtering.

Sub OCF: 0x03

A Command Complete event will be generated for this command.

LE_APCF_Command: solicitation_uuid_sub_cmd

This subcommand is used to add or delete a solicitation UUID or to clear a solicitation UUID list for on-chip filtering.

Sub OCF: 0x04

A Command Complete event will be generated for this command.

LE_APCF_Command: local_name_sub_cmd

This subcommand is used to add or delete a local name string or to clear the local name string list for on-chip filtering.

Sub OCF: 0x05

A Command Complete event will be generated for this command.

LE_APCF_Command: manf_data_sub_cmd

This subcommand is used to add or delete a manufacturer data string or to clear the manufacturer data string list for on-chip filtering.

Sub OCF: 0x06

A Command Complete event will be generated for this command.

LE_APCF_Command: service_data_sub_cmd

This subcommand is used to add or delete a service data string or to clear the service data string list for on-chip filtering.

Sub OCF: 0x07

A Command Complete event will be generated for this command.

LE_APCF_Command: ad_type_sub_cmd

This subcommand is used to add or delete an AD type or to clear an AD type list for on-chip filtering. Use read_extended_features_sub_cmd to check if this command is supported or not.
When APCF_AD_DATA_Length is 0, filter APCF_AD_TYPE without comparing AD Data and AD Data Mask. If the received ADV packet's data length exceeds AD_DATA_LENGTH , compare only the first AD_DATA_LENGTH bytes of AD Data and ignore the remaining data.

Sub OCF: 0x09

A Command Complete event will be generated for this command.

LE_APCF_Command: read_extended_features_sub_cmd

This subcommand is used to read extended APCF features.

Sub OCF: 0xFF

A Command Complete event will be generated for this command.

Controller activity and energy information command

The objective of this information is for higher host system functions to analyze the total activities of all components, including the BT controller and its macro state, in conjunction with what is happening in the apps and framework. To do this, the following information is required from the BT stack and the controller:

• BT stack: Reporting the current macro-operational state of the controller
• Firmware: Reporting aggregate activity and energy information

BT host stack macro states, as determined at the user level:

• Idle: [page scan, LE advt, inquiry scan, LE scan]
• Scan: [paging/inquiry/trying to connect]
• Active: [ACL link on, SCO link ongoing, sniff mode]

The activities that the controller keeps track of over its life are Tx time, Rx time, idle time, and total energy consumed. They are cleared when read from the host.

LE_Get_Controller_Activity_Energy_Info

This is a vendor-specific command.

OCF: 0x159

A Command Complete event will be generated for this command.

LE extended set scan parameters command

This command can be used to enable a larger scan window and interval in the controller. Per the BT Core 5.2 Specification, a scan window and interval have an upper bound limit of 10.24 seconds, which hampers scan intervals beyond 10.24 seconds for apps.

Base reference: BT Core 5.2 Specification, page 2493 (LE Set Scan Parameters Command)

OCF: 0x15A

A Command Complete event will be generated for this command.

Get controller debug info command

The objective of this information element is to acquire controller debug information by a host, in binary form, for post-processing and analysis. This helps debug on-field issues and provides engineers with a toolkit to log information for analysis. A Controller can provide the information when requested by a host via the event (Controller Debug Info subevent) or autonomously when desired by the controller. Example uses could be to report firmware state information, crash dump information, logging information, etc.

OCF: 0x15B

A Command Complete event will be generated for this command.

A2DP hardware offload support

The A2DP offload feature supports the offload of the A2DP audio encoding process to an audio processor attached to the BT Controller. The encoded audio data stream passes directly from the Audio processor to the BT Controller without the BT host's involvement. The BT Host is still responsible for the configuration and control of the A2DP session. Two versions of the commands are available. The legacy commands with Sub OCF 0x01-0x02 only support open-source codecs. The versions with Sub-OCF 0x03-0x04 are agnostic to the configured codec.

OCF: 0x15D

Start A2DP offload (legacy)

Sub OCF: 0x01

Use this command both to configure the A2DP offload process and to start the A2DP stream.

A Command Complete event will be generated for this command.

Start A2DP offload

Sub OCF: 0x03

Use this command both to configure the A2DP offload process and to start the A2DP stream.

A Command Complete event will be generated for this command.

Stop A2DP offload (legacy)

Sub OCF: 0x02

This command is used to stop the A2DP offload stream.

No parameters are defined for this command.

A Command Complete event will be generated for this command.

Stop A2DP offload

Sub OCF: 0x04

This command is used to stop the A2DP offload stream.

A Command Complete event will be generated for this command.

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:
  • Periodic reports
  • Event triggers (stream start/stop and link quality event trigger).
• 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

A Command Complete event will be generated for this command.

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.

A Command Complete event will be generated for this command.

Set audio buffer time

Sub OCF: 0x02

Use this command to set the audio buffer time to the Bluetooth controller.

A Command Complete event will be generated for this command.

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.

Storage threshold breach subevent

This event indicates that the storage threshold has been breached.

Subevent code = 0x54

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

LE advertisement tracking subevent

This event indicates when an advertiser is found or lost.

Sub event code = 0x56

Controller debug info subevent

This event is used by a Controller to provide binary debug information to a host.

Subevent code = 0x57

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 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 code = 0x58 [Quality_Report_Id = 0x11 ~ 0x13, Log Dump related event]

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
• Connectable

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

A Command Complete event will be generated for this 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

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.

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

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.

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

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.

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

A Command Complete event will be generated for this command.

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

A Command Complete event will be generated for this command.

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

LE_RPA_offload_Command

OCF: 0x155

A Command Complete event will be generated for this command.

LE_RPA_offload: Enable_cust_specific_sub_Command

Sub OCF: 0x01

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.

LE_RPA_offload: Add_IRK_to_list_sub_Command

Sub OCF: 0x02

A Command Complete event will be generated for this command.

LE_RPA_offload: Remove_IRK_to_list_sub_Command

Sub OCF: 0x03

A Command Complete event will be generated for this command.

LE_RPA_offload: Clear_IRK_list_sub_Command

Sub OCF: 0x04

A Command Complete event will be generated for this command.

LE_RPA_offload: Read_IRK_list_sub_Command

Sub OCF: 0x05

A Command Complete event will be generated for this command.