From 035e6a012e9bb212385170b0fefc67eb92927512 Mon Sep 17 00:00:00 2001 From: Wouter R Date: Thu, 2 May 2013 16:28:24 +0200 Subject: [PATCH] Update installation guide to include wifibox feed. --- BuildOpenwrt.md | 33 ++++++++++++++++++++++++--------- Home.md | 3 +-- ProjectOutline.md | 2 +- 3 files changed, 26 insertions(+), 12 deletions(-) diff --git a/BuildOpenwrt.md b/BuildOpenwrt.md index ae7d4d3..df828f4 100644 --- a/BuildOpenwrt.md +++ b/BuildOpenwrt.md @@ -1,31 +1,46 @@ -# Building OpenWRT for the WifiBox +# Building OpenWrt for the WifiBox __TODO__: add steps to clone openwrt, install required software, create an image (on OSX) and fetch package feeds -When changing enabled packages, make sure the image has been created (check the timestamp). If not, the contents were probably too large to fit on the device. +This page describes how to build an OpenWrt image for the WifiBox as well as additional steps to get it up and running. + +_Note_: After changing enabled packages and building, make sure the image has been created (check the timestamp). If not, the contents were probably too large to fit on the device. Luci and Python (even mini) are notable for causing this. -## Configuration changes + +## 1. Adding a custom feed for the wifibox package + +This has only been tested on OSX. The feed source will eventually be replaced with an online one. + +- In the trunk directory, run `cp feeds.conf.default feeds.conf` +- Create a feed directory somewhere (e.g. /Users/me/wrt-wifibox-feed) and clone the WifiBox code into it as a subdirectory called `wifibox` +- Add this line to `feeds.conf`: `src-link wifibox /Users/me/wrt-wifibox-feed` +- Install the feeds' packages by running: `./scripts/feeds update wifibox; ./scripts/feeds install -a -p wifibox` +- While in the menuconfig in the next section, enable the wifibox package (listed under Miscellaneous). + + +## 2. Configuration changes - set target system ar7xxx/ar9xxx - set target profile to TP-Link MR3020 or WR703N - disable all target images except squashfs - enable 'Build the OpenWrt SDK' (or just toolchain?) in case you want to include your own packages - enable Base System/wireless-tools (Utilities/iwinfo not needed unless cmdline tool is needed) -- enable Languages/Lua/lua -- enable Libraries/libuci-lua -- Languages/Lua/libiwinfo-lua -- (*ignore this one, it crashes uhttpd*) enable Network/Web Servers&Proxies/uhhtpd-mod-lua and follow this: http://wiki.openwrt.org/doc/uci/uhttpd#embedded.lua +- (_ignore_) enable Languages/Lua/lua +- (_ignore_) enable Libraries/libuci-lua +- (_ignore_) Languages/Lua/libiwinfo-lua +- (_ignore this one, it crashes uhttpd_) enable Network/Web Servers&Proxies/uhttpd-mod-lua and follow this: http://wiki.openwrt.org/doc/uci/uhttpd#embedded.lua - disable Network/ppp and Network/ppp/ppp-mod-pppoe - (Global build settings) disable kernel symbol table, debug info and sysrq support - (Global build settings) disable ipv6 -## Extra changes (optional) +### 2.1 Extra changes (optional) - enable LuCI/Collections/luci if you want it - enable LuCI/Themes/luci-theme-bootstrap if you like - enable Languages/Python/python-mini if you want Python - enable uhttpd debug messages (Network/Web Servers\/Proxies) -## Further notes on setting up an unconfigured device + +## 3. Further notes on setting up an unconfigured device - it might be necessary to remove the host key from .ssh/known_hosts to prevent an ssh error - it might be handy to add a host entry to `.ssh/config` so you don't need to use an account name and can use a hostname instead of IP - set password to have the device switch from telnet to ssh diff --git a/Home.md b/Home.md index 354971e..cc12fd4 100644 --- a/Home.md +++ b/Home.md @@ -14,10 +14,9 @@ A number of milestones have been created in the issue tracker. Bitbucket sorts t ## Pages on this wiki -[Building OpenWRT](BuildOpenwrt) +[Building OpenWrt](BuildOpenwrt) [Analyzing uhttpd crashes](UhttpdCrash) [Outline for self-update functionality](SelfUpdater) -[Partial original wiki content](OriginalContent) [Miscellaneous notes](MiscNotes) [An outline of the project structure](ProjectOutline) [Webinterfaces for sending/viewing gcode](GcodeSenders) diff --git a/ProjectOutline.md b/ProjectOutline.md index aa45765..f8b1c34 100644 --- a/ProjectOutline.md +++ b/ProjectOutline.md @@ -1,4 +1,4 @@ -# Outline of the Wifibox project +# Outline of the WifiBox project Consider this a sketch, including some ideas which might never end up in the final application.