Periphery Consulta de UUID BLE no iPhone: encontre e nomeie os UUIDs de serviço de um dispositivo
Todo serviço e característica BLE tem um UUID. Para vê-los, conecte ao dispositivo no inspetor do Periphery: cada serviço e característica mostra seu UUID bruto, e os comuns também mostram um nome legível, como Battery Level para 2A19. Os nomes vêm de uma pequena lista guardada no app, então a consulta funciona offline; UUIDs que não estão nela ficam como hex bruto.
UUIDs BLE curtos e longos
Serviços e características definidos pelo Bluetooth SIG usam UUIDs curtos de 16 bits escritos em 4 dígitos hex, como 180F para Battery Service. Fabricantes e projetos hobby usam UUIDs completos de 128 bits, como 6E400001-B5A3-F393-E0A9-E50E24DCCA9E para o serviço Nordic UART. Um UUID curto já basta para consultar; um longo personalizado só significa algo se o fabricante o publicou.
Como encontrar o UUID dos serviços de um dispositivo Bluetooth
- Toque em Digitalizar e encontre seu dispositivo. Filtre pelo nome com Filtrar por nome ou UUID se a lista for grande.
- Toque no dispositivo para abrir o inspetor. O Periphery conecta e lista cada serviço que encontra.
- Cada cabeçalho de serviço mostra o nome quando o Periphery o conhece, senão o UUID bruto. Toque num cabeçalho para recolher ou expandir suas características.
- Sob o nome de cada característica, o UUID bruto aparece sempre em letra pequena, para você copiar no seu próprio código ou anotações.
O identificador em cada linha de verificação é diferente: é o ID que o iOS atribui ao próprio dispositivo, não um UUID de serviço.
UUIDs que o Periphery nomeia offline
A lista embutida é curta e focada no que os desenvolvedores encontram com mais frequência. Estas são as entradas que ela resolve:
| UUID | Nome mostrado |
|---|---|
| 1800 | Generic Access |
| 1801 | Generic Attribute |
| 180A | Device Information |
| 180D | Heart Rate |
| 180F | Battery Service |
| 1810 | Blood Pressure |
| 1812 | Human Interface Device |
| 1816 | Cycling Speed and Cadence |
| 1818 | Cycling Power |
| 181A | Environmental Sensing |
| FFF0 | Xiaomi Service |
| 6E400001-B5A3-F393-E0A9-E50E24DCCA9E | Nordic UART Service |
| 5C7A4CD0-07F5-4F60-BF6A-C7B2A61CBBF8 | ESP32 Custom Service |
| ADE3D529-C784-4F63-A987-EB69F70EE816 | Shelly BLU |
| UUID | Nome mostrado |
|---|---|
| 2A19 | Battery Level |
| 2A24 | Model Number |
| 2A26 | Firmware Revision |
| 2A29 | Manufacturer Name |
| 2A37 | Heart Rate Measurement |
| 2A38 | Body Sensor Location |
| 2A6E | Temperature |
| 2A6F | Humidity |
| FFF1 | Xiaomi Data |
| 6E400002-B5A3-F393-E0A9-E50E24DCCA9E | Nordic UART RX |
| 6E400003-B5A3-F393-E0A9-E50E24DCCA9E | Nordic UART TX |
São 25 UUIDs no total. Não é a lista completa do Bluetooth SIG, e qualquer outro é mostrado como seu UUID bruto para você consultar na documentação do fabricante do chip ou nos números atribuídos pelo Bluetooth SIG.
Exemplo prático: uma placa Nordic UART
Conecte a uma placa baseada em nRF rodando o serviço Nordic UART e o inspetor mostra o serviço como Nordic UART Service. Sob ele você vê Nordic UART RX (6E400002-...) com uma marcação W, aquela em que você escreve, e Nordic UART TX (6E400003-...) com uma marcação N, a que envia dados para você. O cartão no topo mostra Dispositivo UART nórdico.
Erros comuns
- Confundir o identificador do dispositivo na linha de verificação com um UUID de serviço. Não têm relação.
- Assumir que FFF0 sempre significa Xiaomi. Muitos dispositivos baratos reaproveitam FFF0 e FFF1 para seus próprios dados.
- Esperar um nome para todo UUID personalizado. UUIDs personalizados de 128 bits são privados a menos que o fabricante os publique.
- Buscar um serviço pelo UUID no filtro de verificação. Filtrar por nome ou UUID casa com o nome do dispositivo ou seu identificador do iOS, não com os serviços internos.
Perguntas frequentes
A consulta de UUID precisa de internet?
Por que alguns serviços mostram só um código hex longo?
Onde está o UUID do próprio dispositivo Bluetooth?
Mais guias do Periphery
- Como encontrar um dispositivo Bluetooth perdido com o iPhone pela força do sinal
- Usando um app scanner Bluetooth no iPhone para listar dispositivos BLE próximos
- Como identificar um dispositivo Bluetooth desconhecido no iPhone
- Como ler, escrever e assinar uma característica BLE do seu iPhone
- Como ver a força do sinal Bluetooth no iPhone
- Todas as perguntas sobre o Periphery
- Voltar para o Periphery