Difference between revisions of "Getting started with Yantrr Device Cloud"

From Yantrr Wiki
Jump to: navigation, search
(→‎Overview)
(→‎Run Yantrr Device Client)
 
(17 intermediate revisions by the same user not shown)
Line 2: Line 2:
 
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.
 
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|300px | Overview of YDC ]]
+
[[File:YDCOverview.png| center|thumb|400px | Overview of YDC ]]
 +
<br/><br/>
  
−
= Getting Started =
+
== 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.
+
* 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.
−
* Registered user will be ready to see their Registered Yantrr devices in the device dashboard. These will be your VIBE or Beaglebone Black with Vayu Capes running YCM client.<br />  
+
* Once logged in, please register your device(s) using the "Register New Device" link
−
* If you are accessing the YDC demo site, the browser will be in read only mode and the user can browse some of the Yantrr Demo Devices.
+
* 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 />  
−
* Please click on the "Device Dashboard" to get started.
+
* 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.
  
−
After clicking on “Register Now” button, you are redirected to the simple user registration form.<br />[[File:YDC_UserRegistration.jpg|YDC User Registration | center]]<br /> Please fill out all the required details and click on “Sign Up” button. To complete the registration, the user gets a verification link to the email address provided. Please verify by clicking on the link, and enabling access to the YDC Site.
+
== 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>
  
−
# '''Already Existing User'''<br />To login in YDC go to http://demo.yantrr.net:9090/Demo3_Test/default/user/login<br />[[File:YDC_UserLogin.jpg| YDC Login | center]]<br />Fill out Username, Password in respective fields and click on “Log In” button. After successful login user is redirected to YDC’s main page.<br />[[File:YDC_Main.jpg| YDC Main Page | center]]
+
== Devices List ==
−
# '''Accessing Device Dashboard'''<br />For accessing the device dashboard
+
Here a list of devices and their current status are displayed
−
## Login to YDC account (like mentioned in step 2)
+
* The Device ID generated for your registered device
−
## After login click on “Device Dashboard” tab[[File:ManageDevices.jpg| Devices List | center]]Here a list of devices and there current status are displayed. To access individual device’s dashboard click on particular Device ID.For example, to access Dashboard of Device ID “ytr_0001” click on ytr_0001.[[File:NavigateDevDashboard.jpg| Access Individual Device Dashboard| center]]After clicking any particular Device ID, user will be redirected to its dashboard page like shown in below image.[[File:IndDevDashboard.jpg| Device Dashboard | center]]On this device dashboard page, user will get various sections which displays real time update coming from device like Device Information, status of Sensors and GPS, live sensors and GPS data, etc. To know all these sections detail go to “Sections on Device Dashboard Page”.
+
* The Device description entered at the time of registration
−
# '''Sections on Device Dashboard Page'''
+
* The current status of communication of the device with YDC
−
## '''Device Information'''<br />This section displays the device details with its MAC ID, MIPS (CPU Frequency), Memory Information (RAM), Current CPU Temperature, Current CPU Load.[[File:DeviceInfo.jpg| Device Information| center]]
+
* Last connected status
−
## '''Device Status and Control'''<br />This section displays the current status of Device, the Sensors attached to it as well as GPS. Also you can change the sample rate at which the data to be published to server from current device.[[File:DevStatusControl.jpg| Device Status & Control| center]]
+
* Mac ID of the device
−
## '''Real Time Device GPS Location'''<br />This section displays the current location of device on map in real time. The current GPS location is displayed with timestamp in text format.[[File:RealTimeGPSLocation.jpg| Real Time GPS Location| center]]
+
* Some supported operations on the device (Disabled for demo use)
−
## '''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]]
+
<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]]
+
[[File:DeviceList.JPG| Devices List | center|300px|thumb]]
−
## '''Sample Weather Data from Device'''<br />This section displays the random sample weather data in real time.[[File:sampleWeatherData.jpg| Sample Weather Data| center]]
+
<br/>
−
## '''Real Time Sensor Data from Device'''<br />This section displays the sensor data in real time graphs. [[File:RealTimeSensorData.jpg| Real Time Sensor Data| center]]
+
 
−
# '''Logout from YDC'''<br />For logout from current session, click on “Log Out” located in dropdown menu under current username.[[File:YDCLogOut.jpg| YDC Log Out| center]]
+
== 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]]

Latest revision as of 06:32, 30 December 2015

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.

Overview of YDC



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.
  • 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
#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

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
  1. Login to Yantrr Device Cloud
  2. Click on "Register New Device" button
  3. 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.

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 :

  1. SSH into device
    2. ssh -l root 192.168.1.150
root@192.168.1.150's password: root
root@Yantrr:~#
  2. Install python-virtualenv package
    3. #apt-get install python-virtualenv
  3. Download YES-LiteSandbox package on a device
    4. #wget https://www.dropbox.com/s/vkgt7nlq4bdnblt/YES-LiteSandbox.tar
  4. Extract the downloaded package
    5. #tar xvf YES-LiteSandbox.tar
  5. Now Run Yantrr Device Client
    6. #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 &

    Note: Here “ytr_38_60_77_2e_c7_a2” is the registered Device ID of your device on Yantrr Device Cloud.

  6. Now device can be controlled by accessing dashboard of device.

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)


Devices List


Device Dashboard

To access individual device’s dashboard click on the Device ID.

Device Dashboard

Sections on Device Dashboard Page

  1. Device Information
    The device details with its MAC ID, MIPS (CPU Frequency), Memory Information (RAM), Current CPU Temperature, Current CPU Load are displayed here.
    Also, its shows the realtime status of Memory Free, CPU Temperature, CPU Load, etc.
    Device Information

  2. Device Status and Control
    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.
    Device Status & Control
  3. Real Time Device GPS Location
    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.
    Real Time GPS Location

  4. Historical Device Data Access
    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.
    Access Historical Data

  5. Monitoring Device CPU Load and CPU Frequency
    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.
    CPU Monitoring

  6. Sample Weather Data from Device
    This section displays the random sample weather data in real time.
    Sample Weather Data

  7. Real Time Sensor Data from Device
    The sensor data of attached LUX and BMP sensors are shown in real time graphs.
    Real Time Sensor Data
Retrieved from "http://wiki.yantrr.com/index.php?title=Getting_started_with_Yantrr_Device_Cloud&oldid=772"