Makefile

Description

An integrated Makefile needed to build any/all of the utilities.

Usage

make toolname                 # use the real toolname, e.g. 'busybox'
make all

Targets

• all
  • Generate all binary packages, and create an ipkg feed in packages/
• directories
  • Create the working directories for compilation
• distclean
  • Remove any built or staged files
• packages
  • Create the ipkg packages
• toolchain
  • Create the GNU build tools for ARM
• toolchain-binary
  • Download and install the GNU build tools for ARM (requires sudo)
• toolclean
  • Remove toolchain for clean rebuild
• torture
  • Generate all packages, each after a distclean
• firmware, firmware-romfs
  • Create a firmware .upgrade or .romfs.bin file

For each package there are some standard operations accessible as make targets, e.g.:

make rss-source    # download the sources
make rss-unpack    # unpack the downloaded 
make rss           # build
make rss-stage     # stage
make rss-ipk       # create the IPK package
make rss-clean     # clean all of the built file
make rss-dirclean  # clean all dynamically created directories
make rss-check     # sanity check for the package

Above commands work also for kernel and firmware re-building, e.g.:

Firmware modding

When building firmware one can create optional firmware.config file that will

name resulting firmware. For example one can create a fimware.config file

with the following contents in the trunk directory:

# use export FIRMWARE_CONFIG=$PWD/firmware.config
FIRMWARE_MODEL := MG35
FIRMWARE_REVISION := 3
FIRMWARE_RELEASE := a7
FIRMWARE_MODDER := LK
FIRMWARE_LANG := CE
FIRMWARE_CP := 1250
FIRMWARE_AUDIENCE := Devel

If we issue

then this file will be sources when building firmware and named files accordingly.

Otherwise default values will be used.

License

Copyright (C) 2008 by John <gardez@users.sourceforge.net>
Copyright (C) 2004 by Rod Whitby <unslung@gmail.com>
Copyright (C) 2004 by Oleg I. Vdovikin <oleg@cs.msu.su>
Copyright (C) 2001-2004 Erik Andersen <andersen@codepoet.org>
Copyright (C) 2002 by Tim Riker <Tim@Rikers.org>
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

Todo

History

Version 1.00 - [John, 2008-07-23]

• 'make torture' works

Comments

• External testing welcome :)

Status of SVN r1056 firmware building with integrated Makefile

It should be noted that r1056 does not build workable firmware. Without

having serial console, one can not see what is happening. Besides kernel

there are also cramfs differences when comparing produced kernel with

custom kernel MG35_1.5.2.3-a8-JD_Eng_Devel.upgrade. More detailed explanation

is described in r1056 firmware status page.