summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJames O'Shannessy <james.oshannessy@fiberdyne.com.au>2018-09-13 17:20:37 -0700
committerMark Farrugia <mark.farrugia@fiberdyne.com.au>2018-10-26 17:27:42 +1100
commit72499de21381625577160fac2e1e31af0d1f104d (patch)
tree4d65493fd25dde575e798cfe35103e061182cb43
parent5a2a915287e7cd12a347a03d37861310701a72fb (diff)
Updating build instructions
Cleaning up build instructions for building AVIRT Signed-off-by: James O'Shannessy <james.oshannessy@fiberdyne.com.au>
-rw-r--r--docs/2. Building.md24
1 files changed, 20 insertions, 4 deletions
diff --git a/docs/2. Building.md b/docs/2. Building.md
index 983db8d..0016822 100644
--- a/docs/2. Building.md
+++ b/docs/2. Building.md
@@ -2,20 +2,34 @@ Building AVIRT
===================================
## Table of Contents
-1. [Out of Tree](#out-of-tree)
-2. [In Tree](#in-tree)
+1. [Introduction](#intro)
+2. [Out of Tree](#out-of-tree)
+3. [In Tree](#in-tree)
+
+<a name="intro"/>
+
+## Introduction
+The AVIRT module and submodules can be built using a variety of methods. There are Visual Code build tasks for in and out of tree builds, make file support for CLI building (both in and out of tree), and xds build support.
+
<a name="out-of-tree"/>
## Out Of Tree
-The kernel modules can be built either in-tree, or out-of-tree.
-To build both AVIRT and the dummy Audio Path out-of-tree, use the following command:
+### Building with CLI
+To build both AVIRT and the additional Audio Paths out-of-tree, use the following command:
+
+```sh
+$ make
+```
+or
```sh
$ CONFIG_AVIRT=m CONFIG_AVIRT_BUILDLOCAL=y CONFIG_AVIRT_DUMMYAP=m make -C /lib/modules/$(uname -r)/build/ M=$(pwd)
```
+The latter is executed internally with the make file.
+### Building with XDS SDK
To build both AVIRT and the dummy Audio Path out-of-tree for [AGL](http://docs.automotivelinux.org/) (`aarch64` currently supported), use the [XDS](http://docs.automotivelinux.org/docs/devguides/en/dev/reference/xds/part-1/0_Abstract.html) build system together with the `make_agl.sh` script:
```sh
@@ -26,6 +40,7 @@ $ ./make_agl.sh ${XDS_SDK_ID}
## In tree
+The kernal modules can be built in tree, dependent on the avirt repository being located in drivers/staging - If using your own fork of the linux kernel, you will need to update the staging Makefiles and Kconfigs accordingly.
To build in tree, use the [Fiberdyne Linux fork](https://github.com/fiberdyne/linux), which will automatically clone the AVIRT Driver and required AudioPath modules to the `drivers/staging` directory. You can then turn AVIRT Support on by setting to `<M>`. The drivers can be found here:
```
@@ -33,6 +48,7 @@ $ make menuconfig
# Navigate to: Device Drivers--->Staging Drivers--->AVIRT Support
```
+
Finally build the kernel with the configuration selected by making.
```
$ make