A partir de 27 de março de 2025, recomendamos usar android-latest-release
em vez de aosp-main
para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.
Banda ultralarga
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
No Android 13, o Android inclui uma implementação de framework padrão
para tecnologia de rádio de banda ultralarga (UWB), uma tecnologia que
permite o alcance preciso e altamente seguro entre dispositivos com suporte a essa tecnologia. A pilha
AOSP UWB da plataforma está disponível como um
módulo opcional para fabricantes de dispositivos.
Para mais detalhes sobre o módulo, consulte
Módulo: UWB.
Arquitetura
A pilha UWB consiste no módulo principal da UWB e na implementação HAL
fornecida por um fornecedor de chip UWB, conforme mostrado na Figura 1.
Figura 1. Arquitetura de pilha UWB
Pilha do AOSP
A pilha UWB do AOSP, empacotada como um módulo opcional, com.google.android.uwb
,
contém os seguintes componentes:
- Plataforma UWB da API
- Local do código:
packages/modules/Uwb/framework
- Biblioteca de suporte
- Local do código:
packages/modules/Uwb/service/support_lib
- Camada UwbService e camada de gerenciamento de serviços comum (CSML, na sigla em inglês) definidas
por componentes definidos por FiRa
- Local do código:
packages/modules/Uwb/service
- Camada UCI nativa do Rust
- Local do código:
external/uwb
- Interface HAL para UWB baseada na especificação da interface de comando (UCI, na sigla em inglês) para UWB
definida pela FiRa
- Local do código:
hardware/interfaces/uwb
Componentes do fornecedor
A pilha do fornecedor inclui uma implementação de HAL do fornecedor UWB, um driver UWB e um
dispositivo UWB.
Superfícies de API para UWB
A pilha UWB inclui plataformas de API para apps do sistema e de terceiros.
Apps do sistema
Os fabricantes de dispositivos usam a
API do sistema android.uwb.UwbManager
para permitir o acesso de baixo nível a apps do sistema. Para usar essa
API, os apps do sistema precisam usar a biblioteca de suporte
(packages/modules/Uwb/service/support_lib
).
Apps de terceiros
Os apps de terceiros usam a plataforma da API pública do Jetpack UWB,
androidx.core.uwb
.
Para mais informações, consulte
Comunicação de banda ultralarga.
Verificação
Para verificar a implementação do UWB, verifique se o dispositivo passa nos testes
do CTS localizados em /cts/tests/uwb
.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-27 UTC."],[],[],null,["# Ultra-wideband\n\nFrom Android 13, Android includes a default framework\nimplementation for ultra-wideband (UWB) radio technology, a technology that\nenables highly secure, precise ranging between supported devices. The platform\nAOSP UWB stack is available as an optional\n[module](/docs/core/architecture/modular-system) for device manufacturers.\nFor more details on the module, see\n[Module: UWB](/docs/core/ota/modular-system/uwb).\n\nArchitecture\n------------\n\nThe UWB stack consists of the UWB mainline module and the HAL implementation\nprovided by a UWB chip vendor as shown in Figure 1.\n\n**Figure 1.** UWB stack architecture\n\n### AOSP stack\n\nThe AOSP UWB stack, packaged as an optional module, `com.google.android.uwb`,\ncontains the following components:\n\n- UWB platform API surface\n - Code location: `packages/modules/Uwb/framework`\n- Support library\n - Code location: `packages/modules/Uwb/service/support_lib`\n- UwbService layer and Common Service Management Layer (CSML) defined components defined by [FiRa](https://www.firaconsortium.org/)\n - Code location: `packages/modules/Uwb/service`\n- Rust native UCI layer\n - Code location: `external/uwb`\n- UWB HAL interface based on the UWB command interface (UCI) specification defined by [FiRa](https://www.firaconsortium.org/)\n - Code location: `hardware/interfaces/uwb`\n\n### Vendor components\n\nThe vendor stack includes a UWB HAL vendor implementation, UWB driver, and a\nUWB device.\n\nAPI surfaces for UWB\n--------------------\n\nThe UWB stack includes API surfaces for system apps and third-party apps.\n\n### System apps\n\nDevice manufacturers use the\n[`android.uwb.UwbManager`](https://cs.android.com/android/platform/superproject/+/android-latest-release:packages/modules/Uwb/framework/java/android/uwb/UwbManager.java)\nsystem API surface to allow low-level access for system apps. To use this\nAPI surface, system apps must use the support library\n(`packages/modules/Uwb/service/support_lib`).\n\n### Third-party apps\n\nThird-party apps use the Jetpack UWB public API surface,\n[`androidx.core.uwb`](https://developer.android.com/reference/kotlin/androidx/core/uwb/package-summary).\nFor more information, see\n[Ultra-wide band communication](https://developer.android.com/guide/topics/connectivity/uwb).\n\nVerification\n------------\n\nTo verify your implementation of UWB, ensure that your device passes the CTS\ntests located under `/cts/tests/uwb`."]]