xG22 Bluetooth LE SDK hugbúnaður

„

Tæknilýsing:

• Vöruheiti: Simplicity SDK Suite
• Útgáfa: 2024.12.2
• Útgáfudagur: 1. apríl 2025
• Samhæfðir þýðendur:
  • IAR Embedded Workbekk fyrir ARM (IAR-EWARM) útgáfu 9.40.1
  • GCC (The GNU Compiler Collection) útgáfa 12.2.1, fylgir
    Simplicity stúdíó
• Bluetooth útgáfa: 9.1.0.0

Notkunarleiðbeiningar fyrir vöru:

Samhæfi og notkunartilkynningar:

Fyrir upplýsingar um öryggisuppfærslur og tilkynningar, sjá
Öryggiskafli útgáfuskýringa pallsins settur upp með þessu
SDK eða farðu á TECH DOCS flipann á Kísill
Rannsóknarstofur websíða. Mælt er með því að gerast áskrifandi að Security
Ráðleggingar fyrir uppfærðar upplýsingar.

Að nota þessa útgáfu:

Ef þú ert nýr í Silicon Labs Bluetooth SDK skaltu skoða
leiðbeiningar og athugasemdir í notendahandbókinni fyrir notkun þessa
Útgáfuhluti.

Helstu eiginleikar:

• Samhæfðir þýðendur:
  • IAR Embedded Workbekk fyrir ARM (IAR-EWARM) útgáfu 9.40.1
  • GCC (The GNU Compiler Collection) útgáfa 12.2.1

Nýir eiginleikar:

Nýir hlutir í útgáfu 9.1.0.0:

• GATT viðskiptavinur fyrir ATT MTU skipti eingöngu:
  • Bætt við íhlut
    bluetooth_feature_gatt_client_att_mtu_request_only til sjálfkrafa
    hefja ATT MTU skiptiferli þegar GATT tengingin er
    opið.
  • Notaðu sl_bt_gatt_server_set_max_mtu API til að stilla hámarksstærð
    af ATT MTU í BLE Host Stack.
• Íhlutir fyrir tiltekin tengihlutverk:
  • Nýir íhlutir bluetooth_feature_connection_role_central og
    bluetooth_feature_connection_role_peripheral veita stuðning fyrir
    sérstök tengihlutverk.
  • Láttu einn eða báða af hlutverkasértæku íhlutunum fylgja með
    þarfir umsóknarinnar þegar þær eru meðtaldar
    bluetooth_feature_connection.
• Betri hagræðing kóða í Bluetooth Security Manager:
  • Bluetooth öryggisstjórinn stjórnar nú sjálfkrafa
    miðlægar eða jaðarkerfisvélar byggðar á innifalinn
    íhlutir.

Nýir hlutir í útgáfu 9.0.0.0:

• TX Power hærra en 10 dBm í Low Power Mode:
  • Styður notkun TX afl sem er hærra en 10 dBm í lágstyrksstillingu í
    NCP og SoC stillingar.
  • Stilltu aflmörk í lágorkuham með því að nota
    sl_bt_system_linklayer_configure() með lykli
    sl_bt_system_linklayer_config_key_low_power_mode_power_limit.
• Nýr skannivalkostur:
  • Bætt við SL_BT_SCANNER_IGNORE_BONDING valmöguleika til notkunar með
    sl_bt_scanner_set_parameters_and_filter skipun til að forðast
    óþarfa leit í tengingum ef tengingarupplýsingar eru það ekki
    þarf í auglýsingaskýrslum.
• Nýr sérsniðinn heimilisfangsvalkostur:
  • Bætti við SL_BT_CONFIG_SET_CUSTOM_ADDRESS_FROM_NVM3 valkosti fyrir
    stilla hvort staflan ætti að nota sérsniðið heimilisfang sem er geymt í
    NVM3 sem auðkennisfang tækisins.
  • Þessi valkostur er sjálfgefið virkur.

Algengar spurningar:

Sp.: Hvar get ég fundið upplýsingar um öryggisuppfærslur?

Svar: Sjá öryggiskafla útgáfuskýringa pallsins
sett upp með þessu SDK eða farðu á TECH DOCS flipann á Silicon Labs
websíða fyrir öryggisuppfærslur.

Sp.: Hvernig stilli ég afltakmörkin í lágstyrksstillingu?

A: Stilltu aflmörk í lágstyrksstillingu með því að nota
sl_bt_system_linklayer_configure() með lykli
sl_bt_system_linklayer_config_key_low_power_mode_power_limit.

Sp.: Hvaða þýðendur eru samhæfðir við þessa vöru?

A: Samhæfðir þýðendur innihalda IAR Embedded Workbench fyrir ARM
útgáfa 9.40.1 og GCC útgáfa 12.2.1 með Simplicity
Stúdíó.

“`

Bluetooth® LE SDK 9.1.0.0 GA
Simplicity SDK Suite 2024.12.2 1. apríl 2025

Silicon Labs er leiðandi söluaðili í Bluetooth vélbúnaðar- og hugbúnaðartækni, notuð í vörum eins og íþróttum og líkamsrækt, rafeindatækni, leiðarljósum og snjallheimaforritum. Kjarna SDK er háþróaður Bluetooth 5.4 samhæfður stafli sem veitir alla kjarnavirkni ásamt mörgum API til að einfalda þróun. Kjarnavirknin býður upp á bæði sjálfstæða stillingu, sem gerir þróunaraðila kleift að búa til og keyra forritið sitt beint á SoC, eða í NCP ham sem gerir kleift að nota ytri hýsil MCU. Þessar útgáfuskýringar ná yfir SDK útgáfu(r):
9.1.0.0 GA út 1. apríl 2025 9.0.1.0 GA út 5. febrúar 2025 9.0.0.0 GA út 16. desember 2024
Samhæfi og notkunartilkynningar
Fyrir upplýsingar um öryggisuppfærslur og tilkynningar, sjá öryggiskafla útgáfuskýringa pallsins sem er uppsett með þessu SDK eða á TECH DOCS flipanum á https://www.silabs.com/developers/bluetooth-low-energy. Silicon Labs mælir einnig eindregið með því að þú gerist áskrifandi að öryggisráðgjöfum til að fá uppfærðar upplýsingar. Fyrir leiðbeiningar sem og athugasemdir um notkun Secure Vault eiginleika, eða ef þú ert nýr í Silicon Labs Bluetooth SDK, sjá Notkun þessa útgáfu.

LYKILEIGNIR
Bluetooth · GA útgáfa af reglubundnum auglýsingum
BGAPI atburður · BT LE Connection Subrating · Samþykkja lista byggð á sjálfvirkri tengingu · BT Atlanta (v6.0) LL og Host Qualifi-
cation · Rás Hljómar strjál rás kort
stuðningur · Ráshljóðandi loftnetsskipti
stuðningur · CBAP – CPMS samþætting Multiprotocol · ZigbeeD og OTBR stuðningur á Open-
WRT GA · DMP BLE + CMP ZB & Matter/OT með
Samhliða hlustun á MG26 fyrir SoC GA · 802.15.4 Sameinað útvarpsáætlunarforgangshluti · Debian pökkunarstuðningur fyrir MP hýsingarforrit – Alpha

Samhæfðir þýðendur:

IAR Embedded Workbekk fyrir ARM (IAR-EWARM) útgáfu 9.40.1.
· Notkun vín til að byggja með IarBuild.exe skipanalínuforritinu eða IAR Embedded Workbench GUI á macOS eða Linux gæti leitt til rangra files verið notað vegna árekstra í kjötkássa reiknirit víns til að mynda stutt file nöfnum.
· Viðskiptavinum á macOS eða Linux er ráðlagt að byggja ekki með IAR utan Simplicity Studio. Viðskiptavinir sem gera ættu að sannreyna vandlega að rétt files eru notuð.

GCC (The GNU Compiler Collection) útgáfa 12.2.1, fylgir Simplicity Studio.

silabs.com | Að byggja upp tengdari heim.

Höfundarréttur © 2025 Silicon Laboratories

Bluetooth 9.1.0.0

Innihald
Innihald
1 nýir hlutir ………………………………………………………………………………………………………………………………………………… ……………………………………… 3 1.1 Nýir eiginleikar ………………………………………………………………………………………… ………………………………………………………………………………….. 3 1.2 Ný API………………………………………………… ………………………………………………………………………………………………………………………… 4
2 Umbætur………………………………………………………………………………………………………………………………………………………………………………………. 5 2.1 Breyttir hlutir ……………………………………………………………………………………………………………………………………………………………………… 5 2.2 Breytt API ………………………………………………………………………………………………………………………………………………………………………. 5
3 Föst mál ………………………………………………………………………………………………………………………………………………………………………………………… 6 4 Þekkt mál í núverandi útgáfu ……………………………………………………………………………………………………………………………………………… 8 5 Úreltir hlutir …………………………………………………………………………………………………………………………………………………………………. 9 6 Fjarlægðir hlutir ………………………………………………………………………………………………………………………………………………………………….. 10 7 Multiprotocol Gateway og RCP ………………………………………………………………………………………………………………………………………………… 11
7.1 Nýir hlutir………………………………………………………………………………………………………………………………………………………………………………… 11 7.2 Endurbætur……………………………………………………………………………………………………………………………………………………………………………… 11 7.3 Föst mál ………………………………………………………………………………………………………………………………………………………. ………………………………………………………………………………………………………………………….. 12 7.4 Úreltir hlutir ………………………………………………………………………………………………………………………………………………………………… 13 7.5 Fjarlægðir hlutir ………………………………………………………………………………………………………………………………………………………………………………………… 13 7.6 Notkun þessarar útgáfu ………………………………… 13 8 Notkun þessarar útgáfu …………………………………………. 14 Uppsetning og notkun ……………………………………………………………………………………………………………………………………………………………… 8.1 14 Öryggisupplýsingar……………………………………………………………………………………………………………………………………………………………… 8.2 14 Stuðningur ………………………………………………………………………………………………………………………………………………………………. 8.3 15 SDK útgáfu- og viðhaldsstefna …………………………………………………………………………………………………………………………………………. 8.4

silabs.com | Að byggja upp tengdari heim.

Bluetooth 9.1.0.0 | 2

1 Nýir hlutir

Nýir hlutir

1.1 Nýir eiginleikar
Bætt við útgáfu 9.1.0.0
GATT viðskiptavinur fyrir ATT MTU skipti eingöngu
Bætt við íhlut bluetooth_feature_gatt_client_att_mtu_request_only. Þessi hluti veitir lágmarks GATT viðskiptavin til að hefja sjálfkrafa ATT MTU skiptiferli þegar GATT tengingin er opin. Þessi hluti veitir ekki GATT Client API. Notaðu GATT Server API sl_bt_gatt_server_set_max_mtu til að stilla hámarksstærð ATT MTU í BLE Host Stack.
Íhlutir fyrir tiltekin tengihlutverk
Bætt við nýjum íhlutum bluetooth_feature_connection_role_central og bluetooth_feature_connection_role_peripheral. Þessir íhlutir veita stuðning fyrir tiltekið tengihlutverk. Þegar forrit inniheldur bluetooth_feature_connection, ætti forritið einnig að innihalda annan eða báða hlutverkasértæku íhlutina miðað við þarfir forritsins. Ef forritið inniheldur aðeins bluetooth_feature_connection, verða bæði tengihlutverkin studd fyrir afturábak samhæfni.
Betri hagræðing kóða í Bluetooth Security Manager
Bluetooth öryggisstjórinn sleppir nú sjálfkrafa miðlægu eða jaðarkerfi vélinni ef annaðhvort bluetooth_feature_connection_role_central eða bluetooth_feature_connection_role_peripheral hluti, í sömu röð, er ekki innifalinn í forritinu.
Bætt við útgáfu 9.0.0.0
TX afl hærra en 10 dBm í lágstyrksstillingu
Notkun TX afl sem er hærri en 10 dBm í lágstyrksstillingu er studd í NCP og SoC stillingum. Hægt er að stilla afltakmörkin í lágorkuham með því að nota sl_bt_system_linklayer_configure() með lyklinum sl_bt_system_linklayer_config_key_low_power_mode_power_limit.
Nýr skannivalkostur
Bætti við nýjum skannivalkosti, SL_BT_SCANNER_IGNORE_BONDING, til notkunar með sl_bt_scanner_set_parameters_and_filter skipuninni. Ef forritið þarfnast ekki tengingarupplýsinganna í auglýsingaskýrslum getur hún stillt þennan skannavalkost til að forðast óþarfa leit í tengingunum.
Nýr valkostur fyrir sérsniðið heimilisfang
Bætti við nýjum valkosti, SL_BT_CONFIG_SET_CUSTOM_ADDRESS_FROM_NVM3, til að stilla hvort staflinn ætti að nota sérsniðið heimilisfang sem er geymt í skilgreindum lykli á Bluetooth svæði NVM3 sem auðkennisvistfang tækisins. Sjálfgefið er að þessi valkostur sé virkur.
Atburðakerfi IPC stuðningur fyrir Bluetooth viðburði
Nýi valfrjálsi íhluturinn, bluetooth_event_system_ipc, veitir stuðning við að fá Bluetooth viðburði í gegnum Event System vélbúnaðinn í forriti sem notar RTOS.
Tengingarhlutfall
Nýi valfrjálsi íhluturinn, bluetooth_feature_connection_subrate, býður upp á Bluetooth Connection Subrating eiginleika. Eiginleikinn er veittur í tilraunagæði í þessari útgáfu.
LTO stuðningur í hýsilstafla bókasöfnum
Valin hýsilstafla GCC bókasöfn eru byggð með LTO valkostum (-flto, -ffat-lto-objects). Þetta gerir betri kóðastærð fínstillingu ef forritið notar LTO.
HCI atburðasía
Leyfir að skilgreina sérsniðnar atburðasíur fyrir HCI atburðavinnslu. Síuhringingin er kölluð áður en atburðurinn er sendur í hýsingarstafla. Þetta er hægt að nota til að takmarka óþarfa umferð um HCI tengingu.
Aukinn RTOS stuðningur
Bætt við RTOS afbrigði af mörgum núverandi tdample umsóknir.

silabs.com | Að byggja upp tengdari heim.

Bluetooth 9.1.0.0 | 3

Nýir hlutir
ESL: Auto-Connect byggt á samþykkislista Bætti nýrri tengingaraðferð við Electronic Shelf Label (ESL) Access Point (AP) til að flýta fyrir stórri netuppsetningu. ESL: Endursamstilling með skönnun Tags getur nú reynt að skanna endursamstillingu á samstillingartapi áður en byrjað er að auglýsa (framleiðandasértækur, valinn aukahlutur á ESL Tag Kjarnahluti) Þessi eiginleiki krefst þess að AP auglýsi PAwR breytur. ESL: forstillt netkerfisstilling ESL AP getur flutt inn og flutt netlotur til og frá JSON sniði sem lýsir ESL hópum og auðkenni. Eftir að hafa flutt inn fullkomna netstillingu til að nota sjálfvirka stillingu fyrir sjálfvirka netfang, er einnig hægt að stilla einkastillingu til að fleygja öllum nálægum auglýsingum ESL sem eru ekki í stillingunum. ESL AP getur haldið áfram fyrri netlotu eftir rafmagnslotu með því að endurstilla sömu tæki með sama ESL auðkenni í sama hópi og áður. ESL: útvíkkað lyklasafn Virkni ESL AP Key Library Python flokksins hefur verið víkkuð út til að nýta ESL heimilisfang, svarlykilefni og tengda AP reiti lykilgagnagrunnsins. CS Initiator: stillanlegt rásakort Rásakort CS Initiator tdample er nú stillanlegt. BRD2608A þróunarsett: BRD2608A þróunarsett fyrrvampLe forritið styður nú IMU skynjarann.
1.2 Ný API
Bætt við í útgáfu 9.0.0.0 sl_bt_gap_get_identity_address() skipun: Fáðu Bluetooth auðkennisvistfangið sem tækið notar. sl_bt_gatt_read_variable_length_characteristic_values() skipun: Lestu mörg einkennisgildi með breytilegum lengd frá ytri GATT netþjóni. sl_bt_gatt_server_read_attribute_properties() skipun: Lestu eiginleika eigindar úr staðbundnum GATT gagnagrunni. sl_bt_gattdb_get_attribute_state() skipun: Fáðu eigindastöðu úr staðbundnum GATT gagnagrunni þegar þú notar kraftmikla GATT gagnagrunnseiginleikann. sl_bt_gatt_server_find_primary_service() skipun: Finndu aðalþjónustur með UUID úr staðbundnum GATT gagnagrunni. sl_bt_connection_set_default_acceptable_subrate() skipun: Stilltu sjálfgefnar viðunandi færibreytur fyrir undirflokkunarbeiðnir. sl_bt_connection_request_subrate() skipun: Biddu um breytingu á undirmatsstuðlinum og öðrum breytum. sl_bt_evt_connection_subrate_changed atburður: Tilkynna um lokun á undirflokkunarferli eða breytingar á undirflokkunarfæribreytum á tengingu. sl_bt_evt_connection_request_subrate_failed atburður: Tilkynna að undirmatsaðferð hafi mistekist. sl_bt_evt_periodic_advertiser_status atburður: Tilkynntu nýjustu stöðu reglubundinna auglýsinga á auglýsingasetti. sl_bt_system_linklayer_config_key_set_periodic_advertising_status_report (0x8): Nýr lykill að sl_bt_system_linklayer_configure() til að virkja eða slökkva á stöðuskýrslu reglubundinna auglýsinga.

silabs.com | Að byggja upp tengdari heim.

Bluetooth 9.1.0.0 | 4

2 Endurbætur

Umbætur

2.1 Breyttir hlutir
Breytt í útgáfu 9.0.0.0

Kennitala 1233899
1234000
1298645 1318468 1321901 1329672 1332939
1334523
1324517

Lýsing
Valin Bluetooth hýsilssöfn eru sett saman með LTO valkostum (-flto -ffat-lto-objects) til að leyfa betri útrýmingu dauðans kóða í forritum.
Vottorðareitir hafa verið uppfærðir fyrir vottorðsbundna auðkenningu og pörun. Gagnagrunni bætt við fyrir útgefin skilríki.
Breytti skiluðum villukóðum til að nota raunveruleg gildi frá NVM3 þegar aðgangur var að honum með BGAPI.
Vottorðsbundin auðkenning og pörun er nú studd á xG22 tækjum.
Nú er hægt að velja hlutrakningarham „kyrrstæð hlutaröktun“ í bt_cs_host.
Gefið út CBAP bókasafnsuppsprettu. CBAP endurstilling virkjuð. Meðhöndlun tenginga batnað.
Staðfestingaratburður er sendur jafnvel þegar tengingin hefur þegar verið dulkóðuð og pörunarbeiðni er móttekin frá miðlæga tækinu.
BLE gestgjafi getur nú starfað án þess að NVM3 sé til staðar. Til að sleppa NVM3 úr Bluetooth forriti má forritið ekki nota bluetooth_feature_builtin_bonding_database, bluetooth_feature_nvm eða bluetooth_feature_sm íhluti.
Bætt við stillingarfána tengilags til að tilkynna fjölda sendra pakka í beinum prófunarhamum.

2.2 Breytt API
Breytt í útgáfu 9.0.0.0 Ekkert.
2.3 Ætluð hegðun
Breytt í útgáfu 9.0.0.0 Ekkert.

silabs.com | Að byggja upp tengdari heim.

Bluetooth 9.1.0.0 | 5

3 Föst mál
Lagað í útgáfu 9.1.0.00

Föst mál

Kennitala 1404920
1405476 1417581

Lýsing
Lagaði vandamál þar sem fjölvi til að endurstilla flugstöðvarlitina var skilgreindur en ekki notaður. _app_log_reset_color var skilgreindur en ekki notaður í app_log.h Þessi lagfæring bætir því við lok fjölva sem nota _app_log_print_color.
Lagaði vandamál sem kom í veg fyrir að NCP ræsti sig á réttan hátt þegar dulkóðun BGAPI skilaboða er virkjuð.
Lagað tímavandamál þegar eitt auglýsingahandfang er notað af bæði eldri og lengri auglýsingum. Þetta olli keppnisástandi sem stöðvaði auglýsandann ótímabært.

Lagað í útgáfu 9.0.1.0

Kennitala 1381647
1355908 1383315 1388519
1393811

Lýsing
Í notkunartilvikum fyrir ráshljóð (CS) með fjöltengi, þar sem endurskinsmælirinn keyrir CS-aðferðir með fleiri en einum ræsibúnaði, valdi endurskinsmaðurinn stundum færibreytur sem myndu leiða til þess að verklagsreglur skarast. Þetta er búið að laga.
Reglubundnar auglýsingar virkuðu ekki sem skyldi í kraftmiklum fjölsamskiptareglum með OpenThread. Þetta er búið að laga.
Ónotaður bluetooth_feature_extended_scanner hluti var fjarlægður úr ESL AP NCP.
Lagaði aðhvarf í innbyggðri rafhlöðumælingu ESL Tag sem var að koma í veg fyrir að rétt gildi væri mælt.
Lagaði aðhvarf í QR kóða rafallinu fyrir ESL kynninguna sem var kynnt með Pillow v11.x Python mát uppfærslu.

Lagað í útgáfu 9.0.0.0

ID # 845506 1082103, 1141041, 1212061 1284611
1328923
1335919 1349058 1356037
1371005
1362681 1336266

Lýsing
Aðlögunarhæfni AFH er hægt að slökkva á eða virkja með skipuninni sl_bt_system_linklayer_configure() og sl_bt_system_linklayer_config_key_set_channelmap_flags.
Notkun TX afl sem er hærri en 10 dBm í lágstyrksstillingu er studd í NCP og SoC stillingum. Hægt er að stilla afltakmörkin í lágstyrksstillingu með sl_bt_system_linklayer_configure() lyklinum sl_bt_system_linklayer_config_key_low_power_mode_power_limit.
Skýrt í API skjölunum að ræsing á DTM sendi- eða móttakaraprófi á meðan önnur Bluetooth starfsemi er virk mun annað hvort leiða til villusvars eða valda virknivandamálum. API skjölin benda nú til þess að forritið ætti að ganga úr skugga um að önnur Bluetooth starfsemi sé stöðvuð þegar próf er framkvæmt.
Lagaði vandamál í kraftmiklum GATT gagnagrunnseiginleika sem, eftir að nýrri lýsingu hefur verið bætt við GATT eiginleika sem hefur verið gert kleift að vera sýnilegur ytri GATT viðskiptavinum, getur ytri GATT viðskiptavinurinn ekki séð nýja lýsinguna.
Gerðu bluetooth_feature_advertiser hluti stillanlegan á Simplicity Studio íhluta vafra GUI.
Lagaði vandamál sem gerði öryggiseiginleikum kleift að lækka við endurpörun. Nú verða öryggiseiginleikar að passa við eða vera fleiri en þeir sem notaðir voru við fyrri pörun.
sl_bt_nvm_save(), sl_bt_nvm_load() og sl_bt_nvm_erase() sannreyna nú rétt að tiltekinn NVM3 lykill sé á því sviði sem úthlutað er fyrir notendagögn. Lykilsvið notendagagna sem geymd eru á Bluetooth-svæði NVM3 er stækkað í 0x4000 – 0x5fff.
Lagaði vandamál í Bluetooth LE hlekkjalaginu, þar sem auglýsingatæki sem er að senda út tengdar útbreiddar auglýsingar svarar AUX_CONN_REQ með ógildu AUX_CONN_RSP. Þetta vandamál átti sér stað þegar notandinn stillti handahófskennt heimilisfang eingöngu á aukna auglýsingasettið.
Lagað PAwR subevent_start. Það var ekki að hækka rétt.
Lagaði vandamál með sl_bt_advertiser_set_timing() sem virkar ekki rétt með hærri en 16000 (10sek). Interval_max.

silabs.com | Að byggja upp tengdari heim.

Bluetooth 9.1.0.0 | 6

Kennitala 1330263

Föst mál
Lýsing Lagaði vandamál í Bluetooth LE tengilaginu sem olli því að PAwR auglýsandinn hætti að samþykkja undirviðburðagagnastillingu frá hýsilnum.

silabs.com | Að byggja upp tengdari heim.

Bluetooth 9.1.0.0 | 7

Þekkt vandamál í núverandi útgáfu

4 Þekkt vandamál í núverandi útgáfu

Feitletruð tölublöð voru bætt við frá fyrri útgáfu. Ef þú hefur misst af útgáfu eru nýlegar útgáfuskýringar fáanlegar á https://www.silabs.com/developers/bluetooth-low-energy í Tech Docs flipanum.

ID # 361592 368403 641122 682198
756253
1031031 1334418 1335263
1373310 1383864 1397074
1399177

Lýsing
Sync_data atburðurinn tilkynnir ekki TX afl.
Ef CTE bil er stillt á 1, ætti að senda CTE beiðni á hverju tengingarbili. En það er aðeins sent á öðru hverju tengibili.
Bluetooth staflahlutinn veitir ekki uppsetningu fyrir RF loftnetsslóð.
Bluetooth-stafla er með samvirknivandamál á 2M PHY með Windows tölvu.
RSSI gildið á Bluetooth-tengingu sem Bluetooth API skilar er rangt á EFR32M|B21 tækjum. Það er um 8 ~ 10 dBm hærra en raunverulegt gildi, samkvæmt mælingu.
Breyting á uppsetningu í bt_aoa_host_locator forritinu leiðir til þess að forritið hrynur.
Rásar sem hljómar lítilsháttar skjálfti þegar verið er að senda RTT samstillingarpakka á upphafsaðila megin. Þetta gæti verið sýnilegt þegar þú gerir rásarhljóð í sumum öðrum tækjum söluaðila.
RTOS forgangsröðun er ekki rétt stillt í SoC/NCP tilviki ef ekki er notað kraftmikil fjölsamskiptareglur. Þetta gæti valdið því að forgangsröðun í útvarpi verði læst af minna mikilvægum forgangsröðun.
Skannatilvik gæti innihaldið fleiri sorpbæt í hávaðasömu umhverfi, þar sem fullt af BLE tækjum auglýsa á sama tíma.
Í notkunartilvikinu Channel Sounding, ef óstuddur Free-Running háttur er valinn í stillingarhausnum file, sumar tengingar verða lokaðar af forritinu og komið á aftur.
Ef um er að ræða rásarhljóðandi fjöltengingaratburðarás, þar sem endurskinsmerki er tengt við fleiri en einn ræsibúnað, gætu sumar tengingar lokað vegna tímaloka í rekstri.

Lausn Engin
Engin
Þetta er vandamál sérstaklega fyrir BGM210P. Ein lausn er að uppfæra uppsetninguna handvirkt í sl_bluetooth_config.h í textabreytingarham. Engin lausn er til. Fyrir þróun og prófun forrita er hægt að forðast sambandsrof með því að slökkva á 2M PHY með sl_bt_connection_set_preferred_phy() eða sl_bt_connection_set_default_preferred_phy(). Settu upp „RAIL Utility, RSSI“ íhlutinn í umsóknarverkefninu. Þessi hluti veitir sjálfgefna RSSI offset fyrir flísinn sem er notaður á RAIL stigi og getur hjálpað til við að ná nákvæmari RSSI mælingum.
Engin
Engin
Útvarpsforgangsröðun þarf að stilla útvarpsforgangsröðun í forritahugbúnaðinum.
Engin
Stilltu hámarksfjölda aðgerða á 0.
Engin

silabs.com | Að byggja upp tengdari heim.

Bluetooth 9.1.0.0 | 8

Úreltir hlutir
5 úreltir hlutir
Úrelt í útgáfu 9.0.0.0 Að hnekkja HFXO CTUNE með gildi á NVM3 Bluetooth svæðinu er úrelt. Sjálfgefið er að hnekkja CTUNE með því að nota NVM3 Bluetooth svæði er óvirk. Virkjaðu það með SL_BT_CONFIG_SET_CTUNE_FROM_NVM3 stillingunni. Frá Simplicity SDK 2024.12.1 útgáfunni, er valkosturinn við CTUNE hnekkt að nota vettvangshlutann clock_manager_oscillator_calibration_override. Þessi pallur hluti styður bæði HFXO og LFXO CTUNE hnekkt.

silabs.com | Að byggja upp tengdari heim.

Bluetooth 9.1.0.0 | 9

6 Fjarlægðir hlutir
Fjarlægt úr útgáfu 9.0.1.0

Kennitala 1382948

Lýsing Bluetooth RTOS examples eru ekki lengur studd á xG22 tækjum.

Fjarlægt úr útgáfu 9.0.0.0 sl_bt_connection_get_rssi sl_bt_rtos_has_event_waiting sl_bt_rtos_event_wait sl_bt_rtos_get_event sl_bt_rtos_set_event_handled Færibreyta `tx_connection_parameter sl_connection_ev ts_connection_ev

Fjarlægðir hlutir

silabs.com | Að byggja upp tengdari heim.

Bluetooth 9.1.0.0 | 10

7 Multiprotocol Gateway og RCP

Multiprotocol Gateway og RCP

7.1 Nýir hlutir
Bætt við útgáfu 9.1.0.0
Startskipunin zigbee_throughput plugin inniheldur nú valfrjálsa uint8_t rök “plugin throughput start 0” sem mun ekki hreinsa staflateljarana áður en afkastapróf hefst. Þetta er ætlað til prófunar. Ef engin viðbótarefni er innifalin og/eða ekki 0, helst núverandi hegðun sú sama og mun hreinsa teljara tækisins þegar afkastapróf hefst.
Bætt við útgáfu 9.0.0.0
Virkjað GA SoC stuðning fyrir BLE DMP með Zigbee + Openthread CMP með samhliða hlustun á xG26 hlutum.
Debian alfa stuðningi hefur verið bætt við fyrir zigbeed, OTBR og Z3Gateway forrit. Zigbeed og OTBR eru einnig í DEB pakkasniði fyrir valinn viðmiðunarvettvang (Raspberry PI 4). Sjáðu að keyra Zigbee, OpenThread og Bluetooth samtímis á Linux Host með Multiprotocol Co-processor fyrir frekari upplýsingar.
Bætti við Zigbeed stuðningi fyrir Tizen-0.1-13.1 fyrir arm32 og aarch64 sem og Android 12 fyrir aarch64. Frekari upplýsingar um Zigbeed er að finna á docs.silabs.com.
Bætti við nýjum „802.15.4 Sameinað útvarpsáætlunarforgangi“ íhlutinn. Þessi hluti er notaður til að stilla útvarpsforgangsröðun 15.4 stafla. Íhluturinn þarf einnig nýja „radio_priority_configurator“ íhlutinn. Þessi hluti gerir verkefnum kleift að nota Radio Priority Configurator tólið í Simplicity Studio til að stilla útvarpsforgangsstig þeirra stafla sem krefjast þess.

7.2 Endurbætur
Breytt í útgáfu 9.1.0.0
Zigbee-NCP + OpenThread-RCP (UART & SPI) samples, sem og Zigbee-NCP + BLE-NCP (UART & SPI)amples, eru nú aðeins leyfðar til framleiðslu á hlutum með nægilegt vinnsluminni (>=96kB).
Breytt í útgáfu 9.0.1.0
Zigbee BLE – DynamicMultiprotocolLightSed sampLe verkefnið er nú hægt að smíða fyrir borð með aðeins einni LED ef LED1 íhluturinn er útilokaður frá verkefninu.
Þessi endurskoðun hefur eftirfarandi endurbætur fyrir forrit með mörgum samskiptareglum þegar tdample, keyra Zigbee eða OpenThread fyrir sérsniðið notkunartilvik að keyra eina samskiptareglu í einu: · sl_zigbee_af_zll_unset_factory_new() API hefur verið bætt við til að leyfa forritum að aftengja Zigbee hnút frá sjálfgefna verksmiðjunni
nýtt ástand þegar þörf krefur. · Svarhringingu, sl_rail_mux_invalid_rx_channel_detected_cb(), hefur verið bætt við Zigbee+OT forrit. Þetta svarhringingu tilkynnir
forrit þegar reynt hefur verið að senda RX á tveimur mismunandi rásum á meðan samhljóða hlustun er ekki virkjuð. Forritið getur síðan innleitt sína eigin rökfræði til að takast á við þessar aðstæður.
Breytt í útgáfu 9.0.0.0
Athugasemd um forrit Að keyra Zigbee, OpenThread og Bluetooth samtímis á Linux Host með Multiprotocol Co-Processor (AN1333) hefur verið flutt á docs.silabs.com.
OpenWRT stuðningur er nú GA gæði. OpenWRT stuðningi hefur verið bætt við fyrir zigbeed, OTBR og Z3Gateway forrit. Zigbeed og OTBR eru einnig í IPK pakkasniði fyrir viðmiðunarvettvanginn (Raspberry PI 4). Sjáðu að keyra Zigbee, OpenThread og Bluetooth samtímis á Linux Host með Multiprotocol Co-processor fyrir frekari upplýsingar.

silabs.com | Að byggja upp tengdari heim.

Bluetooth 9.1.0.0 | 11

7.3 Föst mál
Lagað í útgáfu 9.1.0.0

Multiprotocol Gateway og RCP

Kennitala 1392015
1393057 1399687 1420018

Lýsing
SL_OPENTHREAD_ENABLE_SERIAL_TASK er nú sjálfgefið stillt á 0 til að minnka minni verkefna sem er ekki krafist fyrir RCP forrit. (Önnur tilvísun: 1424440)
Lagaði vandamál þar sem Zigbee-NCP + OpenThread-RCP (UART & SPI) eruamples, sem og Zigbee-NCP + BLE-NCP (UART & SPI)amples, var leyft að búa til á hlutum með ófullnægjandi vinnsluminni.
Lagaði vandamál þar sem Zigbee-BLE DMP Light appið gæti ekki farið í EM2 svefn.
Lagaði vandamál þar sem CPC skilaboð frá RTOS-virku RCP til hýsingar gætu beðið í sendingarröð þar til eitthvað vakti raðverkefnið.

Lagað í útgáfu 9.0.1.0

auðkenni #
1363050
1378298 1381165

Lýsing
Zigbee stafla frumstilling virkjar ekki lengur útvarpið (eða RCP fyrir hýsilstafla) áður en forritið kallar á stafla API. Þetta kemur í veg fyrir óæskilega multi-PAN aðgerð á Rás 11 (sjálfgefin rás) þegar notað er multiPAN-hæfa RCP uppsetningu. (Önnur tilvísun: 1390724)
Lagaði vandamál sem olli hruni þegar slegið var inn „lyklaprentun“ í DMP Light appi með LTO virkt.
Lagaði vandamál á Zigbee-NCP + OT-RCP, þegar slökkt var á PTA hefði valdið NCP/RCP endurstillingu.

Lagað í útgáfu 9.0.0.0

ID # 1275378 1300848 1332330
1337101
1337228 1337295 1346785 1346849 1365665

Lýsing
Lagaði vandamál þar sem hringing í sl_802154_radio_set_scheduler_priorities() á undan sli_mac_lower_mac_init() gæti leitt til hruns.
Lagaði vandamál þar sem Z3Gateway í OpenWRT umhverfi gat ekki ræst EZSP samskipti af völdum missamræmis termios stýristöfum sem keyra á OpenWRT og öðru umhverfi.
Lagaði vandamál þar sem 15.4+BLE RCP sem starfar í umhverfi með mikilli netumferð gæti stundum lent í keppnisástandi sem myndi gera það að verkum að það gæti ekki sent skilaboð allt að CPCd fyrr en tækið var endurræst.
Ófullnægjandi 15.4 sendingaraðgerðir (Tx bíður eftir svari, Tx svar sem svar við skilaboðum osfrv.) eru ekki lengur taldar ótímabærar við útvarpsrof vegna DMP. Þetta gerir kleift að gefa téðri aðgerð tækifæri til að endurskipuleggja hana eftir truflunina eða að hún verði varanlega misheppnuð af RAIL (villutilvik í tímaáætlunarstöðu).
Í Zigbeed er halCommonGetInt32uMillisecondTick() tick API nú uppfært til að nota MONOTONIC clock, svo að það verði ekki fyrir áhrifum af NTP í hýsilkerfi.
DMP CLI skipunin „plugin ble gap print-connections“ mun nú prenta „No BLE connections“ ef tengitaflan er tóm, í stað þess að gefa ekkert svar.
Lagaði keppnisástand sem gæti valdið því að samhliða hlustun yrði óvirk á 802.15.4 RCP þegar báðar samskiptareglur voru að senda samtímis.
Að bæta rail_mux hlutunum við verkefni mun nú valda því að það byggist sjálfkrafa með tilheyrandi staflasafnsafbrigðum.
Lagaði vandamál þar sem gestgjafinn myndi tilkynna að hann hefði fengið pakka með ógildri eftirlitssummu á endapunkti 12.

silabs.com | Að byggja upp tengdari heim.

Bluetooth 9.1.0.0 | 12

Multiprotocol Gateway og RCP

7.4 Þekkt vandamál í núverandi útgáfu
Feitletruð tölublöð voru bætt við frá fyrri útgáfu. Ef þú hefur misst af útgáfu eru nýlegar útgáfuskýringar fáanlegar á https://www.silabs.com/developers/simplicity-software-development-kit.

ID # 937562 1074205 1122723 1209958 1221299 1385052
1385486

Lýsing

Lausn

Bluetoothctl „auglýsa á“ skipunin mistekst með rcp-uart802154-blehci appinu á Raspberry Pi OS 11.

Notaðu btmgmt app í staðinn fyrir bluetoothctl.

CMP RCP styður ekki tvö net á sama PAN auðkenni.

Notaðu mismunandi PAN auðkenni fyrir hvert net. Stuðningur er fyrirhugaður í framtíðarútgáfu.

Í annasömu umhverfi getur CLI orðið óviðbragðslaust í z3-light_ot-ftd_soc appinu.

Engin þekkt lausn.

ZB/OT/BLE RCP sem notar samhliða hlustun á MG24 og MG21 gæti hætt að virka í þolprófi (varar í ~2 klst) með stöðugri og samhliða umferð á öllum 3 staflanum.

Slökktu á samhliða hlustun í notkunartilfellum sem fela í sér stöðuga og samhliða umferð á öllum 3 samskiptareglunum.

Mfglib RSSI lestur er mismunandi á milli RCP og NCP.

Verður fjallað um í framtíðarútgáfu.

Coex-virkt RCP gæti samt stundum sent TX ACK eftir að hafa tapað styrknum, jafnvel þegar Acking er óvirkt og TX Abort er virkt.

Verður fjallað um í framtíðarútgáfu.

TX frá RCP getur sjaldan gerst án beiðninnar eftir að kveikt hefur verið á MAC Holdoff coex valmöguleikanum sem ekki er samhæfður 802.15.4.

Verður fjallað um í framtíðarútgáfu.

7.5 úreltir hlutir
„Multiprotocol Container“ sem er nú fáanlegur á DockerHub (siliconlabsinc/multiprotocol) verður úreltur í væntanlegri útgáfu. Gámurinn verður ekki lengur uppfærður og hægt að draga hann úr DockerHub. Debian-undirstaða pakkanna fyrir cpcd, zigbeed og ot-br-posix, ásamt innfæddum mynduðum og samsettum verkefnum, munu koma í stað virkni sem glataðist með því að fjarlægja ílátið.
7.6 Fjarlægðir hlutir
Fjarlægt í útgáfu 9.0.1.0 sl_sec_man_init() hefur verið fjarlægt, þar sem það þjónar ekki lengur tilgangi. Fjarlægt í útgáfu 9.0.0.0 Ekkert.

silabs.com | Að byggja upp tengdari heim.

Bluetooth 9.1.0.0 | 13

Að nota þessa útgáfu
8 Notkun þessarar útgáfu
Þessi útgáfa inniheldur eftirfarandi · Silicon Labs Bluetooth staflasafn · Bluetooth sample applications Fyrir frekari upplýsingar um Bluetooth SDK sjá https://docs.silabs.com/bluetooth/latest/. Ef þú ert nýr í Bluetooth skaltu skoða UG103.14: Bluetooth LE Fundamentals.

8.1 Uppsetning og notkun
Bluetooth SDK er veitt sem hluti af Simplicity SDK, föruneyti Silicon Labs SDK. Til að byrja fljótt með Simplicity SDK skaltu setja upp Simplicity Studio 5, sem mun setja upp þróunarumhverfið þitt og leiða þig í gegnum GSDK uppsetninguna. Simplicity Studio 5 inniheldur allt sem þarf fyrir IoT vöruþróun með Silicon Labs tækjum, þar á meðal auðlinda- og verkefnaræsi, hugbúnaðarstillingarverkfæri, fullan IDE með GNU verkfærakeðju og greiningarverkfæri. Uppsetningarleiðbeiningar eru í nethandbók Simplicity Studio 5.
Að öðrum kosti er hægt að setja Simplicity SDK upp handvirkt með því að hlaða niður eða klóna það nýjasta frá GitHub. Sjá https://github.com/SiliconLabs/simplicity_sdk fyrir frekari upplýsingar.
Simplicity Studio setur Simplicity sjálfgefið upp í: · (Windows): C:Users SimplicityStudioSDKssimplicity_sdk · (MacOS): /Notendur/ /SimplicityStudio/SDKs/simplicity_sdk
Skjöl sem eru sértæk fyrir SDK útgáfuna eru sett upp með SDK. Viðbótarupplýsingar má oft finna í þekkingargrunnsgreinum (KBA). API tilvísanir og aðrar upplýsingar um þessa og fyrri útgáfur eru fáanlegar á https://docs.silabs.com/.

8.2 Öryggisupplýsingar
Örugg Vault samþætting
Þegar þeir eru settir á Secure Vault High tæki eru viðkvæmir lyklar eins og Long Term Key (LTK) verndaðir með því að nota Secure Vault Key Management virknina. Taflan hér að neðan sýnir vernduðu lyklana og geymsluverndareiginleika þeirra.

Vafður lykill fjarlægur langtímalykill (LTK) staðbundinn langtímalykill (aðeins eldri) Fjarlægur auðkennislykill (IRK)
Staðbundinn auðkennislykill

Útflutningshæft / Óútflutningshæft Óútflutningshæft Óútflutningshæft
Útflutningshæft

Skýringar
Verður að vera hægt að flytja út af framtíðarsamhæfisástæðum Verður að vera hægt að flytja út vegna þess að lyklinum er deilt með öðrum tækjum.

Vafðir lyklar sem eru merktir sem „Non-Exportable“ er hægt að nota en ekki viewed eða deilt á keyrslutíma.

Vafðir lyklar sem eru merktir sem „Exportable“ er hægt að nota eða deila á keyrslutíma en haldast dulkóðaðir meðan þeir eru geymdir í flash.

Fyrir frekari upplýsingar um Secure Vault Key Management virkni, sjá AN1271: Secure Key Storage.

silabs.com | Að byggja upp tengdari heim.

Bluetooth 9.1.0.0 | 14

Að nota þessa útgáfu
Öryggisráðgjöf
Til að gerast áskrifandi að öryggisráðgjöf, skráðu þig inn á Silicon Labs viðskiptavinagáttina og veldu síðan Account Home. Smelltu á HEIM til að fara á heimasíðu gáttarinnar og smelltu síðan á Stjórna tilkynningar reitnum. Gakktu úr skugga um að hakað sé við "hugbúnaðar-/öryggisráðgjafar og tilkynningar um vörubreytingar (PCN)" og að þú sért að lágmarki áskrifandi að vettvangi þínum og samskiptareglum. Smelltu á Vista til að vista allar breytingar.

8.3 Stuðningur
Viðskiptavinir Þróunarsetts eiga rétt á þjálfun og tækniaðstoð. Notaðu Silicon Labs Bluetooth LE web síðu til að fá upplýsingar um allar Silicon Labs Bluetooth vörur og þjónustu, og til að skrá þig fyrir vöruaðstoð. Þú getur haft samband við þjónustudeild Silicon Laboratories á http://www.silabs.com/support.
8.4 SDK útgáfu- og viðhaldsstefna
Fyrir frekari upplýsingar, sjá SDK útgáfu og viðhaldsreglur.

silabs.com | Að byggja upp tengdari heim.

Bluetooth 9.1.0.0 | 15

Simplicity stúdíó
Aðgangur með einum smelli að MCU og þráðlausum verkfærum, skjölum, hugbúnaði, frumkóðasöfnum og fleira. Í boði fyrir Windows, Mac og Linux!

IoT safn
www.silabs.com/IoT

SV/HW
www.silabs.com/Simplicity

Gæði
www.silabs.com/quality

Stuðningur og samfélag
www.silabs.com/community

Fyrirvari Silicon Labs ætlar að veita viðskiptavinum nýjustu, nákvæma og ítarlega skjölin um öll jaðartæki og einingar sem eru tiltækar fyrir kerfis- og hugbúnaðarframleiðendur sem nota eða ætla að nota Silicon Labs vörurnar. Einkennisgögn, tiltækar einingar og jaðartæki, minnisstærðir og minnisföng vísa til hvers tiltekins tækis og „Dæmigert“ færibreytur geta verið mismunandi eftir mismunandi forritum. Umsókn tdampLesið sem lýst er hér er eingöngu til lýsingar. Silicon Labs áskilur sér rétt til að gera breytingar án frekari fyrirvara á vöruupplýsingum, forskriftum og lýsingum hér, og gefur enga ábyrgð á nákvæmni eða heilleika meðfylgjandi upplýsinga. Án fyrirvara getur Silicon Labs uppfært fastbúnað vörunnar meðan á framleiðsluferlinu stendur af öryggis- eða áreiðanleikaástæðum. Slíkar breytingar munu ekki breyta forskriftum eða frammistöðu vörunnar. Silicon Labs ber enga ábyrgð á afleiðingum notkunar upplýsinganna sem gefnar eru upp í þessu skjali. Þetta skjal felur ekki í sér eða gefur beinlínis leyfi til að hanna eða búa til samþættar rafrásir. Vörurnar eru ekki hannaðar eða heimilaðar til notkunar í neinum FDA Class III tækjum, forritum þar sem FDA formarkaðssamþykki er krafist eða lífsstuðningskerfum án sérstaks skriflegs samþykkis Silicon Labs. „Lífsstuðningskerfi“ er hvers kyns vara eða kerfi sem ætlað er að styðja við eða viðhalda lífi og/eða heilsu, sem, ef það mistekst, má með sanngirni búast við að muni leiða til verulegs líkamstjóns eða dauða. Silicon Labs vörur eru ekki hannaðar eða heimilaðar fyrir hernaðarlega notkun. Silicon Labs vörur skulu undir engum kringumstæðum notuð í gereyðingarvopnum, þar með talið (en ekki takmarkað við) kjarnorku-, sýkla- eða efnavopn, eða eldflaugar sem geta flutt slík vopn. Silicon Labs afsalar sér allri óbeinum og óbeinum ábyrgðum og ber ekki ábyrgð á meiðslum eða skemmdum sem tengjast notkun Silicon Labs vöru í slíkum óviðkomandi forritum.
Upplýsingar um vörumerki Silicon Laboratories Inc.®, Silicon Laboratories®, Silicon Labs®, SiLabs® og Silicon Labs logo®, Bluegiga®, Bluegiga Logo®, EFM®, EFM32®, EFR, Ember®, Energy Micro, Energy Micro logo og samsetningar þeirra, „orkuvænustu örstýringar heims“, Redpine Signals®, WiSeConnect , n-Link, EZLink®, EZRadio®, EZRadioPRO®, Gecko®, Gecko OS, Gecko OS Studio, Precision32®, Simplicity Studio®, Telegesis, Telegesis Logo®, USBXpress® , Zentri, Zentri lógóið og Zentri DMS, Z-Wave® og fleiri eru vörumerki eða skráð vörumerki Silicon Labs. ARM, CORTEX, Cortex-M3 og THUMB eru vörumerki eða skráð vörumerki ARM Holdings. Keil er skráð vörumerki ARM Limited. Wi-Fi er skráð vörumerki Wi-Fi Alliance. Allar aðrar vörur eða vörumerki sem nefnd eru hér eru vörumerki viðkomandi eigenda.
Silicon Laboratories Inc. 400 West Cesar Chavez Austin, TX 78701 Bandaríkin
www.silabs.com

Skjöl / auðlindir

SILICON LABS xG22 Bluetooth LE SDK hugbúnaður [pdfNotendahandbók xG22, xG22 Bluetooth LE SDK hugbúnaður, Bluetooth LE SDK hugbúnaður, LE SDK hugbúnaður, SDK hugbúnaður, hugbúnaður

Heimildir

• Notendahandbók