Digi ConnectPort X4 User manual











iDigi®GatewayDevelopmentKit
GettingStartedGuide
WirelessWANVersion






June8,2011
90001253_A

iDigiGatewayDevelopmentKitGettingStartedGuide–WirelessWANVersion  2

©2011DigiInternationalInc.
Allrightsreserved.

Digi,iDigi,DigiInternational,theDigiandiDigilogos,ConnectPort,DigiESP,iDigiDia,XBee,DigiXBee
SmartPlug,iDigiManagerPro,iDigiWebServicesAPI,andaDigiInternationalCompanyaretrademarks
orregisteredtrademarksofDigiInternational,Inc.intheUnitedStatesandothercountriesworldwide.
Allothertrademarksarethepropertyoftheirrespectiveowners.

Informationinthisdocumentissubjecttochangewithoutnoticeanddoesnotrepresentacommitment
onthepartofDigiInternational.

Digiprovidesthisdocument“asis,”withoutwarrantyofanykind,eitherexpressedorimplied,including,
butnotlimitedto,theimpliedwarrantiesoffitnessormerchantabilityforaparticularpurpose.Digimay
makeimprovementsand/orchangesinthismanualorintheproduct(s)and/ortheprogram(s)described
inthismanualatanytime.

Thisproductcouldincludetechnicalinaccuraciesortypographicalerrors.Changesareperiodicallymade
totheinformationherein;thesechangesmaybeincorporatedinneweditionsofthepublication.


iDigiGatewayDevelopmentKitGettingStartedGuide–WirelessWANVersion  3

UsingthisGuide
ContactInformation
PleasealwayschecktheproductspecificsectionontheDigisupportwebsiteforthemostcurrent
revisionofthisdocument:http://www.digi.com/gatewaydevelopmentkit.

FormoreinformationaboutyourDigiproducts,orforcustomerserviceandtechnicalsupport,contact
DigiInternational.

TocontactDigiInternationalbyUse
MailDigiInternational
1101BrenRoadEast
Minnetonka,MN55343
U.S.A.
WorldWideWebhttp://www.digi.com/support
Telephone(US)(952)912‐3444or(877)912‐3444
Telephone(otherlocations)+1(952)912‐3444or(877)912‐3444

ConventionsusedinthisGuide



Thisiconindicatesastepthathasthepotentialtobe
troublesome.Furtherinformationregardingitems
markedwiththissymbolcanbefoundinAppendixD:
Troubleshootingonpage79.



Thisiconindicatesahint,orconceptthatislearned.


Thisiconindicatesthatagoalofthekithasbeen
completed.

Thisiconindicatesawarningofthepotentialfor
confusionordanger.

iDigiGatewayDevelopmentKitGettingStartedGuide–WirelessWANVersion  4

Contents
UsingthisGuide............................................................................................................................................3
ContactInformation..................................................................................................................................3
ConventionsusedinthisGuide................................................................................................................3
IntroductiontotheiDigi®GatewayDevelopmentKit–WirelessWANVersion...........................................7
GoalsoftheKit..........................................................................................................................................7
RequirementsoftheKit............................................................................................................................7
SystemRequirements...........................................................................................................................7
WebBrowserRequirements.................................................................................................................7
AdditionalRequirements......................................................................................................................7
Part1:SetupyourDigi®GatewayDevelopmentKit......................................................................................8
Step1:KitPreparation..............................................................................................................................8
IdentifyYourKitComponents...............................................................................................................8
Step2:UnpackandSetuptheConnectPortX4........................................................................................9
Step3:ConfiguretheConnectPortX4....................................................................................................10
ConfiguringtheConnectPortX4IPGatewayPriority.........................................................................11
ConfiguringtheEthernetInterface.....................................................................................................12
ViewingIPAddressInformation.........................................................................................................13
ViewingEthernetStatistics.................................................................................................................13
Step4:SetuptheXBeeSmartPlugandXBeeSensor.............................................................................14
Step5:ConnecttheConnectPort®X4toiDigi®........................................................................................15
AddtheConnectPortX4®toyouriDigi®Inventory............................................................................17

iDigiGatewayDevelopmentKitGettingStartedGuide–WirelessWANVersion  5

Step6:InstalltheDigiESP™forPythonDevelopmentEnvironment.....................................................19
Step7:CreateyourfirstiDigi®DiaProject..............................................................................................22
Step8:PerformaniDigiWebServicesAPI™Request............................................................................43
Step9:UsingtheiDigi®GatewayDevelopmentKitDemonstrationApplication....................................50
GettingFamiliarwiththeiDigiGatewayDevelopmentKitDemonstrationApplication....................52
XBee®Sensor:.....................................................................................................................................52
XBeeSmartPlugTM(forUSkitsonly):.................................................................................................53
LoggedData:.......................................................................................................................................54
Part2:LearnMore......................................................................................................................................57
iDigi®Dia&iDigi®.....................................................................................................................................57
GoingtoMarket?................................................................................................................................57
DigiESP™forPython...............................................................................................................................58
Digi’s®GatewayProducts........................................................................................................................63
GatewayFunctionality........................................................................................................................63
Programmability.................................................................................................................................63
XBee®Sensor...........................................................................................................................................64
XBeeSmartPlug™(orXBee®WallRouterinnon‐USkits)......................................................................64
Digi’s®ZigBeeRFModules.......................................................................................................................64
AppendixA:ConfiguringforGSM/EdgeCellularNetworks........................................................................65
Step1:InsertingtheSIMCard(s)............................................................................................................65
Step2:ConfiguringtheCellularInterface...............................................................................................66
AppendixB:ConfiguringforCDMACellularNetworks...............................................................................68
CDMACellularConfigurationExample(Verizon)................................................................................68

iDigiGatewayDevelopmentKitGettingStartedGuide–WirelessWANVersion  6

CDMACellularConfigurationExample(Sprint)..................................................................................72
AppendixC:ConfiguringforWiMAXNetworks..........................................................................................75
Step1:ConnectingtotheConnectPortX4HomePage..........................................................................75
Step2:ConfiguringtheWirelessWANInterfaceforWiMAXNetworks................................................76
Step3:ViewingtheWiMAXConnectionStatus......................................................................................78
AppendixD:Troubleshooting.....................................................................................................................79
XBee®devicesfailtojointheConnectPortX4’sXBee®network.............................................................79
IstheASSCLEDsolidgreen?...............................................................................................................79
IstheASSCLEDblinkinggreen?..........................................................................................................79
iDigiManagerPro™doesnotdiscoveryourConnectPort®X4...............................................................80
iDigiManagerPro™liststheConnectPort®X4as‘Disconnected’..........................................................82

iDigiGatewayDevelopmentKitGettingStartedGuide–WirelessWANVersion  7

IntroductiontotheiDigi®GatewayDevelopmentKit–
WirelessWANVersion
ThankyouforpurchasinganiDigiGatewayDevelopmentKit.Thekitisdesignedtomakeiteasy
tosetupanXBeenetwork,uploadacustomiDigiDiaapplication,andprovideseamless
connectivitytotheiDigiCloudforwebservicesintegrationtostandardbusinessapplications
overtheInternet.Beforeyoustartworkingwiththekit,let’scoversomebasics.
GoalsoftheKit
Asyougothroughthestepsinthiskit,youwill:
1. ConfiguretheWirelessWANinterfaceoftheConnectPortX4.
2. CreateaniDigideveloperaccountontheiDigiM2MoperatingCloud.
3. SetupandconfigurethephysicalelementsofanXBeewirelessnetworkandunderstand
howthenetworkismanagedthroughaConnectPortX4gateway.
4. UsetheDigiESPforPythonIDEtobuild,download,andlaunchaniDigiDiaapplication
foryourConnectPortX4gateway,theninteractwiththeapplicationinarealisticsetting.
5. UsetheiDigiManagerProWebServicesConsoletosendawebservicerequesttothe
ConnectPortX4retrievingthecurrentXBeedevices’sensorreadings.
6. UsetheiDigiGatewayDevelopmentKitDemonstrationApplicationtounderstandhow
anEnterpriseapplicationcouldusetheiDigiWebServicesAPItomonitorthedata
gatheredbytheXBeedevices’sensors.
RequirementsoftheKit
SystemRequirements
ToinstallthesoftwarementionedintheGettingStartedGuide,youwillneedaPCrunningMicrosoft
WindowsXP,VistaorWindows7.
WebBrowserRequirements
MicrosoftInternetExplorer7.0ornewer
GoogleChrome4.0ornewer
MozillaFirefox3.0ornewer
AdditionalRequirements
ThisGettingStartGuideassumesascenariowheretherearenootherXBeewirelessdevicesin
thearea(otherthantheonesprovidedwiththiskit)andthatthelocalnetworkhasanInternet
connection.

Note:IfotherXBeenetworksarepresentandopenforjoining,theXBeeSensorandXBeeSmart
Plugmayjointhewrongnetwork.Pleaserefertothe“XBeedevicesfailtojointheConnectPort
X4’snetwork”sectionofAppendixD:Troubleshootingonpage79formoreinformation.

iDigiGatewayDevelopmentKitGettingStartedGuide–WirelessWANVersion  8

Part1:SetupyourDigi®GatewayDevelopmentKit
Step1:KitPreparation
IdentifyYourKitComponents
Carefullyunpackandverifythecontentsofyourkit.

Figure1:KitComponents
ThetablebelowindicatesthetypeandquantityofcellularorWiMAXantennasincludedinyourkit.
AntennaSprint
X4K‐Z1U‐C1011‐A1
Verizon
X4K‐Z1U‐C2011‐A1
AT&T
X4K‐Z1U‐H2011‐A1
Generic
X4K‐Z1U‐U7011‐A1
WiMAX
X4K‐Z1U‐C6011‐A1
A11111
B22
C 2 2
D 2

iDigiGatewayDevelopmentKitGettingStartedGuide–WirelessWANVersion  9

Step2:UnpackandSetuptheConnectPortX4
TobeginsettingupyouriDigiGatewayDevelopmentKit,youwillneedtoconnecttheantennas
toyourConnectPortX4,connectyourPC’sEthernetcabletotheConnectPortX4,andthen
powerontheConnectPortX4,andthenformyourXBeenetwork.

Figure2:ConnectingHardware
1. RemovetheConnectPortX4fromtheboxandattachtheXBeeantennatotheunit.
2. AttachtheCellularorWiMAXantenna(s)toyourConnectPortX4.
3. ConnectthepowersupplytotheConnectPortX4andthenplugthepowersupplyintoa
walloutlet.
Note:Thepowersupplyhasatwist‐lockingconnector,ensurethattheconnectoris
lockedintoplace.

iDigiGatewayDevelopmentKitGettingStartedGuide–WirelessWANVersion  10

Step3:ConfiguretheConnectPortX4
Note:Bydefault,ConnectPortX4WirelessWANmodelsareconfiguredwithastaticIPAddressof
192.168.1.1fortheEthernetinterface,andtheyareconfiguredtoactasaDHCPServer.This
configurationsimplifiestheinitialconfigurationoftheunit.
1. ConnectoneendoftheEthernetcabletoyourPC,andtheotherendtotheConnectPort
X4Ethernetport(ensurethatyourPCisconfiguredtoobtainitsIPaddressviaDHCP).
2. OpentheWebinterfaceoftheConnectPortX4bynavigatingtothe192.168.1.1address
inaWebbrowseronthePCandyouwillseeascreensimilartothefollowing:

Figure3:WebInterface
3. ConfiguretheConnectPortX4WirelessWANandEthernetinterface.Selectthe
AppendixbelowthatbestmatchestheWirelessWANinterfaceofyourConnectPortX4.
Note:FormoreinformationonhowtoproperlyconfiguretheConnectPortX4Wireless
WANinterface,refertothefollowingAppendix:
AppendixA:ConfiguringforaGSM/Edgecellularnetwork(AT&T)
AppendixB:ConfiguringforaCDMAcellularnetwork(Verizon)
AppendixC:ConfiguringforaCDMAcellularnetwork(Sprint)
AppendixD:ConfiguringforaWiMAXnetwork