1. Manuals
  2. Brands
  3. Digi Manuals
  4. Gateway
  5. ConnectPort X3 Series
  6. Getting started manual

Digi ConnectPort X3 Series Getting Started Manual

Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
®
C o n n e c t P o r t
X 3 F a m i l y
Getting Started Guide
90001180_A
May 20, 2011

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the ConnectPort X3 Series and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Digi ConnectPort X3 Series

Summary of Contents for Digi ConnectPort X3 Series

  • Page 1 ® C o n n e c t P o r t X 3 F a m i l y Getting Started Guide 90001180_A May 20, 2011...

  • Page 2: Table Of Contents

    2.7 iDigi Manager Pro ™ ................13 3 Digi ESP ™ for Python...............15 3.1 Digi ESP ™ for Python Overview ............15 3.2 Download and Install Digi ESP ™ for Python ......... 15 4 Configuring the Initial ConnectPort X3 Gateway Settings ...........17 5 Using Digi ESP ™...

  • Page 3: Introduction

    4. Verify the connection between your ConnectPort X3 gateway and iDigi via the device’s cellular interface. 5. Use the Digi ESP for Python IDE to build, download, and run your first Python sample project on your ConnectPort X3 gateway. 6. View the uploaded GPS data from the ConnectPort X3 gateway using iDigi Manager Pro.

  • Page 4: Connectport X3 Product Features

    ConnectPort ® X3 Family Getting Started Guide 1.1 ConnectPort X3 Product Features 1. Mounting feet 2. Cellular antenna connector 3. XBee antenna connector 4. GPS antenna connector 5. SIM slot Page 4...

  • Page 5: Connectport X3 H Product Features

    ConnectPort ® X3 Family Getting Started Guide 1.2 ConnectPort X3 H Product Features Note: The ConnectPort X3 H module is housed within a NEMA enclosure. The image shown below identifies the NEMA-enclosure hardware features for the product only. Please refer to the ConnectPort X3 Product Features section on page 4 for the ConnectPort X3 hardware within the NEMA enclosure.

  • Page 6: Connectport X3 And Connectport X3 H Leds

    ConnectPort ® X3 Family Getting Started Guide 1.3 ConnectPort X3 and ConnectPort X3 H LEDs RESET XBEE CELLULAR LINK LINK LINK CELLULAR SIGNAL STRENGTH STATUS POWER 6-30VDC 1.75A MAX SERIAL 1. GPS Lock LED 2. Status LED 3. Power LED 4.
  • Page 7 ConnectPort ® X3 Family Getting Started Guide The following table displays LED functionality for the ConnectPort X3 and ConnectPort X3 H. Color and Description Light Pattern Power Device is off Solid blue Device is on Status Blinking amber Normal operation Solid amber Device is initializing Cellular Link...

  • Page 8: Connectport X3 R Product Features

    ConnectPort ® X3 Family Getting Started Guide 1.4 ConnectPort X3 R Product Features Side View 1. Wiring Harness connector 2. Cellular antenna connector 3. GPS antenna connector 4. XBee antenna connector 5. SIM slot Top View ConnectPort X3 6. Mounting holes 7.
  • Page 9 ConnectPort ® X3 Family Getting Started Guide 1.4.1 ConnectPort X3 R LEDs The following table displays LED functionality for the ConnectPort X3 R. Color and Description Light Pattern POWER Device is off Solid blue Device is on STATUS Blinking amber Normal operation Solid amber Device is initializing...

  • Page 10: Idigi

    Manager Pro will be discussed in more detail in section 2.7 iDigi Manager Pro™ on page 13. For more information about iDigi visit the iDigi web site at www.idigi.com, or see the iDigi User’s Guide available at http://www.digi.com/connectportx3. Page 10...

  • Page 11: Create An Idigi ® Developer Account

    ConnectPort ® X3 Family Getting Started Guide 2.6 Create an iDigi ® Developer Account An iDigi developer account is a full service iDigi user account providing access to a limited number of iDigi devices. It allows iDigi developers to set up a maximum of five iDigi devices in order to develop Python programs and iDigi client applications that will leverage the functionality provided by both iDigi and the iDigi devices.
  • Page 12 ConnectPort ® X3 Family Getting Started Guide 4. If you are a current iDigi developer account user, login with your existing user name and password. If you are a new user, click on the “Are you a new user” link and follow the on-screen instructions to create an account.

  • Page 13: Idigi Manager Pro

    ConnectPort ® X3 Family Getting Started Guide 2.7 iDigi Manager Pro ™ iDigi Manager Pro is a web based device management application that allows a user to manage their inventory of iDigi devices. iDigi Manager Pro delivers capabilities that empower IT, network operations and customer support organizations to conquer the challenges of managing the vast array of equipment in their device networks, including: •...
  • Page 14 ConnectPort ® X3 Family Getting Started Guide 4. Ensure the device is displayed in the devices list on the Devices Page. Notice that the status column indicates Disconnected. Later in this guide you will configure the ConnectPort X3 gateway to properly establish both a cellular and iDigi connection which will change this state to “Connected”.

  • Page 15: Digi Esp ™ For Python

    1. Navigate to http://www.digi.com/connectportx3 and click on the Download Digi ESP for Python link. 2. The various download options for the Digi ESP for Python framework will be displayed on this page. Based on your operating system, click the link to download Digi ESP for Python.
  • Page 16 ConnectPort ® X3 Family Getting Started Guide 3. Once the Digi ESP for Python framework has been downloaded, run the Digi ESP for Python framework installation wizard. Follow the steps in the wizard until the Choose Components dialog is displayed.

  • Page 17: Configuring The Initial Connectport X3 Gateway Settings

    To configure your unit: 1. Open the Digi X3 Dashboard. To do so, navigate to Start > Digi > Digi X3 Dashboard > Digi X3 Dashboard. Once the Digi X3 Dashboard opens the Device Information tab should be displayed as shown below.
  • Page 18 ConnectPort ® X3 Family Getting Started Guide 2. To configure your mobile settings click, on the Mobile tab. Enter your service plan/APN information into the Service Plan/APN field then click Apply. Note: “i2gold” is for example purposes only. Enter your specific service plan/APN information in place of this text.
  • Page 19 ConnectPort ® X3 Family Getting Started Guide 3. The Remote Management tab is used to provide the address of the iDigi Device Cloud which is “developer.idigi.com” in this case. Click on the Remote Management tab and configure your settings to match what is displayed in the image below, then click Apply. Page 19...
  • Page 20 Note: If an IP address is not displayed and the LED is not green, click the Refresh button and wait a few seconds for the ConnectPort X3 gateway to refresh its configuration settings. 5. Click OK to exit the Digi X3 Dashboard program. Page 20...
  • Page 21 6. Verify the ConnectPort X3 gateway’s connection to iDigi by opening the Device Page within iDigi Manager Pro, and ensuring that the status column shows Connected for the device’s status. For more information about the configuration settings for your ConnectPort X3 gateway, see the ConnectPort X3 Family User’s Guide, available at http://www.digi.com/connectportx3. Page 21...

  • Page 22: Using Digi Esp ™ For Python

    ConnectPort X3 gateway. This section will guide you through the steps required to run your first sample project. 1. If it is not already open, launch Digi ESP for Python (Start > Digi > iDigi > Digi ESP). 2. Open the Digi ESP for Python Workbench (second image shown below) by clicking on the Workbench icon (as indicated in the image below).
  • Page 23 ConnectPort ® X3 Family Getting Started Guide Note: The Package Manager screen (shown below) will be displayed every time you run Digi ESP for Python (except the very first time, or until you de-select the “open this dialog at startup” checkbox).
  • Page 24 ConnectPort ® X3 Family Getting Started Guide 4. Click to enable the ‘Show only samples compatible with platform:’ checkbox, then select your ConnectPort X3 gateway from the drop-down menu. For the example used in this guide, the ConnectPort X3 R gateway is selected. 5.
  • Page 25 ConnectPort ® X3 Family Getting Started Guide 6. Within the Remote Device Selection wizard page, ensure that Use Current Remote Configuration is selected and then click the New… button to create a new remote configuration. Page 25...
  • Page 26 After clicking the New… button, the Device Manager wizard dialog will open. Click on the Device Discovery button. b. A dialog will ask you to identify a location where the Digi ESP for Python framework should look for devices. Select Local area network / USB / UART devices. Click OK when finished.
  • Page 27 ConnectPort ® X3 Family Getting Started Guide c. A progress dialog is displayed, indicating that the Digi Device Discovery utility is searching for devices. When the search is finished the Digi Device Discovery dialog is displayed listing all the Digi devices discovered on your local network.
  • Page 28 ConnectPort ® X3 Family Getting Started Guide e. Ensure that your ConnectPort X3 gateway is displayed in the ‘Select the connected device type from the list:’ drop-down menu. For the example used in this guide, the ConnectPort X3 R gateway should be displayed.
  • Page 29 ConnectPort ® X3 Family Getting Started Guide Click on the USB/UART Connection tab. Verify that your COM port is selected from the ‘Select the COM Port connected to the device’ drop-down menu, then change the ‘Reboot TimeOut (seconds)’ field to 60 seconds. Page 29...
  • Page 30 ‘Password’ fields. Ensure that developer.idigi.com is typed into the ‘Host Name field, then click Apply. h. Click the Set Current button 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 interaction with the remote device (reboot, transfer files, etc.).
  • Page 31 ConnectPort ® X3 Family Getting Started Guide 8. When the Remote Device’s Information wizard page is displayed, click Next. 9. When the Review wizard page is displayed, click Finish. Page 31...
  • Page 32 ConnectPort ® X3 Family Getting Started Guide Once the wizard closes your selected project, idigi_gps, will be displayed in your Digi ESP for Python workbench’s workspace. 10. You are now ready to run your sample project. Using the Run As button’s drop-down menu (shown below) go to Run As >...
  • Page 33 ConnectPort ® X3 Family Getting Started Guide The Source View region of the Workbench screen (highlighted below) will display status messages as the project builds, downloads files to your ConnectPort X3 gateway, reboots your ConnectPort X3 gateway (in order to start the application), and finally starts sending GPS application data to your ConnectPort X3 gateway.

  • Page 34: Viewing Uploaded Data On Idigi

    ConnectPort ® X3 Family Getting Started Guide ® 6 Viewing Uploaded Data on iDigi Each of the 10 data messages sent from your ConnectPort X3 gateway to the iDigi Developer Cloud can be viewed in their entirety using iDigi Manager Pro. This section will guide you through the steps required to view your uploaded GPS data.
  • Page 35 5. Double-click on one of the files to display its contents; for example the GPS positioning information from the ConnectPort X3 gateway. This is the end of the Digi ESP for Python Application Sample Project demonstration. You can rerun the sample program at any time by repeating Step 10 of Chapter 5, and its subsequent Reboot Target button.
  • Page 36 © 2011 Digi International Inc. All rights reserved. Digi, Digi International, the Digi logo, a Digi International Company, the Digi web site, iDigi, iDigi Dia, iDigi Manager Pro, iDigi Device Cloud, iDigi Developer Cloud, Digi Connect, ConnectPort X, XBee, and Digi ESP are trademarks or registered trademarks of Digi International, Inc. in the United States and other countries worldwide.

Table of Contents