Openwrt/README

  _______                     ________        __
 |       |.-----.-----.-----.|  |  |  |.----.|  |_
 |   -   ||  _  |  -__|     ||  |  |  ||   _||   _|
 |_______||   __|_____|__|__||________||__|  |____|
          |__| W I R E L E S S   F R E E D O M
 -----------------------------------------------------

This is the buildsystem for the OpenWrt Linux distribution.

To build your own firmware you need a Linux, BSD or MacOSX system (case
sensitive filesystem required). Cygwin is unsupported because of the lack
of a case sensitive file system.

You need gcc, binutils, bzip2, flex, python3.5+, perl, make, find, grep, diff,
unzip, gawk, getopt, subversion, libz-dev and libc headers installed.

1. Run "./scripts/feeds update -a" to obtain all the latest package definitions
defined in feeds.conf / feeds.conf.default

2. Run "./scripts/feeds install -a" to install symlinks for all obtained
packages into package/feeds/

3. Run "make menuconfig" to select your preferred configuration for the
toolchain, target system & firmware packages.

4. Run "make" to build your firmware. This will download all sources, build
the cross-compile toolchain and then cross-compile the Linux kernel & all
chosen applications for your target system.

Sunshine!
	Your OpenWrt Community
	http://www.openwrt.org
build: Update README & github help Update README to include Openwrt branding and improve wording. Point at the Openwrt wiki in .github templates. Signed-off-by: Kevin Darbyshire-Bryant <ldir@darbyshire-bryant.me.uk> 2018-07-07 21:23:01 +00:00			`_______ ________ __`
			`\| \|.-----.-----.-----.\| \| \| \|.----.\| \|_`
			`\| - \|\| _ \| -__\| \|\| \| \| \|\| _\|\| _\|`
			`\|_______\|\| __\|_____\|__\|__\|\|________\|\|__\| \|____\|`
			`\|__\| W I R E L E S S F R E E D O M`
			`-----------------------------------------------------`
demistifying make *clean targets, fix some clean targets issues SVN-Revision: 272 2005-02-19 13:00:30 +00:00
build: Update README & github help Update README to include Openwrt branding and improve wording. Point at the Openwrt wiki in .github templates. Signed-off-by: Kevin Darbyshire-Bryant <ldir@darbyshire-bryant.me.uk> 2018-07-07 21:23:01 +00:00			`This is the buildsystem for the OpenWrt Linux distribution.`
demistifying make *clean targets, fix some clean targets issues SVN-Revision: 272 2005-02-19 13:00:30 +00:00
build: Update README & github help Update README to include Openwrt branding and improve wording. Point at the Openwrt wiki in .github templates. Signed-off-by: Kevin Darbyshire-Bryant <ldir@darbyshire-bryant.me.uk> 2018-07-07 21:23:01 +00:00			`To build your own firmware you need a Linux, BSD or MacOSX system (case`
build: README punctuation pendantry Signed-off-by: Kevin Darbyshire-Bryant <ldir@darbyshire-bryant.me.uk> 2018-07-08 10:58:07 +00:00			`sensitive filesystem required). Cygwin is unsupported because of the lack`
build: Update README & github help Update README to include Openwrt branding and improve wording. Point at the Openwrt wiki in .github templates. Signed-off-by: Kevin Darbyshire-Bryant <ldir@darbyshire-bryant.me.uk> 2018-07-07 21:23:01 +00:00			`of a case sensitive file system.`
little modification SVN-Revision: 655 2005-04-15 10:26:39 +00:00
build: switch to Python 3 This patch switches Python used in buildroot to Python 3 as Python 2.x series is going to be EOL relatively soon[1]. "Being the last of the Python 2.x series, 2.7 will have an extended period of maintenance. Specifically, 2.7 will receive bugfix support until January 1, 2020. After the last release, 2.7 will receive no support." It seems like Python 3 is going to be needed in order to support Meson build system which has gained some traction recently. Build tested on following targets: ath79/generic imx6/generic ipq40xx/generic lantiq/xway layerscape/armv7 (broken) layerscape/armv8_32b (broken) layerscape/armv8_64b (broken) mvebu/cortexa72 ramips/mt7621 ramips/mt7620 sunxi/cortexa7 x86/64 Layerscape targets are unfortunately left broken as their ls-rcw firmware package uses Python 2 and converting it to Python 3 would take more then reasoanble amount of time (I've tried to fix it already) and would be better fixed by someone who can even run test it. Run tested on ath79 (Archer C7 v5), ipq40xx (nbg6617) and x86_64 (QEMU and apu2). 1. https://www.python.org/dev/peps/pep-0373/ Ref: PR#1937 Cc: Yangbo Lu <yangbo.lu@nxp.com> Cc: Mathew McBride <matt@traverse.com.au> Acked-by: Yousong Zhou <yszhou4tech@gmail.com> Signed-off-by: Petr Štetiar <ynezz@true.cz> 2019-03-19 12:02:07 +00:00			`You need gcc, binutils, bzip2, flex, python3.5+, perl, make, find, grep, diff,`
build: Update README & github help Update README to include Openwrt branding and improve wording. Point at the Openwrt wiki in .github templates. Signed-off-by: Kevin Darbyshire-Bryant <ldir@darbyshire-bryant.me.uk> 2018-07-07 21:23:01 +00:00			`unzip, gawk, getopt, subversion, libz-dev and libc headers installed.`
trying to make README file a bit more helpful SVN-Revision: 29837 2012-01-21 01:15:24 +00:00
build: Update README & github help Update README to include Openwrt branding and improve wording. Point at the Openwrt wiki in .github templates. Signed-off-by: Kevin Darbyshire-Bryant <ldir@darbyshire-bryant.me.uk> 2018-07-07 21:23:01 +00:00			`1. Run "./scripts/feeds update -a" to obtain all the latest package definitions`
			`defined in feeds.conf / feeds.conf.default`
trying to make README file a bit more helpful SVN-Revision: 29837 2012-01-21 01:15:24 +00:00
build: Update README & github help Update README to include Openwrt branding and improve wording. Point at the Openwrt wiki in .github templates. Signed-off-by: Kevin Darbyshire-Bryant <ldir@darbyshire-bryant.me.uk> 2018-07-07 21:23:01 +00:00			`2. Run "./scripts/feeds install -a" to install symlinks for all obtained`
			`packages into package/feeds/`
demistifying make *clean targets, fix some clean targets issues SVN-Revision: 272 2005-02-19 13:00:30 +00:00
build: Update README & github help Update README to include Openwrt branding and improve wording. Point at the Openwrt wiki in .github templates. Signed-off-by: Kevin Darbyshire-Bryant <ldir@darbyshire-bryant.me.uk> 2018-07-07 21:23:01 +00:00			`3. Run "make menuconfig" to select your preferred configuration for the`
			`toolchain, target system & firmware packages.`
lzma loader patch from oleg, great thanks good work, saves another 300 kb flashmemory SVN-Revision: 513 2005-04-02 12:12:58 +00:00
build: README punctuation pendantry Signed-off-by: Kevin Darbyshire-Bryant <ldir@darbyshire-bryant.me.uk> 2018-07-08 10:58:07 +00:00			`4. Run "make" to build your firmware. This will download all sources, build`
build: Update README & github help Update README to include Openwrt branding and improve wording. Point at the Openwrt wiki in .github templates. Signed-off-by: Kevin Darbyshire-Bryant <ldir@darbyshire-bryant.me.uk> 2018-07-07 21:23:01 +00:00			`the cross-compile toolchain and then cross-compile the Linux kernel & all`
			`chosen applications for your target system.`
little modification SVN-Revision: 655 2005-04-15 10:26:39 +00:00
lzma loader patch from oleg, great thanks good work, saves another 300 kb flashmemory SVN-Revision: 513 2005-04-02 12:12:58 +00:00			`Sunshine!`
merge: base: update base-files and basic config Signed-off-by: Zoltan HERPAI <wigyori@uid0.hu> 2017-11-07 08:45:50 +00:00			`Your OpenWrt Community`
			`http://www.openwrt.org`
demistifying make *clean targets, fix some clean targets issues SVN-Revision: 272 2005-02-19 13:00:30 +00:00