T-BOXN12R

You can make it wireless

First steps with T-BOXN12R

Date: 2004-07-16
Version 1.0
Content
1. Purpose of this document ....................................................................................................................................... 3
2. T-BoxN12R overview ............................................................................................................................................ 4
3. First step ................................................................................................................................................................. 5
3.1. Preparing your workshop to start quickly ...................................................................................................... 5
3.2. Powering up your T-Box................................................................................................................................ 5
3.3. Installing software .......................................................................................................................................... 5
3.4. Connecting T-Box to your PC........................................................................................................................ 6
3.5. Configuring security....................................................................................................................................... 7
4. See how your T-Box works.................................................................................................................................... 9
4.1. Example application – Blinker....................................................................................................................... 9
4.2. Start and configure Hyper Terminal............................................................................................................... 9
4.3. See how blinker switches outputs ................................................................................................................ 11
4.4. See how blinker reads inputs........................................................................................................................ 11
4.5. Manage Java IMlet applications................................................................................................................... 12
5. User control mode ................................................................................................................................................ 13
5.1. How to start? ................................................................................................................................................ 13
5.2. User Control Mode configuration ................................................................................................................ 13
6. Reference.............................................................................................................................................................. 16
1. Purpose of this document
Purpose of this document is to help users and integrators to quickly start integrating and using the T-
BOXN12R (hereafter T-Box). This document describes how to connect T-Box to external hardware,
personal computer and how to set it up for testing and operation.

The reader of this document should be familiar with the documents listed on reference page.
2. T-BoxN12R overview

T-BOX/N12R is a terminal with GSM connectivity. T-BOX/N12R module is designed using most
advanced solutions from Nokia. It has a built-in Nokia 12 modem for data transfer. So, various data transfer
channels of GSM can be used. In this way, we can offer you most reliable connection for the best price.

T-BOX/N12R operates in any GSM network: 900/1800 MHz or 850/1900 MHz. EDGE, GPRS,
HSCSD, CSD and SMS could be used for data transfer*.

T-BOX/N12R can be used as a remote control unit, data collection and transfer unit.

Discrete outputs can be use to manage external loads like relays, lights etc. Discrete inputs can be
used to monitor the status of external devices. The inputs are optically isolated. Analog inputs enable to
mease the static signals like voltage, current, temperature, etc.

T-BOX/N12R can be used as a small and very simple logical controller. T-BOX/N12R includes
Java™ with remote IMlet downloading. It means that this controller can be programmed according
consumer requirements with standard and easy available tools. Integrated TCP/IP stack enables to make an
IP connection to remote servers or modules. It is a very easy to send and receive data. Integrated CORBA
support allows creating distributed applications.

Module also includes an interface for connecting a GPS receiver, which is necessary for location
acquirement applications.

This device can be used as a modem for PC as well. Also you can control the external devices
connected via RS-232 interface.

Wide range of power supply voltage and operating temperature range expands the possibilities. The T-
Box case is suitable for fitting with electronic instruments that can hook to the DIN EN 50022. T-
BOX/N12R is small in size, but big in its functionality, what lets you easily control your machines.
3. First step
3.1. Preparing your workshop to start quickly

This chapter explains what you need to start working with T-Box. Most needed tools are on CD
which is supplied with T-Box.

To start and configure T-Box you need:

1. T-BoxN12 Sample

2. Cables (included with T-BoxN12R)

Two cables are shipped with T-Box. The first one is called Port 1/2 and second one - Port 3. Cable
labels match port names of Nokia 12 GSM module.

3. Power supply

Power supply should be: 6 to 30 V DC, 1A. (500mA@12V).

4. PC with Microsoft Windows operating system

Requirements: any IBM PC compatible machine which fits OS requirements.

5. Nokia 12 Configurator Software

This software is shipped on the CD with T-Box. You can also check Nokia’s web site
www.forum.nokia.com for updates.

3.2. Powering up your T-Box

Connect power supply to power connector of T-Box. See labelling on T-Box housing. Polarity is
important – be careful not to swap positive and negative terminals. T-Box has an integrated protection for
wrong power connection.

3.3. Installing software

In order to start working with T-Box, you must install Nokia 12 Configurator Software, which is
found on the CD, at first. To start the installation process log in to your computer as a user with appropriate
permissions. Start Nokia_12_Configurator_2.40.exe (version might be different) and follow the screen
messages. You must agree with license and press button “Next” a few times.
3.4. Connecting T-Box to your PC

Connect cable labelled Port1/2 to T-Box port labelled Port2/3 and to COM port of your PC. This
will let you configure T-Box via M2M interface.

Configure Nokia 12 Configurator to use COM port to which the T-Box is connected and set
connection type to M2M System Interface.

Figure 1

Nokia 12 Configurator software setup is shown Figure 1.

After setting these parameters press OK and wait a while until Configurator connects to T-Box. When
connection is successful you should see a dialog box asking to enter PIN code. This dialog box is shown
below in Figure 2.

Figure 2

PIN code should be provided by your GSM provider, it is a four digit code. PIN code depends on the
SIM card you use.

Note: Usually each SIM card has its own PIN code.
 After you enter the PIN code you will see your GSM operator’s name and a green/blue connector in
the lower right corner of the Configurator window:

Menu for configuration

Operators name
and signal strength

Connection OK

3.5. Configuring security

Nokia 12 module supports GSM security codes, AutoPIN and live checks with reset mechanisms, to
enhance the reliability and security of the M2M application.

You can configure T-Box security in “GSM Security> PIN Code Settings” menu:

Figure 3 PIN Code Settings

 Change the PIN code query in the PIN Code Settings dialog. The available settings are:

On (PIN code query On): Every time the T-Box is started, the PIN code is queried.

Off (PIN code query Off): The PIN code query is disabled.

Auto (AutoPIN): The PIN code is stored into the memory of the Nokia 12 GSM Module during the
first start-up. In later start-ups the T-Box automatically enters the PIN code for the current SIM card.

AutoPIN enables device recovery after (occasional) power cuts without on-site intervention, and helps
to prevent fraud. The PIN code is programmed into the memory of the Nokia 12 module where it is relayed
in unusual situations. When AutoPIN is in use, the SIM card is useless to any outsider.
4. See how your T-Box works

The T-Box samples are shipped with preloaded demo Java application. This application is called
Blinker. This section describes the functionality of blinker application.

4.1. Example application – Blinker

Blinker application writes 1s and 0s every 0,5 s and you will see that on blinking LEDs. Then it logs
the state of digital and analog inputs to Java port (Port 3 Nokia 12).

To see how Blinker works you should connect PORT 3 of T-Box to some of the COM ports of your
PC. You should use cable labelled PORT 3 connected to T-Box on port labelled PORT2/3.

Note: PORT 2 and PORT 3 of Nokia 12 GSM Module are connected to one connector of T-Box labelled
PORT 2/3. To use PORT 2, use cable labelled PORT1/2. To use PORT 3, use cable labelled PORT 3.

4.2. Start and configure Hyper Terminal

Hyper Terminal is a standard Windows application, it can be found in Start> Programs> Accessories>
Communication menu.

When you start Hyper Terminal it will ask you for configuration:

First enter connection name. Connection name is defined by user:

After you press OK you have to choose the COM port to which T-Box is connected.

Then you have to set up COM port parameters as following:

 After you press OK you should see something like this:

Values can be different.

4.3. See how blinker switches outputs

When Blinker application is running, LEDs on front panel of T-Box should blink in sequence. Also
outputs are switched. You can see how outputs are switched in the following simple schematic:

LED 1k 12V
T-BOX 200Ω Output

4.4. See how blinker reads inputs

When T-Box connected to a PC via PORT3 to COM port, you can see the state of inputs with Hyper
Terminal.

To change the state of the inputs you should apply for example 12V between input and input ground.

Note: Inputs are optically isolated and have separate ground. Input ground has this sign:
 Connection schematic should be the following:

+ IN x where x is the number of T-Box input.

12V
-

When voltage is applied, input state will change to True, when there is no voltage, the state will be
False.

4.5. Manage Java IMlet applications

T-Box (Nokia 12 GSM Module) has 1Mbyte memory for application and data storage. This memory
can be used for storing IMlets or data files. One IMlet application can be up to 128Kb in size. But you can
load as much IMlets as you want until you have enough memory. Only one IMlet can run at a time. One
IMlet can start another IMlet.

IMlets are managed with Nokia Configuration software. You can run IMlet loading application in
Nokia Configurators menu IMlet Loading > Cable:

You can stop and start

an IMlet here.

Check
Delete or load new application
how
much
memory
left on
module

Figure 4 IMlet loading suite

If you don’t need demo application in your T-Box, you should simply delete it.

Note: Before deleting an IMlet stop it with stop button!

5. User control mode
5.1. How to start?

First you should stop or delete a demo application. Start Nokia Configurator as it is described in
section 3.4. Start IMlet loading suite as it is described in section 4.5 an stop an IMlet if it is running.

To see which IMlet is active simply click on each IMlet available in the list and look at the Stop and
Start buttons. If Stop button is active, it means that current IMlet is running.

5.2. User Control Mode configuration

In Nokia 12 Configurator Software select User Control Mode > Settings. You should see the following
window:

Figure 5 User Control Mode Setup window

First step is to enter an identifier in identifier field. Click Change, enter identifier and click Accept.
 Note: Remember to click Write Parameters button after every change of parameters!

When identifier is entered General, Security and Aliasing tabs are enabled.

Note: If identifier is already entered and dabs are still disabled, click Read Parameters button

Purpose of tabs:

General tab – Here you can enable or disable acknowledgements. They are used to send confirmation
to user about performed commands.

Security tab - Configure security options:

Enter password here

Enter authorized numbers here. The

firs number in the list is a special one.
Owner of this number will receive all
failed commands sent so Nokia 12.
 Aliasing tab – here you can enter an alias for each input and output. This helps better to remember
the functionality of the command. For example

So in this case instead of writing OUTPUT_SET 5 ON you should just write Heating ON.

When all the parameters are entered click Write Parameters.

Now test how it works. Suppose identifier is IDF and password is PSW, then send the following
message to your T-Box:

IDF PSW Heating ON

Message format is: <identifier> <PSW> <Command>

For more information about User Control Mode refer to #3.

6. Reference

Recommended literature

1. T-BoxN12r Integrators Manual

Available documents from www.forum.nokia.com/m2m.

2. Nokia 12 Hardware Integration Manual

3. Nokia 12 Remote IO Control Guide

4. Nokia M2M Platform Nokia 12 GSM Module IMlet Programming Guide

5. Nokia M2M Platform Software Developer’s Guide

6. Nokia 12 GSM Module Product Specification