User's Manual
Table Of Contents
- Introduction
- The Integrator’s Task
- Installing the Modem
- Using the Modem Test Jig
- Testing
- Desense
- Application Development
- Message Routing and Migration
- Appendix A - NCL Interface
- Appendix B - Software Development Kit
- SDK Contents
- System Requirements
- SDK Software Architecture
- NCL Application Programmer’s Interface
- Implementation
- Logical Architecture
- Application Interface
- Opening a Session
- Close Session
- Send Data to a Radio Host
- Receive Data From RPM
- Get RPM Status Information
- Set Configuration ITEMS Within the RPM
- Reset RPM
- Register Event Callback Function
- Enable / Disable Events
- Get Error Description
- Register Wakeup Application
- Deregister Wakeup Application
- Switch RPM On/Off
- Send Generic NCL Command To RPM
- Get Software Version
- SCR Application Programmer’s Interface
- A
- Appendix C – Sample programs
- Appendix D - Wavenet Application Loader
- Appendix E - Numeric Conversion Chart
- Appendix F - Specifications
- Appendix H - Glossary
Boomer II User Manual & Integrator’s Guide ______________________________________________ SDK SCRAPI
BM210012WT27 131 Wavenet Technology
Please refer to Appendices B and C for guidance to how to use the
Boomer II SDK. All code was developed using Microsoft Visual C++
Version 6.0, for Microsoft Windows WIN98/NT/2000.
System Requirements
This SDK requires the Microsoft Message Queue (MSMQ) service
running on the target PC. MSMQ is included in Windows 2000 as part
of the operating system but this service needs to be activated manually.
Please refer to Microsoft documentation on how to activate the MSMQ
service on Windows 2000. For all other versions of the Windows
operating system, please inquire from Microsoft on how MSMQ can be
installed and activated. Ensure that the PC has at least one available
serial (RS-232) port before using this SDK.
SDK Software Architecture
The SDK is built on a client-server architecture. The server application
allows multiple client applications simultaneous access to the modem
The sample ‘ModemInfo’ application is an example of a client
application. The ‘PortServer’ application acts as the server.
Server Initialisation: Start the server application by running
‘PortServer.exe’. This server application does not have a user’s
interface. The only way to ensure that it is running is to view the active
processes on the Windows Task Manager. ‘PortServer.exe’ does take
the desired serial port name as a command line parameter. If no
command line parameter is specified, ‘PortServer’ assumes that ‘com1’
is desired. If com2 is connected to the modem, run the server as
following: PortServer com2VDD Library.
The VDD library contains all tools required for client-server
communications by using the MSMQ service to deliver messages to the
other party. All clients applications are required to open a session with
the server application if it wants to communicate with the modem. By
using the VDD library this process message delivery is transparent for
the client.
NCL Application Programmer’s Interface
The Native Control Language Application Programmer's Interface
(NCL API) is the client component of the SDK. The NCL API
provides routines for sending and receiving data messages through the
DataTAC wireless network, using a radio packet modem (RPM). It also
allows the client application to control configuration parameters of the
RPM and to retrieve status information from the RPM.
Implementation
The NCL API is implemented as a DLL library of written in C++ for
windows using Microsoft~ Visual C++ Version 6.0.
The NCL API communicates with PC or Pocket PC applications based