Aquila SolutionsInc. GCT LTE Module Software Development Guide OEM/Integrators Installation Manual V2.2 December 27, 2018 AQUILA is a trademark of Aquila Solutions, registered in the United States and other countries. Other product and brand names may be trademarks or registered trademarks of their respective owners. This technical data may be subject to U.S. and international export, re-export, or transfer (“export”) laws. Diverscioonntrary to U.S. and international law is strictly prohibited.
GCT LTE Module Software Development Guide INDEX 1 Overview .............................................................................................................................................3 1.1 Overview ............................................................................................................................3 1.2 Revision history .................................................................................................................3 2 Software Framework .............
GCT LTE Module Software Development Guide 1 Overview 1.1 Overview This document is aimed to provide customers with GCT-CAT4 LTE module software development guide in using CPE. 1.2 Revision history Revision V1.0 V2.0 V2.1 V2.2 Version V2.2 Date 2017/6/30 2018/11/28 2018/12/18 2018/12/27 Release Note Formal release.
GCT LTE Module Software Development Guide 2 Software Framework 2.1 Schematic software framework Figure 1. VLAN based System Architecture 2.2 Explain The Figure 1 exhibits overall VLAN configuration used to communicate with host processor. The total number of feasible logical channels needed for LTE device operation is 5. Three of them are used to support LTE operation (currently destined to be used in Verizon LTE network) and two of them for the control：mage update channel and AT command processing.
GCT LTE Module Software Development Guide CDC-ACM drive kernel configuration options, and the VLAN configuration options: (different host platforms may vary) CONFIG_USB_ACM= y CONFIG_USB_USBNET= y CONFIG_USB_NET_CDCETHER= y CONFIG_USB_NET_CDC_EEM= y CONFIG_VLAN_8021Q=y 2.
GCT LTE Module Software Development Guide 2. wan port eth2 used for file updates, version upgrades, debugging, etc. 3. Three virtual VLAN ports ( vlan id of GCT module is :100 101 102 103) eth2.100 eth2.101 eth2.102 eth2.103 Version V2.
GCT LTE Module Software Development Guide 3 Host Side VLAN Construction 3.1 VLAN tag of GCT module The vlan tag of GCT module is 100,101,102,103. When the user sets up the VLAN on the Host side, it needs to be dealt with accordingly. 3.2 Introduction of network card After the drive is loaded normally, eth2 network card will be generated. (if want to know which network card is generated please see dmesg log, different platforms and drivers, and the resulting network card name may be different).
GCT LTE Module Software Development Guide 2.How to network IP, Netmask, GW, DNS and other information; AT+CGCONTRDP=3 （for multyapn ,the id can be 1,2,3,4） Pdn_type: IPv4 Pdn_type: IPv4/IPv6 Interpretation parameter of AT+CGCONTRDP=3: 3.
GCT LTE Module Software Development Guide example： vlan_tag=100 ipaddr=10.166.194.196 netmask=255.0.0.0 gateway=10.0.0.59 device=eth2 vdevice=eth2.100 The steps are as follows: 1. ip link set dev eth2.100 down 2. ip link delete eth2.100 3. vconfig add eth2 100 4. ip link set vlan100 name eth2.100 5. ifconfig eth2.100 –arp 6. ifconfig eth2.100 10.166.194.196 netmask 255.0.0.0 up 7. ip link set txqueuelen 100 dev eth2.100 8. route add default gw 10.0.0.59 dev eth2.100 9.
GCT LTE Module Software Development Guide 4 Debugging Information Output 4.1 DM tools In some cases, such as debugging, information output, version view, version upgrade, etc. user need to access the module from an external PC or CPE. One way is provide: The GCT module has a private IP inside: 169.254.0.1 .Users can log in to 169.254.0.1 on the web page. Access method: 1. CPE side network card needs to configure the same segment address(169.254.0.
GCT LTE Module Software Development Guide then enter “dmesg” ,you will get the module boot up log : 2nd. Also you can enter lted_cli for changing script environment to DM> environment then enter “arm1log 2”, then you can see DM> 3rd. you enter “ dbg L3* -1” Version V2.
GCT LTE Module Software Development Guide and then“q 2”(if needto shut down the print logs, need enter: q 0 ) Version V2.
GCT LTE Module Software Development Guide 5 Common AT Command Description Please refer to AT command manual for detailed AT commands.
GCT LTE Module Software Development Guide 5.1 Check attach status （1）AT+CFUN? +CFUN:1 （2） AT+CGATT? +CGATT:1 OK （3） AT+CEREG? +CEREG: 2,5,"0001","00000007",7 OK （4）AT+CGACT? +CGACT：1,3 5.2 Special status check If the gct module can not auto attach，please check status： AT+CGATT? (Attach manually. When the network is available, the module can be attached manually.) AT+CGPADDR (Look up obtained IP address.) 5.
GCT LTE Module Software Development Guide 6 Possible Problem Description 1. Baud Rate: 921600 2. Reboot should be done after configing module parameters. 3. pdn3 is for GCT module main apn, so pdn3 should be actived first 4.
GCT LTE Module Software Development Guide 7 AT Commands Description PROPRIETARY AT COMMANDS 7.1 System at commands 7.1.1 AT%GIMEISV Descriptions: Set command changes the value of IMEI or SVN. Read command returns the current IMEISV. Parameter definition: - String, - “IMEI” : Set IMEI , this case is same at%gimei=”value”.
GCT LTE Module Software Development Guide 7.1.2 AT%GPDNTYPE Descriptions: Set command registers PDN type of each CID Read command returns the current set PDN type Parameter definition: integer, 1 ~ 8 : context ID.
GCT LTE Module Software Development Guide 7.1.3 AT%GFREQRNG Descriptions: Set command sets frequency range for band respectively.. Read command returns the current setting value. Parameter definition: Band number < ST_EARFCN> Start EARFCN of Downlink < ED_EARFCN> End EARFCN of Downlink 7.1.4 AT%GLOCKCELL Descriptions: Set command set cell lists that is locked Parameter definition: Integer, Number of Cell list. Max value is 30. It means Cell list locked can be registered up to 30 lists.
GCT LTE Module Software Development Guide 7.1.5 AT%GLOCKSCELL Descriptions: Set command set secondary cell lists that is locked Parameter definition: Integer, Number of Cell list. Max value is 8. Integer, E-UTRA absolute radio frequency channel number of the serving cell. Range: 0 to 65535. Integer, Physical cell ID to which the UE is locked. Range: 0 to 503.
GCT LTE Module Software Development Guide 7.1.7 AT%GRRCRINFO Descriptions : Execution command returns the RRC information Parameter definition: Integer, Number of RRC Connection requests. Integer, Number of RRC Connection reestablishment requests. Integer, Number of Radio Link Failures. 7.1.8 AT%CRASHTEST Descriptions : TriggerLinux or module crash by password. Parameter definition: string, Though specified algorithm to calculate by serial number.
GCT LTE Module Software Development Guide ERROR at%crashtest=7Xi8Ec6Af9Nd,0 atcm: atc_compare_sn_password SN:[6772017120700039] atcm: atc_compare_sn_password It's matched atcm: [atc_gdm_process_crashtest] linux will be crash right now 7.1.9 AT%SAVECRASHLOG Descriptions : Save modem or linux crash log.After running this AT cmd ,the crash log will saved at “/tmp/crash.log” Note: This command is can only execute once, after system restart. Example: at%savecrashlog OK How to get crash log from user? 1.
GCT LTE Module Software Development Guide OK How to get module config document from user? 1.Running this AT cmd ” AT%SAVEUCFG”; 2.Execute script command at host side, such as ” tftp -g -r ucfg_config.xml 169.254.0.1”, then it will save document in /tmp/ucfg_config.xml at HOST side. 3.Use APP supported SCP protocol to get module config document from HOST side. 7.2 Dual sim at commands 7.2.
GCT LTE Module Software Development Guide 7.3.2 AT%SYSCMD="zm_gps get location_time" Descriptions : Get command get locationand time Example: AT%SYSCMD="zm_gps get location_time" uart port[1] fc=0 cr=0000002b %SYSCMD: time=34004.000000 latitude=31.167280 longitude=121.400146 altitude=-7.000000 OK Version V2.
GCT LTE Module Software Development Guide OEM/Integrators Installation Manual Important Notice to OEM integrators 1. This module is limited to OEM installation ONLY. 2. This module is limited to installation in mobile or fixed applications, according to Part 2.1091(b). 3. The separate approval is required for all other operating configurations, including portable configurations with respect to Part 2.1093 and different antenna configurations 4. For FCC Part 15.
GCT LTE Module Software Development Guide Federal Communication Commission Interference Statement This device complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions: (1) This device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesired operation. This equipment has been tested and found to comply with the limits for a Class B digital device, pursuant to Part 15 of the FCC Rules.
GCT LTE Module Software Development Guide Industry Canada Statement This device complies with Industry Canada’s licence-exempt RSSs. Operation is subject to the following two conditions: (1) This device may not cause interference; and (2) This device must accept any interference, including interference that may cause undesired operation of the device. Le présent appareil est conforme aux CNR d'Industrie Canada applicables aux appareils radio exempts de licence.
GCT LTE Module Software Development Guide End Product Labeling This transmitter module is authorized only for use in device where the antenna may be installed such that 20 cm may be maintained between the antenna and users. The final end product must be labeled in a visible area with the following: “Contains IC: 24872-MG401”.
