Wavenet Technology BM3-800D User Manual

Boomer-iii datatac oem modem module

Table of Contents

Quick Links

Download this manual

User Manual

and

Integrator's Guide

Boomer-III DataTAC

OEM Modem Module:

BM3-800D

Revision 0.4

October 2003

Table of Contents

Need help?

Do you have a question about the BM3-800D and is the answer not in the manual?

Questions and answers

Summary of Contents for Wavenet Technology BM3-800D

Page 1 User Manual Integrator’s Guide Boomer-III DataTAC OEM Modem Module: BM3-800D Revision 0.4 October 2003...
Page 2 Web Site: www.wavenet.com.au This manual is intended to be used for the operation of Wavenet Technology equipment. Performance figures quoted are typical values and subject to normal manufacturing and service tolerances. Wavenet Technology Pty Ltd reserves the right to alter, without notice, the equipment, software or specification to meet technological advancement.
Page 3: Table Of Contents
Wavenet SDK.....................62 Wavenet Commander ................65 Wavenet Application Loader...............69 Integration Testing ..................74 Hardware Integration..................74 Desense and EMI..................75 Regulatory Compliance ................76 Application Software...................77 Final Assembly ...................77 End User Problem Resolution ..............77 OEM Service Depot Repair ................78 BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 4 Measurement Techniques ................133 Alternate Measurement Method ...............134 Methods of Controlling Emissions ............135 RF Network Issues ...................137 Antenna ....................138 Desense Summary...................138 Appendix G - Numeric Conversion Chart.............140 Appendix H - Specifications .................142 Appendix I - Glossary...................144 Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 5: Introduction
A picture of the Boomer-III OEM Modem Module is shown below. RF Connector Indicators Data Interface Port This manual contains the following major sections: Section 1: Introduction BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 6: Modem Features
Small footprint and low profile design Low-voltage and low standby current consumption for battery based products Auto-wake up of host/terminal on incoming messages Roaming capabilities as defined by the network Easy to install, service and update Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 7: Wireless Applications
The Boomer-III OEM Modem offers a real solution to this problem. Parking, Buses and Ticketing Ticketing machines are being be converted to cashless operation. The Boomer-III OEM Modem is the best alternative to facilitate the introduction of this cashless technology. BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 8: Developer Support
Intel compatible Pentium computer or higher Windows 2000 or later 16MB RAM (memory) minimum, 32MB recommended 1MB available hard disk space 9-pin serial Port using a 16550 UART 3.5-inch Disk Drive CD-ROM drive Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 9: Compliance Statement
Consult your supplier or an experienced radio/TV technician for assistance. Warning: Changes or modifications to this unit not expressly approved by the party responsible for compliance could void the user’s authority to operate this equipment. BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 10: Information For Your Safety
It has been dropped or damaged in any way. It does not operate normally by following the instructions contained in this manual. It exhibits a distinct change in performance. Failure to observe all these instructions will void the limited warranty. Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 11: The Integrator's Task
Develop and validate the hardware Develop supporting applications software Test and approve the product As you review these tasks, allow sufficient time for such required activities as the regulatory approval process. Identify critical path activities up front. BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 12: Plan The Product And Create The Design
46. The typical approach to creating the model is to define the peak and average network throughput requirements based on input from the user. Wavenet Technology is able to provide current consumption figures for each of the various modes of operation (receive and transmit, for example) and explain the functionality of the network Power Save protocol.
Page 13 Such a software utility is essential for field service engineers and shop technicians to diagnose problems with the product and to troubleshoot a problem to a failed assembly or mismanaged communication link. BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 14 Regulatory issues are discussed in more detail in “Regulatory Requirements” on page 19. In addition, see “Regulatory Compliance” on page 76. Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 15: Develop And Validate The Hardware
A number of development test aids are available to assist in hardware and applications development. Wavenet can provide both the modem hardware and an evaluation board. The evaluation board is a specially developed circuit board with test points and jumper switches. The BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 16: Develop Supporting Applications Software
Proper modem operation requires that you minimize EMI (electromagnetic interference) radiated from your product’s platform. Excess noise significantly reduces the wireless modem’s ability to receive, making the network less likely to be heard. Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 17: Environmental Issues
If you need additional ruggedness and safety in your products, you must engineer the environmental characteristics of your host/terminal to achieve a special safety rating. BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 18 When setting down or picking up the static sensitive component, make skin contact with a conductive work surface first and maintain this contact while handling the component. If possible, maintain relative humidity of 70-75% in development labs and service shops. Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 19: Regulatory Requirements
Country Requirements The country requirements given below are provided as a general guide to the certification processes in the regions and countries given. You BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 20 5dBi, the MPE limits will not be exceeded. In this case, the following clause should be included in the installation and user documentation: Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 21 Consult the dealer or an experienced radio/TV technician for help.” Labelling The FCC requires the integrated product to be labelled as shown here: “This product contains a type-accepted transmitter approved under FCC ID: PQS-BM3800D.” BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 22 Within the radio portion of the network, between the device and the base station, specialized RF protocols (RD-LAP or MDC4800) carry the data. These radio protocols are typically transparent to wireless applications. Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 23 Note: On Motient and Bell Mobility networks the modem operates in either MDC 4800 mode or RD-LAP 19200 mode, as provided by local coverage, however, it is recommended contact be made with the relevant network operators to confirm specific details. BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 25: Installing The Modem
Fixed-mount units are sometimes AC-line powered and require filtering to eliminate the 50Hz or 60Hz noise that can impair modem operation, depending upon country of use. BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 26: Mounting The Boomer-Iii Oem Modem To Your Device
Mount the Boomer-III OEM Modem to your device Connect the Data Interface Port Connect and position the antenna Supply power A picture of the Boomer-III OEM Modem is shown below. RF Connector Indicators Pin 1 Data Interface Port Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 27: Connecting The Data Interface Port
OEM Modem’s Data Interface Port and the host/terminal. The connector specification is given below. The modem utilises connector part number 803-30-T-U from A-Point however, connector equivalents such as F006-52893 from Molex as shown below, may also be used in the host/terminal. BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 28 Molex FPC Connector F006-52893 Pin 1 of the connector is adjacent to the LED window; it is also marked on the housing. The pin assignment of the Data Interface Connectors is shown in the following table. Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 29 Note: The voltage range of most of the modem input pins is typically 0-3V, however, 0-5V may be used for compatibility with conventional digital logic, unless otherwise stated. BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 30 The electrical interface specification and equivalent circuit is as follows: Modem On/Off Control Equivalent Circuit Modem On/Off Control Electrical Characteristics Parameter Range High Input Voltage 0-3V 0-5V 1.0 V (max) 2.5 V (min) Input Current 20 µA (max) 100 µA (max) Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 31 Input Voltage 2.1 V 3V (max) Input Current 1 µA 10 µA Warning: The input voltage on RTC-BB (pin 11) must never exceed 3V under any circumstances or the modem may be damaged. BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 32 Reset Input Equivalent Circuit Reset Electrical Characteristics Parameter Range Reset Active Reset Inactive Input Voltage 0-3V 0-5V 1.8 V (min) Input Current 200 µA (max) 200 µA (max) Pulse width 5mS (min) Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 33 Low when ready Data set ready Input High when host/terminal Request to send requires data throttling Output High when modem requires Clear to send data throttling Output Pulses Low when messages Ring indicator are waiting BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 34 0.8 V (max) 2.0 V (min) Output Voltage 0 – 3V 0.4 V (max) 2.5 V (min) Input Current 100 µA (max) 100 µA (max) Output Current 4 mA (max) 4 mA (min) Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 35 Analogue: 0V (min) Analogue: 3V (max) Output Voltage 0 – 3V 0.4 V (max) 2.5 V (min) Input Current 100 µA (max) 100 µA (max) Output Current 4 mA (max) 4 mA (min) BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 36: Led Indicators
Note: The LED’s may be disabled to minimise power consumption. All LED’s will flash on start-up and the Receive and Transmit LED’s will flash on power down regardless of the state of the LED disable control. Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 37 Input/ Output SPI_MISO LED Output Lines Equivalent Circuit LED Interface Electrical Characteristics Parameter Range High Output Voltage 0 – 3V 0.4 V (max) 2.5 V (min) Output Current 4 mA (max) 4 mA (min) BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 38 The Message waiting signal is held active low whenever there is at least one complete message waiting in the outbound buffers (including the reread buffer). In-Range The In Range signal is held active low whenever the modem is in RF reception range. Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 39: Selecting & Positioning The Antenna
You can design a portable device that can use an off-the-shelf, plug-in antenna, such as a ¼ wave monopole or ½ wave dipole antenna. Typical gain of these omni directional antennas is 0dBi and 2.14dBi, respectively. BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 40 VSWR < 2.0 or RL < -10dB (minimum) The power output of the Boomer-III OEM Modem is nominally 2W at the antenna port. The antenna gain or loss will affect the radiated value. Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 41 OET Bulletin 65 and Supplement C (June 2002) with respect to Specific Absorption Rate (SAR) requirements. The Boomer-III modem module operates on a packet data network which sets the timing of most aspects of the RF signalling protocol. BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 43 OEM integration into any final host/terminal product and is the responsibility of the OEM Integrator. The algorithm and preset Duty Cycle is recorded in the module firmware at the time of manufacture and cannot be altered by the end user. BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 44: Supplying Power
Wavenet recommends designing a robust power supply that can provide adequate power under non-ideal conditions such as an improperly matched antenna, where current can be up to 2.2A. Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 45 Refer to Appendix A - NCL Interface. All LEDs will flash on start-up and the Receive and Transmit LEDs will flash on power down regardless of the state of the LED disable control. BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 46 For instance, a dispatch application could have a message traffic model as follows: Messages transmitted in 8 hour day: 25 Average length of transmission: 120 bytes Messages received in 8 hour day: 10 Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 47 If the HCRESET signal is used, once it is de-asserted the modem CPU will be able to initialise. Once out of reset the first operation is the boot-up of the modem CPU. At this time CTS is momentarily asserted, then de-asserted. After a BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 48 This facility may be utilised to further reduce current consumption in battery powered applications, but note that the modem will need to re-register on the network after wake-up Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 49 The HCRESET signal is de-asserted. The internal modem reset is released to allow the modem boot up sequence. The modem exits the boot load state, is operational and is ready to communicate with the DTE. BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 50 The following diagram shows the sequence for these actions. Power-Down Timing Diagram HOSTPWR_ON Network Deregistration RF Protocol Requirement Modem software is Modem internal power control Operational Modem Internal Power Note: DSR and DCD are active low signals. Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 51 This represents the greatest number of packaging options. Exhibits a memory effect when not occasionally discharged below the lower extent of its operating voltage. The memory effect reduces the usable capacity of each battery cell. BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 52 Raw battery cells or battery packs can be purchased from suppliers. Li-ion Reasonably mature technology leaving lots of potential for increased capacity Higher energy density than either NiCad or NiMH Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 53 Adequate supply guard-band must be designed in to ensure that the modem and any other circuitry in the final product are not reset during transmissions. BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 54 The environmental requirements of the Boomer-III OEM Modem are as follows: Operating Temperature: -30° to +60°C Storage Temperature: -40° to +70°C Relative Humidity 0 to 95% non-condensing These limits should not be exceeded in the intended application. Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 56: Using The Modem Test Jig
From time to time updates may be provided for the Boomer-III test jig and these should be implemented as per the Update Notice. If you are unsure if your test jig incorporates all the latest updates please contact Wavenet Technology. Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 57: Exploring The Boomer-Iii Test Jig
10k Pull down to GND 10k Pull down to GND 10k Pull down to GND H-P-ON Turn the modem off Turn the modem on RESET Keep modem reset Keep modem in working status BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 58 Used to connect the Boomer-III’s antenna socket to the antenna connector. Antenna Connector Used to connect the external antenna. LEDs There are eight LEDs used to indicate the following: Power Low Battery In Range Message Waiting Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 59 3 RDW Header connector 52-pin Header Connector used for jumpers (supplied). Connector All the jumpers are connected as default. RESET H-P-ON MSGWTG INRANGE LOWBAT SSO/RX2 SS1/TX2 SS2/CTS2 SS3/RTS2 3.8V 3.8V 3.8V 3.8V BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 60: Initial Calibration
Lock Lever b. Ensure that the cable is inline with the connector and insert the FPC cable into the connector with the conducting surface of the cable facing downwards. FPC conductor side Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 61 You are now ready to communicate with the modem using the PC as a host/terminal. The modem should be able to talk to the PC by using Wavenet Commander software, or other NCL protocol software. BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 62: Software Development Tools
A directory structure containing a serial port sever. The serial port server runs as a service on your PC and allows multiple clients to access the modem via a serial port. Virtual Device Driver (VDD) Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 63: System Requirements
In Control Panel, choose Add/Remove Programs and then choose Add/Remove Windows Components. In the Windows Component Wizard, choose Message Queuing Services from the Components list. Click Next, and then follow the remaining steps. BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 64 VDD library this process message delivery is transparent for the client. Please refer to Appendix B – SDK NCL-API and Port Server and Appendix C – SDK Sample programs for additional information on the Boomer-III SDK contents. Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 65: Wavenet Commander
The executable file user_defined.def Definition file for User Scripts ncl_generic.def Default NCL Commands. Refer to Appendix A - NCL Interface for the NCL command list. A typical screen shot from Wavenet Commander is shown below. BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 66 Hot Key F6 or click on the connect icon in the toolbar. Choose the modem communications port when prompted and following view will be displayed. Note: The base station port is for Depot Test Mode, which is not available in the user version Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 67 Edit View Window. Note your modem must be registered on a channel. Status: Displays the modem’s RF-Protocol, channel, RSSI, In Range Status, Base Station ID the modem is registered on, and the modems power source level. BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 68 Pressing ‘?’ will display basic help. Hot Keys Wavenet Commander has the following Hot Keys. F4 Standard NCL command Selection. • F5 User NCL Command Selection • F6 Communication port configuration. • Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 69: Wavenet Application Loader
408 is software version 4.08 and 233 is software version 2.33 If you select the incorrect Apploader file for your modem the following typical message will be displayed. BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 70 11. After the application has been updated, the modem is automatically switched off. A message is displayed prompting you to switch the modem on again. 12. Click and the download window will read the modems application version and redisplay it. Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 71: Troubleshooting
This message will appear if the modem is disconnected whilst running the Application Loader. Ensure that all the connections between the PC and the modem are secure, check the battery connections and ensure the modem is switched on. BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 72 Application Loader file. The letter preceding the three numerical characters at the end of the Application loader file name denotes which modem the file is appropriate for, i.e. BM3 for the Boomer-III OEM modem. Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 74: Integration Testing
3V CMOS levels and the 12V RS-232 levels generally found on PCs. Specific Tests In addition to the various tests that exercise your own circuitry, such as power-on self-test, design tests that ensure proper interaction between Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 75: Desense And Emi
For this test, you provide an integrated product, including antenna, power supply and any peripherals. Wavenet Technology then produces a test graph that reports the amount of desense. All desense testing is generally performed at Wavenet Technology’s facilities.
Page 76: Regulatory Compliance
74). Wavenet provides the ability to key and dekey the radio at the required frequencies and modulation levels from an external PC via the pass-through mode. For further information about regulatory compliance, refer to “Regulatory Requirements” on page 19. Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 77: Application Software
It is very time consuming and expensive to send products to service, especially if the problem is caused by a temporary network or Enterprise Server Application outage. For this reason, you should design the application to allow for end-user problem determination. BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 78: Oem Service Depot Repair
If the modem has been determined to be faulty it should be returned to the place of purchase for inspection and repair. Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 80: Appendix A - Ncl Interface
Get mode of notification to the DTE for received SDUs. R_RX_STATUS ASCII b Get receiver enable status. R_TX_STATUS ASCII c Get transmitter enable status. R_ANTENNA ASCII d Get antenna selection status. R_RADIO_IN_RANGE ASCII e Get radio in range status. Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 81 ASCII C S_TX_CONTROL ASCII B S_POWER_SAVE ASCII I Set the Power Save mode. S_ROAM_MODE ASCII J Set the roaming mode: ROAM_ Set to manual. ASCII 0 MANUAL ROAM_AUTO Set to automatic. ASCII 1 BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 82 RF out of range. RX_PWR_SAVE_ ASCII 3 Power saving enabled. ENABLED RX_PWR_SAVE_ ASCII 4 Power saving disabled. DISABLED RX_ACTIVE ASCII 5 Device in active state on RF channel. CHAN_DISALLOWED ASCII 6 Device disallowed on Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 83 Cannot execute command due to pending inbound messages. SW_ERROR ASCII N Software error. OUT_OF_RANGE ASCII O RF not in range. PACKET_ERROR ASCII Z SDU data corruption. True only if confirmed delivery mode enabled. BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 84 P..Y, 1..9 SYNTAX ASCII 3 Command SDU syntax error. Note the following error codes: INVALID ASCII b Invalid options. TOO_LONG ASCII c Data is too long. VENDOR ASCII Z ASCII Z Vendor-specific response. Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 85: Wavenet Specific Ncl Extensions
WN_GET_STATUS Command Syntax (NCL string “ZF?…”): Status CMND Length SDU Tag VENDOR ‘F’ ‘?’ Request ‘Z’ WN_GET_STATUS VEND_ WAVENET WN_GET_STATUS Response Syntax: Response RESP Length SDU Tag VENDOR ‘F’ ‘1’ data ... SUCCESS VEND_WAVENET BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 86 Hz for the channel the modem is currently scanning or locked on to. Current channel: Unsigned word (2 bytes) representing current channel. Current Base Station ID: Unsigned byte representing current base station ID. Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 89 ASCII characters. The tenth character is typically a null termination character. Generic set RPM Configuration command type 1 (WN_SET_PARAM): This command allows the DTE to set the configuration settings of certain aspects of the modem. BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 90 WN_SET_PARAM: Set Modem Configuration (NCL string “ZF^[2 byte parameter number][2 Byte parameter length][parameter block..]”). Parameter name : WN_PWR_SAVE_MODE Parameter number : 0x7000 (“Byte1Byte2”) (ASCII 0x70 = ‘p’) Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 91 (ASCII 0x6E = ‘n’) Parameter length : 0x0002 (“Byte3Byte4”) Parameter contents: One unsigned word (2 bytes) containing the number of milliseconds between message notifications to the Palm. The maximum setting is 65 seconds (65000 milliseconds). BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 92 This mode allows the modem to conserve about a milliamp of current, and is particularly suited for applications where the modem LEDs are not visible to the user. Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 93 WN_ PROFILE Get list of profiles from modem (NCL string “ZF$f\00” with “\00” representing one byte with value of zero). SUCCESS is followed by a block of information in the format shown below: BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 94 0x7000 (eg NCL cmd ZF$\70\00 = ZF$p\00) WN_PROFILE 0x6600 (eg NCL cmd ZF$\66\00 = ZF$f\00) WN_MSG_RX_NOTIF_TMR 0x6E00 (eg NCL cmd ZF$\6E\00 = ZF$n\00) WN_CMD ASCII '*' (eg NCL commands ZF*..) WN_LEDS_OFF 0x45 (eg NCL cmd ZF5F\45\00\00) Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 96: Appendix B - Sdk Ncl-Api And Port Server
Wavenet NCL API Model Logical Architecture The following table lists the required functionality for the API per layer. The code forms a DLL, with only a subset of functions available for third party developers. Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 97 NCL Interpreter The NCL Interpreter strips NCL API function calls from application messages, queue the calls and execute the calls on a FIFO basis. Received messages will be queued and matched against an appropriate BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 98 API calls. Prototype: int VDDOpen(void) Description: Opens a session with the VDD. Input: none Output: Return value = 0 Operation was successful Return value ≠ 0 Operation failed. Value specifies the error type Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 99 RX queue for that session. The application is responsible for reading and processing the response on the RX queue. By calling ‘nclReceiveData()’. Description: Send application data to the radio host identified by the host ID. BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 100 SDU tag equal to 65535. The received event/ response messages will be represented as an array of bytes which must be typed cast to a structure identified by returned structure ID. Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 101 Size (in bytes) of the data in ucBuf. Note: Buffer lengths of 0 is possible – rely solely on the return value in such cases ucBuf Pointer to buffer containing the received data BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 102 }NCLProdId; /* NCL version structure */ typedef struct NCLVersion char major[2]; char minor[2]; }NCLVersion; /* RPM ID structure */ typedef struct NCLRpmId BYTE b_val[4]; }NCLRpmId; /* Config block structure */ typedef struct NCLConfigBlock Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 103 /* Channel Table */ typedef struct NCLChannelTable WORD channel[NCL_NUM_CHANNELS]; BYTE num; }NCLChannelTable; /* Vendor Spesific: Wavenet Get Settings*/ typedef struct NCLWaveSettings { BYTE LLI[4]; BYTE SerNum[16]; } NCLWaveSettings; /* Vendor Spesific: Wavenet Get Radio Settings*/ BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 104 }NCLStatus; /* Event Type */ typedef struct NCLEventType BYTE etype; /* NCL_RCV_MSG_DATA Received message data /* NCL_MSG_NOTIFICATION ‘B’ Received Message notification /* NCL_TX_EVENT Transmitter event /* NCL_RX_EVENT Receiver event /* NCL_HW_EVENT Hardware event Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 105 Get software version number NCL_R_RPM_ID NCLRpmId Get RPM address NCL_R_RPM_VID NCLStatus.rpm_vid[2] Get RPM VID address (MDC) NCL_R_MAX_DATA_SIZE NCLStatus.max_data_size Get SDU data limit NCL_R_RCV_MODE NCLStatus.rcv_mode Get mode of notification to DTE f d SDU BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 106 Command the RPM to send the requested status information. Input: usSduTag Pointer to a word where the SDU tag can be stored ucVendor Vendor identifier. Use: NCL_NO_VEND = 0 if not vendor specific or NCL_VEND_WAVENET = ’F’ for Wavenet Technology specific Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 107 The type of status information to retrieve from the RPM (Used by Vendor specific requests). Set to zero for non-vendor requests or WN_GET_STATUS = ‘?’ for Wavenet Technology specific requests ucRequest The requested status information, as listed in one of the appropriate tables above, to retrieve from the RPM.
Page 108 RX queues (that have NCL_RCV_MSG_DATA enabled) using the NCLRXDataID structure type. Prototype: int nclSetEvent (word *usSduTag, byte ucType, byte ucSetting); Description: Enable / Disable event reporting by the RPM for the specified event type. Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 109 NCL API: An error occurred creating a MSMQ NCL_ERR_MSMQ_DELETE NCL API: An error occurred deleting a MSMQ NCL_ERR_MSMQ_NAME NCL API: An error occurred searching for a MSMQ NCL_ERR_MAX_CLIENTS NCL API: Maximum number of supported clients reached BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 110 Return a pointer to a character string describing the specified error code. Input: iErrorCode Integer specifying the error code for which a string description is required. Output: WCHAR * Pointer to a NULL terminated wide character (Unicode) string describing the error Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 111 Return value ≠ 0 Operation failed. Value specifies the error type Deregister Wakeup Application The application can call this function to deregister an application that was previously registered to wakeup. Prototype: int nclDeregWakeupApp (WCHAR *usAppName); BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 112 Operation failed. Value specifies the error type Send Generic NCL Command To RPM The application can call this function to send application specific commands to the RPM. Prototype: int nclSendGenericCommand (WORD *usSduTag, BYTE ucLength, BYTE *ucParam); Description: Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 113 Return value ≠ 0 Operation failed. Value specifies the error type usVersion The upper 8 bits contain the major version and the lower 8 bits contain the minor software version if the return value is zero BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 114: Appendix C - Sdk Sample Programs
The Settings tab displays the modems current profile (i.e. Channel list, RD-LAP version, etc), whether the modem is on or off, the modems power save mode, and (if supported), its vibrator mode. Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 115 RSSI level. If the device is not registered, it will be in scan mode, scanning the channels from the channel list in its current profile. The Versions tab displays the devices LLI, serial number, hardware platform and software version. BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 116 The Messages tab allows a user to send and receive messages from the channel the device is currently registered on. The About tab displays the version number of ModemInfo, copyright information, and the web address of Wavenet Technology. Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 118: Appendix D - Application Development
Anticipate the user will move between IN_RANGE and OUT_OF_RANGE conditions. This means you need to provide: • A user indicator that identifies the current operating status. • Recovery mechanisms when application transactions fail as a result of losing network contact. Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 119: Roaming Issues
If network contact is not established using either list, this sequence is repeated after a delay interval. See “Conserve battery life when out of range” below. BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 120 This preferred-channel pre-roam algorithm is performed at intervals that increase exponentially and with identical reset conditions. See “Conserve battery life when out-of-range” above. Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 121 SDU. Note: This could be the result of transmitting a Receiver Disable command to the wireless modem. This command requires both Receiver Enable and Transmitter Enable commands to recover two- way communications. BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 122 Under such circumstances, the wireless modem seeks a preferred alternate channel, as previously described. Usually this situation does not produce notification of network contact and reacquisition. Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 123: Power Management
On/Off upon User Demand To extend battery life, design the application to switch the modem on and off as the usage need arises. This method is especially effective for session-based, user-initiated applications. BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 124 Power Save protocol device takes longer to respond to changes in the RF environment. The infrequent worst case latency in responding to external stimuli (resulting in either a location update or Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 125: Wireless Data Systems Considerations
Large Message Transfer Message size is a key factor affecting response times in wireless data systems. To efficiently accommodate typical data applications, the BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 128: Appendix E - Message Routing And Migration
PVC and SVC host connection line types. X.25 is a popular choice for developers looking for a worldwide connectivity solution. Other supported protocols include: DataTAC 4000 system X.25, TCP/IP, LU6.2, leased line, dial-up, RF-Loopback DataTAC 5000 system X.25, TCP/IP, SLIP DataTAC 6000 system X.25 Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 129: Standard Context Routing (Scr)
Provide a delivery status of messages. Hold messages on the network for a later delivery. Discard messages. This header and instruction information is the basis of the SCR protocol. BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 130: Datatac Messaging (Dm)
Windows 2000, Windows 95, Windows NT, or Windows CE. Special Text Formatting The display of dates, numbers, and monetary values varies among locales. Support for these differences may be provided by your Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 131 (Be sure to get advanced approval from the local operator to run your test version without it being validated.) In this case, the target network will not be tested directly and more verification testing will be required. BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 132: Appendix F - Guide To Desense
Wanted and Unwanted Signal Levels Amplitude Wanted Signal Level Unwanted Signal Level Frequency Fc = Radio Receiver Channel Frequency Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 133: Noise Sources
The receiver is susceptible to being desensed within the channel bandwidth and at intermediate frequencies used for down conversion. Excessive noise on power supply pins can also create sensitivity problems. Measurement Techniques Desense can be measured in one of the following ways: BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 134: Alternate Measurement Method
The gain on the LNA will make low-level noise more visible. Ensure that the spectrum analyser’s input is not Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 135: Methods Of Controlling Emissions
The shield approach appears to be a big step at first. The advantage is that the shield will minimise the possible redesign required of the host/terminal PCB platform and circuitry. For a thorough discussion of shielded enclosure design, an excellent reference is Electromagnetic Compatibility: Principles and BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 136 This is an inexpensive way of solving the problem, as no special shielding or decoupling is required. The limitations of the clock pulling method are: Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 137: Rf Network Issues
“self-desense”, other machines in the user’s environment can still impact radio performance. These machines are not usually within close proximity of the wireless modem antenna, and have less effect. An FCC Class B radiator can impact the wireless BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 138: Antenna
Cabling for other peripherals must not interfere with this region. Desense Summary Desense considerations fall into two categories when using a wireless device and computer as a system: The impact of the host/terminal EMI on system performance Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 139 Since each product is unique. The level of noise is very difficult to predict, as is the amount of effort needed to control it. Measuring the product in an early engineering phase is key to managing the situation. BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 140: Appendix G - Numeric Conversion Chart
01110000 00110001 01110001 00110010 01110010 00110011 01110011 00110100 01110100 00110101 01110101 00110110 01110110 00110111 01110111 00111000 01111000 00111001 01111001 00111010 01111010 00111011 01111011 00111100 < 01111100 00111101 01111101 00111110 > 01111110 00111111 01111111 Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 142: Appendix H - Specifications
(Add 1.2 mA if LED’s enabled) Off current consumption 100 µA (nominal) Transmit Duration 32 ms (minimum) 7 seconds RD-LAP (maximum) 30% (maximum) Duty Cycle Power Supply Ripple < 15 mV peak to peak Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 143 < -116dBm at 5% PER MDC Spurious emission (receive mode) < -57dBm Channel selectivity > 50dB (5kHz dev 1kHz tone) Spurious rejection > 70dB Image rejection > 60dB RSSI Reading -120dBm ~ -45dBm BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 144: Appendix I - Glossary
File name suffix for modem configuration files Erasable, programmable, read-only memory EPROM Effective radiated power Electrostatic discharge Electronic serial number Federal Communications Commission (U.S.) Field effect transistor First in, first out FIFO Fixed network equipment Flexible printed circuit Copyright Wavenet Technology © October 2003 BM310012WT04...
Page 145 Personal Computer Memory Card International Association PCMCIA Personal data assistant Packet data unit Personal information communicator Phase-locked loop Part number Packet modem integration test PMIT POST Power-on self test Parts per million Quad flat pack BM310012WT04 Copyright Wavenet Technology © October 2003...
Page 146 Voltage common collector Voltage controlled oscillator Voltage direct drain Voltage peak to peak VSWR Voltage standing-wave ratio Wireless Data Group (Motorola) Wireline Communications over a direct, physical link Execute in place Zero insertion force Copyright Wavenet Technology © October 2003 BM310012WT04...