Advertisement

Quick Links

OptConnect ema™
Windows Networking Guide
Application Note: 002
V1.2 Updated May 2020

Advertisement

Table of Contents
loading

Summary of Contents for OptConnect ema

  • Page 1 OptConnect ema™ Windows Networking Guide Application Note: 002 V1.2 Updated May 2020...
  • Page 2: Table Of Contents

    2.3.5 Closing and Re-opening the Connection Troubleshooting CDC_NCM Data Connections Telit Connection Manager 2.5.1 Overview 2.5.2 Installation Instructions 2.5.3 Configuration 2.5.4 Troubleshooting Windows 8/10 Environments Overview MBIM Mode 3.2.1 Overview 3.2.1 Relevant ema Ports © OptConnect Management, LLC 2020. All rights reserved. Revision 1.2...
  • Page 3 3.3.1 Overview 3.3.2 Verify ema Enumeration 3.3.3 Window Cellular Settings 3.3.4 Verify the Internet Connection Troubleshooting 3.4.1 Verify the Internet Connection 3.4.2 Windows Fails to Open the Connection Revision History © OptConnect Management, LLC 2020. All rights reserved. Revision 1.2...
  • Page 4: Introduction

    Windows 7, 8, and 10 operating systems. For demonstration purposes, OptConnect’s ema:Play Evaluation Kit will be used as ema’s host system throughout this document. Also, the ema:Play USB port (J6) that is directly beneath ema (when plugged into the modem socket on ema:Play) will be used for both the data connection and AT command parser serial connection.
  • Page 5: Additional Resources

    The second option involves using Telit's Connection Manager tool. Section 2.2 covers the procedure for setting up ema to use CDC_NCM protocol, as well as the steps to configure the relevant Windows settings. Section 2.3 explains how to install, configure, and use Telit's Connection Manager Tool.
  • Page 6: Cdc_Ncm Mode

    First, the user should familiarize themselves with the available ports that ema presents to Windows 7. When ema is powered on with the USB cable connected at ema:Play (J6), several USB ports will enumerate. To see the available ports, open the Windows Device Manager, and open the "Ports" tab. ema...
  • Page 7: Ema Configuration

    2.2.3 ema Configuration 1. Open a Terminal Window: ema must be configured to use CDC_NCM protocol. As mentioned in Section 2.2.2, The USB0 port should be used as the AT interface for the CDC_NCM setup.
  • Page 8: Windows Configuration

    #USBCFG: 0 If ema does not respond with the above result code, reissue the first AT command, or consult Telit's AT command manual. 3. Enable GPRS Network Attaching: In order to establish a data connection, ema must attach to the General Packet Radio Services (GPRS) network. Issue the following AT command: AT+CGATT=1 4.
  • Page 9 Figure 3 Double click on “Local Area Connection x/Telit Mobile (NCM1)” to open the Properties dialogue as shown in Figure 4. Figure 4 © OptConnect Management, LLC 2020. All rights reserved. Revision 1.2...
  • Page 10 The settings listed in the window will need to be updated with ema’s connection data. 2. Get ema Connection Data: The fields in Figure 5 must be updated with ema specific parameters. To get this data, issue the following AT command: AT+CGCONTRDP=<cid>...
  • Page 11 Figure 8. Double click on “Local Area Connection #”. It should now take you to the Status Dialogue. Click on “Details”. Locate the “Physical Address” line and record this value. Reference Figure 9. © OptConnect Management, LLC 2020. All rights reserved. Revision 1.2...
  • Page 12 Figure 8 Figure 9 © OptConnect Management, LLC 2020. All rights reserved. Revision 1.2...
  • Page 13: Windows Command Prompt Settings

    IP address, allowing the device at the MAC address to communicate directly with the IP address. In the case of ema and the CDC_NCM setup procedure, it is a good practice to clear this cache to avoid any potential errors or MAC address conflicts.
  • Page 14: Verify The Internet Connection

    As shown in Figure 10, the ARP cache has an entry of ema’s physical address and its gateway address. At this point, the internet connection should be established. 2.3.4 Verify the Internet Connection After the Windows settings have been properly configured, the host platform should be connected to the Internet via cellular using ema.
  • Page 15: Troubleshooting Cdc_Ncm Data Connections

    Troubleshooting CDC_NCM Data Connections If a CDC_NCM connection has been set up on ema, and the Windows is connected to the proper "Local Area Connection x" network, but the host platform cannot load webpages or ping online resources, follow the steps below.
  • Page 16: Configuration

    Figure 12 Note: The installer may also try to install the latest Windows drivers for ema. However, it is not recommended to allow the installer to update the drivers on the host platform. After the installation is finished, close the installer, and open Telit Connection Manager (TCM).
  • Page 17 This window contains the settings for the APN that will be used for the data connection. Generally, the APN is populated automatically by the program, and will be configured by default. However, if this is not the case, edit the relevant fields to reflect the proper APN for ema. Be sure to save the configuration when finished.
  • Page 18: Troubleshooting

    The TCM can occasionally say that it has disconnected after the "Connect" button has been pressed. In this case, shut down ema and close out of TCM. Then, restart the program, followed by ema. The "Connect" button should now function as intended, and will not automatically disconnect. The TCM can also show that the connection is valid, but Windows is reporting no internet connection.
  • Page 19: Windows 8/10 Environments

    First, the user should familiarize themselves with the available ports that ema presents to Windows 8 and 10. When ema is powered on with the USB cable connected at ema:Play (J6), several USB ports will enumerate. To see the available ports, open the Windows Device Manager, and open the "Ports" tab. ema...
  • Page 20: Ema Configuration

    #USBCFG: 3 If ema does not respond with the above result code, reissue the first AT command, or consult Telit's AT command manual. 3. Assign PDP Context to the MBIM stack: The proper PDP context must be assigned to the MBIM stack.
  • Page 21: Windows Configuration

    General Packet Radio Services (GPRS) network. Issue the following AT command: AT+CGATT=1 5. Disable the PDP Context: In order for MBIM mode to work properly on ema, the PDP context must not be activated on the 4G LTE network. To ensure ema does not have an active connection to the network, issue the following AT command: AT+SGACT=<cid>, 0...
  • Page 22: Window Cellular Settings

    Figure 17 If the "CDC NCM/MBIM" entry is listed under the "Network Adapters" tab, then ema has properly enumerated. 3.3.3 Window Cellular Settings 1. Open the “Windows Cellular Settings” window: Open the start menu and search for “Cellular Settings." The Cellular Settings Window should look similar to Figure 18.
  • Page 23 2. Set an APN for the Connection: Click on the “Advanced Options” link as shown in Figure 18 to open the options for the current cellular connection. The window that opens should look similar to Figure 19. © OptConnect Management, LLC 2020. All rights reserved. Revision 1.2...
  • Page 24 Figure 19 Click on the option labeled "Add an APN", as shown in Figure 19. In the window that opens, populate the following fields according to Figure 20. © OptConnect Management, LLC 2020. All rights reserved. Revision 1.2...
  • Page 25 Figure 20 Rename the profile to any arbitrary name, and replace the text <enter ema APN here> with the APN for the SIM card in use. Additionally, be sure to select the IP type that matches the cellular data plan in use.
  • Page 26 Cellular Settings window. Click the "Connect" button to open the data connection. If the connection succeeds, the connection status will change to show "Connected" and the window should look similar to Figure 21. © OptConnect Management, LLC 2020. All rights reserved. Revision 1.2...
  • Page 27: Verify The Internet Connection

    Figure 21 If Windows fails to connect, or issues a message asking the user to set an APN for ema, navigate to section 3.4 for troubleshooting information. 3.3.4 Verify the Internet Connection Before attempting to test the Internet connection, ensure that all other Internet sources are disconnected or deactivated.
  • Page 28: Troubleshooting

    When attempting to start the data connection by clicking the "Connect" button in the Cellular Settings Window, a message requesting the user to add an APN may be displayed, as shown in Figure 23. Figure 23 © OptConnect Management, LLC 2020. All rights reserved. Revision 1.2...
  • Page 29: Windows Fails To Open The Connection

    Fortunately, there is a simple fix for this error. Simply issue the following AT command: AT#REBOOT This AT command will cause ema to reset itself, which in turn causes the MBIM interface to re-enumerate on the Windows host platform. This re-enumeration will fix the error, and Windows should now be able to connect to the internet.
  • Page 30: Revision History

    4. Revision History Revision Date Description Author 6/4/2019 Initial Release 1/15/2020 ema Management UART is now referred to as emaLink 5/18/2020 Updated ema p/n’s © OptConnect Management, LLC 2020. All rights reserved. Revision 1.2...

Table of Contents