From the command line, execute the following command to talk directly to the CELLv1.0:

sudo minicom -b 115200 -o -D /dev/ttyAMA0

If you don’t have minicom, install it with the following command:

sudo apt-get install minicom

Additional tools necessary:

1. Raspberry Pi 3
2. USB micro cable (for power)
3. 8GB SD card for Raspberry Pi (above 4GB should work)
4. USB keyboard
5. HDMI monitor and cable
6. Ethernet cable connected to the internet
7. A computer with WinSCP and access to the same network as the Raspberry Pi

Plug the CELLv1.0 into the Raspberry Pi Shield and the Raspberry Pi Shield into the Raspberry Pi. Micro USB cable to the Raspberry Pi and Micro USB cable to the CELLv1.0 is required. The CELLv1.0 must also have an antenna attached and SIM card in order to communicate over the cellular network. This Raspberry Pi requires additional connection through either an Ethernet cable or keyboard and HDMI monitor is used to connect to the Raspberry Pi. The Raspberry Pi also must be booted with a specific OS.

There are issues with the new UART on the Raspberry Pi 3 as the baud rate fluxuates due to clock changes.  Therefore, the current work-around is to re-enable the UART and disable the bluetooth interface.

1. Download:
   1. MAIN ZIP file from http://www.sparqee.com/code/raspberryPi_shieldR_v1/RaspberryPi_setup__for3.zip
2. Unzip the archive
   1. Format your SD card using the SD Card Association’s formatting tool.
      1. NOTE: Windows version is included in MAIN ZIP
      2. NOTE: Original sourced from: https://www.sdcard.org/downloads/formatter_4/eula_windows/
      3. Install and run the Formatting Tool on your machine
      4. Click on the “Option” menu, Set “Quick Format,” Set “FORMAT SIZE ADJUSTMENT” option to “ON”
      5. Check that the SD card you inserted matches the one selected by the Tool
      6. Click the “Format” button
   2. Raspian OS installation
      1. Unzip “NOOBS_v1_9_1.zip” onto the SD card
      2. NOTE: OS is included in MAIN ZIP
      3. NOTE: Original sourced from: http://www.raspberrypi.org/downloads
      4. Insert the SD card into the Raspberry Pi
      5. Power the Raspberry Pi using the USB to micro cable, HDMI for video, and keyboard
      6. To Press enter to select Raspbian, press ‘l’ to install your language and keyboard, press ‘i’ to install and press enter for “yes”
      7. After booting select “finish”
   3. Using the keyboard and monitor, login to the Raspberry Pi
      1. user/pass – pi/raspberry
   4. Find the IP address of the Raspberry Pi in order to WinSCP files over (the Raspberry Pi is setup with DHCP so the ethernet cable should be plugged into a network with a DHCP server and internet to install required packages)
      1. Execute $ ifconfig
      2. The IP address is to the right of “inet addr:”
      3. SCP to the above IP address
   5. Transfer remaining files to “/home/pi” including:
      1. test_v1.py
   6. Install required libraries:
      1. NOTE: Original sourced from: https://pypi.python.org/pypi/RPi.GPIO

   sudo apt-get install python-usb
   sudo apt-get install python-serial
   wget http://pypi.python.org/packages/source/R/RPi.GPIO/RPi.GPIO-0.6.2.tar.gz
   tar zxf RPi.GPIO-0.6.2.tar.gz
   cd RPi.GPIO-0.6.2/
   sudo apt-get update
   sudo apt-get upgrade
   sudo apt-get install python-dev python3-dev
   sudo python setup.py install

3. Edit /boot/cmdline.txt
   1. remove “console=serial0,115200”
4. Edit /boot/config.txt
   1. add “dtoverlay=pi3-miniuart-bt”
   2. NOTE: This change may eliminate bluetooth functionality on the Pi3
5. Transfer files to the “/home/pi” directory:
   1. test_v1.py
6. Make the script executable with the command

   sudo chmod 755 test_v1.py

7. Reboot the Raspberry Pi

   sudo reboot

8. Run the test with the command

   sudo ./test_v1.py

9. Minicom for testing

   sudo minicom -b 115200 -o -D /dev/ttyAMA0
   Note: use "sudo apt-get install Minicom"
   

Additional tools necessary:

1. Raspberry Pi (Works with B+/2/3)
2. USB micro cable (for power)
3. 8GB SD card for Raspberry Pi (above 4GB should work)
4. USB keyboard
5. HDMI monitor and cable
6. Ethernet cable connected to the internet
7. A computer with WinSCP and access to the same network as the Raspberry Pi

Plug the CELLv1.0 into the Raspberry Pi Shield and the Raspberry Pi Shield into the Raspberry Pi. Micro USB cable to the Raspberry Pi and Micro USB cable to the CELLv1.0 is required. The CELLv1.0 must also have an antenna attached and SIM card in order to communicate over the cellular network. This Raspberry Pi requires additional connection through either an Ethernet cable or keyboard and HDMI monitor is used to connect to the Raspberry Pi. The Raspberry Pi also must be booted with a specific OS.

1. Download:
   1. NOOBS_v1_4_0 from http://www.raspberrypi.org/downloads/
   2. “MAIN ZIP” file from http://www.sparqee.com/code/raspberryPi_shieldR_v1/RaspberryPi_setup2__for2.zip
2. Unzip the archive
   1. Format your SD card using the SD Card Association’s formatting tool.
      1. NOTE: Windows version is included in MAIN ZIP
      2. NOTE: Original sourced from: https://www.sdcard.org/downloads/formatter_4/eula_windows/
      3. Install and run the Formatting Tool on your machine
      4. Click on the “Option” menu, Set “Quick Format,” Set “FORMAT SIZE ADJUSTMENT” option to “ON”
      5. Check that the SD card you inserted matches the one selected by the Tool
      6. Click the “Format” button
   2. Raspian OS installation
      1. Unzip “NOOBS_v1_4_0.zip” onto the SD card
      2. NOTE: OS is included in MAIN ZIP
      3. NOTE: Original sourced from: http://www.raspberrypi.org/downloads
      4. Insert the SD card into the Raspberry Pi
      5. Power the Raspberry Pi using the USB to micro cable, HDMI for video, and keyboard
      6. To Press enter to select Raspbian, press ‘l’ to install your language and keyboard, press ‘i’ to install and press enter for “yes”
      7. After booting select “finish”
   3. Using the keyboard and monitor, login to the Raspberry Pi
      1. user/pass – pi/raspberry
   4. Find the IP address of the Raspberry Pi in order to WinSCP files over (the Raspberry Pi is setup with DHCP so the ethernet cable should be plugged into a network with a DHCP server and internet to install required packages)
      1. Execute $ ifconfig
      2. The IP address is to the right of “inet addr:”
      3. SCP to the above IP address
   5. Transfer remaining files to “/home/pi” including:
      1. cmdline.txt
      2. inittab
      3. test_v1.py
   6. Install required libraries:
      1. NOTE: Original sourced from: https://pypi.python.org/pypi/RPi.GPIO

   sudo apt-get install python-usb
   sudo apt-get install python-serial
   wget http://pypi.python.org/packages/source/R/RPi.GPIO/RPi.GPIO-0.5.3a.tar.gz
   tar zxf RPi.GPIO-0.5.3a.tar.gz
   cd RPi.GPIO-0.5.3a/
   (may need if the following fails) sudo apt-get update
   sudo apt-get install python-dev python3-dev
   sudo python setup.py install

   1. OPTIONAL: Americanize keyboard and time:
      1. http://rohankapoor.com/2012/04/americanizing-the-raspberry-pi/
3. Transfer files to the “/home/pi” directory:
   1. cmdline.txt
   2. inittab
   3. test_v1.py
4. Replace the original “cmdline.txt” with the command

   sudo cp cmdline.txt /boot/cmdline.txt

5. Replace the original “inittab” with the command

   sudo cp inittab /etc/inittab

6. Make the script executable with the command

   sudo chmod 755 test_v1.py

7. Run the test with the command

   sudo ./test_v1.py

#!/usr/bin/python

import SparqEE #version 1
import re
import signal
import sys

# GLOBALS --------------------------------------------------------------------

SparqEE.glob_debug = 5                      #Override global debug print level   

def debug(str):
    SparqEE.debug_print( str, SparqEE.debug["DEBUG"] )

def debug2(cmd, ret):
    debug(cmd)
    debug( "---> CMD RET --->: " + str(ret) )
    debug( "---> BUFFER  --->" + SparqEE.buffer )

#-----------------------------------------------------------------------------

try:
    SparqEE.cmd_setup()                     #set-up shield GPIO
    SparqEE.cmd_power()                     #power on
    SparqEE.cmd_connection()                #check cellular connection

    #BASIC AT COMMANDS
    #Nickname                       #at command     #Description

    ret = SparqEE.at_status()       #at_at          #Quick status
    debug2 ("STATUS", ret)

    ret = SparqEE.at_echoOn()       #at_ate1        #Enable command echo
    debug2 ("ECHO", ret)

    ret = SparqEE.at_reg()          #at_creg        #Network registration status
    debug2 ("REG", ret)

    ret = SparqEE.at_nets()         #at_cops        #List available networks
    debug2 ("NETS", ret)

    ret = SparqEE.at_tech()         #at_cnti        #Current tech
    debug2 ("TECH", ret)

    ret = SparqEE.at_sig()          #at_csq         #Signal Quality
    debug2 ("SIG", ret)

#-----------------------------------------------------------------------------

    SparqEE.debug_print( "***END***", SparqEE.debug["WARNING"] )
    SparqEE.cmd_cleanup()                   #clean-up shield GPIO

except:
    SparqEE.debug_print( "***END (exception)***", SparqEE.debug["CRITICAL"] )
    SparqEE.cmd_cleanup()                   #clean-up shield GPIO
    print "Unexpected error:", sys.exc_info()[0]
    raise

#!/usr/bin/python

import SparqEE #version 1
import re
import signal
import sys

# GLOBALS --------------------------------------------------------------------

SparqEE.glob_debug = 5              #Override global debug print level   

def debug(str):
    SparqEE.debug_print( str, SparqEE.debug["DEBUG"] )

def debug2(cmd, ret):
    debug(cmd)
    debug( "---> CMD RET --->: " + str(ret) )
    debug( "---> BUFFER  --->" + SparqEE.buffer )

#-----------------------------------------------------------------------------

try:
    SparqEE.cmd_setup()             #set-up shield GPIO
    SparqEE.cmd_power()             #power on
    SparqEE.cmd_connection()        #check cellular connection

    #BASIC SMS
    ret = SparqEE.at_sms("+12223334444", "20140902 1:00pm testing sms")
    debug2 ("STATUS", ret)

#-----------------------------------------------------------------------------

    SparqEE.debug_print( "***END***", SparqEE.debug["WARNING"] )
    SparqEE.cmd_cleanup()           #clean-up shield GPIO

except:
    SparqEE.debug_print( "***END (exception)***", SparqEE.debug["CRITICAL"] )
    SparqEE.cmd_cleanup()           #clean-up shield GPIO
    print "Unexpected error:", sys.exc_info()[0]
    raise

This option uses SMS-over-IP which essentially creates a TCP connection and used an SMS gateway to send the text to an endpoint.

ret = SparqEE.at_webopen()         #at_zipcallOpen      #start call - state 1 open
ret = SparqEE.at_websetup(1,0,"23.253.146.203",9999) #at_zipopen #socketId,type(TCP=0),IP,Port
ret = SparqEE.at_websend(1)        #at_zipsend          #send data
msg = "SABCDWXYZ+12223334444 Hello!\n\n"
ret = SparqEE.at_webmsg(msg)       #at_zipwrite
ret = SparqEE.at_webclose()        #at_zipcallClose     #stop call - state 0 close

You’ll notice the line:

msg = "SABCDWXYZ+12223334444 Hello!\n\n"

The user is ABCD and the pass is WXYZ. You’ll have to use your credentials which are available under your SparqSIM account under “Services”->”Source Credentials”. That line will look something like the following for non ASCII characters:

msg = "S" + chr(0x41) + chr(0x42) + chr(0x43) + chr(0x44) + chr(0x57) + chr(0x58) + chr(0x59) + chr(0x5a) + "+12223334444 Hello!\n\n"

Where 0x41 = ‘A’ … 0x5a = ‘Z’

#!/usr/bin/python

import SparqEE #version 1
import re
import signal
import sys

# GLOBALS --------------------------------------------------------------------

SparqEE.glob_debug = 5              #Override global debug print level   

def debug(str):
    SparqEE.debug_print( str, SparqEE.debug["DEBUG"] )

def debug2(cmd, ret):
    debug(cmd)
    debug( "---> CMD RET --->: " + str(ret) )
    debug( "---> BUFFER  --->" + SparqEE.buffer )

#-----------------------------------------------------------------------------

try:
    SparqEE.cmd_setup()             #set-up shield GPIO
    SparqEE.cmd_power()             #power on
    SparqEE.cmd_connection()        #check cellular connection

    #BASIC WEB QUERY
    #Nickname                                               #at command         #Description
    ret = SparqEE.at_webopen()                              #at_zipcallOpen     #start call - state 1 open
    debug2 ("WEBOPEN", ret)

    ret = SparqEE.at_websetup(1,0,"www.dbunplugged.com",80) #at_zipopen         #socket id,type(UDP=1,TCP=0),hostname/IP,Port
    debug2 ("WEBSETUP", ret)

    ret = SparqEE.at_websend(1)                             #at_zipsend         #send data
    debug2 ("WEBSEND", ret)

    msg = "GET /ip HTTP/1.1\r\nHost: www.dbunplugged.com\r\n\r\n"
    ret = SparqEE.at_webmsg(msg)                            #at_zipwrite
    debug2 ("WEBMSG", ret)

    ret = SparqEE.at_webclose()                             #at_zipcallClose    #stop call - state 0 close
    debug2 ("WEBCLOSE", ret)

#-----------------------------------------------------------------------------

    SparqEE.debug_print( "***END***", SparqEE.debug["WARNING"] )
    SparqEE.cmd_cleanup()           #clean-up shield GPIO

except:
    SparqEE.debug_print( "***END (exception)***", SparqEE.debug["CRITICAL"] )
    SparqEE.cmd_cleanup()           #clean-up shield GPIO
    print "Unexpected error:", sys.exc_info()[0]
    raise

BASIC – Raspberry Pi

This example is a quick guide to establish a PPP connection providing you an IP address and internet gateway through the CELLv1.0. This example uses a great script called Sakis3g and attempts to give you the quick and dirty for getting it working with the Raspberry Pi.

Please comment on the forum if you have any questions or something is missing.

Command                                                 Notes
sudo apt-get update                                     Make sure you are up to date
sudo apt-get install ppp                                Install PPP
wget "http://www.sparqee.com/code/cellv1/sakis3g.gz"    Grab the sakis3g script
gunzip sakis3g.gz                                       Unzip it
chmod +x sakis3g                                        Make it executable

Run the Script: 
sudo ./sakis3g connect --console --nostorage --pppd APN="Internetd.gdsp" BAUD=115200 CUSTOM_TTY="/dev/ttyAMA0" MODEM="OTHER" OTHER="CUSTOM_TTY" APN_USER="user" APN_PASS="pass" 

If everything goes well, you should be presented with something like: 
"MF206A connected to DATA ONLY (310410)." 
This means it's connected!!! 

To validate that you are online, check two things: 
1. "ifconfig" - make sure you were assigned an IP address on interface ppp0 
2. "curl www.dbunplugged.com/ip" - it should return the public IP address, <br>, and the time 

Kill the Script: 
sudo ./sakis3g disconnect

BASIC – Linux (tested on Ubuntu 14.04)

Same steps as the Raspberry Pi except the script is going to be something like the following. You may have to change some parameters as noted:

sudo ./sakis3g connect --nostorage --pppd APN="Internetd.gdsp" APN_USER="user" APN_PASS="pass" USBINTERFACE="1" USBDRIVER="option" OTHER="USBMODEM" USBMODEM="19d2:0117" 

    OPTION          NOTE
    APN             Should be the APN from your particular provider (typically on the SIM card package)
    APN_USER        Same as APN, but for username.  If none, leave as-is
    APN_PASS        Same as APN, but for password.  If none, leave as-is
    USBINTERFACE    The 'X' digit(s) following the USB modem from /dev/ttyUSBX
    USBMODEM        USB Modem MAC addr from "lsusb" (when the modem is on), ex: 19d2:0117

If everything goes well, you should be presented with something like:
"MF206A connected to DATA ONLY (310410)."
This means it's connected!!!

INTERMEDIATE

Here are two troubleshooting options that work consistently if the modem is having problems connecting. Without legitimate error messages, make sure these two tricks are tried first:

    1. Reset the Modem by:Toggle power (unplug/plug back in)
        -Pull "PRN" to ground momentarily
        -Verify the modem is talking by sending a few "at<enter>" commandsUbuntu 14.04: sudo minicom -b 115200 -o -D /dev/ttyUSB1
    2. Raspberry Pi: sudo minicom -b 115200 -o -D /dev/ttyAMA0

Note: A potential automation fix is to add “ATH” to the dialer script needs in order to hang up previous sessions.

ADVANCED

Interesting options for the sakis3g command:

    OPTION          NOTE
    --console       All from the terminal, no ActiveX gui
    --debug         Debug information
    --googledns     Use google dns servers instead of those provided by the peer
    --interactive   Enter interactive mode versus using the command options

View the Manpages:

    1. sudo ./sakis3g man
        -Helpful options for the command line
        -Automation information (about startup)
    2. sudo ./sakis3g man sakis3g_config
        -Eliminate command line options by putting options in a config file

Troubleshooting Commands:

    Command                       Notes
    tail -f /var/log/messages     Debug information
    tail -f /var/log/syslog       Debug information
    lsusb                         Information about USB devices/drivers
    dmesg                         Debug information
    netstat -nr                   Routing/Networking information
    ifconfig -a                   Networking interfaces
    cat /etc/resolv.conf          Routing information
    http://en.wikipedia.org/wiki/Hayes_command_set
                                  Exhaustive set of commands for modem

Troubleshooting:

Using minicom, see what the SIM card reports for the command

    at+cgdcont=?

With the SparqSIM SIM card, it should include "Internetd.gdsp" and look something like this:

    +CGDCONT: 1,"IP","Internetd.gdsp","0.0.0.0",0,0

If the APN isn't correct, then enter the following and try again:

    at+cgdcont=1,"IP","Internetd.gdsp"