Digi ConnectPort Network Device Guide de l'utilisateur

ConnectPort® X2e ZBUser’s GuideConnectPort X2e ZB EthernetConnectPort X2e ZB Wi-FiConnectPort X2e ZB Cellular 90001298_C

Configuration and management interfaces10iDigi Manager Pro™ interfaceThe default behavior of Connectport X2e ZB is to power up and connect to the iDig

Configuration and management interfaces11With iDigi Manager Pro, management of large populations of devices is made easy. Devices can be tagged and gr

Programming interfaces and capabilities12Programming interfaces and capabilitiesThe ConnectPort X2e ZB allows custom embedded logic via the Python scr

Product differences from predecessor ConnectPort X products13Linux command shellNote: The ConnectPort X2e ZB also has a Linux shell command-line inter

Where to find more information14 User interfaces:– The ConnectPort X2e ZB has a web user interface for both network configuration and access to the l

15HardwareCHAPTER 2This section provides hardware specifications, reviews key hardware features, and lists regulatory statements and certifications of

16ConnectPort X2e ZB Cellular hardware1 Power requirements. See page 19.2 LED status indicators. See the Getting Started Guide topic “Troubleshooting.

Hardware specifications17Hardware specificationsConnectPort X2e ZB Ethernet and Wi-FiSpecification ValueEnvironmental Operating temperature32° F to 10

Hardware specifications18Wi-Fi 802.11 b/g/n (2.4GHz only)Data RateUp to 72.2 MbpsTransmit Power 18 dBm typical (varies by mode and channel)Receiver Se

Hardware specifications19ConnectPort X2e ZB CellularSpecification ValueEnvironmental Operating temperature32° F to 104° F (0° C to 40° C)Relative humi

2©Digi International Inc. 2013. All Rights Reserved.The Digi logo, ConnectPort, iDigi Device Cloud, iDigi Manager Pro, iDigi Dia, and XBee are tradema

Hardware specifications20Cellular EDGE 850, 900, 1800, 1900 MHzGSM UMTS / HSPA 800/850, 900, 1700 (AWS), 1900, 2100 MHzCDMA 1xRTT 800, 1900 MHzEV-DO 8

LEDs21LEDsThe ConnectPort X2e ZB has several LEDs. All LEDs have default behaviors, described in this section. LED descriptions are in the “Troublesho

LEDs22Power LEDXBee LEDThe XBee LED indicates the status of the connection of the XBee RF module in the ConnectPort X2e ZB to an XBee wireless network

LEDs23Signal strength LEDColor and blink pattern DescriptionOFF No or poor cellular signal. Moving device to a better location is recommended.Solid ye

LEDs24Network LEDThe Network LED indicates the status of the connection of the ConnectPort X2e ZB to both a communications network and an iDigi server

Button25ButtonThe button on the ConnectPort X2e ZB is capable of performing a number of Digi-defined actions, including: Reset the device configurati

Button26Factory resetPressing the button for over 10 seconds after the ConnectPort X2e ZB is running resets the device to its factory default configur

Antennas27AntennasThe ConnectPort X2e ZB has internal antennas.  All models have an internal antenna for the XBee RF module.  Wi-Fi models have an a

Regulatory information and certifications28Regulatory information and certificationsRF exposure statementIn order to comply with RF exposure limits es

Regulatory information and certifications29European Community - CE Mark Declaration of Conformity (DoC)We:of:Declare under our sole responsibility tha

Contents3ContentsContents...

Regulatory information and certifications30Industry Canada (IC) certificationsThis digital apparatus does not exceed the Class B limits for radio nois

Regulatory information and certifications31Safety statementsImportant Safety InformationTo avoid contact with electrical current:  Never install elec

Regulatory information and certifications325.10 Ignition of Flammable Atmospheres Warnings for Use of Wireless DevicesObserve all warning notices rega

Regulatory information and certifications33International EMC (Electromagnetic Emissions/Immunity/Safety) standardsThis product complies with the requi

Configuration can be performed programmatically34ConfigurationCHAPTER 3While the ConnectPort X2e ZB is designed to allow network communication with mi

Important configurable settings35Important configurable settingsFor the ConnectPort X2e ZB, most settings have reasonable defaults that do not need to

Important configurable settings36DNS serversA DNS (Domain Name System) server is an Internet service that resolves domain names into IP addresses. Nam

Important configurable settings37Mobile settings and provisioningThe mobile settings configure how to connect to mobile (cellular) networks using the

Important configurable settings38Raw SMS messagingIn addition to iDigi-formatted messages, a user can send an SMS message without iDigi modifying it a

Important configurable settings39iDigi remote device managementThe ConnectPort X2e ZB, as with many of its predecessors, is compatible with the iDigi

Contents4Industry Canada (IC) certifications ...

Additional device configuration settings40Additional device configuration settingsThere are several additional device features that are not essential

Configuration from the Web interface41Configuration from the Web interfaceThe web interface for ConnectPort X2e ZB is intended to support basic featur

Configuration from the Web interface424 A dialog is displayed for asking where to look for connected devices. Make sure the option Local Area Network

Configuration from the Web interface436 Open an internal browser within Digi ESP by choosing Window > Show View > Other > Internal Web Browse

Configuration from the Web interface44The Home pageWhen the web interface is opened, the Home page is displayed. The information listed on this page m

Configuration from the Web interface45Configuration and Administration linksThe left side of the Home page has a menu of choices that display pages fo

Configuration from the Web interface46Configuration settings pagesEthernet NetworkThe Ethernet Network settings display the current IP address and DHC

Configuration from the Web interface47Mobile Connectivity settingsThe Mobile Connectivity settings identify the service provider to use in connecting

Configuration from the Web interface48 Short Message Service (SMS) Settings: These options configure the cellular Short Message Service (SMS) capabil

Configuration from the Web interface49SureLink™ Configuration settingsDigi SureLink™ is an optional feature that monitors the integrity of an establis

Contents5Restore Factory Defaults ...

Configuration from the Web interface50 Ping Test: Enables or disables the use of “ping” (ICMP) as a test to verify the integrity of the mobile connec

Configuration from the Web interface51 Repeat the selected link integrity test every N seconds: Specifies the interval, in seconds, at which the sele

Configuration from the Web interface52Python: configure automatic starting and exit conditions for Python programsThe Python Autostart Configuration p

Configuration from the Web interface53Network ServicesThe Network Services page enables or disables common network services that are available on the

Configuration from the Web interface54iDigi ConnectivityThe iDigi Connectivity page enables/disables the connection to the iDigi server used for manag

Configuration from the Web interface55XBee NetworkThe ConnectPort X2e ZB provides a gateway between an Internet Protocol (IP) network and a network of

Configuration from iDigi Manager Pro56Configuration from iDigi Manager ProThe iDigi User’s Guide describes how to set up an iDigi account and add devi

Configuration from iDigi Manager Pro57Basic configuration settingsIn the iDigi Manager Pro interface, basic configuration settings for the ConnectPort

Configuration from iDigi Manager Pro58SureLink settings Digi SureLink™ is an optional feature that monitors the integrity of an established network co

Configuration from iDigi Manager Pro59 Host List: Two hostnames may be configured for this test. Hostnames can be specified in the form of domain nam

About this guide6IntroductionCHAPTER 1About this guideThis guide introduces the hardware, firmware, and software features of the ConnectPort® X2e ZB.

Configuration from iDigi Manager Pro60XBee Networks pageClicking the XBee Networks menu within the iDigi Manager Pro tab opens the XBee Networks page.

Configuration from iDigi Manager Pro61XBee RF module settingsThe configuration information for an XBee node is displayed by opening its Properties pag

Configuration from iDigi Manager Pro62SMS settingsThere are three groups of SMS settings and tasks in the iDigi Manager Pro interface from the right-c

Configuration from iDigi Manager Pro63SMS > SMS commands | ConfigureRight-clicking the device and selecting SMS from the menu displays a set of SMS

Common administrative tasks 64Administration/maintenanceCHAPTER 4This chapter describes the administrative and maintenance tasks that need be performe

Common administrative tasks 65XBee RF module firmware updatesUpdating the firmware for XBee RF modules involves two firmware update scenarios: Update

Administration from the Web interface66Administration from the Web interfaceFirmware UpdateThe Firmware Update page updates the gateway operating syst

Administration from the Web interface67Mobile StatusThe Mobile Status page items are specific to a cellular modem or service provider account. These v

Administration from the Web interface68Status field Cellular modem typeDescriptionDevice type Both The type of cellular modem. For CDMA devices, the v

Administration from the Web interface69Provisioning status CDMA Specifies the status of the provisioning process for the cellular modem, in which it i

ConnectPort X2e ZB7ConnectPort X2e ZBThe ConnectPort X2e ZB is a compact, ZigBee®-to-IP gateway that provides low-cost IP connectivity of RF devices a

Administration from the Web interface70Network ID CDMA The network identification number of the cellular network with which the cellular modem is regi

Administration from the Web interface71Connection state Both The operating state of the cellular modem:Initializing: Modem is being reset and config

Administration from the Web interface72Disconnect reason BothDisplayed after a previous connection was ended. Indicates the reason the previous connec

Administration from the Web interface73Idle timeout Both The number of connection resets because the idle timeout was reached/exceeded for transmitted

Administration from the Web interface74File ManagementThe File Management page loads files onto the ConnectPort X2e ZB and displays current informatio

Administration from the Web interface75System LogThe System Message Log File Browser is a diagnostic tool that allows viewing entries in a system log

Administration from the Web interface76Available log files and contentsThe following log files are available:The Message Filters allow Digi Technical

Administration from iDigi Manager Pro77Administration from iDigi Manager ProIn iDigi Manager Pro, administration tasks are organized in the right-clic

Administration from iDigi Manager Pro78Restore Factory DefaultsAdministration > Restore Factory Defaults restores the factory default configuration

Administration from iDigi Manager Pro79File ManagementThe File Management task is launched from the Properties page for ConnectPort X2e ZB, by clickin

Hardware interfaces8Hardware interfacesConnectPort X2e ZB hardware interfaces include a button for controlling various device operations, LEDs that in

Administration from iDigi Manager Pro80The File Management toolbar provides quick access to file management tasks.System logThere is no browser interf

Administration from iDigi Manager Pro81System information The System Information pages display general system information and system statistics. This

82ProgrammingCHAPTER 5The ConnectPort X2e ZB offers a variety of interfaces that produce and/or consume data. Developing software programs for Connect

Programming resources83Programming resourcesSeveral tools and resources are available for developing software programs for the ConnectPort X2e ZB.Pyth

Programming resources84Program samples in Digi ESPDigi ESP for Python provides samples to use as a base for programming the ConnectPort X2e ZB, includ

Programming resources85iDigi Dia softwareThe Digi ESP development environment includes iDigi Device Integration Application (iDigi Dia) software. This

Programming resources86Digi Python Programmer’s GuideThe Digi Python Programmer’s Guide introduces the Python programming language by showing how to c

Digi-specific Python modules for programming87Digi-specific Python modules for programmingSeveral Digi-provided built-in modules apply to functionalit

Sample programs88Sample programsThese simple annotated samples introduce several programmable features for the ConnectPort X2e ZB, including button ha

Sample programs89LED controlControlling the LEDs on the ConnectPort X2e ZB is handled through the user_led_set function. This sample program controls

Configuration and management interfaces9Web interface The web interface, available via a local network connection to the ConnectPort X2e ZB, provides

Sample programs90WatchdogThe watchdog feature, provided through the watchdog module, exists as a safeguard. If there are critical operations that “mu

Sample programs91RCI callbackAn RCI callback involves two types of actions, demonstrated in the following programs:  Making RCI requests from Python

Sample programs92Make an RCI request-example programFollowing is a simple RCI callback example: import rci (1)def cb(req): (2) print "Received re

Sample programs93XBee functionsFor a description of the xbee module and program samples, see this Wiki page:http://www.digi.com/wiki/developer/index.p

The ConnectPort X2e ZB filesystem94The ConnectPort X2e ZB filesystemThe ConnectPort X2e ZB has a Linux-based filesystem. This section gives an overvie

The Linux command shell (command-line interface)95The Linux command shell (command-line interface)A shell is a program that takes commands from the ke