First use of the C4-D

This page has been updated on the 5 April 2011.

What is this document about?

Here, we’ll explain how to use your device for the first time with a default configuration. More precisely, we will show you all the parameters you have access to and how to access the first set of data your device will have sent to our server.
Before reading this document please make sure your device is switched on. If that’s not the case, click here. for information on first install.

How to access the console

This will show you how to use a terminal like Tera Term.

1. Download and install Tera Term.
2. Launch TeraTerm and select Setup>Serial port.


3. Enter the following parameters and select OK.

Baud rate: 115200
Data bits: 8
Parity: none
Stop bit: 1
Flow control: none



4. Type #SWITCH# to display the console.

Check the device APN

First, check that your device is connected to the GPRS network. This information is given by the third LED, it should be blinking slowly (3 seconds ON, 3 seconds OFF).
If this is not the case, check if the APN set in your device is right. This parameter depends on your network provider.
To check this parameter got to the console and enter modem to check if the APN is right

The parameters

Settings

To ensure your device sends data to the server you need to activate three components.

DataRecoder

To activate this component enter the following command into the light console:
s dataRecorder active 1

DataEmitter

To activate the dataEmitter enter the command:
s dataEmitter active 1

BinaryGate

The last thing you need to configure is the binary Gate. This is the point of entrance of the data into the server. For the data to be recorded on the server the device must be allowed to access it.
To configure the binary Gate, set the parameters binaryGate.port and binaryGate.url. The values of those should have been given to you by Mobile Devices.
The commands you need to enter are:

  • the fist is to set the URL: s binaryGate url combin1.sandbox.g8teway.com
  • the second one is to set the port: s binaryGate port 4242

Warning: Those values are examples. Do not use them on your devices. Mobile Devices will provide you with the correct information.

GPS

If you are using an external GPS antenna, check that the source of the GPS antenna is set correctly.
To do so, use the following command: g gps default_antenna_source. If the return value is 0 the source is internal.
To switch to the external source set this parameter to 1 with the command: g gps default_antenna_source 1

Check the value of a parameter.

There are two ways to check the device’s parameters. The first is using the console and the second is by SMS.

With the console.

First, connect your device to your computer and access to the light console.

So to check a parameter, you should use the command g,component.parameter_name

Here is an example of what you should get:

Here, we can see the frequency at which the device records speed. In this case 30 seconds.

Reminder: The different settings you can use for each field are :

  • x >0 to save your data every x seconds.
  • 0 to save you data on event (when it changes).
  • -1 to disable the record.

By SMS

You first need to send a SMS to the device you want to interact with.
This SMS has a very simple syntax:
get,component.parameter_name

Example:

  • you want to check the value of the speed field, so you send the following message:
    get,dataRecorder.fieldPeriod[8]
  • then within a few seconds, the device sends you a message back:
    CNF:get:dataRecorder.fieldPeriod[8]=30#
    The value is 30 seconds.

Note:
You can make several request in the same message, you just need to separate each command by a ‘#’.

Change the value of a parameter

With the console.

To check a parameter, you should use the command s,component.parameter_name,value

Here is an example of what you should have:

In this example, we’ll set the frequency at which the device records speed. We’ll set it to 60 seconds.

WARNING:
You will need to restart the software after having changed the value of a parameter. To do so, enter “reset” in the light console.

By SMS

You will need to send a SMS to the device you want to interact with.
This SMS has a very simple syntax:
set,component.parameter_name

Example:

  • you want to set the value of the speed field to 30 seconds, so you send the following message:
    set,dataRecorder.fieldPeriod[8],30
  • then within a few seconds, the device sends you a message back:
    CNF:get:dataRecorder.fieldPeriod[8]=30#
    The value is now 30 seconds.
  • then do a reset, to do so send the SMS ‘reset’.

How to see your device on the server?

  • To consult the data sent by a device to the server, we provide a graphical interface at this web site: http://sandbox.g8teway.com/apiv2/
    A documentation about this web site is available here.
    From this site, you will also be able to retrieve part or all the data in different format such as xml or json.
  • Another feature we provide is to localize a device on a map, for this purpose go to this web site http://sandbox.g8teway.com.
    A documentation on this web site is available here.