Skip to content
Andrea Del Signore edited this page Nov 15, 2026 · 5 revisions

Wi-Fi

MOD Duo: available MOD Duo X: available MOD Dwarf: available

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.

Settings in the web interface

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.

Web interface: WiFi settings

WiFi

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)

WiFi networks

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 range or not 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:

Web interface: add a WiFi network

  1. double click a network of the list to copy its name, or type the name in Name (SSID)
  2. type the Password (8 to 63 characters; leave it empty for an open network). The eye icon shows it while you type
  3. 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.

Access point

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, modduox or modduo) and the default password is starless, the same on every device: change them.

The access point is switched on and off from the device, see below.

Settings on the device

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.1 when the access point is on. NOT CONNECTED when the Dwarf is not connected to any network, NO DEVICE when 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/A means that the dongle does not support the access point mode.
  • AP STATUS: the state of the access point: OFF, STARTING, ON with the network name, STOPPING, FAILED (the last switch did not work), NOT SUPPORTED or NO 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.

Wi-Fi state on the main screen

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.

The blue LED

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.

Connecting a phone or a tablet to the access point

  1. switch the access point on from the Dwarf (SETTINGS > WIFI > ACCESS POINT), and wait for the AP icon in the title bar and the blue LED
  2. connect the phone to the network of the Dwarf (the Name (SSID) of the access point settings)
  3. open http://192.168.60.1 in the browser. Where the browser supports it, http://moddwarf.local works 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.

Where the Wi-Fi driver comes from

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 rtl8xxxu driver 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.

Compatibility

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:8179
0bda:0179 (8188ETV)
0bda:ffef Rosewill USB-N150 Nano
0df6:0076 Sitecom
2001:3311 D-Link USB-GO-N150
2001:330f D-Link DWA-125 rev D1
2001:3310 D-Link DWA-123 rev D1
2001:331b D-Link DWA-121 rev B1
07b8:8179 Abocom
056e:4008 Elecom WDC-150SU2M
2357:010c TP-Link TL-WN722N v2
2357:0111 TP-Link TL-WN727N v5.21
2c4e:0102 Mercusys MW150US v2
0b05:18f0 ASUS USB-N10 Nano B1
7392:b811 Edimax EW-7811Un V2
yes, experimental 1 ✔ 0bda:8179
RTL8188FU
RTL8188FTV
0bda:f179 yes 15 no
RTL8192EU 0bda:818b
2357:0108 TP-Link TL-WN822N v4
2357:0109 TP-Link
2001:3319 D-Link DWA-131 rev E1
yes 127 no
RTL8192FU 0bda:f192 Comfast CF-826F
0bda:318b
0b05:18f1 ASUS USB-N13 rev C1
7392:b722 Edimax
yes 127 no
RTL8710BU
(RTL8188GU)
0bda:b711
0bda:2005 TOTOLINK N150UA V5 / N150UA-B
yes 15 no
RTL8723BU 0bda:b720
7392:a611 Edimax
yes 127 no
RTL8723AU 0bda:8724
0bda:1724
0bda: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).

More information

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.

Clone this wiki locally