Difference between revisions of "WiFi book"
(One intermediate revision by the same user not shown) | |||
Line 74: | Line 74: | ||
==Get the Pi running== | ==Get the Pi running== | ||
* downaload the img file with the mibian distribution, and a few more configuration set up, in order to save time. http://publicationstation.wdka.hro.nl/files/rpi-base.img | * downaload the img file with the mibian distribution, and a few more configuration set up, in order to save time. http://publicationstation.wdka.hro.nl/files/rpi-base.img | ||
* once downloaded check the img integrity | * once downloaded check the img integrity against the hash in http://publicationstation.wdka.hro.nl/files/rpi-base.md5 | ||
* write that file onto the the card, by: | * write that file onto the the card, by: | ||
** inserting the sd-card to your computer | ** inserting the sd-card to your computer | ||
Line 97: | Line 97: | ||
Wait a bit for the Pi to reboot, and log once more into the Pi, using the previous ssh command. | Wait a bit for the Pi to reboot, and log once more into the Pi, using the previous ssh command. | ||
==install software== | ==install software== | ||
Line 121: | Line 120: | ||
In the case of TL-WN772N its make is Atheros, therefore requiring installing <code>firmware-atheros</code> | In the case of TL-WN772N its make is Atheros, therefore requiring installing <code>firmware-atheros</code> | ||
apt-get -y install firmware-atheros | apt-get -y install firmware-atheros | ||
==Git clone== | ==Git clone== |
Latest revision as of 05:25, 16 March 2017
https://opencourse.mywdka.nl/openaanbod/wp-content/uploads/sites/260/2017/01/bibliotecha-logo.png
Resources
- Git repository with content and a few tools https://github.com/wdka-publicationSt/WiFi-Book
- Git repository with configuration files for RaspberryPi https://github.com/wdka-publicationSt/WiFi-Book-Rpi
- Pad https://stuff2233.club/padlife/p/wifibook
Day 1
WiFi book brain storm
- What is a Wifi book?
- How does the Wifi book work?
- Why would you create a Wifi book?
- What content does the Wifi book provide?
WiFi publications and interventions
http://bibliotecha.info/imgs/data/book/web/04_bibliotecha.png
https://piratebox.cc/_media/piratebox-openwrt.300.gif
Weise7 in/compatible Laboratorium Archive
https://julianoliver.com/output/images/weise7-book/weise7-book-home5.jpg
A Public Domain by lnd4 (aka Linda Hilfling)
http://apd.lnd4.net/images/APD-diagram.png http://apd.lnd4.net/images/apd_amazon.png
content
De Hel van het Eschmarkerveld by Kim Hospers will be the content to the book. However you can choose to use and develop other content that you consider more appropriate for a Wifi Book. Or you can add other content to the De Hel van het Eschmarkerveld, such as audio, video, images or texts.
The De Hel van het Eschmarkerveld is only content (in HTML) with some structure. It contains no style (CSS).
The content is located inside the open course's git repository, inside the folder content/
Go through the content and discuss with your group how do you want to:
- present that content: how it should look like
- structure the content: do you want have in a continuous flow, or in "pages"
- navigate it: by scrolling, clicking "next page", clicking a menu that links to the different parts of the book
- add extra material
Most likely the WiFi book will be a website. Therefore, before having it in the Wifi Book device it should work on your laptops
Download content from Git https://github.com/wdka-publicationSt/WiFi-Book/archive/master.zip
collaborative tools
etherpad
If you want to work together on the same document (e.g. an HTML file) you can use the collaborative editing software etherpad
You just need to create a new pad, share its address with you group and start typing away.
You can use the program - tools/download-pad.sh
, in your computer's terminal with the address of the pad.
Example:
./download-pad.sh https://stuff2233.club/padlife/p/wifibook-test.html
This will download the pad's content, which can be viewed on the browser and refreshed to get the latest changes.
Day 2: WifiBook on a RaspberryPi
Get the Pi running
- downaload the img file with the mibian distribution, and a few more configuration set up, in order to save time. http://publicationstation.wdka.hro.nl/files/rpi-base.img
- once downloaded check the img integrity against the hash in http://publicationstation.wdka.hro.nl/files/rpi-base.md5
- write that file onto the the card, by:
- inserting the sd-card to your computer
- write the image to the sd-card
dd if=rpi-base.img of=/dev/mmcblk0 bs=4M
- BE AWARE: the location and naming of the sd-card in your computer's file-system will changed based on the operating system your are running. In Debian it is located in /dev/mmcblk0
Once dd
has finished writing to the sd-card, remove it from your computer and get it running on the Pi:
- insert the sd-card with the operating system image into the Pi
- connect the Pi to a Ethernet port
- power the Pi
If all is good you will see crazy blinking leds. Wait for the them to stop and look for the Pi's IP address
Once you know the IP address of your Pi, using the terminal, login to it as the user root (the owner of the system), using its IP address:
ssh root@the.ip.address
The default password is raspberry
once you are in the Pi, expand its file-system, by running
raspi-config
And choosing option 1. Say yes and reboot.
Wait a bit for the Pi to reboot, and log once more into the Pi, using the previous ssh command.
install software
Let's install some software, which we'll need, by running
apt-get install --yes nginx dnsmasq nano usbutils hostapd wireless-tools git
nginx
is a lightweight webserverdnsmasq
is a Domain Name System (DNS) forwarderNano
is a simple text editorusbutils
are a bunch of tools to inspect what is plugged into the USB portshostapd
turn normal network interface cards into access pointswireless-tools
are a bunch of tools to work with the wifigit
is a version trakcing software, which will use to import configuration files to the Pi
set-up the wifi dongle
In the best case scenario you have a generic 802.11 wifi dongle. We will be using the TP-Link TL-WN722N wifi dongle, as it is a generic one, that works well.
check what make is your wifi dongle
lsusb | grep 802.11
In the case of TL-WN772N its make is Atheros, therefore requiring installing firmware-atheros
apt-get -y install firmware-atheros
Git clone
The essential configuration files for running the WiFiBook are stored in a Git repository.
That allow us to import, or in Git slang "clone" those files into our system and place them in their correct location.
To do so follow these step:
cd /
go to the root /
of the RaspberryPi's file-system
git init
initiate a new git repository
git remote add origin https://github.com/wdka-publicationSt/WiFi-Book-Rpi.git
add the WifiBook repository as remote - the Git place to pull and push files
git fetch origin
Fetch the content of the repository
git checkout -f --track origin/master
ensure you are in the master branch, from the origin remote
That's it! If you encountered no errors all the configuration files have been dowloaded in place in the right locations, within the RaspberryPi file-system.
If you wanna see what files were downloaded and where they are located, run:
git ls-tree master -r --name-only
Reboot to WifiBook
reboot the RaspberryPi
reboot
Wait a bit for the Pi to reboot, and log once more into the Pi, using the previous ssh command.
If all is good your Pi salutes you with
_ _ _____ ____ | | / , / ' , / ) / --|-/|-/--------/__----------/__ /-----__----__---/-__- |/ |/ / / / / ) / ) / ) /( __/__|____/___/________/___/____/___(___/_(___/_/___\__
And the it has created a wifi hotspot with name WifiBook
Connect to it, perhaps with your mobile phone as you dont want to loose your ssh connection to the Pi
And in your browser visit any http (not https) URL. You should see nginx's (the Pi's webserver) landing page.
To load the WifiBook landing page (stored in /var/www/wifibook/index.html
), you must
Make the wifibook website configuration enabled
ln /etc/nginx/sites-available/wifibook /etc/nginx/sites-enabled/
Disable nginx default site by removing it from the the sites-enabled directory
rm /etc/nginx/sites-enabled/default
Reload nginx
ngnix -s reload
Now if you reload the same or other http URL you'll get forwarded to the WiFiBook landing page, and you can navigate the few pages that are there.
Make it yours
At the moment several public elements of WifiBook book network are in their default state. But you can edit any of them, to make the WifiBook be what you decide.
These elements are:
- the Wifi hostspot configuration
/etc/hostapd/hostapd.conf
- its name can be changed in the line
ssid=WiFiBook
- its name can be changed in the line
- the name of the machine (raspberry)
/etc/hostname
- the salutation
/etc/motd
- the webpage files
/var/www/wifibook/
- the index.html file is the landing page
The webpage files /var/www/wifibook/
files can be changed any time and the changes will be right away visible when you refresh the changed page in your web browser.
The other changes require you to reboot the Pi.