README.md


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

# meta-qcom

![latest build](https://github.com/linaro/meta-qcom/actions/workflows/push.yml/badge.svg)
![daily builds](https://github.com/linaro/meta-qcom/actions/workflows/daily.yml/badge.svg)

## Introduction

OpenEmbedded/Yocto Project layer for Qualcomm based platforms.

This layer depends on:

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

This layers has an optional dependency on meta-oe layer:

```
URI: https://github.com/openembedded/meta-openembedded.git
layers: meta-oe
branch: master
revision: HEAD
```

The dependency is optional, and not strictly required. When meta-oe is enabled
in the build (e.g. it is used in BBLAYERS) then additional recipes from
meta-qcom are added to the metadata. You can refer to meta-qcom/conf/layer.conf
for the implementation details.

## Device support

All contemporary boards are supported by a single qcom-armv8a machine. Please
use it instead of using the per-board configuration file. In order to enable
support for the particular device extend the qcom-armv8a.conf file .


## Quick build

If you're new to the Yocto Project, you might want to read the ![Yocto Project
Quick Build](https://docs.yoctoproject.org/brief-yoctoprojectqs/index.html) 
document in order to setup your Yocto Project build environment. 

From inside ```poky``` folder, clone this repository:

```
git clone git://git.yoctoproject.org/meta-qcom
```

Now, from inside ```poky``` folder initialize your build folder:

```
source oe-init-build-env build/qcom-armv8a
```

The script will cd into the newly created ```build/qcom-armv8a``` folder.
From within this folder, add meta-qcom layer:

```
bitbake-layers add-layer ../../meta-qcom
```

Change ```MACHINE``` variable into ```conf/local.conf``` to:

```
MACHINE ?= "qcom-armv8a"
```

Finally, build your image:

```
bitbake core-image-minimal
```

## Contributing

If you want to contribute changes, you can send Github pull requests at
https://github.com/Linaro/meta-qcom/pulls.

You can discuss about this layer, on `#linaro` on Libera Chat IRC network.

## Reporting issues

Please report any issue on https://github.com/Linaro/meta-qcom/issues

## Maintainer(s)

Dmitry Baryshkov <dmitry.baryshkov@linaro.org>