summaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorMatt Ranostay <matt.ranostay@konsulko.com>2018-01-15 15:50:24 -0800
committerMatt Ranostay <matt.ranostay@konsulko.com>2018-01-15 18:42:59 -0800
commit6c6011ab6195786af36a5d95f75afd5638427b24 (patch)
tree8beabad25721b5736abe747bafc57f4fbfc31366 /README.md
parent8943ed66bca18a72bb69d61eaaee69b6574799a9 (diff)
binding: radio: add binding documentation
Add initial documentation for agl-service-radio service Bug-AGL: SPEC-1245 Change-Id: Idff666ad36aad6d4bb3df48e865fc22a816b98ee Signed-off-by: Matt Ranostay <matt.ranostay@konsulko.com>
Diffstat (limited to 'README.md')
-rw-r--r--README.md33
1 files changed, 33 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1bfe68d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,33 @@
+# Radio Service
+
+## Overview
+
+Radio Service allows tuning of rtl-sdr based devices to radio stations and receive
+respective audio stream.
+
+## Verbs
+
+| Name | Description | JSON Parameters |
+|:-------------------|:-------------------- -----------------------|:---------------------------------------------------------------|
+| subscribe | subscribe to radio events | *Request:* {"value": "frequency"} |
+| unsubscribe | unsubscribe to radio events | *Request:* {"value": "frequency"} |
+| frequency | get/set tuned radio frequency | *Request:* {"value": 101100000} |
+| band | get/set current band type (e.g. AM, FM) | *Request:* {"band": "FM"} *Response:* {"band": "FM"} |
+| band_supported | check if a certain band is supported | *Request:* {"band": "FM"} *Response:* {"supported": 1} |
+| frequency_range | get frequency range for band type | *Request:* {"band": "FM"} *Response:* {"min": ..., "max": ...} |
+| frequency_step | get frequency step/spacing for band type | *Request:* {"band": "FM"} *Response:* {"step": 200000} |
+| start | start radio playback | |
+| stop | stop radio playback | |
+| scan_start | start scanning for station | *Request:* {"direction": "forward" or "backward"} |
+| scan_stop | stop scanning for station | |
+| stereo_mode | get/set stereo or mono mode | *Request:* {"value": "stereo" or "mono"} |
+
+## Events
+
+### frequency Event JSON Response
+
+JSON response has a single field **frequency** which is the currently tuned frequency.
+
+### station_found Event JSON Response
+
+JSON response has a single field **value** of the frequency of the discovered radio station.