View source for Getting started with Yantrr Device Cloud

= Overview  =
Yantrr Device Cloud (YDC) is cloud based software that provides complete management and reporting for your registered Yantrr device. You can access features like Device status, positioning, control, and access its data from any browser.

[[File:YDCOverview.png| center|thumb|400px | Overview of YDC ]]
<br/><br/>

== Getting Started ==
* You will have to create a user account on the YDC, if you don't already have one. Click on the “Register Now” button, and fill in the required fields. An email with the verification link is sent and clicking on this completes your Registration process.
* Once logged in, please register your device(s) using the "Register New Device" link
* The Device dashboard, is the view where all the registered Yantrr devices like the VIBE or Beaglebone Black with Vayu Capes running YCM client will be displayed.<br /> 
* If you are accessing the YDC demo site, the site will be presented in read only mode and the user can browse some of the Yantrr Demo Devices. Some of the functionality like Registering device and Admin tab will be disabled in this demo mode.
* Please click on the "Devices" tab to get started.

== Device Registration ==
* Step 1 : Note down the Ethernet MAC ID of your device
<pre>
#ifconfig eth0
eth0      Link encap:Ethernet  HWaddr 38:60:77:2e:c7:a2  
          inet addr:192.168.1.150  Bcast:192.168.1.255  Mask:255.255.255.0
          inet6 addr: fe80::3a60:77ff:fe2e:c7a2/64 Scope:Link
          UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
          RX packets:96953 errors:0 dropped:284 overruns:0 frame:0
          TX packets:61474 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:1000 
          RX bytes:91913079 (91.9 MB)  TX bytes:6508982 (6.5 MB)
          Interrupt:40
</pre>
Here 38:60:77:2e:c7:a2 is the ethernet MAC ID of your device. 
* Step 2 : Fill the device details in device registration form
#Login to Yantrr Device Cloud
#Click on "Register New Device" button
#Submit the details of your device
Note: In MAC ID field you have to type _ (underscore) instead of : (colon). Like in this case, for Ethernet MAC ID 38:60:77:2e:c7:a2 you have to type 38_60_77_2e_c7_a2.
[[File:deviceReg.png| center|thumb|400px | Device Registration ]]
On successful device registration user is redirected to Devices List page where some of demo devices provided by Yantrr and user registered device is listed.

== Run Yantrr Device Client ==
'''Prerequisites :'''
* Beaglebone Black or VIBE/VIBE2 platform flashed with Yantrr debian image
* Device is registered on Yantrr Device Cloud & note down its Device ID. Like in this case it will be "ytr_38_60_77_2e_c7_a2"
'''Steps :'''
<ol>
<li>SSH into device</li>
<pre>
ssh -l root 192.168.1.150
root@192.168.1.150's password: root
root@Yantrr:~#
</pre>
<li>Install python-virtualenv package</li>
<pre>
#apt-get install python-virtualenv 
</pre>
<li>Download YES-LiteSandbox package on a device</li>
<pre>
#wget https://www.dropbox.com/s/vkgt7nlq4bdnblt/YES-LiteSandbox.tar
</pre>
<li>Extract the downloaded package</li>
<pre>
#tar xvf YES-LiteSandbox.tar 
</pre>
<li>Now Run Yantrr Device Client</li>
<pre>
#source /root/YES/bin/activate; sleep 1; python /root/YES/YantrrClient/mainRunner.py -url "ws://dev.yantrr.net:1235/ws" -c “ytr_38_60_77_2e_c7_a2” -realm SWG_Router1 & 
</pre>
Note: Here “ytr_38_60_77_2e_c7_a2” is the registered Device ID of your device on Yantrr Device Cloud.
<li>Now device can be controlled by accessing dashboard of device.</li>
</ol>

== Devices List ==
Here a list of devices and their current status are displayed
* The Device ID generated for your registered device
* The Device description entered at the time of registration
* The current status of communication of the device with YDC
* Last connected status
* Mac ID of the device
* Some supported operations on the device (Disabled for demo use)
<br/>    
[[File:DeviceList.JPG| Devices List | center|300px|thumb]]
<br/>

== Device Dashboard ==
 
To access individual device’s dashboard click on the Device ID.
<br/>
[[File:IndDevDashboard.jpg| Device Dashboard | center|300px|thumb]]

'''Sections on Device Dashboard Page'''
# '''Device Information'''<br />The device details with its MAC ID, MIPS (CPU Frequency), Memory Information (RAM), Current CPU Temperature, Current CPU Load are displayed here.<br/>Also, its shows the realtime status of Memory Free, CPU Temperature, CPU Load, etc.<br />[[File:DeviceInfo.jpg| Device Information| center|300px|thumb]]<br/>
# '''Device Status and Control'''<br />The current status of Device, the Sensors attached to it as well as GPS status is displayed here. Also you can change the sample rate at which the data to be published to server from current device.[[File:DevStatusControl.jpg|300px|thumb| Device Status & Control| center]]
# '''Real Time Device GPS Location'''<br />The location of the Yantrr device can be visualized on the map in real time. The current GPS location is displayed with timestamp in text format.<br/>[[File:RealTimeGPSLocation.jpg| Real Time GPS Location| 300px|thumb|center]]<br/>
#'''Historical Device Data Access'''<br />This section gives capability to user such that he/she can download historical data of sensors attached to device. Currently the devices which are provided in this demo has LUX and BMP sensors attached to it.[[File:HistoricalDataAccess.jpg| Access Historical Data| center|300px|thumb]]<br/>
#'''Monitoring Device CPU Load and CPU Frequency'''<br />In this section the user can monitor the current CPU load and frequency of device. Also user can increase the CPU load or change CPU frequency.[[File:CPU_Monitoring.jpg| CPU Monitoring| center|300px|thumb]]<br/>
#'''Sample Weather Data from Device'''<br />This section displays the random sample weather data in real time.[[File:sampleWeatherData.jpg| Sample Weather Data| center|300px|thumb]]<br/>
#'''Real Time Sensor Data from Device'''<br />The sensor data of attached LUX and BMP sensors are shown in real time graphs. [[File:RealTimeSensorData.jpg| Real Time Sensor Data| center|300px|thumb]]