Digi X4K-Z1U-00011-A1 Getting Started Manual Download Page 62

iDigi

 

Gateway

 

Development

 

Kit

 

Getting

 

Started

 

Guide

    

 

62

 

 

3.

 

At

 

this

 

point

 

in

 

time,

 

the

 

ConnectPort

 

X4

 

has

 

been

 

added

 

to

 

your

 

iDigi

 

inventory,

 

but

 

the

 

device

 

itself

 

has

 

not

 

yet

 

been

 

configured

 

to

 

establish

 

a

 

connection

 

to

 

iDigi.

 

To

 

configure

 

the

 

ConnectPort

 

X4

 

to

 

establish

 

a

 

connection

 

to

 

iDigi,

 

follow

 

the

 

steps

 

below.

  

a.

 

If

 

you

 

know

 

the

 

IP

 

address

 

of

 

the

 

ConnectPort

 

X4,

 

connect

 

to

 

its

 

web

 

UI

 

by

 

entering

 

its

 

IP

 

address

 

in

 

your

 

web

 

browser.

   

If

 

you

 

do

 

not

 

know

 

the

 

IP

 

address

 

of

 

the

 

unit,

 

use

 

the

 

Digi

 

Device

 

Discovery

 

tool

 

in

 

the

 

Start

 

Menu,

 

and

 

double

click

 

on

 

the

 

device

 

to

 

open

 

its

 

web

 

UI.

 

b.

 

Click

 

the

 

iDigi

 

link

 

to

 

configure

 

the

 

device’s

 

remote

 

management

 

configuration

 

options.

 

In

 

the

 

Digi

 

configuration

 

settings

 

page,

 

enter

 

the

 

DNS

 

name

 

of

 

the

 

iDigi

 

platform

 

(

developer.idigi.com

)

 

into

 

the

 

iDigi

 

Server

 

Address

 

field

 

under

 

the

 

“Enable

 

Device

Initiated

 

iDigi

 

Connection”

 

section.

 

c.

 

Click

 

the

 

checkbox

 

labeled

 

“Automatically

 

reconnect

 

to

 

iDigi

 

after

 

being

 

disconnected”

 

then

 

click

 

Apply

.

 

 

  

Figure

 

69:

 

iDigi

 

Configuration

 

Page

 

The

 

ConnectPort

 

X4

 

will

 

now

 

attempt

 

to

 

establish

 

a

 

connection

 

with

 

iDigi,

 

if

 

the

 

device

 

is

 

on

 

a

 

network

 

with

 

Internet

 

access,

 

the

 

connection

 

should

 

be

 

established

 

in

 

less

 

than

 

a

 

minute.

 

With

 

the

 

ConnectPort

 

X4

 

properly

 

configured

 

to

 

communicate

 

with

 

iDigi,

 

and

 

with

 

the

 

device

 

added

 

to

 

your

 

iDigi

 

inventory,

 

return

 

to

 

the

 

“Add

 

the

 

ConnectPort

 

X4

 

to

 

your

 

iDigi

 

inventory”

 

section

 

and

 

proceed

 

with

 

Step

 

d

 

on

 

page

 

13.

 

Downloaded from 

Elcodis.com

 

electronic components distributor

 

Summary of Contents for X4K-Z1U-00011-A1

Page 1: ...iDigi Gateway Development Kit Getting Started Guide December 16 2010 90001205 _A Downloaded from Elcodis com electronic components distributor...

Page 2: ...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 inc...

Page 3: ...ren 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...

Page 4: ...n Development Environment 14 Step 5 Create your first iDigi Dia Project 17 Step 6 Perform an iDigi Web Services API Request 38 Step 7 Using the iDigi Gateway Development Kit Demonstration Application...

Page 5: ...ng Started Guide 5 Is the ASSC LED blinking green 60 iDigi Manager Pro does not discover your ConnectPort X4 61 iDigi Manager Pro lists the ConnectPort X4 as Disconnected 63 Downloaded from Elcodis co...

Page 6: ...onsole to send a web service request to the ConnectPort X4 retrieving the current XBee devices sensor readings 5 Use the iDigi Gateway Development Kit Demonstration Application to understand how an En...

Page 7: ...ice Discovery Application For proper kit configuration and operation the Digi Device Discovery Application must be downloaded and installed To download the Digi Device Discovery Application 1 Navigate...

Page 8: ...you are unable to do this other devices might join the kit network and create interference when deploying your iDigi Dia project You could also encounter issues connecting the XBee Sensor and XBee Sm...

Page 9: ...ciated with an XBee network 5 Remove the batteries 3 from the box and install them into the XBee Sensor unscrew the two screws on the XBee Sensor to install the batteries The XBee Sensor s ASSC LED wi...

Page 10: ...red and wireless Digi and third party Gateways called iDigi devices The iDigi platform provides easy integration with M2M and mesh network devices First before you can connect your ConnectPort X4 to i...

Page 11: ...ogin Page Continue filling in all required fields of the iDigi Registration Form until you complete the iDigi Registration process Figure 6 New User Registration Page d After completing the iDigi Regi...

Page 12: ...ices on your network automatically the Add Devices applet requires Java Runtime Environment JRE 1 6 or newer If Java Runtime Environment JRE 1 6 is not installed you must add your device manually see...

Page 13: ...tPort X4 should now appear as Connected Figure 8 iDigi Device Inventory Note If the device still appears as Disconnected after clicking the Refresh button please refer to the iDigi Manager Pro lists t...

Page 14: ...for Python Development Environment 1 Navigate to http www digi com gatewaydevelopmentkit and click on the Download Digi ESP for Python link 2 You will be redirected to the Python Product page The vari...

Page 15: ...mework will launch automatically and prompt you to select a workspace directory Use the default workspace directory or click the Browse button and navigate to your desired alternate workspace location...

Page 16: ...SP for Python the Welcome screen is displayed Figure 11 Digi ESP for Python Welcome Screen 6 Open the Digi ESP for Python Workbench by clicking on the Workbench icon as indicated above Figure 12 Digi...

Page 17: ...s in this section will help you build download and launch your first iDigi Dia application The resulting iDigi Dia application will contain drivers for the XBee Sensor and XBee Smart Plug The applicat...

Page 18: ...insert the name of the project to be created name your project This example uses a project name of Demo_Project1 but you can choose any unique name Once the project name has been provided click Next...

Page 19: ...nd then click the New button to create a new remote configuration Figure 15 Create New Configuration A new Remote Device Configuration is needed to work with each specific target device your ConnectPo...

Page 20: ...the dialog lists the Remote Configurations that exist in the Workbench b Initially there are no Remote Configurations listed in the Device Manager To begin the process of creating your first Remote C...

Page 21: ...17 Digi Device Discovery Search Location Selection d When finished the Digi Device Discovery dialog will appear listing all the Digi devices discovered on your local network Your device should be list...

Page 22: ...ttings configured automatically f Click Set Current to make this configuration the current one which means that the Digi ESP for Python framework will use it to perform several operations that require...

Page 23: ...fter clicking the Set Current button you will be redirected back to the iDigi Dia Project wizard Ensure that Use Current Remote Device is selected and click Next Figure 20 Remote Device Selection Down...

Page 24: ...2 4 3 is selected within the Python settings section and that iDigi Dia is supported then click Finish to create the project Figure 21 Remote Device s Information Note If a prompt appears asking you...

Page 25: ...e Pydev Package Explorer view expand it to see its contents To open the Pydev Package Explorer view select Window Show View Pydev Package Explorer If Pydev Package Explorer does not appear in the list...

Page 26: ...e project dia yml will be opened and displayed in the Smart Project Editor view It contains the iDigi Dia elements devices services etc that will be used by the iDigi Dia project Figure 24 Smart Proje...

Page 27: ...ote For non US kits select the XBee Wall Router instead of XBee RPM 8 At this point in time the two XBee devices have been added to your project but the iDigi Dia Project Editor is missing the XBee MA...

Page 28: ...ice Discovery Path 10 Running the Digi Device Discovery Tool will bring up the Digi Device Discovery Application Devices list Figure 27 Locate your Device in the Device List Locate your device in the...

Page 29: ...4 Configuration and Management Home Page 11 The ConnectPort X4 s Home page contains several links Click on the XBee Network link from the left menu to access the XBee Configuration page Figure 29 XBee...

Page 30: ...are not listed try clicking the Discover XBee Devices button to force the ConnectPort X4 to discover its attached XBee devices If this does not fix the problem see the XBee devices fail to join the C...

Page 31: ...from the ConnectPort X4 s web UI into the MAC address field of the XBee Sensor device in the Smart Project Editor b Then copy the Extended Address of your XBee Smart Plug from the ConnectPort X4 s web...

Page 32: ...ore often These sensor updates will allow you to see value changes more easily in the steps to follow However changing the sleep interval will impact battery life as well This is something you should...

Page 33: ...m the menu Figure 33 Save Project 16 Now that the XBee MAC addresses have been configured your iDigi Dia project is fully configured and ready to be deployed Click the Run button on the main toolbar t...

Page 34: ...gi Dia project builds Downloads files to your ConnectPort X4 Reboots your ConnectPort X4 in order to start the Dia application and finally starts running the Dia application on your ConnectPort X4 Fig...

Page 35: ...he following Figure 36 Dia Web Presentation Tab The Elements section of the Smart Project Editor for iDigi Dia provides several presentations including an RCI Handler Console Port and a Web Presentati...

Page 36: ...html Figure 37 XBee Smart Plug Power ON From this page you can turn the XBee Smart Plug off and on as well as view all the current sensor readings In order to demonstrate how this web page can contro...

Page 37: ...anges button d To update the values displayed by the XBee devices sensors click the Refresh All button You have just completed Goal 3 Using the Digi ESP for Python IDE to build download and launch an...

Page 38: ...Smart Plug by making a minor modification to one of the provided examples and then sending an HTTP Post request to iDigi which will respond with the current sensor readings from the sensors in your X...

Page 39: ...this box you will select the target iDigi devices that you would like to send requests to 5 Click on the Add Targets drop down box and choose the device ID corresponding to your ConnectPort X4 Click t...

Page 40: ...ger Pro will now send Web Services API examples to the selected device Within the Web Services Console toolbar click on the Examples drop down menu then go to SCI Python Callback Figure 43 Python Call...

Page 41: ...rieve the sensor readings from your XBee devices you will need to modify this example text slightly a Locate the following lines of text highlighted in the screenshot below do_command target rci_callb...

Page 42: ...equest to iDigi you will be prompted to enter your iDigi credentials enter them in the dialog provided Once authenticated iDigi will send this request to the ConnectPort X4 on behalf of your web servi...

Page 43: ...9 Observe the output displayed within the Web Services Responses panel A POST ws sci 200 response indicates that the web services request was successful Figure 46 Successful Callback Attempt Download...

Page 44: ...htness power on state and temperature readings from the rpm0 XBee Smart Plug device and the brightness battery condition and temperature reading from the sensor0 XBee Sensor device Figure 47 Successfu...

Page 45: ...k you through this process 1 Navigate to http www digi com gatewaydevelopmentkit and click on the Link to iDigi Gateway Development Kit Demo Application link 2 You will be redirected to the iDigi Gate...

Page 46: ...for the XBee Sensor and the XBee Smart Plug connected to your ConnectPort X4 s XBee network Values are updated by clicking the refresh button Every time the screen is refreshed the application also up...

Page 47: ...sensors are reported Figure 50 XBee Sensor Display In the event that your brightness reading looks similar to the example above simply cover the light sensor on the front of the XBee Sensor and click...

Page 48: ...application displays the current flowing through the XBee Smart Plug and the On Off state of the XBee Smart Plug Figure 52 XBee Smart Plug Display Current Flowing In the event your XBee Smart Plug dis...

Page 49: ...ry data click the Refresh button Figure 54 Logged Data Display Off When you log in to this demonstration application Telemetry logging will start automatically and run for an hour Since the logged dat...

Page 50: ...look similar to the following Figure 56 Logged Data Display XBee Smart Plug Off XBee Sensor Covered Waiting a few moments before turning the XBee back on and uncovering the light sensor on the XBee Se...

Page 51: ...understand how a web services enabled Enterprise application interacts with iDigi and monitors the data gathered by the XBee device sensors Congratulations you have completed the process of setting up...

Page 52: ...an on demand platform as a service you will only be charged for what you use Further support can be accessed through our support portal at http www digi com support kw idigi iDigi Dia Device Integrat...

Page 53: ...Bar and explore the documents listed under the iDigi Dia Resources and iDigi Platform Resources headings Figure 59 iDigi Dia and iDigi Documentation Additional documentation can also be found on the...

Page 54: ...ations with Python in the Eclipse platform Digi ESP for Python customizes Eclipse and PyDev to support developing specifically with Digi platforms Digi ESP for Python documentation can be found within...

Page 55: ...itional help documentation can be located by navigating to Help Help Contents from the Digi ESP for Python framework main menu Figure 63 Help Contents Path Figure 64 Digi ESP for Python Help Section D...

Page 56: ...Web Presentation The Web Presentation iDigi Dia project described in this guide provides details for a new web page idigi_dia html Click on the Dia Web Presentation tab to open this new web page Figur...

Page 57: ...our ConnectPort X4 using TCP port 4146 and the iDigi Dia CLI will be presented to you Figure 67 Establish a Telnet Connection The will provide a list of the supported CLI commands and the channel_dump...

Page 58: ...ays support the Python programming language and offer the memory space for local development This allows the gateways to function with enough local intelligence to make decisions about which events ar...

Page 59: ...regarding the XBee Smart Plug go to http www digi com products wirelessdropinnetworking networkextenders xbee smart plug zb jsp For more information regarding the XBee Wall Router go to http www digi...

Page 60: ...work or the ConnectPort X4 simply needs to rediscover the list of its attached XBee devices To troubleshoot this problem first try clicking the Discover XBee Devices button on the ConnectPort X4 s XBe...

Page 61: ...dd the ConnectPort X4 to your iDigi inventory by clicking the Add Manually button and then entering the MAC address found on the bottom of the device into the appropriate field After the MAC address i...

Page 62: ...management configuration options In the Digi configuration settings page enter the DNS name of the iDigi platform developer idigi com into the iDigi Server Address field under the Enable Device Initia...

Page 63: ...Internet access 2 The ConnectPort X4 is unable to resolve the DNS address of developer idigi com 3 If you added the ConnectPort X4 to iDigi inventory manually the MAC address provided to iDigi may no...

Reviews: