Skip to content

Setup Access Point

Jump to bottom
Lina edited this page Mar 16, 2023 · 3 revisions

Installing WiMoVE

  1. Find out what architecture your access point is by looking it up on the OpenWRT wiki.
  2. Download the package for the matching architecture for your access point. You find the package in the artifacts of the build pipeline or you can cross-compile it yourself.
  3. Verify that you have ssh connectivity to the access point. OpenWRT guide for ssh
  4. Copy the package via SCP from your computer to the access point scp -O <Path to WiMoVE on your machine> <access-point>
  5. Login via ssh on to your access point.
  6. Install the package on your access point via opkg update && opkg install <Path to WiMoVE>. An internet connection is required for this step in order to fetch dependencies.
  7. Run wimove. You should see an error message, which shows that wimove is successfully installed.

FRR

  1. Install frr via opkg update && opkg install frr-bgpd frr-zebra frr-watchfrr frr-vtysh
  2. Copy sample-configs/access-points/daemons and sample-configs/access-points/frr.conf to the directory /etc/frr/.
  3. Replace placeholder values in sample configs with actual values. Placeholder values are marked with <>.
  4. Restart frr by running service frr restart

You can check the configuration of FRR with the vtysh command. This command provides a stateful shell to manipulate FRR. More detailed documentation about vtysh can be found here

Hostapd

The hostapd config will be generated for you from /etc/config/wireless.

  1. It is important that the full version of hostapd is installed. The default package for hostapd does not work with our software. The correct package is named hostapd
  2. Configure a Wi-Fi network for the access point with WPA-PSK security via the web interface.
  3. The file /etc/config/wireless should now contain a wifi-iface section. The following options are required in this section.
    option isolate '1'
    option per_sta_vif '1'
    option vlan_file '/etc/hostapd.vlan'
  1. Create the file /etc/hostapd.vlan with the following content:
*   vlan#
  1. Restart the access point

When connecting to the Wi-Fi network you just created, you should see that an interface with the name vlan* gets created where * is an arbitrary number. The interface should disappear, after the station disconnects. You can check the existing interfaces with ip l. If you do not see the interfaces, recheck that you followed the guide exactly.

Configure WiMoVE

The default path for WiMoVE config is /etc/wimove/config. It can be configured as the first command line argument of WiMoVE. A default configuration file is available at sample-configs/access-points/wimove. There are listed all configuration options with the default values and an explanation. Right now there is almost no configuration. If you miss any configuration option, please feel free to open an issue.

After a successful configuration, you can run wimove and it should start without any errors. When connecting with a client, you should see log messages.

Clone this wiki locally