Motorola Mobile Workstation 520 Application Developer's Manual
Motorola Mobile Workstation 520 Application Developer's Manual

Motorola Mobile Workstation 520 Application Developer's Manual

Table of Contents


Quick Links

Mobile Workstation 520
Model F5203/F5205
Commercial, Government and
Industrial Solutions Sector
Application Developer's Guide


Table of Contents

Summary of Contents for Motorola Mobile Workstation 520

  • Page 1 Mobile Workstation 520 ™ Model F5203/F5205 Commercial, Government and Industrial Solutions Sector Application Developer’s Guide 98-08901C31-A...
  • Page 2 One (1) Year from the date of shipment. Motorola, at its option, will at no charge either repair the Product (with new or reconditioned parts), replace it with the same or equivalent Product (using new or reconditioned Product), or refund the purchase price of the Product during the warranty period provided purchaser notifies Motorola according to the terms of this warranty.
  • Page 3 VI. PATENT AND SOFTWARE PROVISIONS: Motorola will defend, at its own expense, any suit brought against the end user purchaser to the extent that it is based on a claim that the Product or its parts infringe a United States patent, and Motorola will pay those costs and damages finally awarded against the end user purchaser in any such suit which are attributable to any such claim, but such defense and payments are conditioned on the following: A) that Motorola will be notified promptly in writing by such purchaser of any notice of such claim;...
  • Page 4: Table Of Contents

    APM 1.2 System State Machine................22 ACPI........................23 Sleeping State......................23 MW-520 Temperature Control Mechanism............25 Windows System Power Management Events............ 27 Commercial, Government and Industrial Solutions Sector 98-08901C31-A 1301 E. Algonquin Road, Schaumburg, IL 60196 © Motorola Inc., 2001 June 2001...
  • Page 5 Contents Suspend ....................... 30 Executing the Suspend .................... 30 PCMCIA Configuration ..............31 Configuring PCMCIA Cards in Windows NT ............ 31 Using Specific Hardware Features ..........32 Software Development Tools................32 Hardware Access API ..................32 User Application’s Connection Mechanism ............32 Emergency Event Registration................
  • Page 6: About This Guide

    About This Guide About This Guide Scope The Mobile Workstation 520™ (MW-520) is a standard mobile computer with a Pentium II or Pentium III processor which runs Microsoft Windows 98 ® ® Windows NT 4.0, Windows 2000 , or Windows Me (for model F5205 only).
  • Page 7: Related Documents

    Related Documents The following manuals provide additional information: • Mobile Workstation 520™ Model F5205 Owner’s Manual, 68P02962C10 • Mobile Workstation 520™ Model F5205 Quick Reference Card, 68P02962C11 • Mobile Workstation 520™ Model F5205 Vehicle Installation Manual, 68P02962C15 • RPM500, Radio Portable Modem, Radio Service Software, User’s Guide, 68P02945C40 •...
  • Page 8: Mw-520 Description

    MW-520 Description MW-520 Description General This chapter provides an introductory overview of the MW-520 workstation. Characteristics of the mechanical and electrical design and the basics of operation are briefly described. When designing and optimizing applications for the MW-520, note the following: •...
  • Page 9: Data Exchange Network

    MW-520 Application Developer’s Guide Table 1 MW-520 Features & Specifications Feature Basic MW-520 Specifications Radio Communications Optional Private DataTAC, iDEN, CDPD Optional Trimble II integrated device 1. Model dependent. 2. Supports 16 and 32 bit. Specifications are subject to change without notice. Data Exchange Network The MW-520 typically communicates over a radio data network consisting of a central (host) computer that runs messaging and form-generation software, a radio...
  • Page 10: The Processor Unit

    MW-520 Description The Processor Unit The Front Panel The main power switch, the reset button and the PCMCIA card slot are located on the front panel of the processor. PCMCIA card slots Antenna hole Lock-down Reset button mechanism Main Power switch (on/off) Figure 1 Front View of the Processor Main Power...
  • Page 11 MW-520 Application Developer’s Guide The Back Panel All device and communication connectors are located on the back panel of the processor. USB port IDB port Parallel port Power connector antenna Video In port RF antenna (radio modem antenna) AUX port Audio-in jack COM1 port Display...
  • Page 12: The Display Unit

    MW-520 Description The Display Unit The display unit is a color, active-matrix LCD. The display includes seven pre- defined buttons and six user-defined buttons. The pre-defined buttons are: • Power • Suspend/Resume • Backlight On/Off • Brightness • Volume On/Off (mute) •...
  • Page 13: Battery

    MW-520 Application Developer’s Guide Table 2 Display Buttons Functionality Control/Indicator Function Power Turns the MW-520 on or off. Power LED Power on/off indication; Blinks when the battery is low. Temperature LED Extreme temperature conditions indication. Suspend/Resume Toggles between suspend and resume. Suspend/Resume LED Suspend indication.
  • Page 14: System Software

    Windows special hardware features, Windows 9x includes additional files that were added by Motorola to support the workstation’s special abilities. When adding new applications to the hard drive, please be careful not to remove these files, as this can cause your system to malfunction.
  • Page 15 MW-520 Application Developer’s Guide HWAPP.INI file This file is contained in the Windows 98 and Windows Me system software configurations. It contains different parameters that are used by the driver that handles the special hardware and software of the MW-520. Table 3 HWAPP.INI Parameters Parameter...
  • Page 16: Windows Nt, Windows 2000

    System Software Windows NT, Windows 2000 HWAPP Registry Windows NT and Windows 2000 parameters are saved in the Registry data-base. The MW-520 Registry keys are located in the following registry folder: In Windows NT: My Computer\Hkey_Local_Machine\Software\MW-520\HWDRIVER In Windows 2000: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\mwserv\ Parameters The HWDRIVER includes the following parameters: Table 4...
  • Page 17 MW-520 Application Developer’s Guide Table 4 HWDRIVER Parameters Parameter Data Description 0×03 Duration of shutdown process ShutdownTime* (in case of critical CCFL temperature). This value does not exist in Windows 2000. 0×01 This parameter indicates CCFLPollingEnable whether the MWService module must perform MW-520 display temperature polling.
  • Page 18 System Software Table 4 HWDRIVER Parameters Parameter Data Description 0×03 IgnitionOffShutdownTime is a IgnitionOffShutdownTime period of time (in minutes) during which MWService waits before shutting down in the case of an ignition power key off event. For example, if the value of this parameter is 4 and MWService receives notification about an ignition power key off...
  • Page 19: Pc Configuration

    MW-520 Application Developer’s Guide PC Configuration The MW-520 mobile workstation consists of three separate interconnected components: processor, display unit, and keyboard. Figure 4 describes the MW-520 components and their interfaces. Processor Unit Display Unit LVDS LVDS Keys Touch screen Controls PC Core Keyboard Unit Keyboard...
  • Page 20 PC Configuration The MW-520 PC architecture is illustrated in Figure 5 . It contains the devices listed below: Processor EMC-2 (Pentium II MMX 333 or Pentium III 500 MHz) ChipSet Intel 82371EB (443BX and PIIX4E) Level 2 cache 512KB 64 MB (1 × 8M × 64 bit) SDRAM 128 MB (1 ×...
  • Page 21 MW-520 Application Developer’s Guide EMC2 Module Pentium Host Bus 440BX-System SO DIMM L2 Cache Controller RAM Slot Temperature Sensor PCI Bus IDE Bus Sound PCMCIA Clock SM Bus PCI to ISA/IDE Controller Controller Generator Controller Xcelerator (PIIX4E) DRAM PCMCIA Card Sound I/O A &...
  • Page 22: Logic Control And Addressing

    PC Configuration Logic Control and Addressing This section includes maps of upper memory blocks, I/O addresses, and interrupts. Upper Memory Blocks Table 5 UMB Map Address (hex) Task Comments Video memory A0000-BFFFF VGA BIOS C0000-CAFFF PCM boot BIOS CB000-CFFFF PCMCIA services Used for power management D0000-D7FFF PCMCIA services...
  • Page 23: I/O Map

    MW-520 Application Developer’s Guide I/O Map Table 6 I/O Map Address (Hex) Width FUNCTION 8-bit DMAC-1 0000-000F 8-bit PM2_CTRL register 0020 8-bit PIC-1 0020-0021 8-bit TIMER 0040-0043 8-bit TIMER 0048-004B 8-bit Reset X-bus, IRQ12/M and IRQ1 0060 8-bit NMI status and control, speaker 0061 8-bit Keyboard Controller...
  • Page 24: Smbus Interface

    PC Configuration Table 6 I/O Map (Continued) Address (Hex) Width FUNCTION 8-bit Video 03CC 8-bit Video 03CE-03CF 8-bit Video 03D4-03D5 8-bit Video 03DA 8-bit PCMCIA Controller 03E0-03E1 8-bit PCMCIA Controller 03E4-03E5 8-bit COM3 [Radio] 03E8-03EF 8-bit Primary diskette controller (not used) 03F0-03F5 8-bit Primary IDE channel command port...
  • Page 25: Interrupts And Dma Channels Map

    MW-520 Application Developer’s Guide Interrupts and DMA Channels Map The devices use the Interrupts as defined in the following tables:. Table 8 PCI INT Line Definitions PCI IRQ Devices INT A PCMCIA Controller (1) + Sound Controller (1) INT B PCMCIA Controller (2) + VGA Controller INT C Free...
  • Page 26 PC Configuration Table 10 Channel Map Channel Source DMA 0 Free (can be used by PCI devices) DMA 1 Parallel Port (ECP mode) DMA 2 Free (can be used by PCI devices) DMA 3 Free (can be used by PCI devices) DMA 4 Direct memory access controller DMA 5...
  • Page 27: Power Management

    MW-520 Application Developer’s Guide Power Management APM 1.2 System State Machine The APM 1.2 System State Machine defines the states of all components in the system. Windows Activity Idle (IRQ) Resume CPU Idle Timer or Suspend key Suspend Figure 6 System State Machine The machine contains three states: On, CPU Idle, and Suspend.
  • Page 28: Acpi

    Power Management ACPI The MW-520 supports ACPI for Windows 98/2000/Me, using a standard ACPI system with a number of extensions: • At state S4, power is preserved for most devices. At state S5 the power is Off. • Battery handling is similar to standard battery handling, providing a battery low notification.
  • Page 29 MW-520 Application Developer’s Guide Table 12 Device States Device/State Controlled by Hard Disk Not supported Not supported Standby PIIX4E ON (working state) (hard disk stopped) (IDE Controller) VGA Controller ON (working state)* Not supported Not supported † Device off + LVDS closed Sound Controller ON (working state)* Not supported...
  • Page 30: Mw-520 Temperature Control Mechanism

    Power Management MW-520 Temperature Control Mechanism Model 5203/5205 contains a new temperature control mechanism, based on CPU internal clock throttling. The new mechanism is valid for all operating systems, and has several advantages: • The clock-throttling enables reduction of the CPU heat in high temperature conditions.
  • Page 31 MW-520 Application Developer’s Guide • MM2 is a sensor located on the EMC2 module too. This sensor is responsible for the second 25% throttling, and its level can be adjusted using the relevant software. • The thermistor located on the main board (identical to the sensor which was responsible for the temperature mechanism in previous MW-520 phases).
  • Page 32: Windows System Power Management Events

    Power Management Windows System Power Management Events Any of the following events will resume the MW-520 from Suspend mode: • Resume key pressed • Key pressed • COM1, COM3 ring indicator • Touch screen display • Emergency key pressed. The Windows software informs the application about a power management event over a message.
  • Page 33 MW-520 Application Developer’s Guide Return Values Return to grant a request. TRUE Request to deny a request. BROADCAST_QUERY_DENY WM_POWER message is sent when the system is about to enter Suspend mode. WM_POWER WM_POWER fwPowerEvt = wParam; // power-event notification message Parameters fwPowerEvt Value of wParam.
  • Page 34 Power Management Parameters dwData Reserved; must be 0. Return Values No return value. Remarks Applications may receive this message at any time without a preceding message. PBT_APMSUSPEND PBT_APMSUSPEND is sent immediately before the computer is suspended. PBT_APMSUSPEND This message is typically sent when all applications and installable drivers have returned to a previous message.
  • Page 35: Suspend

    MW-520 Application Developer’s Guide Suspend The MW-520 supports two suspend modes: Suspend to RAM and Suspend to Disk. In Suspend to RAM mode, the memory switches to “self refresh” mode, all system clocks are stopped, and all devices switch to StandBy. In Suspend to Disk mode, the memory content and essential register values are written to the hard disk, and then the power is switched off.
  • Page 36: Pcmcia Configuration

    PCMCIA Configuration PCMCIA Configuration Configuring PCMCIA Cards in Windows NT When you have Windows NT as your operating system, the Phoenix Card Executive for NT is automatically loaded onto your hard drive. The Card Executive configures the PCMCIA card properly each time it is inserted in MW-520. It is recommended to insert Ethernet cards before running Windows NT and remove the cards after Windows shutdown.
  • Page 37: Using Specific Hardware Features

    MW-520 Application Developer’s Guide Using Specific Hardware Features Software Development Tools Microsoft Visual C++ development kit was used by the MW-520 engineering team during product development. No special restrictions apply to the software development tools for its applications. The Application Program Interface (API) library and include files are located on your hard disk as follows: C:\HWDRIVER\HWEVNT.LIB (16-bit) HWEVNT.H...
  • Page 38: Emergency Event Registration

    Using Specific Hardware Features Emergency Event Registration The Windows user application can be registered to receive the MW-520 emergency events. The registration process is as follows: 1. Activate the function call from the user’s application Register_Emg (see API for details). Its output is the registration status. 2.
  • Page 39: Hardware Access Api

    MW-520 Application Developer’s Guide Hardware Access API Register_Emg (HWND hwnd, UINT uiMsg) or WORD APIENTRY Register_Emg (HWND hwnd, UINT uiMsg) WORD APIENTRY Register_Emg32 Purpose Opens the emergency session. Input hwnd: Window handle of the emergency session. uiMsg: The message number used for notification. Output None.
  • Page 40 Using Specific Hardware Features DeRegisterSysEvent (HWND hwnd) or WORD APIENTRY DeRegisterSysEvent (HWND hwnd) WORD APIENTRY DeRegisterSysEvent32 Purpose De-registers the system event session. Input hwnd: specifies the handle of the user application. Output None. Returned Value 1 – ok, 0 – fail...
  • Page 41: Driver Wide Communication Api

    MW-520 Application Developer’s Guide Driver Wide Communication API ReadLCDTemp (float *temperature) BOOL APIENTRY ReadLCDTemp Purpose Reads the LCD temperature from LCD ASIC. Input None Output float *data. (volts) Returned Value 1 – ok, 0 – fail ReadBrightnessLevelStep (int *BrighnessLevel) BOOL APIENTRY ReadBrightnessLevelStep Purpose Reads the brightness level from LCD ASIC.
  • Page 42 Using Specific Hardware Features ReadBrightnessLock (void) BOOL APIENTRY ReadBrightnessLock Purpose Reads the brightness lock value in LCD ASIC. Input BOOL value : TRUE – lock, FALSE – unlock Output None Returned Value BOOL value : TRUE – locked, FALSE – unlocked ReadLCDVersion (DWORD *data) BOOL APIENTRY ReadLCDVersion...
  • Page 43: General Purpose Lines Control Api

    MW-520 Application Developer’s Guide General Purpose Lines Control API The following API refers to the MW-520 hardware driver from versions (Windows 2000), and (Windows 98 and Windows Me) only. Note GPIO Line 3 is an internal line (it does not connect to the auxiliary port).
  • Page 44: Resuming The Display

    Using Specific Hardware Features ReadGPIO (PBYTE pValue, BYTE status) BOOL APIENTRY ReadGPIO Purpose Reads the state of an entire GPIO (all four GPIO lines). Input [out] PBYTE pValue - pointer to the byte variable in which to place the read value of the GPIO state. The returned value will be placed into the four least significant bits of this variable;...
  • Page 45 MW-520 Application Developer’s Guide This function has four parameters, of which only the first and third are used here. The first parameter is a virtual-key code and the third parameter indicates whether the key is pressed or released. By default, the third parameter is zero, which means Key Down.
  • Page 46: User-Defined Buttons

    User-Defined Buttons User-Defined Buttons The six user-defined buttons located on the display unit use scan codes through , from left to right. These scan codes are not used by any other keys on the keyboard.
  • Page 47: Main Peripherals

    MW-520 Application Developer’s Guide Main Peripherals General The following peripheral devices may be attached to the MW-520 connectors: • mobile printers • external speaker • serial RS-232 communication devices • DataTAC radio • iDEN radio • CDPD radio • Standard GPS •...
  • Page 48 Main Peripherals the radio application should notify the modem to stop transferring data (deassert DTR, or switching the modem to transparent mode). If the application receives a message during data transferring, it is recommended to PWR_SUSPENDREQUEST reject the request in order to prevent data loss. When Resume occurs, it should notify the modem to continue (assert DTR, or switch the modem to Native mode).
  • Page 49: Loading A New System Image

    MW-520 Application Developer’s Guide Loading a New System Image This section details how to load a new system image on an MW-520 device, Models F5203/F5205. The three different methods for loading a system image on a device are: PCMCIA ATA HARD DRIVE card, Network, and Parallel Port. The selection of which method to use is left to the individual administrator.
  • Page 50: Image Installation Via Pcmcia Ata Hard Drive

    (This should be installed on the host PC and on the bootable media.) • A copy of the PREGHOST utility. (This is available in the recovery CD or from Motorola at FTP://MW520.MOT.COM). This should be installed on the bootable media.
  • Page 51: Image Installation Via Network

    MW-520 Application Developer’s Guide 4. From within GHOST, choose Local -> Disk -> From Image 5. Choose the image file you need. 6. Choose target hard drive (number 2, not ATA HARD DRIVE card). 7. Press to size, and then to proceed.
  • Page 52: Image Installation Procedure

    Loading a New System Image 7. Edit the in the directory of the floppy disk, so that protocol.ini \mswgcn\ it contains the following strings: [network.setup] version=0x3100 netcard=ms$elnk3,1,MS$ELNK3 transport=ms$netbeui,MS$NETBEUI lana0=ms$elnk3,1,ms$netbeui [protman] DriverName=PROTMAN$ PRIORITY=MS$NETBEUI [MS$ELNK3] DriverName=ELpc3$ (or name of your network card driver: elpc3.dos -> elpc$) IOADDRESS=0x300 MAXTRANSMITS=6 pcmcia_enabler=yes...
  • Page 53: Image Installation Via Parallel Port

    2. Before powering-on the MW-520 unit, connect the MW-520 unit to the Microsoft Windows 9x host via the parallel crossover cable. 3. Power-on the MW-520 unit and enter the by pressing the BIOS Setup when the Motorola logo is displayed. 4. Open the menu item and set the setting to POWER...
  • Page 54 13. Press OK to the target drive, OK to size, and then Yes to proceed. 14. After the image is loaded, restart the computer. 15. Open Bios Setup (by pressing the F2 key when the Motorola Logo is displayed). 16. Press the F9 key (Setup defaults) and confirm changes (by selecting the Yes item).
  • Page 55: Acronyms And Abbreviations

    MW-520 Application Developer’s Guide Acronyms and Abbreviations ACPI Advanced Configuration and Power management Interface Application Program Interface ASIC Application Specific Integrated Circuit BIOS Basic Input/Output System CMOS Complementary Metal-Oxide Semiconductor Central Processing Unit Direct Memory Access DRAM Dynamic Random Access Memory Data Terminal Ready Integrated Data Base Integrated Drive Electronics...
  • Page 56: Glossary

    Glossary Glossary Application A computer program used to perform a specific work. The interface between application programs and the network software. ASIC A chip which can be readily customized for a given application. BIOS Software for transferring information between elements such as memory, screen and disk.
  • Page 57 MW-520 Application Developer’s Guide ISA bus A computer’s bus is the hardware system it uses to transfer information between the different hardware elements of the computer. The ISA bus is the most common form of bus. Supplier who makes equipment for sale by a third party. The equipment is usually disguised by the third party with his own labels.
  • Page 58: Index

    Index Index PCMCIA Card Slot, 5 PCMCIA configuration, 31 APM 1.2 System State Machine, 22 Power Off Event, 33 APM Power Management Events, 27 Processor Unit, 5 Audio connector, 6 AUX port, 6 Reset Button, 5 Battery, 8 BIOS, 9 serial port, 6 Sound Controller, 8 Speaker, 8...

This manual is also suitable for:


Table of Contents