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

From Yantrr Wiki
Jump to: navigation, search
(→‎Basic steps)
(→‎Basic steps)
Line 19: Line 19:
 
** Helpful functions for operating GPIOs  
 
** Helpful functions for operating GPIOs  
 
==== Basic steps ====
 
==== Basic steps ====
−
** Download image file and flash to a 4GB SD CARD.  
+
Steps:
−
** Attach cape to beaglebone black and boot from sd card.  
+
* Download image file and flash to a 4GB SD CARD.  
−
** Keep USB cable unattached at first. Place a WCDMA enabled SIM card in the SIM card slot.
+
* Attach cape to beaglebone black and boot from sd card.  
−
** After booting, turn on the modem by one of these options:
+
* Keep USB cable unattached at first. Place a WCDMA enabled SIM card in the SIM card slot.
−
*** Pressing switch S1 for 4 seconds and releasing, or
+
* After booting, turn on the modem by one of these options:
−
*** Issue the commands:
+
** Pressing switch S1 for 4 seconds and releasing, or
−
<code>
+
** Issue the commands:
 +
<pre>
 
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.  
−
 
+
* 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.
−
** After some time, LED D4 should start blinking to indicate modem has turned on.  
+
* Check that modem is visible on the USB bus by:
−
** 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.
+
<pre>
−
** Check that modem is visible on the USB bus by:
+
−
<code>
+
 
lsusb
 
lsusb
  
Line 44: Line 41:
 
Bus 002 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
 
Bus 001 Device 007: ID 21f5:2012
−
</code>
+
</pre>
  
−
** You can also check that ports will be assigned for the modem by :
+
* You can also check that ports will be assigned for the modem by :
−
<code>
+
<pre>
 
ls /dev/ttyUSB*
 
ls /dev/ttyUSB*
  
 
/dev/ttyUSB0  /dev/ttyUSB1  /dev/ttyUSB2
 
/dev/ttyUSB0  /dev/ttyUSB1  /dev/ttyUSB2
−
</code>
+
</pre>
  
 
** The modem is now ready for use with pon/poff, ppp, Wvdial or any other dialer program.
 
** The modem is now ready for use with pon/poff, ppp, Wvdial or any other dialer program.

Revision as of 07:47, 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:

Download Files:

  • 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

Basic steps

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
    • The modem is now ready for use with pon/poff, ppp, Wvdial or any other dialer program.

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

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