diff options
| author |   Matt Ranostay <matt.ranostay@konsulko.com> | 2018-01-15 15:50:24 -0800 |
|---|---|---|
| committer | Matt Ranostay <matt.ranostay@konsulko.com> | 2018-01-15 18:42:59 -0800 |
| commit | 6c6011ab6195786af36a5d95f75afd5638427b24 (patch) | |
| tree | 8beabad25721b5736abe747bafc57f4fbfc31366 /README.md | |
| parent | 8943ed66bca18a72bb69d61eaaee69b6574799a9 (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.md | 33 |
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. |