JouBeh 9602W SBD Iridium Transceiver Application …arpaway.com/manuals/Iridium Application Note...

JouBeh 9602W SBD Iridium Transceiver

Application Note

Revision: 1.0.3

Revision Date: 2016/06/17

ATrack Technology Inc.

3F, No. 88, Sec. 1, Neihu Rd.,

Neihu Dist., Taipei City 11493

Taiwan (R.O.C.)

Tel: +886-2-27975852

Fax: +886-2-27974030

http://www.atrack.com.tw

http://www.atrack.com.tw/

Confidential Document

© ATrack Technology Inc. All Rights Reserved. of 18

Contents

1. Notification .............................................................................................................................. 3

1.1. Disclaimer .................................................................................................................................... 3

1.2. Copyright ...................................................................................................................................... 3

1.3. Warning ........................................................................................................................................ 3

1.4. Document Amendments ............................................................................................................... 4

2. Introduction ............................................................................................................................. 5

3. Prepare for Installation .......................................................................................................... 6

4. Hardware Configuration ........................................................................................................ 7

5. Additional Info to Standard Protocol ................................................................................... 8

5.1. AT$SATC Enable/Disable Satellite Communication ................................................................. 8

5.2. AT$REPT Query or set the user defined report ...................................................................... 10

5.3. AT$RACT Query or set the user defined report action settings .............................................. 13

5.4. Note to Command Change ........................................................................................................ 14

6. Sample Script ........................................................................................................................ 15

7. Device Connection ................................................................................................................ 16

8. Host Server Configuration ................................................................................................... 17



11.. NNoottiiffiiccaattiioonn

11..11.. DDiissccllaaiimmeerr

This document, and all other ATrack related products, such as device, firmware, and software, is developed

by ATrack Technology Inc. thoroughly. At the time of release, it is most compatible with specified firmware

version. Due to the functionalities of the devices are being developed and improved from time to time, the

change in the protocol, specification, and firmware functions are subjects to change without notice. ATrack

Technology Inc. is obligated to modify all the documentation without the limitation of time frame. A change

notice shall be released to ATrack Technology Inc. customers upon the completion of document modification.

ATrack Technology Inc. products are not intended to be used as life support or rescue equipments. ATrack

Technology Inc. is not liable for any loss or injury caused by using or referencing to any products. Any possible

means of using or integrating ATrack Technology Inc. products shall be avoided.

11..22.. CCooppyyrriigghhtt

ATrack Technology Inc. holds all parts of intellectual rights applicable in the copyright laws in all the countries.

Any or all parts of this document shall not be exposed to non-authorized party without any form of approval

from ATrack Technology Inc. Any forms, including but not limited to oral, copy, or internet sharing, of releasing

or exposing information to an unauthorized party shall be prohibited. ATrack Technology Inc. reserves the

rights of litigation in the violation of such copyright laws.

11..33.. WWaarrnniinngg

Connecting the wire inputs can be hazardous to both the installer and your vehicle’s electrical system if not

done by an experienced installer. This document assumes you are aware of the inherent dangers of working

in and around a vehicle and have a working understanding of electricity.



11..44.. DDooccuummeenntt AAmmeennddmmeennttss

Note: For the F/W Version column with specific firmware number, it means the modification(s) on the

Comments column is done on this corresponding firmware version (and the versions thereafter). Please make

sure you upgrade the firmware to the specified version before applying any changes made in this protocol.

Revision Date Comments Firmware

1.0.3 Add support for duplex communication (receiving

command)

AT5_5.07BISU2

AT5_6.01BISU2

AU7_5.08BISU2

1.0.2 Apr 13, 2015 Add support for changing format when sending report

over Iridium network

AT5_5.07BS3

AT5V_6.01BS3

AU7_5.07BS3

1.0.1 Aug 08, 2014 Corrected REPT 102 and RACT 2 in the Sample Script

1.0.0 Aug 01, 2014 Initial Release



22.. IInnttrroodduuccttiioonn

This document describes the detailed installation process of how to physically connect a satellite modem

(Model 9602W) to an ATrack tracking device, along with the configurations involved for enabling data transfer

over Iridium satellite networks while GSM/3G data network is unavailable. With a non-terrestrial link backup

function, the ATrack device switches to satellite transmission from a dropped GSM/3G connection

automatically to keep an always online network. In areas of no GSM/3G coverage, the ATrack device instructs

the 9602W to send data across the inter-satellite links. These data then reaches the Iridium Gateway which

provides interconnection to the terrestrial data network and are finally delivered to your host server via a

Direct IP connection. Consult the Iridium service provider for more information on how to apply for the Direct

IP service. Please be advised that duplex communication is supported for this backup function. Please

contact Joubeh for the IP and Port for the communication from your server to Joubeh. As soon as GSM/3G is

restored, the ATrack device switches back to GSM/3G data transmission. This communication switching is not

default. Specific ATrack AT commands have to be applied in order for ATrack device to do the communication

switch. Please refer to the Sample Script section for a test startup.



33.. PPrreeppaarree ffoorr IInnssttaallllaattiioonn

In this installation guide, we will be using JouBeh 9620W and ATrack AT5. Both the 9602W and the AT5 are

connected to a 12 volt DC power supply. Prepare the following items before the installation:

1. 9602W SBD Iridium Transceiver * 1

2. SMA Threaded Iridium Antenna *1

3. Serial Cable (DB 15 Female Connector to DB9 Male Connector) *1



44.. HHaarrddwwaarree CCoonnffiigguurraattiioonn

Use these instructions to set Iridium modem hardware configurations. It is required to communicate with

ATrack device. Please be advised that you may ask JouBeh Technologies to help you set hardware

configurations before sending devices to you when larger deployment quantity involved.

1. Remove screws and nuts from the 9602W SBD Transceiver

2. Adjust the switch to the left position as shown in below lower-left corner and insert the jumper on pins 2

and 3 as shown in the lower-right corner.

3. Follow these sequence diagrams to reassemble your device.



55.. AAddddiittiioonnaall IInnffoo ttoo SSttaannddaarrdd PPrroottooccooll

55..11.. AATT$$SSAATTCC EEnnaabbllee//DDiissaabbllee SSaatteelllliittee CCoommmmuunniiccaattiioonn

Command Description

This command is used to enable or disable the Iridium Satellite Communication as backup communication method while

GSM/3G data network is not available.

Syntax

Write Command AT$SATC=<Enable>,<Debounce>,<Option>,<Prefix>,<Custom Report Format>,<Satellite Queue

Checking Interval>

Response $OK

Read Command AT$SATC=?

Response $SATC=<Enable>,<Debounce>,<Option>,<Prefix>,<Custom Report Format>,<Satellite Queue Checking

Interval>

Parameter Description

Parameters Description Data Type Default

<Enable> Enable or disable Iridium satellite communication U8 0

<Debounce> Time in minutes that device should wait before entering into

satellite communication mode

U8 1

<Option> When communication is switched from Satellite back to GSM/3G,

0: Send satellite queued messages over GSM network (higher

priority than

GSM queued message)

1: Delete satellite queued messages

U8 0

<Prefix> The prefix when sending report over satellite communication. String(2) @P

<Custom Report

Format>

When set, the report sent over satellite communication will be

changed to this format. For what fields are available, please see

table below. Note that the header fields are fixed and cannot be

changed.

String(100) ""

<Satellite Queue

Checking Interval>

The interval in minutes to check the queue in Iridium gateway.

Commands sent to the device over satellite is queued in the Iridium

gateway and requires the Iridium modem to check if there is a

queued message to be received. Note: Once this interval is set, it

will result in additional cost as each queue checking packet is

charged by Iridium service. When there is a report being sent, the

U16 0



queue will also be checked so this interval timer will restart.

0: Disable queue checking

Example

Device wait for 10 minutes of no GSM/3G network, then enter into satellite communication mode:

AT$SATC=1,10

# Enable Iridium satellite communication mode. Switch to satellite communication after 5 minutes when GSM/3G is unavailable.

Transfer all queued messages generated in satellite mode via GSM/3G once the communication is switched back to GSM/3G. Keep

prefix original setting and customize report format to only RTC date time, longitude, latitude, and report ID.

AT$SATC=1,5,1,@P,"%RT%LG%LA%RD"

Remark

MEMO SERIAL SMS GPRS

Below table shows the default position message format variables. For more % variables, please refer to

AT$FORM command in Protocol Document and AT$REPT command below.

Variable Description Size

%GT GPS Date Time Varied length Please refer to AT$FORM

%RT RTC Date Time Varied length Please refer to AT$FORM

%ST Position Sending Date Time Varied length Please refer to AT$FORM

%LG Longitude S32 0.000001 unit

%LA Latitude S32 0.000001 unit

%HD Heading U16 Degrees (0..359)

%RD Report ID U8 See Default Report ID

%OD Odometer U32 0.1 km

%HP GPS HDOP U16 0.1 unit

%IN All Input Status U8 8 bits status for up to 8 inputs

%VS Speed U16 1 km/hr

%OP All Output Status U8 8 bits status for up to 8 outputs

%AI1 Analog input n value U16 0.001 Volt

%DD Driver ID

Varied length.

Size:

String (1) to String (16)

When no ID is presented, a 0x00

character will be placed in this field.

When ID is presented, 0x00 will be

the ID string terminator.

%TP1 Temperature sensor 1 reading S16 2000 in 0.1 °C

%TP2 Temperature sensor 2 reading S16 2000 in 0.1 °C

%MS Text message String(500) End with 0x00



55..22.. AATT$$RREEPPTT QQuueerryy oorr sseett tthhee uusseerr ddeeffiinneedd rreeppoorrtt

Command Description

This command is used to query or set the user defined report settings.

Syntax

Write Command AT$REPT=<Report ID>,<Enable>,<"Event String" >,<"Trigger control">,<Schedule>,

<Action ID>,<Text ID>

Response $OK

Read Command AT$ REPT=<Report ID>,?

Response $REPT =<Report ID>,<Enable>,<"Event String">,<"Trigger control">,<Schedule>,

<Action ID>,<Text ID>



<Report ID> User define Report ID 101..164 (101..132

for AT1 and AX5)

U8

<Enable> Enable the user report

0: Disable

1: Enable

U8 0

<"Event String"> The event string can be in conjunction

with event/status parameters. See the

following Note for available event/status

parameters.

String(50) ""

<"Trigger Control"> Event trigger condition

0: OFF

1: ON

String(20) ""

<Schedule> Specify the schedule for the report.

The parameter is in conjunction with the

following bits:

0 – indicates use no schedule (i.e. always

on)

Bit 0 – Schedule 1







U8 0




<Action ID> Action ID (Action defined by AT$RACT) U8 0

<Text ID> Reference to AT$TEXT ID for Custom

SMS text

U8 0

Example

(1) Create a user define report ID=101 for monitoring the event of ACC=ON. When the condition is met, processing

RACT=1 for action.

AT$REPT=101,1,”%IN0”,”1”,0,1

(2) Create a user define report ID=102 for monitoring the event of input 1 ON and engine OFF. When both conditions

are met, processing RACT=2 for action.

AT$REPT=102,1,"%IN1%EG","10",0,2

(3) Create a user define report ID=103 for monitoring the event of ACC=ON and over speeding inside the geofence #1

area. When all conditions are met, processing RACT=2 for action.

AT$REPT=103,1,”%IN0%SD%GF1”,”111”,0,2

Note

Available event/status parameters for <Event String>

These event/status parameters may not support all model of ATrack product. Please see the notation of each

data field.

Event Descriptions AT1 AT1Pro AT3 AK1 AT5 AU5 AU7 AX5 AX7 AY5

%INn Input n event status (%IN0..%INn) ● ● ● ● ● ● ● ● ● ●

%EG Engine event status ● ● ● ● ● ● ● ● ● ●

%SD Speeding event status ● ● ● ● ● ● ● ● ● ●

%SDn Speeding event status with index set ● ● ● ● ● ● ● ●

%DL Vehicle idle event status ● ● ● ● ● ● ● ● ● ●

%TW Vehicle towed event status ● ● ● ● ● ● ● ● ● ●

%MT Vehicle motion event status ● ● ● ● ● ● ● ● ● ●

%IP Impact event status ● ● ● ● ● ● ●

%PL Main power low event status ● ● ● ● ● ● ● ● ● ●

%PS Main power lose event status ● ● ● ● ● ● ● ● ● ●

%SS GPS antenna event status ● ● ● ● ● ● ● ● ●

%SS1 GPS antenna disconnected status ●

%SS2 GPS antenna short circuit status ●

%SS3 GPS signal reception timeout status ●

%ANn Analog input event status (%AN1) ● ● ● ● ●



%AGn Analog change event status (%AG1) ● ● ● ●

%GFn Geofence event status (%GF1..%GFn) ● ● ● ● ● ● ● ● ● ●

%FU Fuel sensor event status ● ● ● ● ●

%TPn Temperature sensor event status (%TP1..%TPn) ● ● ● ● ●

%SP Vehicle stop event status ● ● ● ● ● ● ● ● ● ●

%HA Vehicle harsh acceleration event status ● ● ● ● ● ● ● ● ● ●

%HB Vehicle harsh brake event status ● ● ● ● ● ● ● ● ● ●

%HC Vehicle harsh cornering event status ● ● ● ● ● ● ● ●

%JD GSM signal jammed event status ● ● ● ● ● ● ● ● ●

%RP Engine over RPM event status ● ● ● ● ● ● ●

%PF Preferred Network status ● ● ● ● ● ● ● ● ● ●

%RO Roaming status ● ● ● ● ● ● ● ● ● ●

%CR GSM registration status

1: Registered to home network

0: Others

● ● ● ● ● ● ● ● ● ●

%BL Backup battery low status

0: Backup battery normal

1: Backup battery voltage < 3.7V

● ● ● ● ● ● ● ●

%OPn Output status (%OP1..%OPn) ● ● ● ● ● ● ● ●

%EL Engine load event status ● ●

%ML MIL (Malfunction Indicator Lamp) status ● ●

%TR Throttle position event status ● ●

%ET Eng ne Coolant Temperature event status ● ●

%FC Fuel Used event st tus ● ●

%OC OBD-II connect status ● ●

%SF GPS fix status ● ●

%VR Voice Call Ringing ● ●

%VA Voice Call Authorized ● ●

%VC Voice Call Connected ●

%SU Iridium satellite communication used ● ●

Remark




55..33.. AATT$$RRAACCTT QQuueerryy oorr sseett tthhee uusseerr ddeeffiinneedd rreeppoorrtt aaccttiioonn sseettttiinnggss

Command Description

This command is used to query or set the user defined report action settings.

Syntax

Write Command AT$RACT=<Index>,<Action>,<Destination>,<Output ID>,<New State>,

<New State Duration>, <Opposite Duration>,<Repeat Times >,<Track ID>

Response $OK

Read Command AT$RACT=<Index>,?

Response $RACT =<Index>,<Action>,<Destination>,<Output ID>,<New State>,

<New State Duration>, <Opposite Duration>,<Repeat Times >,<Track ID>



<Index> User define Report action index (1..10) U8

<Action> The <Action> parameter can be in conjunction with the

following bits:

Bit 0: Logging

Bit 1: Reporting

Bit 2: Output Control

Bit 3: Tracking Control

Bit 4 & 5: Reserved

Bit 6: Iridium Satellite Report

U8 0

<Destination> Reporting destination

The <Destination> parameter shall be defined when reporting

<Action> is set. The parameter is in conjunction with the

following bits:

Bit 0: SMS

Bit 1: GPRS

Bit 2: USSD

Bit 3: Serial

Bit 4: Authorized SMS Number 1 (N/A in AT5, AX5)



Bit 7: Incoming Calling Number (N/A in AT5, AX5)

U8 0

<Output ID> Output ID for the output action

1 ~ 3: Digital output ID (1 ~ 2 for AT1 and AT3)

U8 1



9: Buzzer output (not available on AT1 and AT3)

10: Wireless Relay output (Only for AX5)

<New State> New output state

0: OFF

1: ON

U8 0

<New State Duration> New state duration in 0.1 seconds. U16 0

<Opposite Duration> Opposite state duration in 0.1 seconds. U16 0

<Repeat Times> Repeat times. (0 ~ 255, where 255 means continuous

repeating)

U8 0

<Track ID> Reference to AT$TRAX index (1 ~ 10)

0 means to use settings in AT$TRAC.

U8 0

Example

Set report action 1 as when referred, log the current report and send one copy to the server via GPRS:

AT$RACT=1,3,2

Set report action 2 as when referred, report to the SMS Base Number and set output 2 to be ON:

AT$RACT=2,6,1,2,1

Remark


55..44.. NNoottee ttoo CCoommmmaanndd CChhaannggee

Note that <Destination> in TRAC, TRAX, and RACT do not have any changes. Once <Destination> is set to

GPRS and AT$SATC is enabled, reports will be sent via Iridium satellite automatically after the <Debounce>

time is reached. A more practical way to implement this is by setting different interval or disabling TRAC/TRAX

when switching to Iridium satellite communication. Below is a complete sample script to change the tracking

interval when switching to Iridium satellite communication:



66.. SSaammppllee SSccrriipptt

##### Start of Sample Script #####

# Set default tracking every 30 seconds when ACC is turned on

AT$TRAC=5,30,,,,,2

# Set report (ID 101), action 1, and TRAX 1 to switch tracking interval to 15 minutes after Iridium satellite

communication is used. No event report will be sent.

AT$REPT=101,1,"%SU","1",0,1

AT$RACT=1,9,,,,,,,1

AT$TRAX=1,5,900,,,,,2

# Set report (ID 102) and action 2 to switch tracking interval back to TRAC (30 seconds interval) after

GSM/3G network is available. No event report will be sent.

AT$REPT=102,1,"%SU","0",0,2

AT$RACT=2,9,,,,,,,0

# Set ACC On/Off (103 and 104) and action 3 so the On/Off reports will be delivered over GSM/3G and

satellite when GSM/3G network is unavailable.

AT$REPT=103,1,"%IN0","1",0,3

AT$REPT=104,1,"%IN0","0",0,3

AT$RACT=3,67,2,

# Enable Iridium satellite communication mode. Switch to satellite communication after 5 minutes when

GSM/3G is unavailable. Delete all queued messages generated in satellite mode once the communication is

switched back to GSM/3G. Keep prefix original setting and message format. Enable satellite queue checking

interval to 10 minutes.

AT$SATC=1,5,1,@P,"%GT%RT%ST%LG%LA%HD%RD%OD%HP%IN%VS%OP%AI1%DD%TP1%TP2%

MS",10

# Change serial port baud rate so the ATrack device is able to communicate with JouBeh Iridium Transceiver.

AT$BAUD=1,19200

##### End of Sample Script #####

Note that a line starting with # sign is considered as comment in ATrack device. You can copy/paste all

commands to the terminal during the setting. Save it to a text file and make any necessary changes if needed.

Once all is set, follow the next section to connect the ATrack device with JouBeh Iridium Transceiver.



77.. DDeevviiccee CCoonnnneeccttiioonn

1. Connect DB15 Female Connector to DB15 Male Connector on the 9602W.

2. Connect DB9 Male Connector at one end of the serial cable to DB9 Female Connector at one end of

another serial cable that is connected to the AT5.

3. Devices are connected in the following way.



88.. HHoosstt SSeerrvveerr CCoonnffiigguurraattiioonn

Since data will be delivered to your host server via a Direct IP connection, consult your Iridium service

provider for more information on how to apply for the Direct IP service. The data received on the server via

Iridium satellite communication will have a specific header. Refer to “Iridium Short Burst Data Service

Developers Guide” for detail information. Sample String with ATrack Standard ASCII Message Format in HEX

as shown below:

01 00 7D 01 00 1C 5B 18 9E B4 33 30 30 32 33 34 30 36 31 39 34 35 35 33 30 00 00 00 00 00 53

5E 12 99 03 00 0B 00 19 0C 8F 79 8A 1F 00 00 00 0C 02 00 77 40 50 2C 41 46 35 33 2C 31 31 39

2C 31 31 32 2C 33 35 32 35 39 39 30 34 34 35 38 33 34 37 39 2C 31 34 30 34 31 32 31 37 31 34

2C 31 34 30 34 31 32 31 38 30 38 2C 31 34 30 34 31 32 31 38 31 33 2C 31 32 31 35 36 32 35 36

31 2C 32 35 30 38 33 36 32 34 2C 30 2C 31 31 39 2C 34 31 2C 39 39 30 2C 30 2C 30 2C 30 2C 30

2C 2C 32 30 30 30 2C 32 30 30 30 2C 1A 0D 0A

Field Size Sample Value in HEX

MO Header 1 01

MO Length 2 00 7D

MO DirectIP Header 1 01

MO DirectIP Header Length 2 00 1C

CDR Reference (Auto ID) 4 5B 18 9E B4

Satellite Modem IMEI 15 33 30 30 32 33 34 30 36 31 39 34 35 35 33 30

Session Status 1 00

MOMSN 2 00 00

MTMSN 2 00 00

Time of Session 4 53 5E 12 99

MO Location 1 03

MO Header Length 2 00 0B

Latitude/Longitude 7 00 19 0C 8F 79 8A 1F

CEP Radius 4 00 00 00 0C

MO Payload 1 02

MO Payload Length 2 00 77

Payload

(ATrack Data Fields)

MO Payload Length 40 50 2C 41 46 35 33 2C 31 31 39 2C 31 31 32 2C 33 35 32 35 39 39

30 34 34 35 38 33 34 37 39 2C 31 34 30 34 31 32 31 37 31 34 2C 31

34 30 34 31 32 31 38 30 38 2C 31 34 30 34 31 32 31 38 31 33 2C 31

32 31 35 36 32 35 36 31 2C 32 35 30 38 33 36 32 34 2C 30 2C 31 31

39 2C 34 31 2C 39 39 30 2C 30 2C 30 2C 30 2C 30 2C 2C 32 30 30

30 2C 32 30 30 30 2C 1A 0D 0A



Below example is with customized ATrack Binary report format with only GPS date time, RTC date time,

Longitude, Latitude, Report ID, Odometer, HDOP, and Speed by setting the below command:

AT$SATC=1,1,1,@P,"%GT%RT%LG%LA%RD%OD%HP%VS"

01 00 7D 01 00 1C 5B 18 9E B4 33 30 30 32 33 34 30 36 31 39 34 35 35 33 30 00 00 00 00 00 53

5E 12 99 03 00 0B 00 19 0C 8F 79 8A 1F 00 00 00 0C 02 00 77 40 50 91 A4 00 87 00 0A 00 03 10

D9 35 8B 1C 91 55 1B A5 39 55 1B A5 39 07 3E E5 49 01 7E BC DC 02 00 00 00 00 00 0B 00 00

Field Size Sample Value in HEX

MO Header 1 01

MO Length 2 00 7D

MO DirectIP Header 1 01

MO DirectIP Header Length 2 00 1C

CDR Reference (Auto ID) 4 5B 18 9E B4

Satellite Modem IMEI 15 33 30 30 32 33 34 30 36 31 39 34 35 35 33 30

Session Status 1 00

MOMSN 2 00 00

MTMSN 2 00 00

Time of Session 4 53 5E 12 99

MO Location 1 03

MO Header Length 2 00 0B

Latitude/Longitude 7 00 19 0C 8F 79 8A 1F

CEP Radius 4 00 00 00 0C

MO Payload 1 02

MO Payload Length 2 00 77

Payload

(ATrack Data Fields)

MO Payload Length 40 50 91 A4 00 87 00 0A 00 03 10 D9 35 8B 1C 91 55 1B A5 39 55 1B

A5 39 07 3E E5 49 01 7E BC DC 02 00 00 00 00 00 0B 00 00

Where:

4050 -->Prefix

91A4 -->CRC

0087 -->Length

000A -->Seq ID

000310D9358B1C91 -->Unit ID

551BA539 -->%GT

551BA539 -->%RT

073EE549 -->%LG

017EBCDC -->%LA

02 -->%RD

00000000 -->%OD

000B -->%HP

0000 -->%VS

JouBeh 9602W SBD Iridium Transceiver Application …arpaway.com/manuals/Iridium Application Note...

Documents

Transcript of JouBeh 9602W SBD Iridium Transceiver Application …arpaway.com/manuals/Iridium Application Note...