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)
2. [MMX CLI](#example2)
- [Configure AP via MMX CLI](#configure-access-point-via-mmx-cli)
3. [MMX Web UI](#mmx-web-interface-web-ui)
- [Configure AP via Web UI](#configure-access-point-via-web-ui)
4. [OpenWrt config files and MMX](#openwrt-config-files-and-mmx)
# General
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
......@@ -36,13 +42,10 @@ root@prplWrt:~# mmx-cli
>
```
`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:
```
......@@ -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
For configurin Access Point (AP) you need to enter in `acesspoints ap` submenu:
```
> mmx prplmesh accesspoints ap
```
Use `?` for getting help output.
......@@ -90,30 +91,33 @@ Access Point Index: 1 SSID: prplMesh MultiApMode: Fronthaul
Band2_4G: false
Band5GL: false Band5GH: false Band6G: false
```
The next step is changing `SSID` via `config` command.
`For multi-instance objects need to put index number after confog keyword.`
The next step is changing `SSID` via `config` command. `For multi-instance objects need to put index number after confog keyword.`
Set SSID
```
mmx/prplmesh/accesspoints/ap> config 1 ssid "GL-NET-5Ghz"
Operation completed successfully
```
Set band
```
mmx/prplmesh/accesspoints/ap> config 1 band5gh true
Operation completed successfully
```
Set security mode. `You need to change submenu on accesspoints/security.`
```
mmx/prplmesh/accesspoints/security> config 1 modeenabled "WPA2-Personal"
Operation completed successfully
```
Set passphrase
```
mmx/prplmesh/accesspoints/security> config 1 keypassphrase "testpassphrase"
Operation completed successfully
......@@ -121,8 +125,7 @@ Operation completed successfully
# MMX Web Interface (Web UI)
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:
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:
![image](uploads/4596618e9032db60d75393616f290e3d/image.png)
......@@ -143,6 +146,7 @@ MMX Core contains feature for saving OpenWrt config files from `/etc/config` and
## Saving config files via MMX-CLI
To save config files, from the busybox shell do:
```
echo mmx prplmesh board_settings mmx_settings config saveconfig true | mmx-cli
```
......@@ -164,6 +168,7 @@ MMX stores logs in `/var/log/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:
```
rm -rf /overlay/upper/etc/mmx
reboot
......
......