Aquila Solutions Inc. GCT LTE Module Software Development Guide OEM/Integrators Installation Manual V2.2 July 19, 2019 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-CAT6 LTE module software development guide in using CPE. 1.2 Revision history Revision V1.0 V2.0 V2.1 V2.2 V2.3 Version V2.2 Date 2017/6/30 2018/11/28 2018/12/18 2018/12/27 2019/07/19 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.2 Dual sim at commands 7.2.1 AT%SIMSLOT Descriptions : Set command set which sim slot to use and setting will be saved in the config file, this command will reboot module.
GCT LTE Module Software Development Guide String gps_glonass_galileo– make module support gps/glonass/galileo position system gps_beidou_galileo– make module support gps/beidou/galileo position system Version V2.
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 residential installation. This equipment generates, uses and can radiate radio frequency energy and, if not installed and used in accordance with the instructions, may cause harmful interference to radio communications. However, there is no guarantee that interference will not occur in a particular installation.
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 Manual Information To the End User The OEM integrator has to be aware not to provide information to the end user regarding how to install or remove this RF module in the user’s manual of the end product which integrates this module. The end user manual shall include all required regulatory information/warning as show in this manual.
