Excited to control your devices?

We have built a lite version of our Yantrr Device Client which can be run on VIBE/VIBE2 IoT platform or on BeagleBone Black.

Hardware Requirement

Software Requirement

BeagleBone Black or VIBE/VIBE2 Platform with internet connection through ethernet
Debian Image provided by Yantrr for respective Hardware Platform or any Linux with Python support.

To get started with Yantrr Device Cloud

Hardware Setup

You have two options for setting up the device:

  1. For a new VIBE / VIBE2 or BeagleBone board, you can download the pre-built Yantrr Debian image.
  2. if you already have a working Linux running on your hardware (BeagleBone / VIBE / VIBE2) which has Python support (Latest BeagleBone image has it), then go to the next step.

Plug the ethernet cable into hardware and power up your respective hardware after it has flashed with above debian image. For instructions on flashing the image, please refer to Yantrr's Wiki

Software Setup

Step 1: Note down the Ethernet MAC ID of your device by running

ifconfig eth0 
eth0      Link encap:Ethernet  HWaddr 54:4a:16:be:ab:74
UP BROADCAST MULTICAST MTU:1500 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)
Interrupt:40
Here, 54:4a:16:be:ab:74 is the ethernet MAC ID of your device.

Step 2: Register your device with Yantrr Device Cloud

  • You will have to create a user account on the YDC, if you don't already have one. Click on the “Register Now” button at the end of this page, 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.
  • Fill in the details about your device like MAC ID (same as the one you noted down in step 1), device name (any name), cell number (optional), device type (Ethernet / GSM).

    Device_Registration_Form_img

Step 3: Connect your device to Yantrr Device Cloud

  1. SSH into device
  2. To get access of terminal of your device, you have to ssh into it using below command
    ssh -l root 192.168.1.150
    root@192.168.1.150's password: root
    root@Yantrr:~#
    Note: All debian images provided from Yantrr are configured to connect on ethernet port with IP address 192.168.1.150
  3. Install python-virtualenv package
  4. apt-get install python-virtualenv 
  5. Download YES-LiteSandbox package on a device
  6. wget https://www.dropbox.com/s/vkgt7nlq4bdnblt/YES-LiteSandbox.tar
  7. Extract the downloaded package
  8. tar xvf YES-LiteSandbox.tar 
  9. Now Run Yantrr Device Client
  10. source /root/YES/bin/activate; sleep 1; python /root/YES/YantrrClient/mainRunner.py -url "ws://dev.yantrr.net:1235/ws" -c “ytr_412195786312519” -realm SWG_Router1 & 
    Note :
    1. Here “ytr_412195786312519” is the device id of your device which is auto generated by system on successful device registration and it is internally mapped with device's ethernet MAC ID.
    2. To know device id of the device, go to "Devices" page where all the devices are listed with there current status.

      List_of_Devices_img
  11. The device can be controlled by accessing dashboard of device on Yantrr Device Cloud.
  12. To access individual device’s dashboard click on the Device ID from "Devices" page.

    Device_Dashboard_img