summaryrefslogtreecommitdiffstats
path: root/README.md
blob: 1acea55b2eae6c785dc1742544ee648e96120bb6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
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