PRODUCT GUIDE Copyright © 2002-2003 Nokia. All rights reserved. Issue 2.
Contents ACRONYMS AND TERMS ...................................................................................................... 1 REFERENCES......................................................................................................................... 2 1. ABOUT THIS DOCUMENT .............................................................................................. 3 2. INTRODUCTION ..........................................................................................................
6. CONFIGURATOR SW.................................................................................................... 15 7. APPLICATION EXAMPLES ........................................................................................... 16 7.1 EVALUATION MODULE CONTROL APPLICATION .............................................. 16 7.2 TERMINAL END APPLICATIONS ........................................................................... 16 7.3 SERVER END EXAMPLE1 AND EXAMPLE2 APPLICATIONS ............
Legal Notice Copyright © 2002-2003 Nokia. All rights reserved. Reproduction, transfer, distribution or storage of part or all of the contents in this document in any form without the prior written permission of Nokia is prohibited. Nokia and Nokia Connecting People are registered trademarks of Nokia Corporation. Java and all Java-based marks are trademarks or registered trademarks of Sun Microsystems, Inc.
ACRONYMS AND TERMS ADK Application Development Kit ANSI American National Standards Institute API Application Programming Interface CORBA Common Object Request Broker Architecture CSD Circuit Switched Data GIOP General Inter-ORB Protocol GPRS General Packet Radio Service GW Gateway HSCSD High Speed Circuit Switched Data HW Hardware IDL Interface Definition Language IP Internet Protocol M2M Machine-to-Machine OMG Object Management Group ORB Object Request Broker OS Operating Sy
REFERENCES Guide for Evaluation Module SW Installation Guide for Nokia M2M Application Development Kit 2/21
1. ABOUT THIS DOCUMENT This document describes the main characteristics of the Nokia Machine-toMachine (M2M) Application Development Kit (ADK). The product concept, purpose of use, main features, and sales packages are depicted at a general level. More detailed information can be found at the Forum Nokia website, http://www.forum.nokia.com, from the Nokia M2M section. All Nokia M2M ADK documentation and installation software is downloadable from that website.
2. INTRODUCTION As we are quickly moving towards the world of third generation mobile traffic, more attention than ever is being paid to the wireless data market. So far, we have seen only the first steps towards the mobile information society, but it has already become clear that wireless data means more than just web browsing. M2M communication is just one of the aspects of wireless data services.
Figure 1. Nokia M2M Platform 2.2 OTHER NOKIA M2M PLATFORM PRODUCTS 2.2.1 Nokia M2M Gateway The Nokia M2M Gateway provides wireless CORBA access and interoperability to the Internet. The Nokia M2M Gateway bridges the GSM network and Internet by wireless connection establishment and protocol translation between applications located on the Internet and in remote devices.
has a limited set of features compared to Corporate and Service Provider editions.Nokia 30 GSM Connectivity Terminal The Nokia 30 GSM Connectivity Terminal, presented in Figure 2, is an M2M communications device with versatile interfaces and advanced functions. It forms part of Nokia M2M Platform solution, comprising terminals and the Nokia M2M Gateway. Nokia 30 has many useful features: • Dual band EGSM 900/1800 MHz • GPRS multi-slot class 6 (max 3 + 1, 2 + 2) • HSCSD multi-slot class 6 (up to 43.
3. NOKIA M2M ADK PRODUCT CONCEPT AND USAGE The Nokia M2M Application Development Kit (ADK) belongs to the Nokia M2M Platform product family. The Nokia M2M ADK provides a set of tools for creating applications on the Nokia M2M Platform and testing them in the development phase. The Nokia M2M ADK is the easiest way to become familiar with Nokia M2M Platform technology. It shows how to utilize the built-in features of the Nokia M2M Platform concept with simple example applications.
Figure 3.
4. EVALUATION MODULE The Nokia M2M ADK includes an evaluation module, which is an example HW for the embedded application module. One of the example applications in the Nokia M2M ADK can be used to control evaluation module digital and analog inputs and outputs, see Chapter 7. In addition to these inputs and outputs, the evaluation module has interfaces for standard RS-232, SW downloading and tracing. Figure 4. Evaluation module for Nokia M2M ADK 4.1 INTERFACES 4.1.
4.1.2 Power interface The evaluation module has a power interface for the ACW-5 Nokia Power Supply. The input voltage range is 6.4 V - 13.5 V, and the absolute maximum rating is 16.5 V. This power interface is not needed if power is supplied from the terminal through the M2M system connector. Alternatively, the evaluation module can supply the terminal through this same interface. 4.1.
4.1.8 Tracing interface The evaluation module has an interface for tracing the traffic in the M2M system interface between the evaluation module and the Nokia GSM Connectivity Terminal. Physically there are two D9 connectors on the PCB, one for tracing the traffic from the evaluation module and one for tracing the traffic to the evaluation module. Tracing requires compatible PC software that is supplied with the Nokia M2M ADK. 4.
4.2.3 OS & HW wrappers This SW module integrates other M2M components to other embedded SW. The purpose is that M2M components could remain the same as far as possible, whatever the overall system. This is achieved by defining a general purpose interface that can be easily mapped to various platforms. The size is about 1 kbyte. 4.3 MECHANICS The Evaluation module is provided with aluminium mechanics. Dimensions are 152 x 144 x 45 mm. The mechanics is removable.
5. NOKIA M2M GATEWAY TRIAL VERSION The Nokia M2M Gateway Trial Version is intended for trialling the Nokia M2M Platform technology and for testing purposes in the software development phase. The server application may be run on the same host as the Nokia M2M Gateway Trial Version. Due to the limited connectivity services offered, the Trial Version has restricted suitability for commercial applications. 5.1 FEATURES 5.1.
Table 1. Nokia M2M Gateway Trial Version system requirements Product Operating System Nokia M2M Gateway Trial Version Windows NT 4.0 / Windows 98 / Windows 2000 Hardware Pentium III processor, minimum 500 MHz Memory (RAM) Min 256 MB, 512 MB recommended Hard disk space Min 200 MB These requirements are the general requirements for the Nokia M2M ADK software.
6. CONFIGURATOR SW The Configurator software is an accessory product for Nokia GSM Connectivity Terminals. It is used to modify the basic settings of the terminal so that the connection to the GW can be established. The following settings can be configured: • GSM security settings • GSM network settings • GSM WAP parameter settings A PC or laptop and an RS-232 serial cable are needed when configuring the terminal.
7. APPLICATION EXAMPLES The Nokia M2M Application Development Kit includes application examples that show how the Nokia M2M Platform application can be implemented. All application examples are available in source codes that make application development easier, as the codes can be copied, modified and used in the customer’s own applications. 7.1 EVALUATION MODULE CONTROL APPLICATION The evaluation module control application is an end-to-end application, i.e.
These terminal end applications are implemented with C. 7.3 SERVER END EXAMPLE1 AND EXAMPLE2 APPLICATIONS Nokia M2M ADK includes example applications for controlling the terminal connected to the evaluation module at the embedded end from the server side. In example application 1, the server end queries the remote terminal for a list of names of objects that are registered to the Object Request Broker (ORB) of the terminal (i.e. objects that can be found from the remote terminal).
8. M2M TRACER The Nokia M2M Application Development Kit includes a tracer for logging the traffic over the M2M system interface between the evaluation module and the Nokia GSM Connectivity Terminal. The tracer includes a tracer interface in the evaluation module and PC software. The PC is connected to the evaluation module tracing interface by a serial cable, see tracing interface Chapter 4.1.8. The user can set the hooks as he/she wants. Logs are saved in text files.
9. IDL COMPILER The Nokia M2M ADK includes an IDL compiler for the embedded application development. The IDL compiler is a program that reads IDL files and produces the necessary programming language-specific files: skeletons and stubs. These translate message data into a form that is appropriate for cross-platform messaging. This is described in Figure 5.
10. DOCUMENTATION Nokia M2M ADK includes a lot of documentation concerning the ADK HW and SW and about application development on the Nokia M2M Platform. All the documents are available separately from the Forum Nokia website in Nokia M2M section, but they are also included in the CD-ROM in the evaluation module sales package.
11. SALES PACKAGE To get full benefit of the Nokia M2M ADK, the developer needs two Nokia GSM Connectivity Terminals, an evaluation module and M2M ADK software in the installation CD-ROM. Evaluation module sales package contains following items: • Package carton • Evaluation module • Power supply with AC cable • RS-232 data cable X 2 • Nokia M2M ADK Installation CD-ROM • Product note Figure 6.
