VIBEQ

From Yantrr Wiki
Revision as of 07:43, 14 May 2018 by Vaibhav (Talk | contribs) (→‎AT Commands Manual)

Jump to: navigation, search

Overview

Quick Start Guide

Board Layout

VIBEQ Top View

Jumpers

Jumper Description
J2 Battery connection bypass jumper, for non BATT-UPG configurations this jumper should be closed.
J3 Boost section bypass jumper, for non BATT-UPG configurations this jumper should be closed.

Switches

Switch Description
S1 Reset switch
S2 Boot switch
S3 Power switch
S4 Modem ON/OFF switch
S5 Modem Reset switch
S7 Cape address switch

LEDs

LED Description
D1 Power LED
D2 User LED 0
D3 User LED 1
D4 User LED 2
D5 User LED 3
D13 Modem Power LED
D14 Modem operation status LED
D15 Modem network activity status LED
D16 Modem network registration mode LED
D18 Cape Side Power LED
D20 Diagnostic status LED

Getting Started

Setting up the system

  1. Place 3V coin cell(supplied with VIBEQ) in the holder for RTC.
  2. Place a data enabled mini-SIM in the SIM card slot and connect a GSM antenna to the respective main antenna connector using uFL connectors.
  3. Ensure that the power jumpers J2 and J3 on VIBEQ are in place and eeprom address set at 0x54 using dip switch S7
  4. Power up VIBEQ using the 5V,5A DC adapter (supplied with VIBEQ).

Before proceeding further ensure D1 LED is glowing properly. Make sure that the adapter being used is of proper rating and has been connected properly.

Before powering down the system always ensure to Turn OFF the Modem using the PWRKEY turn ON/OFF control pin or using the AT Command AT+QPOWD.

Accessing the System

Modem Ports

VIBEQ has an option between 3G/HSPA+ and 4G/LTE,CAT4 modem for WAN connectivity.

  • 3G Modem : VIBEQ-3GUC20-x comes with Quectel UC20 3G modem.
  • 4G Modem : VIBEQ-4GEC25-x comes with Quectel EC25 4G modem.

Both 3G/4G modem creates 5 ports :

  1. /dev/ttyUSB0  : DM
  2. /dev/ttyUSB1  : For GPS NMEA message output
  3. /dev/ttyUSB2  : For AT commands
  4. /dev/ttyUSB3  : For PPP connections or AT commands
  5. /dev/cdc-wdm0  : QMI WWAN Port

Modem Control

Please ensure that the modem is properly turned on before ppp connections can be established. If PPP connection cannot be established properly, soft reset the modem following the timing procedures for modem.

The modem can be powered on/off by either using the push button switch S4 or GPIO45.

Power on

The module will be turned off after power-on(when power is supplied) normally. In the state of power off, provide a high level pulse atleast for 100 Milliseconds to ON/OFF PIN to turn on the module by either toggling the push button switch or by cycling the GPIO through Low-High cycle.

The default state of ON/OFF GPIO should be low. 

cd /sys/class/gpio
echo 45 > export
cd gpio45
echo “low” > direction

cd /sys/class/gpio/gpio45
echo "high" > direction
sleep 0.1
echo "low" > direction

In Yantrr Pre-Compiled VIBEQ Boot Image, all modem related GPIOs are set for its desired usage, hence the modem will get powered ON on its boot up.

Check that modem is visible on the USB bus by : 

root@Yantrr:~# lsusb 
Bus 002 Device 002: ID 2c7c:0125  
Bus 002 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 001 Device 002: ID 0424:2412 Standard Microsystems Corp. 
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub

In Yantrr Pre-Compiled VIBEQ Boot Image, for ease of user these regular commands with the GPIOs have been created as functions : pinexp, setout, setin, pinread. 

pinexp 45
pinexp 44
setout 45 low
setout 44 high

Power off

In the state of Power On, provide atleast a 700 Milliseconds low level pulse to ON/OFF PIN to turn off the module. 

cd /sys/class/gpio/gpio45
echo "high" > direction
sleep 0.7
echo "low" > direction

Soft Reset

To soft reset the modem, cycle the Modem On/Off pin through a Power-Off and then Power-On cycle. i.e.

  1. Power Off the Modem.
  2. Wait for 1-2s atleast.
  3. Power on the modem.

Hard Reset

There might arise situations where modem does not seem to be responding to any commands issued on AT commands port or it cannot be turned on/off. In such scenarios, issue hard reset to the modem. It can be done by either toggling Switch S5 for atleast 500ms or pulling GPIO44 low for 1s and then setting it high again. 

cd /sys/class/gpio/
cd gpio44
echo "low" > direction
sleep 0.5
echo "high" > direction

Please use hard reset conservatively. Soft reset should be preferred under most conditions.

PPP connection using wvdial

Download and install Wvdial 

apt-get install wvdial

Open the wvdial.conf file 

$ nano /etc/wvdial.conf

Assuming that you have the USERNAME, PASSWORD and APN available for the service provider of the sim card being used, edit and make wvdial.conf file like this. Sample wvdial.conf file for AT&T and T-Mobile USA 

[Dialer Defaults]
Modem Type = Analog
ModemPhone = *99#
ISDN = 0
Baud = 115200
Username = USERNAME
Password = PASSWORD
Modem = /dev/ttyUSB3
Init1 = ATZ
Init2 = ATQ0 V1 E1 S0=0 &C1 &D2 +FCLASS=0
Init3 = at+cgdcont=1,"ip","APN"
Stupid Mode = 1

Usually for GSM Networks, Modemphone is *99# or *99***1#. Consult your network provider for exact details in case you are facing difficulties. After editing, save and exit, now run wvdial for establishing communication. 

$ wvdial

If all parameters are correct and everything is working, you should see a success message from wvdial. Once PPP connection has been established, you will see a ppp0 IP.

To check the status of wvdial and find out its IP open a new shell and use either of following:

  • Run ifconfig and find ppp0 in the list of network connections.
$ ifconfig
or
$ ifconfig ppp0
  • Check the network statistics for IP and their gateways and check the Iface column for ppp0
$ netstat -arn
* Kernel IP routing table 

Destination Gateway Genmask Flags MSS Window irtt Iface
0.0.0.0 192.168.1.1 0.0.0.0 UG 0 0 0 eth0
192.168.1.0 0.0.0.0 255.255.255.0 U 0 0 0 eth0
192.168.7.0 0.0.0.0 255.255.255.252 U 0 0 0 usb0
192.200.1.21 0.0.0.0 255.255.255.255 UH 0 0 0 ppp0
  • Read the system messages as
$ cat /var/log/messages

It lists all the attempts at establishing ppp communication using the modem and IPs for the successful attempt.

Now all that is left is to route the network traffic over the gateway of ppp0 instead of eth0 so that GPRS communication is fully completed.

GPS

UC20/EC25 GNSS engine allows calculating location without any assistance from the network.

Please note that the /dev/ttyUSB1 is only GPS NMEA message output port

  • Turn ON GNSS 
 AT+QGPS=1

Note : By default GNSS engine is in OFF state on Modem Power Up.

  • Turn OFF GNSS
 AT+QGPSEND
  • Positioning Information
 AT+QGPSLOC?

For more AT commands refer device specific manuals from below section.

AT Commands Manual

All the AT commands can be executed on the serial port /dev/ttyUSB2 with baud rate of 115200 8N1.

Software Setup Guide

Precompiled Images

Applications

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