7867b5c950
All checks were successful
ci/woodpecker/push/woodpecker Pipeline was successful
- Enable bridge VLAN filtering on CAP for proper per-client VLAN assignment - Fix AdGuard container IP conflicts (.2→.10, .3→.11) with static IPs - Fix 2.4GHz co-channel interference (both APs were on ch 1, CAP now ch 6) - Fix 5GHz overlap (HAP ch 36/5180, CAP moved to ch 52/5260) - Update WiFi access-list: VLAN assignment now active with per-device VLAN IDs - Add Xiaomi Air Purifier MC1 to VLAN 30 access-list Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
6.7 KiB
6.7 KiB
WiFi and CAPsMAN Configuration
Last Updated: 2026-02-26 Purpose: Document WiFi network settings, CAPsMAN configuration, and device compatibility requirements
Network Overview
| SSID | Band | Purpose | Password |
|---|---|---|---|
| XTRM | 5GHz | Primary network (fast devices) | M0stW4nt3d@home |
| XTRM2 | 2.4GHz | IoT/Legacy devices | M0stW4nt3d@IoT |
XTRM (5GHz) - wifi1
Target: Modern devices (phones, laptops, tablets)
| Setting | Value |
|---|---|
| SSID | XTRM |
| Band | 5GHz |
| Mode | 802.11ax (WiFi 6) |
| Channel | 5180 MHz (ch 36) |
| Width | 40MHz |
| Security | WPA2-PSK + WPA3-PSK |
| Cipher | CCMP (AES) |
| 802.11r (FT) | Enabled |
| Password | M0stW4nt3d@home |
XTRM2 (2.4GHz) - wifi2
Target: IoT devices, legacy devices, smartwatches
CRITICAL COMPATIBILITY REQUIREMENTS
Some devices (Tuya JMWZG1 gateway, Amazfit TREX3, iPad 2) require legacy settings:
| Setting | Value | Reason |
|---|---|---|
| SSID | XTRM2 | |
| Band | 2.4GHz | IoT compatibility |
| Mode | 802.11g | Legacy device support |
| Channel | 1 (2412 MHz) | Most compatible |
| Width | 20MHz | Required for old devices |
| Security | WPA-PSK + WPA2-PSK | WPA needed for legacy |
| Cipher | TKIP + CCMP | TKIP required for old devices |
| 802.11r (FT) | Disabled | Causes issues with IoT |
| Password | M0stW4nt3d@IoT |
Devices Requiring WPA + TKIP
| Device | MAC Address | Model | Notes |
|---|---|---|---|
| Roborock S7 Vacuum | B0:4A:39:3F:9A:14 | S7 | Requires WPA+TKIP |
| Amazfit TREX3 | TBD | Smartwatch | Requires WPA+TKIP |
| Tuya Smart Gateway | 38:1F:8D:04:6F:E4 | JMWZG1 | Requires WPA+TKIP |
| iPad 2 | TBD | A1395/A1396 | Legacy device |
RouterOS Commands for XTRM2
# Working configuration for legacy devices
/interface wifi set wifi2 \
channel.frequency=2412 \
channel.band=2ghz-g \
channel.width=20mhz \
security.authentication-types=wpa-psk,wpa2-psk \
security.encryption=tkip,ccmp \
security.ft=no \
security.ft-over-ds=no \
security.passphrase="M0stW4nt3d@IoT"
Fallback (Maximum Compatibility)
If devices still can't connect, use WPA-only with TKIP-only:
/interface wifi set wifi2 \
security.authentication-types=wpa-psk \
security.encryption=tkip
CAPsMAN Configuration
Manager (HAP ax³ - 192.168.10.1)
| Setting | Value |
|---|---|
| Enabled | Yes |
| Interfaces | bridge, vlan10-mgmt |
| Certificate | Auto-generated |
CAP Device (cAP XL ac - 192.168.10.2)
| Setting | Value |
|---|---|
| caps-man-addresses | 192.168.10.1 |
| discovery-interfaces | bridgeLocal |
| slaves-datapath | capdp (bridge=bridgeLocal, vlan-id=40) |
| certificate | request |
| RouterOS | 7.21.1 |
| SSH Port | 2222 |
| SSH (via proxy) | See ProxyJump command below |
SSH Access: Direct SSH to CAP is unreliable. Use ProxyJump through Unraid:
ssh -o ProxyCommand="ssh -i ~/.ssh/id_ed25519_unraid -p 422 -W %h:%p root@192.168.10.20" -i ~/.ssh/mikrotik_key -p 2222 xtrm@192.168.10.2
CAP Bridge VLAN Filtering
The CAP runs bridge VLAN filtering to properly tag/untag WiFi client traffic before sending it to the HAP over the trunk link (ether1):
| Setting | Value |
|---|---|
| bridgeLocal | vlan-filtering=yes, pvid=10 |
| ether1 (trunk) | bridge port, PVID=10 |
| wifi1, wifi2 | dynamic bridge ports, PVID=40 (set by datapath vlan-id) |
Bridge VLAN Table:
| VLAN | ether1 | wifi1 | wifi2 | bridgeLocal | Purpose |
|---|---|---|---|---|---|
| 10 | untagged | - | - | untagged | Management |
| 20 | tagged | tagged | tagged | - | Trusted |
| 25 | tagged | tagged | tagged | - | Kids |
| 30 | tagged | tagged | tagged | - | IoT |
| 35 | tagged | tagged | tagged | - | Cameras |
| 40 | tagged | untagged | untagged | - | CatchAll (default) |
CAP Interfaces
| Interface | Radio | Band | SSID | Security | Status |
|---|---|---|---|---|---|
| cap-wifi1 | wifi2 | 5GHz | XTRM | WPA2/WPA3-PSK, CCMP | Working (Ch 52/5260, 40MHz, DFS) |
| cap-wifi2 | wifi1 | 2.4GHz | XTRM2 | WPA2-PSK, CCMP | Working (Ch 6/2437, 20MHz) |
Note: cap-wifi2 uses WPA2+CCMP only (not WPA+TKIP like HAP's local wifi2). Legacy IoT devices requiring TKIP will only work on HAP1's local wifi2.
WiFi Access List
Status: VLAN assignment via access list is active. Each entry has a vlan-id that assigns the device to the correct VLAN upon WiFi association. This works on both HAP (local) and CAP (remote, via bridge VLAN filtering).
30+ entries configured (MAC-based accept rules with VLAN IDs + 1 default catch-all):
| # | MAC | Device | VLAN |
|---|---|---|---|
| 0 | AA:ED:8B:2A:40:F1 | Samsung S25 Ultra - Kaloyan | 20 |
| 1 | 82:6D:FB:D9:E0:47 | MacBook Air - Nora | 20 |
| 12 | CE:B8:11:EA:8D:55 | MacBook - Kaloyan | 20 |
| 13 | BE:A7:95:87:19:4A | MacBook 5GHz - Kaloyan | 20 |
| 27 | B8:27:EB:32:B2:13 | RecalBox RPi3 | 25 |
| 28 | CC:5E:F8:D3:37:D3 | ASUS ROG Ally - Kaloyan | 20 |
| 31 | C8:5C:CC:40:B4:AA | Xiaomi Air Purifier 2 | 30 |
| 32 | (any) | Default - VLAN40 | 40 (catch-all) |
Default behavior: Devices not in the access list get VLAN 40 (CatchAll) via the default rule and the datapath vlan-id=40.
Show Full Access List
/interface wifi access-list print
Troubleshooting
Device can see XTRM2 but can't connect
- Check security settings - device may need WPA (not WPA2)
- Check cipher - device may need TKIP (not CCMP/AES)
- Try 802.11g mode instead of 802.11n
- Use channel 1, 6, or 11
Device connects but disconnects immediately
- Check if 802.11r (Fast Transition) is disabled
- Check VLAN assignment - CAP clients need special rule
- Check channel width - use 20MHz for stability
CAP not connecting to CAPsMAN
- Check certificate - remove old cert and re-request
- Check firewall - ports 5246-5247 UDP must be open
- Check interface binding - CAPsMAN must listen on correct interface
Backup Files
| File | Location | Purpose |
|---|---|---|
| wifi-backup-working.rsc | Router files | WiFi config export |
| config-backup-working.backup | Router files | Full system backup |
Quick Reference
Show WiFi status
/interface wifi print
/interface wifi monitor wifi2 once
/interface wifi registration-table print
Show security settings
/interface wifi security print detail
:put [/interface wifi get wifi2 security.authentication-types]
:put [/interface wifi get wifi2 security.encryption]
Check CAPsMAN
/interface wifi capsman print
/interface wifi capsman remote-cap print