Repository navigation
WiFi
The MOD devices have no built-in Wi-Fi, but the Starless images support USB Wi-Fi dongles plugged into the USB host port of the MOD Dwarf, the MOD Duo X and the MOD Duo. With a supported dongle (see Compatibility) the device can:
- join your Wi-Fi networks, so you can open the web interface from any device on the same network
- become an access point, so a phone or tablet can reach the web interface without a router, for example on stage or in the rehearsal room
The driver and the tools are included in the image starting from Starless 18 on the Dwarf, and from Starless 19 on the Duo X and the Duo: there is nothing to install. Plug in the dongle and configure it from the web interface.
Experimental. Wi-Fi on the MOD devices is not an official MOD feature. Network traffic uses some CPU. Test your pedalboards with Wi-Fi active before relying on it on stage.
Open the web interface, click the settings icon in the bottom bar (Go to settings screen), or open
http://<dwarf address>/settings, then select the WiFi tab.
The tab is shown only on images that include the Wi-Fi support.

The first section shows the current state, for example Connected to "Home" (192.168.0.151).,
and the information about the dongle:
| Field | Meaning |
|---|---|
| Adapter | manufacturer, product and USB ID of the dongle |
| Chip | chip and firmware version |
| Driver |
rtl8xxxu (alabs-mod-wifi) is the Starless driver, (kernel) the original driver of the image |
| Access point | whether the dongle supports the access point mode, and how many clients it accepts |
| Signal, Speed | quality of the connection to your network (client mode) |
| Clients | devices connected to the access point (access point mode) |
The list of the networks the Dwarf connects to, in order of priority: the Dwarf connects to the first network of the list that is in range.
- ▲ ▼ change the priority of a network
- the trash icon removes a network
-
State shows
connected,in rangeornot in range
Changes are saved immediately. Passwords are never shown and are not stored in clear text. Hidden networks are not supported.
Click Add to add a network. The Dwarf scans the networks around it as soon as the dialog opens:

- double click a network of the list to copy its name, or type the name in Name (SSID)
- type the Password (8 to 63 characters; leave it empty for an open network). The eye icon shows it while you type
- click Save
The new network is added at the end of the list. If the network is already in the list, its
password is changed. ↻ scans again. Networks already in the list are marked as in the list.
The scan is not available while the access point is on. Networks changed while the access point is on are used when it is switched off.
The settings of the network that the Dwarf creates when the access point is on:
- Name (SSID): the name of the network
- Password: the WPA2 password, 8 to 63 characters
- Channel: the 2.4 GHz channel, 1 to 11
Click Save to store them. They are applied the next time the access point is switched on.
The default name is the name of the device (
moddwarf,modduoxormodduo) and the default password isstarless, the same on every device: change them.
The access point is switched on and off from the device, see below.
On the device, open the settings menu and select WIFI. The pictures below are taken on the Dwarf: the Duo X and the Duo have the same page, and show the Wi-Fi state in the title of the control screen.
The page shows three items:
-
WIFI IP: the address of the Dwarf on the Wi-Fi network: the address received from your network in
client mode,
192.168.60.1when the access point is on.NOT CONNECTEDwhen the Dwarf is not connected to any network,NO DEVICEwhen no dongle is plugged in. -
ACCESS POINT: switches the access point on and off. Turn the knob to choose ON or OFF,
then click it.
N/Ameans that the dongle does not support the access point mode. -
AP STATUS: the state of the access point:
OFF,STARTING,ONwith the network name,STOPPING,FAILED(the last switch did not work),NOT SUPPORTEDorNO WIFI.
Before switching, the Dwarf asks for a confirmation, because the Wi-Fi connection drops for a few seconds. Choose OK to switch, CANCEL to leave it as it is:
Starting the access point takes a few seconds: AP STATUS shows STARTING, then ON with the
network name.
The access point is always off when the Dwarf starts: after a reboot the Dwarf joins your Wi-Fi networks again.
When a Wi-Fi dongle is plugged in, an icon in the top right corner of the title bar shows the Wi-Fi state, so you don't need to open the settings to check it:
| Title bar | Wi-Fi state |
|---|---|
![]() |
connected to one of your Wi-Fi networks |
![]() |
dongle plugged in, but not connected to any network |
![]() |
access point on |
![]() |
no icon: no Wi-Fi dongle plugged in |
The icon is not updated continuously: the Dwarf reads the Wi-Fi state when you leave the settings menu, when a pedalboard is loaded (also at startup) and, while the access point is starting or stopping, every 2 seconds. If the connection to your network drops, the icon changes at the next of these events.
While the access point is on, the LED of the shift button (the button on the left of the display) is blue, in control mode and on the WIFI settings page. You can see that the access point is on also from a distance, for example on stage:
In the photo the access point is on: AP in the title bar and the blue LED on the left of the display.
- switch the access point on from the Dwarf (SETTINGS > WIFI > ACCESS POINT), and wait for the
APicon in the title bar and the blue LED - connect the phone to the network of the Dwarf (the Name (SSID) of the access point settings)
- open
http://192.168.60.1in the browser. Where the browser supports it,http://moddwarf.localworks too
Notes:
- the access point has no internet access: when the phone asks, choose to stay connected to the network
- if the phone also knows a Wi-Fi network with internet in range (for example your home network), it may switch to it on its own, often while the screen is off. Disable the automatic connection to that network while you use the Dwarf
- with the RTL8188EU dongles the access point accepts one client at a time
The USB cable connection (192.168.51.1) keeps working as before, in both modes.
The official Dwarf kernel (6.1.15-rt7-moddwarf) has no working driver for the most common USB
dongles. Its rtl8xxxu driver does not recognize them, and the older r8188eu driver freezes the whole
device a few seconds after the dongle is plugged in.
The Starless image adds:
- the
rtl8xxxudriver taken from Linux 6.6, backported to the Dwarf kernel. It is installed next to the original one, so the kernel itself is not modified - a few patches to make it more robust on the Dwarf (retries when the USB transfers or the firmware download fail) and an experimental access point mode for the RTL8188EU chip
- the Realtek firmware files from linux-firmware, which are not part of the official image, and the Wi-Fi regulatory database
-
wifi-ap, the tool that switches the dongle between client and access point mode, used by the web interface and by the device settings
The sources, the patches and all the technical details are in the alabs-mod-wifi repository.
Tested only with my dongle: a Realtek RTL8188EUS, USB ID
0bda:8179(sold as "802.11n NIC"). The other chips and IDs below are supported by the driver, but they have never been tested on the Dwarf. Reports are welcome: open an issue with the USB ID and the result.
| Chip | USB IDs and known devices | Access point | Max AP clients | Tested on the Dwarf |
|---|---|---|---|---|
| RTL8188EU RTL8188EUS RTL8188ETV |
0bda:81790bda:0179 (8188ETV)0bda:ffef Rosewill USB-N150 Nano0df6:0076 Sitecom2001:3311 D-Link USB-GO-N1502001:330f D-Link DWA-125 rev D12001:3310 D-Link DWA-123 rev D12001:331b D-Link DWA-121 rev B107b8:8179 Abocom056e:4008 Elecom WDC-150SU2M2357:010c TP-Link TL-WN722N v22357:0111 TP-Link TL-WN727N v5.212c4e:0102 Mercusys MW150US v20b05:18f0 ASUS USB-N10 Nano B17392:b811 Edimax EW-7811Un V2 |
yes, experimental | 1 | ✔ 0bda:8179
|
| RTL8188FU RTL8188FTV |
0bda:f179 |
yes | 15 | no |
| RTL8192EU |
0bda:818b2357:0108 TP-Link TL-WN822N v42357:0109 TP-Link2001:3319 D-Link DWA-131 rev E1 |
yes | 127 | no |
| RTL8192FU |
0bda:f192 Comfast CF-826F0bda:318b0b05:18f1 ASUS USB-N13 rev C17392:b722 Edimax |
yes | 127 | no |
| RTL8710BU (RTL8188GU) |
0bda:b7110bda:2005 TOTOLINK N150UA V5 / N150UA-B |
yes | 15 | no |
| RTL8723BU |
0bda:b7207392:a611 Edimax |
yes | 127 | no |
| RTL8723AU |
0bda:87240bda:17240bda:0724
|
no | - | no |
Notes:
- All the dongles work only on the 2.4 GHz band.
- RTL8188CU, RTL8192CU and the other chips that the upstream driver marks as "untested" are not supported. Dongles with other chipsets (MediaTek, Ralink, Atheros, ...) are not supported either.
- Be careful when buying: the same commercial model is sometimes sold with different chipsets (look for "v1", "v2", "v3" on the label). Always check the USB ID.
To read the USB ID of a dongle, plug it into a Linux PC and run lsusb:
Bus 001 Device 007: ID 0bda:8179 Realtek Semiconductor Corp. RTL8188EUS 802.11n Wireless Network Adapter
Here the ID is 0bda:8179. When the dongle is plugged into the Dwarf, the web interface shows the ID
in the Adapter line of the Wi-Fi settings (see Settings in the web interface).
The alabs-mod-wifi repository contains the driver sources and
patches, how the driver was backported to the Dwarf kernel, the manual installation, the wifi-ap
commands and the troubleshooting of the access point.



