XBee Wi-Fi Development Kit Getting Started Guide

90002133_A 6/17/2011

2011DigiInternationalInc. Allrightsreserved. Digi,DigiInternational,theDigilogo,theDigiwebsite,aDigiInternationalCompany,XBee,andDigiXBeeare trademarksorregisteredtrademarksofDigiInternational,Inc.intheUnitedStatesandothercountries worldwide.Allothertrademarksarethepropertyoftheirrespectiveowners. Allothertrademarksmentionedinthisdocumentarethepropertyoftheirrespectiveowners. Informationinthisdocumentissubjecttochangewithoutnoticeanddoesnotrepresentacommitmentonthe partofDigiInternational. Digiprovidesthisdocumentasis,withoutwarrantyofanykind,eitherexpressedorimplied,including,butnot limitedto,theimpliedwarrantiesoffitnessormerchantabilityforaparticularpurpose.Digimaymake improvementsand/orchangesinthismanualorintheproduct(s)and/ortheprogram(s)describedinthismanual atanytime. Thisdocumentcouldincludetechnicalinaccuraciesortypographicalerrors.Changesareperiodicallymadetothe informationherein;thesechangesmaybeincorporatedinneweditionsofthepublication.

2011DigiInternational,Inc.

Table of Contents
Using this Guide ............................................................................................................ 4
Conventions used in this Guide .............................................................................. 4 Contact Information................................................................................................. 4

Introduction .................................................................................................................... 5
Goals of the Kit ....................................................................................................... 5 Requirements of the Kit .......................................................................................... 5

..........................................................................................5 Additional Requirements ......................................................................................5

System Requirements

Part 1: Set up your XBee Wi-Fi Development Kit ................................................. 6

Identify Kit Components.......................................................................................... 6 Assemble your XBee Wi-Fi Development Kit ......................................................... 7

Part 2: Download and Install X-CTU Software ....................................................... 8

Installing USB Drivers ............................................................................................. 8 Installing X-CTU Software ...................................................................................... 8

Part 3: Establish an 802.11 bgn Network Connection ......................................... 9

Starting the X-CTU Software .................................................................................. 9 Running the X-CTU Software ............................................................................... 10

Part 4: Put the XBee Module into Deep Sleep Mode ......................................... 18
Further Information ............................................................................................... 22

Appendix A: Troubleshooting .................................................................................23

Resetting the XBee Wi-Fi Module ........................................................................ 23

Appendix B: Possible Access Point/Router Connection Issues ...................25

2011DigiInternational,Inc..

Using this Guide

Conventions used in this Guide
Thisiconindicatesastepthathasthepotentialtobetroublesome. Furtherinformationregardingitemsmarkedwiththissymbolcanbe foundinAppendixAorAppendixB.

Thisiconindicatesahint,orconceptthatislearned.

Thisiconindicatesthatagoalofthekithasbeencompleted.

Thisiconindicatesawarningofthepotentialforconfusionordanger.

Contact Information
FormoreinformationaboutyourDigiproducts,orforcustomerserviceandtechnicalsupport,contact DigiInternational. ToContactDigiInternationalby: DigiInternational Mail WorldHeadquarters 11001BrenRoadEast Minnetonka,MN55343 Phone 8:00AM5:00PM(U.S.MountainTime) OnlineSupport Email 18667659885tollfreeUSAandCanada 18017659885Worldwide http://www.digi.com/support/eservice/ login.jsp rfexperts@digi.com Use

2011DigiInternational,Inc..

Introduction
ThankyouforpurchasinganXBeeWiFiDevelopmentKit.Thiskitisdesignedtomakeiteasytosetupan XBeeWiFinetwork,senddatafromoneXBeetotheother,andadjusttheXBeesettings.Beforeyoustart workingwiththekit,let'scoversomebasics.

Goals of the Kit

Asyougothroughthestepsinthiskit,youwill: 1.SetupyourXBeeWiFiDevelopmentKit. 2.DownloadandinstallXCTUconfigurationsoftware. 3.UseXCTUtoestablishan802.11bgnnetworkconnectionbetween theXBeeWiFimodulesusinganaccesspointorwirelessrouter. 4.PuttheXBeeWiFimoduleintodeepsleepmode.

Requirements of the Kit

System Requirements
Toinstallthesoftwarementionedinthisguide,youwillneedaPCrunningMicrosoftWindows 2000,XP,VistaorWindows7.

Additional Requirements
Thisguideassumestheuseofan802.11bgnaccesspointorwirelessrouter(notprovided)with WPA,orWPA2withPSKandDHCPenabled.TheXBeeWiFidoesnotsupportWEPorenterprise encryption. Further,thisguideassumesbothmodulesareconnectedtothesameaccesspointorrouter. WhileitispossibletoconnecttheXBeeWiFitodifferentaccesspointsorrouters,itisbeyond thescopeofthisguide.ForinformationoncommunicationacrossaccesspointsseetheUser's Manual.

2011DigiInternational,Inc..

Part 1: Set up your XBee Wi-Fi Development Kit

Identify Kit Components
Carefullyunpackandverifythecontentsofyourkit.Yourkitshouldincludethefollowing:

2 - XBee Interface Boards

U.FL Antenna XBee Wi-Fi PCB Antenna Module XBee Wi-Fi U.FL Module 2 - USB Cables

2011DigiInternational,Inc..

XBe e W i F i De ve lo pme nt K i t Ge tting Star te d Guide

Assemble your XBee Wi-Fi Development Kit

AssemblethekitbyplacingoneXBeeWiFimoduleoneachoftheXBeeUSBDevelopmentBoardsas showninthediagrambelow.ConnecttheU.FLantennatotheU.FLXBeeasshown.ConnecttheUSB cabletotheXBeeUSBDevelopmentBoard;itwillbeattachedtothecomputerinalaterstep.

or

Notes: 1.TheantennaisonlyinstalledonU.FLmodules.ThePCBantennamodulecomesequipped withanantennaalreadyonthemodule. 2.ModulesareinstalledbyaligningpinsandpressingintotheXBeeUSBDevelopmentBoard socket. 3.ModulescanberemovedfromtheXBeeUSBDevelopmentBoardsocketbycarefully applyingupwardpressuretothemodule. 4.Thepowersupplyjackisonthelowerleftcorneroftheboard.Itisnotrequiredforthis module.ThisguideassumestheboardispoweredbyaUSBcableconnectedtothe computer.

YouhavejustcompletedGoal#1settingupyourXBee WiFiDevelopmentKit.

2011DigiInternational,Inc..

Part 2: Download and Install X-CTU Software

ForproperkitconfigurationandoperationXCTUsoftware(version5.15orlater)mustbedownloaded andinstalled.AcopyofXCTUsoftwareandUSBdriverswillneedtobeoneachcomputerusedin conjunctionwiththisguide.

Installing USB Drivers

TheXBeeUSBinterfaceboardisa"plugandplay"devicethatshouldbedetectedbythePC automatically.IfyouareusingWindows7orVista,theUSBdriversshouldautomaticallyinstallanda notificationwillappearinthelowerrightportionofyourscreenindicatingsuccessorfailure.IftheUSB driversfailtoinstall,pleasefollowtheUSBdriverinstallationinstructionsfoundhere: http://www.digi.com/support/kbase/kbaseresultdetl.jsp?id=3214. IfyouareusingWindows2000orXP,downloadandinstallthedriverasperthefollowingdirections. ToinstalltheUSBdriver: 1.Downloadthedriversetupfileat: http://ftp1.digi.com/support/driver/FTDI_Windows_Driver_Setup.exe. 2.Doubleclickonthesetupfile.Awindowwillpopupduringinstallationandautomaticallyclose whentheprocessiscomplete.TheUSBinterfaceboardmaynowbeconnectedtothecomputer.

Installing X-CTU Software

1.DownloadXCTUatwww.digi.com/xctu. 2.Browsetothefoldertowhichyousavedtheaboveinstallfile. 3.DoubleclickontheinstallerfileandfollowtheXCTUSetupWizard. 4.WhenaskedifyouwouldliketocheckDigi'swebsiteforfirmwareupdates,clickYes. 5.Afterthefirmwareupdatesarecomplete,clickClose.Updatesmaytakeafewminutes,pleasebe patient. 6.StartXCTUbydoubleclickingontheXCTUicononyourdesktop,orbyselectingStart>Programs >Digi>XCTU. TheXCTUsoftwareisnowreadytobeused.

YouhavejustcompletedGoal#2downloadingandinstalling theXCTUconfigurationsoftware.

2011DigiInternational,Inc..

Part 3: Establish an 802.11 bgn Network Connection

Twotypesofnetworkconnectionareavailable.Thefirstisadhocwhereatwomodulenetworkis establishedwithouttheaidofanaccesspointorrouter.Thismodeisnotdiscussedinthisguide.Further informationonadhocnetworksisavailableintheUser'sManual.Thesecondtypeofnetworkiscreated usinganaccesspointorrouter.Thebasicsofthistypeofconnectionwillbecoveredinthissection.

Starting the X-CTU Software

1.ConnecttheXBeeUSBDevelopmentBoardUSBcabletothecomputer. 2.GotothefilewhereyousavedtheXCTUsoftware. 3.DoubleclickonXCTU.exetostarttheprogram.

2011DigiInternational,Inc..

XBe e W i F i De ve lo pme nt K i t Ge tting Star te d Guide

Running the X-CTU Software

1.UnderthePCSettingstab,selectthePCserialCOMportthatwillbeused(USBSerialPort(COM4) inthiscase.TheUSBportswillbelabeledasUSBSerialPortandareassignedanumberbasedon yourPC'ssettings.

2.SetthefollowingvaluesintheComPortSetupsectionofXCTU: BaudRate: FlowControl: DataBits: Parity: StopBits: 9600 None 8 None 1

Note:TheXCTUbaudratemustmatchthemodule'sBDparameterforproper communication.Themoduledefaultis9600baud.

2011DigiInternational,Inc..

10

XBe e W i F i De ve lo pme nt K i t Ge tting Star te d Guide

3.SelecttheXCTUModemConfigurationtab,andthenclickRead. ThiswillcauseXCTUtodisplaytheavailablesettingsforthemodule.

4.Tofindtheavailableaccesspointsandrouterswithinthemodulesrange,scrolltothetopofthe settingslistandclickonActiveScan.ThenclickontheScanbuttonthatwillappear.

2011DigiInternational,Inc..

11

XBe e W i F i De ve lo pme nt K i t Ge tting Star te d Guide

5.ThiswillcausetheXBeetoscanforavailableaccesspointsandroutersintheareaandbringupthe Scanwindow,shownbelow:

TheSecuritysectionshowsthetypeofsecurityusedbyeachnetworklisted.Receiver SignalStrengthIndicator(RSSI(dBm))isameasureofthepowerlevelreceivedatthe module.Thehigherthenumber,themorepowerisreceivedfromthatnetwork. ClickingtheCancelbuttonwillclosethewindow.ClickingtheScanbuttonwithintheScan windowwillcausetheXBeetorescanforallavailableaccesspointsandrouters.The SecurityKeysectionisforenteringthesecuritykeyoftheaccesspointorrouterselected, ifrequired.

2011DigiInternational,Inc..

12

XBe e W i F i De ve lo pme nt K i t Ge tting Star te d Guide

6.LocatethenetworkyouwouldlikeyourXBeeWiFimoduletojoinandclickontheSSIDwithinthe scanwindow.YouwillnoticethattheSecurityKeysectionisgrayedoutifthenetworkssecurityis "open".Ifthenetworkisusingasecuritykey,enterthatkeyitintotheSecurityKeytextbox.Little boxcharactersmayappearnexttoeachSSID.Pleasedisregardthesecharacters.

Warning:TheXBeeWiFimodulewillnotconnecttoaccesspointsorroutersthatuse WEPorEnterprisesecurity.TheaccesspointorrouterneedstobeconfiguredforDHCP forthepurposesofthisguide. 7.Onceyouhaveselectedanetwork,clickontheSelectAPbutton.ThisconnectstheXBeeWiFito thenetwork.TheInfowindow(shownbelow)willbedisplayed;thiswindowtellsyouhowlongit tooktoconnecttoyourspecifiednetwork.

Note:IfyourXBeeWiFimoduledoesnotjointheaccesspoint,pleasereferto "AppendixB:PossibleAccessPoint/RouterConnectionIssues".

2011DigiInternational,Inc..

13

XBe e W i F i De ve lo pme nt K i t Ge tting Star te d Guide

8.ClicktheOKbutton.Thiswillcloseboththeinfoandscanwindows.

Note:TheIPaddresswillbedynamicallyassignedbytheaccesspointorrouter. Thiscantakeafewsecondstocomplete.

9.ConnecttheotherXBeeInterfaceBoardUSBcabletothecomputerandrepeatsteps1through8 forthesecondmodule.YoucaneitheropenmultipleXCTUwindowsonthesamecomputeroruse aseparatecomputerforeachmodule. Warning:Forthepurposesofthisguide,itisrequiredthatbothmodulesjointhesame accesspoint. 10.WithintheAddressingfolderyouwillfindtheModuleIPAddressline.ThisistheIPaddress assignedbytheaccesspointorrouter.

2011DigiInternational,Inc..

14

XBe e W i F i De ve lo pme nt K i t Ge tting Star te d Guide

Note:IftheModuleIPAddresslistedis0.0.0.0,clicktheReadbuttonandtheIPaddress willbedisplayed.ItmaytakeafewsecondsfortheaccesspointorroutertoassignanIP addresstotheXBeeWiFimodule. 11.AlsowithintheAddressingfolderyouwillfindtheDestinationIPAddress.Clickonthisaddressto displayaSetbutton.

12.ClickontheSetbuttontodisplaytheSetStringwindow.

2011DigiInternational,Inc..

15

XBe e W i F i De ve lo pme nt K i t Ge tting Star te d Guide

13.EntertheModuleIPAddressfrommodule2intomodule1'sDestinationIPAddress,andthe ModuleIPAddressformodule1intomodule2'sDestinationIPAddress.

14.ClicktheWritebutton(nexttotheReadbutton).Thiswillsavethesettingstothemodule. Note:TorestorethefactoryoriginalsettingsclicktheRestorebutton(nexttotheWrite button).Thiswillplacethemoduleintheoriginalsettingsandallowyoutoconnecttoa newnetwork.

2011DigiInternational,Inc..

16

XBe e W i F i De ve lo pme nt K i t Ge tting Star te d Guide

15.SelecttheTerminaltabforeachmodule,clickanywherewithinthewhitewindow,andtypeany charactersthatyouwouldliketheXBeeWiFimoduletotransmit. Note:Typedcharactersinthewindowofonemodulewillbetransmittedtotheother moduleanddisplayedinthatmodulesXCTUscreen.Characterstransmittedaredisplayed inbluetextandcharactersreceivedaredisplayedinredText.

YouhavejustcompletedGoal#3usingXCTUtoestablishan 802.11bgnnetworkconnectionbetweentheXBeemodules, usingaccesspointsorawirelessrouter.

2011DigiInternational,Inc..

17

Part 4: Put the XBee Module into Deep Sleep Mode

Twotypesofsleepareavailableonthemodule;thefirstisassociatedsleep.Inassociatedsleepmodethe modulewillremembertheconnectiontothelastaccesspointorrouteritwasconnectedto.Formore informationonassociatedsleepseetheUser'sManual. Thesecondtypeofsleepisdeepsleep;deepsleepmodewillcompletelypowerdowntheWiFiportion ofthemodule.DeepsleepisthelowestcurrentmodefortheXBeeWiFimodule. ToenterdeepsleepandwakeuptheXBeeWiFimoduleperformthefollowingsteps: 1.MakesuretheXCTUTerminaltabisselected.

2011DigiInternational,Inc..

18

XBe e W i F i De ve lo pme nt K i t Ge tting Star te d Guide

2.EnterATcommandmodebytyping+++inthetextwindow.ThemodulewillrespondwitharedOK asshownbelow:

2011DigiInternational,Inc..

19

XBe e W i F i De ve lo pme nt K i t Ge tting Star te d Guide

3.Typeatsm1andpresstheEnterkeytoenablethedeepsleepmode.

Note:ATSM1isanATcommandspecifyingsleepmode1.Additionalinformationon sleepmodeisavailableintheProductManual.

Warning:ThiscommandneedstobeenteredwithinafewsecondsortheXBeeWiFiwill automaticallyexitcommandmodeandyouwillneedtogobacktoStep2.Thedefault commandmodetimeoutis10seconds.

Note:YoucanexitthecommandmodebytypingatcnandpressingtheEnterkey.

2011DigiInternational,Inc..

20

XBe e W i F i De ve lo pme nt K i t Ge tting Star te d Guide

4.ToentersleepmodeunchecktheDTRbox.TheCTSlightwillgoout,andthemodulewillgoto sleep.

5.Toexitsleepmode,wakethemoduleupbycheckingtheDTRbox.TheCTSlightwillcomebackon andtheXBeeWiFimodulewillwakeup.

2011DigiInternational,Inc..

21

XBe e W i F i De ve lo pme nt K i t Ge tting Star te d Guide

Warning:IftheXCTUwindowdisplaysthemessageUnabletomonitorcomevents,it willbenecessarytoclicktheCloseComPortbutton(thebuttonnamewillchangetoOpen ComPort).ClicktheOpenComPortbuttonandtheXBeeWiFimodulewillbereadyto communicateagain. Ifthemessagepersists,resetthemoduleasshowninAppendixA:Troubleshooting. Thiserroriscausedbythecurrentrequirementsatstartup.SeetheDesignNotesPower SupplysectionoftheUsersManualformoreinformation.

YouhavejustcompletedGoal#4puttingtheXBeeWiFi moduleintodeepsleepmode. Congratulations!YouhavejustcompletedallofthegoalsoftheXBeeWiFiGettingStarted Guide.ThisconcludesyourintroductiontotheXBeeWiFimodules.

Further Information
TherearemanymorefeaturesavailableintheXBeeWiFifirmware.Someofthesefeaturesincludead hocmode,overtheairconfiguration,andaccesstoanaloganddigitalI/Olines.Detailsregardingthese topicsandmorecanbefoundintheproductmanual.Inaddition,messageboardsforquestionsand otherhelpcanbefoundattheXBeeWiFiForum.

2011DigiInternational,Inc..

22

Appendix A: Troubleshooting
Resetting the XBee Wi-Fi Module
EachXBeeUSBDevelopmentBoardhasaresetbutton(locatedasshownbelow):

Pressingthisbuttonresetsthemodule,butwillnotclearanychangeswrittentothemodule.Pressingthis buttonwillalsoresettheCOMportfortheboard. ToreconnecttothemoduleafterpressingtheresetbuttonselecttheTerminalTab,andthenclickthe CloseComPortbutton.

2011DigiInternational,Inc..

23

XBe e W i F i De ve lo pme nt K i t Ge tting Star te d Guide

ClickingtheCloseComPortbuttonwillgrayoutthelargetextboxandchangethenameonthebuttonto OpenComPort.

ClickingtheOpenComPortbuttonwillrestoretheconnection.

2011DigiInternational,Inc..

24

Appendix B: Possible Access Point/Router Connection Issues

IftheXBeeWiFiisnotconnectingtotheaccesspointorrouter,pleasecheckthefollowing: 1.Besuretheaccesspointorrouterisconnectedtoapowersourceandturnedon. 2.Checktheaccesspointorrouterforthepropersecuritysettings(Open[nosecurity],WPAPSKand WPA2PSKaresupported).BesureMACaddressfilteringisturnedoffontheassesspointor router,asthiswillrequiretheXBeeWiFimodulesMACaddresstobeenteredintothesystem. 3.ChecktheaccesspointorroutertobesureitisintheDHCPsettingwhichwilldynamicallyassign anIPaddresstotheXBeeWiFi.Staticaddressingisalsoavailable,consulttheproductmanualfor moreinformationonstaticaddressing. 4.ChecktheXBeeWiFimoduleforproperantennainstallation.Ifnoantennaconnectorisavailable theXBeeWiFimodulecouldhaveaninternalantennaontheprintedcircuitboardorawirewhip. 5.BesuretheXBeeWiFiiswithintherangecapabilitiesoftheaccesspointorrouter.Movingthe XBeeWiFiandaccesspointorrouterclosertogethercouldsolvethisissue. 6.IFthesecuritysettingisnotOPEN(nosecurityselected),besurethepropersecuritykeyhasbeen entered.Thesecuritykeyissetontheaccesspointorrouter. 7.SomeaccesspointsandroutershaveasettingwheretheSSID(nameoftheaccesspointorrouter) isnotvisible.InthiscasetheSSIDwillnotshowupusinganactivescan.Forinformationonsetting theSSIDintheXBeeWiFimoduleconsulttheproductmanual. 8.AmoduleresetasdescribedinAppendixA:Troubleshootingmayalsosolvetheissue.

2011DigiInternational,Inc..

25