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 boru (IUwbChip::sendUciMessage() ve IUwbClientCallback::onUciMessage()) kullanır. Tüm Android ultra geniş bant tedarikçileri, FiRa spesifikasyonunda tanımlanan tüm mesajları desteklemelidir. Ultra geniş bant çerçevesi geriye dönük uyumludur ve cihazda ultra geniş bant tedarikçisi tarafından uygulanan tüm UCI sürümleriyle çalışır. AOSP ultra geniş bant çerçevesi bir modül olduğundan, önemli FiRa standart sürümleri için hedeflenen taslak UCI spesifikasyonlarından onaylanmış değişiklik istekleri (CR'ler) için seçici olarak destek de ekleyebilir. Uygulanan bu tür taslak inceleme raporları değiştirilebilir.

Arayüz tanımı

UWB HAL arayüzü, sağlam AIDL kullanılarak tanımlanır. Ana arayüz android.hardware.uwb paketini kullanır.

Aşağıda, android.hardware.uwb paketindeki iki ana arayüz gösterilmektedir.

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ının başlatılması, UWB yığınının devre dışı bırakılması ve UWB oturumunun başlatılması ve durdurulması süreçleri için UWB çerçevesinden gelen çağrı akışı gösterilmektedir.

Şekil 1. UWB yığınını ilk kullanıma hazırlama çağrı akışı (UWB açma/kapatma düğmesi)

Şekil 2. UWB yığınının ilk durumuna döndürme çağrı akışı (UWB açma/kapatma düğmesi)

Şekil 3. Ultra geniş bant oturumu başlatma/durdurma akışı

Ultra geniş bant ülke kodu yapılandırması

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

1. Ülke kodunu geçersiz kılma: Ülke kodu, adb kabuk komutu aracılığıyla zorunlu kılınmıştır (yerel veya otomatik test).
2. Telefon ülke kodu: Cep telefonu üzerinden alınan ülke kodu. Farklı kodlar döndüren birden fazla SIM varsa seçilen ülke kodu kesin değildir.
3. Kablosuz ağ ülke kodu: Kablosuz ağ üzerinden alınan ülke kodu (80211.ad).
4. Bilinen son telefon ülke kodu: Cep telefonu üzerinden alınan bilinen son ülke kodu. Farklı kodlar döndüren birden fazla SIM varsa seçilen ülke kodu rastgeledir.
5. Konum ülke kodu: Birleştirilmiş konum sağlayıcıdan alınan ülke kodu.LocationManager
6. OEM varsayılan ülke kodu: Cihaz üreticisi tarafından ayarlanan ülke kodu.

UWB çerçevesi bir UWB ülke kodu belirleyemezse ANDROID_SET_COUNTRY_CODE UCI komutunu DEFAULT_COUNTRY_CODE ("00") değerine sahip olarak çağırır ve UWB uygulamalarını UWB yığın durumunun DISABLED olduğunu bildirir. Daha sonra, ultra geniş bant çerçevesi geçerli bir ülke kodu belirleyebildiğinde ANDROID_SET_COUNTRY_CODE komutunu kullanarak yeni ülke kodunu yapılandırır ve ultra geniş bant uygulamalarını ultra geniş bant yığınının READY olduğunu bildirir.

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

Kullanıcı farklı bir ülkeye gittiğinde UWB çerçevesi, ANDROID_SET_COUNTRY_CODE UCI komutunu kullanarak yeni bir ülke kodu yapılandırır. Bu durum, ultra geniş bant denetleyicisi tarafından döndürülen durum koduna (yeni ülkedeki ultra geniş bant düzenlemelerine bağlı olarak) bağlı olarak ultra geniş bant yığın durumunda bir değişikliğe neden olabilir.

FIRA UCI spesifikasyonu tarafından 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 tedarikçilerinin UCI_GET_DEVICE_INFO_RSP ve UCI_GET_CAPS_INFO_RSP komutlarını kullanarak cihaz tarafından uygulanan UCI yığınının sürümünü göstermesine olanak tanır. Çerçeve, cihazın UCI sürümünü almak 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ü Şartları İçin SUS API ve UCI Spec Desteği

Android UCI arayüzü (FiRa tedarikçi firma bölümü)

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

Android tarafından kullanılan bu tedarikçi mesajları, android.hardware.uwb.fira_android HAL paketinde tanımlanır.

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

Ultra geniş bant tedarikçileri, cihazda desteklenen android.hardware.uwb.fira_android HAL paketinin sürümünü IUwbChip.getSupportedAndroidUciVersion() üzerinden göstermelidir. Çerçeve, geriye dönük uyumluluğu yönetmek için bu sürüm bilgilerini kullanır.

Android GID'lerinin ve OID'lerinin listesi

Aşağıdaki tabloda Android için GID'ler ve OID'ler listelenmiştir. 0xE ve 0xF GID'leri Android OEM'lerin kullanması için ayrılmıştır.

UCI spesifikasyonu tarafından tanımlanan mesajlara yönelik tedarikçi uzantıları

Bu bölümde, UCI spesifikasyonu tarafından tanımlanan mesajlara yönelik tedarikçi 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 tedarikçi firma tarafından ayrılmış kısmında AOSP yığını tarafından tanımlanan tür uzunluk değerleri (TLV'ler) verilmiştir:

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

Aşağıdaki tabloda, ultra geniş bant oturum yapılandırma mesajlarının parametreleri listelenmiştir.

CORE_GET_CAPS_INFO_RSP

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

• GID: 0000b (ultra geniş bant çekirdek grubu)
• OID: 000011b (CORE_GET_CAPS_INFO_RSP)

Aşağıdaki tabloda, ultra geniş bant özellik mesajlarının parametreleri listelenmiştir.

Durum kodları

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

SESSION_STATUS_NTF'deki 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 menzil belirleme oturumunun durumu değiştiğinde (örneğin, ACTIVE yerine IDLE) UWBS tarafından gönderilir.