> For the complete documentation index, see [llms.txt](https://docs.morsemicro.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.morsemicro.com/application-notes/appnote-31-how-to-configure-easymesh.md).

# APPNOTE-31 How to Configure EasyMesh

[Download as PDF](https://www.morsemicro.com/resources/appnotes/MM_APPNOTE-31_How_to_Configure_EasyMesh.pdf)

## 1 Scope

Wi-Fi EasyMesh is a standards-based solution for multi-AP Wi-Fi networks, enabling seamless and intelligent wireless coverage across homes and small offices. It simplifies network (re)configuration and device onboarding, requiring minimal user intervention while ensuring self-monitoring and optimized performance. While Wi-Fi EasyMesh by the Wi-Fi Alliance was designed for managing Wi-Fi 2.4GHz, 5GHz, and 6GHz radios, Morse Micro's HaLow-specific extensions enable the Wi-Fi HaLow radio to be managed alongside other Wi-Fi bands.

Morse Micro’s OpenWrt uses the open source EasyMesh implementation called prplMesh provided by [prpl Foundation](https://www.google.com/url?q=https://prplfoundation.org/\&sa=D\&source=editors\&ust=1783414481989205\&usg=AOvVaw06W3Jyejl9Jb5qCEwWwAfO). This guide provides instructions for setting up prplMesh to form an EasyMesh network using HaLowLink1.

The prerequisites for this application note are:

1. 2 × HaLowLink1 devices
2. Any router supporting 2.4GHz Wi-Fi or Ethernet with an active internet uplink
3. 1 x Laptop

By following this application note, the reader will learn:

* How to configure HaLowLink1 devices to setup Virtual Wire.
* How to validate this is operating correctly.

## 2 Theory of Operation

An EasyMesh network always consists of two types of logical entities:

* One EasyMesh Controller
* One or more EasyMesh Agents

The EasyMesh Controller is a logical entity responsible for centralized management of all Wi-Fi access points (APs) within a local network. It acts as a master in the network instructing EasyMesh agent nodes on what to do.

The EasyMesh Agent is a logical entity that executes the commands received from EasyMesh Controller and reports measurements and capabilities of the APs. EasyMesh agent interfaces with Wi-Fi subsystem to achieve the commands received from EasyMesh controller.

Unlike a fully distributed 802.11s mesh, EasyMesh enforces a tree-based network topology, where all agents are coordinated via a single controller node. This centralised approach enables more predictable and manageable behaviour but differs from peer-to-peer or decentralised mesh networks.

![](/files/8657a13de06d53468b5593f5d8146593d8ddfb35)

### 2.1 Simple EasyMesh Network

![Example EasyMesh Network](/files/73412dfb640577d32be114d0f57f4f2bbc2b3613)

*Example EasyMesh Network*

To demonstrate the features and capabilities of EasyMesh with Wi-Fi HaLow radio, we will form a simple EasyMesh network with HaLowLink1 as shown in the figure with two nodes where one node must be configured as the EasyMesh controller, while the other node is configured as an EasyMesh agent.

An existing router with a 2.4GHz Wi-Fi AP serves as an internet uplink connection, enabling devices in the EasyMesh network to access the internet.

## 3 How to Configure

The following sections detail the configuration process for both the EasyMesh HaLow Gateway and EasyMesh Extender, along with their corresponding UCI settings.&#x20;

The Web UI features a configuration wizard page designed to simplify the setup of different modes and switch between them quickly. It uses OpenWrt UCI/UBUS configuration interface to apply the required configuration for a specific mode. These UCI configurations are then used by OpenWrt applications to configure the device.

### 3.1 Getting Access to GUI

Connect your computer to HaLowLink1’s LAN port using an Ethernet cable. The default setting in HaLowLink1 assigns your computer an IP address in 192.168.12.x range with the default gateway set to 192.168.12.1. Once your laptop is connected to the HaLowLink’s local network, use a browser to connect to [http://192.168.12.1](https://www.google.com/url?q=http://192.168.12.1\&sa=D\&source=editors\&ust=1783414481995632\&usg=AOvVaw3R89DI7QLMuE3UtFdK_O03). Use the Device Username and Device Password printed on the rear side of the HaLowLink1 device to login.

After logging in, the home page should be visible, similar to the below screenshot:

![](/files/9fe2903bb4cfcf688551d449b69d31d416e43b2b)

### 3.2 EasyMesh HaLow Gateway

The objective is to configure HaLowLink1 in router mode to function as an EasyMesh HaLow Gateway running the EasyMesh Controller service. The figure below depicts our reference configuration.

wlan-prpl  is a HaLow AP interface in a lan network.

phy0-sta0 is a  2.4GHz Wi-Fi station interface in a wan network for internet uplink.

phy0-ap0 is a 2.4GHz Wi-Fi AP interface in lan network

WAN Ethernet port attached  in wan network.

LAN Ethernet port attached to the lan network.

EasyMesh HaLow Gateway configuration involves the following high level networking configuration steps (detailed steps shown in following sections):

1. Set up a lan network with a dhcp server with the IP range 192.168.12.x.
2. Set up a wan network with dhcp client service for the uplink internet.
3. Create a bridge interface br-prpl to serve the LAN network.
4. Create an AP interface wlan-prpl on HaLow radio and attach to br-prpl.
5. Create a station interface phy0-sta0 on 2.4GHz radio and add to wan for internet uplink.
6. Attach LAN and WAN Ethernet ports to lan and wan network respectively.
7. Create a lan and wan firewall zone which maps to lan and wan network.
8. Enable forwarding rules between lan and wan network allows lan clients to access the internet.
9. Enable prplMesh in Controller + Agent mode.

#### 3.2.1 How to Configure

The following steps use the Wizard to create the EasyMesh HaLow Gateway configuration outlined above:

1. Navigate to the Wizard option in the side menu.
2. HaLow Mode : Choose EasyMesh Controller option.
3. Network Mode allows us to choose the preferred uplink.
4. If you have a Wi-Fi route with 2.4 GHz radio, we can select “use 2.4GHz for an uplink”. And refer to the section on how to configure 2.4 GHz Wi-Fi as uplink.
5. If you prefer to use Ethernet as an uplink, select the first option.
6. Click Save & Apply and wait for successful initialization.

![](/files/ac1e16b37f04ab36c94855985df94809b4280b85)

#### 3.2.2 Controller Status

![](/files/5f2e9f5d59b244a336bffd78bf79be2fdd68c9fb)

To confirm the EasyMesh Controller is enabled properly, status information is available on the Home page under EasyMesh Controller card.

Agent status active shows a successful configuration of EasyMesh Controller

#### 3.2.3 Configure 2.4 GHz Wi-Fi as uplink

![](/files/34499babbd88498690c5eaabf140b6f800b4cb81)

Navigate to the Uplink (2.4 GHz) card from the Home page and click Disconnected cross or use the expand arrow to access the uplink configuration tab.

![](/files/6dffc24a51e6a06a3d11fb8576c90038a7180a47)

Clicking the search option lists available Wi-Fi networks. Choose your router’s SSID and update your network settings.

Click the Save & Apply button.

![](/files/6040db88231111cda097fd2dbcd4a349cbe01a56)

The uplink card status should change to Connected with a tick once the uplink connection is successfully established.

#### 3.2.4 UCI configuration (Optional)

Using the Wizard is easy but it skips over a lot of underlying detail that can help understanding what is going on. This section explains the underlying configuration changes made to setup the EasyMesh HaLow Gateway.  UCI configurations generated by following the steps represent the changes from sections from 3.2.1 to 3.2.3.

This section can be safely skipped for those that are not interested in the inner workings of UCI configurations.

At a high level configuring EasyMesh HaLow Gateway involves:

* changes in wireless UCI configuration
* configures HaLow radio,
* configures an access point interface(wlan-prpl) and attach to lan.
* configures 2.4GHz Wi-Fi radio,
* configures a station interface(phy0-sta0) and attach to wan
* changes in prplmesh UCI configuration,
* configures EasyMesh in Controller + Agent mode, and
* configures list of wifi-device and wifi-interface to be managed under EasyMesh
* changes in network UCI configuration,
* creates a network bridge called br-prpl, and
* attaches the lan network interface to bridge br-prpl.
* changes in firewall  UCI configuration,
* creates a firewall zone for the lan network, and
* enables  forwarding rules between lan and wan network.
* changes in dhcp UCI configuration
* runs a DHCP server in the lan network.
* runs a DHCP client in wan to receive an IP address from uplink router

The configuration files described below are located in the /etc/config/ directory.

| **wireless**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| UCI Configuration                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| <p> config wifi-device 'radio1'<br>  option type 'morse'<br>  option path \<GET FROM DEFAULTS><br>  option bcf  \<GET FROM DEFAULTS><br>  option band 's1g'<br>  option hwmode '11ah'<br>  option reconf '0'<br>  option country 'US'<br>  option channel '44'<br>config wifi-iface 'default\_radio1'<br>  option mode 'ap'<br>  option wds '1'<br>  option device 'radio1'<br>  option network 'lan'<br>  option ssid 'MorseMicro'<br>  option encryption 'sae-mixed'<br>  option key 'Morse\@123'<br>  option disabled '0'<br>  option bss\_transition '1'<br>  option multi\_ap '3'<br>  option ieee80211k '1'<br>  option ieee80211w '2'<br>  option ifname 'wlan-prpl'<br>  option wps\_virtual\_push\_button '1'<br>  option wps\_independent '0'<br>  option auth\_cache '0'</p> | <p>wifi-device config section radio1 refers to the physical HaLow radio in a device. The options present in this section describe properties common across all wireless interfaces on this radio device, such as country, channel.<br><br>wifi-iface config section provides a means to create an access point or station interface on a radio. This section contains interface specific properties like SSID and network credentials.<br>wifi-iface config section default\_radio1 creates an access point  interface wlan-prpl on a HaLow radio device radio1 and attaches it with a lan network.<br>The SSID and network credentials specified in this section are propagated to all EasyMesh Agent nodes in the network through the EasyMesh auto configuration process.<br></p> |
| **prplmesh**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><br> config prplmesh 'config'<br>  option management\_mode 'Multi-AP-Controller-and-Agent'<br>  option operating\_mode 'Gateway'<br>  option enable '1'<br>  option master '1'<br>  option gateway '1'<br>  option wired\_backhaul '1'<br> config wifi-device 'radio1'<br>  option hostap\_iface 'wlan-prpl'<br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | <p>The configuration section for prplmesh contains options that allow users to enable or disable EasyMesh, along with its associated features, and modify EasyMesh behaviour. <br>Most configurations in the prplmesh config section have default settings shared by both EasyMesh Controller and Agent. The example on the left highlights only the difference between EasyMesh Controller and Agent.<br>wifi-device section facilitates the addition of  wireless interfaces under EasyMesh management.<br>Example on the left adds AP interface wlan-prpl on HaLow radio device radio1 under EasyMesh management.<br>prplMesh expects radio1 and wlan-prpl to be preconfigured in the <a href="#h.jxnujhmh94dm">wireless</a> setting.<br></p>                                     |
| **network**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><br> config interface 'lan'<br>  option device 'br-prpl'<br>  option proto 'static'<br>  option ipaddr '192.168.12.1'<br>  option netmask '255.255.255.0'<br>  option ip6assign '60'<br> config interface 'wan'<br>  option proto 'dhcp'<br> config device<br>  option name 'br-prpl'<br>  option type 'bridge'<br>  option macaddr \<GET FROM DEFAULTS><br>  list ports 'usblan'<br>  list ports 'lan'<br></p>                                                                                                                                                                                                                                                                                                                                                                      | <p>interface config section provides a means to create a logical network interface.<br>In our example,<br>we create a lan network which is our primary local network in which we attach a HaLow AP interface (wlan-prpl).<br><br>We create a wan network and enable dhcp client for uplink internet connectivity to which we attach the 2.4GHz station interface(phy0-sta0) and WAN Ethernet port.<br>device config section allows us to create a linux network bridge to which we can attach our network ports.</p>                                                                                                                                                                                                                                                                 |
| **firewall**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><br>config zone<br>  option name 'lan'<br>  list network 'lan'<br>  option input 'ACCEPT'<br>  option output 'ACCEPT'<br>  option forward 'ACCEPT'<br>config zone<br>  option name 'wan'<br>  list network 'wan'<br>  option input 'REJECT'<br>  option output 'ACCEPT'<br>  option forward 'REJECT'<br>  option masq '1'<br>  option mtu\_fix '1'<br>config forwarding<br>  option src 'lan'<br>  option dest 'wan'<br>  option enabled '1'<br></p>                                                                                                                                                                                                                                                                                                                                 | <p><br>zone config section allows us to create a logical firewall zone which corresponds to a logical network we created in network config.<br>In our example,<br>We create a firewall zone for the lan network where we should allow input, output and forwarding network traffic.<br>We create a firewall zone for the wan network where we should allow only egress traffic.<br>forwarding config section allows to enable/disable the traffic flow between firewall zones.<br>In this example, we want to route the traffic between the lan to the wan zone which  enables devices on the lan network to access the internet.</p>                                                                                                                                                |
| **dhcp**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><br> config dnsmasq<br>  option domainneeded '1'<br>  option localise\_queries '1'<br>  option rebind\_localhost '1'<br>  option local '/lan/'<br>  option domain 'lan'<br>  option expandhosts '1'<br>  option cachesize '1000'<br>  option authoritative '1'<br>  option readethers '1'<br>  option localservice '1'<br>  option ednspacket\_max '1232'<br>config dhcp 'lan'<br>  option interface 'lan'<br>  option start '100'<br>  option limit '150'<br>  option leasetime '12h'<br>config dhcp 'wan'<br> option interface 'wan'<br> option ignore '1'</p>                                                                                                                                                                                                                     | <p>dhcp config allows us to configure dhcp server and instances in the logical network that we created in network config.<br>The  example shown here enables dhcp server in lan network and disables(option ignore) it in wan network.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |

***

### 3.3 EasyMesh HaLow Extender

The objective is to configure HaLowLink1 in extender mode to function as an EasyMesh HaLow Extender running EasyMesh agent service.

Setting up the HaLow Extender involves (detailed steps in the following sections):

1. Set up a LAN network and enable DHCP client service to receive IP from EasyMesh Gateway.
2. Create a bridge interface br-prpl to serve the LAN network.
3. Create a station interface (wlan-prpl-1) on HaLow radio and attach to br-prpl.
4. Create an AP interface (wlan-prpl) on HaLow radio and attach to br-prpl.
5. Create an AP interface (phy0-ap0) on 2.4GHz radio and attach to br-prpl.
6. Attach LAN and WAN Ethernet ports to br-prpl.
7. Attaching all these interfaces to br-prpl keeps them in the lan.
8. Enable prplMesh in Controller + Agent mode.

![](/files/63c9edc0be0a75c73fbb6d5ed30616c7738af305)

wlan-prpl-1  is a HaLow station interface in a lan network providing HaLow Backhaul Link connectivity with EasyMesh HaLow Gateway.

wlan-prpl  is a HaLow AP interface in a lan network to serve HaLow Clients and to further extend HaLow network

phy0-ap0 is a 2.4GHz Wi-Fi AP interface in lan network

WAN Ethernet port attached in lan network.

LAN Ethernet port attached to the lan network.

#### 3.3.1 How to Configure

EasyMesh Agent configuration in HaLowLink1 does not require a web interface. It is simplified into the following two steps:

1. Switch HaLowLink1 to extender mode. Refer to below section  3.3.2 Extender mode.
2. Use push button to pair this extender with another HaLowLink1 configured as EasyMesh Controller. Refer to below section 3.3.3 Pairing Extender with Gateway.

#### 3.3.2 Extender mode

1. Power on the HaLowLink1 that is to be configured as an extender.
2. Wait until the status LED turns solid green, indicating that the HaLowLink1 has been initialised.
3. Press and hold the mode button until the status LED starts flashing aqua. Initially, the LED will flash green slowly before transitioning to flashing aqua, signaling that the button can be released for extender mode configuration.
4. Wait for the status LED to turn solid aqua, which indicates the successful configuration of  extender mode.

![](/files/1a88def80bd52b84a2002713a4ee4a13cee73376)

#### 3.3.3 Pairing Extender with Gateway

This step allows the extender to connect with HaLowLink1 configured as EasyMesh Gateway.

1. Ensure the extender’s Status LED is in solid aqua mode.
2. Ensure the EasyMesh HaLow Gateway’s status LED in solid green.
3. Press and immediately release the mode button on the bottom of the extender and EasyMesh HaLow Gateway device at the same time.[\[a\]](#cmnt1)
4. At the start of the button press, the Wi-Fi HaLow LEDs on both devices will begin slowly flashing purple. Upon successful pairing, both devices will display a solid purple Wi-Fi HaLow LED.

![](/files/902c524d9c13f29a58cc78832986077486f47009)

#### 3.3.4 Agent Status

![](/files/874614b05b6466bf57f3ae9c5c771e2a642bd977)

To confirm the EasyMesh Agent is enabled properly, status information is available on the extender’s Home page under EasyMesh Agent card.

Agent status Active shows a successful configuration of EasyMesh Agent.

#### 3.3.5 UCI configuration (Optional)

This is an informative section intended to explain the EasyMesh Extender’s reference UCI configurations generated by following the steps from sections from 3.3.1 to 3.3.4.

This section can be safely skipped for those that are not interested in the inner workings of UCI configurations.

At a high level configuring EasyMesh Agent in extender mode involves,

* changes in wireless UCI configuration, which
* configures HaLow radio,
* configures a backhaul station interface,
* configures an access point interface and
* attaches the access point and station interface with the lan network.
* changes in prplmesh UCI configuration, which
* configures EasyMesh in Agent mode and
* configures list of wifi-device and wifi-interface (accesspoint and backhaul station) to be managed under EasyMesh
* changes in network UCI configuration, which
* creates a network bridge called br-prpl,
* attaches the lan network interface to bridge br-prpl.
* changes in firewall UCI configuration, which
* creates a firewall zone for the lan network.
* changes in dhcp UCI configuration, which
* runs a DHCP client in lan to receive ip address from a gateway.

***

| **wireless**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| UCI Configuration                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><br>config wifi-device 'radio1'<br>  option type 'morse'<br>  option path \<GET FROM DEFAULTS><br>  option bcf  \<GET FROM DEFAULTS><br>  option band 's1g'<br>  option hwmode '11ah'<br>  option reconf '0'<br>  option country 'US'<br>  option channel '44'<br>config wifi-iface 'default\_bh\_radio1'<br>  option device 'radio1'<br>  option disabled '0'<br>  option mode 'sta'<br>  option multi\_ap '1'<br>  option wds '1'<br>  option ifname 'wlan-prpl-1'<br>  option network 'lan'<br>config wifi-iface 'default\_radio1'<br>  option mode 'ap'<br>  option wds '1'<br>  option device 'radio1'<br>  option network 'lan'<br>  option ssid 'MorseMicro'<br>  option encryption 'sae-mixed'<br>  option key 'Morse\@123'<br>  option disabled '0'<br>  option bss\_transition '1'<br>  option multi\_ap '3'<br>  option ieee80211k '1'<br>  option ieee80211w '2'<br>  option ifname 'wlan-prpl'<br>  option wps\_virtual\_push\_button '1'<br>  option wps\_independent '0'<br>  option auth\_cache '0'<br></p> | <p><br>wifi-device config section radio1 refers to the physical HaLow radio in a device. The options present in this section describe properties common across all wireless interfaces on this radio device, such as country, channel.<br><br><br><br>wifi-iface config section default\_bh\_radio1 creates a backhaul station interface wlan-prpl-1 on a HaLow radio device radio1 and attaches it with a lan network. This interface is used  as a backhaul link.<br><br><br><br>wifi-iface config section default\_radio1 creates an access point  interface wlan-prpl on a HaLow radio device radio1 and attaches it with a lan network.<br>EasyMesh Agent configures wlan-prpl with the  SSID and network credentials received from  EasyMesh Controller during the Auto configuration process.<br>For standard EasyMesh operation, AP interface wlan-prpl and backhaul station interface wlan-prpl-1 must be connected to the same network, which in our case is lan.</p> |
| **prplmesh**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><br> config prplmesh 'config'<br>  option management\_mode 'Multi-AP-Agent'<br>  option operating\_mode 'WDS-Repeater'<br>  option enable '1'<br>  option master '0'<br>  option gateway '0'<br>  option wired\_backhaul '0'<br> config wifi-device 'radio1'<br>  option hostap\_iface 'wlan-prpl'<br>  option sta\_iface 'wlan-prpl-1'<br> <br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | <p>Most configurations in the prplmesh config section have default settings shared by both EasyMesh Controller and Agent. The example on the left highlights only the difference between EasyMesh Controller and Agent.<br>Example on the left adds AP interface wlan-prpl and backhaul station interface wlan-prpl-1 on HaLow radio device radio1 under EasyMesh management.<br>prplMesh expects radio1 , wlan-prpl and wlan-prpl-1 to be preconfigured in the <a href="#h.jxnujhmh94dm">wireless</a> setting.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| **network**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><br> config interface 'lan'<br>  option device 'br-prpl'<br>  option proto 'dhcp'<br>  option ipaddr '192.168.12.1'<br>  option netmask '255.255.255.0'<br>  option ip6assign '60'<br> config device<br>  option name 'br-prpl'<br>  option type 'bridge'<br>  option macaddr \<GET FROM DEFAULTS><br>  list ports 'usblan'<br>  list ports 'lan'<br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | <p><br>interface section creates a lan network attached to bridge br-lan, configured to run a dhcp client.<br><br><br><br>device section creates a linux network bridge br-lan and attaches lan network port to it.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| **firewall**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><br>config zone<br>  option name 'lan'<br>  list network 'lan'<br>  option input 'ACCEPT'<br>  option output 'ACCEPT'<br>  option forward 'ACCEPT'<br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | <p>This example config creates a  network zone for lan which is our primary local network where we should allow input, output and forwarding network traffic.<br>forwarding config section is not needed as the backhaul station interface wlan-prpl-1 is attached to the lan network.<br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| **dhcp**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><br> config dhcp 'lan'<br>  option interface 'wan'<br>  option ignore '1'</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | This section disables the DHCP server in the lan network.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |

***

## 4 How to Verify

To verify the successful configuration of Easymesh we can verify each of the below features of EasyMesh are working:

* Unified network credentials across all HaLow APs.
* EasyMesh Topology Tree

### 4.1 Unified network credentials

All HaLow AP's are managed by controller and agent within an EasyMesh network. After the initial pairing process, they are configured with the same SSID and network credentials to ensure seamless connectivity.

To verify the configuration

1. Login to EasyMesh extender node’s web UI.
2. we can find the extender’s IP address by clicking the DHCP Leases option under the Local Network card on the Home page.
3. Navigate to the Quick Config page.
4. Check the SSID and network credentials for the HaLow AP interface (wlan-prpl) match the EasyMesh Gateway’s credentials.

![](/files/620b8bb3153a5b1322d0ce7becdb78861cf2e022)

#### 4.1.1 EasyMesh Auto Configuration

In an optimal EasyMesh network deployment, network credentials should propagate seamlessly to all EasyMesh agents without causing any disruption. However, since a single HaLow AP is used to serve both fronthaul clients and HaLow extenders, any changes made to the AP credentials on the HaLow Gateway will necessitate manual reconfiguration of the extender.

***

### 4.2 EasyMesh Topology Tree

We can view the complete topology of the EasyMesh network through the EasyMesh Gateway’s web UI. Simply navigate to the EasyMesh Controller card on the home page and click the expand option to display the network topology. This page becomes accessible when at least one extender node is connected to the controller.

![](/files/e039ca2595fd20ee1c4c1a83fee902b3324480e8)

### 4.3 Read-Only Quick Config Page

The configuration options for EasyMesh-managed wireless interfaces on the Quick Config page are set to read-only to prevent potential misconfigurations that could disrupt normal EasyMesh functionality. To modify the SSID or network credentials for HaLow interfaces, navigate to the Network-> Wireless page.

Ideally, the SSID, security mode, and network key should be editable in the HaLow Gateway’s Quick Config page. However, this limitation in the web UI is not addressed until the OpenWrt 2.8.x release.

***

### 4.4 Useful Commands

List the prplMesh applications

root\@halowlink1-b19b:\~# ps | grep prpl

&#x20;9426 root     15700 S    /opt/prplmesh/bin/ieee1905\_transport

&#x20;9427 root     22520 S    /opt/prplmesh/bin/beerocks\_controller

&#x20;9428 root     21844 S    /opt/prplmesh/bin/beerocks\_agent

&#x20;9474 root     17376 S    /opt/prplmesh/bin/beerocks\_fronthaul -i wlan-prpl

Enable prplMesh debug logs

1. To collect logs syslog (logread), set log\_syslog\_enabled to true in beerocks\_controller.conf and beerocks\_agent.conf located in /opt/prplmesh/config.
2. To collect logs in a text file, set log\_files\_enabled to
3. in the same configuration files, and use the log\_files\_path option to specify the desired file path.

Command line Topology view

1. We can use beerocks\_cli to dump the EasyMesh network.

root\@halowlink1-b19b:\~# /opt/prplmesh/bin/beerocks\_cli -c bml\_conn\_map

GW\_BRIDGE: name: GW\_MASTER, mac: f2:flag\_bb:43:dc:f6:39, ipv4: 192.168.12.1

&#x20;ETHERNET: mac: 3b:f6:dc:43:bb:f2

&#x20;RADIO: wlan-prpl mac: 94:flag\_bb:43:dc:f6:39, ch: 44, bw: 8 S1G, freq: 924 MHz

&#x20; bVAP\[0]: wlan-prpl.0 bssid: 94:flag\_bb:43:dc:f6:39, ssid: halowlink1-b19b

&#x20;  IRE\_BACKHAUL: mac: 96:flag\_bb:43:dc:f9:89, ch: 44, bw: 8 S1G

&#x20;   IRE\_BRIDGE: name: IRE\_f9:89, mac: f2:flag\_bb:43:dc:f9:89, ipv4: 10.22.121.111

&#x20;    ETHERNET: mac: 8b:f9:dc:43:bb:f2

&#x20;    RADIO: wlan-prpl mac: 94:flag\_bb:43:dc:f9:89, ch: 44, bw: 8 S1G, freq: 924 MHz

&#x20;     bVAP\[0]: wlan-prpl.0 bssid: 94:flag\_bb:43:dc:f9:89, ssid: halowlink1-b19b

2. We can use the below command to dump the EasyMesh Wi-Fi data elements.\
   root\@halowlink1-b19b:\~# ubus call Device \_get '{"depth":10}'

## 6 Revision History

| Release Number | Release Date | Release Notes   |
| -------------- | ------------ | --------------- |
| 01             | 11/04/2025   | Initial release |
