-
Notifications
You must be signed in to change notification settings - Fork 277
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Added information to the README about the new OS Image option and cle…
…aned it up a bit
- Loading branch information
Showing
1 changed file
with
35 additions
and
14 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,42 +1,63 @@ | ||
RaspiWiFi | ||
|
||
RaspiWiFi is a program to headlessly configure a Raspberry Pi's WiFi | ||
connection using using any other WiFi-enabled device (much like the way | ||
a Chromecast or similar device can be configured). RaspiWiFi has been | ||
RaspiWiFi is a program to headlessly configure a Raspberry Pi's WiFi | ||
connection using using any other WiFi-enabled device (much like the way | ||
a Chromecast or similar device can be configured). RaspiWiFi has been | ||
tested with the Raspberry Pi B+, Raspberry Pi 3, and Raspberry Pi Zero W. | ||
|
||
|
||
|
||
INSTALLATION INSTRUCTIONS: | ||
OS IMAGE USAGE: | ||
|
||
== Navigate to the directory you downloaded or cloned RaspiWiFi to | ||
== Just burn the ".IMG" file attached to this release to an 8GB+ SD card. Boot | ||
your Raspberry Pi with the SD card and it will automatically boot into its AP | ||
Host (broadcast) mode with an SSID based on a unique id (the last four of your | ||
Pi's serial number). No input devices or displays necessary. Otherwise this is | ||
a base install of the current Raspbian Stretch, up to date as of the date of | ||
this release. | ||
|
||
|
||
|
||
SCRIPT-BASED INSTALLATION INSTRUCTIONS: | ||
|
||
== Navigate to the directory you downloaded or cloned RaspiWiFi | ||
|
||
== Run: | ||
|
||
sudo python3 initial_setup.py | ||
|
||
== This script will install all necessary prerequisites, copy configuration files, and reboot. When it finishes booting it should present itself in "Configuration Mode" as a WiFi access point with the name "RaspiWiFi Setup". | ||
|
||
== This script will install all necessary prerequisites, copy configuration | ||
files, and reboot. When it finishes booting it should present itself in | ||
"Configuration Mode" as a WiFi access point with the name "RaspiWiFi Setup". | ||
|
||
|
||
|
||
USAGE: | ||
|
||
== Connect to the "RaspiWiFi Setup" access point using any other WiFi enabled device. | ||
== Connect to the "RaspiWiFi Setup" access point using any other WiFi enabled | ||
device. | ||
|
||
== Navigate to http://10.0.0.1:9191 using any web browser on the device you connected with. | ||
== Navigate to http://10.0.0.1:9191 using any web browser on the device you | ||
connected with. | ||
|
||
== Select the WiFi connection you'd like your Raspberry Pi to connect to from the drop down list and enter its wireless password on the page provided. If no encryption is enabled, leave the password box blank. | ||
== Select the WiFi connection you'd like your Raspberry Pi to connect to from | ||
the drop down list and enter its wireless password on the page provided. If no | ||
encryption is enabled, leave the password box blank. | ||
|
||
== Click the "Connect" button. | ||
|
||
== At this point your Raspberry Pi will reboot and connect to the access point specified. | ||
|
||
== At this point your Raspberry Pi will reboot and connect to the access point | ||
specified. | ||
|
||
|
||
|
||
RESETTING THE DEVICE: | ||
|
||
== If GPIO 18 is pulled HIGH for 10 seconds or more the Raspberry Pi will reset all settings, reboot, and enter "Configuration Mode" again. It's useful to have a simple button wired on GPIO 18 to reset easily if moving to a new location, or if incorrect connection information is ever entered. Just press and hold for 10 seconds or longer. | ||
== If GPIO 18 is pulled HIGH for 10 seconds or more the Raspberry Pi will reset | ||
all settings, reboot, and enter "Configuration Mode" again. It's useful to have | ||
a simple button wired on GPIO 18 to reset easily if moving to a new location, | ||
or if incorrect connection information is ever entered. Just press and hold for | ||
10 seconds or longer. | ||
|
||
== You can also reset the device by re-running the initial_setup.py as instructed above. | ||
== You can also reset the device by running the manual_reset.py in the | ||
"Reset Device" directory |