mcy
/
owlps
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Improve compilation process for OpenWrt 

- common.mk has been tweaked so that the OpenWrt compilation process is
  more flexible: one can now choose an OPENWRT_TARGET and the
  OPENWRT_ROOT instead of just the OPENWRT_VERSION.
- The OPENWRT_VERSION's default value trunk" has been removed.
- Makefile_atheros_openwrt has been deleted, since with recent OpenWrt
  versions (12.09) everything should compile just fine, and we are not
  specific to the atheros target any more.
- INSTALL.t2t has been updated to reflect these changes, and a new
  section was added to explain how to compile your own toolchain.
This commit is contained in:
Matteo Cypriani 2013-04-24 13:21:25 -04:00
parent 4aed9c1ef0
commit f9fffd4a9e
3 changed files with 102 additions and 92 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

98
INSTALL.t2t
View File

@ -51,43 +51,91 @@ specific GCC version to be used.
= Compiling for OpenWrt = = Compiling for OpenWrt =
== The OpenWrt toolchain ==
We strongly advise that you download the full OpenWrt source tree
instead of just the pre-compiled SDK, because it will allow you to
easily add the components needed by the OwlPS modules you want to build.
The OpenWrt documentation will help you with that:
- http://wiki.openwrt.org/doc/howto/buildroot.exigence
- http://wiki.openwrt.org/doc/howto/build
In the configuration (``make menuconfig``), you have to:
+ Choose the OpenWrt //Target System// (and possibly //Subtarget//).
+ Select the components needed to build (press the <space> key to have a
//M// or a //*//). For example:
- in the //Libraries// menu, select //boost-program_options//,
//confuse// and //libiw//;
- in the //Base system// menu, //libpthread//, //librt// and
//libstdcpp// should now be automatically selected.
== Make options ==
To compile for OpenWrt, you need to set the ``OPENWRT_VERSION`` variable To compile for OpenWrt, you need to set the ``OPENWRT_VERSION`` variable
when calling make, for example: when calling make, for example:
``` make OPENWRT_VERSION=10.03 ``` make OPENWRT_VERSION=12.09
The makefile ``Makefile_atheros_openwrt`` will help you compile only
modules that have been tested for OpenWrt. If you do not set
``OPENWRT_VERSION``, it will set it for you to "10.03", but you can
specify another version, such as "trunk":
``` make -f Makefile_atheros_openwrt OPENWRT_VERSION=trunk You can also specify OPENWRT_ROOT and OPENWRT_TARGET:
It is assumed than the OpenWrt SDK is installed in - OPENWRT_ROOT defines the path to the base directory in which the
``$HOME/openwrt/buildroot`` and that the target architecture is OpenWrt stuff is (default: $HOME/openwrt).
``atheros``. For a different set up, you will need to edit the
``common.mk`` file.
For now, only OpenWrt 10.03 and trunk are supported. If you set - OPENWRT_TARGET is the name of the OpenWrt target to build for
OPENWRT_VERSION to something different than "10.03", it is replaced by (default: atheros).
"trunk".
For this to work we advise that you do something like that:
The toolchain is assumed to be under the
``$OPENWRT_ROOT/$OPENWRT_TARGET/$OPENWRT_VERSION`` directory.
For maintainability's sake, we don't handle changes of version of the
toolchain's tools, so you have to create symbolic links under this
directory (change the ``*`` with the relevant version numbers and all):
- ``target_uClibc`` pointing on ``staging_dir/target-$ARCH_*_uClibc-*``
- ``toolchain_gcc_uClibc`` pointing on
``staging_dir/toolchain-$ARCH_*_gcc-*_uClibc-*``
It might be easier to install your OpenWrt buildroot in a separate
directory, and just use symbolic links to point to the relevant
version (cf. example below).
== Example of OpenWrt set-up ==
We assume here that you want to build for the last OpenWrt development
version (//trunk//), for the //ar71xx// target, and that the OpenWrt
material is in the ``/opt/openwrt`` directory. You will compile with the
following command line:
``` make OPENWRT_VERSION=trunk OPENWRT_TARGET=ar71xx OPENWRT_ROOT=/opt/openwrt
We also assume your trunk OpenWrt source tree is in the
``/opt/openwrt/trunk`` directory. For this to work, you will first
create the ``/opt/openwrt/ar71xx/trunk`` directory, and link the
toolchain's directories from it. As of writing, the following commands
will do what you need:
``` ```
mkdir -p ~/openwrt/atheros/trunk mkdir -p /opt/openwrt/ar71xx/trunk
cd ~/openwrt/atheros/trunk cd /opt/openwrt/ar71xx/trunk
ln -s ../../buildroot/staging_dir ln -s ../../trunk/staging_dir
ln -s \ ln -s staging_dir/target-mips_r2_uClibc-0.9.33.2 target_uClibc
../../buildroot/staging_dir/target-mips_uClibc-0.9.33 \ ln -s staging_dir/toolchain-mips_r2_gcc-4.6-linaro_uClibc-0.9.33.2 \
target-mips_uClibc toolchain_gcc_uClibc
ln -s \
../../buildroot/staging_dir/toolchain-mips_gcc-4.6-linaro_uClibc-0.9.33/ \
toolchain-mips_gcc_uClibc
``` ```
Of course, you will have to update the symlinks when you compile a new Of course, you will have to update the ``target_uClibc`` and
version of the SDK. ``toolchain_gcc_uClibc`` symbolic links from time to time, as the
tools' version numbers change in trunk.
= Installing = = Installing =

45
Makefile_atheros_openwrt
View File

@ -1,45 +0,0 @@
ifndef MAKEFILE
MAKEFILE := Makefile_atheros_openwrt
endif
ifndef OPENWRT_VERSION
OPENWRT_VERSION := 10.03
endif
include common.mk
.PHONY: \
all help \
libowlps \
libowlps-client \
owlps-client \
owlps-listener
## Compilation ##
all: \
libowlps \
libowlps-client \
owlps-client \
owlps-listener
libowlps:
@$(MAKE) -C $@ $(TARGET)
libowlps-client: libowlps
@$(MAKE) -C $@ $(TARGET)
owlps-client: libowlps libowlps-client
@$(MAKE) -C $@ $(TARGET)
owlps-listener: libowlps libowlps-client
@$(MAKE) -C $@ $(TARGET)
## Help ##
help :
@echo "Compiles the supported modules for OpenWrt Atheros."
@echo "Supported variables:"
@echo " MAKEFILE: makefile to call (default: $(MAKEFILE))."
@echo " OPENWRT_VERSION: version of OpenWrt to build against \
(default: $(OPENWRT_VERSION))."
@echo " TARGET: target to call (default: all)."

51
common.mk
View File

@ -94,35 +94,41 @@ LDFLAGS :=
## OpenWrt specifics ## ## OpenWrt specifics ##
# #
# To compile for OpenWrt, the OPENWRT_VERSION variable must be set. # To compile for OpenWrt, the OPENWRT_VERSION variable must be set.
# The other relevant variables are:
# OPENWRT_ROOT: path to the base directory in which the OpenWrt stuff
# is (default: $HOME/openwrt).
# OPENWRT_TARGET: name of the OpenWrt target to build for (default:
# atheros).
# #
# By default (i.e. if OPENWRT_VERSION is set to something else than a # To allow building against several targets and OpenWrt versions, we
# known version number, we assume compiling for trunk. For this to # look for the toolchain in the following base directory, taking into
# work we advise that you do something like that (assuming the OpenWrt # account specificities of each version when needed:
# builroot is installed in ~/openwrt/buildroot): # $OPENWRT_ROOT/$OPENWRT_TARGET/$OPENWRT_VERSION
# mkdir -p ~/openwrt/atheros/trunk #
# cd ~/openwrt/atheros/trunk # For maintainability's sake, we don't handle changes of version of the
# ln -s ../../buildroot/staging_dir # toolchain's tools, so you have to create symbolic links under this
# ln -s \ # directory:
# ../../buildroot/staging_dir/target-mips_uClibc-0.9.33 \ # target_uClibc --> staging_dir/target-$ARCH_*_uClibc-*
# target-mips_uClibc # toolchain_gcc_uClibc --> staging_dir/toolchain-$ARCH_*_gcc-*_uClibc-*
# ln -s \ #
# ../../buildroot/staging_dir/toolchain-mips_gcc-4.6-linaro_uClibc-0.9.33/ \ # See the documentation in INSTALL.t2t for further information on how to
# toolchain-mips_gcc_uClibc # set up a building environment for OpenWrt.
# Of course, you have to update the symlinks when you compile a new #
# version of the SDK. ifndef OPENWRT_PATH
OPENWRT_ROOT = $${HOME}/openwrt
endif
ifndef OPENWRT_TARGET
OPENWRT_TARGET := atheros
endif
ifdef OPENWRT_VERSION ifdef OPENWRT_VERSION
TOOLCHAIN_PREFIX := $${HOME}/openwrt/atheros/trunk TOOLCHAIN_PREFIX := $(OPENWRT_ROOT)/$(OPENWRT_TARGET)/$(OPENWRT_VERSION)
STAGING_DIR := $(TOOLCHAIN_PREFIX)/staging_dir STAGING_DIR := $(TOOLCHAIN_PREFIX)/staging_dir
TOOLCHAIN1 := $(TOOLCHAIN_PREFIX)/toolchain-mips_gcc_uClibc TOOLCHAIN1 := $(TOOLCHAIN_PREFIX)/toolchain_gcc_uClibc
TOOLCHAIN_BIN := $(TOOLCHAIN1)/bin TOOLCHAIN_BIN := $(TOOLCHAIN1)/bin
TOOLCHAIN2 := $(TOOLCHAIN_PREFIX)/target-mips_uClibc TOOLCHAIN2 := $(TOOLCHAIN_PREFIX)/target_uClibc
ifeq "$(OPENWRT_VERSION)" "10.03" ifeq "$(OPENWRT_VERSION)" "10.03"
TOOLCHAIN_PREFIX := $${HOME}/openwrt/atheros/10.03/staging_dir
STAGING_DIR := $(TOOLCHAIN_PREFIX)
TOOLCHAIN1 := $(TOOLCHAIN_PREFIX)/toolchain-mips_gcc-4.3.3+cs_uClibc-0.9.30.1
TOOLCHAIN_BIN := $(TOOLCHAIN1)/usr/bin TOOLCHAIN_BIN := $(TOOLCHAIN1)/usr/bin
TOOLCHAIN2 := $(TOOLCHAIN_PREFIX)/target-mips_uClibc-0.9.30.1
endif endif
CFLAGS += -I$(TOOLCHAIN1)/usr/include -I$(TOOLCHAIN2)/usr/include CFLAGS += -I$(TOOLCHAIN1)/usr/include -I$(TOOLCHAIN2)/usr/include
@ -131,6 +137,7 @@ ifdef OPENWRT_VERSION
SEMISTATIC_LDFLAGS += $(TOOLCHAIN1)/lib/ld-uClibc.so.0 SEMISTATIC_LDFLAGS += $(TOOLCHAIN1)/lib/ld-uClibc.so.0
CC := STAGING_DIR=$(STAGING_DIR) $(TOOLCHAIN_BIN)/mips-openwrt-linux-gcc CC := STAGING_DIR=$(STAGING_DIR) $(TOOLCHAIN_BIN)/mips-openwrt-linux-gcc
CXX := STAGING_DIR=$(STAGING_DIR) $(TOOLCHAIN_BIN)/mips-openwrt-linux-g++
STRIP := STAGING_DIR=$(STAGING_DIR) $(TOOLCHAIN_BIN)/mips-openwrt-linux-strip -s STRIP := STAGING_DIR=$(STAGING_DIR) $(TOOLCHAIN_BIN)/mips-openwrt-linux-strip -s
endif endif