Product Documentation Manual

CRUISER System
Telecommunications Products

CRUISER Telemetry System 2008 All rights Reserved

TABLE OF CONTENTS
1 INTRODUCTION.................................................................................................................4

1.1 Background........................................................................................................4 1.2 Whats new.........................................................................................................4

1.2.1 Firmware upgrade (command 9).............................................................................4 1.2.2 Serial input event handling (command 170/171).....................................................4 1.2.3 Setting of baud rate parameters (command 257)...................................................4 1.2.4 Communications Port (command 263)...................................................................4 1.2.5 Modbus support (command 264)............................................................................5 1.2.6 Mains status reporting (command 265)..................................................................5 1.2.7 Dial-up modem configuration (command 266)........................................................5 1.2.8 Data Flushing delay (command 267)......................................................................5

1.3 System Description............................................................................................5 1.4 Digital vs. Analogue............................................................................................6 1.5 Status LED.........................................................................................................6
2 EVENTS..............................................................................................................................7

2.1 Digital Input events.............................................................................................7 2.2 Timer events.......................................................................................................7 2.3 Counter events...................................................................................................7 2.4 Serial events.......................................................................................................7 2.6 Analogue events.................................................................................................8
3 CRUISER START-UP.........................................................................................................9 4 COMMAND MODE............................................................................................................10

4.1 Entering Commands.........................................................................................10

5 CRUISER DIGITAL IO.......................................................................................................11

5.1 Inputs................................................................................................................11
5.1.1 Option 1................................................................................................................11 5.1.2 Option 2................................................................................................................12

5.2 Outputs.............................................................................................................13
6 CRUISER ANALOGUE INPUTS.......................................................................................14

6.1 Analogue Inputs...............................................................................................14

6.1.1 Option 1 current input............................................................................................14 6.1.2 Option 2 voltage input...........................................................................................15 6.1.2.1 Adding a Truteq Temperature sensor.................................................................15

CRUISER Telemetry System 2008 All rights Reserved

7 APPLICATION EXAMPLES...............................................................................................16 8 ELECTRICAL INTERFACES.............................................................................................16 8.1.1 4 X Digital inputs and 4 X Digital outputs and 0 X Analogue inputs:......................16 8.1.2 0 X Digital inputs and 0 X Digital outputs and 4 X Analogue inputs:......................17 8.1.3 4 X Digital inputs and 4 X Digital outputs and 4 X Analogue inputs:......................17 8.1.4 8 X Digital inputs and 8 X Digital outputs and 0 X Analogue inputs:......................19 8.1.5 0 X Digital inputs and 0 X Digital outputs and 8 X Analogue inputs:......................20 9 HARDWARE OPTIONS.....................................................................................................21

9.1 IO PCB options.................................................................................................21 9.2 Current consumption........................................................................................22

10 DISCLAIMER...................................................................................................................23 11 GLOSSARY.....................................................................................................................23 12 REVISION INFORMATION.............................................................................................23 13 WARNINGS.....................................................................................................................24 14 CONTACTING TRUTEQ WIRELESS..............................................................................24 15 NOTICES & TRADEMARKS...........................................................................................24

CRUISER Telemetry System 2008 All rights Reserved

1 INTRODUCTION
1.1 Background
The CRUISER is part of the Truteq range of telemetry terminals. The CRUISER offers much more than just simple I/O and is under full control of the user - it can be programmed to behave in a particular way when events occur. In addition to the basic telemetry functions, the CRUISER can also be used as a modem.

1.2 Whats new

The CRUISER is constantly being upgraded with more and more features. The following has been implemented on the current release (V110) from the previous release (V103a).

1.2.1

Firmware upgrade (command 9)

The CRUISER now includes an application called FLASH MANAGER (FM). This application resides in the protected boot loader space of the microprocessor. At start-up it verifies the FLASH memory content and from there starts the application. The CRUISER command !9 can set a flag in the eeprom for the FM to enter serial boot mode. The user can now upload new firmware via the serial port using the Truteq YAT PRO software. To use this command enter !9 SERIAL on the command prompt.

1.2.2

Serial input event handling (command 170/171)

The serial input event has an added time-out option. The data field of command 170 indicates the wait time in steps of 100ms. This is the time to wait before the script in command 171 is executed. Enter *** followed by a pause to re-enter command mode.

1.2.3

Setting of baud rate parameters (command 257)

The GSM communications is now fixed to 8,N,1 character framing. The GSM (air link) framing is also not being printed out during start-up. The local port parameters can still be set to any of the following baud rates: 2400, 4800, 9600, 19200, 38400, 57600, 115200 (where 57600&115200 will print a warning of high baud rate possible data loss) The local port framing options are 7,E,1 and 8,N,1 No more air link option in command 257. The CRUISER will also not restart any more after the settings have been changed. Just update the terminal program to the newly set parameters and press <enter>.

1.2.4

Communications Port (command 263)

The link between the CRUISER serial port and the GSM link can now be set to the following options: 1. No link to the GSM (more suitable for telemetry applications) 2. Only link during data connections (more suitable for AMR applications) 3. Always linked to the GSM (more suitable for modem applications)

CRUISER Telemetry System 2008 All rights Reserved

1.2.5

Modbus support (command 264)

The CRUISER now supports TCP modbus protocol (when enabled option 1) The following function codes are supported: 0x01 - Read Coil (get status of relay outputs) 0x02 - Read Discrete Inputs (get status of digital inputs) 0x03 Read Holding registers (add0 = signal, 1~4 = counters) 0x04 Read Input Registers (get values of analog inputs where applicable) 0x05 - Write Single Coil (set digital outputs) Enter *** followed by a pause to re-enter command mode.

1.2.6

Mains status reporting (command 265)

The CRUISER has an extra input in certain hardware profiles to indicate MAINS availability. This command enable the use of that extra input and will display the status with <?6>

1.2.7

Dial-up modem configuration (command 266)

It is inevitable that customers want to use the CRUISER for modem dial-up connections made from PCs running Windows or other operating systems. During this mode the CRUISER bypasses ALL internal functions and only act as a modem. The user can now do dial-up at speeds up to 115200baud. (TIP: this setting can also be used for uploading new firmware to the GSM module)

1.2.8

Data Flushing delay (command 267)

Some devices connected to a CRUISER are very timing critical when it comes to data flow. To avoid TCP packets segmentation and partial buffer flushing one can use command 267 to first wait a given time, before flushing the buffer as a constant output string.

1.3 System Description

The system is built by adding different modules together. In its most basic configuration, the CRUISER will consist of a processing board/PCB, a GSM modem/communication board/PCB, and one input/output board with either four digital inputs and four digital outputs or four analogue inputs and 1 analogue output. More input/output boards can be added (if required) to increase the total number of digital inputs and outputs and/or analogue inputs and outputs, to a maximum of seven input/output boards. The input/output boards can be digital only, analogue only or a mixture (in any ratio) of the two types, just as long as there are no more than seven input/output boards in total. The processing board executes the scripted Commands that are linked to all the triggered events, as well as scripted Commands received via SMS. A triggered event can be, for instance, an input going from high to low or the timer that runs out. Commands can, for instance, send SMS, toggle an output or clear the timer.

CRUISER Telemetry System 2008 All rights Reserved

Events Event A
Script linked to event A

Command Lists <Command> <Command> <Command>

Event B
Script linked to event B

<Command> <Command> <Command>

Event C
Script linked to event C

<Command>;

Script contained in SMS

<Command> <Command>;

SMS messages sent to the CRUISER are executed as a script.

1.4 Digital vs. Analogue

Unless specified otherwise, all inputs and outputs referred to in this manual are Digital inputs and Digital Outputs

1.5 Status LED

The status LED is used to display the current actions of the CRUISER unit according to the following table: Condition Initialising GSM and SIM Idle (signal OK) SMS RX SMS TX Indication Blink Rapidly with 2 sec intervals Short pulses Blink Rapidly while sms being read Blink slow while sms is being send

1 2 3 4

4. After start-up, the CRUISER unit connects to the GSM network and ensures that all the SIM card functions are available. 5. The CRUISER unit is waiting for an Event or incoming Command. 6. The CRUISER unit is busy receiving an SMS. 7. The CRUISER unit is busy transmitting an SMS.

CRUISER Telemetry System 2008 All rights Reserved

2 EVENTS
An event is a change in condition and where certain commands then needs to be executed.

2.1 Digital Input events

Separate Command Lists are linked to the events where an input goes high (on/open) or low (off/closed). The delay times (also known as the debounce times) before the unit registers a change in input state can be configured. More input/output boards can be added to increase the total number of inputs and outputs.

2.2 Timer events

Separate Command Lists are linked to the events where a timer runs out. There are 5 separate timers.

2.3 Counter events

Separate Command Lists are linked to the events where a counter reaches one of its low or high levels. There are 4 different counters, each with its own high and low levels.

2.4 Serial events

The CRUISER can be configured to execute certain commands when data is received on the serial port. Typical applications are tag readers and barcode scanners as well as a whole list of devices that sends out unsolicited serial data.

CRUISER Telemetry System 2008 All rights Reserved

2.5 Analogue events

Separate Command Lists are linked to the events where an analogue value passes a certain level. The following diagram explains which command lists are associated with which level.

Full Scale

Set with cmd 52 High Level Hysteresis High Trip

Cmd list 54 exec when level goes past this point Cmd list 55 exec when level goes past this point

High Recv

Set with cmd 52

Typical Analogue Level

Set with cmd 53 Hysteresis Low Recv

Cmd list 56 exec when level goes past this point Cmd list 57 exec when level goes past this point

Low Level

Low Trip

Set with cmd 53 Zero

CRUISER Telemetry System 2008 All rights Reserved

3 CRUISER START-UP
The CRUISER will print BOOT information on start-up. This information is printed on the serial port at the last baud rate and framing that the CRUISER was set to with command 257. Please see description of command 257. A standard DB9 male to female serial cable (1:1) with any terminal program is sufficient to monitor this data. The first line will always print the hardware configuration with <DigIn>X<DigOut>X<AnIn>. The second line will always print the current firmware version. The CRUISER is ready for operation once the Start-up complete!! sentence is printed. One can now enter commands via command mode (AT$TT) or use it as a standard modem.

CRUISER Telemetry System 2008 All rights Reserved

4 COMMAND MODE
By default the CRUISER serial port acts as a standard modem. However this serial port is also used to enter commands and to configure the CRUISER. The AT command AT$TT is used to enter the standard TruTeq Text mode command prompt. In this mode the CRUISER will echo all incoming text, and add command prompts and readable carriage returns as well as line feeds. The command mode will time-out after a default 30 seconds, or can be quitted by typing <ctrl-z>, this will return the CRUISER into normal modem mode. A simplified command mode is also available for use with serial applications by entering AT$RT (RawText). In this mode there will be no echoing or prompts to simplify the serial encapsulation in a typical application.

4.1 Entering Commands

Commands can be entered once the CRUISER is in command mode.

F F

Default serial parameters are: 9600,8,N,1. A List of all the commands and descriptions are available in the document: TruTalk

CRUISER Telemetry System 2008 All rights Reserved

10

5 CRUISER DIGITAL IO
5.1 Inputs
The CRUISER digital inputs can be configured to work in 1 of 2 ways.

5.1.1

Option 1

The first option (factory default) is the potential free input mode. In this mode a connection must be made between the common (pin1) and the corresponding digital input, either with a switch, or a relay contact.

Note: In this mode the inputs are NOT opto-isolated.

Note: Do NOT apply any voltage on either the common or the individual inputs

CRUISER Telemetry System 2008 All rights Reserved

11

5.1.2

Option 2

In option 2 the inputs are driven with a low voltage to drive the opto-isolator. This mode is ideal for devices with an open collector output configuration. In this mode P1 and P2 must be linked as shown. Apply the devices voltage to Vx, and the open collector outputs to V1->4. An optional resistor Rx is needed if Vx is > 12V typ a 2k2 1/4W will be used for 24V systems.

Note: In this mode the inputs are opto-isolated.

CRUISER Telemetry System 2008 All rights Reserved

12

5.2 Outputs
The CRUISER digital outputs are potential free relay contacts. The relays contacts have the following rating: 250Vac 1A (max 250W ac) 24Vdc 2A (max 50W dc) The relay contact outputs are jumper selectable to be either normally open or normally closed. The following figure illustrates how the outputs can be connected in typical applications.

In the figure above the output 1 will switch the house light remotely on, and output 4 can switch a siren on/off.

N!

Only authorised and licensed persons are allowed to do installations on mains and live systems!!!!

CRUISER Telemetry System 2008 All rights Reserved

13

6 CRUISER ANALOGUE INPUTS

6.1 Analogue Inputs
The CRUISER analogue inputs can be configured to work in 1 of 2 ways. Note the jumper setting for each analogue input, as this determines the input option.

6.1.1

Option 1 current input

The first option (factory default) is the 0-20mA input mode. In this mode a current must be supplied to the analogue input, typically from a sensor with a 4-20mA output.

Note: When a sensor is used that doesnt have an external power input but responds like a current load, then the Vraw output can be used to supply the load.

CRUISER Telemetry System 2008 All rights Reserved

14

6.1.2

Option 2 voltage input

The second option is the 0-5V input mode. In this mode a voltage must be supplied to the analogue input, typically from a sensor with a 0-5V output.

Note: A voltage divider might be needed when a sensor is used with an output > than 5V.

6.1.3

Adding a Truteq Temperature sensor

The Truteq temperature sensor has an output of 0~5V representing 50degC ~ +120degC. Connection diagram to add the temperature sensor to analogue input 1:

CRUISER Telemetry System 2008 All rights Reserved

15

7 APPLICATION EXAMPLES
PLEASE VISIT HTTP://WWW.TRUTEQ.COM/TIPS/TRUTALK/ FOR SOME MORE EXAMPLES

8 ELECTRICAL INTERFACES
The female DB9 connector is standard RS232 and is connected to a computer with a standard serial cable. 8.1.1 4 X Digital inputs and 4 X Digital outputs and 0 X Analogue inputs:
HANDSET 13

GSM ANTENNA GSM STATUS GSM DATA POWER 4X4 STATUS MAINS (230V AC) INPUT SERIAL PORT 9600,8,N,1

I/O Connector: 1 Digital inputs common 2 Digital input 1 3 Digital input 2 4 Digital input 3 5 Digital input 4 6 Digital output 1 N/O 7 Digital output 1 Common 8 Digital output 2 N/O 9 Digital output 2 Common 10 Digital output 3 N/O 11 Digital output 3 Common 12 Digital output 4 N/O 13 Digital output 4 Common To register an input, short the input pin-to-pin 1 on the connector as shown. The outputs are 5A @ 240VAC relays with an internal option between normally open, or normally closed contacts.

CRUISER Telemetry System 2008 All rights Reserved

16

8.1.2

0 X Digital inputs and 0 X Digital outputs and 4 X Analogue inputs:

GSM ANTENNA GSM STATUS GSM DATA POWER 4X4 STATUS MAINS (230V AC) INPUT SERIAL PORT 9600,8,N,1

13

I/O Connector: 1 An1 (Current input) 2 An1 (Voltage input) 3 An1 GND 4 An2 (Current input) 5 An2 (Voltage input) 6 An2 GND 7 +Vdc output (used with current sinks) 8 An3 (Current input) 9 An3 (Voltage input) 10 An3 GND 11 An4 (Current input) 12 An4 (Voltage input) 13 An4 GND 8.1.3

CRUISER Telemetry System 2008 All rights Reserved

HANDSET

17

8.1.4

4 X Digital inputs and 4 X Digital outputs and 4 X Analogue inputs:

GSM ANTENNA GSM STATUS GSM DATA POWER STATUS CON2 SERIAL PORT 9600,8,N,1

MAINS (230V AC) INPUT CON1

13

I/O Connector (Con1): 1 Digital inputs common 2 Digital input 1 3 Digital input 2 4 Digital input 3 5 Digital input 4 6 Digital output 1 N/O 7 Digital output 1 Common 8 Digital output 2 N/O 9 Digital output 2 Common 10 Digital output 3 N/O 11 Digital output 3 Common 12 Digital output 4 N/O 13 Digital output 4 Common I/O Connector (Con2): 1 An1 (Current input) 2 An1 (Voltage input) 3 An1 GND 4 An2 (Current input) 5 An2 (Voltage input) 6 An2 GND 7 +Vdc output (used with current sinks) 8 An3 (Current input) 9 An3 (Voltage input) 10 An3 GND 11 An4 (Current input) 12 An4 (Voltage input) 13 An4 GND

CRUISER Telemetry System 2008 All rights Reserved

HANDSET

18

8.1.5

8 X Digital inputs and 8 X Digital outputs and 0 X Analogue inputs:

GSM ANTENNA GSM STATUS GSM DATA POWER STATUS CON2 SERIAL PORT 9600,8,N,1

MAINS (230V AC) INPUT CON1

13

I/O Connector (Con1): 1 Digital inputs (1->4) common 2 Digital input 1 3 Digital input 2 4 Digital input 3 5 Digital input 4 6 Digital output 1 N/O 7 Digital output 1 Common 8 Digital output 2 N/O 9 Digital output 2 Common 10 Digital output 3 N/O 11 Digital output 3 Common 12 Digital output 4 N/O 13 Digital output 4 Common I/O Connector (Con2): 1 Digital inputs (5->8) common 2 Digital input 5 3 Digital input 6 4 Digital input 7 5 Digital input 8 6 Digital output 5 N/O 7 Digital output 5 Common 8 Digital output 6 N/O 9 Digital output 6 Common 10 Digital output 7 N/O 11 Digital output 7 Common 12 Digital output 8 N/O 13 Digital output 8 Common

CRUISER Telemetry System 2008 All rights Reserved

HANDSET

19

8.1.6

0 X Digital inputs and 0 X Digital outputs and 8 X Analogue inputs:

GSM ANTENNA GSM STATUS GSM DATA POWER STATUS CON2 SERIAL PORT 9600,8,N,1

MAINS (230V AC) INPUT CON1

13

I/O Connector (Con1): 1 An1 (Current input) 2 An1 (Voltage input) 3 An1 GND 4 An2 (Current input) 5 An2 (Voltage input) 6 An2 GND 7 +Vdc output (used with current sinks) 8 An3 (Current input) 9 An3 (Voltage input) 10 An3 GND 11 An4 (Current input) 12 An4 (Voltage input) 13 An4 GND I/O Connector (Con2): 1 An5 (Current input) 2 An5 (Voltage input) 3 An5 GND 4 An6 (Current input) 5 An6 (Voltage input) 6 An6 GND 7 +Vdc output (used with current sinks) 8 An7 (Current input) 9 An7 (Voltage input) 10 An7 GND 11 An8 (Current input) 12 An8 (Voltage input) 13 An8 GND

CRUISER Telemetry System 2008 All rights Reserved

HANDSET

20

The following DC connections apply when no mains input is available:

DC input

+ -

9 9.1

HARDWARE OPTIONS IO PCB options

Standard I/O configurations Option # 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 IO PCBs 0 1 2 1 2 3 2 3 4 3 4 5 4 5 6 5 6 7 Description 0X0X0 0X0X4 0X0X8 4X4X0 4X4X4 4X4X8 8X8X0 8X8X4 8X8X8 12 X 12 X 0 12 X 12 X 4 12 X 12 X 8 16 X 16 X 0 16 X 16 X 4 16 X 16 X 8 20 X 20 X 0 20 X 20 X 4 20 X 20 X 8

CRUISER Telemetry System 2008 All rights Reserved

21

9.2 Current consumption

CRUISER current consumptions (12V DC input): Description Talker + KOI (0 X 0 X 0) 1 X IO PCB 1 X Analogue PCB Average (mA) 70 10 15 Max (mA) 942 110 Notes TX Bursts All relays on (25mA/relay)

examples: 4 X 4 X 4 = 95mA Average (no relays on) and 1062mA max (peak) 20 X 20 X 8 = 150mA Average (no relays on) and 1512mA max (peak)

CRUISER Telemetry System 2008 All rights Reserved

22

10 DISCLAIMER
TruTeq Wireless does not accept any direct or indirect liability for the use of any TruTeq product. The customer takes full responsibility for its use and any liability or damage that may arise from the use of the TruTeq Wireless product. NOTE: This product is not designed or certified for use as medical equipment or with medical equipment or with medical devices. This product is also not designed or certified to be used with any medical services or medical related services.

11 GLOSSARY
Abbreviation
API ASN.1 CDR CSV DB DNS FQDN GAIN HTTP HTTPS IVR I/O IP MMS MMSC PDA SMSC SMPP USSD WIG WAP WML WASP XML

Description
Application programmers Interface Abstract Syntax Notation One Charge Data Record Comma Separated Values Database Domain Name System Fully Qualified Domain Name Gateway Application and Interface Node Hypertext Transfer Protocol HTTP Secure Interactive Voice Response Input/Output Internet Protocol Multimedia Message Service Multimedia Messaging Service Centre Personal Digital Assistant Short Message Service Centre Short Message Peer to Peer Protocol Unstructured Supplementary Services Data Wireless Internet Gateway Wireless Application Protocol Wireless Mark-up Language Wireless Application Service Provider Extensible Markup Language

12 REVISION INFORMATION
Date 29 July 2008 Version 1.0 Comments Port to new format Author Eric Guldemond

CRUISER Telemetry System 2008 All rights Reserved

23

13 WARNINGS
WARNING: Do not open this equipment under any circumstances. High risk of electrical shock exists that may and probably will lead to injuries and/or death.

14 CONTACTING TRUTEQ WIRELESS

Telephone Fax Web email +27 12 6671530 +27 12 6671531 www.truteq.com [email protected]

Snail Mail
PO Box 12220 Centurion, 0046 SOUTH AFRICA

TruTeq Wireless(Pty) LTD

Unit 6, Falcon Crest Office Park 142 Suid Street, Lyttelton, 0157 SOUTH AFRICA

15 NOTICES & TRADEMARKS

Copyright Notice
Copyright 2008 TruTeq Wireless (Pty) LTD. All rights reserved. No part of this document may be reproduced in any form or by any means without prior written authorisation from TruTeq Wireless (Pty) LTD.

Trademarks
TruTeq Wireless and the TruTeq corporate logo are trademarks of TruTeq Wireless. All other trademarks appearing in this guide are the exclusive property of their respective owners.

General Notice
TruTeq Wireless reserves the right to revise this document without obligation to provide notification of such changes. TruTeq Wireless provides this documentation without warranty expressed, implied, statutory, or otherwise, and specifically disclaims any warranty of merchantability or fitness for a particular purpose. TruTeq Wireless may make improvements or changes in the product(s) and/or the program(s) described in this documentation at any time. TruTeq Wireless assumes no responsibility for product reliability and/or performance if any party other than TruTeq modifies the device configuration or if the installation is not performed in accordance with this manual.

CRUISER Telemetry System 2008 All rights Reserved

24