Skip to content

Commit

Permalink
Add a readme
Browse files Browse the repository at this point in the history
  • Loading branch information
daw1012345 committed Nov 13, 2022
1 parent 794cf23 commit 58822c8
Showing 1 changed file with 17 additions and 0 deletions.
17 changes: 17 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
# Eduroam - RPi
## Description
A (very) basic script to connect the Raspberry Pi to Eduroam
## Purpose
It is not trivial to connect the Raspberry Pi to WPA2-Enterprise networks such as Eduroam.
The GUI doesn't allow for it, and most of tutorials are convoluted and involve editing wpa-supplicant configuration files.
This is not intuitive for e.g. university students with little experience working with Linux. This script simlifies the problem
to 3 pieces of information - the username, password and country code. This was originally made for the University of Twente (Operating Systems course - 2022
edition).
## Use
1. Get the `configure.py` file onto the Raspberry Pi. This can be done with SCP, git, a USB drive, or the clipboard (copy-paste the contents)
2. (Optional) Inspect the script to ensure it doesn't do anything malicious. You're going to have to trust it with your username and password!
3. Execute it! Run `python3 configure.py`, with the working directory being the same as the containing folder of `configure.py`
4. Answer the questions when prompted. See this [list of country codes](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes) if unsure what to answer for the last question

## Internals
This script replaces the network management system on the Pi with NetworkManager. It's much more intuitive and it makes the GUI applet more functional. It also configures the country code and enables wifi (if not already done). Then it generates and places a configuration file in the correct place using the username and password.

0 comments on commit 58822c8

Please sign in to comment.