Enfora Enabler IIIE User manual

EDG0308IG001 Page 1 Rev. 1.00 – 04/08/2008
SDK Guide
EDG0308SD001
Enabler IIIE
SDK Guide
Revision 1.00

Document Title: Enfora Enabler IIIE SDK Guide
Version: 1.00
Date: 06/26/08
Status: Released
Document Control ID: EDG0308SD001
General
All efforts have been made to ensure the accuracy of material provided in this document at
the time of release. However, the items described in this document are subject to continuous
development and improvement. All specifications are subject to change without notice and
do not represent a commitment on the part of Enfora, Inc. Enfora, Inc. will not be responsible
for any loss or damages incurred related to the use of information contained in this document.
This product is not intended for use in life support appliances, devices or systems where a
malfunction of the product can reasonably be expected to result in personal injury. Enfora,
Inc. customers using, integrating, and/or selling this product for use in such applications do so
at their own risk and agree to fully indemnify Enfora, Inc. for any damages resulting from
illegal use or resale.
Copyright
Complying with all applicable copyright laws is the responsibility of the user. Without limiting
the rights under copyright, no part of this document may be reproduced, stored in or
introduced into a retrieval system, or transmitted in any form or by any means (electronic,
mechanical, photocopying, recording or otherwise), or for any purpose, without the express
written permission of Enfora, Inc.
Enfora may have patents, patent applications, trademarks, copyrights or other intellectual
property rights covering subject matter in this document. Except as expressly provided in any
written license agreement from Enfora, the furnishing of this document does not give you any
license to these patents, trademarks, copyrights or other intellectual property.
©2002, 2003, 2004, 2005, 2006, 2007, 2008 Enfora, Inc. All rights reserved.
Enabler and Spider are either registered trademarks or trademarks of Enfora, Inc. in the
United States.

The Enfora SDK (Software Developer’s Kit) is designed to allow Enfora partners to
evaluate the Enfora Enabler III module and develop their own applications that will use
the Enfora Enabler module.
J3D1 Current
Measurement Header
SIM Holder
Enabler
Module
GSM/GPRS
Antenna Connector
DB-9 Serial
Connection
J601
SW200
Power Switch
Power Input Port
J202
SW203 PWR
CNTL
Serial Port Status
LED’s
GPIO Status
LED’s
GPIO DIP Switch
SW401
Debug Headers
J204 Power
Source Select
Handset Speaker
and Microphone
Jacks
J702 & J703
SW201 Reset*
Headset
Jack
J700
Keyboard*
Mini USB
Debug Serial
Port DB9 - J502
J200
J203
Figure 1 – SDK0308
*Implementation varies – see table
Quad Band
GSM/GPRS
Antenna
EDG0308IG001 Page 1 Rev. 1.00 – 06/26/2008

Switches and Jumpers
Switch Functionality Default Position
SW200 Turn modem power on from
power connectors J202 or
P200
Off - Once a power supply
has been applied to J202 or
P200 it may be placed in the
on position to power on
SDK and/or modem
SW201 Momentary switch:
Temporarily applies ground
to the RESET pin and resets
the modem.
Open
SW203 Momentary switch:
temporarily applies ground
to \PWR_CNTL pin (pin 35
of modem)
J200 must be set to
SWITCH setting to
manually control
\PWR_CTL (pin 35).
SW401 GPIO DIP Switch Up is
open, down is closed All switches open
J200 \PWR_CTL jumper, if
jumpered to GND setting,
ground will always be
applied to Pin 35 of the
modem, automatically
powering on. To manually
control \PWR_CTL, jumper
to SWITCH setting and
control with SW203
Jumper installed to GND
setting.
J203 Selects assertion level of
reset function (SW201) Default position of J203 shown. Use Active Low for
EDG0308.
J204 Switches main power
source between J202 (to the
left) and P200 (right)
To the left - using J202
J301 Current measurement
header. Remove jumper to
facilitate current
measurement of modem
Jumper installed
EDG0308IG001 Page 2 Rev. 1.00 – 06/26/2008

RF connector
There are two RF cable assemblies. An SMA Connector has been provided to facilitate
using an external antenna (or port to test equipment) as well as an RF cable assembly
connecting an internal quad band antenna.
External SIM Connector
An external SIM connector is provided on the SDK. Users may use either the external
SIM or a SIM connector on the module (if configured), but not both at the same time.
The SIM CLOCK, control and data lines are physically the same lines that go to the on
board SIM. SIM’s cannot be installed both on the external SIM connector and the on
board SIM connector. It must be one or the other.
Audio Section
The audio section has a 4-pole stereo headset connector (J700) and separate speaker and
microphone handset connectors (J702 and J703). The audio path is configured with
AT$VSELECT command. AT$VSELECT=0 selects handset and AT$VSELECT=1
selects headset. Please see the AT command manual for the audio level commands.
GPIO Section
DIP switches and LED’s have been provided to help facilitate testing of GPIO and GPIO
based events. Each GPIO is tied to a DIP switch (SW401) and pulled up high through a
resistor. If the GPIO is configured as an input (See AT$GPIOCFG), a high or low can be
applied to each GPIO line by setting the corresponding DIP switch to open or closed. If
it is open, the line will be pulled high. If it is closed the line will be pulled low.
Each GPIO line also has a corresponding LED. These LED’s show the current state of
the GPIO. The opposite side of the LED is tied to ground. If the LED is illuminated,
then the GPIO line is high. If it is not illuminated, then the GPIO line is low
Serial Ports
The SDK has a standard serial port and serial debug port. The RS232 modem port (J601)
is the modem primary serial port. Prior to RS 232 conversion, each hardware line is tied
to a status LED. On the opposite side of the LED, each is tied to ground. If the LED is
illuminated the line is high, if it is not illuminated, the line is low.
The debug serial port (J502) is used for modem debugging and is for Enfora use only.
There is no control of the modem through the debug serial port.
Power Input Port
J202 is the power input port. The connector is of size 1.3mm inner and 3.8mm outer.
Centre pin is positive. Power supply input range is 4.5V – 9V maximum.
Debug headers
J400, J401, J403 and J404, located in the center of the board, bring each line from the
100-pin connector to a header pin, for ease of monitoring and troubleshooting.
EDG0308IG001 Page 3 Rev. 1.00 – 06/26/2008

To use some features on the SDK, jumpers must be placed on the debug headers to link in
the feature. Removal of the jumper will isolate the SDK feature from the module to
allow for external circuitry to be added via the headers without interference from the
SDK.
The Factory Default for the Debug header jumper settings are: (all other pins are not
jumpered)
J401:
LED_A > LEDA_J
VRWLED > VRWLEDJ
J403:
UART2_TX > UART2_TX_J
UART2_RX > UART2_RX_J
USB_VBUS > USB_VBUS_J
DTR > DTR_J
CTS > CTS_J
RTS > RTS_J
TX > TX_J
DSR > DSR_J
DCD > DCD_J
RX > RX_J
RING > RING_J
I2C_DA > I2CDA
I2C_CK > I2CCK
_VBAK > VBAK
J404:
KBR0 > _KBR0
KBR1 > _KBR1
KBR2 > _KBR2
KBR3 > _KBR3
KBR4 > _KBR4
KBC0 > _KBC0
KBC1 > _KBC1
KBC2 > _KBC2
KBC3 > _KBC3
KBC4 > _KBC4
VRIO > VRIO_J
COM_E > GND
EDG0308IG001 Page 4 Rev. 1.00 – 06/26/2008

Configuring the Enfora module
To communicate with, and configure the Enfora module, connect the serial connector of
the SDK to the serial port of a PC. From a Windows PC, you can use HyperTerminal to
configure the module. Please follow these instructions to correctly configure
HyperTerminal:
a. Start HyperTerminal
On Windows XP, click on:
Start>Programs>Accessories>Communications>HyperTerminal
1. You should see the following screen.
Note: Since the default baud rate of the EDG0308 module is 460,800, you
will need to select COM3 or higher as the communication port.
2. Enter a name for the Connection. In this example, the Name is
Enfora Com3.
3. Click OK.
4. The next window that will appear is the Connect To window.
EDG0308IG001 Page 5 Rev. 1.00 – 06/26/2008

5. In the Connect Using field, make sure the correct Com port is
selected.
6. Click OK.
7. The next window is the Port Settings window.
EDG0308IG001 Page 6 Rev. 1.00 – 06/26/2008

8. Make sure the settings match the example.
9. Click OK.
10. Now the Main Program Window should appear.
11. Terminal Setup Testing.
a. Make sure the cursor is in the main window.
b. Type “AT” and press “Enter”
c. You should see the modem respond back with “OK” in the
Main Window
d. If this happens, the COM port is configured correctly.
e. At this point you are ready to start configuring your SDK with
AT commands.
EDG0308IG001 Page 7 Rev. 1.00 – 06/26/2008

EDG0308IG001 Page 8 Rev. 1.00 – 06/26/2008
Modem Settings that Allow for Automated GSM and GPRS Network Connectivity
1. Open the HyperTerminal connection that you configured in the previous section.
2. Type AT and press <ENTER> the modem should respond with OK. This will
verify that you are communicating with the modem. If you cannot see characters
entered on the screen, enter ATE1V1.
3. To perform a PDP context activation on a network, the following commands need
to be used:
AT&F (Default configuration)
AT+CREG=2 (status GSM registration)
AT%CGREG=2 (Status GPRS attach)
AT+CGDCONT=1,"IP","APN","",0,0 (.APN value will be provided by carrier. )
AT%CGPCO=1,"username,password",1 (Set Type of Authentication, Username and
Password if is need it)
AT+CPIN="xxxx" (xxx is a PIN number for SIM card if
needed)
AT$AREG=2 (auto GPRS activation on power up of
device)
AT&W (save the configuration)
SDK Tips
Before using the SDK for the first time, please make sure you remove all packing
material from the SDK (tape, etc.).
Enfora Parts
The SDK includes: The SDK Board and AC/DC “Wall-Pack” Power Supply. (Note:
The AC/DC Adapter is only supplied in the United States.)
There are optional accessories that you may need in addition to the Enfora module. Some
examples of these accessories are listed below. Please contact your Enfora sales
representative for specific part information, and ordering information.
•Molex Connector
•SIM Card Holder
User Manuals
EDG0308AT001.pdf – Enabler IIIE AT Command Set
EDG0308IG001.pdf - Enabler IIIE Integration Guide