واجهة النطاق الفائق العرض (HAL)

يستخدم حِزمة النطاق الفائق العرض (UWB) في AOSP واجهة UCI التي تحدّدها FiRa كسطح HAL. تستخدم واجهة HAL مسارًا مسدودًا (IUwbChip::sendUciMessage() وIUwbClientCallback::onUciMessage()) لإرسال وتلقّي أوامر واجهة الأوامر في النطاق الفائق العرض (UCI) وردود الإشعارات. على جميع مورّدي تقنية النطاق الفائق العرض (UWB) لأجهزة Android إتاحة جميع الرسائل المحدّدة في مواصفات FiRa. يتوافق إطار عمل النطاق الفائق العرض مع الإصدارات القديمة ويعمل مع أي إصدار UCI نفَّذه مزوّد النطاق الفائق العرض على الجهاز. بما أنّ إطار عمل UWB في AOSP هو وحدة، فإنه يمكنه أيضًا إضافة ميزات بشكل انتقائي لطلبات التغيير الموافَق عليها (طلبات التعديل) من مسودة مواصفات UCI المخصّصة لإصدارات معايير FiRa الرئيسية. إنّ أي طلبات إعادة نظر تم تنفيذها من هذا النوع هي عرضة للتغيير.

تعريف الواجهة

يتم تحديد واجهة UWB HAL باستخدام AIDL الثابت. تستخدم الواجهة الرئيسية حزمة android.hardware.uwb.

في ما يلي الواجهات الرئيسية في حزمة android.hardware.uwb.

IUwbChip.aidl

package android.hardware.uwb;

interface IUwbChip {

 String getName();

 void open(in android.hardware.uwb.IUwbClientCallback clientCallback);

 void close();

 void coreInit();

 void sessionInit(int sessionId);

 int getSupportedAndroidUciVersion();

 int sendUciMessage(in byte[] data);

}

IUwbClientCallback.aidl

package android.hardware.uwb;

interface IUwbClientCallback {

 oneway void onUciMessage(in byte[] data);

 oneway void onHalEvent(in android.hardware.uwb.UwbEvent event, in android.hardware.uwb.UwbStatus status);

}

مسار مكالمة HAL من إطار عمل UWB

توضّح الصور التالية تسلسل المكالمات من إطار عمل النطاق الفائق العرض (UWB) لعمليات إعداد حِزمة UWB وإلغاء إعدادها وبدء جلسة UWB وإيقافها.

الشكل 1: مسار استدعاء إعداد حزمة النطاق الفائق العرض (UWB) (تفعيل خيار UWB)

الشكل 2: تسلسل المكالمات لإزالة إعدادات حزمة النطاق الفائق العرض (UWB) (إيقاف التبديل في النطاق الفائق العرض)

الشكل 3: عملية بدء/إيقاف جلسة النطاق الفائق العرض (UWB)

ضبط رمز بلد النطاق الفائق العرض (UWB)

كما هو موضّح في الشكل 1، يضبط إطار عمل UWB رمز بلد UWB أثناء بدء تجميع UWB باستخدام الأمر UCI في مساحة المورّد ANDROID_SET_COUNTRY_CODE (GID=0xC، OID=0x1). يحاول إطار عمل UWB تحديد رمز بلد UWB باستخدام المصادر التالية (المدرَجة بترتيب الأهمية ). يتوقف إطار عمل UWB عند المصدر الأول الذي يتم فيه تحديد رمز البلد.

1. إلغاء رمز البلد: يتم فرض رمز البلد من خلال أمر shell adb (اختبار محلي أو آلي).
2. رمز البلد للهاتف: يتم استرداد رمز البلد من خلال شبكة الجوّال. إذا كانت هناك عدة شرائح SIM تعرِض رموزًا مختلفة، يكون رمز البلد الذي تم اختياره غير محدّد.
3. رمز البلد لشبكة Wi-Fi: رمز البلد الذي تم استرجاعه من خلال شبكة Wi-Fi (80211.ad).
4. آخر رمز بلد معروف للاتصال الهاتفي: آخر رمز بلد معروف تم استرجاعه من خلال شبكة الجوّال إذا كانت هناك شرائح SIM متعددة تعرض رموًا مختلفة، يكون رمز البلد الذي تم اختياره غير محدّد.
5. رمز بلد الموقع: رمز البلد الذي تم استرجاعه من LocationManager موفِّر الموقع الجغرافي المجمّع
6. رمز البلد التلقائي للمصنّع الأصلي للجهاز: رمز البلد الذي ضبطه المصنّع الأصلي للجهاز.

إذا تعذّر على إطار عمل النطاق الفائق العرض (UWB) تحديد رمز بلد النطاق الفائق العرض (UWB)، يُطلِب الإطار ANDROID_SET_COUNTRY_CODE الأمر UCI بالقيمة DEFAULT_COUNTRY_CODE ("00") ويُعلم تطبيقات النطاق الفائق العرض (UWB) بأنّ حالة حِزمة النطاق الفائق العرض (UWB) هي DISABLED. في وقت لاحق، عندما يتمكّن إطار عمل UWB من تحديد رمز بلد شرعي، يتم ضبط رمز البلد الجديد باستخدام الأمر ANDROID_SET_COUNTRY_CODE وإرسال إشعار إلى تطبيقات UWB بأنّ حِزمة UWB هي READY.

إذا تعذّر استخدام تقنية النطاق الفائق العرض (UWB) بسبب اللوائح المحلية في بلد معيّن، يعرض جهاز التحكّم في تقنية النطاق الفائق العرض رمز الحالة STATUS_CODE_ANDROID_REGULATION_UWB_OFF. بعد ذلك، يُرسِل إطار عمل UWB إعلامًا إلى تطبيقات UWB بأنّ حالة حِزمة UWB هي DISABLED.

عندما ينتقل المستخدم إلى بلد مختلف، يضبط إطار عمل UWB رمز بلد جديد باستخدام الأمر ANDROID_SET_COUNTRY_CODE UCI. استنادًا إلى код الحالة الذي يعرضه جهاز التحكّم في النطاق الفائق العرض (UWB) (استنادًا إلى اللوائح التنظيمية للنطاق الفائق العرض في البلد الجديد)، قد يؤدي ذلك إلى تغيير في حالة حِزمة النطاق الفائق العرض.

تنسيق الأوامر المحدَّد في مواصفات FIRA UCI

للاطّلاع على تنسيق حزم التحكّم في UCI، يُرجى الاطّلاع على القسم 4.4.2 من مواصفات UCI.

تحديد إصدارات الواجهة

تسمح مواصفات UCI لبائعي تقنية النطاق الفائق العرض (UWB) بعرض إصدار حِزمة UCI الذي نفَّذه الجهاز باستخدام الأمرَين UCI_GET_DEVICE_INFO_RSP و UCI_GET_CAPS_INFO_RSP. يستخدم إطار العمل هذه الأوامر لجلب إصدار UCI للجهاز وتغيير سلوكه وفقًا لذلك.

قائمة مسودات طلبات تحديث البرامج القابلة للتنفيذ التي تتوافق مع وحدة النطاق الفائق العرض (UWB)

تتيح وحدة النطاق الفائق العرض (UWB) الإصدار 330810000 مسودة طلبات إعادة النظر التالية في FiRa 2.0:

• الطلب رقم 287
• متطلبات واجهة CCC Digital Key لتوفير SUS API ودعم مواصفات UCI

واجهة UCI في Android (جزء المورّد في FiRa)

تحدِّد مواصفات UCI مجموعة من معرّفات المجموعات (GID) ومعرّفات تعليمات التشغيل (OID) لجميع الرسائل المحدّدة في المواصفات. تحتفظ المواصفة أيضًا بمجموعة من أرقام تعريف Google محجوزة حصريًا لاستخدام المورّدين. تستخدِم حزمة AOSP UWB بعض معرّفات GID ومعرّفات OID الخاصة بالمورّدين هذه لأوامر خاصة بنظام التشغيل Android لم يتم تحديدها في المواصفات. لمعرفة التفاصيل، يُرجى الاطّلاع على القسم 8.4 من مواصفات UCI.

يتم تعريف رسائل المورّدين هذه التي يستخدمها Android في ملف برمجي android.hardware.uwb.fira_android HAL.

إصدارات واجهة المورّد

على مورّدي تقنية النطاق الفائق العرض (UWB) عرض إصدار حزمة android.hardware.uwb.fira_android HAL المتوافقة على الجهاز من خلال IUwbChip.getSupportedAndroidUciVersion(). يستخدم إطار العمل معلومات الإصدار هذه للتعامل مع التوافق مع الإصدارات القديمة.

قائمة أرقام تعريف Google وأرقام تعريف OpenID في Android

يسرد الجدول التالي أرقام تعريف Google وأرقام تعريف OpenID لنظام التشغيل Android. إنّ معرّفات Google‏ 0xE و0xF محجوزة لمصنّعي المعدّات الأصلية لأجهزة Android.

إضافات المورّدين إلى الرسائل المحدّدة في مواصفات UCI

يصف هذا القسم تفاصيل إضافات المورّدين إلى الرسائل المحدّدة بمواصفات UCI.

‫SESSION_SET_APP_CONFIG_[CMD|RSP] وSESSION_GET_APP_CONFIG_[CMD|RSP]

في ما يلي قيم طول النوع (TLV) التي حدّدتها حِزمة AOSP في الجزء المحجوز للمورّد من قيم طول النوع في APP_CONFIG:

• GID: 0001b (مجموعة إعدادات جلسة UWB)
• رقم التعريف الفريد (OID): 000011b‏ (SESSION_SET_APP_CONFIG_CMD)
• رقم التعريف المفتوح (OID): 000100b‏ (SESSION_GET_APP_CONFIG_CMD)

يسرد الجدول التالي مَعلمات رسائل ضبط جلسة النطاق الفائق العرض (UWB).

CORE_GET_CAPS_INFO_RSP

في ما يلي حِزم البيانات الوصفية التي حدّدتها حِزمة AOSP في القسم المخصّص للمورّد من حِزم البيانات الوصفية في CAPS_INFO:

• رقم تعريف المجموعة: 0000b (مجموعة UWB الأساسية)
• رقم التعريف الفريد (OID): 000011b‏ (CORE_GET_CAPS_INFO_RSP)

يسرد الجدول التالي مَعلمات رسائل إمكانات النطاق الفائق العرض (UWB).

رموز الحالة

في ما يلي رموز الحالة في مساحة المورّد. ويتم عرض هذه البيانات في ردود UCI (مثل SESSION_START_RSP) من خلال النظام الفرعي لتقنية النطاق الفائق العرض (UWBS).

رمز سبب تغيير الحالة في SESSION_STATUS_NTF

في ما يلي رموز أسباب تغيير الحالة المحدّدة في مساحة المورّد لسمة الحالة التي يعرضها ملف UWBS في SESSION_STATUS_NTF. يُرسِل هذا الإشعار بروتوكول UWBS عند تغيُّر حالة جلسة قياس المسافة (على سبيل المثال، من ACTIVE إلى IDLE).