# Remote access via a standalone network This tutorial is adapted from a tutorial that you can find [here](https://www.raspberryconnect.com/projects/65-raspberrypi-hotspot-accesspoints/157-raspberry-pi-auto-wifi-hotspot-switch-internet). All the files modified in this document are also available in the repository, in the folder `scripts/raspbian_configuration`. The architecture of this folder shows where each file belong. In order to work as an access point, the Raspberry Pi will need to have access point software installed, along with DHCP server software to provide connecting devices with a network address. To create an access point, we'll need DNSMasq and HostAPD. Install all the required software in one go with this command:: ```sh sudo apt install dnsmasq hostapd ``` Since the configuration files are not ready yet, turn the new software off as follows:: ```sh sudo systemctl unmask hostapd sudo systemctl disable dnsmasq sudo systemctl disable hostapd ``` ## Configuring HostAPD Using a text editor edit the hostapd configuration file. This file won't exist at this stage so will be blank: `sudo nano /etc/hostapd/hostapd.conf` ```txt #2.4GHz setup wifi 80211 b,g,n interface=wlan0 driver=nl80211 ssid=PlanktoScope-Bababui_Tuogaore hw_mode=g channel=8 wmm_enabled=0 macaddr_acl=0 auth_algs=1 ignore_broadcast_ssid=0 wpa=2 wpa_passphrase=copepode wpa_key_mgmt=WPA-PSK wpa_pairwise=CCMP TKIP rsn_pairwise=CCMP #80211n - Change GB to your WiFi country code country_code=FR ieee80211n=1 ieee80211d=1 ``` The interface will be wlan0. The driver nl80211 works with the Raspberry RPi 4, RPi 3B+, RPi 3 & Pi Zero W onboard WiFi but you will need to check that your wifi dongle is compatable and can use Access Point mode. For more information on wifi dongles see elinux.org/RPi_USB_Wi-Fi_Adapters The SSID is the name of the WiFi signal broadcast from the RPi, which you will connect to with your Tablet or phones WiFi settings. Channel can be set between 1 and 13. If you are having trouble connection because of to many wifi signals in your area are using channel 8 then try another channel. Wpa_passphrase is the password you will need to enter when you first connect a device to your Raspberry Pi's hotspot. This should be at least 8 characters and a bit more difficult to guess than my example. The country_code should be set to your country to comply with local RF laws. You may experience connection issues if this is not correct. Your country_code can be found in /etc/wpa_supplicant/wpa_supplicant.conf or in Raspberry Pi Configuration - Localisation settings To save the config file press `CTRL+O` and to exit press `CTRL+X`. We also use a special function to change the network name to the machine name. Add this to `/etc/rc.local` with `sudo nano /etc/rc.local`: ```sh # Replace wifi hostname sed -i "s/^ssid.*/ssid=PlanktoScope-$(python3 -c "import planktoscope.uuidName as uuidName; print(uuidName.machineName(machine=uuidName.getSerial()).replace(' ','_'))")/" /etc/hostapd/hostapd.conf ``` Now the defaults file needs to be updated to point to where the config file is stored. In terminal enter the command `sudo nano /etc/default/hostapd` Change `#DAEMON_CONF=""` to `DAEMON_CONF="/etc/hostapd/hostapd.conf"` Check the `DAEMON_OPTS=""` is preceded by a #, so is `#DAEMON_OPTS=""`. And save. ## DNSmasq configuration Next dnsmasq needs to be configured to allow the Rpi to act as a router and issue ip addresses. Open the dnsmasq.conf file with `sudo nano /etc/dnsmasq.conf` Go to the bottom of the file and add the following lines: ```txt #AutoHotspot config interface=wlan0 bind-dynamic server=1.1.1.1 domain-needed bogus-priv dhcp-range=192.168.4.100,192.168.4.200,12h #AutoEthernet config interface=eth0 bind-dynamic server=1.1.1.1 domain-needed bogus-priv dhcp-range=192.168.5.100,192.168.5.200,12h ``` and then save `CTRL+O` and exit `CTRL+X`. Reload dnsmasq to use the updated configuration: ```sh sudo systemctl reload dnsmasq ``` ## DHCPCD DHCPCD is the software that manages the network setup. The next step is to stop dhcpcd from starting the wifi network so the autohotspot script in the next step takes control of that. Ethernet will still be managed by dhcpcd. This will also create a fallback configuration to a static IP if no DHCP server is present on the Ethernet network. Just add this line to the end of /etc/dhcpcd.conf with `sudo nano /etc/dhcpcd.conf`: ```txt nohook wpa_supplicant # define static profile profile static_eth0 static ip_address=192.168.5.1/24 static routers=192.168.5.1 static domain_name_servers=192.168.5.1 # fallback to static profile on eth0 interface eth0 fallback static_eth0 ``` Save and exit. For the fallback Ethernet network to work, we also need to add a hook to DHCPCD so it starts up the local DHCP server (dnsmasq). Edit the file `/etc/dhcpcd.enter-hook` with `sudo nano /etc/dhcpcd.enter-hook`: ```sh if [ "$interface" = "eth0" ] && [ "$if_up" ]; then systemctl start dnsmasq if [ "$reason" = "STATIC" ] || [ "$reason" = "TIMEOUT" ] || [ "$reason" = "EXPIRE" ] || [ "$reason" = "NAK" ]; then systemctl start dnsmasq elif [ "$reason" = "NOCARRIER" ] || [ "$reason" = "INFORM" ] || [ "$reason" = "DEPARTED" ]; then systemctl stop dnsmasq fi fi ``` ## Autohotspot service file Next we have to create a service which will run the autohotspot script when the Raspberry Pi starts up. Create a new file with the command `sudo nano /etc/systemd/system/autohotspot.service` Then enter the following text: ```txt [Unit] Description=Automatically generates a Hotspot when a valid SSID is not in range After=multi-user.target [Service] Type=oneshot RemainAfterExit=yes ExecStart=/usr/bin/autohotspotN [Install] WantedBy=multi-user.target ``` Save and exit. For the service to work it has to be enabled. To do this enter the command `sudo systemctl enable autohotspot.service`. ## Service Timer Create the timer with `sudo nano /etc/systemd/system/autohotspot.timer`: ```txt # /etc/systemd/system/autohotspot.timer [Unit] Description=Run autohotspot every 5 minutes, starting 10 seconds after system boot [Timer] OnBootSec=5sec OnUnitActivateSec=5min [Install] WantedBy=timers.target ``` Save and exit. Activate with `sudo systemctl enable autohotspot.timer`. ### AutoHotspot Script This is the main script that will manage your wifi connections between a wifi router and an Access Point. It will search for any wifi connection that is setup on you Raspberry Pi by using the details found in /etc/wpa_supplicant/wpa_supplicant.conf If no wifi signal is found for a known SSID then the script will shutdown the wifi network setup and create a Hotspot. If an ethernet cable that allows internet access is connect then the Hotspot will become a full internet access point. Allowing all connected devices to use the Internet. Without an ethernet connect the Raspberry Pi can be accessed from a wifi device using SSH or VNC. The script works with SSID's that contain spaces and by entering your routers MAC address it can be used with hidden SSID's. !!! info Hidden SSIDs If your routers SSID is not broadcast/hidden then find this section in the script ```txt #Enter the Routers Mac Addresses for hidden SSIDs, seperated by spaces ie #( '11:22:33:44:55:66' 'aa:bb:cc:dd:ee:ff' ) mac=() ``` and enter you routers MAC address in the brackets of mac=() as shown in the example. Make sure mutiple MAC addresses are seperated by a space. Create a new file with the command `sudo nano /usr/bin/autohotspotN` and add the following: ```sh #!/bin/bash #version 0.961-N/HS-I-PlanktonPlanet #changes by PlanktonPlanet includes the following: #- formatting and shellcheck validation #- removal of ip forwarding setup #You may share this script on the condition a reference to RaspberryConnect.com #must be included in copies or derivatives of this script. #Network Wifi & Hotspot with Internet #A script to switch between a wifi network and an Internet routed Hotspot #A Raspberry Pi with a network port required for Internet in hotspot mode. #Works at startup or with a seperate timer or manually without a reboot #Other setup required find out more at #http://www.raspberryconnect.com wifidev="wlan0" #device name to use. Default is wlan0. ethdev="eth0" #Ethernet port to use with IP tables #use the command: iw dev ,to see wifi interface name #These two lines capture the wifi networks the RPi is setup to use wpassid=$(awk '/ssid="/{ print $0 }' /etc/wpa_supplicant/wpa_supplicant.conf | awk -F'ssid=' '{ print $2 }' | sed 's/\r//g' | awk 'BEGIN{ORS=","} {print}' | sed 's/\"/''/g' | sed 's/,$//') IFS="," read -r -a ssids <<<"$wpassid" #Note:If you only want to check for certain SSIDs #Remove the # in in front of ssids=('mySSID1'.... below and put a # infront of all four lines above # separated by a space, eg ('mySSID1' 'mySSID2') #ssids=('mySSID1' 'mySSID2' 'mySSID3') #Enter the Routers Mac Addresses for hidden SSIDs, seperated by spaces ie #( '11:22:33:44:55:66' 'aa:bb:cc:dd:ee:ff' ) mac=() ssidsmac=("${ssids[@]}" "${mac[@]}") #combines ssid and MAC for checking createAdHocNetwork() { echo "Creating Hotspot" ip link set dev "$wifidev" down ip a add 192.168.4.1/24 brd + dev "$wifidev" ip link set dev "$wifidev" up dhcpcd -k "$wifidev" >/dev/null 2>&1 systemctl start dnsmasq systemctl start hostapd } KillHotspot() { echo "Shutting Down Hotspot" ip link set dev "$wifidev" down systemctl stop hostapd systemctl stop dnsmasq ip addr flush dev "$wifidev" ip link set dev "$wifidev" up dhcpcd -n "$wifidev" >/dev/null 2>&1 } ChkWifiUp() { echo "Checking WiFi connection ok" sleep 20 #give time for connection to be completed to router if ! wpa_cli -i "$wifidev" status | grep 'ip_address' >/dev/null 2>&1; then #Failed to connect to wifi (check your wifi settings, password etc) echo 'Wifi failed to connect, falling back to Hotspot.' wpa_cli terminate "$wifidev" >/dev/null 2>&1 createAdHocNetwork fi } chksys() { #After some system updates hostapd gets masked using Raspbian Buster, and above. This checks and fixes #the issue and also checks dnsmasq is ok so the hotspot can be generated. #Check Hostapd is unmasked and disabled if systemctl -all list-unit-files hostapd.service | grep "hostapd.service masked" >/dev/null 2>&1; then systemctl unmask hostapd.service >/dev/null 2>&1 fi if systemctl -all list-unit-files hostapd.service | grep "hostapd.service enabled" >/dev/null 2>&1; then systemctl disable hostapd.service >/dev/null 2>&1 systemctl stop hostapd >/dev/null 2>&1 fi #Check dnsmasq is disabled if systemctl -all list-unit-files dnsmasq.service | grep "dnsmasq.service masked" >/dev/null 2>&1; then systemctl unmask dnsmasq >/dev/null 2>&1 fi if systemctl -all list-unit-files dnsmasq.service | grep "dnsmasq.service enabled" >/dev/null 2>&1; then systemctl disable dnsmasq >/dev/null 2>&1 systemctl stop dnsmasq >/dev/null 2>&1 fi } FindSSID() { #Check to see what SSID's and MAC addresses are in range ssidChk='NoSSid' i=0 j=0 until [ $i -eq 1 ]; do #wait for wifi if busy, usb wifi is slower. ssidreply=$( (iw dev "$wifidev" scan ap-force | grep -E "^BSS|SSID:") 2>&1) >/dev/null 2>&1 #echo "SSid's in range: " $ssidreply printf '%s\n' "${ssidreply[@]}" echo "Device Available Check try " $j if ((j >= 5)); then #if busy 5 times goto hotspot echo "Device busy or unavailable 5 times, going to Hotspot" ssidreply="" i=1 elif echo "$ssidreply" | grep "No such device (-19)" >/dev/null 2>&1; then echo "No Device Reported, try " $j NoDevice elif echo "$ssidreply" | grep "Network is down (-100)" >/dev/null 2>&1; then echo "Network Not available, trying again" $j j=$((j + 1)) sleep 2 elif echo "$ssidreply" | grep "Read-only file system (-30)" >/dev/null 2>&1; then echo "Temporary Read only file system, trying again" j=$((j + 1)) sleep 2 elif echo "$ssidreply" | grep "Invalid exchange (-52)" >/dev/null 2>&1; then echo "Temporary unavailable, trying again" j=$((j + 1)) sleep 2 elif echo "$ssidreply" | grep -v "resource busy (-16)" >/dev/null 2>&1; then echo "Device Available, checking SSid Results" i=1 else #see if device not busy in 2 seconds echo "Device unavailable checking again, try " $j j=$((j + 1)) sleep 2 fi done for ssid in "${ssidsmac[@]}"; do if (echo "$ssidreply" | grep -F -- "$ssid") >/dev/null 2>&1; then #Valid SSid found, passing to script echo "Valid SSID Detected, assesing Wifi status" ssidChk=$ssid return 0 else #No Network found, NoSSid issued" echo "No SSid found, assessing WiFi status" ssidChk='NoSSid' fi done } NoDevice() { #if no wifi device,ie usb wifi removed, activate wifi so when it is #reconnected wifi to a router will be available echo "No wifi device connected" wpa_supplicant -B -i "$wifidev" -c /etc/wpa_supplicant/wpa_supplicant.conf >/dev/null 2>&1 exit 1 } chksys FindSSID #Create Hotspot or connect to valid wifi networks if [ "$ssidChk" != "NoSSid" ]; then if systemctl status hostapd | grep "(running)" >/dev/null 2>&1; then #hotspot running and ssid in range KillHotspot echo "Hotspot Deactivated, Bringing Wifi Up" wpa_supplicant -B -i "$wifidev" -c /etc/wpa_supplicant/wpa_supplicant.conf >/dev/null 2>&1 ChkWifiUp elif { wpa_cli -i "$wifidev" status | grep 'ip_address'; } >/dev/null 2>&1; then #Already connected echo "Wifi already connected to a network" else #ssid exists and no hotspot running connect to wifi network echo "Connecting to the WiFi Network" wpa_supplicant -B -i "$wifidev" -c /etc/wpa_supplicant/wpa_supplicant.conf >/dev/null 2>&1 ChkWifiUp fi else #ssid or MAC address not in range if systemctl status hostapd | grep "(running)" >/dev/null 2>&1; then echo "Hostspot already active" elif { wpa_cli status | grep "$wifidev"; } >/dev/null 2>&1; then echo "Cleaning wifi files and Activating Hotspot" wpa_cli terminate >/dev/null 2>&1 ip addr flush "$wifidev" ip link set dev "$wifidev" down # ip addr flush "$ethdev" # ip link set dev "$ethdev" down rm -r /var/run/wpa_supplicant >/dev/null 2>&1 createAdHocNetwork else #"No SSID, activating Hotspot" createAdHocNetwork fi fi ``` Save and exit. Make this script executable with `sudo chmod +x /usr/bin/autohotspotN`. You can now reboot your machine. If it doesn't find the a setup wifi network, it will generate its own.