-
Notifications
You must be signed in to change notification settings - Fork 3
/
Copy pathconfigure-a-bluecats-edgerelay.html
196 lines (194 loc) · 10 KB
/
configure-a-bluecats-edgerelay.html
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
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
<!DOCTYPE HTML>
<html>
<head>
<title>Configure a BlueCats Edge Relay | diyActive</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="description" content="How to configure BlueCats Edge Relay to interface with reelyActive's open source software.">
<link href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet">
<link rel="stylesheet" href="style/main.css">
<script src="https://cdnjs.cloudflare.com/ajax/libs/angular.js/1.6.2/angular.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/angular-ui-bootstrap/2.5.0/ui-bootstrap-tpls.min.js"></script>
<script type="text/javascript" src="js/diyactive.js"></script>
</head>
<body ng-app="diyActive">
<div ng-controller="InteractionCtrl">
<nav class="navbar navbar-default" role="navigation">
<div class="navbar-header">
<button type="button" class="navbar-toggle"
ng-init="navCollapsed = true"
ng-click="navCollapsed = !navCollapsed">
<span class="sr-only">Toggle navigation</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
<a class="navbar-brand" href="https://www.reelyactive.com">
<strong>reely</strong>Active
</a>
</div>
<div class="collapse navbar-collapse" ng-class="!navCollapsed && 'in'"
ng-click="navCollapsed = true">
<ul class="nav navbar-nav navbar-right">
<li class="active"><a href="/"> diyActive </a></li>
<li class="dropdown" uib-dropdown on-toggle="toggled(open)">
<a href class="dropdown-toggle" uib-dropdown-toggle role="button"
data-toggle="dropdown" aria-haspopup="true"
aria-expanded="false">
Quick links <span class="caret"></span>
</a>
<ul class="dropdown-menu" uib-dropdown-menu role="menu">
<li role="menuitem">
<a href="https://github.com/reelyactive/" target="_blank">
reelyActive on GitHub
</a>
</li>
<li role="menuitem">
<a href="https://www.npmjs.com/~reelyactive" target="_blank">
reelyActive on npmjs
</a>
</li>
<li role="separator" class="divider"></li>
<li role="menuitem">
<a href="https://www.reelyactive.com" target="_blank">
reelyActive website
</a>
</li>
<li role="menuitem">
<a href="https://getpareto.com" target="_blank">
Pareto by reelyActive
</a>
</li>
<li role="separator" class="divider"></li>
<li role="menuitem">
<a href="https://shop.reelyactive.com" target="_blank">
Our online store
</a>
</li>
<li role="menuitem">
<a href="https://reelyactive.com/blog/" target="_blank">
Our blog
</a>
</li>
</ul>
</li>
</ul>
</div>
</nav>
<div class="container-fluid">
<div class="row">
<div class="col-xs-12 col-sm-10 col-sm-offset-1 col-md-8 col-md-offset-2 col-lg-6 col-lg-offset-3">
<h1>
Configure a BlueCats Edge Relay <br>
<small> To interface with reelyActive's open source software </small>
</h1>
<p> The BlueCats Edge Relay is a versatile BLE edge device which may be configured to scan and send all real-time packets to an endpoint running <a href="open-source-software.html">reelyActive open source software</a>. This tutorial provides the steps to achieve such a configuration. </p>
<h2> Connect to the Edge Relay <br>
<small> To access the web configuration utility </small> </h2>
<p> See BlueCats' GitHub page with all the steps for connecting your computer to Edge Relay so that you can access its web configuration utility. Additionally, follow the instructions to connect the Edge Relay to WiFi. It is <b><i>not</i></b> required to register with the BlueCats Cloud. </p>
<p class="text-center">
<a class="btn btn-primary" href="https://github.com/bluecats/bluecats-docs-edge/blob/master/getting-started-connect.md#connecting-to-the-edge"
target="_blank" role="button"> Connecting to the Edge </a>
</p>
<h2> Configure the target endpoint <br>
<small> Define where to stream the data </small> </h2>
<p> From the <b>BlueCats</b> pull-down, select <b>Setup Endpoints</b>, then: </p>
<ul>
<li> leave the UDP target port as default (9942)
<li> enter the IP address of the endpoint running the reelyActive software (ex: 192.168.0.101)
</ul>
<p> Ignore the other endpoint settings and click <b>Save & Apply</b> </p>
<img src="images/bluecats-edge-endpoint.png" class="img-responsive">
<h2> Configure the application <br>
<small> Scan and Forward as JSON over UDP </small> </h2>
<p> From the <b>BlueCats</b> pull-down, select <b>Applications</b> and select the <b>Scan and Forward</b> tab, then: </p>
<ul>
<li> enable Enable Scan and Forward Messages
<li> select UDP endpoint
<li> select JSON message format
<li> leave Sample Rate as default (0)
<li> leave Maximum Devices per Sample as default (0)
</ul>
<p> Click <b>Save & Apply</b> </p>
<img src="images/bluecats-edge-applications.png" class="img-responsive">
<h2> Configure the advanced settings <br>
<small> Send all packets, even the unknown </small> </h2>
<p> From the <b>BlueCats</b> pull-down, select <b>Advanced</b>, then: </p>
<ul>
<li> disable Enable RSSI Smoothing
<li> enable Scan Unknown Bluetooth Advertisements
<li> increase Devices per scan to 100
<li> leave all other settings as default
</ul>
<p> Click <b>Save & Apply</b> </p>
<img src="images/bluecats-edge-advanced.png" class="img-responsive">
<h2> Confirm reception of the data stream <br>
<small> Listen on the target machine </small> </h2>
<p> Run an instance of <a href="https://www.npmjs.com/package/hlc-server" target="_blank">hlc-server</a> on the target machine to observe the real-time data (requires <a href="https://nodejs.org" target="_blank">Node.js</a>). Paste the following into a file called <b>server.js:</b> </p>
<pre>
const server = require('hlc-server');
var app = new server();
// Replace xxx below with the IP address of the server
app.bind( { protocol: "bluecats-udp", path: "xxx.xxx.xxx.xxx:9942" } );
</pre>
<p> Then from the command line, in the same folder as <b>server.js</b>, run the following: </p>
<p> <code> npm install hlc-server </code> to install the prerequisite software packages, then </p>
<p> <code> node server </code> to run the software. </p>
<p> Point your web browser to port 3001 of the server (ex: http://xxx.xxx.xxx.xxx.:3001) and observe the real-time data. </p>
<div uib-carousel interval="4000">
<div uib-slide index="0">
<img ng-src="images/piHub-hlc-960.png"
class="img-responsive">
<div class="carousel-caption">
<h1> hlc-server </h1>
</div>
</div>
<div uib-slide index="1">
<img ng-src="images/piHub-dashboard.png"
class="img-responsive">
<div class="carousel-caption">
<h1> Dashboard </h1>
</div>
</div>
<div uib-slide index="2">
<img ng-src="images/piHub-bubblescape.jpg"
class="img-responsive">
<div class="carousel-caption">
<h1> The bubblescape </h1>
</div>
</div>
</div><br>
<h2> Simply interested in the real-time data? </h2>
<img src="images/pareto-by-reelyactive.jpg"
class="img-responsive center-block"><br>
<p> Our Pareto platform combines the convenience of SaaS with plug-and-play hardware. </p>
<p class="text-center">
<a class="btn btn-primary" href="https://getpareto.com"
target="_blank" role="button"> Visit getpareto.com </a>
</p>
<hr>
<h2> What's next? </h2>
<p> Experiment with our barnowl middleware, learn about other compatible gateways and hubs, or return to the diyActive home page. </p>
<p class="text-center">
<a class="btn btn-default" href="barnowl-baby-steps.html"
role="button"> Barnowl Baby Steps </a>
<a class="btn btn-default" href="gateways-and-hubs.html"
role="button"> Gateways and Hubs </a>
<a class="btn btn-success" href="/"
role="button"> Return to diyActive </a>
</p>
</div>
</div>
</div>
<footer class="footer">
<a href="/"
uib-tooltip="Do-it-yourself with reelyActive"
tooltip-placement="left"> diyActive </a> |
<a href="https://www.reelyactive.com"
uib-tooltip="We believe in an open Internet of Things"
tooltip-placement="right">
© reelyActive 2017-2018
</a>
</footer>
</div>
</body>
</html>