Util Functions#

The Util Functions component provides helper functions to inform the application about the Wi-SUN PHY configured in the RAIL configuration file.

Functions#

sl_status_t
sl_wisun_util_get_rf_settings(uint8_t *reg_domain, uint8_t *op_class, uint16_t *op_mode) SL_DEPRECATED_API_SDK_4_2

Get frequency band settings of the first RAIL configuration listed in RAIL's channelConfigs array.

sl_status_t
sl_wisun_util_get_phy_config(sl_wisun_phy_config_t *phy_config)

Get PHY settings of the first RAIL configuration listed in RAIL's channelConfigs array.

sl_status_t
sl_wisun_util_connect(const uint8_t *network_name)

Connect to a Wi-SUN network.

Function Documentation#

sl_wisun_util_get_rf_settings#

sl_status_t sl_wisun_util_get_rf_settings (uint8_t * reg_domain, uint8_t * op_class, uint16_t * op_mode)

Get frequency band settings of the first RAIL configuration listed in RAIL's channelConfigs array.

Parameters
[out]reg_domain

Regulatory domain of the Wi-SUN network

[out]op_class

Operational class of the Wi-SUN network

[out]op_mode

Operational mode of the Wi-SUN network

Returns

  • SL_STATUS_OK if successful, an error code otherwise

  • One of the following:

    • SL_STATUS_OK if successful

    • SL_STATUS_INVALID_CONFIGURATION if a configuration that cannot be managed by the plugin is used

    • SL_STATUS_FAIL if an other error occured

Warnings

  • Do not call this function while the Wi-SUN stack is started.

DeprecatedThis function will be removed in the future versions of the Wi-SUN stack. See sl_wisun_util_get_phy_config() for a replacement.


Definition at line 62 of file /mnt/raid/workspaces/ws.XvhINl85J/overlay/gsdk/protocol/wisun/stack/inc/sl_wisun_util.h

sl_wisun_util_get_phy_config#

sl_status_t sl_wisun_util_get_phy_config (sl_wisun_phy_config_t * phy_config)

Get PHY settings of the first RAIL configuration listed in RAIL's channelConfigs array.

Parameters
[out]phy_config

Pointer to PHY configuration

Returns

  • SL_STATUS_OK if successful, an error code otherwise

  • One of the following:

    • SL_STATUS_OK if successful

    • SL_STATUS_INVALID_CONFIGURATION if a configuration that cannot be managed by the plugin is used

    • SL_STATUS_FAIL if an other error occured

Warnings

  • Do not call this function while the Wi-SUN stack is started.


Definition at line 79 of file /mnt/raid/workspaces/ws.XvhINl85J/overlay/gsdk/protocol/wisun/stack/inc/sl_wisun_util.h

sl_wisun_util_connect#

sl_status_t sl_wisun_util_connect (const uint8_t * network_name)

Connect to a Wi-SUN network.

Parameters
[in]network_name

Name of the Wi-SUN network as a zero-terminated string

Returns

  • SL_STATUS_OK if successful, an error code otherwise

  • One of the following:

    • SL_STATUS_OK if successful

    • SL_STATUS_INVALID_CONFIGURATION if a configuration that cannot be managed by the plugin is used

    • SL_STATUS_FAIL if an other error occured

Since Wi-SUN frequency band settings are deduced from first RAIL configuration listed in RAIL's channelConfigs array, using this function is not recommended if more than one RAIL configuration is described.


Definition at line 97 of file /mnt/raid/workspaces/ws.XvhINl85J/overlay/gsdk/protocol/wisun/stack/inc/sl_wisun_util.h