Ezurio provides a Buildroot br2-external tree that includes support for the Sona IF and Sterling LWBx series radios. Platforms that use the Buildroot build system can use this br2-external tree to do much of the integration automatically. This section gives a brief overview of the steps needed to include and use this tree.

Basic familiarity with Buildroot is assumed.

Installation

The Ezurio Buildroot br2-external tree is called summit-radio-external and is available on gitHub at summit-radio-external. Clone or copy this into your project directory alongside your main buildroot directory.

Note: Be sure to specify the branch corresponding to the Ezurio Connectivity Stack release version. The example below checks out the lrd-13.24.0.x branch, which supports the 13.24.0.20 release.

cd /my_project/
git clone https://github.com/Ezurio/summit-radio-external -b lrd-13.24.0.x

The summit-radio-external br2-external tree must be added to your buildroot configuration using the BR2_EXTERNAL make variable. There are several ways this could be done, depending on whether you have other br2-external trees. In most cases, you can specify it as part of any call to make and the value will be preserved for future calls to make.

For example:

make BR2_EXTERNAL=$PWD/summit-radio-external <your_defconfig>-menuconfig

If you have multiple br2-external trees in your project, specify all of them in a colon deliminated list.

Configuration

Once installed, run the Buildroot menuconfig command to configure the Ezurio Connectivity Stack for the Sona IF and Sterling LWBx series radios.

make BR2_EXTERNAL=$PWD/summit-radio-external <your_defconfig>-menuconfig

The Ezurio Connectivity Stack components are available at External options ---> Summit Radio Configuration. Support can be added using a pre-configured Radio Stack Bundle or by adding the components individually. The Core Sona IF/Sterling LWBx Radio Stack Bundle is the preferred mechanism and automatically includes the Summit backports, Summit supplicant and hostapd and Summit NetworkManager by default. These components can be individually configured as necessary.

Note: The Sona IF/Sterling LWBx radio firmware component must be manually configured. Some radios have multiple firmware packages available depending on interface and antenna configuration. See Firmware for more details. The regulatory domain configuration discussed at Regulatory Compliance can optionally be configured as part of the firmware configuration.

  • Select Radio Stack Bundles
  • Select Core Sona IF/Sterling LWBx Radio Stack Bundle
  • Select Summit Radio Firmware
  • Select Sona IF/Sterling LWBx Series Radio Firmware
  • Select the Sona IF/Sterling LWBx firmware package corresponding to the radio used in the design
  • Optionally set the country code in Regulatory Domain

The backports package contains the following in-tree defconfig files pre-configured for the Sona IF and Sterling LWBx series radios:

defconfig Description
lwb Sona IF/Sterling LWBx support for Wi-Fi and Bluetooth
lwb_nbt Sona IF/Sterling LWBx support for Wi-Fi only

The Sona IF/Sterling LWBx Radio Stack Bundle will default the backports configuration using one of these defconfigs depending on the presence of the BlueZ stack in the buildroot configuration. The backports defconfig can be verified (or changed) at Summit Linux Backports / Wi-Fi & Bluetooth drivers ---> Backports defconfig name

Note: The Radio Stack Bundles enable Connectivity Stack components by default, if they are not otherwise configured. Once a component is disabled, it is configured and the Radio Stack Bundle logic will not re-enable it. If the Summit supplicant, hostapd and Summit Network Manager have been previously disabled the Radio Stack Bundle will not enable them.

Save the Buildroot configuration after the Ezurio Connectivity Stack has been configured. Update the defconfig file to preserve the changes.

make <your_defconfig>-savedefconfig

Note: You may need to manually save the resulting defconfig file to in your configs directory.

See the buildroot documentation for more details.