Use this page to understand and configure the Wi-SUN parameters on the XBee Hive for Wi-SUN. These settings define how the Border Router advertises the network and must match the configuration used by joining nodes.

Before you begin

Select the network parameters for your deployment and confirm that all devices will use the same values. For definitions and planning guidance, see Form a network.

Network settings

Setting Purpose

Enable

This will enable the Wi-SUN Border Router functionality on the device.

Channel Plan ID

Selects the regional channel plan and hop sequence used for discovery and data traffic.

PHY Operating Mode ID

Selects the IEEE 802.15.4g SUN PHY mode used for modulation and data rate.

Network name

Human-readable identifier used by nodes to filter candidate networks.

Network size

Controls default settings that scale with network density and expected node count.

Max TX power

Sets the maximum transmit power for the Border Router radio, subject to regional limits.
All nodes must use the same Channel Plan ID, PHY Operating Mode ID, and Network name as the Border Router. See Add devices to an existing network for node configuration steps.

Advanced network settings

These parameters influence discovery, synchronization, and how quickly nodes can join. Tune them only after you have a working network.

Setting Purpose

Unicast dwell interval

Time spent on each channel for unicast traffic during frequency hopping.

Broadcast dwell interval

Time spent on each channel for broadcast traffic during frequency hopping.

Broadcast interval

Period between PAN advertisement and configuration broadcasts.

LFN broadcast interval

Interval that Low Power Field Nodes wake to listen for broadcast traffic.

LFN broadcast sync period

The number of LFN broadcast intervals between broadcast sync frames.

PHY Operating Mode Selection

Selects automatic or manual PHY modes selection.

PHY Operating Modes

Comma-separated list of PHY mode IDs when manual PHY mode selection is enabled.

Configure Wi-SUN network settings

You can set Wi-SUN network parameters using the Web UI or the command line. The exact labels can vary by firmware, but the settings are grouped under the Wi-SUN Border Router configuration area.

Use the command line to configure Wi-SUN network settings.

See Change settings for how to access the command line.

Example showing current settings
> config
(config)> wisun
(config wisun)> show
auth
    identity
        type initial
    method open
    trust_store
        no ca_certs
        include_digi true
chan_plan_id 1
enable true
network
    broadcast_dwell_interval 255
    broadcast_interval 1020
    lfn_broadcast_interval 60000
    lfn_broadcast_sync_period 5
    phy_operating_mode_selection auto
    unicast_dwell_interval 255
network_name my-wisun-network
phy_mode_id_chan_plan_1 2
size small
tx_power 14
(config wisun)>
Example: show help for a setting

To see general help at the current setting path type '?'.
To see help for a specific setting type '?' after the setting.

(config wisun)> enable ?

Enable: This will enable the Wi-SUN Border Router functionality on the device. Warning: Verify Regulatory Domain
accurately reflects your location to avoid regulatory compliance issues.
Format: true, false, yes, no, 1, 0
Default value: false
Current value: true

(config wisun)> enable
Example: set a network setting
> config
(config)> wisun
(config wisun)> enable true
(config wisun)> network_name my-wisun-network
(config wisun)> save
>
Example: set an advanced network setting
> config
(config)> wisun
(config wisun)> network
(config wisun network)> broadcast_interval 200
(config wisun network)> save
>

Configure Wi-SUN network settings using the Web UI.

See Change settings for how to access the Web UI.

Configure network settings

Navigate to: Wi-SUN Border Router for core network settings or Wi-SUN Border Router > Network for advanced network settings.

The fields on this page correspond to the network settings described above. Edit the fields as needed, then click Apply to save changes.