Skip to content

Linux installation

Jump to bottom
Txisko edited this page May 12, 2015 · 3 revisions

XBee Internet Gateway for Linux

I. LINUX INSTALLATION

System requirements:

  • Linux (Ubuntu confirmed, please let us know results from other flavors)
  • Chrome, Firefox or similar web browser Hardware requirements:
  • XBee USB adaptor (XBee Explorer, Parallax, Adafruit, Digi XBee Evaluation board or similar)
  • USB cable
  • 802.15.4 (Series 1) or ZigBee ZB (Series 2) XBee radio Hardware configuration 802.15.4 (Series 1):
  1. For 802.15.4 XBee radios, pick a PAN ID between 0x0 and 0xFFFE. This will need to be set the same for all radios in your network.
  2. We recommend updating your XBee to the latest firmware in X-CTU
  3. Use X-CTU or a terminal program to configure your 802.15.4 radio with the following settings: * ATRE (to factory reset the radio…alternately use the Reset button in X-CTU) * ATID 1966 (please replace 1966 with your chosen PAN ID!) * ATAP 1 (sets your radio to basic API mode) * ATD6 1 (turns on monitoring for RTS) * ATBD 6 (sets baud rate to 57,600 which is currently the highest supported baud rate) * ATWR (saves these as the startup settings) Hardware configuration ZB ZigBee (Series 2):
  4. For ZigBee XBee radios, picking a PAN ID is optional, so we'll skip that for now.
  5. You will need to update your radio to use the ZigBee Coordinator in API mode firmware in X-CTU.
  6. Use X-CTU or a terminal program to configure your ZigBee Coordinator radio with the following settings: * ATRE (to factory reset the radio…alternately use the Reset button in X-CTU) * ATD6 1 (turns on monitoring for RTS) * ATBD 6 (sets baud rate to 57,600 which is the highest supported baud rate) * ATWR (saves these as the startup settings) Software Installation:
  7. Install Python 2.7 (see http://www.python.org/getit/)
  8. Download the latest version of the software from https://code.google.com/p/xig/wiki/DownloadFiles?tm=2 .
  9. Unzip and untar the file
  10. Move the xig_1_5_0 folder to the directory where you would like to install it.
  11. From the src directory, start the xig_app Python script in the gui directory: * xig/src> python gui/xig_app.py * (to run the application as a headless server, use "python gui/xig_app.py --no-browser" as the command to start the script and then go to http:// youripaddress :8000 to administer it.)
  12. You will see a command-line window open in the background:

http://faludi.com/xig/images/XIG_Linux_terminal.png * then your default web browser will be launched and directed to http://localhost:8000 to display the online user interface for the XIG (below). 1. Select the correct COM port for your XBee USB adaptor in the pop-up list 1. Select the correct baud rate for your XBee, typically 57,600. With the correct COM port and baud rate, your XBee Status should change to a green "Joined or Formed Network" indicator. 1. Enter a friendly name for your XBee Internet Gateway in the Description field.

II. Device Cloud SETUP

  1. Create a FREE account on Device Cloud.
  2. Log in to your new account.
  3. Select the Devices tab, to see the Devices panel: http://faludi.com/xig/images/XIG_iDigi_Manager_Pro_tab.png
  4. Click on Add Devices: http://faludi.com/xig/images/XIG_iDigi_Add_Devices_button.png
  5. Click on the Add Manually button: http://faludi.com/xig/images/XIG_iDigi_Add_Manually_button.png
  6. On the pop-up list, switch from MAC Address to Device ID. Then enter the Device ID that shows in the XIG Admin dashboard: http://faludi.com/xig/images/XIG_iDigi_Device_ID_list.png
  7. Click the Add button to add that device to the list, then click the OK button at the bottom of the window: http://faludi.com/xig/images/XIG_iDigi_DeviceID_Add_button.png http://faludi.com/xig/images/XIG_iDigi_device_added_OK_button.png
  8. Your device should show up in the list, it might still appear as Disconnected: http://faludi.com/xig/images/XIG_iDigi_Devices_list_disconnected.png
  9. Wait a few moments, then click on the circling yellow arrows to Refresh the list: http://faludi.com/xig/images/XIG_iDigi_Refresh_button.png
  10. You should now see your device listed as Connected: http://faludi.com/xig/images/XIG_iDigi_Devices_list_connected.png

(By default you will be connected to the login.etherios.com server. If you would like to use a different server you can edit the address in xig/src/settings.json) CONGRATULATIONS, you're done! Here's a quick tour of the important Device Cloud features:

  • Getting Data: Click on the Data Services tab. This is where data uploaded from your XIG will appear. The data you send will become available in a series of XML-formatted files. See the UserDocumentation under "Sending Sample Data to Device Cloud" for more information.
  • Sending Data and Commands: Click on the Web Services Console. This is where you can send test sending ASCII text and AT commands directly from the Internet to your XBees. See the UserDocumentation under "Sending Messages from the Internet to an XBee Using Device Cloud " and "Setting or Getting Remote XBee AT Settings via Device Cloud" for more information.
  • Follow the XIGproject on Twitter.
  • Join the XBee Internet Gateway discussion group

III. USE

See the XBee Internet Gateway UserDocumentation for further information.

http://faludi.com/xig/images/XIG_Linux_admin.png

Clone this wiki locally