summaryrefslogtreecommitdiffstats
path: root/docs/3. Usage.md
diff options
context:
space:
mode:
authorJames O'Shannessy <james.oshannessy@fiberdyne.com.au>2018-10-08 12:22:32 +1100
committerMark Farrugia <mark.farrugia@fiberdyne.com.au>2018-10-26 17:27:43 +1100
commit819bbaa22430988a88999e283ceb02368ad0f7b3 (patch)
tree4b58238f4bfcdf34cca0ccabb0a0a37cea7e0dad /docs/3. Usage.md
parent72499de21381625577160fac2e1e31af0d1f104d (diff)
Committing usage document
Updated usage document with loading/unloading, configuration information Signed-off-by: James O'Shannessy <james.oshannessy@fiberdyne.com.au>
Diffstat (limited to 'docs/3. Usage.md')
-rw-r--r--docs/3. Usage.md70
1 files changed, 70 insertions, 0 deletions
diff --git a/docs/3. Usage.md b/docs/3. Usage.md
index e69de29..b5ec136 100644
--- a/docs/3. Usage.md
+++ b/docs/3. Usage.md
@@ -0,0 +1,70 @@
+Using AVIRT
+===================================
+
+## Introduction
+
+## Table of Contents
+1. [Load/Unload AVIRT](#un-load-avirt)
+2. [Configuring AVIRT](#configuring-avirt)
+
+<a name="un-load-avirt"/>
+
+## Loading and Unloading AVIRT
+
+To run, we must load the kernel modules using the `loadDrivers.sh` script, which contains sample module parameters to AVIRT:
+```sh
+$ ./loadDrivers.sh
+```
+To unload the drivers use:
+```sh
+$ ./unload.sh
+```
+
+<a name="configure-avirt" />
+
+## Configuring AVIRT
+
+AVIRT is configured using configfs.
+### Note:
+A sample script for the following is supplied inside the ```scripts``` folder.
+
+First, verify the kernel supports the use of configfs.
+```sh
+fgrep configfs /proc/filesystems
+```
+
+the expected output is:
+```
+nodev configfs
+```
+
+Once confirmed, we can mount the configfs at the conventional point:
+```sh
+#Check configfs is mounted on the system
+mkdir -p /config
+mount -t configfs none /config
+```
+
+Finally, we can configure AVIRT:
+
+```sh
+# Set up each of the cards channels
+mkdir /config/avirt/streams/playback_media
+echo "2">/config/avirt/streams/playback_media/channels
+
+mkdir /config/avirt/streams/playback_navigation
+echo "1">/config/avirt/streams/playback_navigation/channels
+
+mkdir /config/avirt/streams/playback_emergency
+echo "1">/config/avirt/streams/playback_emergency/channels
+
+mkdir /config/avirt/streams/capture_voice
+echo "1">/config/avirt/streams/capture_voice/channels
+
+# Finally, seal the card, and initiate configuration
+echo "1">/config/avirt/streams/sealed
+```
+
+### Note:
+A simplified helper library, libavirt, is available [here](https://github.com/fiberdyne/libavirt).
+Please refer to the readme in libavirt for further details.