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: T-BOX 200Ω Output LED 1k 12V 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: + 12V - IN x where x is the number of T-Box input. False. When voltage is applied, input state will change to True, when there is no voltage, the state will be 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. Delete or load new application Check 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