summaryrefslogtreecommitdiffstats
path: root/docs/2. Building.md
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:44 +1100
commit7e4db2ff6865d723a2a6233a9542730876d06260 (patch)
tree91d37a48772711cd9a3ad85195799cd356377f12 /docs/2. Building.md
parent83ab0cdf84def71eebdebf0c813cebfce8f99d06 (diff)
Updating build instructions
Cleaning up build instructions for building AVIRT Signed-off-by: James O'Shannessy <james.oshannessy@fiberdyne.com.au>
Diffstat (limited to 'docs/2. Building.md')
-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