0
0
mirror of https://github.com/Doodle3D/doodle3d-firmware.git synced 2024-09-16 16:50:07 +02:00

Update installation guide to include wifibox feed.

Wouter R 2013-05-02 16:28:24 +02:00
parent 8c439e4106
commit 035e6a012e
3 changed files with 26 additions and 12 deletions

@ -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

@ -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)

@ -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.