Digi ConnectPort X2 User manual











ConnectPort®X2Wireless
M‐BusDevelopmentKit
GettingStartedGuide






90001223_B
September9,2011

ConnectPortX2WirelessM‐BusDevelopmentKit
GettingStartedGuide  2
©2011DigiInternational,Inc.
Allrightsreserved.

Digi,iDigi,DigiInternational,theDigiandiDigilogos,ConnectPort,DigiESP,XBee,iDigiManagerPro,
iDigiDeviceCloud,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,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.


ConnectPortX2WirelessM‐BusDevelopmentKit
GettingStartedGuide  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/support/.

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hint,orconceptthatislearned.

Thisiconindicatesawarningofthepotentialfor
confusionordanger.

ConnectPortX2WirelessM‐BusDevelopmentKit
GettingStartedGuide  4
Contents
UsingthisGuide............................................................................................................................................3
ContactInformation..................................................................................................................................3
ConventionsusedinthisGuide................................................................................................................3
IntroductiontotheConnectPortX2WirelessM‐BusDevelopmentKit.......................................................5
GoalsoftheKit..........................................................................................................................................5
RequirementsoftheKit............................................................................................................................5
SystemRequirements...........................................................................................................................5
WebBrowserRequirements.................................................................................................................5
Part1:SetupyourWirelessM‐BusDevelopmentKit..................................................................................6
Step1:IdentifyYourKitComponents.......................................................................................................6
Step2:GettingtoKnowYourDevice........................................................................................................7
Step3:ConnectandPower‐OntheConnectPortX2................................................................................9
Step4:ConnecttheInterfaceBoard.......................................................................................................10
Part2:DownloadandInstalltheDigiESPforPythonDevelopmentEnvironment...................................11
Part3:FollowtheInstructionsintheESPHelpSystemtoComplete
theDevelopmentKitExperience................................................................................................................17

ConnectPortX2WirelessM‐BusDevelopmentKit
GettingStartedGuide  5
IntroductiontotheConnectPortX2WirelessM‐Bus
DevelopmentKit
ThankyouforpurchasingtheDigiConnectPortX2WirelessM‐BusDevelopmentKit.TheM‐Bus
DevelopmentKitincludesallthehardwareandsoftwaretoolsnecessarytodeployandconfigurean
M‐Businfrastructurewithasimulatedmeteringdevice.TheiDigi®DeviceCloud™willhelpyoustoreand
readM‐Busdatageneratedbythesimulator.
ByusingtheiDigiDeviceCloud,developerscanrapidlydeployandmanagetheirapplicationsremotely
acrossanIPconnectionwithouttheneedtoprogrammiddlewareapplications.
GoalsoftheKit
Asyougothroughthestepsinthiskit,youwill:
1. ConnecttheConnectPortX2toyourlocalnetwork.
2. UsetheDigiESP™forPythonIDEtobuild,download,andlaunchaPythonapplicationfor
yourConnectPortX2gateway,theninteractwiththeapplicationinarealisticsetting.
3. CreateaniDigideveloperaccountontheiDigiDeviceCloud.
4. UsetheiDigistorageinterfacetoretrievemeterdata.
RequirementsoftheKit
SystemRequirements
Internetconnection
PCrunningMicrosoftWindowsXP,VistaorWindows7
Note:MacoperatingsystemsarenotsupportedinthisDevelopmentKitexperience.
WebBrowserRequirements
MicrosoftInternetExplorer7.0ornewer
GoogleChrome4.0ornewer
MozillaFirefox3.0ornewer

ConnectPortX2WirelessM‐BusDevelopmentKit
GettingStartedGuide  6
Part1:SetupyourWirelessM‐BusDevelopmentKit
Step1:IdentifyYourKitComponents
Carefullyunpackandverifythecontentsofyourkit.Yourkitshouldincludeeachofthe
following:


Figure1:KitContents

ConnectPortX2WirelessM‐BusDevelopmentKit
GettingStartedGuide  7
Step2:GettingtoKnowYourDevice
ConnectPortX2LEDsandButtons
DigideviceshaveseveralLEDsthatindicatesystemstatus,linkintegrity,andlinkactivity.The
followingimagesillustratetheConnectPortX2LEDs.



Figure2:ConnectPortX2LEDsandButtons
TheConnectPortX2resetbuttonislocatedonthesidepanelofthedevice(asshownabove).To
performafactoryresetofthedevice,locateanitemthatissmallenoughtobeinsertedintothe
resetbuttonhole(forexample,theendofapapercliporpush‐pin).Next,inserttheiteminto
theresetbuttonhole,andpressandholdtheresetbuttonforafewseconds.Whentheunit
resets,aflashingpatternof1‐5‐1ontheEthernetLEDwillindicateasuccessfulfactoryreset.
ConnectPortX2LEDandButtonFunctionality
LED/ButtonColorandLight
Pattern
Description
Ethernet
LinkLED
SolidyellowEthernetlinkisup
Ethernet
ActivityLED
BlinkinggreenEthernettrafficisonthelink
AssociationN/ANotused
PowerOFFNotfunctioningcorrectly
ONOK
Reset
Button
Singlepress‐performsequivalentofapower‐cycle.
Pressandholdatpoweron‐resetsthedevice
configurationsettingstofactorydefaults(factoryreset).

ForadditionalinformationregardingtheConnectPortX2LEDsandbuttons,seetheConnectPort
XFamilyUser’sGuideavailableontheDigiSupportwebsite.

ConnectPortX2WirelessM‐BusDevelopmentKit
GettingStartedGuide  8
WebInterface
DigiConnectPortX2devicesutilizeaweb‐basedinterfaceforconfiguring,monitoring,and
administeringDigidevices.ToconfigureyourConnectPortX2,simplyentertheIPaddressofthe
deviceintoyourwebbrowser.YouwilldiscovertheIPaddressofyourdevicelaterinthisguide
whenyougothroughtheprocessofinstallingandrunningyourfirstPythonprogram.

ForadditionalinformationregardingtheConnectPortX2webinterface,seetheConnectPortX
FamilyUser’sGuideavailableontheDigiSupportwebsite.

CommandLineInterface
DigiConnectPortX2devicescanbeconfiguredbyissuingcommandsfromthecommandline.
Thecommand‐lineinterfaceallowscommunicationdirectlywithoutagraphicalinterface.The
command‐lineinterfaceprovidesflexibilityformakingprecisechangestodeviceconfiguration
settingsandoperation.Itdoesrequireuserstohaveexperienceissuingcommands,andaccess
tocommanddocumentation.

ThecommandlineisavailablethroughTelnetorSSHTCP/IPconnections,orthroughserialport
usingterminalemulationsoftwaresuchasHyperterminal.Accesstothecommandlinefrom
serialportsdependsontheportprofileinusebytheport.Bydefault,serialportcommand‐line
accessisallowed.

Foradditionalinformationonaccessingandconfiguringthecommandlineinterfaceofyour
ConnectPortX2,aswellasthevariouscommanddescriptionsavailable,seetheDigiConnect
FamilyCommandReferenceavailableontheDigiSupportwebsite.


ConnectPortX2WirelessM‐BusDevelopmentKit
GettingStartedGuide  9
Step3:ConnectandPower‐OntheConnectPortX2
TobeginsettingupyourDigiConnectPortX2WirelessM‐BusDevelopmentKityouwillneedto
connectandpower‐ontheConnectPortX2.
1. ConnectoneendoftheEthernetcabletotheConnectPortX2,andtheotherendtoyour
Ethernetswitch(theConnectPortX2defaultstoobtainingitsIPAddressviaDHCP).
WARNING:IftheConnectPortX2doesnothaveaccesstotheInternetthiskitcannotbe
completed.
2. Connecttheappropriatepowersupplyadaptertothepowersupply.
3. ConnectthepowersupplytotheConnectPortX2andthenplugthepowersupplyintoa
walloutlet.


Figure3:ConnectingtheConnectPortX2


ConnectPortX2WirelessM‐BusDevelopmentKit
GettingStartedGuide  10
Step4:ConnecttheInterfaceBoard
1. InstalltheAmberWirelessM‐Bus(OMS)moduleontotheinterfaceboard.
2. ConnecttheUSBcabletotheinterfaceboardthenconnecttheotherendtoyourPC.

Figure4:ConnectingtheInterfaceBoard
3. InstallUSBdriversforyourinterfaceboard.
IfyouhaveneverinstalledUSBCOMportdriversonyourPC,Windowswilldisplaya
pop‐upaskingtoinstalldrivers.ThedriverscanbedownloadedfromtheDigiwebsite
here:http://www.digi.com/support/kbase/kbaseresultdetl.jsp?id=2138
IfyouhaveexistingUSBCOMportdriversinstalledonyourPC,youwillneedtoinstall
thedriversmanually.Youmayneedtodisableoruninstalltheexistingdriversforthe
interfaceboardtofunctionproperly.