summaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
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
+