Skip to content
Update prplMesh UI using MMX authored by Frederik Van Bogaert's avatar Frederik Van Bogaert
| Important |
|-----------|
| :exclamation: **MMX is obsolete!**. It's support is unmaintained and (as of v3.2) removed from the CI. Please use a solution based on amx-fcgi instead, such as the prplOS web UI or the [topologyViewer](https://gitlab.com/prpl-foundation/prplmesh/topologyviewer). |
1. [General](#General) 1. [General](#General)
2. [MMX CLI](#example2) 2. [MMX CLI](#example2)
- [Configure AP via MMX CLI](#configure-access-point-via-mmx-cli) - [Configure AP via MMX CLI](#configure-access-point-via-mmx-cli)
3. [MMX Web UI](#mmx-web-interface-web-ui) 3. [MMX Web UI](#mmx-web-interface-web-ui)
- [Configure AP via Web UI](#configure-access-point-via-web-ui) - [Configure AP via Web UI](#configure-access-point-via-web-ui)
4. [OpenWrt config files and MMX](#openwrt-config-files-and-mmx) 4. [OpenWrt config files and MMX](#openwrt-config-files-and-mmx)
# General # General
New prplMesh WebUI and CLI are implemented using [MMX](https://github.com/InangoSystems) which has been developed by [Inango Systems LTD.]() New prplMesh WebUI and CLI are implemented using [MMX](https://github.com/InangoSystems) which has been developed by [Inango Systems LTD.]()
MMX is a router management system which provides access to board via several management protocols MMX is a router management system which provides access to board via several management protocols
...@@ -36,13 +42,10 @@ root@prplWrt:~# mmx-cli ...@@ -36,13 +42,10 @@ root@prplWrt:~# mmx-cli
> >
``` ```
`To get help about menu items, command params and etc. you may type ? or press Tab` `To get help about menu items, command params and etc. you may type ? or press Tab`
It's possible to enter on each level of menu hierarchy or type full command in one line, for example: It's possible to enter on each level of menu hierarchy or type full command in one line, for example:
``` ```
...@@ -56,12 +59,10 @@ ID: 94:83:c4:02:7d:df NumberOfDevices: 1 ControllerID: 94:83:c4:02:7d:df ...@@ -56,12 +59,10 @@ ID: 94:83:c4:02:7d:df NumberOfDevices: 1 ControllerID: 94:83:c4:02:7d:df
## Configure Access Point via MMX CLI ## Configure Access Point via MMX CLI
For configurin Access Point (AP) you need to enter in `acesspoints ap` submenu: For configurin Access Point (AP) you need to enter in `acesspoints ap` submenu:
``` ```
> mmx prplmesh accesspoints ap > mmx prplmesh accesspoints ap
``` ```
Use `?` for getting help output. Use `?` for getting help output.
...@@ -90,30 +91,33 @@ Access Point Index: 1 SSID: prplMesh MultiApMode: Fronthaul ...@@ -90,30 +91,33 @@ Access Point Index: 1 SSID: prplMesh MultiApMode: Fronthaul
Band2_4G: false Band2_4G: false
Band5GL: false Band5GH: false Band6G: false Band5GL: false Band5GH: false Band6G: false
``` ```
The next step is changing `SSID` via `config` command. The next step is changing `SSID` via `config` command. `For multi-instance objects need to put index number after confog keyword.`
`For multi-instance objects need to put index number after confog keyword.`
Set SSID Set SSID
``` ```
mmx/prplmesh/accesspoints/ap> config 1 ssid "GL-NET-5Ghz" mmx/prplmesh/accesspoints/ap> config 1 ssid "GL-NET-5Ghz"
Operation completed successfully Operation completed successfully
``` ```
Set band Set band
``` ```
mmx/prplmesh/accesspoints/ap> config 1 band5gh true mmx/prplmesh/accesspoints/ap> config 1 band5gh true
Operation completed successfully Operation completed successfully
``` ```
Set security mode. `You need to change submenu on accesspoints/security.` Set security mode. `You need to change submenu on accesspoints/security.`
``` ```
mmx/prplmesh/accesspoints/security> config 1 modeenabled "WPA2-Personal" mmx/prplmesh/accesspoints/security> config 1 modeenabled "WPA2-Personal"
Operation completed successfully Operation completed successfully
``` ```
Set passphrase Set passphrase
``` ```
mmx/prplmesh/accesspoints/security> config 1 keypassphrase "testpassphrase" mmx/prplmesh/accesspoints/security> config 1 keypassphrase "testpassphrase"
Operation completed successfully Operation completed successfully
...@@ -121,8 +125,7 @@ Operation completed successfully ...@@ -121,8 +125,7 @@ Operation completed successfully
# MMX Web Interface (Web UI) # MMX Web Interface (Web UI)
MMX Web replaces LuCI Web so you need to open page: `http://ROUTER-LAN-IP/` MMX Web replaces LuCI Web so you need to open page: `http://ROUTER-LAN-IP/` (by default it's `http://192.168.1.1/`). After loading you should see authentication screen screen:
(by default it's `http://192.168.1.1/`). After loading you should see authentication screen screen:
![image](uploads/4596618e9032db60d75393616f290e3d/image.png) ![image](uploads/4596618e9032db60d75393616f290e3d/image.png)
...@@ -143,6 +146,7 @@ MMX Core contains feature for saving OpenWrt config files from `/etc/config` and ...@@ -143,6 +146,7 @@ MMX Core contains feature for saving OpenWrt config files from `/etc/config` and
## Saving config files via MMX-CLI ## Saving config files via MMX-CLI
To save config files, from the busybox shell do: To save config files, from the busybox shell do:
``` ```
echo mmx prplmesh board_settings mmx_settings config saveconfig true | mmx-cli echo mmx prplmesh board_settings mmx_settings config saveconfig true | mmx-cli
``` ```
...@@ -164,6 +168,7 @@ MMX stores logs in `/var/log/mmx`. ...@@ -164,6 +168,7 @@ MMX stores logs in `/var/log/mmx`.
MMX stores some of its information in `/etc/mmx`. MMX stores some of its information in `/etc/mmx`.
If you have some troubles getting it to work (for example, following the rename of `Controller` to `Device.Wifi.DataElements`), remove the configuration from the overlay and reboot: If you have some troubles getting it to work (for example, following the rename of `Controller` to `Device.Wifi.DataElements`), remove the configuration from the overlay and reboot:
``` ```
rm -rf /overlay/upper/etc/mmx rm -rf /overlay/upper/etc/mmx
reboot reboot
... ...
......