SILICON LABS 6.1.3.0 GA Bluetooth Mesh Развој на софтвер

Спецификации

• Име на производ: Gecko SDK Suite 4.4
• Датум на издавање: 23 октомври 2024 година
• Спецификација на Bluetooth Mesh Верзија: 1.1
• Поддржани верзии на SDK:
  • 6.1.3.0 објавен на 23 октомври 2024 година
  • 6.1.2.0 објавен на 14 август 2024 година
  • 6.1.1.0 објавен на 2 мај 2024 година
  • 6.1.0.0 објавен на 10 април 2024 година
  • 6.0.1.0 објавен на 14 февруари 2024 година
  • 6.0.0.0 објавен на 13 декември 2023 година

Упатство за употреба на производот

Известувања за компатибилност и употреба
За безбедносни ажурирања и известувања, погледнете го поглавјето за безбедност во белешките за издавање на платформата Gecko или посетете ја страницата Белешки за издавање на Silicon Labs. Претплатете се на безбедносните совети за најновите информации.

Користење на ова издание
Ако сте нови во Silicon Labs Bluetooth mesh SDK, следете ги упатствата дадени во упатството за употреба за да започнете со производот.

Компатибилни компајлери
Осигурајте се дека го користите правилното files и компајлери како што се препорачува за оптимални перформанси на производот.

Најчесто поставувани прашања

• П: Каде можам да најдам повеќе информации за безбедносните ажурирања?
  О: Може да се повикате на поглавјето за безбедност од белешките за издавање на платформата Gecko или да ја посетите страницата Silicon Labs Release Notes за детални информации за безбедносно ажурирање. |
• П: Како да се претплатам на безбедносни совети за овој производ?
  О: За да се претплатите на Security Advisories и да добивате ажурирани информации, следете ги упатствата дадени во упатството за корисникот или контактирајте со поддршката на Silicon Labs.
• П: Кои компајлери се компатибилни со овој производ?
  О: Видете во упатството за употреба за список на компатибилни компајлери препорачани за употреба со овој производ.

Bluetooth® мрежа SDK 6.1.3.0 GA
Gecko SDK Suite 4.4, 23 октомври 2024 година

Bluetooth mesh е нова топологија достапна за Bluetooth уреди со ниска енергија (LE) која овозможува комуникација од многу-на-многу (m:m). Оптимизиран е за создавање мрежи на уреди од големи размери и е идеално погоден за автоматизација на згради, мрежи со сензори и следење средства. Нашиот софтвер и SDK за развој на Bluetooth поддржува Bluetooth Mesh и Bluetooth 5.3 функционалност. Програмерите можат да додадат мрежна мрежна комуникација на LE уреди како што се поврзани светла, домашна автоматизација и системи за следење средства. Софтверот поддржува и Bluetooth beaconing, скенирање на светилници и GATT конекции, така што Bluetooth mesh може да се поврзе со паметни телефони, таблети и други Bluetooth LE уреди. Ова издание вклучува функции поддржани од верзијата 1.1 на спецификацијата на Bluetooth mesh.

КЛУЧНИ КАРАКТЕРИСТИКИ

• Квалификувана имплементација на Mesh 1.1
• Додадена е мрежна контрола на осветлување (NLC) проfiles

Овие белешки за издавање ги покриваат верзиите на SDK:

• 6.1.3.0 објавен на 23 октомври 2024 година
• 6.1.2.0 објавен на 14 август 2024 година
• 6.1.1.0 објавен на 2 мај 2024 година
• 6.1.0.0 објавен на 10 април 2024 година
• 6.0.1.0 објавен на 14 февруари 2024 година
• 6.0.0.0 објавен на 13 декември 2023 година

Известувања за компатибилност и употреба
За повеќе информации за безбедносните ажурирања и известувања, видете го поглавјето за безбедност на белешките за издавање на платформата Gecko инсталирани со оваа SDK или на страницата Silicon Labs Release Notes. Silicon Labs, исто така, силно препорачува да се претплатите на безбедносните совети за ажурирани информации. За инструкции или ако сте нов во Silicon Labs Bluetooth mesh SDK, видете Користење на ова издание.

Компатибилни компајлери:
IAR Embedded Workbench for ARM (IAR-EWARM) верзија 9.40.1

• Користењето вино за градење со алатката за командна линија IarBuild.exe или графичкиот интерфејс на IAR Embedded Workbench на macOS или Linux може да резултира со неточни fileсе користи поради судири во алгоритмот за хеширање на виното за генерирање на кратки file имиња.
• На клиентите на macOS или Linux им се препорачува да не градат со IAR надвор од Simplicity Studio. Клиентите кои го прават тоа треба внимателно да проверат дали е точно fileсе користат. GCC (Колекција на компајлер на GNU) верзија 12.2.1, обезбедена со Simplicity Studio.
• Функцијата за оптимизација за време на врската на GCC е оневозможена, што резултира со мало зголемување на големината на сликата.

Нови артикли

 Нови карактеристики
Додадено во издание 6.0.1.0

Промени во компонентите на SLC:

• Додадена е трета BT Mesh Role покрај улогата на обезбедувач и обезбедувач – прилагодена BT Mesh Role, каде што апликацијата добива слобода да имплементира приспособена улога. За прampле, Обезбедувачот или
• Улогата на провизор може да биде избрано време на траење.
• Додадено во издание 6.0.0.0
• Нова мрежна контрола на осветлување (NLC) прampле апликации:
• btmesh_soc_nlc_basic_lightness_controller за демонстрација на BT Mesh NLC Basic Lightness Controller Profile
• btmesh_soc_nlc_basic_scene_selector за демонстрација на BT Mesh NLC Basic Scene Selector Profile
• btmesh_soc_nlc_dimming_control за демонстрација на BT Mesh NLC Dimming Controller Profile
• btmesh_soc_nlc_sensor_ambient_light за демонстрација на BT Mesh NLC Ambient Light Sensor Profile
• btmesh_soc_nlc_sensor_occupancy за демонстрација на BT Mesh NLC Occupancy Sensor Profile (Луѓето се бројат)

Промени во прampле апликации:
btmesh_soc_sensor_server беше избришан и неговата функционалност беше поделена на 3 поранешниamples:

• btmesh_soc_sensor_thermometer за демонстрација на модел на сензорски сервер со термометар
• btmesh_soc_nlc_sensor_occupancy за демонстрација на BT Mesh NLC Occupancy Sensor Profile (луѓето се бројат)
• btmesh_soc_nlc_sensor_ambient_light за демонстрација на BT Mesh NLC Ambient Light Sensor Profile
• btmesh_soc_switch беше преименуван во btmesh_soc_switch_ctl, чија цел е да ја демонстрира употребата на Light CTL Client Model. Поранешниотampповеќе не ги контролира сцените (клиент за сцена)
• btmesh_soc_light беше преименуван во btmesh_soc_light_ctl
• Поранешниотampповеќе не ги демонстрира моделот на LC-серверот и моделите на серверот за сцена, серверот за распоредувач и моделите на серверот за време
• btmesh_soc_hsl беше преименувана во btmesh_soc_light_hsl
• Поранешниотampповеќе не ги демонстрира моделот на LC-серверот и моделите на серверот за сцена, серверот за распоредувач и моделите на серверот за време

Промени во сите прampле апликации:

• Ажурирањата на сликите на DFU се генерираат со Python скрипта наместо create_bl_fileс.лат/.ш files
• Поддршка за Mesh Composition Data Страници 1, 2, 128, 129, 130 е додадена за сите пр.amples, овие страници автоматски се генерираат од алатката BT Mesh Configurator.

Нови SLC компоненти:

• btmesh_nlc_basic_lightness_controller за демонстрација на BT Mesh NLC Basic Lightness Controller Profile
• btmesh_nlc_basic_lightness_controller_profile_metadata за Composition Data Page 2 NLC поддршка за Basic Lightness Controller Profile
• btmesh_nlc_basic_scene_selector за демонстрација на BT Mesh NLC Basic Scene Selector Profile
• btmesh_nlc_basic_scene_selector_profile_metadata for Composition Data Page 2 NLC поддршка за Basic Scene Selector Profile btmesh_nlc_dimming_control за демонстрација на BT Mesh NLC
• Професионален контролер за затемнувањеfile
• btmesh_nlc_dimming_control_profile_metadata for Composition Data Page 2 NLC поддршка за Dimming Controller Profile btmesh_nlc_ambient_light_sensor за демонстрација на BT Mesh NLC Ambient Light Sensor Profile
• btmesh_nlc_ambient_light_sensor_profile_metadata for Composition Data Page 2 Поддршка на NLC за Ambient Light Sensor Profile btmesh_nlc_occupancy_sensor за демонстрација на BT Mesh NLC Occupancy Sensor Profile (Луѓето се бројат)
• btmesh_nlc_occupancy_sensor_profile_metadata for Composition Data Page 2 Поддршка на NLC за Occupancy Sensor Profile
• btmesh_generic_level_client_ext за проширување на компонентата Generic Base со Generic Move Unacknowledged и Generic Delta Unacknownledged пораки
• ncp_btmesh_ae_server за овозможување на моделот продавач на серверот за конфигурација на Silabs за јазолот да дозволи пренос на податоци преку наставката за рекламирање
• ncp_btmesh_ae_server за овозможување на моделот на продавач на клиентот за конфигурација на Silabs за јазолот.
• ncp_btmesh_user_cmd за демонстрирање на комуникацијата помеѓу NCP-домаќин и NCP целта користејќи BGAPI кориснички пораки, одговори и настани.

Нови API-и
Додадено во издание 6.1.0.0

Дополнувања на BGAPI:
Додадени се нови команди во класата на јазли за да се поврзат податоците за одговор на скенирање со Mesh обезбедување и Mesh прокси-сервис реклами. Податоците за одговор на скенирањето поврзани со рекламите на Mesh прокси услугата може да се постават поединечно за секој мрежен клуч, така што може да содржи податоци шифрирани со тој клуч, но апликацијата зависи да управува со тоа. Новите команди се:

• sl_btmesh_node_set_proxy_service_scan response: Поставете податоци за одговор на скенирање за оглас за прокси услуга
• sl_btmesh_node_clear_proxy_service_scan_response: Избришете ги податоците за одговорот на скенирањето за огласот за прокси услуга
• sl_btmesh_node_set_provisioning_service_scan response: Поставете податоци за одговор на скенирање за обезбедување на реклама за услуга
• sl_btmesh_node_clear_provisioning_service_scan_response: Избришете ги податоците за одговорот на скенирањето за обезбедување оглас за услуга

Додадена е нова команда во класата на модели на продавач за да се постават опции за однесување на моделот. Во моментов постои една опција која контролира дали работниот тампон е доделен од купот за секој модел на продавач за известување за прием на пораки. Стандардната вредност (1) доделува тампон, што ја зголемува еластичноста за известување настани кога уредот е под големо оптоварување на сметка на дополнителното користење на куп меморија. Новата команда е:

• sl_btmesh_vendor_model_set_option: Поставете опција за однесување на моделот на продавачот

Додадени се нови команди во дијагностичката класа за известување за настани поврзани со пријателство. Новите команди се:

• sl_btmesh_diagnostic_enable_friend: овозможете генерирање дијагностички настани поврзани со пријателство
• sl_btmesh_diagnostic_disable_friend: оневозможи генерирање дијагностички настани поврзани со пријателство
• sl_btmesh_diagnostic_get_friend: Побарајте дијагностички бројачи поврзани со пријателство

Новите настани додадени во дијагностичката класа се како што следува: 

• sl_btmesh_diagnostic_friend_queue: настан за порака се додава во редот за пораки за пријателство
  sl_btmesh_diagnostic_friend_relay: настан за порака што се пренесува на LPN
• sl_btmesh_diagnostic_friend_remove: настан за порака се отстранува од редот за пораки за пријателство

Додадено во издание 6.0.0.0

Промени во компонентите на SLC:

• ncp_btmesh_dfu компонентата ncp_btmesh_dfu.h има нов API
  • void sl_btmesh_ncp_dfu_handle_cmd(void *податоци, bool *cmd_handled);
• btmesh_provisioning_decorator компонентата не го рестартира обезбедувањето откако неуспешно обезбедувањето. sl_btmesh_lighting_server.h на btmesh_lighting_server.h има нов API
  • void sl_btmesh_update_lightness (uint16_t леснотија, uint32_t преостанати_ms);
• btmesh_event_log има повеќе грануларни опции за конфигурација
• sl_btmesh_ctl_client.h на btmesh_ctl_client има промена на API наместо
  • void sl_btmesh_set_temperature(uint8_t new_color_temperature_percentagд); новиот АПи е
  • void sl_btmesh_ctl_client_set_temperature(uint8_t temperature_percent); void sl_btmesh_ctl_client_set_lightness(uint8_t lightness_percent);

Дополнувања на BGAPI:
Додадена е нова класа BGAPI за дијагностика на уреди. Таа ја обезбедува апликацијата со бројачи за статистика на Mesh стек и известување засновано на настани за мрежно пренесување и прокси PDU, кое може да се активира и деактивира по потреба.

Наредбите BGAPI во дијагностичката класа се:

• sl_btmesh_diagnostic_init: Иницијализирајте ја дијагностичката компонента
• sl_btmesh_diagnostic_deinit: Деиницијализирајте ја дијагностичката компонента
• sl_btmesh_diagnostic_enable_relay: овозможете известување засновано на настани за мрежната активност на PDU пренесување/прокси
• sl_btmesh_diagnostic_disable_relay: оневозможи известување засновано на настани за мрежната активност на PDU пренесување/прокси
• sl_btmesh_diagnostic_get_relay: Добијте го бројот на релеирани/проксирани мрежни PDU-и досега
• sl_btmesh_diagnostic_get_statistics: Добијте бројачи за статистика на мрежест стек
• sl_btmesh_diagnostic_clear_statistics: бројачи за статистика со нула мрежа

Настанот BGAPI во дијагностичката класа е: 

• sl_btmesh_diagnostic_relay: настан кој известува дека мрежен PDU е пренесен или проксиран од стекот

 Подобрувања

Променет во издание 6.1.0.0

Командата за дијагностичка класа BGAPI за преземање статистика е променета за да се преземат делови од податоци наместо да се преземат сите податоци одеднаш. Повикувачот треба да ја достави големината на делот што го бара заедно со поместувањето на делот во статистичките податоци, а повикот ќе се врати со онолку податоци колку што може да се достават, со оглед на ограничувањата на барањето.

Променет во издание 6.0.0.0

• Обезбедувач или јазол сега може да се конфигурира користејќи го моделот на конфигурациски клиент и својата примарна адреса како дестинација за пораките. Ова може да ја замени самоконфигурацијата со тест команди BGAPI.
• Оптимизацијата на кодот може да резултира со малку помали слики на фирмверот од претходно, во зависност од употребениот сет на функции.
• Оптимизацијата на кодот може да резултира со малку помала употреба на RAM меморија од претходно, во зависност од користениот сет на функции.
• Мешовиот оџак повеќе не бара или поддржува застарени компоненти на BLE огласувач и скенер. Наместо тоа, ги користи тековните верзии на секоја од нив (наследен огласувач и наследен скенер за непроширени реклами, и продолжен огласувач и продолжен скенер за продолжени реклами). Апликациите што ги користат и BLE и Mesh BGAPI-ите повеќе не треба да ги користат ниту застарените компоненти на BLE огласувач и скенер.

Поправени проблеми

Поправено во издание 6.1.3.0

Поправено во издание 6.1.2.0 

Поправено во издание 6.1.0.0 

Поправено во издание 6.0.1.0 

Поправено во издание 6.0.0.0 

 Познати проблеми во тековното издание

Проблемите со задебелени букви беа додадени од претходното издание.

Застарени ставки

Застарено во издание 6.0.0.0

Командата BGAPI sl_btmesh_node_get_networks() е застарена. Наместо тоа, користете sl_btmesh_node_key_key_count() и sl_btmesh_node_get_key().
Наредбите BGAPI sl_btmesh_test_set_segment_send_delay() и sl_btmesh_test_set_sar_config() се застарени. Наместо тоа, користете sl_btmesh_sar_config_set_sar_transmitter() и sl_btmesh_sar_config_server_set_sar_receiver().

Отстранети ставки

Отстрането во издание 6.0.0.0
Наредбите BGAPI sl_btmesh_test_set_local_config() и sl_btmesh_test_get_local_config() се отстранети. Наредбите BGAPI sl_btmesh_node_get_statistics() и sl_btmesh_node_clear_statistics() се отстранети.

 Користење на ова издание

Ова издание го содржи следново

• Silicon Labs Bluetooth мрежеста библиотека со стек
• Bluetooth мрежа сampле апликации

Ако сте корисник за прв пат, видете QSG176: Silicon Labs Bluetooth Mesh SDK v2.x Водич за брз почеток.

 Инсталација и употреба
Bluetooth mesh SDK е обезбеден како дел од Gecko SDK (GSDK), пакетот на Silicon Labs SDK. За брзо да започнете со GSDK, инсталирајте го Simplicity Studio 5, кој ќе ја постави вашата развојна околина и ќе ве води низ инсталацијата на GSDK. Simplicity Studio 5 вклучува сè што е потребно за развој на IoT производи со уредите на Silicon Labs, вклучително и фрлач на ресурси и проекти, алатки за конфигурација на софтвер, целосен IDE со синџир на алатки GNU и алатки за анализа. Упатствата за инсталација се дадени во онлајн Упатството за корисникот Simplicity Studio 5.
Алтернативно, Gecko SDK може да се инсталира рачно со преземање или клонирање на најновото од GitHub. Види https://github.com/Sili-conLabs/gecko_sdk за повеќе информации.

Стандардната локација за инсталирање на GSDK е променета со Simplicity Studio 5.3 и понова верзија.

• Windows: C:\Users\ \SimplicityStudio\SDKs\gecko_sdk
• MacOS: /Корисници/ /SimplicityStudio/SDKs/gecko_sdk

 Поддршка
Клиентите на пакетот за развој се подобни за обука и техничка поддршка. Користете ја Bluetooth мрежата на Silicon Labs web страница за да добиете информации за сите производи и услуги на Bluetooth на Silicon Labs и да се регистрирате за поддршка на производите. Контактирајте со поддршката на Silicon Laboratories на http://www.silabs.com/support.

Портфолио на IoTwww.silabs.com/IoT

• SW/HW www.silabs.com/simplicity
• Квалитет www.silabs.com/quality
• Поддршка и заедница www.silabs.com/community

Одрекување
Silicon Labs има намера да им обезбеди на клиентите најнова, точна и длабинска документација за сите периферни уреди и модули достапни за имплементаторите на системот и софтверот кои користат или имаат намера да ги користат производите на Silicon Labs. Податоците за карактеризација, достапните модули и периферни уреди, големината на меморијата и адресите на меморијата се однесуваат на секој специфичен уред, а дадените „Типични“ параметри може и се разликуваат во различни апликации. Апликација прampОписите опишани овде се само за илустративни цели. Silicon Labs го задржува правото да прави промени без дополнително известување за информациите за производот, спецификациите и описите овде и не дава гаранции за точноста или комплетноста на вклучените информации. Без претходно известување, Silicon Labs може да го ажурира фирмверот на производот за време на производниот процес од безбедносни или доверливи причини. Ваквите промени нема да ги променат спецификациите или перформансите на производот. Silicon Labs нема да има одговорност за последиците од употребата на информациите дадени во овој документ.

Овој документ не имплицира или изрично дава никаква лиценца за дизајнирање или производство на какви било интегрирани кола. Производите не се дизајнирани или овластени да се користат во уреди од FDA класа III, апликации за кои е потребно одобрение од FDA пред пазарот или системи за поддршка на животот без специфична писмена согласност од Silicon Labs. „Систем за поддршка на животот“ е секој производ или систем наменет за поддршка или одржување на животот и/или здравјето, што, доколку не успее, може разумно да се очекува да резултира со значителна лична повреда или смрт. Производите на Silicon Labs не се дизајнирани или овластени за воени апликации. Производите на Silicon Labs во никој случај нема да се користат во оружје за масовно уништување, вклучувајќи (но не ограничувајќи се на) нуклеарно, биолошко или хемиско оружје, или проектили способни да испорачуваат такво оружје. Silicon Labs ги отфрла сите изречни и имплицитни гаранции и нема да биде одговорна или одговорна за какви било повреди или штети поврзани со употреба на производ на Silicon Labs во такви неовластени апликации.

Информации за заштитен знак
Silicon Laboratories Inc.®, Silicon Laboratories®, Silicon Labs®, SiLabs® и логото на Silicon Labs®, Bluegiga®, Bluegiga Logo®, EFM®, EFM32®, EFR, Ember®, Energy Micro, Energy Micro логото и нивни комбинации , „најеколошки микроконтролери во светот“, Redpine Signals®, WiSeConnect, n-Link, EZLink®, EZRadio®, EZRadioPRO®, Gecko®, Gecko OS, Gecko OS Studio, Precision32®, Simplicity Studio, Telegesis Logo®, USBXpress®, Zentri, логото на Zentri и Zentri DMS, Z-Wave® и други се заштитни знаци или регистрирани заштитни знаци на Silicon Labs. ARM, CORTEX, Cortex-M3 и THUMB се заштитни знаци или регистрирани заштитни знаци на ARM Holdings. Keil е регистрирана трговска марка на ARM Limited. Wi-Fi е регистрирана трговска марка на Wi-Fi Alliance. Сите други производи или имиња на брендови споменати овде се заштитни знаци на нивните соодветни сопственици.

Silicon Laboratories Inc.
400 Западен Цезар Чавез Остин, Тексас 78701
САДwww.silabs.com

Документи / ресурси

SILICON LABS 6.1.3.0 GA Bluetooth Mesh Развој на софтвер [pdf] Упатство за корисникот 6.1.3.0 GA Bluetooth Mesh развој на софтвер, 6.1.3.0 GA, Bluetooth Mesh развој на софтвер, Mesh развој на софтвер, развој на софтвер, развој

Референци

• Упатство за употреба