aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorClément Bénier <clement.benier@iot.bzh>2018-05-28 14:32:22 +0200
committercle©mentbeénier <clement.benier@iot.bzh>2018-06-21 14:23:37 +0200
commit4bea2d73a5de0f8ec83c61edc37653718d34f31b (patch)
tree27bcf6901c168face30b593cb97c2460cb63a5b1 /README.md
parent42407a7e9f7e0bf29c7d8c679536eecb9c899e86 (diff)
initial commit: draft work in progress
Change-Id: I8c0c17c66a484df9bc152046466d80224cf65498 Signed-off-by: Clément Bénier <clement.benier@iot.bzh>
Diffstat (limited to 'README.md')
-rw-r--r--README.md76
1 files changed, 76 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1acea55
--- /dev/null
+++ b/README.md
@@ -0,0 +1,76 @@
+# Radio Service
+
+## Overview
+
+Accelera Service allows getting data from acceleration, gyroscope and
+electronic compass.
+
+## Verbs
+
+| Name | Description | JSON Parameters |
+|:-------------------|:-------------------- -----------------------|:--------------------------------------------------------------- |
+| subscribe | subscribe to accelero events | *Request:* {"event": "accel"} {"event": "magn"} {"event":anglvel"}|
+| unsubscribe | unsubscribe to accelero events | *Request:* {"event": "accel"} {"event": "magn"} {"event":anglvel"}|
+
+## Events
+
+There are 3 different events matching with the different sensor available.
+
+* "accel": is for acceleration data
+* "magn": is for gyroscope data
+* "anglvel": is for data
+
+### 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.
+
+# AGL Radio Tuner Binding
+
+## FM Band Plan Selection
+
+The FM band plan may be selected by adding:
+```
+fmbandplan=X
+```
+to the [radio] section in /etc/xdg/AGL.conf, where X is one of the
+following strings:
+
+US = United States / Canada
+JP = Japan
+EU = European Union
+ITU-1
+ITU-2
+
+Example:
+```
+[radio]
+fmbandplan=JP
+```
+
+## Implementation Specific Confguration
+
+### USB RTL-SDR adapter
+
+The scanning sensitivity can be tweaked by adding:
+```
+scan_squelch_level=X
+```
+to the [radio] section in /etc/xdg/AGL.conf, where X is an integer. Lower
+values make the scanning more sensitive. Default value is 140.
+
+Example:
+```
+[radio]
+scan_squelch_level=70
+```
+
+### M3ULCB Kingfisher Si4689
+
+## Known Issues
+
+### M3ULCB Kingfisher
+