Custom Feature Bitmap#

This section provides a reference to the custom feature bitmap in the boot configuration feature bitmaps.

Macros#

#define

Disables gateway configuration sent to STA from RSI AP.

#define

Configures the clock for NWP SOC to 160 MHz.

#define

Configures the Access Point (AP) to operate in hidden mode.

#define

Includes DNS server IP address in DHCP offer response when in AP mode.

#define

Enables scanning of DFS channels in the 5 GHz band.

#define

Enables LED blinking feature to indicate network activity.

#define

Enables asynchronous WLAN connection status indication to the host.

#define

Enables wake-on-wireless functionality in UART mode.

#define

Enables AP blacklisting in Station (STA) mode.

#define

Sets the maximum number of clients supported in AP mode.

#define

Selects between de-authentication or null data (with power management bit set) for roaming.

#define

Triggers automatic configuration.

#define

Limits the number of packets buffered per STA in Access Point (AP) mode.

#define

Enables HTTP/HTTPS authentication.

#define

Configures the clock for NWP SOC to 120 MHz.

#define

Rejects new LTCP connection requests immediately when maximum clients are connected.

#define

Enables dual-band roaming and VCSAFD (Virtual Channel Scan and Frequency Avoidance Detection) feature (currently not supported).

#define

Enables Real-Time Clock (RTC) synchronization from the host.

#define

Enables Bluetooth In-App Programming (IAP) feature.

#define

Validates the use of extended custom feature bitmap.

Macro Definition Documentation#

SL_SI91X_CUSTOM_FEAT_DISABLE_GATEWAY_IN_RSI_AP#

#define SL_SI91X_CUSTOM_FEAT_DISABLE_GATEWAY_IN_RSI_AP
Value:
BIT(2)

Disables gateway configuration sent to STA from RSI AP.

If this bit is set to 1, the DHCP server behavior changes when the device is in Access Point (AP) mode. The DHCP server assigns IP addresses to client nodes without sending out a Gateway address, providing only the assigned IP and Subnet values. It is highly recommended to keep this value at '0' for standard AP functionality, as disabling the gateway address is typically needed only for very specialized use cases. The default value of this bit is '0'.

Note

  • Bits 0 - 1 are reserved.


Definition at line 531 of file components/device/silabs/si91x/wireless/inc/sl_wifi_device.h

SL_SI91X_CUSTOM_FEAT_SOC_CLK_CONFIG_160MHZ#

#define SL_SI91X_CUSTOM_FEAT_SOC_CLK_CONFIG_160MHZ
Value:
BIT(4)

Configures the clock for NWP SOC to 160 MHz.

If higher performance, such as increased throughput, is required this configuration sets the System-on-Chip (SoC) clock to 160 MHz.

Note

  • Ensure to set pll_mode to 1 in the feature frame command for this configuration to take effect.

  • Bit 3 is reserved.


Definition at line 541 of file components/device/silabs/si91x/wireless/inc/sl_wifi_device.h

SL_SI91X_CUSTOM_FEAT_AP_IN_HIDDEN_MODE#

#define SL_SI91X_CUSTOM_FEAT_AP_IN_HIDDEN_MODE
Value:
BIT(5)

Configures the Access Point (AP) to operate in hidden mode.

If this bit is set, the AP is created in a hidden mode where its SSID is not broadcasted, making the AP less visible to clients. This feature is valid only when the device is in AP mode.


Definition at line 549 of file components/device/silabs/si91x/wireless/inc/sl_wifi_device.h

SL_SI91X_CUSTOM_FEAT_DNS_SERVER_IN_DHCP_OFFER#

#define SL_SI91X_CUSTOM_FEAT_DNS_SERVER_IN_DHCP_OFFER
Value:
BIT(6)

Includes DNS server IP address in DHCP offer response when in AP mode.

When this bit is set, the DHCP server runs in AP mode and includes the DNS server IP address in the DHCP offer response sent to clients.


Definition at line 556 of file components/device/silabs/si91x/wireless/inc/sl_wifi_device.h

SL_SI91X_CUSTOM_FEAT_DFS_CHANNEL_SUPPORT#

#define SL_SI91X_CUSTOM_FEAT_DFS_CHANNEL_SUPPORT
Value:
BIT(8)

Enables scanning of DFS channels in the 5 GHz band.

This bit enables the support for scanning Dynamic Frequency Selection (DFS) channels in the 5 GHz band. It is applicable in Wi-Fi client mode only. Ensure to set the region configuration before scanning DFS channels.

Note

  • Bit 7 is reserved.

  • 5 GHz is not supported in SI917.


Definition at line 567 of file components/device/silabs/si91x/wireless/inc/sl_wifi_device.h

SL_SI91X_CUSTOM_FEAT_LED_FEATURE#

#define SL_SI91X_CUSTOM_FEAT_LED_FEATURE
Value:
BIT(9)

Enables LED blinking feature to indicate network activity.

When this bit is set, the LED (GPIO_16) will blink to indicate network activity. The LED blinks when a TX packet is sent or when a unicast packet addressed to the device’s MAC is received.

Note

  • Not applicable for SI917.


Definition at line 577 of file components/device/silabs/si91x/wireless/inc/sl_wifi_device.h

SL_SI91X_CUSTOM_FEAT_ASYNC_CONNECTION_STATUS#

#define SL_SI91X_CUSTOM_FEAT_ASYNC_CONNECTION_STATUS
Value:
BIT(10)

Enables asynchronous WLAN connection status indication to the host.

If this bit is enabled, the module will asynchronously notify the host of WLAN connection status changes. This feature is valid in Wi-Fi client mode only.


Definition at line 585 of file components/device/silabs/si91x/wireless/inc/sl_wifi_device.h

SL_SI91X_CUSTOM_FEAT_WAKE_ON_WIRELESS#

#define SL_SI91X_CUSTOM_FEAT_WAKE_ON_WIRELESS
Value:
BIT(11)

Enables wake-on-wireless functionality in UART mode.

This bit enables the wake-on-wireless feature when operates in UART mode, which allows the module to wake up in response to wireless events.

Note

  • applicable for NCP only.


Definition at line 594 of file components/device/silabs/si91x/wireless/inc/sl_wifi_device.h

SL_SI91X_CUSTOM_FEAT_ENABLE_AP_BLACKLIST#

#define SL_SI91X_CUSTOM_FEAT_ENABLE_AP_BLACKLIST
Value:
BIT(12)

Enables AP blacklisting in Station (STA) mode.

By default, the client maintains an AP blacklist to avoid specific access points. Enabling this feature allows the client to bypass the AP blacklist during roaming or rejoin, if required.


Definition at line 602 of file components/device/silabs/si91x/wireless/inc/sl_wifi_device.h

SL_SI91X_CUSTOM_FEAT_MAX_NUM_OF_CLIENTS#

#define SL_SI91X_CUSTOM_FEAT_MAX_NUM_OF_CLIENTS
Value:
(max_num_of_clients)

Sets the maximum number of clients supported in AP mode.

This bit field sets the maximum number of clients that can be supported in Access Point (AP) mode. The value for this field should be provided in the range specified by bits 13 - 16.


Definition at line 611 of file components/device/silabs/si91x/wireless/inc/sl_wifi_device.h

SL_SI91X_CUSTOM_FEAT_ROAM_WITH_DEAUTH_OR_NULL_DATA#

#define SL_SI91X_CUSTOM_FEAT_ROAM_WITH_DEAUTH_OR_NULL_DATA
Value:
BIT(17)

Selects between de-authentication or null data (with power management bit set) for roaming.

If this bit is enabled then roam through DEAUTH, or roam through NULL.


Definition at line 618 of file components/device/silabs/si91x/wireless/inc/sl_wifi_device.h

SL_SI91X_CUSTOM_FEAT_TRIGGER_AUTO_CONFIG#

#define SL_SI91X_CUSTOM_FEAT_TRIGGER_AUTO_CONFIG
Value:
BIT(20)

Triggers automatic configuration.

This bit enables the auto-configuration feature, which allows the module to automatically configure itself based on predefined parameters.

Note

  • Bits 18 - 19 are reserved.

  • Not applicable for SI917.


Definition at line 628 of file components/device/silabs/si91x/wireless/inc/sl_wifi_device.h

SL_SI91X_CUSTOM_FEAT_LIMIT_PACKETS_PER_STA#

#define SL_SI91X_CUSTOM_FEAT_LIMIT_PACKETS_PER_STA
Value:
BIT(22)

Limits the number of packets buffered per STA in Access Point (AP) mode.

In AP mode, if the bit is set, only two packets per Station (STA) would be buffered when the STA is in Power Save (PS) mode. This helps manage buffer usage and ensures efficient packet handling.

Note

  • Bit 21 is reserved.


Definition at line 638 of file components/device/silabs/si91x/wireless/inc/sl_wifi_device.h

SL_SI91X_CUSTOM_FEAT_HTTP_HTTPS_AUTH#

#define SL_SI91X_CUSTOM_FEAT_HTTP_HTTPS_AUTH
Value:
BIT(23)

Enables HTTP/HTTPS authentication.

This bit enables authentication for HTTP and HTTPS connections, adding an extra layer of security for web-based communications.


Definition at line 645 of file components/device/silabs/si91x/wireless/inc/sl_wifi_device.h

SL_SI91X_CUSTOM_FEAT_SOC_CLK_CONFIG_120MHZ#

#define SL_SI91X_CUSTOM_FEAT_SOC_CLK_CONFIG_120MHZ
Value:
BIT(24)

Configures the clock for NWP SOC to 120 MHz.

This configuration sets the System-on-Chip (SoC) clock to 120 MHz. This might requires certain performance needs. Ensure to set pll_mode to 1 in the feature frame command for the configuration to be in effect.

Note

  • This configuration is necessary for high throughput scenarios.


Definition at line 655 of file components/device/silabs/si91x/wireless/inc/sl_wifi_device.h

SL_SI91X_CUSTOM_FEAT_REJECT_CONNECT_REQ_IMMEDIATELY#

#define SL_SI91X_CUSTOM_FEAT_REJECT_CONNECT_REQ_IMMEDIATELY
Value:
BIT(26)

Rejects new LTCP connection requests immediately when maximum clients are connected.

When bit is set, any new connection request for an LTCP socket would be rejected immediately if the maximum number of clients are connected already. By default, such requests are maintained in a pending list until an existing client disconnects.

Note

  • When BIT[26] = 0: New connection requests are held in a pending list. When BIT[26] = 1: New connection requests are immediately rejected.


Definition at line 665 of file components/device/silabs/si91x/wireless/inc/sl_wifi_device.h

SL_SI91X_CUSTOM_FEAT_DUAL_BAND_ROAM_VCSAFD#

#define SL_SI91X_CUSTOM_FEAT_DUAL_BAND_ROAM_VCSAFD
Value:
BIT(27)

Enables dual-band roaming and VCSAFD (Virtual Channel Scan and Frequency Avoidance Detection) feature (currently not supported).

This bit enables support for dual-band roaming and VCSAFD, which enhances the module’s ability to switch between different frequency bands and avoid interference.


Definition at line 673 of file components/device/silabs/si91x/wireless/inc/sl_wifi_device.h

SL_SI91X_CUSTOM_FEAT_RTC_FROM_HOST#

#define SL_SI91X_CUSTOM_FEAT_RTC_FROM_HOST
Value:
BIT(28)

Enables Real-Time Clock (RTC) synchronization from the host.

When bit is set, the module uses the Real-Time Clock (RTC) provided by the host system for timekeeping.

Note

  • Ensures the Real-Time Clock (RTC) timer is configured to enable certificate validation.


Definition at line 683 of file components/device/silabs/si91x/wireless/inc/sl_wifi_device.h

SL_SI91X_CUSTOM_FEAT_BT_IAP#

#define SL_SI91X_CUSTOM_FEAT_BT_IAP
Value:
BIT(29)

Enables Bluetooth In-App Programming (IAP) feature.

This bit enables the Bluetooth In-App Programming (IAP) feature, which allows the module to support Bluetooth-related IAP functionalities.


Definition at line 690 of file components/device/silabs/si91x/wireless/inc/sl_wifi_device.h

SL_SI91X_CUSTOM_FEAT_EXTENTION_VALID#

#define SL_SI91X_CUSTOM_FEAT_EXTENTION_VALID
Value:
BIT(31)

Validates the use of extended custom feature bitmap.

The bit indicates the extended custom feature bitmap is valid. If this bit is enabled then only, the features present in the extended custom feature bitmap can be used.


Definition at line 698 of file components/device/silabs/si91x/wireless/inc/sl_wifi_device.h