হাব নেটওয়ার্ক অ্যাক্সেসরি স্পেসিফিকেশন খুঁজুন, হাব নেটওয়ার্ক অ্যাক্সেসরি স্পেসিফিকেশন খুঁজুন, হাব নেটওয়ার্ক অ্যাক্সেসরি স্পেসিফিকেশন খুঁজুন, হাব নেটওয়ার্ক অ্যাক্সেসরি স্পেসিফিকেশন খুঁজুন

v1.3

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

গ্যাট স্পেসিফিকেশন

নিম্নলিখিত অর্থসহ ফাস্ট পেয়ার সার্ভিসে একটি অতিরিক্ত জেনেরিক অ্যাট্রিবিউট (GATT) বৈশিষ্ট্য যোগ করা উচিত:

ফাস্ট পেয়ার সার্ভিসের বৈশিষ্ট্য এনক্রিপ্টেড অনুমতি UUID
বীকন কার্যক্রম না পড়ুন, লিখুন এবং অবহিত করুন FE2C1238-8366-4814-8EB0-01DE32100BEA

সারণি ১: এফএইচএন-এর ফাস্ট পেয়ার সার্ভিসের বৈশিষ্ট্যসমূহ।

প্রমাণীকরণ

এই এক্সটেনশনের জন্য প্রয়োজনীয় অপারেশনগুলো একটি রাইট অপারেশন হিসেবে সম্পাদিত হয়, যা একটি চ্যালেঞ্জ-রেসপন্স মেকানিজম দ্বারা সুরক্ষিত। যেকোনো অপারেশন সম্পাদন করার আগে, সিকারের কাছ থেকে টেবিল ১-এর ক্যারেক্টারিস্টিক থেকে একটি রিড অপারেশন সম্পাদন করার প্রত্যাশা করা হয়, যার ফলে নিম্নলিখিত ফরম্যাটে একটি বাফার তৈরি হয়:

অক্টেট ডেটা টাইপ বর্ণনা মূল্য
uint8 প্রোটোকলের প্রধান সংস্করণ নম্বর ০x০১
১ - ৮ বাইট অ্যারে এককালীন এলোমেলো ননস বিভিন্ন

প্রতিটি রিড অপারেশনের ফলে একটি ভিন্ন ননস তৈরি হবে এবং একটি ননস শুধুমাত্র একটি অপারেশনের জন্যই বৈধ থাকবে। অপারেশনটি ব্যর্থ হলেও ননসটি অবশ্যই বাতিল করতে হবে।

এরপর সিকার পরবর্তী রাইট রিকোয়েস্টে ব্যবহারের জন্য একটি ওয়ান-টাইম অথেন্টিকেশন কী গণনা করে। টেবিল ২ থেকে ৫-এ বর্ণিত পদ্ধতি অনুসারে অথেন্টিকেশন কী-টি গণনা করা হয়। অনুরোধকৃত অপারেশনের উপর নির্ভর করে, সিকার নিম্নলিখিত এক বা একাধিক কী সম্পর্কে তার জ্ঞান প্রমাণ করে:

অপারেশন

বৈশিষ্ট্যে লেখা ডেটার বিন্যাস সারণি ২ থেকে ৫-এ দেওয়া হয়েছে। এই বিভাগের পরবর্তী অংশে প্রতিটি অপারেশন নিয়ে আরও বিস্তারিত আলোচনা করা হয়েছে।

অক্টেট ডেটা টাইপ বর্ণনা মূল্য
uint8 ডেটা আইডি
  • 0x00: বীকন প্যারামিটার পড়ুন
  • 0x01: রিড প্রোভিশনিং স্টেট
  • 0x02: ক্ষণস্থায়ী পরিচয় কী সেট করুন
  • 0x03: ক্ষণস্থায়ী পরিচয় কী মুছে ফেলুন
uint8 ডেটার দৈর্ঘ্য বিভিন্ন
২ - ৯ বাইট অ্যারে এককালীন প্রমাণীকরণ কী HMAC-SHA256(account key, protocol major version number || the last nonce read from the characteristic || data ID || data length || additional data)
১০ - ভ্যার বাইট অ্যারে অতিরিক্ত তথ্য
  • 0x00: প্রযোজ্য নয়
  • 0x01: প্রযোজ্য নয়
  • 0x02: ৩২ বাইট যা হলো ক্ষণস্থায়ী পরিচয় কী, যা অ্যাকাউন্ট কী দিয়ে AES-ECB-128 পদ্ধতিতে এনক্রিপ্ট করা। যদি প্রোভাইডারের কাছে আগে থেকেই একটি ক্ষণস্থায়ী পরিচয় কী সেট করা থাকে, তাহলে SHA256(current ephemeral identity key || the last nonce read from the characteristic)
  • 0x03: SHA256(ephemeral identity key || the last nonce read from the characteristic)

সারণি ২: বীকন সরবরাহের অনুরোধ।

অক্টেট ডেটা টাইপ বর্ণনা মূল্য
uint8 ডেটা আইডি 0x04: ব্যবহারকারীর সম্মতিতে ক্ষণস্থায়ী পরিচয় কী পড়া হয়েছে
uint8 ডেটার দৈর্ঘ্য ০x০৮
২ - ৯ বাইট অ্যারে এককালীন প্রমাণীকরণ কী HMAC-SHA256(recovery key, protocol major version number || the last nonce read from the characteristic || data ID || data length)

সারণি ৩: বীকন প্রোভিশনিং কী পুনরুদ্ধারের অনুরোধ।

অক্টেট ডেটা টাইপ বর্ণনা মূল্য
uint8 ডেটা আইডি
  • 0x05: রিং
  • 0x06: রিংগিং অবস্থা পড়া হয়েছে
uint8 ডেটার দৈর্ঘ্য বিভিন্ন
২ - ৯ বাইট অ্যারে এককালীন প্রমাণীকরণ কী HMAC-SHA256(ring key, protocol major version number || the last nonce read from the characteristic || data ID || data length || additional data)
১০ - ভ্যার বাইট অ্যারে অতিরিক্ত তথ্য
  • 0x05: ৪ বাইট যা রিংগিং অবস্থা, রিংগিংয়ের সময়কাল এবং রিংগিংয়ের ভলিউম নির্দেশ করে।
  • 0x06: প্রযোজ্য নয়

সারণি ৪: রিং করার অনুরোধ।

অক্টেট ডেটা টাইপ বর্ণনা মূল্য
uint8 ডেটা আইডি
  • 0x07: অনাকাঙ্ক্ষিত ট্র্যাকিং সুরক্ষা মোড সক্রিয় করুন
  • 0x08: অনাকাঙ্ক্ষিত ট্র্যাকিং সুরক্ষা মোড নিষ্ক্রিয় করুন
uint8 ডেটার দৈর্ঘ্য বিভিন্ন
২ - ৯ বাইট অ্যারে এককালীন প্রমাণীকরণ কী HMAC-SHA256(unwanted tracking protection key, protocol major version number || the last nonce read from the characteristic || data ID || data length || additional data)
১০ - ভ্যার বাইট অ্যারে অতিরিক্ত তথ্য
  • 0x07: ১ বাইট নিয়ন্ত্রণ ফ্ল্যাগ (ঐচ্ছিক)
  • 0x08: SHA256(ephemeral identity key || the last nonce read from the characteristic)

সারণি ৫: অনাকাঙ্ক্ষিত ট্র্যাকিং সুরক্ষা অনুরোধ।

সফল রাইটগুলো সারণি ৬-এ তালিকাভুক্ত নোটিফিকেশনগুলো ট্রিগার করে।

0x05 ব্যতীত অন্য ডেটা আইডি সহ নোটিফিকেশন: যে রাইট ট্রানজ্যাকশনটি নোটিফিকেশনটি ট্রিগার করে, সেটি সম্পন্ন হওয়ার আগে, অর্থাৎ রাইট রিকোয়েস্টের জন্য একটি রেসপন্স পিডিইউ পাঠানোর আগে, রিং স্টেট পরিবর্তনের তথ্য পাঠানো উচিত।

অক্টেট ডেটা টাইপ বর্ণনা মূল্য
uint8 ডেটা আইডি
  • 0x00: বীকন প্যারামিটার পড়ুন
  • 0x01: রিড প্রোভিশনিং স্টেট
  • 0x02: ক্ষণস্থায়ী পরিচয় কী সেট করুন
  • 0x03: ক্ষণস্থায়ী পরিচয় কী মুছে ফেলুন
  • 0x04: ব্যবহারকারীর সম্মতিতে ক্ষণস্থায়ী পরিচয় কী পড়া হয়েছে
  • 0x05: রিং অবস্থার পরিবর্তন
  • 0x06: রিংগিং অবস্থা পড়া হয়েছে
  • 0x07: অনাকাঙ্ক্ষিত ট্র্যাকিং সুরক্ষা মোড সক্রিয় করুন
  • 0x08: অনাকাঙ্ক্ষিত ট্র্যাকিং সুরক্ষা মোড নিষ্ক্রিয় করুন
uint8 ডেটার দৈর্ঘ্য বিভিন্ন
২ - ৯ বাইট অ্যারে প্রমাণীকরণ প্রতিটি অপারেশনের বিস্তারিত বিবরণ
১০ - ভ্যার বাইট অ্যারে অতিরিক্ত তথ্য
  • 0x00: ৮ বাইট যা ট্রান্সমিশন পাওয়ার, ক্লক ভ্যালু, এনক্রিপশন পদ্ধতি এবং রিংগিং সক্ষমতা নির্দেশ করে, অ্যাকাউন্ট কী (শূন্য দ্বারা প্যাড করা) দিয়ে AES-ECB-128 পদ্ধতিতে এনক্রিপ্ট করা হয়।
  • 0x01: প্রোভিশনিং অবস্থা নির্দেশকারী ১ বাইট, এবং প্রযোজ্য ক্ষেত্রে এর পরে বর্তমান ক্ষণস্থায়ী আইডি (২০ বা ৩২ বাইট)।
  • 0x04: ৩২ বাইট যা হলো ক্ষণস্থায়ী পরিচয় কী, যা অ্যাকাউন্ট কী দিয়ে AES-ECB-128 পদ্ধতিতে এনক্রিপ্ট করা।
  • 0x05: ৪ বাইট যা নতুন অবস্থা এবং পরিবর্তনের কারণ নির্দেশ করে।
  • 0x06: ৩ বাইট যা সক্রিয়ভাবে রিং হওয়া কম্পোনেন্টগুলো এবং রিং হওয়ার জন্য অবশিষ্ট ডেসিসেকেন্ডের সংখ্যা নির্দেশ করে।
  • অন্যান্য ডেটা আইডিগুলো খালি অতিরিক্ত ডেটা ব্যবহার করে।

সারণি ৬: বীকন পরিষেবার প্রতিক্রিয়া।

সারণি ৭-এ অপারেশনগুলো দ্বারা ফেরত আসা সম্ভাব্য GATT ত্রুটি কোডগুলো তালিকাভুক্ত করা হয়েছে।

কোড বর্ণনা নোট
০x৮০ অপ্রমাণিত প্রমাণীকরণ ব্যর্থ হলে (পুরানো ননস ব্যবহারের ক্ষেত্র সহ) একটি রাইট রিকোয়েস্টের জবাবে এটি ফেরত আসে।
০x৮১ অবৈধ মান যখন কোনো অবৈধ মান প্রদান করা হয় অথবা প্রাপ্ত ডেটাতে অপ্রত্যাশিত সংখ্যক বাইট থাকে, তখন এটি ফেরত আসে।
০x৮২ ব্যবহারকারীর সম্মতি নেই ডেটা আইডি 0x04 সহ একটি রাইট রিকোয়েস্টের জবাবে ফেরত এসেছে: ডিভাইসটি পেয়ারিং মোডে না থাকলে ব্যবহারকারীর সম্মতিতে ক্ষণস্থায়ী আইডেন্টিটি কী পড়া হয়েছে

সারণি ৭: গ্যাট (GATT) ত্রুটি কোডসমূহ।

বীকনের প্যারামিটারটি পড়ুন

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

যাচাইকরণ ব্যর্থ হলে প্রোভাইডার একটি অপ্রমাণিত ত্রুটি ফেরত দেয়।

সফল হলে, প্রোভাইডার টেবিল ৬ থেকে ডেটা আইডি 0x00 সহ একটি প্রতিক্রিয়া পাঠিয়ে অবহিত করে। প্রোভাইডার ডেটা সেগমেন্টটি নিম্নরূপে গঠন করে:

অক্টেট ডেটা টাইপ বর্ণনা মূল্য
uint8 ক্রমাঙ্কিত শক্তি ০ মিটারে প্রাপ্ত ক্যালিব্রেটেড পাওয়ার (মান [-১০০, ২০] পরিসরের মধ্যে)। ১ dBm রেজোলিউশন সহ একটি চিহ্নযুক্ত পূর্ণসংখ্যা হিসাবে উপস্থাপিত।
১ - ৪ uint32 ঘড়ির মান বর্তমান ক্লকের মান সেকেন্ডে (বিগ এন্ডিয়ান)।
uint8 বক্ররেখা নির্বাচন এনক্রিপশনের জন্য ব্যবহৃত উপবৃত্তাকার বক্ররেখা:
  • 0x00 (ডিফল্ট): SECP160R1
  • 0x01: SECP256R1 (বর্ধিত বিজ্ঞাপন প্রয়োজন)
uint8 উপাদান যেসব উপাদান বেজে উঠতে সক্ষম, তাদের সংখ্যা:
  • 0x00: নির্দেশ করে যে ডিভাইসটি রিং করতে অক্ষম।
  • 0x01: নির্দেশ করে যে শুধুমাত্র একটি উপাদানই অনুরণন করতে সক্ষম।
  • 0x02: নির্দেশ করে যে বাম এবং ডান ইয়ারবাড, এই দুটি অংশ স্বাধীনভাবে রিং করতে সক্ষম।
  • 0x03: নির্দেশ করে যে বাম ও ডান ইয়ারবাড এবং কেস—এই তিনটি উপাদান স্বাধীনভাবে বাজতে সক্ষম।
uint8 রিং করার ক্ষমতা সমর্থিত বিকল্পগুলো হলো:
  • 0x00: রিংটোনের ভলিউম নির্বাচনের সুযোগ নেই।
  • 0x01: রিং-এর ভলিউম নির্বাচনের সুবিধা রয়েছে। এটি সেট করা থাকলে, প্রোভাইডারকে অবশ্যই রিং অপারেশনে নির্দেশিত ৩টি ভলিউম লেভেল গ্রহণ ও পরিচালনা করতে হবে।
৮-১৫ বাইট অ্যারে প্যাডিং AES এনক্রিপশনের জন্য কোনো প্যাডিং ব্যবহার করা হয় না।

অনুরোধটি প্রমাণীকরণের জন্য ব্যবহৃত অ্যাকাউন্ট কী দিয়ে ডেটা অবশ্যই AES-ECB-128 পদ্ধতিতে এনক্রিপ্ট করতে হবে।

প্রমাণীকরণ অংশটি HMAC-SHA256(account key, protocol major version number || the last nonce read from the characteristic || data ID || data length || additional data after encryption || 0x01)

বীকনটির প্রোভিশনিং অবস্থা পড়ুন

সিকার, ডেটা আইডি 0x01 সহ টেবিল ২ থেকে একটি অনুরোধ সম্বলিত ক্যারেক্টারিস্টিকে একটি রাইট অপারেশন সম্পাদন করে বীকনটির প্রোভিশনিং অবস্থা সম্পর্কে প্রোভাইডারকে জিজ্ঞাসা করতে পারে। প্রোভাইডার যাচাই করে যে প্রদত্ত ওয়ান-টাইম অথেনটিকেশন কী-টি ডিভাইসে সংরক্ষিত যেকোনো অ্যাকাউন্ট কী-এর সাথে মেলে কিনা।

যাচাইকরণ ব্যর্থ হলে, প্রোভাইডার একটি অপ্রমাণিত ত্রুটি ফেরত দেয়।

সফল হলে, প্রোভাইডার টেবিল ৬ থেকে ডেটা আইডি 0x01 সহ একটি প্রতিক্রিয়া পাঠিয়ে অবহিত করে। প্রোভাইডার ডেটা সেগমেন্টটি নিম্নরূপে গঠন করে:

অক্টেট ডেটা টাইপ বর্ণনা মূল্য
uint8 সরবরাহকারী রাষ্ট্র একটি বিটমাস্ক যার নিম্নলিখিত মানগুলি রয়েছে:
  • বিট ১ (0x01): ডিভাইসটির জন্য একটি ক্ষণস্থায়ী পরিচয় কী (ephemeral identity key) সেট করা থাকলে এটি নির্ধারিত হয়।
  • বিট ২ (0x02): প্রদত্ত ওয়ান-টাইম অথেনটিকেশন কী যদি মালিক অ্যাকাউন্টের কী-এর সাথে মিলে যায়, তবে এটি সেট হয়।
১ - ২০ বা ৩২ বাইট অ্যারে বর্তমান ক্ষণস্থায়ী শনাক্তকারী ২০ বা ৩২ বাইট (ব্যবহৃত এনক্রিপশন পদ্ধতির উপর নির্ভর করে), যা বীকন দ্বারা প্রচারিত বর্তমান ক্ষণস্থায়ী আইডি নির্দেশ করে, যদি ডিভাইসটির জন্য কোনো আইডি সেট করা থাকে।

প্রমাণীকরণ অংশটি HMAC-SHA256(account key, protocol major version number || the last nonce read from the characteristic || data ID || data length || additional data || 0x01) এর প্রথম ৮ বাইট হিসাবে সংজ্ঞায়িত করা হয়।

একটি ক্ষণস্থায়ী পরিচয় কী সেট করুন

একটি অপ্রস্তুত প্রোভাইডারকে FHN বীকন হিসেবে প্রস্তুত করতে, অথবা ইতিমধ্যে প্রস্তুতকৃত প্রোভাইডারের ক্ষণস্থায়ী পরিচয় কী (ephemeral identity key) পরিবর্তন করতে, সিকার (Seeker) ডেটা আইডি 0x02 সহ টেবিল ২ থেকে একটি অনুরোধ সম্বলিত ক্যারেক্টারিস্টিকে একটি রাইট অপারেশন সম্পাদন করে। প্রোভাইডার যাচাই করে যে:

যাচাইকরণ ব্যর্থ হলে, প্রোভাইডার একটি অপ্রমাণিত ত্রুটি ফেরত দেয়।

সফল হলে, মিলে যাওয়া অ্যাকাউন্ট কী ব্যবহার করে AES-ECB-128 পদ্ধতিতে ডিক্রিপ্ট করার মাধ্যমে ক্ষণস্থায়ী পরিচয় কী-টি পুনরুদ্ধার করা হয়। কী-টি ডিভাইসে সংরক্ষণ করা উচিত এবং সেই মুহূর্ত থেকে প্রোভাইডারের FHN ফ্রেম প্রচার করা শুরু করা উচিত। BLE সংযোগ বিচ্ছিন্ন হওয়ার সাথে সাথেই নতুন ক্ষণস্থায়ী পরিচয় কী-টি কার্যকর হয়। প্রোভাইডার টেবিল ৬ থেকে ডেটা আইডি 0x02 সহ একটি প্রতিক্রিয়ার মাধ্যমে অবহিত করে।

প্রমাণীকরণ অংশটি HMAC-SHA256(account key, protocol major version number || the last nonce read from the characteristic || data ID || data length || 0x01) এর প্রথম ৮ বাইট হিসেবে সংজ্ঞায়িত করা হয়।

ক্ষণস্থায়ী পরিচয় কী মুছে ফেলুন

প্রোভাইডারের বীকন অংশটিকে আনপ্রোভিশন করার জন্য, সিকার ক্যারেক্টারিস্টিকটিতে একটি রাইট অপারেশন সম্পাদন করে, যার মধ্যে ডেটা আইডি 0x03 সহ টেবিল 2 থেকে একটি অনুরোধ অন্তর্ভুক্ত থাকে। প্রোভাইডার যাচাই করে যে:

যদি প্রোভাইডারটিকে FHN বীকন হিসেবে প্রোভিশন করা না থাকে অথবা ভেরিফিকেশন ব্যর্থ হয়, তাহলে এটি একটি অপ্রমাণিত ত্রুটি ফেরত দেয়।

সফল হলে, প্রোভাইডার কী-টি ভুলে যায় এবং FHN ফ্রেমের বিজ্ঞাপন দেওয়া বন্ধ করে দেয়। প্রোভাইডার ডেটা আইডি 0x03 সহ টেবিল ৬ থেকে একটি প্রতিক্রিয়ার মাধ্যমে অবহিত করে। অথেনটিকেশন সেগমেন্টটি HMAC-SHA256(account key, protocol major version number || the last nonce read from the characteristic || data ID || data length || 0x01) এর প্রথম ৮ বাইট হিসাবে সংজ্ঞায়িত করা হয়।

ব্যবহারকারীর সম্মতি সাপেক্ষে ক্ষণস্থায়ী পরিচয় কী-টি পড়ুন।

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

ক্লিয়ারটেক্সট কী পুনরুদ্ধার করতে পারার জন্য সিকারকে অবশ্যই ব্যাকএন্ডে রিকভারি কী সংরক্ষণ করতে হবে, কিন্তু এটি EIK নিজে সংরক্ষণ করে না।

EIK পড়ার জন্য, সিকার ক্যারেক্টারিস্টিকটিতে একটি রাইট অপারেশন সম্পাদন করে, যার মধ্যে ডেটা আইডি 0x04 সহ টেবিল 3 থেকে একটি অনুরোধ অন্তর্ভুক্ত থাকে। প্রোভাইডার যাচাই করে যে:

যাচাইকরণ ব্যর্থ হলে, প্রোভাইডার একটি অপ্রমাণিত ত্রুটি ফেরত দেয়।

ডিভাইসটি পেয়ারিং মোডে না থাকলে, প্রোভাইডার 'ব্যবহারকারীর সম্মতি নেই' (No User Consent) ত্রুটি দেখায়।

সফল হলে, প্রোভাইডার টেবিল ৬ থেকে ডেটা আইডি 0x04 সহ একটি প্রতিক্রিয়া পাঠিয়ে অবহিত করে।

প্রমাণীকরণ অংশটি HMAC-SHA256(recovery key, protocol major version number || the last nonce read from the characteristic || data ID || data length || additional data || 0x01) হিসেবে সংজ্ঞায়িত করা হয়।

রিং অপারেশন

অনুসন্ধানকারী, ডেটা আইডি 0x05 সহ টেবিল 4 থেকে একটি অনুরোধ সম্বলিত ক্যারেক্টারিস্টিক-এ একটি রাইট অপারেশন সম্পাদন করে প্রোভাইডারকে একটি শব্দ বাজাতে বলতে পারে। প্রোভাইডার ডেটা সেগমেন্টটি নিম্নরূপে গঠন করে:

অক্টেট ডেটা টাইপ বর্ণনা মূল্য
uint8 রিং অপারেশন একটি বিটমাস্ক যার নিম্নলিখিত মানগুলি রয়েছে:
  • বিট ১ (0x01): ডান রিং
  • বিট ২ (0x02): রিং বাম
  • বিট ৩ (0x04): রিং কেস
  • 0xFF: সমস্ত উপাদান রিং করুন
  • 0x00: রিং করা বন্ধ করুন
১ - ২ uint16 টাইমআউট টাইমআউটের সময় ডেসিসেকেন্ডে পরিমাপ করা হবে। এটি অবশ্যই শূন্য হবে না এবং ১০ মিনিটের সমতুল্য সময়ের চেয়ে বেশি হবে না।
প্রোভাইডার নিজেকে নীরব করার আগে কতক্ষণ রিং করবে তা নির্ধারণ করতে এই মানটি ব্যবহার করে। ডিভাইসের কোনো কম্পোনেন্ট যদি আগে থেকেই রিং করতে থাকে, তাহলে এই টাইমআউটটি আগে থেকে কার্যকর থাকা টাইমআউটটিকে বাতিল করে দেয়।

রিং অপারেশন 0x00-তে সেট করা থাকলে, টাইমআউট উপেক্ষা করা হয়।
uint8 ভলিউম
  • 0x00: ডিফল্ট
  • 0x01: নিম্ন
  • 0x02: মাঝারি
  • 0x03: উচ্চ
এই মানগুলোর সঠিক অর্থ বাস্তবায়নের ওপর নির্ভরশীল।

অনুরোধটি পাওয়ার পর, প্রদানকারী যাচাই করে যে:

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

রিং শুরু বা শেষ হলে, টেবিল ৬-এ নির্দেশিত ডেটা আইডি 0x05 সহ একটি নোটিফিকেশন পাঠানো হয়। নোটিফিকেশনটির বিষয়বস্তু নিম্নরূপভাবে সংজ্ঞায়িত করা হয়েছে:

অক্টেট ডেটা টাইপ বর্ণনা মূল্য
uint8 রিংগিং অবস্থা
  • 0x00: শুরু হয়েছে
  • 0x01: শুরু বা বন্ধ করা যায়নি (অনুরোধকৃত সকল উপাদান নাগালের বাইরে)
  • 0x02: থেমে গেছে (সময়সীমা উত্তীর্ণ)
  • 0x03: বন্ধ করা হয়েছে (বোতাম চাপা)
  • 0x04: বন্ধ করা হয়েছে (GATT অনুরোধ)
uint8 রিংিং উপাদান অনুরোধে সংজ্ঞায়িত, সক্রিয়ভাবে রিং হওয়া উপাদানগুলোর একটি বিটমাস্ক।
২ - ৩ uint16 টাইমআউট রিং হওয়ার অবশিষ্ট সময় ডেসিসেকেন্ডে। ডিভাইসটি রিং করা বন্ধ করে দিলে, 0x0000 ফেরত দেওয়া উচিত।

প্রমাণীকরণ অংশটি HMAC-SHA256(ring key, protocol major version number || the nonce used to initiate the ringing command || data ID || data length || additional data || 0x01) হিসেবে সংজ্ঞায়িত করা হয়।

রিং করার বা রিং বন্ধ করার অনুরোধ পাওয়ার সময় যদি ডিভাইসটি ইতিমধ্যেই অনুরোধ করা রিং স্টেটে থাকে, তাহলে প্রোভাইডারের উচিত রিং স্টেট অথবা যথাক্রমে 0x00: স্টার্টেড বা 0x04: স্টপড (GATT রিকোয়েস্ট) সহ একটি নোটিফিকেশন পাঠানো। এই অনুরোধটি বিদ্যমান স্টেটের প্যারামিটারগুলোকে ওভাররাইড করে, যার ফলে রিং হওয়ার সময়কাল বাড়ানো যায়।

প্রোভাইডারে যদি কোনো ফিজিক্যাল বাটন থাকে (অথবা টাচ সেন্স চালু থাকে), তাহলে রিং চালু থাকা অবস্থায় সেই বাটনটি চাপলে রিং ফাংশনটি বন্ধ হয়ে যাবে।

বীকনটির রিংগিং অবস্থা জানুন

বীকনের রিংগিং অবস্থা জানার জন্য, সিকার ক্যারেক্টারিস্টিক-এ একটি রাইট অপারেশন সম্পাদন করে, যার মধ্যে ডেটা আইডি 0x06 সহ টেবিল 4 থেকে একটি অনুরোধ অন্তর্ভুক্ত থাকে। প্রোভাইডার যাচাই করে যে প্রদত্ত ওয়ান-টাইম অথেনটিকেশন কী-টি রিং কী-এর সাথে মেলে কিনা।

যদি প্রোভাইডারটিকে FHN বীকন হিসেবে প্রোভিশন করা না থাকে অথবা ভেরিফিকেশন ব্যর্থ হয়, তাহলে প্রোভাইডারটি একটি অপ্রমাণিত ত্রুটি ফেরত দেয়।

সফল হলে, প্রোভাইডার টেবিল ৬ থেকে ডেটা আইডি 0x06 সহ একটি প্রতিক্রিয়া পাঠিয়ে অবহিত করে। প্রোভাইডার ডেটা সেগমেন্টটি নিম্নরূপে গঠন করে:

অক্টেট ডেটা টাইপ বর্ণনা মূল্য
uint8 রিংিং উপাদান রিংগিং অনুরোধে সংজ্ঞায়িত অনুযায়ী, যে উপাদানগুলো সক্রিয়ভাবে রিং করছে।
১ - ২ uint16 টাইমআউট রিং হওয়ার অবশিষ্ট সময় ডেসিসেকেন্ডে। উল্লেখ্য যে, ডিভাইসটি রিং না হলে 0x0000 রিটার্ন করা উচিত।

প্রমাণীকরণ অংশটি HMAC-SHA256 (ring key, protocol major version number || the last nonce read from the characteristic || data ID || data length || additional data || 0x01) হিসেবে সংজ্ঞায়িত করা হয়।

অবাঞ্ছিত ট্র্যাকিং সুরক্ষা মোড

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

বীকনের অবাঞ্ছিত ট্র্যাকিং সুরক্ষা মোড সক্রিয় বা নিষ্ক্রিয় করতে, সিকার ক্যারেক্টারিস্টিক-এ একটি রাইট অপারেশন সম্পাদন করে, যার মধ্যে যথাক্রমে ডেটা আইডি 0x07 বা 0x08 সহ টেবিল 5 থেকে একটি অনুরোধ অন্তর্ভুক্ত থাকে।

অবাঞ্ছিত ট্র্যাকিং সুরক্ষা মোড সক্রিয় করার সময়

প্রোভাইডার ডেটা সেগমেন্টটি নিম্নরূপে গঠন করে:

অক্টেট ডেটা টাইপ বর্ণনা মূল্য
uint8 নিয়ন্ত্রণ পতাকা
  • 0x01: রিংগিং প্রমাণীকরণ এড়িয়ে যান। এটি সেট করা থাকলে, অবাঞ্ছিত ট্র্যাকিং সুরক্ষা মোডে থাকাকালীন রিংগিং অনুরোধগুলি প্রমাণীকৃত হয় না।
যদি কোনো ফ্ল্যাগ সেট করা না থাকে (অর্থাৎ বাইটটিতে সব শূন্য থাকে), তাহলে ডেটা সেকশনটি পুরোপুরি বাদ দিয়ে একটি খালি ডেটা সেকশন পাঠানো বৈধ।
অবাঞ্ছিত ট্র্যাকিং সুরক্ষা মোড নিষ্ক্রিয় না করা পর্যন্তই ফ্ল্যাগগুলো কার্যকর থাকবে।

প্রোভাইডার যাচাই করে যে প্রদত্ত ওয়ান-টাইম অথেনটিকেশন কী-টি অনাকাঙ্ক্ষিত ট্র্যাকিং প্রোটেকশন কী-এর সাথে মেলে কিনা। যদি প্রোভাইডারটি একটি FHN বীকন হিসাবে প্রোভিশন করা না থাকে অথবা যাচাইকরণ ব্যর্থ হয়, তবে এটি একটি অপ্রমাণিত ত্রুটি ফেরত দেয়।

যখন অনাকাঙ্ক্ষিত ট্র্যাকিং সুরক্ষা মোড সক্রিয় করা হয়, তখন বীকনটির MAC প্রাইভেট অ্যাড্রেস রোটেশন ফ্রিকোয়েন্সি প্রতি ২৪ ঘণ্টায় একবার করে দেওয়া উচিত। বিজ্ঞাপিত ক্ষণস্থায়ী শনাক্তকারীটি যথারীতি ঘুরতে থাকবে। ফ্রেম টাইপটি 0x41-এ সেট করা উচিত। এই অবস্থাটি হ্যাশড ফ্ল্যাগস অংশেও প্রতিফলিত হয়।

অবাঞ্ছিত ট্র্যাকিং সুরক্ষা মোড নিষ্ক্রিয় করার সময়

প্রদানকারী যাচাই করে যে:

  • প্রদত্ত এককালীন প্রমাণীকরণ কী-টি অনাকাঙ্ক্ষিত ট্র্যাকিং সুরক্ষা কী-টির সাথে মিলে গেছে।
  • হ্যাশ করা ক্ষণস্থায়ী পরিচয় কী-টি বর্তমান ক্ষণস্থায়ী পরিচয় কী-এর সাথে মিলে যায়।

যদি প্রোভাইডারটিকে FHN বীকন হিসেবে প্রোভিশন করা না থাকে অথবা ভেরিফিকেশন ব্যর্থ হয়, তাহলে প্রোভাইডারটি একটি অপ্রমাণিত ত্রুটি ফেরত দেয়।

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

সফল হলে, প্রোভাইডার টেবিল ৬ থেকে ডেটা আইডি 0x07 বা 0x08 সহ একটি প্রতিক্রিয়া পাঠিয়ে অবহিত করে।

প্রমাণীকরণ অংশটি HMAC-SHA256(unwanted tracking protection key, protocol major version number || the last nonce read from the characteristic || data ID || data length || 0x01) হিসাবে সংজ্ঞায়িত করা হয়।

নির্ভুলতা অনুসন্ধান

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

নির্ভুল অনুসন্ধানের ধরন নির্ভর করে নির্ভুল অনুসন্ধানে নিযুক্ত ডিভাইসগুলিতে সমর্থিত রেঞ্জিং প্রযুক্তির ধরনের উপর। সমর্থিত রেঞ্জিং প্রযুক্তিগুলো ‘রেঞ্জিং: আউট-অফ-ব্যান্ড মেসেজ সিকোয়েন্স এবং পেলোড স্পেসিফিকেশন’-এ পাওয়া যাবে। পরবর্তী বিভাগগুলিতে ব্যবহৃত রেঞ্জিং প্রযুক্তির উপর ভিত্তি করে কী ধরনের নির্ভুল অনুসন্ধানের অভিজ্ঞতা আশা করা যেতে পারে, তা আলোচনা করা হয়েছে।

নির্ভুলতা অনুসন্ধানের প্রবাহ

এই বিভাগে প্রিসিশন ফাইন্ডিং-এর জন্য FHNA মেসেজ ফ্লো নিয়ে আলোচনা করা হয়েছে। চিত্র ১-এ মেসেজগুলোর প্রবাহ দেখানো হয়েছে এবং অনুচ্ছেদগুলোতে প্রতিটি মেসেজ আরও বিস্তারিতভাবে ব্যাখ্যা করা হয়েছে।

নির্ভুলতা অনুসন্ধান বার্তা প্রবাহ

চিত্র ১। প্রিসিশন ফাইন্ডিং মেসেজ প্রবাহের একটি সাধারণ চিত্র।

ইনিশিয়েটর ডিভাইস হলো সেই ডিভাইস, যেটিতে ফাইন্ড হাব অ্যাপ রয়েছে এবং যেখান থেকে প্রিসিশন ফাইন্ডিং ফিচারটি চালু করা হয়েছিল। ইনিশিয়েটর হলো সেই ডিভাইস যা অন্য ডিভাইসটিকে খুঁজে বের করার চেষ্টা করছে।

রেসপন্ডার ডিভাইস হলো সেই ডিভাইস, যাকে ইনিশিয়েটর ডিভাইস খুঁজে বের করার চেষ্টা করে।

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

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

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

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

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

নির্ভুলতা অনুসন্ধান অপারেশন

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

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

সারণি ৮: নির্ভুলতা নির্ণয়ের অপারেশনসমূহ।

রেঞ্জিং ক্ষমতা অনুরোধ অপারেশন

সারণি ৯-এ রেঞ্জিং ক্যাপাবিলিটি রিকোয়েস্ট মেসেজটির সংজ্ঞা দেওয়া হয়েছে।

অক্টেট ডেটা টাইপ বর্ণনা মূল্য
uint8 ডেটা আইডি 0x0A - রেঞ্জিং সক্ষমতা অনুরোধ অপারেশন
uint8 ডেটার দৈর্ঘ্য বিভিন্ন
বাইট অ্যারে এককালীন প্রমাণীকরণ কী HMAC-SHA256-এর প্রথম ৮ বাইট (অ্যাকাউন্ট কী, প্রোটোকলের প্রধান সংস্করণ নম্বর || ক্যারেক্টারিস্টিক থেকে পঠিত সর্বশেষ ননস || ডেটা আইডি || ডেটার দৈর্ঘ্য || অতিরিক্ত ডেটা)।
১০ বাইট অ্যারে অতিরিক্ত তথ্য রেঞ্জিং: আউট-অফ-ব্যান্ড মেসেজ সিকোয়েন্স এবং পেলোড স্পেসিফিকেশনে সংজ্ঞায়িত রেঞ্জিং ক্যাপাবিলিটি রিকোয়েস্ট মেসেজ (হেডার এবং পেলোড উভয়ই)

সারণি ৯: রেঞ্জিং সক্ষমতার অনুরোধ।

রেঞ্জিং সক্ষমতা প্রতিক্রিয়া অপারেশন

সারণি ১০-এ রেঞ্জিং ক্যাপাবিলিটি রেসপন্স মেসেজটির সংজ্ঞা দেওয়া হয়েছে।

অক্টেট ডেটা টাইপ বর্ণনা মূল্য
uint8 ডেটা আইডি 0x0A: রেঞ্জিং সক্ষমতা প্রতিক্রিয়া
uint8 ডেটার দৈর্ঘ্য বিভিন্ন
বাইট অ্যারে এককালীন প্রমাণীকরণ কী HMAC-SHA256-এর প্রথম ৮ বাইট (অ্যাকাউন্ট কী, প্রোটোকলের প্রধান সংস্করণ নম্বর || ক্যারেক্টারিস্টিক থেকে পঠিত সর্বশেষ ননস || ডেটা আইডি || ডেটার দৈর্ঘ্য || অতিরিক্ত ডেটা || 0x01)।
১০ বাইট অ্যারে অতিরিক্ত তথ্য রেঞ্জিং: আউট-অফ-ব্যান্ড মেসেজ সিকোয়েন্স এবং পেলোড স্পেসিফিকেশনে সংজ্ঞায়িত রেঞ্জিং ক্যাপাবিলিটি রেসপন্স মেসেজ (হেডার এবং পেলোড উভয়ই)

সারণি ১০: দূরত্ব পরিমাপ ক্ষমতার প্রতিক্রিয়া।

রেঞ্জিং কনফিগারেশন অপারেশন

সারণি ১১-তে রেঞ্জিং কনফিগারেশন মেসেজটির সংজ্ঞা দেওয়া হয়েছে।

অক্টেট ডেটা টাইপ বর্ণনা মূল্য
uint8 ডেটা আইডি 0x0B - রেঞ্জিং কনফিগারেশন সেট করুন
uint8 ডেটার দৈর্ঘ্য বিভিন্ন
বাইট অ্যারে এককালীন প্রমাণীকরণ কী HMAC-SHA256-এর প্রথম ৮ বাইট (অ্যাকাউন্ট কী, প্রোটোকলের প্রধান সংস্করণ নম্বর || ক্যারেক্টারিস্টিক থেকে পঠিত সর্বশেষ ননস || ডেটা আইডি || ডেটার দৈর্ঘ্য || অতিরিক্ত ডেটা)।
১০ বাইট অ্যারে অতিরিক্ত তথ্য রেঞ্জিং: আউট-অফ-ব্যান্ড মেসেজ সিকোয়েন্স এবং পেলোড স্পেসিফিকেশনে সংজ্ঞায়িত রেঞ্জিং কনফিগারেশন মেসেজ (হেডার এবং পেলোড উভয়ই)

সারণি ১১: রেঞ্জিং কনফিগারেশন।

রেঞ্জিং কনফিগারেশন প্রতিক্রিয়া অপারেশন

সারণি ১২-তে রেঞ্জিং কনফিগারেশন রেসপন্স মেসেজটির সংজ্ঞা দেওয়া হয়েছে।

অক্টেট ডেটা টাইপ বর্ণনা মূল্য
uint8 ডেটা আইডি 0x0B - রেঞ্জিং কনফিগারেশন প্রতিক্রিয়া সেট করুন
uint8 ডেটার দৈর্ঘ্য বিভিন্ন
বাইট অ্যারে এককালীন প্রমাণীকরণ কী HMAC-SHA256-এর প্রথম ৮ বাইট (অ্যাকাউন্ট কী, প্রোটোকলের প্রধান সংস্করণ নম্বর || ক্যারেক্টারিস্টিক থেকে পঠিত সর্বশেষ ননস || ডেটা আইডি || ডেটার দৈর্ঘ্য || অতিরিক্ত ডেটা || 0x01)।
১০ বাইট অ্যারে অতিরিক্ত তথ্য রেঞ্জিং: আউট-অফ-ব্যান্ড মেসেজ সিকোয়েন্স এবং পেলোড স্পেসিফিকেশনে সংজ্ঞায়িত রেঞ্জিং কনফিগারেশন রেসপন্স মেসেজ (হেডার এবং পেলোড উভয়ই)

সারণি ১২: রেঞ্জিং কনফিগারেশন প্রতিক্রিয়া।

রেঞ্জিং অপারেশন বন্ধ করুন

সারণি ১৩-তে স্টপ রেঞ্জিং মেসেজটির সংজ্ঞা দেওয়া হয়েছে।

অক্টেট ডেটা টাইপ বর্ণনা মূল্য
uint8 ডেটা আইডি 0x0D - রেঞ্জিং স্টপ
uint8 ডেটার দৈর্ঘ্য বিভিন্ন
বাইট অ্যারে এককালীন প্রমাণীকরণ কী HMAC-SHA256-এর প্রথম ৮ বাইট (অ্যাকাউন্ট কী, প্রোটোকলের প্রধান সংস্করণ নম্বর || ক্যারেক্টারিস্টিক থেকে পঠিত সর্বশেষ ননস || ডেটা আইডি || ডেটার দৈর্ঘ্য)।
১০ বাইট অ্যারে অতিরিক্ত তথ্য রেঞ্জিং: আউট-অফ-ব্যান্ড মেসেজ সিকোয়েন্স এবং পেলোড স্পেসিফিকেশনে (হেডার এবং পেলোড উভয়ই) সংজ্ঞায়িত স্টপ রেঞ্জিং মেসেজ।

সারণি ১৩: পরিসীমা নির্ধারণ বন্ধ করুন।

রেঞ্জিং রেসপন্স অপারেশন বন্ধ করুন

সারণি ১৪-তে স্টপ রেঞ্জিং রেসপন্স মেসেজটির সংজ্ঞা দেওয়া হয়েছে।

অক্টেট ডেটা টাইপ বর্ণনা মূল্য
uint8 ডেটা আইডি 0x0D - রেঞ্জিং স্টপ প্রতিক্রিয়া
uint8 ডেটার দৈর্ঘ্য বিভিন্ন
বাইট অ্যারে এককালীন প্রমাণীকরণ কী HMAC-SHA256-এর প্রথম ৮ বাইট (অ্যাকাউন্ট কী, প্রোটোকলের প্রধান সংস্করণ নম্বর || ক্যারেক্টারিস্টিক থেকে পঠিত সর্বশেষ ননস || ডেটা আইডি || ডেটার দৈর্ঘ্য || অতিরিক্ত ডেটা || 0x01)।
১০ বাইট অ্যারে অতিরিক্ত তথ্য রেঞ্জিং: আউট-অফ-ব্যান্ড মেসেজ সিকোয়েন্স এবং পেলোড স্পেসিফিকেশনে সংজ্ঞায়িত স্টপ রেঞ্জিং রেসপন্স মেসেজ (হেডার এবং পেলোড উভয়ই)

সারণি ১৪: রেঞ্জিং প্রতিক্রিয়া বন্ধ করুন।

প্রিসিশন ফাইন্ডিং-এর মাধ্যমে অনাকাঙ্ক্ষিত ট্র্যাকিং থেকে সুরক্ষা

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

নির্ভুলভাবে অনুসন্ধানের জন্য রেঞ্জিং প্রযুক্তির নির্দিষ্ট বিবরণ

এই বিভাগে প্রযুক্তি-নির্দিষ্ট বিবরণ রয়েছে।

আল্ট্রা-ওয়াইডব্যান্ড (UWB) এর নির্দিষ্ট বিবরণ

UWB-এর নির্দিষ্ট বিবরণ।

নির্ভুলতা অনুসন্ধানের স্তর

রেঞ্জিং প্রযুক্তি হিসেবে UWB ব্যবহার করে প্রিসিশন ফাইন্ডিং সেশনগুলিতে দূরত্ব এবং দিক উভয় তথ্যই পাওয়া যেতে পারে। রেঞ্জিং ব্যবধান কমপক্ষে ২৪০ মিলিসেকেন্ড হওয়া প্রয়োজন, তবে সর্বোত্তম দিকনির্দেশনার জন্য ৯৬ মিলিসেকেন্ড বাঞ্ছনীয়।

কনফিগারেশন আইডি

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

Each config Id is a set of predefined UWB configuration parameters that is publicly documented . For the Precision Finding use case, the responder device must support config Id 6 , and optionally config Id 3 .

UWB Initiator and Responder

For the Precision Finding use case, the device noted as the Initiator device in this document will be the UWB responder, and the device noted as the Responder device in this document will be the UWB initiator. This is because the UWB initiator device consumes less power than UWB responder does, and in most cases the Responder device will be a peripheral with limited battery.

This means that the Responder device needs to indicate that it supports being a UWB initiator role in the Ranging Capability Response message.

  • Channel 9 must be supported
  • For optimal guidance, a 96ms ranging interval is recommended, otherwise 240ms must be supported.
  • Slot duration of 1ms is recommended for battery savings, but 2ms is also supported.
  • The UWB chip must be at least FIRA v1.2 + P-STS compliant.
  • BPRF is mandatory, HPRF is recommended but optional. The supported or selected mode is determined by the supported or selected preamble index.
  • Session security type: P-STS
BLE Channel Sounding (CS) specifics

BLE CS specific details.

Precision Finding level

Precision Finding sessions using CS as the ranging technology will cause distance only measurements, directionality is not provided at this moment.

Required bond between devices

Precision Finding sessions using Channel Sounding won't work if devices are not bonded. An existing bond between the initiator and the responder device is required. This specification does not provide a way for creating a bond between the devices. Instead, it is up to the developer of the use case to establish this bond between the devices.

Action required by the responder side for CS

Unlike UWB, where both devices are required to call the UWB start ranging and stop ranging API explicitly, for CS, only the initiator device is required to start CS ranging by calling the Bluetooth stack, the rest of the initialization on the responder side happens in-band using Bluetooth (BT). This means that upon receiving the Ranging Configuration message or the Stop Ranging message for CS, the responder side doesn't have to do anything if BT is enabled, other than reply with the Ranging Configuration Response message notification. The responder device could potentially use those messages as a trigger to update the UI where a screen is present, or regardless of having a screen it could be used for visual feedback on the devices state, for example blink the device LEDs.

Wi-Fi NAN RTT

Wi-Fi NAN RTT specific details.

Precision Finding level

Precision Finding sessions using Wi-Fi NAN RTT as the ranging technology will cause distance only measurements, directionality is not provided at this moment.

BLE RSSI

BLE RSSI specific details.

Precision Finding level

Precision Finding sessions using only BLE RSSI as the ranging technology won't be able to get either the distance or the direction information, due to BLE RSSI not being an accurate ranging technology. Instead, the user will see guidance indicating that device is close or device is far.

Advertised frames

After provisioning, the Provider is expected to advertise FHN frames at least once every 2 seconds. If Fast Pair frames are advertised, the Provider should interleave the FHN frames within the regular Fast Pair advertisements. For example, every two seconds, the Provider should advertise seven Fast Pair advertisements and one FHN advertisement.

The conducted Bluetooth transmit power for FHN advertisements should be set to at least 0 dBm.

The FHN frame carries a public key used to encrypt location reports by any supporting client that contributes to the crowdsourcing network. Two types of elliptic curve keys are available: a 160-bit key that fits legacy BLE 4 frames, or 256-bit key that requires BLE 5 with extended advertising capabilities. The Provider's implementation determines which curve is used.

An FHN frame is structured as follows.

Octet মূল্য বর্ণনা
0x02 দৈর্ঘ্য
0x01 Flags data type value
0x06 Flags data
0x18 or 0x19 দৈর্ঘ্য
0x16 Service data data type value
0xAA 16-bit service UUID
0xFE ...
0x40 or 0x41 FHN frame type with unwanted tracking protection mode indication
8..27 20-byte ephemeral identifier
২৮ Hashed flags

Table 15: FHN frame supporting a 160-bit curve.

Table 16 shows the byte offsets and values for a 256-bit curve.

Octet মূল্য বর্ণনা
0x02 দৈর্ঘ্য
0x01 Flags data type value
0x06 Flags data
0x24 or 0x25 দৈর্ঘ্য
0x16 Service data data type value
0xAA 16-bit service UUID
0xFE ...
0x40 or 0x41 FHN frame type with unwanted tracking protection mode indication
8..39 32-byte ephemeral identifier
৪০ Hashed flags

Table 16: FHN frame supporting a 256-bit curve.

Ephemeral identifier (EID) computation

A random is generated by AES-ECB-256 encrypting the following data structure with the ephemeral identity key:

Octet মাঠ বর্ণনা
0 - 10 প্যাডিং Value = 0xFF
১১ কে Rotation period exponent
12 - 15 TS[0]...TS[3] Beacon time counter, in 32-bit big-endian format. The K lowest bits are cleared.
16 - 26 প্যাডিং Value = 0x00
২৭ কে Rotation period exponent
28 - 31 TS[0]...TS[3] Beacon time counter, in 32-bit big-endian format. The K lowest bits are cleared.

Table 17: Construction of a pseudorandom number.

The result of this computation is a 256-bit number, denoted r' .

For the rest of the calculation, SECP160R1 or SECP256R1 are used for elliptic curve cryptographic operations. See curve definitions in SEC 2: Recommended Elliptic Curve Domain Parameters , which defines Fp , n and G referenced next.

r' is now projected to the finite field Fp by calculating r = r' mod n . Finally, compute R = r * G , which is a point on the curve representing the public key being used. The beacon advertises Rx , which is the x coordinate of R , as its ephemeral identifier.

Hashed flags

The hashed flags field is calculated as follows (bits are referenced from most significant to least significant):

  • Bits 0-4: Reserved (set to zeros).
  • Bits 5-6 indicates the battery level for the device as follows:
    • 00: Battery level indication unsupported
    • 01: Normal battery level
    • 10: Low battery level
    • 11: Critically low battery level (battery replacement needed soon)
  • Bit 7 is set to 1 if the beacon is in unwanted tracking protection mode, and 0 otherwise.

To produce the final value of this byte, it is xor-ed with the least significant byte of SHA256(r) .

Note that r should be aligned to the curve's size. Add zeros as most significant bits if its representation is shorter than 160 or 256 bits, or the most significant bits should be truncated if its representation is larger than 160 or 256 bits.

If the beacon doesn't support battery level indication, and isn't in unwanted tracking protection mode, it's allowed to omit this byte entirely from the advertisement.

Encryption with EID

To encrypt a message m , a sighter (having read Rx from the beacon) would do the following:

  1. Choose a random number s in Fp , as defined in the EID computation section.
  2. Compute S = s * G .
  3. Compute R = (Rx, Ry) by substitution in the curve equation and picking an arbitrary Ry value out of the possible results.
  4. Compute the 256-bit AES key k = HKDF-SHA256((s * R)x) where (s * R)x is the x coordinate of the curve multiplication result. Salt isn't specified.
  5. Let URx and LRx be the upper and lower 80-bits of Rx , respectively, in big-endian format. In a similar way, define USx and LSx for S .
  6. Compute nonce = LRx || LSx .
  7. Compute (m', tag) = AES-EAX-256-ENC(k, nonce, m) .
  8. Send (URx, Sx, m', tag) to the owner, possibly through an untrusted remote service.

Decryption of values encrypted with EID

The owner's client, which is in possession of the EIK and the rotation period exponent, decrypts the message as follows:

  1. Given URx , obtain the beacon time counter value on which URx is based. This can be done by the owner's client computing Rx values for beacon time counter values for the recent past and near future.
  2. Given the beacon time counter value on which URx is based, compute the anticipated value of r as defined in the EID computation section.
  3. Compute R = r * G , and verify a match to the value of URx provided by the sighter.
  4. Compute S = (Sx, Sy) by substitution in the curve equation and picking an arbitrary Sy value out of the possible results.
  5. Compute k = HKDF-SHA256((r * S)x) where (r * S)x is the x coordinate of the curve multiplication result.
  6. Compute nonce = LRx || LSx .
  7. Compute m = AES-EAX-256-DEC(k, nonce, m', tag) .

ID rotation

A resolvable (RPA) or non-resolvable (NRPA) BLE address must be used for advertising FHN frames. RPA is required for LE Audio (LEA) devices and is recommended for other devices, with the exception of locator tags that don't use bonding.

Fast Pair advertisement, FHN advertisement and the corresponding BLE address(es) should rotate at the same time. Rotation should happen every 1024 seconds on average. The precise point at which the beacon starts advertising the new identifier must be randomized within the window.

The recommended approach to randomize the rotation time is to set it to the next anticipated rotation time (if no randomization was applied) plus a positive randomized time factor in the range of 1 to 204 seconds.

When the device is in unwanted tracking protection mode, the BLE address of the FHN advertisement should be fixed, but the RPA for FP non-discoverable advertisement (such as Fast Pair) must keep rotating. It's acceptable to use different addresses for the different protocols.

Recovery from power loss

Resolving the ephemeral identifier is strongly tied to its clock value at the time of the advertisement, so it's important that the Provider can recover its clock value if there's a power loss. It is recommend that the Provider writes its current clock value to nonvolatile memory at least once per day, and that at boot time the Provider checks the NVM to see if there's a value present from which to initialize. Resolvers of the ephemeral identifier would implement resolution over a time window sufficient to allow for both reasonable clock drift and this type of power loss recovery.

Providers should still make all efforts to minimize clock drifts, as the resolution time window is limited. At least one additional clock synchronization method should be implemented (advertising non-discoverable Fast Pair frames or implementing the message stream ).

Fast Pair implementation guidelines

This section describes special aspects of the Fast Pair implementation on Providers that support FHN.

Locator tag specific guidelines

  • If the Provider was paired, but FHN wasn't provisioned within 5 minutes (or if an OTA update was applied while the device is paired but not FHN-provisioned), the Provider should revert to its factory configuration and clear the stored account keys.
  • After the Provider is paired, it shouldn't change its MAC address until FHN is provisioned or until 5 minutes pass.
  • If the ephemeral identity key is cleared from the device, the device should perform a factory reset and clear the stored account keys as well.
  • The Provider should reject normal Bluetooth pairing attempts and accept only Fast Pair pairing.
  • The Provider must include a mechanism that lets users temporarily stop advertising without factory resetting the device (for example, pressing a combination of buttons).
  • After a power loss, the device should advertise non-discoverable Fast Pair frames until the next invocation of read beacon parameters . This lets the Seeker detect the device and synchronize the clock even if a significant clock drift occurred.
  • When advertising non-discoverable Fast Pair frames, UI indications shouldn't be enabled.
  • Discoverable Fast Pair frames shouldn't be advertised while the Provider is provisioned for FHN.
  • The Provider shouldn't expose any identifying information information in an unauthenticated manner (eg names or identifiers).

Classic Bluetooth device-specific guidelines

This section describes special aspects of classic Bluetooth devices that support FHN.

FHN provisioning of already paired devices

The Provider isn't always provisioned for FHN when pairing with the Seeker, but a while after that. In that case, the Provider might not have an up-to-date BLE MAC address that's required to establish a GATT connection. The Provider must support at least one of the following ways for the Seeker to get its BLE address while it's already paired:

  • The Provider can periodically advertise the Fast Pair account data that lets the Seeker find its BLE address through a BLE scan.
    This approach suits Providers that don't implement the message stream.
  • The Provider can provide this data through the Fast Pair message stream over classic Bluetooth.
    This approach suits Providers that don't advertise Fast Pair frames while connected to the Seeker over Bluetooth.

Supporting both approaches increases the chances that the user can provision the device for FHN.

Fast Pair message stream

The Provider can implement Fast Pair message stream and use it to notify the Seeker about Device information . Implementing the message stream enables certain features as described in this section.

The Provider should send device information messages once every time the Message Stream is established.

Firmware version (device information code 0x09) and the tracking capability

When a firmware update adds FHN support to the Provider, a connected Seeker can notify the user about that and offer to provision it. Otherwise, the user has to navigate to the Bluetooth device list manually to initiate FHN provisioning.

To allow that, the Provider should use the Firmware version property (code 0x09) to report a string value that represents the firmware version. In addition, the Provider should support the protocol that lets the Seeker know about Capability changes due to firmware updates.

Octet ডেটা টাইপ বর্ণনা মূল্য
uint8 Device information event 0x03
uint8 Firmware version 0x09
২ - ৩ uint16 Additional data length বিভিন্ন
ভ্যার byte array Version string বিভিন্ন

Table 18: Device information event: updated firmware version.

Upon receiving a capability update request (0x0601), if the Provider has enabled support for FHN tracking, it should respond as shown in table 12.

Octet ডেটা টাইপ বর্ণনা মূল্য
uint8 Device capability sync event 0x06
uint8 FHN tracking 0x03
২ - ৩ uint16 Additional data length 0x0007
uint8 FHN provisioning state 0x00 if unprovisioned; 0x01 if provisioned by any account
5 - 10 byte array The current BLE MAC address of the device বিভিন্ন

Table 19: Device capability sync event: added tracking capability.

Current ephemeral identifier (device information code 0x0B)

The Provider can use the current ephemeral identifier (code 0x0B) to report the current EID and clock value when the Provider is provisioned for FHN, to sync the Seeker in case of a clock drift (for example, due to drained battery). Otherwise, the Seeker initiates a more expensive and less reliable connection for this purpose.

Octet ডেটা টাইপ বর্ণনা মূল্য
uint8 Device information event 0x03
uint8 Current ephemeral identifier 0x0B
২ - ৩ uint16 Additional data length 0x0018 or 0x0024
4 - 7 byte array Clock value Example: 0x13F9EA80
8 - 19 or 31 byte array Current EID Example: 0x1122334455667788990011223344556677889900

Table 20: Device information event: clock sync.

ফ্যাক্টরি রিসেট

For devices that support factory reset: if a factory reset is performed, the Provider must stop beaconing and wipe out the ephemeral identity key and all stored account keys, including the owner's account key.

After a factory reset (either manual or programmatic), the Provider shouldn't start advertising Fast Pair right away, to prevent the pairing flow to start immediately after the user deletes the device.

Unwanted tracking prevention

Certified FHN devices must also meet the requirements in the implementation version of the cross-platform specification for Detecting Unwanted Location Trackers (DULT).

Relevant guidelines specific to FHN to be compliant with DULT spec:

  • Any FHN compatible device must be registered in the Nearby Device Console, and have the "Find Hub" capability activated.
  • The device must implement the Accessory Non-Owner service and characteristic defined in the implementation version of the DULT spec, including the Accessory Information operations and Non-owner controls .
  • During the backward compatibility period, as defined in the DULT spec, there are no changes to the advertised frame as defined in this document.
  • "Unwanted tracking protection mode" defined in this document maps to the "separated state" defined by the DULT spec.
  • Guidelines for implementing the Accessory Information opcodes:
    • Get_Product_Data should return the model ID provided by the console, zero padded to fit the 8-byte requirement. For example, model ID 0xFFFFFF is returned as 0x0000000000FFFFFF.
    • Get_Manufacturer_Name and Get_Model_Name should match the values provided in the console.
    • Get_Accessory_Category can return the generic "Location Tracker" value if no other category better fits the type of the device.
    • Get_Accessory_Capabilities must indicate the support for ringing as well as BLE identifier lookup.
    • Get_Network_ID should return Google's identifier (0x02).
  • Guidelines for implementing the Get_Identifier opcode:
    • The operation should only return a valid response for 5 minutes after the user activated the 'identification' mode, which requires a combination of button presses. A visual or audio signal should indicate to the user that the provider entered that mode. The model-specific instructions for activating that mode must be provided to Google as a requirement for certification and at least 10 days prior to any update or modification to the instructions.
    • The response is constructed as: the first 10 bytes of current ephemeral identifier, followed by the first 8 bytes of HMAC-SHA256(recovery key, the truncated current ephemeral identifier) .
  • Guidelines for implementing Identifier over NFC:
    • As a URL, use find-my.googleapis.com/lookup .
    • As the e parameter, use the same response as constructed for Get_Identifier , hex encoded.
    • As the pid parameter, use the same response as constructed for Get_Product_Data , hex encoded.
  • It is mandatory for the device to include a sound maker and support the ringing function. Per the DULT spec, the sound maker must emit a sound with minimum 60 Phon peak loudness as defined by ISO 532-1:2017.
  • Guidelines for implementing the Sound_Start opcode:
    • The command should trigger ringing in all available components.
    • The maximal supported volume should be used.
    • The recommended duration for ringing is 12 seconds.
  • Locator tags must include a mechanism that lets users temporarily stop advertising without factory resetting the device (for example, pressing a combination of buttons).
    • The disablement instructions must be documented in a publicly available URL and provided to Google as a requirement for certification and at least 10 days prior to any update or modification to the instructions.
    • The URL should support localization. Depending on the client, the language will be provided either as a query param ("hl=en") or using the "accept-language" HTTP header.

Switchable protocol guidelines

  • Only one protocol should be used at a time. Ensure that no more than one network can operate on the device simultaneously. This requirement is needed to ensure that there is no commingling of sensitive user data between varying protocols.
  • It is suggested to incorporate a hard reset workflow into the device that allows a user to re-setup a device with a different network.
  • The process of updating a device to a network should be user friendly and equitable between networks. A user must be able to choose which network they want to use without giving preference to one of the networks. This flow needs to be approved by the Google team.

Firmware updates

The process and distribution of OTA updates should be managed by the partner using their own Mobile or Web app workflow.

Fast Pair supports delivering notifications to the user, informing of available OTA updates. In order to use this mechanism:

  • The latest firmware version should be updated in the Nearby Device Console.
  • A companion App should be set in the Nearby Device Console. It should support the firmware update intent .
  • Provider should implement the Firmware revision GATT characteristic.

To prevent tracking, access to the Firmware revision characteristic should be restricted. Seeker will first read the provisioning state and provide an authentication key, as defined in this specification, and only then read the firmware revision. This will be done over the same connection. If an attempt is made to read the firmware revision, and the Provider isn't bonded nor an authenticated operation was successfully completed over that same connection, the Provider should return an unauthenticated error.

সামঞ্জস্যতা

Find Hub network requires location services and Bluetooth to be turned on. Requires cell service or internet connection. Works on Android 9+ and in certain countries for age-eligible users.

পরিবর্তন তালিকা

FHN Version তারিখ মন্তব্য
v1 Initial release of the FHN spec for early access.
v1.1 ফেব্রুয়ারী ২০২৩
  • Added a cleartext indication of unwanted tracking protection mode.
  • Added an option to skip authentication of ringing requests while in unwanted tracking protection mode.
v1.2 Apr 2023
  • Updated the definition of an owner's AK.
  • Added a recommendation for recovering from power loss in locator tags.
  • Added a clarification for MAC address randomization.
  • Added a clarification on MAC address rotation while in unwanted tracking protection mode.
  • Added a guideline on having a way to deactivate a locator tag.
v1.3 Dec 2023
  • Added a clarification on identifying information exposed by locator tags.
  • Added a requirement to implement the unwanted tracking prevention specification.
  • Added guidelines for switchable protocol devices.