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

From Yantrr Wiki
Jump to: navigation, search
(→‎Ready to use Debian Wheezy downloadable image)
m (→‎Ready to use Debian Wheezy downloadable image)
Line 22: Line 22:
 
* <big>Basic steps</big>
 
* <big>Basic steps</big>
 
** Download image file and flash to a 4GB SD CARD.  
 
** 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.  
 
** 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:
 
** After booting, turn on the modem by one of these options:
 
*** Pressing switch S1 for 4 seconds and releasing, or
 
*** Pressing switch S1 for 4 seconds and releasing, or
Line 33: Line 33:
 
</code>
 
</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. 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:
 
** Check that modem is visible on the USB bus by:
 
<code>
 
<code>
 
lsusb
 
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
 
</code>
 
</code>
−
<i><b>Note:</b> The above enabling commands are not necessary if the downstream USB port on the cape is populated. In this case, the modem is self-detected.</i>
+
** You can also check that ports will be assigned for the modem by :
 +
<code>
 +
ls /dev/ttyUSB*
 +
 
 +
/dev/ttyUSB0  /dev/ttyUSB1  /dev/ttyUSB2
 +
</code>
 +
** Now , provided you have USERNAME, PASSWORD, APN for the SIM card
  
 
=== Compiling the SD card image from the Scratch ===  
 
=== Compiling the SD card image from the Scratch ===  

Revision as of 06:37, 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.
    • 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

    • Now , provided you have USERNAME, PASSWORD, APN for the SIM card

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

Retrieved from "http://wiki.yantrr.com/index.php?title=Vayu_Cape_SW_images_and_drivers&oldid=127"