Difference between revisions of "Vayu Cape SW images and drivers"

From Yantrr Wiki
Jump to: navigation, search
m (Ready to use Debian Wheezy downloadable image)
(Ready to use Debian Wheezy downloadable image)
Line 11: Line 11:
 
** [https://www.dropbox.com/s/hlm31vvhrc30rfj/BBB_VAYU-00A0.dtbo BBB_VAYU-00A0.dtbo file]
 
** [https://www.dropbox.com/s/hlm31vvhrc30rfj/BBB_VAYU-00A0.dtbo BBB_VAYU-00A0.dtbo file]
 
** [https://www.dropbox.com/s/1i4u6k05odx5cg4/BBB_VAYU.dts BBB_VAYU.dts file]
 
** [https://www.dropbox.com/s/1i4u6k05odx5cg4/BBB_VAYU.dts BBB_VAYU.dts file]
** [https://www.dropbox.com/s/1i4u6k05odx5cg4/BBB_VAYU.dts BBB_VAYU.img.gz file CHANGE THIS]
+
** [https://www.dropbox.com/s/1i4u6k05odx5cg4/BBB_VAYU.dts BBB_VAYU.img.gz file CHANGE THIS] Kernel version : 3.8.13-bone32 .
  
 
* The above image file has:
 
* The above image file has:
Line 19: Line 19:
 
** PPPd/Wvdial tool to establish 2G and 3G connection (only Service provider data has to be updated) with sample provider files. We have included AT&T and T-Mobile wvdial conf sample files for US users.
 
** PPPd/Wvdial tool to establish 2G and 3G connection (only Service provider data has to be updated) with sample provider files. We have included AT&T and T-Mobile wvdial conf sample files for US users.
 
** Helpful functions for operating GPIOs  
 
** Helpful functions for operating GPIOs  
 
* <big>Details of Kernel & RootFS:</big>
 
** Kernel version : 3.8.13-bone32
 
 
** Cape compatibility:  
 
** Cape compatibility:  
 
* <big>Basic steps</big>
 
* <big>Basic steps</big>
Line 30: Line 27:
 
*** Pressing switch S1 for 4 seconds and releasing, or
 
*** Pressing switch S1 for 4 seconds and releasing, or
 
*** Issue the commands:
 
*** Issue the commands:
<pre>
+
<code>
 
# echo low > /sys/class/gpio/gpio45/direction
 
# echo low > /sys/class/gpio/gpio45/direction
 
# sleep 4
 
# sleep 4
 
# echo high > /sys/class/gpio/gpio45/direction
 
# echo high > /sys/class/gpio/gpio45/direction
</pre>
+
</code>
 
** After some time, LED D4 should start blinking to indicate modem has turned on.  
 
** After some time, LED D4 should start blinking to indicate modem has turned on.  
 
** Attach usb cable between mini USB port (#16) of cape and host port of beaglebone board.  
 
** Attach usb cable between mini USB port (#16) of cape and host port of beaglebone board.  
 
** Check that modem is visible on the USB bus by:
 
** Check that modem is visible on the USB bus by:
<pre>
+
<code>
 
# lsusb
 
# lsusb
</pre>
+
</code>
  
 
=== Compiling the SD card image from the Scratch ===  
 
=== Compiling the SD card image from the Scratch ===  

Revision as of 06:20, 24 February 2014

Vayu capes is fully supported for Debian Wheezy ARMHF (Official Page). The kernel tree is based on Robert C Nelson git tree and all the commits are based on the latest kernel. Kindly follow his wiki for detailed steps on how to compile the kernel from scratch. BBB-RobertCNelson-Main Wiki.

We have recompiled an SD Card flashable image for easy plug and play demonstration of the Vayu 2G and 3G capes. Additionally we have outlined detailed step by step compilation of this images based on BBB-RobertCNelson-Main Wiki. If you are using any other distribution other than debian, the kernel patches are listed, kindly recompile your kernel based on directed patches, enable PPS support (if your capes have GPS timing module) and you should be ready to go.

We know in world of Linux, things get a bit complicated, we have FAQ's which may help you to unblock, kindly follow these.

Ready to use Debian Wheezy downloadable image

A prebuilt SD card image (4GB size), which already hasall the required drivers and extra functions and packages to be used by the Cape can be downloaded from here:

  • The above image file has:
    • PPS drivers, required by NTP server
    • USB drivers , required by WCDMA modem
    • NTP server setup ( if using GPS module) with servers set for Asia/India
    • PPPd/Wvdial tool to establish 2G and 3G connection (only Service provider data has to be updated) with sample provider files. We have included AT&T and T-Mobile wvdial conf sample files for US users.
    • Helpful functions for operating GPIOs
    • Cape compatibility:
  • Basic steps
    • Download image file and flash to a 4GB SD CARD.
    • Keep usb cable unattached at first.
    • Attach cape to beaglebone black and boot from sd card.
    • After booting, turn on the modem by one of these options:
      • Pressing switch S1 for 4 seconds and releasing, or
      • Issue the commands:

  1. echo low > /sys/class/gpio/gpio45/direction
  2. sleep 4
  3. echo high > /sys/class/gpio/gpio45/direction

    • After some time, LED D4 should start blinking to indicate modem has turned on.
    • Attach usb cable between mini USB port (#16) of cape and host port of beaglebone board.
    • Check that modem is visible on the USB bus by:

  1. lsusb

Compiling the SD card image from the Scratch

This section describes how to compile the Debian image from the scratch to enable

  • PPS drivers, required by NTP server
  • USB drivers , required by WCDMA modem
  • Custom wvdial conf file to enable connections
  • Device tree overlays to enable cape
  • Helpful scripts

Kindly follow this page for the detailed outlined steps - Compiling Yantrr Vayu Drivers on Debian Wheezy

Modifying your existing kernel or other distribution

If you are having your own branch of kernel and follow some other linux distribution like Ubuntu, Angstrom, you can use following wiki to recompile the kernel to support Vayu capes. We dont officially support it, but hopefully would make it easier. Note

  • Vayu 2G cape - These are fully supported in all linux distribution with device tree and overlay support, you just need the Vayu cape overlay to configure UART's
  • Vayu 2G + GPS capes - These need PPS support for GPIO in kernel, you may need to rebuilt your kernel to enable these, the details are outlined here from make menuconfig.
  • Vayu 3G & 3G + GPS capes - These may need USB driver support in addition to GPS PPS support.

Following wiki would help you in enabling these if you have correct tools to compile your kernel.

FAQ's