Ultra geniş bant HAL arayüzü

AOSP ultra geniş bant (UWB) yığını, HAL yüzeyi olarak FiRa tarafından tanımlanan UCI arayüzünü kullanır. HAL arayüzü, UWB komut arayüzü (UCI) komutlarını, yanıtlarını ve bildirimlerini göndermek ve almak için opak bir kanal (IUwbChip::sendUciMessage() ve IUwbClientCallback::onUciMessage()) kullanır. Tüm Android UWB tedarikçileri, FiRa spesifikasyonunda tanımlanan tüm mesajları desteklemelidir. Ultra geniş bant çerçevesi geriye dönük olarak uyumludur ve cihazda ultra geniş bant satıcısı tarafından uygulanan tüm UCI sürümleriyle çalışır. AOSP UWB çerçevesi bir modül olduğundan, büyük FiRa standart sürümleri için hedeflenen taslak UCI spesifikasyonlarından onaylanmış değişiklik istekleri (CR) için de seçici olarak destek ekleyebilir. Uygulanan bu tür taslak hazır yanıtlar değişebilir.

Arayüz tanımı

UWB HAL arayüzü, kararlı AIDL kullanılarak tanımlanır. Ana arayüzde android.hardware.uwb paketi kullanılır.

android.hardware.uwb paketindeki iki ana arayüz şunlardır:

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);

}

UWB çerçevesinden HAL çağrı akışı

Aşağıdaki resimlerde, UWB yığını başlatma, UWB yığını başlatmayı kaldırma ve UWB oturumu başlatma ve durdurma işlemleri için UWB çerçevesinden gelen çağrı akışı gösterilmektedir.

1. şekil. UWB yığını başlatma çağrı akışı (UWB açma/kapatma)

Şekil 2. UWB yığını başlatmayı kaldırma çağrısı akışı (UWB kapatıldığında)

3.Şekil UWB oturumunu başlatma/durdurma akışı

UWB ülke kodu yapılandırması

1. Şekil'de gösterildiği gibi, UWB çerçevesi, UWB yığınını başlatma sırasında tedarikçi alanındaki UCI komutunu ANDROID_SET_COUNTRY_CODE (GID=0xC, OID=0x1) kullanarak UWB ülke kodunu yapılandırır. UWB çerçevesi, UWB ülke kodunu aşağıdaki kaynakları kullanarak belirlemeye çalışır (öncelik sırasına göre listelenmiştir). UWB çerçevesi, ülke kodunun belirlendiği ilk kaynakta durur.

1. Ülke kodunu geçersiz kılma: Bir adb shell komutuyla zorlanan ülke kodu (yerel veya otomatik test).
2. Telefon ülke kodu: Hücresel bağlantı üzerinden alınan ülke kodu. Farklı kodlar döndüren birden fazla SIM varsa seçilen ülke kodu belirlenemez.
3. Kablosuz ülke kodu: Kablosuz (80211.ad) üzerinden alınan ülke kodu.
4. Bilinen son telefon ülke kodu: Hücresel bağlantı üzerinden alınan bilinen son ülke kodu. Farklı kodlar döndüren birden fazla SIM varsa seçilen ülke kodu belirlenemez.
5. Konum ülke kodu: LocationManager Birleştirilmiş konum sağlayıcıdan alınan ülke kodu.
6. OEM varsayılan ülke kodu: Cihaz üreticisi tarafından ayarlanan ülke kodu.

UWB çerçevesi bir UWB ülke kodunu belirleyemezse ANDROID_SET_COUNTRY_CODE değeriyle UCI komutunu çağırır ve UWB uygulamalarını UWB yığını durumunun DISABLED olduğu konusunda bilgilendirir.DEFAULT_COUNTRY_CODE ("00") Daha sonra, UWB çerçevesi geçerli bir ülke kodu belirleyebildiğinde ANDROID_SET_COUNTRY_CODE komutunu kullanarak yeni ülke kodunu yapılandırır ve UWB uygulamalarına UWB yığınının READY olduğunu bildirir.

Bir ülkedeki yerel düzenlemeler nedeniyle UWB kullanılamıyorsa UWB denetleyicisi STATUS_CODE_ANDROID_REGULATION_UWB_OFF durum kodunu döndürür. Ultra geniş bant çerçevesi daha sonra ultra geniş bant uygulamalarına ultra geniş bant yığını durumunun DISABLED olduğunu bildirir.

Bir kullanıcı farklı bir ülkeye seyahat ettiğinde UWB çerçevesi, ANDROID_SET_COUNTRY_CODE UCI komutunu kullanarak yeni bir ülke kodu yapılandırır. UWB denetleyicisi tarafından döndürülen durum koduna (yeni ülkedeki UWB düzenlemelerine göre) bağlı olarak, bu durum UWB yığını durumunda değişikliğe yol açabilir.

FIRA UCI spesifikasyonuyla tanımlanan komut biçimi

UCI kontrol paketlerinin biçimi için UCI spesifikasyonunun 4.4.2 bölümüne bakın.

Arayüz sürümü oluşturma

UCI spesifikasyonu, UWB satıcılarının UCI_GET_DEVICE_INFO_RSP ve UCI_GET_CAPS_INFO_RSP komutlarını kullanarak cihaz tarafından uygulanan UCI yığını sürümünü göstermesine olanak tanır. Çerçeve, cihazın UCI sürümünü getirmek ve davranışını buna göre değiştirmek için bu komutları kullanır.

UWB modülü tarafından desteklenen taslak CR'lerin listesi

FiRa 2.0 için aşağıdaki taslak CR'ler, UWB modülü sürüm #330810000 tarafından desteklenir:

• CR 287
• CCC Dijital Anahtar Arayüzü İçin SUS API ve UCI Spesifikasyon Desteği Gereksinimler

Android UCI arayüzü (FiRa satıcı bölümü)

UCI spesifikasyonu, spesifikasyon tarafından tanımlanan tüm mesajlar için bir grup tanımlayıcı (GID) ve işlem kodu tanımlayıcı (OID) grubu tanımlar. Spesifikasyon, yalnızca satıcı kullanımı için ayrılmış bir dizi GID'yi de ayırır. AOSP UWB yığını, spesifikasyonda tanımlanmayan Android'e özgü komutlar için bu satıcı GID'lerinden ve OID'lerinden bazılarını kullanır. Ayrıntılar için UCI spesifikasyonunun 8.4 bölümüne bakın.

Android tarafından kullanılan bu satıcı mesajları, android.hardware.uwb.fira_android HAL paketinde tanımlanır.

Tedarikçi arayüzü sürümü oluşturma

UWB tedarikçileri, cihazda desteklenen android.hardware.uwb.fira_android HAL paketinin sürümünü IUwbChip.getSupportedAndroidUciVersion() aracılığıyla kullanıma sunmalıdır. Çerçeve, geriye dönük uyumluluğu sağlamak için bu sürüm oluşturma bilgilerini kullanır.

Android GID'lerinin ve OID'lerinin listesi

Aşağıdaki tabloda Android için GID'ler ve OID'ler listelenmiştir. GID'ler 0xE ve 0xF, Android OEM'leri tarafından kullanılmak üzere ayrılmıştır.

UCI spesifikasyonunda tanımlanan mesajlara tedarikçi uzantıları

Bu bölümde, UCI spesifikasyonunda tanımlanan iletilere yönelik satıcı uzantılarının ayrıntıları açıklanmaktadır.

SESSION_SET_APP_CONFIG_[CMD|RSP] ve SESSION_GET_APP_CONFIG_[CMD|RSP]

Aşağıda, APP_CONFIG içindeki TLV'lerin satıcıya ayrılmış bölümünde AOSP yığını tarafından tanımlanan tür uzunluğu değerleri (TLV'ler) verilmiştir:

• GID: 0001b (UWB oturum yapılandırma grubu)
• OID: 000011b (SESSION_SET_APP_CONFIG_CMD)
• OID: 000100b (SESSION_GET_APP_CONFIG_CMD)

Aşağıdaki tabloda, UWB oturumu yapılandırma iletilerinin parametreleri listelenmiştir.

CORE_GET_CAPS_INFO_RSP

Aşağıda, CAPS_INFO içindeki TLV'lerin tedarikçiye ayrılmış bölümünde AOSP yığını tarafından tanımlanan TLV'ler verilmiştir:

• GID: 0000b (UWB çekirdek grubu)
• OID: 000011b (CORE_GET_CAPS_INFO_RSP)

Aşağıdaki tabloda, UWB özelliği mesajlarının parametreleri listelenmiştir.

Durum kodları

Tedarikçi alanındaki durum kodları aşağıda verilmiştir. Bunlar, UWB alt sistemi (UWBS) tarafından UCI yanıtlarında (ör. SESSION_START_RSP) döndürülür.

SESSION_STATUS_NTF içindeki durum değişikliği nedeni kodu

Aşağıda, SESSION_STATUS_NTF içinde bir UWBS tarafından döndürülen durum alanı için tedarikçi alanında tanımlanan durum değişikliği nedeni kodları verilmiştir. Bu bildirim, bir mesafe ölçme oturumunun durumu değiştiğinde (örneğin, ACTIVE'dan IDLE'ya) UWBS tarafından gönderilir.