Digi XBee Wi-Fi Cloud Kit User manual

XBee Wi-Fi Cloud Kit
Radio Frequency (RF) Modules
Getting Started Guide

Revision history—90002195
Revision Date Description
A November
2013
Initial release
B February
2014
Improved the quality of the images and corrected part number
discrepancies.
C May 2014 Updated the graphics of the loose components to match the loose
components and other accessories that are currently available with the kit.
D July 2014 Completed a major overhaul of the document including reformatting,
updating links and graphics, adding information for clarity.
E August
2016
Converted to the new MadCap Flare format with minor updates.
Trademarks and copyright
Digi, Digi International, and the Digi logo are trademarks or registered trademarks in the United
States and other countries worldwide. All other trademarks mentioned in this document are the
property of their respective owners.
© 2017 Digi International Inc. All rights reserved.
Disclaimers
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.
Warranty
To view product warranty information, go to the following website:
www.digi.com/howtobuy/terms
Send comments
Documentation feedback: To provide feedback on this document, send your comments to
[e-mail].
Customer support
Digi Technical Support: Digi offers multiple technical support plans and service packages to help our
customers get the most out of their Digi product. For information on Technical Support plans and
pricing, contact us at +1 952.912.3456 or visit us at www.digi.com/support.
XBee Wi-Fi Cloud Kit Getting Started Guide 2

Contents
Introduction to your XBee Wi-Fi Cloud Kit
XBee Wi-Fi development board components and descriptions
Set up your XBee Wi-Fi Cloud Kit
Configure your XBee Wi-Fi module using the Wi-Fi interface 10
Add your XBee Wi-Fi module to your Remote Manager account 10
Create a Remote Manager account 10
Add your XBee Wi-Fi module to Remote Manager 11
Configure widgets on your XBee Wi-Fi sample web application 12
How widgets work on the XBee Wi-Fi dashboard 12
Add widgets to your dashboard 13
Edit (and customize) widget settings 14
Remove widgets from your dashboard 15
Viewing widget source code 16
XBee Wi-Fi application exercise
Create a temperature sensor 19
Assemble the parts 19
Configure the radio 19
Wire up the circuit 20
View it 23
Use it 24
Do more with your XBee Wi-Fi Cloud Kit
Configure your XBee Wi-Fi module 26
Configure your XBee Wi-Fi module with Remote Manager 26
Configure your XBee Wi-Fi module with XCTU 28
Create XBee Wi-Fi applications 34
Learn more about XBee Wi-Fi
Connect your application to the cloud 36
Collaborate and share your story 36
Create your own applications 36
Additional services 36
XBee Wi-Fi Cloud Kit Getting Started Guide 3

XBee Wi-Fi Cloud Kit Getting Started Guide 4
Troubleshooting
XBee device fails to join wireless network 38
Check if the Associate LED is solid green 38
Check if the Associate LED is double-blinking green 38
Check if the Associate LED is lit 39
XBee device does not show up under listed devices 39
Potential cause 39
Resolution 39
XBee device is listed in the wireless networks but cannot connect 39
Potential cause 39
Resolution 39
XBee Wi-Fi dashboard does not work with the XBee device 40
Check if the XBee device is properly connected to your wireless network 40
Check if the changes made to the XBee Wi-Fi development board are reflected on the XBee
Wi-Fi dashboard 40
Check if certain functions within the XBee Wi-Fi sample web application are working as
expected 40

Introduction to your XBee Wi-Fi Cloud Kit
The XBee Wi-Fi Cloud Kit shows you how to set up your XBee Wi-Fi hardware and configure its sample
web application. You can see sensor data from your development board on the web, as well as send
data and commands from the web to your device. The components in this kit allow you to create
customized solutions for connected devices.
The XBee Wi-Fi sample web application integrates with Remote Manager to enable two-way
communication over the Internet, giving you remote control of your device wherever you are. This
application also allows you to customize your dashboard widgets so that you can create your own
connected device systems.
The following sections guide you through your kit setup for cloud-based access:
nXBee Wi-Fi development board components and descriptions
nSet up your XBee Wi-Fi Cloud Kit
nXBee Wi-Fi application exercise
nDo more with your XBee Wi-Fi Cloud Kit
nLearn more about XBee Wi-Fi
nTroubleshooting for XBee Wi-Fi Cloud Kit kit
XBee Wi-Fi Cloud Kit Getting Started Guide 5

XBee Wi-Fi development board components and
descriptions
The following table provides descriptions of the XBee Wi-Fi development board components.
XBee Wi-Fi Cloud Kit Getting Started Guide 6

XBee Wi-Fi development board components and descriptions
XBee Wi-Fi Cloud Kit Getting Started Guide 7
Development
board
components Description
1 Associate LED Indicates wireless connection status to local access point.
nSolid green: The XBee module is not connected to a local access
point.
nFlashing green: The XBee is connected to a local access point and
Remote Manager.
nTwo short double blinks: The XBee is connected to a local access
point, but not Remote Manager.
TCP/IP LED An output light connected to one of the GPIO pins that allows you to turn it on
or off using commands sent from Remote Manager.
User LED An output light that acts as a second User LED that allows you to turn it on or
off using commands sent from Remote Manager.
2 LED gauge The LED gauge indicates analog value ranging from 0-10 LEDs and is
controlled through the XBee Wi-Fi dashboard.
3 Vibration
motor
The vibration motor indicates change in status.
4 Buzzer The buzzer acts as an alarm to indicate trouble. It is loudest at 2 kHz, but
works at a range of frequencies. You can also control the frequency of the
buzzer through the dashboard using the buzzer frequency slider. Use the
buzzer toggle widget to turn the buzzer on or off.
5 Slide switch The XBee Wi-Fi dashboard indicates the state of the slide switch. The switch
stays either on or off.
6 Breadboard The rectangular plastic board that lets you easily insert electronic
components for testing purposes. This is useful for prototyping electronic
circuits.
7 Push button The state of the push button is displayed on the XBee Wi-Fi dashboard. The
button appears ON only when actively being pushed.
8 Potentiometer The potentiometer displays on the XBee Wi-Fi dashboard as a speedometer
gauge, progress bar, or graph. You can control the potentiometer by turning
the adjustable knob left or right.
9 Barrel jack Accepts 4.5V to 24V through the development board. You can also use the
barrel jack with the battery pack provided with the kit.
10 USB jack The USB jack has two purposes:
1. To power the development board up to 5V.
2. To provide serial port access to the XBee Wi-Fi for configuration or
sending and receiving data to and from Remote Manager.

XBee Wi-Fi development board components and descriptions
XBee Wi-Fi Cloud Kit Getting Started Guide 8
Development
board
components Description
11 XBee reset The XBee reset is connected to the XBee Wi-Fi reset pin. You can reconfigure
it via the USB port.
12 DIP switches These switches allow components on the XBee Wi-Fi development board to
disconnect from the XBee. If the switch is away from the XBee, the XBee pin
is connected to that built-in widget on the XBee Wi-Fi dashboard. If the switch
is towards the XBee, the XBee pin disconnects from that component.
Note When you are using loose components or doing advanced prototyping,
you may need to disconnect the built-in component from the XBee pin.
13 Prototyping
headers
The prototyping headers allow connection to all pins of the XBee Wi-Fi. Use
the prototyping headers to connect to your own circuits including those using
the loose components that came with your kit.
14 Commissioning
button
Press the commissioning button four times to reset the network parameters
and reactivate Soft AP mode.

Set up your XBee Wi-Fi Cloud Kit
The XBee Wi-Fi Cloud Kit includes access to a sample web application that makes it quick and easy to
work with your XBee device. The XBee Wi-Fi sample web application integrates with Remote Manager
to enable two-way communication over the Internet, giving you remote control of your device
wherever you are. This application also allows you to customize your dashboard widgets so that you
can create your own connected device systems.
Configure your XBee Wi-Fi module using the Wi-Fi interface 10
Add your XBee Wi-Fi module to your Remote Manager account 10
Configure widgets on your XBee Wi-Fi sample web application 12
XBee Wi-Fi Cloud Kit Getting Started Guide 9

Set up your XBee Wi-Fi Cloud Kit Configure your XBee Wi-Fi module using the Wi-Fi interface
XBee Wi-Fi Cloud Kit Getting Started Guide 10
Configure your XBee Wi-Fi module using the Wi-Fi interface
By now you should have already verified the contents of your XBee Wi-Fi Cloud Kit, connected the
hardware, and configured your XBee to connect to a local Wi-Fi access point.
1. If you have not yet configured your XBee to connect to a local Wi-Fi access point, follow the
instructions in the Quick Start Guide that came in your kit, or find the XBee Wi-Fi Cloud Kit
Quick Start Guide online at Digi.com.
2. If your module is not able to connect to your Wi-Fi access point, it returns to Soft AP
configuration mode, and you are required to repeat the configuration steps. Keep in mind that
your SSIDand password are case sensitive.
3. If you are still having trouble connecting your XBee Wi-Fi to a local access point, see
Troubleshooting.
Add your XBee Wi-Fi module to your Remote Manager account
The XBee Wi-Fi Cloud Kit includes access to a sample web application that makes it quick and easy to
work with your XBee device. The XBee Wi-Fi sample web application integrates with Remote Manager
to enable two-way communication over the Internet, giving you remote control of your device
wherever you are. This application also allows you to customize your dashboard widgets so that you
can create your own connected device systems.
You must have a Remote Manager account to use the features of the XBee Wi-Fi sample web
application.
nIf you do not yet have a Remote Manager account, go to Create a Remote Manager account.
nIf you already have an account, go to Add your XBee Wi-Fi module to Remote Manager.
Create a Remote Manager account
Remote Manager enables you to set up and manage dynamic device networks. Your free developer
account lets you explore Remote Manager's application development and device management tools,
with a limited number of devices and transactions. With this developer account you discover how
Remote Manager's suite of device management and application development tools can help you
realize your machine-to-machine (M2M) solution. When you are ready to expand your Remote Manager
access, complete the following steps.
To create your free Remote Manager account: