* [[:|Wiki Home]]
* [[:cheat_sheet|Cheat Sheet]]
* [[:compiling_on_virtualbox|Precompiled virtual tools]]
* [[:carambola_where_to_start|Where to start]]
* [[:carambola_connecting|Connecting to carambola]]
* [[:carambola_using_and_customizing|Using and Customizing]]
* [[:carambola_demo_projects|Demo projects/examples]]
* [[:carambola_hardware|Hardware]]
Do everything as non-root user!
====== Install packages to your PC ======
sudo apt-get install subversion g++ ncurses-term zlib1g-dev gawk flex patch openssh-server minicom picocom tftp tftpd gettext libncurses5 libncurses5-dev unzip quilt git git-doc git-gui
====== Get latest sources ======
git clone https://github.com/8devices/carambola carambola
cd carambola
====== Get older revision ======
For some reason you might wish to get older source revision. To see available tags execute these commands:
git tag -l
You should see something like this
carambola/v1.0
carambola/v1.1
carambola/v1.1-rc1
carambola/v2.0
carambola/v2.0-rc1
carambola/v2.1
carambola/v2.1-rc1
carambola/v2.1-rc2
carambola/v2.2-rc1
carambola/v2.3-rc1
In order to get older version, type this command (but this should be rare case)
git checkout carambola/v1.0
====== Stable version ======
At this point (2012-11-11) stable version is **carambola/v2.3-rc4**. To get this version type command:
git checkout carambola/v2.3-rc4
====== More packages ======
Edit file:
vi feeds.conf.default
src-git packages git://github.com/8devices/packages.git
#src-git luci https://github.com/8devices/luci.git
src-git luci src-git git://nbd.name/luci.git
#src-svn packages svn://svn.openwrt.org/openwrt/packages
src-svn xwrt http://x-wrt.googlecode.com/svn/trunk/package
#src-svn luci http://svn.luci.subsignal.org/luci/trunk/contrib/package
#src-svn phone svn://svn.openwrt.org/openwrt/feeds/phone
#src-svn efl svn://svn.openwrt.org/openwrt/feeds/efl
#src-svn xorg svn://svn.openwrt.org/openwrt/feeds/xorg
#src-svn desktop svn://svn.openwrt.org/openwrt/feeds/desktop
#src-svn xfce svn://svn.openwrt.org/openwrt/feeds/xfce
#src-svn lxde svn://svn.openwrt.org/openwrt/feeds/lxde
#src-link custom /usr/src/openwrt/custom-feed
Type
./scripts/feeds update -a
./scripts/feeds install -a
I suppose you would also like to add [[carambola_luci|luci]].
====== Build image ======
If you wish you can change kernel settings, but at this time skip this step.
make kernel_menuconfig
Type
make menuconfig
You should see configuration window like this:
{{:carambola_where_to_start_1.png?nolink&|}}
Let's leave everything untouched for now and and exit.
Type
make
for standard building procedure or
make -j 2
if you want to use more than 1 thread and you have more than 1 CPU core on your system. This process takes long time (it took ~1 hour on 4 core machine) or
make V=99
if you need or want to see more details.
You should see build log like this:
{{:carambola_where_to_start_2.png?nolink&|}}
Or if you feel really advanced, you can get email notification upon completing build proces. For this you need to install and configure [[carambola_email_console|email client]]. After you are done, type this long command:
date > /tmp/text.txt; make -j 2 >> /tmp/text.txt; date >> /tmp/text.txt; mail -s "done" email_where_to_send_report@server.com < /tmp/text.txt
If you wish to observe current progress on computer, type in another console
tail -f /tmp/text.txt
====== Remaining steps ======
* [[carambola_serial_cable|Connect using serial cable]]
* [[carambola_serial_terminal|Start terminal]]
* [[carambola_tftp_server|Set up TFTP server]]
* [[carambola_upload_firmware|Upload new firmware to Carambola]]
* [[change_default_configuration|Change default configuration]]
====== Links ======
[[http://wiki.openwrt.org/doc/howto/build?s|openwrt building]]