summaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorTobias Jahnke <tobias.jahnke@microchip.com>2019-08-09 14:12:09 +0200
committerTobias Jahnke <tobias.jahnke@microchip.com>2019-08-12 08:52:11 +0200
commitfa46d3cd2c0166d064a720bd5e621b11751a9977 (patch)
tree17f954cd224f80557d615cb0db537c962e298c3c /README.md
parent114741ed6314cf042460804effdab399936585cc (diff)
unicens-controller: insert initial code of service
Bug-AGL: SPEC-2738 - adds service widget to control microphone mode, amplifier and slimamp master volume Signed-off-by: Tobias Jahnke <tobias.jahnke@microchip.com> Change-Id: I2463b0351c740c738e35185997d926a602bb2489 Signed-off-by: Tobias Jahnke <tobias.jahnke@microchip.com>
Diffstat (limited to 'README.md')
-rw-r--r--README.md134
1 files changed, 134 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..aeeac99
--- /dev/null
+++ b/README.md
@@ -0,0 +1,134 @@
+# UNICENS Controller Service
+This is an AGL service which provides a clear API to control UNICENS network devices.
+This service requires the `agl-service-unicens` in order to communicate with the respective network devices.
+
+# API Description
+## Name
+The name of the provided API is `unicens-controller`.
+
+## Verbs
+| Name | Description | JSON Parameters |
+|-----------------------------|-----------------------------------------------|-------------------------------------------------------------------|
+| slimamp_master_volume_set | Set master volume of the slim amplifer. | *Request:* { "value": 0 } <br>Valid range for `value`: 0..100 |
+| amplifier_master_volume_set | Set master volume of the Fiberdyne amplifer. | *Request:* { "value": 0 } <br>Valid range for `value`: 0..100 |
+| microphone_mode_set | Set LED mode of microphone | See section *Verb microphone_mode_set* |
+
+
+### Verb microphone_mode_set
+You can set an LED signaling mode with the following parameters.
+
+| Name | Description |
+|---------------|---------------------------------------------------------------------------------------|
+| value | none, doa, thinking, speaking, error, waking, ending, cylon, rainbow, wheel |
+
+## Events
+None.
+
+## Supported Hardware
+- Slim Amplifier (Microchip Slim Board Family)
+- Fiberdyne Amplifier
+
+# Setup for a Native Linux Environment
+## Prerequisites
+- Setup of [AGL App-Framework](https://docs.automotivelinux.org/docs/en/master/devguides/reference/3-installing-binder-daemon.html) from [AGL OBS](https://build.opensuse.org/project/show/isv:LinuxAutomotive)
+- MOST Linux Driver
+
+## Download and Compile the Sources
+Since there are two bindings required, we will create one work space and download the repositories here.
+
+```
+$ mkdir ws_unicens
+$ cd ws_unicens
+$ git checkout --recurse-submodules https://git.automotivelinux.org/apps/agl-service-unicens
+$ git checkout --recurse-submodules https://git.automotivelinux.org/apps/agl-service-unicens-controller
+```
+
+Now create a `build` folder and build the `agl-service-unicens`.
+```
+$ cd agl-service-unicens
+$ mkdir build
+$ cd build
+$ cmake ..
+$ make
+$ cd ..
+```
+
+Now create a `build` folder and build the `agl-service-unicens-controller`.
+```
+$ cd agl-service-unicens-controller
+$ mkdir build
+$ cd build
+$ cmake ..
+$ make
+$ cd ..
+```
+
+## Setup Environment Variables
+In the workspace folder setup the following varables. You may set the resulting paths also in your `~/.bashrc` file.
+```
+$ export AGL_UCS_PATH=$PWD
+$ export AFM_APP_INSTALL_DIR=$PWD/agl-service-unicens/build/package
+```
+## Start both Services
+It is possible to start both bindings by executing the following command:
+```
+$ afb-daemon --name=afb-unicens \
+--binding=$AGL_UCS_PATH/agl-service-unicens-controller/build/package/lib/afb-ucs2-ctrl.so \
+--binding=$AGL_UCS_PATH/agl-service-unicens/build/package/lib/afb-ucs2.so \
+--workdir=$AGL_UCS_PATH/agl-service-unicens/build \
+--roothttp=$AGL_UCS_PATH/agl-service-unicens-controller/htdocs \
+--port=1234 --no-ldpaths --tracereq=common --token= --verbose
+```
+
+## Test the Services
+You may open the testing web interface on [http://localhost:1234/](http://localhost:1234/) or execute
+one of the following commands.
+
+```
+$ curl http://localhost:1234/api/unicens-controller/ping
+$ afb-client-demo -H localhost:1234/api?token= unicens-controller ping
+$ afb-client-demo -H localhost:1234/api?token= unicens-controller slimamp_master_volume_set "{'value':25}"
+$ afb-client-demo -H localhost:1234/api?token= unicens-controller amplifier_master_volume_set "{'value':25}"
+$ afb-client-demo -H localhost:1234/api?token= unicens-controller microphone_mode_set "{'value' : 'doa'}"
+```
+
+# Test on AGL Target Platform
+# Prerequisites
+- AGL SDK must be installed
+
+## Download and Cross-Compile the Sources
+Execute the follwing commands to download the sources and create the widget.
+```
+$ git checkout --recurse-submodules https://git.automotivelinux.org/apps/agl-service-unicens-controller
+$ cd agl-service-unicens-controller
+$ mkdir build
+$ cd build
+$ source /opt/agl-sdk/<environment-setup-user-dependent>
+$ cmake ..
+$ make
+$ make widget
+```
+
+## Install Widget on the Target Platform
+Copy the widget to the target and install by executing the following command.
+```
+$ afm-util install agl-service-unicens-controller.wgt
+
+>>> Remember the following response to find out the correct port.
+>>> {
+>>> "added":"agl-service-unicens-controller@<...>"
+>>> }
+
+$ afm-util info agl-service-unicens-controller@<...> | grep http-port
+
+>>> Remember the port for the following test commands.
+```
+
+Please reboot the system and test the binding by executing the following commands. Replace `31022` by the previously
+discovered http-port.
+```
+afb-client-demo --human 'localhost:31022/api?token=HELLO&uuid=magic' unicens-controller ping
+afb-client-demo --human 'localhost:31022/api?token=HELLO&uuid=magic' unicens-controller slimamp_master_volume_set "{'value' : 35}"
+afb-client-demo --human 'localhost:31022/api?token=HELLO&uuid=magic' unicens-controller amplifier_master_volume_set "{'value' : 35}"
+afb-client-demo --human 'localhost:31022/api?token=HELLO&uuid=magic' unicens-controller microphone_mode_set "{'value' : 'doa'}"
+```