aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
blob: 7487b5f072af052239f3e340417fd2cc3324c685 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
# meta-openwrt
OE metadata layer for OpenWRT

This layer provides OpenEmbedded metadata for [OpenWRT](http://www.openwrt.org/) packages

# Getting Started

```shell
git clone git://github.com/openembedded/openembedded-core.git
cd openembedded-core
git clone git://github.com/openembedded/meta-openembedded.git
git clone git://github.com/openembedded/bitbake.git
git clone git://github.com/kraj/meta-openwrt.git
git clone git://github.com/imyller/meta-nodejs.git
git clone git://github.com/imyller/meta-nodejs-contrib.git

$ . ./oe-init-build-env

$ bitbake-layers add-layer ../meta-openembedded/meta-oe
$ bitbake-layers add-layer ../meta-nodejs
$ bitbake-layers add-layer ../meta-nodejs-contrib
$ bitbake-layers add-layer ../meta-openwrt
```

# Building

Below we build for qemuarm machine as an example, add
one of OpenWRT recipes to images e.g. in conf/local.conf add

CORE_IMAGE_EXTRA_INSTALL = "libubox-examples"

To include juci instead of luci add

CORE_IMAGE_EXTRA_INSTALL = "juci"

```shell
$ TCLIBC=musl MACHINE=qemuarm bitbake core-image-minimal
$ TCLIBC=musl MACHINE=qemux86 bitbake core-image-weston
$ TCLIBC=musl MACHINE=qemux86 bitbake core-image-sato

```
# Running

```shell
$ TCLIBC=musl runqemu qemuarm
```

# Limitations

Works with OE Release >= 2.2

Currently images are buildable/bootable for mips, arm, aarch64, ppc, x86, x86_64
based qemu machines
MACHINE variable and TCLIBC variables can also be set in conf/local.conf
to avoid typing it on commandline on any bitbake invocation

# Dependencies

```
URI: git://github.com/openembedded/openembedded-core.git
branch: master
revision: HEAD

URI: git://github.com/openembedded/meta-openembedded.git
branch: master
revision: HEAD

URI: git://github.com/openembedded/bitbake.git
branch: master
revision: HEAD

URI: git://github.com/imyller/meta-nodejs.git
branch: master
revision: HEAD

URI: git://github.com/imyller/meta-nodejs-contrib.git
branch: master
revision: HEAD
```

# Upstreaming

## Mailing List
Send pull requests to openembedded-devel@lists.openembedded.org with '[meta-openwrt]' in the subject'

When sending single patches, please use something like

```shell
git send-email -M -1 --to openembedded-devel@lists.openembedded.org --subject-prefix=meta-openwrt][PATCH
```
## Forking via github

You are encouraged to fork the mirror on [github](https://github.com/kraj/meta-openwrt/)
to share your patches, this is preferred for patch sets consisting of more than
one patch. Other services like gitorious, repo.or.cz or self hosted setups are
of course accepted as well, 'git fetch <remote>' works the same on all of them.
We recommend github because it is free, easy to use, has been proven to be reliable
and has a really good web GUI.

Maintainer(s)

* Khem Raj <mailto:raj.khem@gmail.com>