symbian/ext/Moped/Msg/README

   1 NOTE: this is just a sample of how building Symbian specific
   2 extensions COULD work.  This is most probably far from the best
   3 or final way of doing things.
   4
   5 The Moped::Msg currently defines just a single static method,
   6 get_gsm_network_info(), which returns the GSM network and cell id.
   7
   8 The extension code is in Msg.xs (which gets translated by xsubpp into
   9 Msg.cpp), the Perl glue code is in Msg.pm.  To understand the .xs
  10 syntax studying perlxstut and perlxs is recommended.
  11
  12 The prerequisites for compiling this extension are:
  13
  14 (1) The Perl for Symbian SDK installed (either done "make sdkinstall",
  15     or separately installed the perlXYZsdk.zip).
  16
  17 (2) The etelbgsm.h header, which is available for example from
  18     the Symbian 6.1 SDK (the Communicator SDK). This must be
  19     copied to ...\epoc32\include.
  20
  21 (3) The etel.lib and the gsmbas.lib, they should come both
  22     with the 6.1 and 7.0s SDK.  The WINS udeb and THUMB urel
  23     versions of these must be copied to the directories
  24     ...\epoc32\release\wins\udeb and ...\epoc32\release\thumb\urel,
  25     respectively.
  26
  27 To compile (assuming Perl 5.9.3 and Series 60 SDK 2.6 for Visual C):
  28
  29   perl \symbian\perl\5.9.3\bin\xsbuild.pl --cpp --extversion=0.1 ext\symbian\Moped\Msg
  30
  31 The --symbian indicates the Symbian and SDK version, the --cplusplus
  32 indicates that one should generate a .cpp file instead of a .c file.
  33
  34 The xsbuild.pl both configures and builds the extension.
  35 To clean do "make clean" or "make distclean".
  36
  37 The location.pl demonstrates using the extension.
  38
  39 To create a SIS:
  40
  41   makesis -d%EPOCROOT% ext\Moped\Msg\Msg.pkg
  42
  43 TODO: automate the determination of the EXTVERSION (from .pkg?)
  44 and of creation of .pkg (the location of the .dll in the build
  45 and in the target).
  46
  47
  48
  49