Slightly more user-friendly WiFi network toggling for Arduino Yun
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
.gitignore fixing emacs ignore Jan 3, 2015
LICENSE Initial commit Jan 3, 2015 language Mar 4, 2015
easy-wifi-switch fixing bad variable test Feb 18, 2015
rc.local works with wifi-live-or-reset Jan 4, 2015
wifi.cfg application code Jan 3, 2015

Yun Easy Wifi Switch

A more user-friendly method for WiFi network toggling on Arduino Yun (or any OpenWrt device with removable storage). For when you want to give a Yun-based project to your non-tech-folk friends!

It works by reading a wifi network's SSID, password and encryption method from a text file that is stored on a USB drive or MicroSD card. This file is accessed every time the Yun boots up and the WiFi settings are applied accordingly. If you need to change WiFi networks, you can take the USB drive or MicroSD card out of the Yun, plug it into a computer, edit the file, and place it back in the Yun.

I have tested it switching between WiFi networks and switching from AP mode (where the Arduino broadcasts its own network) to a WiFi network.

Read a more detailed write-up on my blog.


  1. Move easy-wifi-switch into your Yun's /usr/bin/ directory.
  2. Move wifi.cfg on to the root of a USB drive or MicroSD card and plug that into the Yun. I recommend USB due to its ubiquity.
  3. In your Yun's /etc/rc.local file, add a call to easy-wifi-switch before the call to wifi-live-or-reset. If you haven't made changes to the stock rc.local file, you can use the one provided here.


  1. Remove the USB drive or MicroSD card from the Yun and plug it into a computer.
  2. Open wifi.cfg in any text editor and update the SSID, password and encryption variables to the desired values.
  3. Remove the USB drive from your computer and place it back into the Yun.
  4. Reboot the Yun. When it boots up, it will apply the new settings. (Note that I have to reboot the Yun again after applying the settings, so it will take a bit longer to boot up. Thoughts about this removing this requirement are definitely welcome!)


This was created for my Trophy of the Future, an internet-connected fantasy football trophy built with an Arduino Yun. Because the trophy will change hands every year, I needed a simple way for its recipients to configure it to their WiFi networks without having to connect to the Yun's network or depend on an ethernet connection.

More Reading