USER MANUAL CS-GSM/GPRS Digital Transceiver Kits (including the COM110A modem) Issued: 17.6.
Guarantee This equipment is guaranteed against defects in materials and workmanship. This guarantee applies for twelve months from date of delivery. We will repair or replace products which prove to be defective during the guarantee period provided they are returned to us prepaid.
PLEASE READ FIRST About this manual Some useful conversion factors: Area: 1 in2 (square inch) = 645 mm2 Length: 1 in. (inch) = 25.4 mm 1 ft (foot) = 304.8 mm 1 yard = 0.914 m 1 mile = 1.609 km Mass: 1 oz. (ounce) = 28.35 g 1 lb (pound weight) = 0.454 kg Pressure: 1 psi (lb/in2) = 68.95 mb Volume: 1 UK pint = 568.3 ml 1 UK gallon = 4.546 litres 1 US gallon = 3.
Contents PDF viewers note: These page numbers refer to the printed version of this document. Use the Adobe Acrobat® bookmarks tab for links to specific sections. 1. Introduction................................................................. 1 2. Quick Start Guide – for GSM dial-up use .................. 2 3. Quick Start Guide – for GPRS communications ...... 3 4. Using GSM Networks for Dial-up Data Transfer ....... 6 4.1 Network Coverage ...................................................................
9. Using Loggernet for GPRS communications ......... 24 9.1 Setting up to call a logger with a fixed IP address .................................. 24 9.2 Setting up call-back in Loggernet ........................................................... 25 9.2.1 Setting up call-back in Loggernet Version 3 ................................. 25 9.2.2 Setting up call-back in Loggernet Version 4 ................................. 26 9.2.3 Keeping the connection open when calling-back .......................... 28 9.2.
E. Resetting the COM110A Module under Program Control............................................................... E-1 E.1 Principle of Control .............................................................................. E-1 E.2 CRBasic Program Example .................................................................. E-1 E.3 CR10X Program Example .................................................................... E-2 F. Configuring the COM110A via the datalogger ....... F-1 Table 1.
CS-GSM/GPRS digital transceiver kits This manual provides the details of how to use the CS-GSM/GPRS digital transceiver kits with Campbell Scientific dataloggers. This version of the manual covers kits that use the Campbell Scientific COM110A modem as the communication device. Details in this manual are specific to this model introduced in October 2012. If you have an older model i.e. not the COM110A modem version please request an older version of this manual from Campbell Scientific.
CS-GSM/GPRS Digital Transceiver Kits (including the COM110A modem) protocol is supported either using the built-in TCP/IP capability of some Campbell Scientific dataloggers or using a software feature built into the modem that allows more basic loggers to communicate using a GPRS connection, albeit with less functionality. An easy to use configuration tool called the Mobile Data Assistant is available for download free of charge from http://www.campbellsci.co.
Using with Campbell Scientific Dataloggers 4. Connect the power supply to the COM110A modem, by connecting the red/black power lead either directly to the outlet of the power supply, if powering the device continuously or to a suitable power switch – see Section 6.3 below. It is best to connect the power as close as possible to the battery rather than to terminals on the datalogger if possible. 5. Turn on the power to the datalogger and COM110A modem.
CS-GSM/GPRS Digital Transceiver Kits (including the COM110A modem) 4. Connect the modem to the PC using the programming cable (use a serial to USB convertor if necessary). Connect the modem to a nominal 12V DC supply (the datalogger supply if available). 5. Then select the setup option and select the datalogger and, when shown, on the next screen the baud rate (select 115200 baud, unless using an SC-WMI when 9600 baud is used). You will then be prompted for the method of IP connection.
Using with Campbell Scientific Dataloggers for a direct connection to the serial port, CS I/O ME for the SC-WMI or one of the SDC options to match the configuration of an SC105 if used. For all loggers you then need to fill in the APN name provided by your SIM card provider, a user ID and password associated with the APN (these are sometimes blank) and the port the logger will listen on for its normal communications traffic. If shown leave the idle time and reset time at the defaults of 10 and 60 for now.
CS-GSM/GPRS Digital Transceiver Kits (including the COM110A modem) 9. Turn on the power to the datalogger and COM110A modem. The status LED on the end of the package, near the SIM socket should come on continuously initially. After a period of about 15 seconds the LED will start to flash briefly every 2-3 seconds. When the LED starts to flash it indicates that the modem has signed onto the phone network successfully.
Using with Campbell Scientific Dataloggers mode (see Appendix D for more information). Your airtime provider will normally supply you with an extra phone number for the SIM specifically for data use. 4.1 Network Coverage One of the main advantages of using a cellphone network is being able to set up a communications link to a datalogger virtually anywhere without installing land or telephone lines. However, this only applies if a suitable GSM network covers your installation site.
CS-GSM/GPRS Digital Transceiver Kits (including the COM110A modem) If you cannot use a base station GSM modem, lower cost calls may also be possible by programming the datalogger to call back to the land-line phone base station, as the special airtime rates will normally apply to such calls too. Where many calls have to be made in quick succession ISDN digital landlines can be used with a digital terminal adaptor in the calling PC.
Using with Campbell Scientific Dataloggers NOTE Can synchronise the datalogger clock to Internet time (networktimeprotocol). Can send data to other loggers via IP (Send/Get variables, files and data) Can do a normal callback to a Loggernet server (send variables) Can do a one way transmission to Loggernet or another logger (Senddata) Can open virtual serial ports to other dataloggers or sensors via the IP network.
CS-GSM/GPRS Digital Transceiver Kits (including the COM110A modem) searching for “Fixed IP SIM” on the internet making sure the offering is not a 3G only card. Currently Campbell Scientific Ltd only offers SIM cards as part of a subscription to its Konect data service.. It is important to ensure you are aware of the likely costs of GPRS data transfer. Prices can range from £0.005 to £10.00 per Megabyte of data transferred.
Using with Campbell Scientific Dataloggers dynamic name service in this instance (please contact Campbell Scientific for more details). More commonly if you have a dynamic IP SIM you will not be able to call out to the logger as it is on a private network behind a router/firewall. Instead you have to get the datalogger or modem to open a connection back to the Loggernet PC which itself must have a public IP address (see firewall issues below) and have Loggernet hold the connection open.
CS-GSM/GPRS Digital Transceiver Kits (including the COM110A modem) significantly – the transmitter using an extra 100-400 mA depending on the installation and speed of communication. To achieve lower power states either a power switch can be used in the power line, (see the installation section below), or if using a datalogger that is running its own TCP/IP stack, you can close the PPP connection (using PPPClose in your program), which will put the modem in a lower power state.
Using with Campbell Scientific Dataloggers 5.6 Sending configuration commands to the modem It is often advisable to reset the modem at regular intervals or send other configuration commands to the modem, for instance to enable very low power states between calls. When using the loggers IP Stack, this can be done within the datalogger program by opening the serial port to which the modem is connected and sending out commands using the serialout command.
CS-GSM/GPRS Digital Transceiver Kits (including the COM110A modem) NOTE The SC-WMI is not recommended for use where other devices are sharing the CS I/O port. 6.2.1 Connection to a CS I/O Port The Campbell Scientific SC-WMI interface provides a simple, very low power interface for connecting the COM110A modem to the CS I/O port on Campbell Scientific dataloggers.
Using with Campbell Scientific Dataloggers The cable required for the direct connection to a datalogger serial port is supplied as part of the CS-GSM/GPRS 232 kit. The 9-pin connector plugs in the datalogger RS232 port and the 15-way connector directly into the COM110A modem. NOTE The cable supplied for use with the COM110A modem is different from that supplied with older modems. The cable has additional control wires that are not used in standard Campbell installations.
CS-GSM/GPRS Digital Transceiver Kits (including the COM110A modem) 6.4 Selecting and Connecting an Antenna When selecting an antenna, please note the following points: Make sure the antenna used covers the frequency you intend to use the COM110A modem on, i.e. does the antenna cover 900 or 1800 MHz, or both (dual band). Low cost, ¼- or ½-wave antennae are adequate for most applications where signal coverage is good.
Using with Campbell Scientific Dataloggers 6.4.1 Antenna Supplied by Campbell Scientific Campbell Scientific can supply various antennas, if required; including a ‘lowcost’ antenna (see Figure 2, below). This is supplied as part of the standard CSGSM/GPRS package. In areas of high signal strength, the low-cost antenna will be suitable for almost all applications, either at 900 or 1800 MHz.
CS-GSM/GPRS Digital Transceiver Kits (including the COM110A modem) Higher gain YAGI style antennas are available from Campbell Scientific to special order. These can help with reception in remote areas or where reception is poor due to obstacles, but can take some experimentation to find the best orientation to get the optimum reception. 7.
Using with Campbell Scientific Dataloggers NOTE This program is provided free of charge but is only licensed for use with COM110A modems purchased from Campbell Scientific or an authorised reseller. After installation the start up screen looks like this: Operation of the package is fairly intuitive so this manual is limited to a description of the general steps of operation and an explanation of the terminology used.
CS-GSM/GPRS Digital Transceiver Kits (including the COM110A modem) Setup – Settings - Datalogger port: allows you to select the serial port on the datalogger to which the modem will be connected. Setup – IP Control: allows you to select whether you will be using the logger’s own IP stack or the one built into the modem. Setup – IP Control – Logger IP Stack: sets the logger to run its own IP Stack (only shown for loggers that support this).
Using with Campbell Scientific Dataloggers less frequent than the default time of 60 mins then increase this time – at the possible cost of the extra time it will take to recover a bad connection. Setup Settings (for IP connection, Modem IP Stack) –Max Time Online: limits the maximum time the call-back socket is opened for. This is useful for resetting `broken’ connections that can be held open forever otherwise.
CS-GSM/GPRS Digital Transceiver Kits (including the COM110A modem) When this window is opened on the home screen an additional entry window appears below the activity window that lets you send commands directly to the modem. This can be used to send diagnostic commands to the modem and also to send non-standard configuration commands. Prior to using this make sure the COM port and baud rate are selected correctly to match the connection and setup of the modem. 7.
Using with Campbell Scientific Dataloggers 8.1 Configuring a Desk-Top Modem as a Base Station You can use most desktop landline and even cellphone modems to connect to a remote COM110A modem. The modem should be setup as if calling a remote landline modem. The baud rate for connection should be set to 9600 minimum. The modem can be configured to connect either via the TAPI or Phone modem settings (TAPI being the preferred option if you have installed the modem into your Windows environment.
CS-GSM/GPRS Digital Transceiver Kits (including the COM110A modem) To add this setting, use the Phone modem option in Loggernet where you can edit the modem initialisation string in the setup screen. You cannot amend this setting for a TAPI interface in a way that Loggernet can also detect. Campbell Scientific communications software includes other time-outs which are used to check for hung communications links.
Using with Campbell Scientific Dataloggers Where the number of outgoing IP ports is limited, perhaps due to a firewall restriction, Pakbus loggers with discreet Pakbus addresses can be connected via a PakbusTCPServer, as shown below (Loggernet 4 onwards). The IP address of the remote logger is entered in the Routing screen as an Outgoing connection. .
CS-GSM/GPRS Digital Transceiver Kits (including the COM110A modem) 9.2 Setting up call-back in Loggernet Where the logger is programmed to call-back to a Loggernet server, perhaps because it has a dynamic IP address, Loggernet needs to configured to expect a call-back on a the chosen port. The same settings apply whether using the loggers own TCP/IP stack or the modem stack. 9.2.1 Setting up call-back in Loggernet Version 3 Version 3.
Using with Campbell Scientific Dataloggers 9.2.2 Setting up call-back in Loggernet Version 4 In Loggernet 4 there is a new root device called a PakbusTCPServer that has a single call-back port. Multiple dataloggers are attached to this port and are identified, when they call-back, by their Pakbus address rather than the port they call-back on. This simplifies the configuration of the dataloggers and only requires one port to be configured in firewalls/routers.
CS-GSM/GPRS Digital Transceiver Kits (including the COM110A modem) You then need to attach a datalogger entry to the PakbusTCPServer for each datalogger in your GPRS network, making sure each logger has a unique Pakbus address which matches the logger Pakbus address set in the logger using the Device Configuration program. Other settings, such as data collection parameters, clock correction are set as normal in the datalogger tabs. 9.2.
Using with Campbell Scientific Dataloggers minutes or set up another process, e.g. low frequency pinging, to prevent the datalogger resetting the connection. It should be noted that when you download a program to the datalogger via a TCP/IP connection, and the logger is using its own TCP/IP stack, it will reset the connection as part of the process of compiling the program. This will cause it to drop the PPP connection for some tens of seconds.
CS-GSM/GPRS Digital Transceiver Kits (including the COM110A modem) network. Generally, this will provide a reliable connection long term. However, there is a very small chance that the COM110A modem could crash as a result of electrical spikes on the power supply or local electrical storms. If the COM110A modem is powered continuously, such a crash will often prevent it answering an incoming call again until it has been reset.
Using with Campbell Scientific Dataloggers If the COM110A modem has definitely been registered on the GSM network, check that the registration is for ‘non-transparent use’. Also check it is enabled for GSM Data (CSD) at 9600 baud – not just GPRS data. For GSM data connections you need to be able to connect from analogue landlines – the SIM provider will normally give you a second phone number to dial it on.
CS-GSM/GPRS Digital Transceiver Kits (including the COM110A modem) If you manually dial the number with a phone and hear a buzzing noise rather than modem negotiation tones (beep and whistles) the SIM is configured to accept incoming digital (UDI) calls only - contact the SIM supplier. 11.3 GPRS Fault finding – when using the logger TCP/IP stack 11.3.
Using with Campbell Scientific Dataloggers Check the modem was configured correctly. Check you have set the correct APN, username and password. Double check with your airtime provider that the SIM is GPRS enabled. Check the datalogger operating system is up to date. If the datalogger has firmware version 22 onwards additional information is provided in the IPInfo field of the status table that can be used to track progress of PPP connection.
CS-GSM/GPRS Digital Transceiver Kits (including the COM110A modem) Messages that can appear include: Message Cause/Fault ppp initialized PPP was enabled and initialised OK ppp program opening PPPOpen in the program ppp program closing PPPClose in the program ppp closing Now trying to hang up the connection ppp closed failed Could not hang up the modem.
Using with Campbell Scientific Dataloggers Make sure any local firewalls allow you to make outgoing connections on the ports being used. (Some institutions limit you to standard ports) . Make sure the service provider lets you use non-standard ports over GPRS (a very few apply default firewalls – although normally only for calls to the logger). Double check the Net Services settings for the Logger using Device Configuration program.
CS-GSM/GPRS Digital Transceiver Kits (including the COM110A modem) the logger settings first) Click on connect. This opens a dumb terminal emulator. You should see trace data coming through on the screen if the logger is powered and is trying to make a connection. Click on Start export and enter a filename (end it in .txt). Turn the logger off then on and then leave the logger trying to connect for some minutes or long enough to capture enough data to cover the problematic event.
Appendix A. Using the COM110A with the PIN Security Feature Enabled It is possible to use the COM110A with Campbell Scientific dataloggers with the COM110A’s PIN (Personal Identification Number) feature enabled. However, this has the following disadvantages: If the COM110A loses power momentarily, it will not answer further calls until the datalogger sends the PIN again as part of the normal program sequence.
CS-GSM/GPRS Digital Transceiver Kits (including the COM110A modem) 'Main Program BeginProg 'Normal measurements in the main scan here Scan (1,Sec,0,0) PanelTemp (PTemp,250) Battery (Batt_volt) '......
Appendix A. Using the COM110A with the PIN Security Feature Enabled A3. CR10X Program Example Using Instruction P97 with the generic modem option does not require any special cabling or set-up. It is possible that the generic modem option may not be fully documented in your datalogger manual, but you should be able to find some information in the help system of Edlog for Windows. To gain a full understanding of the general mode of operation of P97 please refer to the examples in the datalogger manual.
CS-GSM/GPRS Digital Transceiver Kits (including the COM110A modem) 2: 1 Disabled when User Flag 1 is High 3: 20 Seconds Call Time Limit ; More than enough time to send command 4: 30 5: 1 Seconds Before Fast Retry ; just in case Fast Retries ;try just once more 6: 9999 Minutes before Slow Retry ; don't try for a long time otherwise 7: 3 8: 0000 Failures Loc [ BadPINcnt ] Call-back ID ; set to 0 indicates not a proper call 6: 1: 2: 3: 4: 5: 6: Extended 68 50 87 50 -69 17 Parameters 4 Digit (P68) Opti
Appendix A.
Appendix B. Controlling the Power Supply to the COM110A Modem This Appendix describes how the datalogger can be used to control the power supply to a COM110A modem to minimise power consumption. B.1 Controlling the Power Consumption of the COM110A modem The power consumption of the COM110A system is much lower than many other cellphones, being typically 5 mA while waiting for calls and <200mA when online.
CS-GSM/GPRS Digital Transceiver Kits (including the COM110A modem) B1.1 CRBasic Program Example of Power Control This example can be used on the CR800 series, CR1000 and CR3000 dataloggers. It uses the standard CRBasic serialopen, serialout and serialclose commands to send out configuration commands to the modem. The example shows using a slow sequence to turn on and then turn off the modem after 5 minutes. When it comes to turn off the modem it sets a flag.
Appendix B.
CS-GSM/GPRS Digital Transceiver Kits (including the COM110A modem) B.1.2 CR10X Program Example ;COM110A power control example code for the CR10X ;Port 1 is the control port used to control the switch ON/OFF ;Flag 1 is used to indicate the COM110A should be turned off ;when any current call has ended.
Appendix B. Controlling the COM110A Power Supply CAUTION If power is limited and the turn-on time has to be kept very short, it is critical to ensure that the PC and the datalogger clocks are not allowed to drift apart, otherwise the PC may try to call when the COM110A is turned off. Clock synchronisation can be achieved automatically, during data collection. Please refer to the PC software manual for details on how to do this.
Appendix C. Useful Configuration Commands for the COM110A This section gives details of some of the useful test commands that can be used during setup of the COM110A. Further details can be found in the COM110A technical manuals available on request from Campbell Scientific Ltd. General details referring to the telecommunications industry can be found at the European Telecommunications Standards Institute (ETSI) web site at www.etsi.org. C.
CS-GSM/GPRS Digital Transceiver Kits (including the COM110A modem) C.2 Network Registration Checks AT+COPS Operator selection Test command AT+COPS=? Response TA returns a list of quadruplets, each representing an operator present in the network. Any of the formats may be unavailable and should then be an empty field. The list of operators will be in the following order: home network, networks referenced in SIM, and other networks.
Appendix C.
CS-GSM/GPRS Digital Transceiver Kits (including the COM110A modem) C.3 PIN Configuration AT+CPIN Enter PIN Test command AT+CPIN=? Response OK Read command AT+CPIN? Response TA returns an alphanumeric string indicating whether some password is required or not.
Appendix C. Useful Configuration Commands To switch between EU/US band(s) for the COM110A, use a communication software such as a HyperTerminal, then enter AT+WMBS=,0 command. The table below gives the commands for various band(s) selection: AT+WMBS Band Selection AT+WMBS=0,0 Select mono band mode 850MHz.
Appendix D. Using the COM110A in Transparent Mode for GSM Dial-up use It is possible to use the COM110A in transparent mode, when the default non-transparent (RLP) mode is not supported by the cellular phone network or is incompatible with the COM110A. D.1 Introduction The COM110A software includes an advanced error correction protocol known as RLP, which is specially designed for RF links.
CS-GSM/GPRS Digital Transceiver Kits (including the COM110A modem) D-2
Appendix E. Resetting the COM110A Module under Program Control This Appendix describes how the datalogger can be used to send commands to the COM110A to reset the module and also enable the lowest power mode which still allows incoming calls. E.1 Principle of Control To reset the COM110A and change its mode of operation it can be sent commands by the datalogger by embedding commands within a datalogger program. The commands are identical to those that could be typed into a terminal emulator.
CS-GSM Digital Transceiver Kits (including the COM110A modem) SlowSequence 'Run once a minute so can have one minute resolution of timing Scan (1,Min,3,0) 'Every 12 hours, in this example and only if we are not communicating If TimeIntoInterval (0,12,hr) AND (NOT status.
Appendix E. Resetting the COM110A Under Program Control ; is loaded to as flag 8 will be low then.
Appendix F. Configuring the COM110A via the datalogger It is possible to reconfigure a GSM modem connected to a logger without the programming cable by talking through the datalogger from one communications interface to another. This works with the CR800 series, CR1000 or CR3000 dataloggers. This process can be generally used when you do not have a modem programming cable but you do have a cable or interface to talk to the datalogger via one interface and the modem is plugged into another.
CS-GSM/GPRS Digital Transceiver Kits (including the COM110A modem) 11. The logger should then report “opening 2” (in the case of ComME), which means you now have a “talk through” path to the modem, i.e. it should respond as if connected directly to the PC. 12. If the modem is being use for GPRS use and particularly if the modem is set to use its own TCP/IP stack it will be necessary to get it back into command mode, by sending “+++” then waiting for a response, normally OK. 13.
CAMPBELL SCIENTIFIC COMPANIES Campbell Scientific, Inc. (CSI) 815 West 1800 North Logan, Utah 84321 UNITED STATES www.campbellsci.com info@campbellsci.com Campbell Scientific Africa Pty. Ltd. (CSAf) PO Box 2450 Somerset West 7129 SOUTH AFRICA www.csafrica.co.za sales@csafrica.co.za Campbell Scientific Australia Pty. Ltd. (CSA) PO Box 8108 Garbutt Post Shop QLD 4814 AUSTRALIA www.campbellsci.com.au info@campbellsci.com.au Campbell Scientific do Brazil Ltda. (CSB) Rua Apinagés, nbr.