summaryrefslogtreecommitdiffstats
path: root/docs/4a-framework/concepts.md
diff options
context:
space:
mode:
authorLoïc Collignon <loic.collignon@iot.bzh>2018-09-10 10:36:46 +0200
committerLoïc Collignon <loic.collignon@iot.bzh>2018-10-01 15:46:43 +0200
commit75e26b091f6aae38c9edb069c173bcb04ae3ffd1 (patch)
treeac31716b5bdd2ad0236559d141cdcca8f9696332 /docs/4a-framework/concepts.md
parentfe834167fd205e9a38c986bfb9dfde4265e9cc45 (diff)
Updated documentation
Updated documentation up to date and using the gitbook format. Change-Id: Ie5d6a3bb489b9a9a95e21f5edd05bdd77bff5816 Signed-off-by: Loïc Collignon <loic.collignon@iot.bzh>
Diffstat (limited to 'docs/4a-framework/concepts.md')
-rw-r--r--docs/4a-framework/concepts.md37
1 files changed, 37 insertions, 0 deletions
diff --git a/docs/4a-framework/concepts.md b/docs/4a-framework/concepts.md
new file mode 100644
index 0000000..dba024d
--- /dev/null
+++ b/docs/4a-framework/concepts.md
@@ -0,0 +1,37 @@
+# Concepts
+
+A user application requests to open an audio role, which is bound to a stream,
+which is bound to a zone. This allows the application to only care about the
+audio role.
+
+For example, a navigation application can request the **navigation** role, which
+is bound to the **navigation** stream defined by the HAL. This stream is bound
+to the **driver** zone, which is the closest speaker to the driver.
+
+## Roles
+
+The high level API allows applications to open roles such as **emergency**,
+**navigation** or **multimedia**. A role is bound to a stream, which is
+basically a device URI. When a role is opened, then the policy engine is
+notified and executes an interrupt on every other opened role with a lower
+priority. An interrupt is a policy engine function that can change the volume,
+mute or unmute, change the stream's state.
+
+This behaviour allows the policy engine to take actions like lowering the radio
+volume when an application wants to play something on the emergency role.
+
+## Streams
+
+A stream is basically a device URI that you can open to write audio data. For
+example, it can be "hw:2,0,1", which means that you have to use this as an alsa
+device URI.
+
+## Zones
+
+Multiple speakers are spread around inside a vehicule, they are named depending
+on their position, like **front-center**, **front-left**, **front-right**,
+**rear-left**, **rear-right**, etc...
+
+Zones are an abstraction of positional audio. A zone is made of one or more
+speakers and describes logical audio areas like **driver**, **front**, **rear**,
+etc.