Hoppa till huvudinnehåll

Bluetooth

Sök efter närliggande Bluetooth Low Energy-enheter, inspektera signalstyrka och annonseringsdata, bläddra bland GATT-tjänster och egenskaper, samt visa live-data från anslutna enheter.

Översiktsskärm med skanningskontroller och närliggande enheter sorterade efter RSSI.
Varje enhetsrad visar dess namn, RSSI och om den är anslutningsbar.

Översikt​

Bluetooth-verktyget använder Apples CoreBluetooth-ramverk för att agera som en BLE (Bluetooth Low Energy) central och söka efter närliggande enheter. Det visar varje upptäckt enhet tillsammans med realtids-signalstyrka (RSSI), annonseringsdata och anslutningsstatus. Du kan ansluta till anslutningsbara enheter för att bläddra bland deras GATT-tjänster och egenskaper, läsa värden, prenumerera på notifieringar och inspektera tillverkarinformation.

Innehållsförteckning​

Översiktsskärm​

Översiktsskärmen är huvudsidan för Bluetooth-verktyget. Den innehåller ett sökfält, ett statuskort med skanningskontroller och en rullbar lista över upptäckta enheter.

Ett textfält högst upp på skärmen filtrerar enhetslistan efter namn. När du skriver in en sökterm begränsas listan direkt till enheter vars annonserade eller perifera namn innehåller söktexten (skiftlägesokänsligt). En rensa-knapp visas när fältet inte är tomt.

Bluetooth-statuskort​

Statuskortet visar:

  • Bluetooth-status-etikett med aktuell radiostatus, färgkodad:
    • Påslagen (grön) — Bluetooth är aktivt och redo att skanna.
    • Avstängd (röd) — Bluetooth-radion är avstängd.
    • Obehörig (orange) — användaren har nekat Bluetooth-behörighet för appen.
    • Ej stödd (röd) — enhetens hårdvara stöder inte Bluetooth.
    • Okänd / Återställs (grå) — systemet avgör fortfarande Bluetooth-status.
  • En skanningskontrollknapp (visas endast när Bluetooth är påslagen):
    • Stoppa skanning (röd) — stoppar aktiv skanning.
    • Starta skanning (grön) — påbörjar skanning efter närliggande enheter.

Skanning startar automatiskt när verktyget öppnas och Bluetooth är påslagen.

Enhetslista​

Upptäckta enheter visas i en rullbar lista, sorterad efter RSSI (starkast signal först). Listan uppdateras i realtid när nya enheter hittas eller befintliga enheter uppdaterar sin annonseringsdata.

Enhetsrad​

Varje enhet visas som ett kort med:

  • En Bluetooth-ikon i en cirkulär badge. En vit båge fyller cirkeln proportionellt mot enhetens signalstyrka (0–100%).
  • Enhetsnamn — det annonserade lokala namnet eller perifernamnet. Enheter utan namn visas som [No Name].
  • RSSI — mottagen signalstyrka i dB (t.ex. RSSI: -43 dB).
  • En statusindikator nere till vänster, som visar en av:
    • Ansluten (grön) — enheten är för närvarande ansluten.
    • Anslutningsbar (blå) — enheten annonserar att den accepterar anslutningar.
    • Tjänster: N — antal GATT-tjänster som enheten annonserar (visas när tjänster finns men enheten inte är ansluten).
    • (ingen etikett) — enheten är inte anslutningsbar och annonserar inga tjänster.
  • En indikator till höger:
    • En grön bock-ikon om enheten är ansluten.
    • En chevron (>) om enheten är anslutningsbar (tryck för att visa detaljer).
    • Texten Ej anslutningsbar om enheten inte accepterar anslutningar.

Tryck på en enhetsrad för att gå till Enhetsdetaljer.

Tomma lägen​

Översikten visar kontextuella tomma lägen:

  • Skannar — en förstoringsglasikon med laddningsanimation medan den initiala skanningen pågår och inga enheter hittats än.
  • Bluetooth av / Ej stödd — en överstruken Bluetooth-ikon med aktuell status och en uppmaning att aktivera Bluetooth.
  • Skanning stoppad — en Bluetooth-ikon med en Starta skanning-knapp när Bluetooth är på men skanningen har stoppats manuellt och listan är tom.

Enhetsdetaljer​

Att trycka på en enhetsrad öppnar en dedikerad detaljskärm. Skärmen är uppdelad i en rubrik, en signalstyrkemätare och tre innehållsflikar.

Rubrik och anslutning​

Rubriken innehåller:

  • En tillbaka-knapp (< Enheter) för att återgå till översikten.
  • Enhetsnamnet visas tydligt.
  • En anslutningsstatusindikator — en färgad punkt bredvid en etikett:
    • Ansluten (grön)
    • Ansluter (orange)
    • Frånkopplad (röd)
    • Kopplar från (orange)
  • En Anslut / Koppla från-knapp (visas endast för anslutningsbara enheter):
    • Anslut (blå) — initierar en BLE-anslutning. En laddningssnurra visas medan anslutningen upprättas.
    • Ansluter... (blå, inaktiverad) — visas under anslutningsförsöket.
    • Koppla från (röd) — avslutar aktiv anslutning.

När en anslutning är etablerad upptäcker verktyget automatiskt alla GATT-tjänster och deras egenskaper. Läsbara egenskaper läses direkt, och egenskaper som stöder notifieringar prenumereras på automatiskt.

Signalstyrkemätare​

Signalstyrkesektionen ger en detaljerad, realtidsvy av enhetens radiosignal:

  • Cirkulär mätare — en båge som fylls från 0% till 100% med en vinkelgradient (röd till orange till gul till grön). Aktuellt RSSI-värde i dBm visas i mitten.

  • Ungefärligt avstånd — en läsbar uppskattning baserad på RSSI-värdet:

    RSSI-intervallEtikett
    -30 till -50 dBmMycket nära
    -51 till -65 dBmNära
    -66 till -80 dBmMedel
    -81 till -90 dBmLångt bort
    Under -90 dBmMycket långt bort

  • Signalstaplar — en indikator med 5 staplar som fylls baserat på signalstyrkeprocent.

  • Signalkvalitet — en textetikett: Utmärkt (>80%), Bra (>60%), Godkänd (>40%), Svag (>20%) eller Mycket svag (<=20%).

  • RSSI — råvärdet i dBm.

  • TX Power — sändareffekt i dBm, om enheten annonserar detta. Värdet representerar signalstyrkan på 1 meters avstånd från sändaren och kan användas för att uppskatta avstånd.

  • Signalkurva — ett rullande stapeldiagram över de senaste 20 RSSI-avläsningarna, färgkodade (grön >= -60, gul >= -75, röd < -75). Detta hjälper till att visualisera signalstabilitet över tid.

Info-flik​

Info-fliken visar allmän information om enheten, organiserad som nyckel-värde-rader:

FältBeskrivning
NamnDet annonserade eller perifera namnet (eller [No Name]).
IdentifierareEnhetens UUID tilldelad av CoreBluetooth. Detta är en lokal identifierare och inte enhetens faktiska MAC-adress.
RSSIAktuell mottagen signalstyrka i dB.
TX PowerSändareffekt i dBm (visas endast om enheten annonserar detta).
AnslutningsbarOm enheten accepterar BLE-anslutningar (Ja / Nej).
StatusAktuell anslutningsstatus (Ansluten, Ansluter, Frånkopplad, Kopplar från).
UpptäcktTidsstämpel när enheten först sågs under denna skanningssession.
Senast uppdateradTidsstämpel för senaste annonsering eller RSSI-uppdatering.

Under nyckel-värde-raderna visas två ytterligare sektioner om enheten tillhandahåller motsvarande data:

  • Annonserade tjänster — en lista över GATT-tjänst-UUID:er som enheten inkluderar i sina annonseringspaket. Kända standardtjänster visas med sitt läsbara namn bredvid UUID (t.ex. 180F (Battery Service), 180A (Device Information)). Se Kända tjänster för hela listan.
  • Tillverkarinformation — rå tillverkarspecifik data från annonseringen, visad som en hex-sträng. De två första byten kodar Bluetooth SIG-företagsidentifieraren (little-endian).

Tjänster-flik​

Tjänster-fliken är tillgänglig endast när enheten är ansluten. Den visar hela GATT-tjänst- och egenskapsträdet som upptäckts under anslutningen.

Varje tjänst visas som en expanderbar rad:

  • En färgad ikon som indikerar tjänstekategori:
    • Blå — Generiska tjänster (Generic Access 1800, Generic Attribute 1801)
    • Grön — Battery Service (180F)
    • Orange — Device Information (180A)
    • Lila — Leverantörsspecifika tjänster (UUID som börjar med FE)
    • Grå — Övriga / okända tjänster
  • Tjänstnamn (härlett från UUID för kända tjänster) och rå UUID-sträng.
  • En badge som visar antal egenskaper som tillhör tjänsten.
  • En chevron som roterar när tjänsten expanderas.

Kända tjänster​

UUIDTjänstnamn
1800Generic Access
1801Generic Attribute
180ADevice Information
180FBattery Service
1812HID (Human Interface Device)
1813Scan Parameters
1819Location and Navigation
181CUser Data
FE59Apple Notification Center

När en tjänst expanderas visas dess egenskaper. Varje egenskapsrad visar:

  • En färgad ikon baserat på huvudsaklig egenskap (lila för läs+skriv, blå för endast läs, grön för endast skriv, orange för endast notifiera, grå annars).
  • Egenskapsnamn (härlett från UUID för kända GATT-egenskaper) och rå UUID-sträng.
  • Egenskapsbrickor — små färgkodade etiketter för varje stödd egenskap:
    • Read (blå) — värdet kan läsas vid behov.
    • Write (grön) — värdet kan skrivas med kvittens.
    • Write No Response (ljusgrön) — värdet kan skrivas utan kvittens.
    • Notify (orange) — egenskapen kan skicka uppdateringar till centralen.
    • Indicate (ljusorange) — som Notify men med kvittens.
    • Auth (lila) — egenskapen kräver autentiserade signerade skrivningar.
  • En ögonknapp (visas när egenskapen har ett värde). Tryck för att visa egenskapens aktuella värde, visat i flera format:
    • Hex — rå byte-sekvens.
    • Sträng — UTF-8-tolkning, om byten bildar giltig text.
    • Numeriskt — automatisk tolkning baserat på bytelängd:
      • 1 byte: UInt8-värde
      • 2 byte: UInt16-värde
      • 4 byte: UInt32-värde och Float-värde

Kända egenskaper​

UUIDEgenskapsnamn
2A00Device Name
2A01Appearance
2A04Peripheral Preferred Connection Parameters
2A05Service Changed
2A19Battery Level
2A23System ID
2A24Model Number String
2A25Serial Number String
2A26Firmware Revision String
2A27Hardware Revision String
2A28Software Revision String
2A29Manufacturer Name String
2A2AIEEE 11073-20601 Regulatory Certification Data List
2A50PnP ID

Data-flik​

Data-fliken visar live, tolkad data från den anslutna enheten. Om enheten inte är ansluten visas en uppmaning med en Anslut-knapp (för anslutningsbara enheter) eller ett informationsmeddelande.

När ansluten visas upp till tre kort:

  • Tillverkarinformation — tillverkarspecifik annonseringsdata:

    • Tillverkar-ID — härlett från de två första bytena (little-endian) i tillverkarinformationen. Kända ID inkluderar Apple (0x004C), Microsoft (0x0006), Samsung (0x0075), Xiaomi (0x038F) och Bosch (0x01D7). Okända ID visas i hex (t.ex. ID: 0x1234).
    • Rådata — fullständig hex-dump av tillverkarbytesdata.
    • Byte-visualisering — ett horisontellt stapeldiagram där varje stapel representerar en byte. Stapelhöjden är proportionell mot byte-värdet (0–255), vilket ger en snabb visuell fingeravtryck av datan.

  • Egenskapsvärden — en lista över alla egenskaper som har ett läsbart värde. Varje post visar:

    • Egenskapsnamn (eller UUID om okänt).
    • Tolkat värde (som byte, UInt16, UInt32/Float, UTF-8-sträng eller hex beroende på datalängd).
    • Ett litet byte-stapeldiagram för värden upp till 8 byte, med staplar färgkodade efter storlek (blå < 30%, grön < 60%, gul < 80%, röd >= 80%).
    • Värden uppdateras automatiskt för egenskaper som stöder notifieringar.

  • Anslutningsinfo — tids- och signalmetadata:

    • Upptäckt — tidpunkt då enheten först sågs, med förfluten tid sedan upptäckt.
    • Senaste uppdatering — tidpunkt för senaste datauppdatering, med TX Power om tillgängligt.

Behörigheter och krav​

  • Bluetooth-behörighet — CoreBluetooth kräver att användaren ger Bluetooth-åtkomst. Om behörighet nekas visar Lirum en behörighetsskärm med en knapp för att öppna iOS Inställningar så att användaren kan återaktivera åtkomst.
  • Bluetooth-radio — om Bluetooth är avstängd är verktyget fortfarande tillgängligt men skanningskontroller är inaktiverade och ett tomt läge uppmanar användaren att slå på Bluetooth. Ingen behörighetsgrind visas i detta fall.
  • Bluetooth-behörighet hanteras av systemet; det finns ingen explicit "begär behörighet"-knapp. Systemets uppmaning visas automatiskt första gången CoreBluetooth initieras.

Tekniska detaljer​

  • Verktyget agerar som en BLE Central med CBCentralManager. Det skannar efter alla närliggande enheter (scanForPeripherals(withServices: nil)), vilket innebär att det upptäcker enheter oavsett vilka tjänster de annonserar.
  • RSSI (Received Signal Strength Indicator) värden ligger vanligtvis mellan -30 dBm (mycket stark, enheten är mycket nära) och -100 dBm (mycket svag, enheten är långt borta eller skymd). Verktyget normaliserar detta intervall till en 0–100%-skala med formeln: (RSSI + 100) / 70.
  • För anslutna enheter pollas RSSI var 2:e sekund med readRSSI(). Ett brusfilter undertrycker uppdateringar mindre än 2 dB för att minska visuell flimmer.
  • Vid anslutning anropas discoverServices(nil) för att lista alla GATT-tjänster, därefter discoverCharacteristics(nil, for:) på varje tjänst. Läsbara egenskaper läses automatiskt via readValue(for:), och notifieringsbara egenskaper prenumereras på via setNotifyValue(true, for:).
  • TX Power (CBAdvertisementDataTxPowerLevelKey) representerar signalstyrkan på 1 meters avstånd från sändaren. När både TX Power och RSSI är kända kan skillnaden användas för att uppskatta dämpning och ungefärligt avstånd.
  • Tillverkarinformation (CBAdvertisementDataManufacturerDataKey) följer Bluetooth SIG-format: de två första byten är företagsidentifierare i little-endian, följt av leverantörsspecifika bytes.
  • Periferidentifieraren som visas i Info-fliken är en UUID tilldelad av CoreBluetooth på den lokala enheten. Den är stabil mellan appstarter för samma enhet men är inte den faktiska Bluetooth MAC-adressen (vilken iOS inte exponerar).

Noteringar och begränsningar​

  • Vad du kan se beror på vad varje enhet annonserar och vad iOS exponerar via CoreBluetooth. Vissa enheter annonserar minimal data.
  • Många enheter visas som [No Name] eftersom de inte inkluderar ett lokalt namn i sina annonseringspaket.
  • De ungefärliga avståndsbedömningarna är grova riktlinjer baserade på RSSI-trösklar. Faktiska avstånd varierar kraftigt beroende på miljö, hinder, antennens riktning och sändareffekt.
  • Alla anslutningsbara enheter kan inte alltid anslutas. Vissa kräver parning via iOS Inställningar, och vissa kan neka anslutningar från okända centraler.
  • Klassiska Bluetooth-enheter (icke-BLE) är inte synliga via CoreBluetooth och visas inte i skanningsresultaten.
  • RSSI-värden kan variera snabbt på grund av multipath-interferens, kroppens absorption och andra miljöfaktorer. Signalkurvan hjälper till att visuellt jämna ut dessa variationer.

Felsökning​

  • Inga enheter hittades — kontrollera att Bluetooth är påslaget, stanna kvar på Bluetooth-skärmen några sekunder och tryck på Starta skanning om skanningen har stoppats.
  • Behörighet nekad — tryck på Öppna inställningar på behörighetsskärmen och aktivera Bluetooth-åtkomst för Lirum i iOS sekretessinställningar.
  • Anslutning misslyckas — enheten kan kräva parning i iOS Inställningar först, kanske inte stödja anslutningar från tredjepartsappar, eller ha hamnat utanför räckvidd.
  • Tjänster-fliken är tom — vissa enheter exponerar inga tjänster eller fördröjer tjänsteupptäckt. Vänta några sekunder efter anslutning. Om inga tjänster visas kanske enheten inte stöder standard-GATT-profiler.
  • Egenskapsvärden visas endast som hex — verktyget försöker tolka värden som UTF-8-text och vanliga numeriska typer. Om ingen tolkning är möjlig visas rå hex-dump.
Senast uppdaterad den av Rogerio Hirooka