Bluetooth

Etsi lähistöllä olevia Bluetooth Low Energy -laitteita, tarkastele signaalin voimakkuutta ja mainostietoja, selaa GATT-palveluita ja -ominaisuuksia sekä katsele reaaliaikaisia tietoja yhdistetyistä oheislaitteista.

Yleiskatsausnäkymä, jossa on skannaustoiminnot ja lähilaitteet järjestettynä RSSI:n mukaan.

Jokainen laiterivi näyttää laitteen nimen, RSSI:n ja yhdistettävyystilan.

Yleiskatsaus

Bluetooth-työkalu käyttää Applen CoreBluetooth-kehystä toimiakseen BLE (Bluetooth Low Energy) -keskuksena ja etsiäkseen lähistöllä olevia oheislaitteita. Se näyttää kaikki löytämänsä laitteet reaaliaikaisine signaalin voimakkuuksineen (RSSI), mainostietoineen ja yhteystiloineen. Voit yhdistää yhdistettäviin oheislaitteisiin selataksesi niiden GATT-palveluita ja -ominaisuuksia, lukea arvoja, tilata ilmoituksia ja tarkastella valmistajatietoja.

Sisällysluettelo

• Yleiskatsausnäyttö
  • Hakupalkki
  • Bluetooth-tilakortti
  • Laitelista
  • Laiterivi
  • Tyhjät tilat
• Laitteen tiedot -näyttö
  • Ylätunniste ja yhteys
  • Signaalin voimakkuusmittari
  • Tiedot-välilehti
  • Palvelut-välilehti
  • Data-välilehti
• Luvat ja vaatimukset
• Tekniset tiedot
• Huomautukset ja rajoitukset
• Vianmääritys

---

Yleiskatsausnäyttö

Yleiskatsausnäyttö on Bluetooth-työkalun päänäkymä. Se sisältää hakupalkin, tilakortin skannaustoiminnoilla sekä vieritettävän listan löydetyistä laitteista.

Hakupalkki

Näytön yläosassa oleva tekstikenttä suodattaa laitelistan nimen perusteella. Kirjoittamalla hakusanan lista supistuu välittömästi niihin laitteisiin, joiden mainostettu tai oheislaite-nimi sisältää hakutekstin (kirjainkoolla ei ole väliä). Tyhjennys-painike näkyy, kun kenttä ei ole tyhjä.

Bluetooth-tilakortti

Tilakortti näyttää:

• Bluetooth-tila -merkintä nykyisellä radiotilalla, väritettynä:
  • Päällä (vihreä) — Bluetooth on aktiivinen ja valmis skannaamaan.
  • Pois päältä (punainen) — Bluetooth-radio on pois päältä.
  • Ei oikeuksia (oranssi) — käyttäjä on evännyt Bluetooth-oikeudet sovellukselta.
  • Ei tuettu (punainen) — laitteen laitteisto ei tue Bluetoothia.
  • Tuntematon / Palautetaan (harmaa) — järjestelmä määrittää vielä Bluetoothin tilaa.
• Skannaustoimintopainike (näkyy vain, kun Bluetooth on päällä):
  • Lopeta skannaus (punainen) — pysäyttää aktiivisen skannauksen.
  • Aloita skannaus (vihreä) — aloittaa lähilaitteiden skannauksen.

Skannaus käynnistyy automaattisesti, kun työkalu avataan ja Bluetooth on päällä.

Laitelista

Löydetyt laitteet näkyvät vieritettävässä listassa, järjestettynä RSSI:n mukaan (vahvin signaali ensin). Lista päivittyy reaaliajassa, kun uusia laitteita löytyy tai olemassa olevien laitteiden mainostiedot päivittyvät.

Laiterivi

Jokainen laite esitetään korttina, joka sisältää:

• Bluetooth-kuvake ympyränmuotoisessa merkissä. Valkoinen kaari täyttää ympyrää suhteessa laitteen signaalin voimakkuuteen (0–100 %).
• Laitteen nimi — mainostettu paikallinen nimi tai oheislaite-nimi. Laitteet, jotka eivät lähetä nimeä, näkyvät muodossa [Ei nimeä].
• RSSI — vastaanotetun signaalin voimakkuus dB-yksiköissä (esim. RSSI: -43 dB).
• Tilaindikaattori vasemmassa alakulmassa, joka näyttää yhden seuraavista:
  • Yhdistetty (vihreä) — laite on tällä hetkellä yhdistetty.
  • Yhdistettävissä (sininen) — laite mainostaa hyväksyvänsä yhteyksiä.
  • Palvelut: N — laitteen mainostamien GATT-palveluiden määrä (näkyy, kun palveluita on, mutta laite ei ole vielä yhdistetty).
  • (ei merkintää) — laite ei ole yhdistettävissä eikä mainosta palveluita.
• Oikeanpuoleinen indikaattori:
  • Vihreä valintamerkki-kuvake, jos laite on yhdistetty.
  • Chevron (>) jos laite on yhdistettävissä (avaa tiedot napauttamalla).
  • Ei yhdistettävissä -teksti, jos laite ei hyväksy yhteyksiä.

Napauta mitä tahansa laiteriviä siirtyäksesi Laitteen tiedot -näyttöön.

Tyhjät tilat

Yleiskatsaus näyttää tilannekohtaiset tyhjät tilat:

• Skannataan — suurennuslasikuvake ja latausanimaatio, kun alkuperäinen skannaus on käynnissä eikä laitteita ole vielä löytynyt.
• Bluetooth pois päältä / ei tuettu — Bluetooth-kuvake viivalla, nykyinen tila ja kehotus ottaa Bluetooth käyttöön.
• Skannaus pysäytetty — Bluetooth-kuvake ja Aloita skannaus -painike, kun Bluetooth on päällä, mutta skannaus on pysäytetty manuaalisesti eikä laitteita ole listalla.

---

Laitteen tiedot -näyttö

Laiterivin napauttaminen avaa erillisen tietonäytön. Näyttö on jaettu ylätunnisteeseen, signaalin voimakkuusmittariin ja kolmeen sisältövälilehteen.

Ylätunniste ja yhteys

Ylätunniste sisältää:

• Takaisin-painike (< Laitteet) paluuseen yleiskatsaukseen.
• Laitteen nimi korostettuna.
• Yhteystilan ilmaisin — värillinen piste ja merkintä:
  • Yhdistetty (vihreä)
  • Yhdistetään (oranssi)
  • Katkaistu (punainen)
  • Katkaistaan (oranssi)
• Yhdistä / Katkaise yhteys -painike (näkyy vain yhdistettävissä laitteissa):
  • Yhdistä (sininen) — aloittaa BLE-yhteyden muodostamisen. Latausikoni näkyy yhteyden muodostuessa.
  • Yhdistetään... (sininen, pois käytöstä) — näkyy yhteyden muodostuksen aikana.
  • Katkaise yhteys (punainen) — katkaisee aktiivisen yhteyden.

Kun yhteys on muodostettu, työkalu etsii automaattisesti kaikki GATT-palvelut ja niiden ominaisuudet. Luettavat ominaisuudet luetaan heti, ja ilmoituksia tukevat ominaisuudet tilataan automaattisesti.

Signaalin voimakkuusmittari

Signaalin voimakkuusosio tarjoaa yksityiskohtaisen, reaaliaikaisen näkymän laitteen radiosignaalista:

• Ympyrämittari — kaari täyttyy 0–100 % kulmagradientilla (punaisesta oranssin ja keltaisen kautta vihreään). Nykyinen RSSI-arvo dBm-yksiköissä näkyy keskellä.

• Arvioitu etäisyys — RSSI-arvosta johdettu ihmisläheinen arvio:

  RSSI-alue	Merkintä
  -30 – -50 dBm	Hyvin lähellä
  -51 – -65 dBm	Lähellä
  -66 – -80 dBm	Keskietäisyys
  -81 – -90 dBm	Kaukana
  Alle -90 dBm	Hyvin kaukana

• Signaalipalkit — 5-palkkinen ilmaisin, joka täyttyy signaalin voimakkuuden mukaan.

• Signaalin laatu — tekstimerkintä: Erinomainen (>80 %), Hyvä (>60 %), Kohtalainen (>40 %), Heikko (>20 %), tai Erittäin heikko (<=20 %).

• RSSI — raakaarvo dBm-yksiköissä.

• TX Power — lähetysteho dBm-yksiköissä, jos laite mainostaa sitä. Tämä arvo kuvaa signaalin voimakkuutta 1 metrin etäisyydellä lähettimestä ja sitä voidaan käyttää etäisyyden arviointiin.

• Signaalihistoria — liikkuva pylväskaavio viimeisistä 20 RSSI-havainnosta, väritettynä (vihreä >= -60, keltainen >= -75, punainen < -75). Tämä auttaa havainnollistamaan signaalin vakautta ajan kuluessa.

Tiedot-välilehti

Tiedot-välilehti näyttää laitteen yleiset tiedot avain-arvo -riveinä:

Kenttä	Kuvaus
Nimi	Mainostettu tai oheislaite-nimi (tai [Ei nimeä]).
Tunniste	Oheislaitteen UUID, jonka CoreBluetooth on määrittänyt. Tämä on paikallinen tunniste, ei laitteen todellinen MAC-osoite.
RSSI	Nykyinen vastaanotetun signaalin voimakkuus dB-yksiköissä.
TX Power	Lähetysteho dBm-yksiköissä (näkyy vain, jos laite mainostaa sitä).
Yhdistettävissä	Hyväksyykö laite BLE-yhteydet (Kyllä / Ei).
Tila	Nykyinen yhteystila (Yhdistetty, Yhdistetään, Katkaistu, Katkaistaan).
Löydetty	Aikaleima, jolloin laite havaittiin ensimmäisen kerran tämän skannausistunnon aikana.
Viimeksi päivitetty	Viimeisimmän mainoksen tai RSSI-päivityksen aikaleima.

Avain-arvo -rivien alla näkyy kaksi lisäosiota, jos laite tarjoaa vastaavat tiedot:

• Mainostetut palvelut — lista GATT-palvelu-UUID:ista, jotka laite sisällyttää mainospaketteihinsa. Tunnetut standardipalvelut näytetään ihmisläheisellä nimellä UUID:n vieressä (esim. 180F (Battery Service), 180A (Device Information)). Katso Tunnistetut palvelut täydellinen lista.
• Valmistajatiedot — mainoksen raakavalmistajatiedot heksamerkkijonona. Ensimmäiset kaksi tavua koodaavat Bluetooth SIG -yritystunnisteen (little-endian).

Palvelut-välilehti

Palvelut-välilehti on käytettävissä vain, kun laite on yhdistetty. Se näyttää koko GATT-palvelu- ja ominaisuuspuun, joka löydettiin yhteyden aikana.

Jokainen palvelu näkyy laajennettavana rivinä:

• Värillinen kuvake palveluluokan mukaan:
  • Sininen — Yleiset palvelut (Generic Access 1800, Generic Attribute 1801)
  • Vihreä — Battery Service (180F)
  • Oranssi — Device Information (180A)
  • Violetti — Valmistajakohtaiset palvelut (UUID alkaa FE)
  • Harmaa — Muut / tuntemattomat palvelut
• Palvelun nimi (tunnistetaan UUID:sta tunnetuille palveluille) ja raakamuotoinen UUID.
• Merkki, joka näyttää palvelun ominaisuuksien määrän.
• Chevron, joka pyörii, kun palvelu laajennetaan.

Tunnistetut palvelut

UUID	Palvelun nimi
1800	Generic Access
1801	Generic Attribute
180A	Device Information
180F	Battery Service
1812	HID (Human Interface Device)
1813	Scan Parameters
1819	Location and Navigation
181C	User Data
FE59	Apple Notification Center

Palvelun laajentaminen paljastaa sen ominaisuudet. Jokainen ominaisuus näkyy rivinä, jossa on:

• Värillinen kuvake pääominaisuuden mukaan (violetti luku+kirjoitus, sininen vain luku, vihreä vain kirjoitus, oranssi vain ilmoitus, harmaa muuten).
• Ominaisuuden nimi (tunnistetaan UUID:sta tunnetuille GATT-ominaisuuksille) ja raakamuotoinen UUID.
• Ominaisuuspillerit — pienet värikoodatut merkinnät jokaiselle tuetulle ominaisuudelle:
  • Read (sininen) — arvo voidaan lukea pyynnöstä.
  • Write (vihreä) — arvo voidaan kirjoittaa kuittauksella.
  • Write No Response (vaaleanvihreä) — arvo voidaan kirjoittaa ilman kuittausta.
  • Notify (oranssi) — ominaisuus voi lähettää päivityksiä keskukselle.
  • Indicate (vaaleanoranssi) — kuten Notify, mutta kuittauksella.
  • Auth (violetti) — ominaisuus vaatii todennetut allekirjoitetut kirjoitukset.
• Silmän kuva -painike (näkyy, kun ominaisuudella on arvo). Napauttamalla näet ominaisuuden nykyisen arvon useassa muodossa:
  • Hex — raakabittijono.
  • Merkkijono — UTF-8-tulkinta, jos tavut muodostavat kelvollista tekstiä.
  • Numeerinen — automaattinen tulkinta tavujen pituuden mukaan:
    • 1 tavu: UInt8-arvo
    • 2 tavua: UInt16-arvo
    • 4 tavua: UInt32-arvo ja Float-arvo

Tunnistetut ominaisuudet

UUID	Ominaisuuden nimi
2A00	Device Name
2A01	Appearance
2A04	Peripheral Preferred Connection Parameters
2A05	Service Changed
2A19	Battery Level
2A23	System ID
2A24	Model Number String
2A25	Serial Number String
2A26	Firmware Revision String
2A27	Hardware Revision String
2A28	Software Revision String
2A29	Manufacturer Name String
2A2A	IEEE 11073-20601 Regulatory Certification Data List
2A50	PnP ID

Data-välilehti

Data-välilehti näyttää reaaliaikaisesti tulkittua dataa yhdistetystä laitteesta. Jos laite ei ole yhdistetty, näkyy kehotus ja Yhdistä-painike (yhdistettävissä laitteissa) tai tiedote.

Yhdistettynä välilehti näyttää enintään kolme korttia:

• Valmistajatiedot — valmistajakohtainen mainospayload:

  • Valmistaja-ID — tunnistetaan valmistajatietojen kahdesta ensimmäisestä tavusta (little-endian). Tunnettuja ID:itä ovat Apple (0x004C), Microsoft (0x0006), Samsung (0x0075), Xiaomi (0x038F) ja Bosch (0x01D7). Tuntemattomat ID:t näytetään heksana (esim. ID: 0x1234).
  • Raakatiedot — valmistajatietojen täydellinen heksadumppi.
  • Tavujen visualisointi — vaakapylväskaavio, jossa jokainen pylväs edustaa yhtä tavua. Pylvään korkeus on suhteessa tavun arvoon (0–255), mikä antaa nopean visuaalisen sormenjäljen datasta.

• Ominaisuusarvot — lista kaikista ominaisuuksista, joilla on luettava arvo. Jokainen merkintä näyttää:

  • Ominaisuuden nimen (tai UUID:n, jos tuntematon).
  • Tulkittu arvo (tavu, UInt16, UInt32/Float, UTF-8-merkkijono tai hex datan pituuden mukaan).
  • Pieni tavupylväskaavio arvoille, jotka ovat enintään 8 tavua, pylväät väritettynä arvon mukaan (sininen < 30 %, vihreä < 60 %, keltainen < 80 %, punainen >= 80 %).
  • Arvot päivittyvät automaattisesti ominaisuuksille, jotka tukevat ilmoituksia.

• Yhteystiedot — ajoitus- ja signaalimetatiedot:

  • Löydetty — aika, jolloin laite havaittiin ensimmäisen kerran, sekä kulunut aika havainnosta.
  • Viimeisin päivitys — viimeisimmän datapäivityksen aika, sekä TX Power, jos saatavilla.

---

Luvat ja vaatimukset

• Bluetooth-oikeus — CoreBluetooth vaatii käyttäjän luvan Bluetoothin käyttöön. Jos lupa on evätty, Lirum näyttää oikeusnäytön, jossa on painike iOS:n Asetuksiin, jotta käyttäjä voi ottaa oikeuden uudelleen käyttöön.
• Bluetooth-radio — jos Bluetooth on pois päältä, työkalu pysyy käytettävissä, mutta skannaustoiminnot ovat poissa käytöstä ja tyhjä tila kehottaa ottamaan Bluetoothin käyttöön. Oikeusporttia ei näytetä tässä tapauksessa.
• Bluetooth-oikeus hallitaan järjestelmän toimesta; erillistä "pyydä oikeus" -painiketta ei ole. Järjestelmäkysely ilmestyy automaattisesti, kun CoreBluetooth alustetaan ensimmäistä kertaa.

Tekniset tiedot

• Työkalu toimii BLE-keskuksena käyttäen CBCentralManager-luokkaa. Se skannaa kaikki lähistöllä olevat oheislaitteet (scanForPeripherals(withServices: nil)), eli löytää laitteet riippumatta siitä, mitä palveluita ne mainostavat.
• RSSI (Received Signal Strength Indicator) -arvot ovat tyypillisesti välillä -30 dBm (erittäin vahva, laite hyvin lähellä) – -100 dBm (erittäin heikko, laite kaukana tai esteen takana). Työkalu normalisoi tämän välin 0–100 % asteikolle kaavalla: (RSSI + 100) / 70.
• Yhdistetyille laitteille RSSI haetaan 2 sekunnin välein käyttäen readRSSI(). Kohinansuodatin estää alle 2 dB muutokset visuaalisen värinän vähentämiseksi.
• Yhteyden muodostuksen yhteydessä työkalu kutsuu discoverServices(nil) löytääkseen kaikki GATT-palvelut ja sitten discoverCharacteristics(nil, for:) jokaiselle palvelulle. Luettavat ominaisuudet luetaan automaattisesti readValue(for:)-kutsulla, ja ilmoituksia tukevat ominaisuudet tilataan setNotifyValue(true, for:)-kutsulla.
• TX Power (CBAdvertisementDataTxPowerLevelKey) kuvaa signaalin voimakkuutta 1 metrin päässä lähettimestä. Kun sekä TX Power että RSSI tunnetaan, niiden erotusta voidaan käyttää vaimennuksen ja etäisyyden arviointiin.
• Valmistajatiedot (CBAdvertisementDataManufacturerDataKey) noudattavat Bluetooth SIG -muotoa: ensimmäiset kaksi tavua ovat yritystunniste (little-endian), jonka jälkeen tulee valmistajakohtainen data.
• Oheislaitteen tunniste, joka näkyy Tiedot-välilehdellä, on CoreBluetoothin paikallisesti määrittämä UUID. Se pysyy samana sovelluksen käynnistysten välillä samalle laitteelle, mutta ei ole todellinen Bluetooth MAC-osoite (iOS ei paljasta sitä).

Huomautukset ja rajoitukset

• Näkyvät tiedot riippuvat siitä, mitä kukin oheislaite mainostaa ja mitä iOS paljastaa CoreBluetoothin kautta. Jotkin laitteet mainostavat vain vähän tietoa.
• Monet laitteet näkyvät muodossa [Ei nimeä], koska ne eivät sisällytä paikallista nimeä mainospaketteihinsa.
• Arvioidut etäisyydet ovat suuntaa-antavia ja perustuvat RSSI-raja-arvoihin. Todelliset etäisyydet vaihtelevat merkittävästi ympäristön, esteiden, antennin suunnan ja lähetystehon mukaan.
• Kaikki yhdistettävät laitteet eivät välttämättä yhdisty onnistuneesti. Osa vaatii pariliitoksen iOS:n Asetuksissa, ja osa voi hylätä yhteydet tuntemattomilta keskuksilta.
• Perinteiset Bluetooth-laitteet (ei-BLE) eivät näy CoreBluetoothin kautta eivätkä ilmesty skannaustuloksiin.
• RSSI-arvot voivat vaihdella nopeasti monitieheijastusten, kehon absorptioiden ja muiden ympäristötekijöiden vuoksi. Signaalihistoriakaavio auttaa tasoittamaan näitä vaihteluita visuaalisesti.

Vianmääritys

• Laitteita ei löydy — varmista, että Bluetooth on päällä, pysy Bluetooth-näytöllä muutaman sekunnin ajan ja napauta Aloita skannaus, jos skannaus on pysähtynyt.
• Oikeus evätty — napauta Avaa asetukset -painiketta oikeusnäytöllä ja ota Bluetooth-oikeus uudelleen käyttöön Lirumille iOS:n Tietosuoja-asetuksissa.
• Yhteys epäonnistuu — laite saattaa vaatia pariliitoksen iOS:n Asetuksissa, ei ehkä tue yhteyksiä kolmannen osapuolen sovelluksista tai on voinut siirtyä kantaman ulkopuolelle.
• Palvelut-välilehti on tyhjä — jotkin laitteet eivät paljasta palveluita tai viivästyttävät palveluiden löytymistä. Odota muutama sekunti yhdistämisen jälkeen. Jos palveluita ei ilmesty, laite ei ehkä tue standardeja GATT-profiileja.
• Ominaisuusarvot näkyvät vain hex-muodossa — työkalu yrittää tulkita arvot UTF-8-tekstiksi ja yleisiksi numeerisiksi tyypeiksi. Jos mikään näistä ei sovellu, näytetään raakaa hex-dumppia.