Digi XBee / XBee-PRO S1 802.15.4 Module Quick start guide

Category
Networking
Type
Quick start guide
XBee® 802.15.4 (Legacy)
Starter Kit Getting Started
Guide
90002160_A
6/20/2012
©2012DigiInternational,Inc. 2
©2012DigiInternationalInc.
Allrigh
tsreserved.
Digi,DigiIn
ternational,theDigilogo,theDigiwebsite,aDigiInternationalCompany,XBee,andDigiXBeeare
trademarksorregisteredtrademarksofDigiInternational,Inc.intheUnitedStatesandothercountries
worldwide.Allothertrademarksarethepropertyoftheirrespectiveowners.
Allothertr
ademarksmentionedinthisdocumentarethepropertyoftheirrespectiveowners.
Informationinthisdo
cumentissubjecttochangewithoutnoticeanddoesnotrepresentacommitmentonthe
partofDigiInternational.
Digipr
ovidesthisdocument“asis,withoutwarrantyofanykind,eitherexpressedorimplied,including,butnot
limitedto,theimpliedwarrantiesoffitnessormerchantabilityforaparticularpurpose.Digimaymake
improvementsand/
orchangesinthismanualorintheproduct(s) and/ortheprogram(s)describedinthismanual
atanytime.
Thisdocumen
tcouldincludetechnicalinaccuraciesortypographicalerrors.Changesareperiodicallymadetothe
informationherein;thesechangesmaybeincorporatedinneweditionsofthepublication.
©2012DigiInternational,Inc. 3
Table of Contents
Using this Guide............................................................................................................ 5
Conventions used in this Guide.............................................................................. 5
Contact Information................................................................................................. 5
Introduction .................................................................................................................... 6
Goals of the Kit ....................................................................................................... 6
Requirements of the Kit .......................................................................................... 6
Part 1: Set up your XBee 802.15.4 Starter Kit........................................................ 7
Identify Kit Components.......................................................................................... 7
Assemble your Starter Kit ....................................................................................... 8
Part 2: Download and Install X-CTU Software....................................................... 9
Installing USB Drivers............................................................................................. 9
Installing X-CTU Software ...................................................................................... 9
Part 3: Test Communications Link and Establish a Network.......................... 10
Perform a Range Test .......................................................................................... 10
Part 4: Configure the Modules................................................................................. 15
Set up a Point-to-Multipoint Network.................................................................... 15
Part 5: Explore Advanced Configurations ........................................................... 16
Configure Remote Modules.................................................................................. 16
Change Firmware Version.................................................................................... 18
Software Design Considerations .......................................................................... 20
Part 6: Managing the Network ................................................................................. 21
Digi Gateways....................................................................................................... 21
To the Cloud! Make the most of your data. .......................................................... 22
To the Cloud! Take control of your device network.............................................. 22
©2012DigiInternational,Inc.. 4
XBee® 802.15.4 Development Kit Getting Started Guide
Appendix A: Troubleshooting .................................................................................23
Resetting the XBee 802.15.4 Module................................................................... 23
Why are the modules no longer communicating with one another?.................... 23
©2012DigiInternational,Inc. 5
Using this Guide
Conventions used in this Guide
Thisiconindicatesahint,orconceptthatislearned.
Thisiconindicatesthatagoalofthekithasbeencompleted.
Thisiconindicatesawarningofthepotentialforconfusionordanger.
Contact Information
FormoreinformationaboutyourDigiproducts,orforcustomerserviceandtechnicalsupport,contact
DigiInternational.
ToContactDigiInternational Use
Mail
DigiInternational
Wo
rldHeadquarters
110
01BrenRo
adEast
Minnetonka,MN55343
Phone
8:0
0AM‐5:00
PM(U.S.MountainTime)
1866
7659885tollfreeUSAandCanada
1801
7659885Worldwide
OnlineSupport
http://www.digi.com/support/eservice/login.jsp
Email support.[email protected]
©2012DigiInternational,Inc. 6
Introduction
ThankyouforpurchasinganXBee®802.15.4(Legacy) StarterKit.Thiskitisdesignedtomakeiteasyto
setupanXBeenetwork,senddatafromoneXBeetoanother,andadjusttheXBeesettings.Before
youstartworkingwiththekit,let'scoversomebasics.
Goals of the Kit
Asyougothroughthestepsinthiskit,youwill:
1. SetupyourXBee802.15.4StarterKit.
2. Downloadandins
tallXCTUconfigurationsoftware.
3. Performara
ngetest.
4. Establishanetwork.
5. Configurethemodule
s.
Requirements of the Kit
System Requirements
Toinstallthesoftwarementionedinthisguide,youwillneedaPCrunningMicrosoftWindows
2000,XP,VistaorWindows7.
Additional Documentation
Formoreinformationaboutthesoftware,APIoperations,ATcommandmodes,ortheform
factorpleaserefertothe
XBee®/XBeePRO®802.15.4ProductManual.
Formorein
formationonconfiguringandusingtheXCTUutility,pleaserefertotheXCTU
Configuration&TestUtilitySoftwareUser’sGuide.
©2012DigiInternational,Inc. 7
Part 1: Set up your XBee 802.15.4 Starter Kit
Identify Kit Components
Carefullyunpackandverifythecontentsofyourkit.Yourkitshouldincludethefollowing:
XBee Interface Board (2)
Antenna (1)
XBee Wire
Module (1)
USB Cable (2)
Power Supply (1) Power Supply
Adapters (1)
XBee RPSMA Module (1)
©2012DigiInternational,Inc. 8
XBeePRO®802.15.4DevelopmentKitGettingStartedGuide
Assemble your Starter Kit
Toassembleyourkit,performthefollowingsteps:
1.Ins
tallthemodulesontheXBeeInterfaceBoards(XBIB)byliningthepinsupwiththeheadersand
pressingthemoduleintoplace.
2.At
tachthedipoleantennastothemodules.
3.Connectthefir
stXBIBtoyourcomputerusingaUSBcable.Thisfirstdevicewillbedesignatedas
yourbasemodule.
4.Connectther
emainingmodulesandinterfaceboards,andsetthemasidefornow.
Youar
enowreadytoruntheXCTUsoftwareandtobeginconfiguringyourXBeenetwork.
YouhavejustcompletedGoal#1‐settingupyour
XBee802.15.4StarterKit.
©2012DigiInternational,Inc. 9
Part 2: Download and Install X-CTU Software
ForproperkitconfigurationandoperationXCTUsoftware(version5.15orlater)mustbedownloaded
andinstalled.AcopyofXCTUsoftwareandUSBdriverswillneedtobeinstalledoneachcomputerused
inconjunctionwiththisguide.
Installing USB Drivers
TheXBeeUSBinterfaceboardisa"plugandplay"devicethatshouldbedetectedbythePC
automatically.IfyouareusingWindows7orVista,theUSBdriversshouldautomaticallyinstallanda
notificationwillappearinthelowerrightportionofyourscreenindicatingsuccessorfailure.
IftheUSBdriv
ersfailtoinstall,pleasefollowtheUSBdriverinstallationinstructionsfoundhere:
http://www.digi.com/support/kbase/kbaseresultdetl.jsp?id=3214.
Ifyo
uareusingWindows2000orXP,downloadandinstallthedriverasperthefollowingdirections.
Toins
talltheUSBdriver:
1.Downlo
adthedriversetupfileat:
http://ftp1.digi.com/support/driver/FTDI_Windows_Driver_Setup.exe.
2.Doubleclickonthesetupfi
le.Awindowwillpopupduringinstallationandautomaticallyclose
whentheprocessiscomplete.
Installing X-CTU Software
1.DownloadXCTUatwww.digi.com/xctu.
2.Br
owsetothefoldertowhichyousavedtheaboveinstallfile.
3.Doubleclickontheins
tallerfileandfollowtheXCTUSetupWizard.
4.Whenas
kedifyouwouldliketocheckDigi'swebsiteforfirmwareupdates,clickYes.
5.Af
terthefirmwareupdatesarecomplete,clickClose.Updatesmaytakeafewminutes,pleasebe
patient.
6.St
artXCTUbydoubleclickingontheXCTUicononyourdesktop,orbyselectingStart>Programs
>Digi>XCTU.
TheXCT
Usoftwareisnowreadytobeused.
YouhavejustcompletedGoal#2‐downloadingandinstalling
theXCTUconfigurationsoftware.
©2012DigiInternational,Inc. 10
Part 3: Test Communications Link and
Establish a Network
Perform a Range Test
Befor erunningarangetest,youwillneedtoestablishaconnectionwiththeXCTUsoftware:
1.DoubleclicktheXCTUsho
rtcutonyourdesktop.
2.U
nderthePCSettingstab,selecttheserialCOMportassociatedwiththedevelopmentboardsyou
havejustat tachedtoyourcomputer.
3.Verifythatthebaudrateanddatasettingsmatchtheinternalsettingsofthedevices:
BaudRate:9600
FlowControl:NONE
DataBits:8
Parity:NONE
StopBits:1
4.ClicktheTe
st/Querybuttontoverifycommunicationwiththemodule.Apopupwillbedisplayed
showingstatusandsomebasicinformation.
©2012DigiInternational,Inc. 11
XBee®802.15.4DevelopmentKitGettingStartedGuide
5.OntheModemConfigurationtab,clickRead.
6.Applypow
ertothesecondmoduleusingapowersupplyinafixedlocation.Thiswillbedesignated
asyourremotemodule.
(bridged)
(non-bridged)
Note:YouwillneedtohaveajumperatP8ontheloopbackheaderontheXBIB
fortheremotemodule.
EnsurethattheP8jumperisnotbridgingthetwopinstogetheronthebase
module.ThiscouldcauseXCTUtostallifthejumperispopulatedandrequests
aresenttothemodule.
7.SelecttheRang
eTesttab.
8.(O
ptional)Checkthe“RSSI”checkboxtoenableReceivedSignalStrengthIndicator.
©2012DigiInternational,Inc. 12
XBee®802.15.4DevelopmentKitGettingStartedGuide
9.ClickStarttobegintherangetest.
©2012DigiInternational,Inc. 13
XBee®802.15.4DevelopmentKitGettingStartedGuide
10.MonitorthelinkqualitybyreadingthePercent sectionontheRangeTesttab.Thissection
displaystherunningpercentageofgoodpacketssenttothereceivingmoduleandloopedbackto
thebase.
Asyo
urdistanceincreasesbeyondthemaximumrangeofthemodules,you
willstartseeinggreaterpacketloss.
11.ClickSt
optoendtherangetest.
©2012DigiInternational,Inc. 14
XBee®802.15.4DevelopmentKitGettingStartedGuide
TheAdvancedtaballowsyoutheabilitytoincreasethedatareceivetimeout.whichdefaultsatone
second.
Youhav ejustcompletedGoal#3‐performingarangetest.
©2012DigiInternational,Inc. 15
Part 4: Configure the Modules
Set up a Point-to-Multipoint Network
ToconfigureandsetupyourXBeenetwork,performthefollowingsteps:
1.IntheXCTUModemCo
nfigurationtab,clickRead.
2.Se
lectanyofthemoduleparametersyouwanttochange(e.g.Address,Encryption,etc.)andtype
inorselectthedesiredvalue.
3.ThenclickWr
itetosavethechangestononvolatilememory.
4.Toresto
rethemodulebacktodefaults,clickRestore.
Refertothe
productmanualformoreinformation.
YouhavejustcompletedGoal#4‐configuringthemodules.
©2012DigiInternational,Inc. 16
Part 5: Explore Advanced Configurations
Configure Remote Modules
TheXBeescanalsobeconfigured"overtheair"usingXCTU.Inordertousethisfeature,yourbase
devicemustbeconfiguredforAPImode.
Note:Toconfigureparametersona remotemodule,setAP=1onyourbase
module.FormoreinformationaboutthedifferentAPsettings,seetheAPI
sectionofthepr
oductmanual.
©2012DigiInternational,Inc. 17
Xbee®802.15.4DevelopmentKitGettingStartedGuide
Tosend“overtheaircommands:
1.Gototh
eModemConfigurationtabandclicktheRemoteConfigurationoptionatthetopofthe
window.
2.ClickOp
enComPortandDiscoverfromthemenubaratthetopoftheNetworkwindow.
Alis
tofallofthenodesinthenetworkwillpopulatethescreen.
3.Se
lectaparticularnodefromthelist.YoucaninteractwithitasifitwasconnectedtothePC
directly.
4.ClickRea
d,Write,orRestoreparametersonthemainXCTUwindowandthosechangeswilloccur
overtheairontheremotemoduleselectedintheNetworkwindow.
5.Clos
etheNetworkwindowwhenyouhavefinishedwithremoteconfiguration.
©2012DigiInternational,Inc. 18
Xbee®802.15.4DevelopmentKitGettingStartedGuide
Change Firmware Version
Thesemodulescanalsobesetupformeshcommunications.Insomecases,ameshsolutionmaybea
betteroption.DigiMeshisbetterfornetworksneedingroutingcapabilities.Also,DigiMeshprovidesthe
optionforallthemodulesinthenetworktosleepsynchronously.Ifyouwanttotrymeshmode,yo
ucan
simplyloaddifferentfirmwareonyourXBees.
Theseste
pscanalsobeusedtoupdatetothelatestversionofpointtomultipointfirmware.
1.LaunchXCTUandsel
ectthecorrespondingCOMPort.
2.Se
tthePCsettingsbacktodefault:
Baud Rate: 9600
Flow Control: HARDWARE
Data Bits: 8
Parity: NONE
Stop: Bits 1.
3.ClickontheModemConfigur
ationtab.
4.Selectthemodemty
pe.ChooseXB24DMorXBP24DMtoconvertanXBee802.15.4moduleintoa
DigiMeshXBeeorXBeePRO2.4module.LeavethemodemtypeasXBP24tojustupdatethepoint
tomultipointfirmware.
5.Choo
setheFunctionSetandfirmwareVersiondesired.
6.Clickth
eShowDefaultsbutton.Thishelpstoavoidoutofrangeerrorssincesomeparametershave
differentlimitsbasedonthefirmwaretype.
©2012DigiInternational,Inc. 19
Xbee®802.15.4DevelopmentKitGettingStartedGuide
7.ChecktheAlwaysupdatefirmwarebox.
8.ClickWr
ite.
YouhavejustcompletedGoal#5‐exploringadvancedconfigurations.
Note:WhenyouselectXBP24DM,thefunctionsetthatautomaticallyloadsis
thestandardDigiMeshone.Theversionthatautomaticallyloadsisthenewest
firmwareinXCTU'sdatabase.YoucanclickDownloadnewversion,andthen
downloadthelatestfirmwareavailablefromDigi’sftpsiteintoXCTU’sdatabase
onyo
urPC.
©2012DigiInternational,Inc. 20
Xbee®802.15.4DevelopmentKitGettingStartedGuide
Software Design Considerations
InthisgettingstartedguidewehavebeendiscussingthetransmissionofdatabetweenthemodulesinAT
(transparent)mode.ThebenefitofusingATmodeontheXBeenetworkisthatitisverysimpletosend
andreceivedata.Inthisconfiguration,itactsasthoughyouhadconnectedthetw
oradioswithawire:
whateverdatagoesintoonemodulecomesoutoftheothertransparently.
Theotheroper
atingmodeisAPI.Thismodeisamuchmorepowerfulwayoftransmittingdataand
remotelycontrollingtheradio.Ifyouperformedthe"overtheairconfiguration",youhavealready
performedsomeoperationsusingAPI(RemoteATcommands)throughXCTU.
Theeas
iestwaytoexplainwhyusingAPIissousefuliswithauserscenario:
Letussa
ythatyouhaveinstalledthreesensorstomonitoryourfactoryequipment.Youwouldliketo
wirelesslygatherthesensordatatoabaseradioandbeabletoremotelycontrolarelaylocatedateach
sensor.IfyouweretouseAT(transparent)mode,therewouldbenowaytode
terminewhichsensorsent
whatdata.Thedatafromthethreesensorswouldcomeoutofthebaseradio'sUARTinajumbledmess.
Bysimplychangingtheba
seradiotoAPImode,thedatathatissentbytheremoteradioswillcomeout
oftheUARTinanAPIframe.Includedinthisframeisthesourceaddressaswellasthesensordata,soitis
veryeasytokeeptrackofeachsens
or.Thisprocessworkssimilarlyforsendingdatabacktoaspecific
radio.YoucanalsosendaRemoteATcommandtotoggleapinononeofthesensorradios,allowingyou
toremotelycontroltherelay.
APImodeiscoveredindetailintheproductmanual.Wealsohaveausefultoolavailabletoaidin
prototypingandt
estingAPIframes.
  • Page 1 1
  • Page 2 2
  • Page 3 3
  • Page 4 4
  • Page 5 5
  • Page 6 6
  • Page 7 7
  • Page 8 8
  • Page 9 9
  • Page 10 10
  • Page 11 11
  • Page 12 12
  • Page 13 13
  • Page 14 14
  • Page 15 15
  • Page 16 16
  • Page 17 17
  • Page 18 18
  • Page 19 19
  • Page 20 20
  • Page 21 21
  • Page 22 22
  • Page 23 23

Digi XBee / XBee-PRO S1 802.15.4 Module Quick start guide

Category
Networking
Type
Quick start guide

Ask a question and I''ll find the answer in the document

Finding information in a document is now easier with AI