Digi XBee Industrial Gateway SSH Error During ESP Build

 Digi ESP for Python - XBee Industrial Gateway

* If you are using the XBee Industrial Gateway follow the instructions below. It is mandatory to start Digi ESP for Python as Administrator to avoid build errors. 

The XBee Industrial Gateway incorporates an ssh server that it is incompatible with the client integrated in the Digi ESP for Python. This makes Digi ESP for Python unable to communicate with the XBee Industrial Gateway using ssh protocol, and as a result, avoiding launching and debugging applications from the IDE into the Gateway.
To fix the problem, two patches are required within the Digi ESP for Python installation, this zip file contains all the required files. These are the required changes:

Download zip file is at this URL: https://ftp1.digi.com/support/driver/ESP/digiesp_python_2.3.0_xbee_industrial_gateway_patch.zip

  • Update the provided Digi ESP for Python JRE (Java Runtime Environment) from version 1.6 to version 1.8. The JRE version 1.8 includes all the new used ssh encryption algorithms libraries.

To update the JRE follow these steps:

  1. If Digi ESP for Python is running, close it.
  2. Navigate to the Digi ESP for Python installation folder, usually: C:\Program Files (x86)\Digi\python\DevTools-2.3\DigiESP
  3. Rename the existing jre directory to jre-old.
  4. Extract the jre folder from the zip file into this location.
  5. You should now have two jre directories inside the DigiESP folder: jre and jre-old
  6. Update the Digi ESP for Python jcraft jsch plugin from version 0.1.41 to version 0.1.53. This plug-in links the ssh sessions with the available JRE encryption algorithms. The new version of this plug-in recognizes all the available JRE 1.8 encryption algorithms. 

To update the jcraft jsch plug-in follow these steps:

  1. If Digi ESP for Python is running, close it.
  2. Navigate to the Digi ESP for Python plugins folder, usually: C:\Program Files (x86)\Digi\python\DevTools-2.3\DigiESP\plugins
  3. Extract the com.jcraft.jsch_0.1.53.v201508180515.jar file from the zip file into this location.
  4. You should now have two jcraft plug-in files inside the plugins folder: com.jcraft.jsch_0.1.41.v201101211617.jar and com.jcraft.jsch_0.1.53.v201508180515.jar

Create a remote configuration for the XBee Industrial Gateway

Digi ESP for Python v2.3.0 does not provide native device discovery and configuration support for the XBee Industrial Gateway, but you can create a manual remote configuration to work with it as a normal XBee Gateway. To do so follow these steps:

  1. Start Digi ESP for Python as administrator.
  2. Navigate to Device Options > Device Manager menu. The Device Manager dialog opens.
  3. Click on New Remote Configuration button of the remote configuration list toolbar at the left.
  4. In the right panel, give a name to the remote configuration, for example XBee Industrial Gateway
  5. Select the General tab and apply the following configuration:
    1. Select the connected device type from the list: XBee Gateway
    2. Connection mode: Connect to device using Local Area Network / USB / Serial
    3. Check Validate connection on apply option.
  6. Select the LAN Connection tab and apply the following configuration:
    1. IP Address: The IP address of your XBee Industrial Gateway
    2. Authentication:
      1. Check Use login information if required option.
      2. Login: python
      3. Password: dbps (that's the default password, change it if you have updated the device's default passowrd)
    3. Leave the rest of settings with their default values.
  7. Click Apply. The connection with the device is validated.
  8. Click Set Current. From now on, all the projects will be transferred and executed using this device remote configuration by default.

The remote configuration for the XBee Industrial Gateway only needs to be created once. All the python projects will be able to use the same remote configuration to be transferred and executed in the device.
It is important to launch Digi ESP for Python as administrator. Otherwise DIA projects will fail to build with the following message:

Error executing script: IOError: [Errno 13] Permission denied: 'zip_build_date.py' 
Last updated: Jan 01, 2024

Filed Under


Recently Viewed

No recently viewed articles

Did you find this article helpful?