Wavenet Technology BM3-800D User Manual Download Page 1

Page: 1 / 146

User Manual

and

Integrator’s Guide

Boomer-III DataTAC

OEM Modem Module:

BM3-800D

Revision 0.4

October 2003

Summary of Contents for BM3-800D

Page 1: ...User Manual and Integrator s Guide Boomer III DataTAC OEM Modem Module BM3 800D Revision 0 4 October 2003 ...

Page 2: ...poration in the United States and other countries Other product and company names herein may be the trademarks of their respective owners Whilst every precaution has been taken in the preparation of this document neither Wavenet Technology Pty Ltd nor any of its representatives shall have any liability to any person or entity with respect to any liability loss or damage caused or alleged to be cau...

Page 3: ... Test and Approve the Product 16 Environmental Issues 17 Regulatory Requirements 19 Installing the Modem 25 Mounting the Boomer III OEM Modem to Your Device 26 Connecting the Data Interface Port 27 Selecting Positioning the Antenna 39 Supplying Power 44 Using the Modem Test Jig 56 Features 56 Exploring the Boomer III Test Jig 57 Initial Calibration 60 Fitting the Boomer III Modem 60 Software Devel...

Page 4: ...velopment 118 Roaming Issues 119 Power Management 123 Wireless Data Systems Considerations 125 Appendix E Message Routing and Migration 128 Standard Context Routing SCR 129 DataTAC Messaging DM 130 Other Development Issues 130 Appendix F Guide to Desense 132 Noise Sources 133 Receiver Susceptibilities 133 Measurement Techniques 133 Alternate Measurement Method 134 Methods of Controlling Emissions ...

Page 5: ...hin an area of coverage the modem performs auto roaming auto scanning channel selection and registration on a new channel The modem operates in either battery save or non battery save modes as instructed by the network and overridden by the host terminal The modem determines which RF protocol to use based on the attributes specified by the configured channel list and dynamic channel information fr...

Page 6: ...rporated into a variety of package formats The Boomer III OEM Modem has the following features Up to three UART Serial communications interface ports and one SPI port On Board Real Time Clock with battery back input option Indicator lights showing power supply and data status Five configurable multiple function digital analogue inputs or five digital output lines for external control monitoring So...

Page 7: ...technology Many machines already transmit usage and refill requirements to company head offices via standard telephone lines Radio modems allow vending machines to be placed in areas with poor access to telecommunications infrastructure providing a cost effective alternative to installing new telephone lines On refilling only the required refills will be despatched to the required sites maximising...

Page 8: ...s necessary to get an evaluation and development platform up and running in the shortest possible time The kit contains the following components Evaluation Board for interface to a PC for testing Boomer III Modem Test Jig Power cable for connection to a variable power supply 800 MHz blue tip antenna Antenna cable PC Serial interface cable 5 sample FPC strips for prototyping purposes 5 sample FPC c...

Page 9: ...C rules Wavenet has obtained certificates of Technical Acceptability for use in Canada in accordance with the Radio Standards Procedure RSP 100 and Radio Standards Specification RSS119 Issue 3 This equipment generates uses and can radiate radio frequency energy and if not installed and used in accordance with the manufacturer s instructions may cause interference harmful to radio communications Th...

Page 10: ...ur car such as electronic fuel injection systems electronic anti skid braking systems and electronic cruise control systems may affect the operation of these systems which should be verified before use in the applications Do not place the modem on an unstable surface It may fall and damage the equipment Never push objects of any kind into the modem through openings as they may short out parts that...

Page 11: ...r field returns Because wireless data communication technologies are usually described using a unique variety of jargon buzzwords and technical details it is sometimes hard to know where to start You may also have difficulty evaluating this technical information when you find it As an OEM integrator you must accurately choose where and how a wireless technology will facilitate communication for yo...

Page 12: ...ate the message model determine how much and how often data will be sent in each of the uplink terminal to network and downlink network to terminal directions Answer the question Is there a requirement for the terminal to be on and able to receive 8 hours a day or does the user turn the unit on only when making a query to the Enterprise Server Application The answer has a direct bearing on the bat...

Page 13: ...ry end of line test or while at the user s site For your product to allow integrated testing of the modem you are required to provide modem pass through mode and utilise Wavenet Commander software See End User Problem Resolution on page 77 Without pass through the modem must be mounted on the evaluation board for diagnostics and troubleshooting Pass through mode also allows for modem software upgr...

Page 14: ...roblem remotely Often the best approach is to incorporate progressively deeper loop back tests to determine the point at which the communication link fails As stated elsewhere you need to make this remote diagnostic functionality be part of your standard software load End User Support You have two choices in dealing with an integrated modem that needs to be swapped out and returned for service Dec...

Page 15: ... on the power lines and the ability to supply sufficient instantaneous current to allow proper operation of the transmitter Also ensure that the power supply can accommodate the highest power consumption under transmit conditions and that the voltage does not fall below the minimum levels at the modem terminals Remember voltage drops can occur in the interconnectivity wiring and this must be kept ...

Page 16: ... use a gateway to allow connection to the Internet or other external networks See Air Interface Protocols on page 22 Develop End to End Applications Software In addition to coding the product specific features for your application you are urged to incorporate RF specific reporting and monitoring features such as received signal strength RSSI channel quality and in range out of range conditions Man...

Page 17: ... to the modem are made correctly Testing on a network is not required See Final Assembly on page 77 and End User Problem Resolution on page 77 Install and Field Test the Product When the product is shipped to a site it is installed or mounted in a particular location one that might restrict RF communications The service question is whether the behaviour of a dysfunctional product is caused by poor...

Page 18: ...n servicing host terminal devices Always wear a conductive wrist strap Eliminate static generators plastics Styrofoam and so on in the work area Remove nylon or polyester jackets roll up long sleeves and remove or tie back loose hanging neckties Store and transport all static sensitive components in ESD protective containers Disconnect all power from the unit before ESD sensitive components are re...

Page 19: ... applicable BM3 800D 4062A BM3800D Canada Industry Canada IC RSS119 Radio Performance BM3 800D PQS BM3800D United States of America Federal Communications Commission FCC FCC CFR Title 47 Part 15 Conducted and Emitted Radiation Class B FCC Part 90 Radio Performance Full Product Certification As the integrator you must determine what additional specific regulatory requirements are required for the c...

Page 20: ...r III OEM modem module is a subassembly of xxx and has FCC Identifier PQS BM3800D FCC Part 2 certification requires all integrated products to have routine environmental evaluation for radio frequency RF exposure prior to equipment authorization or use in accordance with FCC rules 2 1091 and 2 1093 and FCC Guidelines for Human Exposure to Radio Frequency Electromagnetic Fields OET Bulletin 65 and ...

Page 21: ...statement in user documentation Regulatory Notice of Compliance This equipment has been tested and found to comply within the limits for a Class B digital device pursuant to Part 15 of the FCC Rules These limits are designed to provide reasonable protection against harmful interference in a residential installation This equipment generates uses and can radiate radio frequency energy and if not ins...

Page 22: ...em and you add an antenna externally to your host terminal you are not required to make a formal application to Industry Canada because Boomer III OEM modems continue to be covered under the original Radio Equipment Certificate of Type Approval Most of the tests required for FCC applications can be used for Industry Canada applications IC requires additional tests which distinguishes their certifi...

Page 23: ... channel Battery save operation Power Save protocol is supported within most DataTAC networks RD LAP Network Operation The RD LAP 9600 and 19200 protocols are used by DataTAC 4000 and 5000 networks The modem supports both continuously keyed multiple channel MFR and intermittently keyed SFR single frequency reuse network configurations depending on the network type The RD LAP protocol specification...

Page 24: ...Integrator s Task ___________________________________________ Boomer III User Manual Integrator s Guide Copyright Wavenet Technology October 2003 24 BM310012WT04 ...

Page 25: ...on handheld designs produce the most hostile environment for an integrated modem A handheld device such as a portable terminal is typically battery powered subjected to temperature extremes and designed to be physically robust When designing portable devices you must consider the following issues DC power noise levels on the host terminal interface Minimum operating voltage levels Shutdown procedu...

Page 26: ...nsure the modem is not subjected to DC voltages exceeding specifications This could create costly damage to the RF section of the modem Adhere to the power supply noise specifications in your design Antenna The antenna must be mounted like any other cellular or land mobile radio antenna Usually the vehicle roof provides a good ground plane unless it is fabricated of non metallic material such as f...

Page 27: ...emoved probed and functionally tested The modem has M2 5 mounting holes in each corner The mounting hole pattern is shown below Connecting the Data Interface Port There are two connectors to interface the Boomer III OEM Modem with your device RF Connector described in the next section and Data Interface Port The data interface port is used to interface the modem to a serial computing device and a ...

Page 28: ...ator s Guide Copyright Wavenet Technology October 2003 28 BM310012WT04 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 20 4mm 14 5mm 14 5mm ...

Page 29: ...Low Battery Output High Impedance 16 SS0 RXD2 Status Signal 0 Bi directional 100k pull up to 3V 17 SS1 TXD2 AD1 Status Signal 1 Bi directional 100k pull up to 3V 18 SS2 RXD3 AD2 Status Signal 2 Bi directional 100k pull up to 3V 19 SS3 TXD3 AD3 Status Signal 3 Bi directional 100k pull up to 3V 20 HOST 3 8V Supply Voltage Supply 3 4 4 2V 21 HOST 3 8V Supply Voltage Supply 3 4 4 2V 22 HOST 3 8V Suppl...

Page 30: ...high input signal The Boomer III modem is fitted with a Real Time Clock that third party applications may utilise to wake up the modem at a pre programmed alarm time This facility may be utilised to further reduce current consumption in battery powered applications but note that the modem may need to re register on the network after wake up The electrical interface specification and equivalent cir...

Page 31: ...kup RTC_BB pin is an optional input to maintain the clock settings time and date in the event the main power to the modem is removed If used this input must be connected to a stable voltage supply such as a suitable alkaline cell that does not exceed the maximum input voltage specifications If not required this input can be left disconnected and the RTC will be powered internally The electrical in...

Page 32: ...a 6 8kΩ series resistor for input protection Internally it is passively pulled high after the series resistor to the supply rail 3V and is asserted with an actively driven low signal to ground The electrical interface specification and equivalent circuit is as follows Reset Input Equivalent Circuit Reset Electrical Characteristics Parameter Range Reset Active Reset Inactive Input Voltage 0 3V OR 0...

Page 33: ...ork dependant The data format is generally 8 data bits no parity 1 stop bit unless otherwise specified The serial interface lines RXD TXD DCD DTR DSR RTS CTS RI are 3V logic compatible They are fitted with a 33Ω series resistor for protection The electrical interface capability equivalent circuit and operation of these lines is summarized below Serial Communications Interface Definitions J1 Pin Si...

Page 34: ...venet Technology October 2003 34 BM310012WT04 Serial Communications Equivalent Circuits Serial Communications Electrical Characteristics Parameter Range Low High Input Voltage 0 3V OR 0 5V 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 ...

Page 35: ...Status line has a 100kΩ resistor to define default input status and a 33Ω series resistor for protection The electrical interface capability equivalent circuit and operation of these lines is summarized in the tables below Status Signal Interface Definitions J1 Pin Signal Description Digital Capability Alternate Function Other 16 SS0 Status Signal 0 Input Output RXD2 17 SS1 Status Signal 1 Input O...

Page 36: ...rough windows in the case of the modem and are defined as below Position of On Board LED Indicators On Board LED Indicator Definitions Operating Mode LED Indicator Colour Off On Flashing POWER Green Power off Power normal and locked on channel Power normal and scanning channels TRANSMIT DATA Red No activity N a Data Transmitted RECEIVE DATA Green No activity N a Data Received Note The LED s may be...

Page 37: ...nal refer to Status Signals section previously Each LED output line has a 33Ω series resistor for protection It is recommended a series resistor be used with the external LED to limit current accordingly The electrical interface capability equivalent circuit and operation of these lines is summarized in the tables below LED Output Interface Definitions J1 Pin Signal Description Digital Capability ...

Page 38: ...al is held active low whenever the supply voltage drops below an acceptable level and deactivated when the voltage level becomes acceptable again The transitions will occur at the same time as the low battery event occurs or would occur if the event was activated Note that in the case of a very fast transition between voltages it may take up to 20 seconds for the modem to confirm a change in batte...

Page 39: ...es exist that can affect the transmission path In this case it would be preferable to use a vertically polarized omni directional antenna Antennas for portable devices include the following designs Internal antenna invisible or pull up An internal antenna must provide a gain sufficient to meet network specifications Cable routing from the modem to the antenna needs to avoid RF sensitive circuits a...

Page 40: ...B Fixed Devices Fixed data device applications use the same design recommendations as a portable device with a remote antenna As for the RF connector of an external antenna whether it is a plug in type or a remote type the most economical and practical choice is a TNC threaded connector TNC has a good frequency response to 7GHz and leakage is low A mini UHF threaded connector provides adequate per...

Page 41: ...y polarised radio frequency transmission The antenna should be located as far from the active electronics of the computing device as possible Typically a metal case of a computing device and its internal components may attenuate the signal in certain directions This is undesirable as the sensitivity and transmit performance of the Boomer III would be reduced However careful use of metal used for t...

Page 42: ... averaging function has been incorporated in the Boomer III modem firmware This function limits the transmit duty cycle by controlling the timing of when transmit transactions are initiated and the delay period between them When a data transmission occurs the actual transmit time is recorded Subsequent data transmissions are inhibited until a delay period idle time has elapsed to ensure the averag...

Page 43: ... Duty Cycle limitation of 30 maximum to physically protect the modem hardware The default Duty Cycle preset in the factory at the time of manufacture is 10 Other duty factors and SAR evaluation must be addressed at the time of 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 a...

Page 44: ...Add 1 2mA if LED s enabled Off current consumption TBD µA nominal Power Supply Ripple 15mV peak to peak Design Considerations The power supply is one of the key issues of design of wireless terminals Due to the burst nature of transmit periods the power supply must be able to deliver high current peaks for short periods of 32ms to a maximum of 7 seconds RD LAP 9600 bps or for 20 seconds MDC 4800 b...

Page 45: ...st terminal must provide a continuous supply The modem is fully compliant with the DataTAC Power Save Management system The modem exists in the lowest power state possible while still providing uninterrupted service By de asserting the HOSTPWR_ON signal the modem disconnects from the network then enters a near zero power state The modem resets if the power source is cycled This can cause network s...

Page 46: ...nd the network configuration of the Power Save protocol For example the following numbers present a typical profile for the Boomer III modem based on reasonably heavy usage and assuming a 3 8V supply current Power Save Mode Maximum 80 Sleep 4 4 mA typical 19 9 Receive 76 mA typical 0 1 Transmit 1 6A typical The actual percentage of total time spent in each state transmit receive sleep is a functio...

Page 47: ...the modem through the Data Interface Connector The host terminal turns the modem ON by asserting the HOSTPWR_ON signal The host terminal may request the modem to turn OFF by de asserting the HOSTPWR _ON or by sending a specific NCL command across the serial interface For the modem to turn OFF after an NCL request the HOSTPWR_ON signal must be de asserted ESD protection is provided on all power sup...

Page 48: ... performs the initialisation protocols for both the NCL DTE interface and the RF network After successfully initialising the NCL DTE interface the modem asserts CTS After the network ACK of the registration sequence DCD is asserted The Boomer III modem is fitted with a Real Time Clock that third party applications may utilise to wake up the modem at a pre programmed alarm time prior to turning the...

Page 49: ... The HOSTPWR_ON signal is asserted to turn on the modem 3 The HCRESET signal is de asserted 4 The internal modem reset is released to allow the modem boot up sequence 5 The modem exits the boot load state is operational and is ready to communicate with the DTE Modem Internal Power Modem Internal Reset CTS DSR DCD LED s 300 ms Initialisation 4 5 Boot Stage Modem is now software controlled Modem is ...

Page 50: ...aves the modem configuration and network channel information The modem then de asserts the DSR line signalling the modem is no longer in a ready state This process can take a few seconds to complete At this point the host terminal can remove the power from the modem and still maintain most of the modem settings and last registered network channel The modem can be left with power applied and HOSTPW...

Page 51: ...oomer III OEM Modem may be powered by batteries if used with a handheld device For battery operated devices battery selection is a critical decision requiring consideration of many factors These include cell size internal impedance charging requirements and susceptibility to common battery phenomena such as memory effect or overcharging Each of these factors is discussed in detail in this section ...

Page 52: ...ergy density over the next five years Higher energy density than NiCad but lower than Li ion Available in standard sizes AA 2 3A 4 5A A and 4 3A and some prismatic rectangular configurations Exhibits the memory effect in a manner similar to NiCad technology but at a less pronounced level Internal impedance of 35 49µΩ per 1 2V cell Typical cell voltages are 1 2V with multiple cells used to obtain h...

Page 53: ...attery technologies consider the following characteristics of OEM devices incorporating wireless data modems Current drain is not constant Typically battery manufacturers specify the battery discharge profiles by assuming a constant current drain model In a wireless data system the constant current drain model no longer applies There are three levels of current drain contributions that can be expe...

Page 54: ...charging Plug in Supplies A mains plug in supply must be designed to ensure that voltage spikes lightening and other power fluctuations cannot damage the Boomer III Transient voltage protection zener diodes or other spike arrestor circuits may be added to keep the inputs within the power requirements mentioned previously These should have a value of 20V and be placed on the supply side of the regu...

Page 55: ...Boomer III User Manual Integrator s Guide_________________________________________________Installation BM310012WT04 55 Copyright Wavenet Technology October 2003 ...

Page 56: ...Serial Communication interface ports with DB9 connectors Through the SPY MODEM connector you can monitor the data transmitted from the modem RX DSR and CTS Through the PORT 2 SPY PC connector you can monitor the data transmitted from the PC TX RTS and DTR or talk to the second serial port of the modem You can make this choice by putting all five jumper links on the right or left side of the RDW he...

Page 57: ... Always leave this switch in the ON position ON 3 SS3 3V 10k Pull down to GND OFF 4 SS2 3V 10k Pull down to GND OFF 5 SS1 3V 10k Pull down to GND OFF 6 SS0 3V 10k Pull down to GND OFF 7 H P ON Turn the modem off Turn the modem on OFF 8 RESET Keep modem reset Keep modem in working status OFF On Off Switch DC Jack Input Supply Port 2 SPY PC Interface DB9 Connector 8 way DIP switch On board LED indic...

Page 58: ...ser program such as spy exe can be used to view the data A communication program such as HyperTerminal can be of limited use if the data spied upon contains a lot of alpha numeric ASCII characters Host PC Connector DB9 connector used to connect serial port 1 of 2 of the modem to the DTE The default values for this RS 232 connection is 9600bps 8 bits no parity 1 stop bit This port can also be used ...

Page 59: ... Warning Must use a high impedance monitor 100kΩ 3 RDW Header Connector Connectors used for jumpers supplied For Port 2 use all the jumpers are positioned from the centre column to the left hand column For Spy PC use all the jumpers are positioned from the centre column to the right hand column 52 pin Header Connector Connector used for jumpers supplied All the jumpers are connected as default 1 D...

Page 60: ...ound 2 Adjust the trim pot marked ADJ VCC to make sure the voltage on the test pin next to the ADJ VCC is 3V 3 Keep all of the switches on the dipswitch in the off position except DIP switch 2 for normal modem operation Fitting the Boomer III Modem With the power off 1 Connect the Boomer III OEM modem to the lower FPC connector on the test jig using a 30 way FPC cable Use the following procedure t...

Page 61: ... Remove the cable after the lock is released 2 Install an antenna to the modem Use either the on board SMA connection and an adapter cable between the modem MMCX connector and the test jig SMA connector or connect directly to the modem itself 3 Connect the PC serial cable to the DB9 connector marked PC 4 After making sure the power supply is set with the operating voltage range of the modem switch...

Page 62: ...er III OEM modem This manual Wavenet Commander software Wavenet Commander is a modem application development and diagnostic communications tool that runs on a Windows PC and allows communication with the modem via the Boomer III Test Jig It provides a means for users to become familiar with the modem and uses NCL protocol to communicate with the modem NCL Application Interface API The NCL API is t...

Page 63: ...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 Wavenet Commander will run on Windows 98 and later revisions however the PortServer and ModemInfo requires the Microsoft Message Queue MSMQ service running on the target PC MSMQ is included in Windows NT4 Windows 2000 and Windows XP MSMQ is not available for ...

Page 64: ... If no command line parameter is specified PortServer assumes that com1 is desired Start the server application by running PortServer exe If com2 is connected to the modem run the server as following PortServer com2 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 VDD Library The VDD libra...

Page 65: ...98 NT or 2000 Wavenet Commander interfaces with the Boomer III OEM Modem via a PC s communications port and the Test Jig s PC port using an RS 232 cable Wavenet Commander is issued as an install shield and will create the following files in the user designated installation directory WC_End_User wcu The executable file user_defined def Definition file for User Scripts ncl_generic def Default NCL Co...

Page 66: ...property pages as selected by the quick link in the tree view Lower Left TTY Control View TTY setting control allowing users to choose what kind of information they want to see in the Lower Right hand quadrant Allows the user clear the window Issue User defined and standard NCL commands Lower Right Edit View Edit view displaying raw and or interpreted data flowing between the modem and the PC On s...

Page 67: ...if registered and its 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 Modem Info Property View The property view is dependant on the tree view The following property pages are displayed for each tree view Settings The user can select the network profile and if required the modems power save mode Network Profile T...

Page 68: ...uired Allows the user to run a user defined NCL command by selection of the User CMD button The user can modify the user_defined def file using an external editor as required Details on how to generate a user command are contained in the def file Clear the Edit View screen by selection of the Clear Screen Button Edit View The Edit View displays the commands issued to the modem and the modems respo...

Page 69: ...modem and if necessary to upload the modem application 1 Connect the Boomer III to the Test Jig as described on page 22 2 Connect the Data Communications Modem connector to the Boomer III Test Jig s PC connector 3 Connect the Data Communications PC connector to a COM serial port on your computer Note that the Data Comms PC connector is a 9 pin plug If your computer has a 25 pin serial port you wil...

Page 70: ...the version of Application you are attempting to install is earlier than the version currently installed the Download Application button will remain disabled A message is displayed in the status bar advising that the application software version on the modem is up to date and requesting that you exit the program 10 Click to update the Application software A progress bar is displayed informing you ...

Page 71: ...ter any problems updating the Application Loader software however the following messages may appear This message will appear if the modem is disconnected during the download Ensure that all the connections between the PC and the modem are secure check the battery connections ensure the modem is switched on and follow the instructions in the message to try again This message will appear if the mode...

Page 72: ...ctober 2003 72 BM310012WT04 This message or similar will appear if you have attempted to upgrade your modem with the incorrect 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 ...

Page 73: ...Boomer III User Manual Integrator s Guide__________________________ Wavenet Software Development Tools BM310012WT04 73 Copyright Wavenet Technology October 2003 ...

Page 74: ...dards requirements and specifications In addition perform functional tests during product development to validate that the integrated package performs as designed Enabler Functions To test the interaction between the modem and host terminal your product must be able to perform the following Turn the various hardware components on and off This capability helps to isolate possible desense and other ...

Page 75: ... 3V m fields Desense and EMI Any host terminal in which the modem is integrated generates some EMI electromagnetic interference which tends to desensitise the modem s ability to receive at certain frequencies Wavenet can provide a facility for testing the amount of desense that your modem experiences while in a host terminal Specifically modem receiver sensitivity is recorded while operating with ...

Page 76: ...ergoes FCC testing with the modem stand alone to ensure compatibility with these requirements But since the eventual transmit capability of the modem is highly integrated with the power supply and antenna system of the host terminal the fully integrated product must be submitted for final regulatory approval In addition regulatory bodies can require the wireless modem to transmit random data patte...

Page 77: ...cause the host terminal application to fail Each condition must have a specific remedial action to alleviate it Final Assembly A final assembly test should be performed before shipment to ensure all components are working properly and issues such as crimped antenna cables lose connections and improper software load are resolved During final assembly the modem may send and receive a loopback messag...

Page 78: ...he Enterprise Server Application up and running OEM Service Depot Repair When a host terminal is returned for service the first requirement is to determine whether the modem must be sent on to Wavenet for inspection and or repair To set up for this test you need to have an evaluation board a known good Boomer III OEM modem for comparison a power supply Wavenet Commander software and an end to end ...

Page 79: ...Boomer III User Manual Integrator s Guide___________________________________________________ Testing BM310012WT04 79 Copyright Wavenet Technology October 2003 ...

Page 80: ...B Get RPM status block R_PROD_ID ASCII C Get RPM product ID RF_RDLAP_9 6 RF protocol is RD LAP 9600 ASCII 0 RF_RDLAP_19 2 RF protocol is RD LAP 9200 ASCII 1 RF_MDC4800 RF protocol is MDC 4800 ASCII 2 RF_DUAL Dual RD LAP 9 2 MDC4800 ASCII 3 NCL_PRE1 2 NCL support is R1 0 or R1 1 ASCII 0 NCL_1 2 NCL support is R1 2 ASCII 2 R_SYSID ASCII C Vendor specific Get system ID of current RF system R_SW_VERSI...

Page 81: ...ASCII 5 Set modem configuration S_RCV_MODE ASCII A Select the confirmed unconfirmed Receive Data mode S_INACTIVITY_ TIMEOUT ASCII A Vendor specific Set read time for outbound packet S_TX_CONTROL ASCII B Enable disable the transmitter S_RX_CONTROL ASCII C Enable disable the radio S_FLOW_CONTROL ASCII D Select the flow control method FLOW_NONE No flow control ASCII 0 FLOW_XONXOFF XON XOFF ASCII 1 FL...

Page 82: ...LL ASCII 6 Full reset of RPM RESET_NCL ASCII 7 Reset NCL interpreter only RESET_OFF ASCII 8 Power off the RPM RESET_DIAG ASCII A Vendor specific Cause DTE to enter diagnostic mode ASCII A Y 7 9 Reserved VENDOR ASCII Z Vendor specific command Event Report SDUs EVENT ASCII B Events Value Event Report Enable Bit Parameters Value Descriptions RCV_MSG_ DATA ASCII A RCV_MSG_DATA_ BIT 10 Received message...

Page 83: ... Value Parameters Value Description Error Code SUCCESS ASCII 1 Successful IBQ_FLUSHED ASCII a Error code Pending SDUs in inbound queue flushed transmitter disabled Used only if the RPM cannot support message buffering while transmitter disabled XFAIL ASCII 2 Command execution error Note the following error codes NO_RESPONSE ASCII A No response from network NO_ACK ASCII B Negative ACK received HOST...

Page 84: ...ntegrator s Guide Copyright Wavenet Technology October 2003 84 BM310012WT04 ASCII P Y 1 9 Reserved 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 ...

Page 85: ...e mode Select new active profile NCL receive message notify timer ZF 2 Byte ID 2 byte Length Val ZF p 00 00 01 new mode byte ZF f 00 00 01 new profile byte ZF n 00 00 02 2 bytes time msec 3 Generic Set RPM configuration command type 2 Set modem configuration parameters eg LED disabling ZF5F 1 Byte ID Val ZF5F 45 00 dis enabled byte 4 Generic Get RPM configuration command Get modem configuration eg...

Page 86: ...t 7 6 5 4 3 2 1 0 RSSI 2 bytes Reserved ignore 1 byte Reserved ignore 1 byte Reserved ignore 1 byte Reserved ignore 1 byte Reserved ignore 1 byte Reserved ignore 1 byte Reserved ignore 1 byte Reserved ignore 1 byte Current Frequency 4 bytes Current Channel 2 bytes Current Base Station ID 1 unsigned byte Where RSSI Two byte signed integer representing the strength of the received signal from the ba...

Page 87: ... unsigned integer representing the Voltage of the battery in mV Battery Percentage Estimate of the remaining capacity of the battery This value ranges from 0 to 100 unsigned byte WN_GET_TIME Get modem time information NCL string ZF t SUCCESS is followed by a block of status information in the format shown below WN_GET_TIME Response Format 7 6 5 4 3 2 1 0 Elapsed Time 4 bytes Elapsed Time is a four...

Page 88: ...NCL Rx Control NCL Tx Control NCL Event Flags Number of Group LLIs n Group LLIs 4 n bytes Number of static channels m Static channels 2 m bytes Reserved ignore 17 bytes Where LLI Four byte unsigned integer the standard NCL command 4E also gives the LLI number back Serial Number ASCII string containing the serial number of the modem Unused bytes are zeros The NCL command ZFts also gives the serial ...

Page 89: ...Group LLIs Each is a four byte unsigned integer The number of Group LLIs is given in the previous field Number of Static Channels Number of channel fields which follow Static Channels Each is a two byte unsigned integer The number of Static Channels is given in the previous field WN_GET_SERIAL Get modem serial number NCL string ZFts SUCCESS is followed by a block of status information in the forma...

Page 90: ...rameter Number A 16 bit field which is unique to each parameter used to differentiate them Parameter Length A 16 bit field which indicates the length of the following parameter in bytes Parameter Contents The actual bytes set for the parameter The format is parameter specific The Parameter Name is a label used to refer to particular parameters and is used as a definition for the parameter number W...

Page 91: ... 4 windows ASCII 2 AVERAGE 8 windows ASCII 3 MINIMUM 16 windows Parameter name WN_PROFILE Parameter number 0x6600 Byte1Byte2 ASCII 0x66 f Parameter length 0x0001 Byte3Byte4 Parameter contents One unsigned byte with the number of the new active profile Parameter name WN_MSG_RX_NOTIF_TMR Parameter number 0x6E00 Byte1Byte2 ASCII 0x6E n Parameter length 0x0002 Byte3Byte4 Parameter contents One unsigne...

Page 92: ...meter contents 16 bit 2 byte field indicating a TRUE or FALSE condition TRUE 0x0001 indicates the LEDs are disabled FALSE 0x0000 indicates normal LED operation The default is FALSE This command sets whether the modem s LEDs are operational If they are disabled with this command then they still flash on powerup and powerdown however they are inactive at all other times This mode allows the modem to...

Page 93: ...RPM Configuration command The responses to these commands obey the WN_GET_PARM response syntax as shown above The one exception is the Get Active Profile command which returns more than just the active profile Parameter Number A 16 bit field which is unique to each parameter used to differentiate them Parameter Length A 16 bit field which indicates the length of the following parameter in bytes Pa...

Page 94: ...y be shorter than the 24 bytes as long as it is followed immediately by the null termination character The 24 bytes do not include the null termination character NCL Label Values Please note the following additions clarifications to the NCL Label Values Table CMND ASCII A RESP ASCII C SUCCESS ASCII 1 VENDOR ASCII Z VEND_MOTOROLA ASCII 0 VEND_WAVENET ASCII F WN_GET_STATUS ASCII WN_GET_RADIO ASCII r...

Page 95: ...Boomer III User Manual Integrator s Guide________________________________ Appendix A NCL INTERFACE BM310012WT04 95 Copyright Wavenet Technology October 2003 ...

Page 96: ... 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 on the following model The NCL API is supplied as a Virtual Device Driver VDD for a PC Win 98 or better or a Pocket PC Win CE Version 3 0 or better Multiple applications can access the RPM via NCL encoded messages MSMQ MSMQ IN N MSMQ...

Page 97: ...o RPM 9600 8 1 N on serial port and a wakeup line Wavenet s current NCL API protocol stack is implemented with the hierarchical structure All DLLs including MSMQ files are included in the install cabinet files for the VDD Message Router The PC or PPC loads MSMQ as a device driver Applications using the modem must open a session with VDD by calling VDDOpen which will create a private Receive MSMQ q...

Page 98: ... Application Interface Opening a Session Applications are required to first open a session with the VDD by calling the API function VDDOpen All other API functions will return an error unless an open session with the VDD was established If successful this operation will result in the creation of two MSMQ queues for use by the client One MSMQ will be used to send messages from the VDD to the client...

Page 99: ...ose a session with the VDD Input None Output Return value 0 Operation was successful Return value 0 Operation failed Value specifies the error type Send Data to a Radio Host Applications can call this function to send data to a radio host The Host ID will automatically be inserted into the data header of the SDU for message routing purposes Prototype int nclSendData word usSduTag byte szHostId byt...

Page 100: ...This applies to both event and response type data from the RPM Note this is the only way to obtain response data originating from the RPM as a result of issuing commands to it by means of other API functions described in this document The return code of all API functions issuing commands to the modem only provides feedback about the posted command It does not guarantee delivery to the RPM It is th...

Page 101: ... to hang on indefinitely for a message The calling thread will be suspended until a message arrive or the time out period has elapsed whichever occurs first ucStructId Pointer to a byte where the structure ID can be stored usSduTag Pointer to a word where the SDU tag can be stored iBufLen Pointer to a integer specifying the total size of ucBuf ucBuf Pointer to the buffer of size iBufLen where rece...

Page 102: ...ChanBlock_ID NCLGroupLlis_ID NCLChannelTable_ID NCLWaveSettings_ID NCLWaveRadio_ID NCLWaveGen_ID NCLByte_ID NCLByte2_ID NCLWord_ID NCLMsg_ID NCLRaw_ID additional structure IDs to be added here including vendor specific types Use 1 byte alignment for the following structures pragma pack 1 Product ID structure typedef struct NCLProdId BYTE hw_platform BYTE rf_protocol BYTE ncl_compliance BYTE releas...

Page 103: ..._msg_count WORD ib_msg_count WORD radio_channel NCLStatusBlock Channel block structure typedef struct NCLChanBlock BYTE radio_in_range WORD radio_channel BYTE attribute BYTE protocol BYTE rssi NCLChanBlock define MAX_GROUP_LLIS 8 define LLI_BYTE_WIDTH 8 define NCL_NUM_CHANNELS 64 Group LLIs array typedef struct NCLGroupLlis BYTE lli MAX_GROUP_LLIS LLI_BYTE_WIDTH BYTE num NCLGroupLlis Channel Table...

Page 104: ...E vendor_id NCLVersion sw_version NCLRpmId rpm_id BYTE rpm_vid 2 NCLGroupLlis rpm_gid WORD max_data_size BYTE rx_status BYTE tx_status BYTE antenna BYTE radio_in_range WORD ob_msg_count WORD ib_msg_count BYTE flow_control BYTE rcv_mode BYTE event_states WORD radio_channel NCLChannelTable chan_table NCLChannelTable dchan_table NCLConfigBlockconfig_block NCLStatusBlock status_block NCLChanBlock chan...

Page 105: ...1 RPM DTE connected NCLEventType RCV_MSG_Data define NCL_MAX_DATA_SIZE 2048 define NCL_MAX_UH_LEN 63 max length of user header typedef struct NCLMsg BYTE is_message If FALSE only len and buf components are valid BYTE sessionID NCL_MAX_UH_LEN 1 NULL terminated BYTE msg_type Used by NCL_DATATAC_5000 networks WORD len BYTE buf NCL_MAX_DATA_SIZE NCLMsg End of 1 byte alignment pragma pack Get RPM Statu...

Page 106: ...o channel NCL_R_CHAN_TABLE NCLChannelTable Read radio channel table NCL_R_CHAN_BLOCK NCLChanBlock Read the channel block NCL_R_BAT_LEVEL NCLStatus bat_level Read the battery level NCL_R_RPM_GID NCLGroupLlis Get RPM group IDs NCL_R_VENDOR_ID NCLStatus vendor_id Get vendor identification NCL_R_DCHAN_TABLE NCLChannelTable Read the D channel table NCL_R_RF_STATISTICS Specific to RF protocol used RD LA...

Page 107: ... queue associated with the VDD session ID If the session ID is not recognized all active RX queues will be posted the response Set Configuration ITEMS Within the RPM By default the modem will have the receiver and transmitter enabled and the RX notification event enabled Modem Configuration items via NCL are TBA and will be restricted to service personnel Reset RPM The application can call this fu...

Page 108: ...vents will be posted to private Receive MSMQ queues the VDD is not required to support callback functions Applications can call the API function nclReceiveData to wait on response and event messages from the RPM on their on account The API function nclReceiveData will return within the time out period specified so applications will not be hung up indefinitely Enable Disable Events The application ...

Page 109: ...s command to the RPM Get Error Description The application can call this function to obtain a string representation for a specified error code Error Code Value Description NCL_ERR_NONE 0 No error has occurred NCL_ERR_SESSION_IS_CLOSED 1 NCL API Session has not been opened NCL_ERR_SESSION_IS_OPEN 2 NCL API Session is already open NCL_ERR_ENCODE 3 NCL API NCL Frame encoding error NCL_ERR_DECODE 4 NC...

Page 110: ...bled NCL_ERR_BUSY H Execution error Resource unavailable NCL_ERR_NOT_AVAILABLE I Execution error Unimplemented services NCL_ERR_HW_ERROR J Execution error Generic NCL_ERR_INVALID_MODE K Execution error Invalid mode of operation NCL_ERR_NO_MESSAGES L Execution error No outbound messages available NCL_ERR_MSGS_PENDING M Execution error Pending inbound messages NCL_ERR_SW_ERROR N Execution error Soft...

Page 111: ...default application will be the Modem Information application as supplied as a sample application with the VDD Prototype int nclRegWakeupApp WCHAR usAppName WORD usWakeupReason Description Register an application for wakeup when specified events occur Input usAppName Pointer to a buffer specifying the full path name Null terminated of the application to execute on a wakeup usWakeupReason Logical O...

Page 112: ...ecifies the error type Switch RPM On Off The application can call this function to switch the RPM on or off Prototype int nclSwitchRPMPower word usSetting Description Switch the RPM power to the desired setting Input usSetting If this value is zero the RPM should power down else it should power up Output Return value 0 Operation was successful Return value 0 Operation failed Value specifies the er...

Page 113: ...ation was successful Return value 0 Operation failed Value specifies the error type Get Software Version The application can call this function obtain the software version of the server application or the VDD DLL Prototype int VDDgetVersion WORD usVersion Description Obtain the software version of the specified software entity Input usVersion Set this value to zero to request the VDD DLL version o...

Page 114: ... sample programs are not intended to be a functional application but are intended to serve as a guide to writing applications and can be used as a basis for developing more complex applications The information given in this section is intended to supplement the source code for the applications by providing a high level overview of the source code The client application is called ModemInfo and uses...

Page 115: ...enet Technology October 2003 The Status tab displays the modem s current channel if registered and its 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 ...

Page 116: ...uide Copyright Wavenet Technology October 2003 116 BM310012WT04 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 ...

Page 117: ...Boomer III User Manual Integrator s Guide___________________________ Appendix C SDK Sample Programs BM310012WT04 117 Copyright Wavenet Technology October 2003 ...

Page 118: ... help you develop wireless enabled applications Use Power Save mode of operation to extend battery life and operational time for the user We recommend that the application does not modify this mode dynamically Use the Confirmed mode of operation to perform the following functions Check the SDU checksum for validity Re read SDUs received in error Read past the last message in Confirmed mode to make...

Page 119: ...ing existing third party software for DataTAC systems Alternatively you can develop a transport level protocol with your application in mind Roaming Requirements The roaming algorithms for the wireless modem are described as follows Note In each case re establishing network contact requires the wireless modem to scan all likely channels and to handshake with the network Send a quick bounded respon...

Page 120: ...e to loss of outbound channel The wireless modem attempts to re establishes network contact following loss of the outbound channel If unable to re establish network contact the modem indicates an out of range event and procedures to re establish network contact are initiated When network contact is re established the wireless modem indicates an in range event The client application then resubmits ...

Page 121: ...ot be delivered due to a low battery condition When a low battery condition is reached the radio network connection is dropped until the low battery condition is corrected This can be addressed by replacing the battery or if trickle charging is enabled waiting for a sufficient charge level to be reached Inbound SDU failure inbound queue full This response indicates that the maximum number 2 of SDU...

Page 122: ... extended period Depending upon the user route and network coverage area this interval could extend from a few minutes to several hours or longer Once network contact is re established the client and server application must be resynchronised if applications transactions have failed during the interval After network contact has been announced further delays should be minimised as the user becomes a...

Page 123: ...tion This situation never occurs when the client application reads continuously to clear the wireless modem of received outbound SDUs Receiver disabled The client application can disable the wireless modem transceiver by using the Receiver Disable NCL command When this occurs network contact is dropped and the radio is turned off Network contact is re established when the application issues the Re...

Page 124: ...arameters can vary by network based on how the network operator sets up Power Save protocol parameters Under Power Save protocol unsolicited outbound traffic to a non awake device is delayed The worst case delay until the first transmit opportunity is 128 seconds under DataTAC 4000 networks and 64 seconds under DataTAC 5000 networks The average delay until the next delivery opportunity is one half...

Page 125: ...annot Be Guaranteed Because a wireless device can roam without restriction it can exit the network RF coverage area leaving it unable to receive or successfully transmit messages When a device is outside the coverage area the applications are informed of failed inbound delivery The application is required to take appropriate recovery action Variation in Message Transit Times Across the Network The...

Page 126: ...to be sent across the system the host and wireless device application must provide the segmentation and reconstruction functions Message Transit Time The time required for an inbound or outbound message to travel across the network is primarily a function of the queuing delays associated with each product in the network infrastructure and the message load on the system As system traffic builds que...

Page 127: ...Boomer III User Manual Integrator s Guide__________________________ Appendix D Application Development BM310012WT04 127 Copyright Wavenet Technology October 2003 ...

Page 128: ...application models The primary host communications mode is Standard Context Routing SCR also known as fleet mode Another application mode is DataTAC Messaging DM which handles messaging among terminals subscriber units SCR and DM are the common sets of rules that describe how to format message headers on DataTAC systems Although the header format differs slightly among DataTAC 4000 5000 and 6000 s...

Page 129: ...ations cost When a terminal sends a message to the host the message must contain a header that includes the sending terminal ID This enables the host to identify which terminal sent the message and which terminal the host is to poll DataTAC System Architectures Other header fields provide the host with options for instructing the network on handling undeliverable messages For example the host can ...

Page 130: ...s character encoding language enabling and special text formatting While such an effort can take longer up front any eventual re porting of the application will be much easier to manage Character Encoding If your application supports languages that use Latin based characters for example English Spanish and German design your application for compatibility with 7 bit ASCII ISO 646 and Latin 1 ISO 88...

Page 131: ...r example if your local and target networks are the same the logistics associated with testing the application are fairly minimal Testing an application for a distant target network requires a bit more planning since the network is not directly accessible from your development site In this case two approaches are worth considering If your application is designed for a DataTAC network in another co...

Page 132: ...antenna issues Note This section considers but does not attempt to resolve these technical issues for a particular platform That is beyond the scope of this guide Receiver desensitisation occurs when an unwanted signal is present at the radio receive frequency The signal is usually the result of harmonic energy emanating from a high frequency non sinusoidal source This noise desensitises or lowers...

Page 133: ...in host terminal designs The frequency of sources drifts as a function of temperature time and aging Other sources by nature move within the frequency spectrum as a function of time The edges of clock signals create detectable harmonics well into the 1GHz band This presents a challenge in measuring the effects of the emission as one must first determine where the emission exists in the frequency s...

Page 134: ... an integrated host terminal using a special facility The best alternate methods for determining the desense is to measure the signal the receiver port sees by using a spectrum analyser see below Spectrum Analyser Setup Using a spectrum analyser with an input impedance of 50 W connect the antenna of the product under test to the analyser If an antenna is currently not developed use a portable dipo...

Page 135: ...hieving this is to shield Through past experience it has become evident that standard techniques used to achieve FCC certification are not enough to satisfy wireless communications Engineering teams logically attempt an array of decoupling partial shielding and PCB layout methods which produce incremental improvements but do not achieve the emission control requirements Hybrid methods of shielding...

Page 136: ...B layout and grounding or a combination of the two Once a shield is in place any revisions to product circuitry have no effect on emissions levels If a circuit level approach is used to control the emissions a change in circuitry can bring a new unknown to the emissions performance Alternate EMI Reduction Methods Although shielding is the brute force method of reducing emission levels other method...

Page 137: ...the portable units is relatively low To compensate for this the base site transmitter power is decreased to a level equal to that of the portable The base site has a much larger and reliable power source and is capable of putting out more power This would help overcome desense problems that the portable unit incurs Most network managers prefer not to increase their site power because of ERP licenc...

Page 138: ... on that network Antenna The Boomer III OEM modem is not equipped with an on board antenna and one must be provided externally in the host terminal Field Strengths from the Antenna Field strengths from the wireless modem transmitter can reach as high as 100 V M for WAN products Harden the host terminal to withstand these levels LCD displays and switching power supplies are particularly susceptible...

Page 139: ...en elusive problem to characterize and correct Most host terminal devices are very fast and include numerous high frequency radiators These can interfere with the radio reception of the wireless modem The theoretical levels at which the receiver might be impacted are derived from system coverage requirements and the sensitivity of the radio These goals are not set arbitrarily to improve product pe...

Page 140: ...on Block 01010111 127 87 57 U W 00011000 030 24 18 C CAN Cancel 01011000 130 88 58 U X 00011001 031 25 19 C EM End of Medium 01011001 131 89 59 U Y 00011010 032 26 1A C SUB Substitute 01011010 132 90 5A U Z 00011011 033 27 1B C ESC Escape 01011011 133 91 5B P 00011100 034 28 1C C FS File Separator 01011100 134 92 5C P 00011101 035 29 1D C GS Group Separator 01011101 135 93 5D P 00011110 036 30 1E ...

Page 141: ...Boomer III User Manual Integrator s Guide_______________________ APPENDIX G Numeric Conversion Chart BM310012WT04 141 Copyright Wavenet Technology October 2003 ...

Page 142: ...rage temperature 40 C to 70 C Relative Humidity 0 to 95 Ports Data Interface Port 3V logic serial port 9600 baud RF Connector MMCX female 50Ω Straight connection or right angle LED Indicators Power Green flashes when scanning On when locked Off when the Boomer III is off Transmit Red flashes when transmitting Receive Green flashes when receiving Power Voltage 3 8V nominal 3 4 to 4 8V range Transmi...

Page 143: ...ation 2 Level FSK MDC 4 8 2 5kHz deviatio 4 Level FSK RDLAP 9 6 3 9kHz deviation 4 Level FSK RDLAP 19 2 5 6kHz deviation RF output power at 50Ω antenna port 2W nominal Transmit Duty Cycle over 5 min 10 default 30 maximum Turn on time 5ms Spurious emission 30dBm Adjacent channel power 55dBc at 25kHz channels Receiver Frequency range 851 870MHz Channel spacing 25kHz 19 2kbps data 12 5kHz 9 6 kbps da...

Page 144: ...ance CNTL Control key CSA California Safety Authority DAC Digital to analog converter DB Decibel DBc Decibels relative to carrier DBm Decibels mean levels relative to 1 mW DCD Detailed circuit description Debounce Protection against feedback voltage Desense Loss of sensitivity from high ambient noise DISC Discriminator DOS Disc operating system DTE Data terminal equipment the user device DTR Data ...

Page 145: ... noise amplifier MDC Mobile data communications protocol Motorola MFR Multiple frequency reuse MPS Maintenance Programming Software NAK Negative acknowledgment NatSim Native Mode Simulation software utility NCL Native Control Language Motorola NiCad NiCd Nickel cadmium battery technology NiMH Nickel Metal Hydride battery technology NPN Type of bipolar transistor NSI Network systems integration OB ...

Page 146: ...diode A diode with low forward voltage drop and fast switching SCR Standard context routing SDK Software developer s kit SDU Service data unit SFR Single frequency reuse SINAD Ratio measured in dB of signal to noise plus distortion SMA Sub miniature connector SMB Sub miniature connector SNR Signal to noise ratio SPDT Single pole double throw switch SPI Serial peripheral interface SRAM Static rando...

Search results

Summary of Contents for BM3-800D

Reviews:

Related manuals for BM3-800D

Brands by name

Popular brands

Wavenet Technology BM3-800D, User Manual

Search results

Summary of Contents for BM3-800D

Reviews:

Related manuals for BM3-800D

Brands by name

Popular brands