Vayu Cape SW images and drivers

From Yantrr Wiki
Revision as of 07:54, 24 February 2014 by Admin (Talk | contribs) (Basic steps for Using Modem)

Jump to: navigation, search

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:

Download Files:

  • Download these files from the dropbox:
  • The above image file has:
    • PPS support using the dtbo/dts files for initializing the device tree overlay.
    • PPS drivers, required by NTP server.
    • USB drivers , required by GSM/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 scripts for operating GPIOs (under /root/bin for activating/reading pins directly).

Basic steps for Using Modem

  • Download image file and flash to a 4GB SD CARD.
  • Attach cape to beaglebone black and boot from sd card.
  • Keep USB cable unattached at first. Place a WCDMA enabled SIM card in the SIM card slot.
  • After booting, turn on the modem by one of these options:
    • Pressing switch S1 for 4 seconds and releasing, or
    • Issue the commands:
echo "low" > /sys/class/gpio/gpio45/direction
sleep 4
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. Alternatively, if the USB host on cape is also populated,then the USB cable can be kept intact before Board was booted up.
  • Check that modem is visible on the USB bus by:
lsusb

Bus 001 Device 002: ID 0424:2412 Standard Microsystems Corp.
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 002 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 001 Device 007: ID 21f5:2012
  • You can also check that ports will be assigned for the modem by :
ls /dev/ttyUSB*

/dev/ttyUSB0  /dev/ttyUSB1  /dev/ttyUSB2
  • The modem is now ready for use with pon/poff, ppp, Wvdial or any other dialer program.

Basic Steps for Using GPS

Basic Steps for Using PPS

Pin Usage and Cape compatibility

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