Including the Network PSY in ROM

Introduction

The Network PSY can be used to obtain position fixes from the network by using a Network Protocol Module. The PSY is packaged in the library lbsnetpsy.dll. To use the Network PSY in a device it must be installed in the device ROM. The buildrom macros described in this document copy the Network PSY to ROM.

Procedure

• To install the Network PSY in ROM

  Use the macro SYMBIAN_INCLUDE_LOCATION_NETWORK_PM when you build the LBS ROM.

  The example below shows how to include the Network PSY in ROM. You may need to specify additional macros depending on which other optional LBS components you also want to install.

  
  buildrom lbs.oby 
  -DSYMBIAN_INCLUDE_LOCATION_API_VARIANT2
  -DSYMBIAN_INCLUDE_LOCATION_NETWORK_PM
  

  The file lbs.oby includes the .iby files necessary to build the LBS ROM (see LBS ROM macros for more information about the LBS .iby files). The LBS .iby file lbsnetpsy.iby contains the commands to copy the Network PSY DLL and all supporting files to the target build location:

  
  #ifndef __LBS_NETPSY_IBY__
  #define __LBS_NETPSY_IBY__
  
  #if !defined(SYMBIAN_EXCLUDE_LOCATION)
  #if defined(SYMBIAN_INCLUDE_LOCATION_API_VARIANT2)
  
  #if defined(SYMBIAN_INCLUDE_LOCATION_NETWORK_PM)
  ECOM_PLUGIN(lbsnetpsy.dll, lbsnetpsy.rsc)
  data=ZRESOURCE\lbsnetpsy_name.rsc                            resource\lbsnetpsy_name.rsc
  data=EPOCROOT##epoc32\data\z\private\10202BE9\10285abe.cre    private\10202be9\10285abe.cre
  #endif // SYMBIAN_INCLUDE_LOCATION_NETWORK_PM
  
  #endif // SYMBIAN_INCLUDE_LOCATION_API_VARIANT2
  #endif // SYMBIAN_EXCLUDE_LOCATION
  #endif // __LBS_NETPSY_IBY__
  
  

  The file 10285abe.cre is the central repository initialisation file that defines the values specified by the Positioning Plug-in Information API to register the Network PSY with the LBS subsystem.

To use the Network PSY in an emulator

The LBS code build process uses the project file lbsnetpsy.mmp to build the Network PSY DLL and copy the ECom resource file to the winscw directory. The Network PSY is therefore available for use in an emulator.