SIM7100. Gobi Development Environment In Linux

Transcription

1 SIM7100 Gobi Development Environment In Linux

2 Document Title: SIM7100 Setup Gobi Development Environment In Linux Version: 1.0 Date: Status: Release Document Control ID: SIM7100 Gobi Development Environment In Linux V1.0 General Notes SIMCom offers this information as a service to its customers, to support application and engineering efforts that use the products designed by SIMCom. The information provided is based upon requirements specifically provided to SIMCom by the customers. SIMCom has not undertaken any independent search for additional relevant information, including any information that may be in the customer s possession. Furthermore, system validation of this product designed by SIMCom within a larger electronic system remains the responsibility of the customer or the customer s system integrator. All specifications supplied herein are subject to change. Copyright This document contains proprietary technical information which is the property of SIMCom Limited., copying of this document and giving it to others and the using or communication of the contents thereof, are forbidden without express authority. Offenders are liable to the payment of damages. All rights reserved in the event of grant of a patent or the registration of a utility model or design. All specification supplied herein are subject to change without notice at any time. Copyright Shanghai SIMCom Wireless Solutions Ltd SIM7100 Gobi Development Environment In Linux V /09/04

3 Contents 1 Introduction Build and install driver Build and install driver Connect and check driver works ok Build and install libraries Build and install GobiAPI libraries Setup Your Application Development Environment Connect Network Without GobiAPI Lib Notice... 8 SIM7100 Gobi Development Environment In Linux V /09/04

4 Version History Date Version Description of change Author V1.0 New version Scope This document describes how to setup Gobi development environment in linux step by step, but not teach customers how to use Gobi API to development their applications upon linux. SIM7100 Gobi Development Environment In Linux V /09/04

5 1 Introduction This document provides the guideline on how to setup Gobi development environment in Linux OS. It takes Ubuntu as an example to present the guildline. 2 Build and install driver 2.1 Build and install driver. (1) Extract GobiNet.zip to customer s workspace. unzip GobiNet.zip (2) Build driver cd GobiNet && make Driver is built successfully and customers can go to next step if they find GobiNet.ko in current directory. (3). Install driver sudo modprobe usbnet sudo insmod GobiNet lsmod Once GobiNet and usbnet are available, the driver is installed successfully. 2.2 Connect and check driver. (1) Connect SIM7100 module via physical USB interface and power on the modem. (2) Open the terminal and type the shell command lsusb. SIM7100 Gobi Development Environment In Linux V /09/04

6 (3) SIM7100 is recognized in Ubuntu as USB interface (vid=1e0e,pid=9001) (4) List the devices by ls -l /dev/qcqmi* ifconfig. If /dev/qcqmi1 is visual, the device driver is installed successfully! Besides, a new interface (eth1) is created, customer could check with command 3 Build and install libraries 3.1 Build and install GobiAPI libraries. Application has to invoke methods in these libraries to communicate with the SIM7100, so customer has to build them first. (1) Extract GobiAPI_ (simcom).tar.gz to workspace. SIM7100 Gobi Development Environment In Linux V /09/04

7 tar zxvf GobiAPI_ \(simcom\).tar.gz (2) Build and install libraries. cd GobiAPI_ make sudo make install (3) Check libraries generated. Type ls lib*, you will find: 4 Setup Application Development Environment (1) Copy libraries to the directory the application in: cp libcore.a libgobiconnectionmgmt.so ${APPLICATION-DIR} (2) Copy header files to the directory application in: cp simcom/gobiconnectionmgmtapi.h ${APPLICATION-DIR} cp simcom/gobiconnectionmgmtapienums.h ${APPLICATION-DIR} cp simcom/gobiconnectionmgmtapistructs.h ${APPLICATION-DIR} cp simcom/gobi3000translation.h ${APPLICATION-DIR} (3) Make sure the header files copied in step 2 is from simcom directory instead of GobiConnectionMgmt (4) Write source code, do not forget: #include GobiConnectionMgmtAPI.h #include GobiConnectionMgmtAPIStructs.h #include Gobi3000Translation.h even GobiConnectionMgmtAPIEnums.h is not necessary, but customers still have to copy it to application directory, because it is included in GobiConnectionMgmtAPIStructs.h (5) Customer must have been aware that function GobiConnect should be invoked before communicate with SIM7100, please remember the value of the first parameter pinterface must be the absolute path of the device after installing driver GobiNet, such SIM7100 Gobi Development Environment In Linux V /09/04

8 as /dev/qcqmi1. (6) When building an application, do not forget to contain lcore lgobiconnectionmgmt in makefile. 5 Connect Network Without GobiAPI Lib GobiAPI provides a powerful library to help customer s application to make use of all functions that modem provides, so it is definitely that customers could connect to the network with these API functions. If only data service is used in app, GobiNet driver is enough. The reference code is in archive ndis_manager.zip. 6 Notice (1) If there is an error bits/predefs.h:no such file or directory when building above libraries. (2) sudo apt-get install gcc-multilib (3) If GobiConnect is always failed and returns 10, please check the permission to access /dev/qcqmi* (4) To Check the debug information of libraries Modify line 4 in Makefile in directory GobiAPI_ , add or delete D DEBUG to enable or disable the debug feature. (5) Error code is defined in GobiConnectionMgmtAPIEnums.h file. SIM7100 Gobi Development Environment In Linux V /09/04

9 Contact us: Shanghai SIMCom Wireless Solutions Co.,Ltd. Address: Building A, SIM Technology Building, No. 633, Jinzhong Road, Shanghai, P. R. China Tel: Fax: URL: SIM7100 Gobi Development Environment In Linux V /09/04