BOOMERANG
=========
Copyright © 1999,2000,2001,2003,2004 by MandySoft
Tomas Mandys, Prague, Czech republic
url: http://www.2p.cz
email: boomerang@2p.cz
voice: +420-604-690589

Basic characteristics
---------------------

BOOMERANG is the component library for GSM communication software
development. It contains also the components for SMS support, serial
port communication, TAPI communication, simple terminal, EMI(ERMES
UCP - universal computer protocol), BMG(BIP/Nokia CIMD - Computer Interface to
Message Distribution) connection, GDEP (Game Data Exchange Protocol)
etc. and several sample applications. The components are primary written
for Delphi 5, but they are usable also for Delphi 4&6&7, Kylix 3 and finally
for Delphi 8 for .NET Framework.

Some components are available as ActiveX objects usable by any ActiveX
capable application (Visual Basic, Visual C#, Visual Basic for Applications,
Delphi etc.).


The library contains: 

-  (serial) port components
-  modem components (client dial-up communication)
-  socket components (TCP/IP client side)
-  TAPI components (TAPI 2.0 - Win98, WinNT)
-  GSM modem components 
-  BMG components (Business Message Gateway), Nokia CIMD protocol(Computer Interface to Message Distribution)/BIP
-  BMG client
-  EMI components (ERMES UCP, T-Online SMS Direct, Oskar)
-  EMI client
-  GDEP components (GDEP/SMPP, Orange Slovakia), IPSec, SSL
-  GDEP client
-  terminal component
-  narrow band socket (NBS) protocol, UDH (user data header) protocol
-  OTA (over-the-air) services
-  Smart messages (CLI, logos, picture messages, ringing tones, business cards, calendar, RTTTL)
-  EMS (pictures, animations, sounds, etc.)
-  OCX libraries for SMS and EMI communication
 
The components are multi-threaded. 

INSTALLATION
============

Lite version in Delphi 4-7
--------------------------

1) unzip files from "Lite" directory to your library directory mentioned in
   "Project Options/Directories Conditionals/Search path"
2) copy to the same directory content of subdirectory coresponding to your compiler version (for example
   "Lite\Delphi7" for Delphi 7)
3) open in IDE "Boomerang.dpk" package
4) compile and install package components into IDE, components should appear in "Communication" palette tab
5) copy "Boomerang.hlp" to $(DELPHI)\Help directory (only in Delphi)
6) add "$(DELPHI)\Help\Boomerang.hlp" to OpenHelp repository using IDE's "Help/Customize/Add files" command

7) unzip sample projects to some directory and test them in IDE or as standalone application
8) register classes, see Registration

Full version
------------
1) inquire us for decription key
2) receive key
3) decrypt sources, see Source codes
4) install packages into IDE, continue 3) of Lite version

ActiveX (OCX) in non-Delphi
---------------------------
Register ActiveX components using "regsvr32.exe stdvcl40.dll" and
"regsvr32.exe lib_name.ocx". Install in IDE or use directly in code.


ActiveX (OCX) in Delphi IDE
---------------------------
Register ActiveX components using "regsvr32.exe lib_name.ocx".

  1) compile and install "MandySoft_OleX.dpk" package
  2) compile and install "Boomerang_xxx.dpk" package(s)
    (recomended)
OR
  1) import components using "Component/Import ActiveX control" (*.ocx)
  2) compile and install newly created package (*.dpk)

3) installed components appear on "ActiveX" tab of the toolbar palette
4) register ActiveX libraries, see Registration

.NET FRAMEWORK
--------------
There is included experimental version built using Delphi 8 Field Test 1 in
located \Lite.Net directory. Example VCL applications are located in *.Net directories.

Assembly is located in Lite.Net directory. Installation is done using
"Component/Installed NET components../.NET VCL Components/Add..." BDS command.
To compile from command line use makenet.bat batch files (don't forget check
correct pathes to your BDS installation).

REGISTRATION (for compiled units .dcu/.dcuil)
============

Before components or ActiveX library are used, it's necesary register and activate
them using registration/activation key. According to the activation key it's possible
to use the application based on Boomerang on one (developers license) machine or
on any machine (deployment license).

GSM.TGSM class
--------------

1) Put the TGSM component onto a form or a datamodule
2) Right click on the component
3) Click "Register" item
4) Follow instructions
5) Registration/activation key is stored in BOOMERANG.KEY file or into the registry

GSMX, EMIX ActiveX (OCX)
------------------------

1) register OCX library into Windows registry using Windows tool
     regsvr32.exe lib_name
2) create license file (lib_name.LIC) - follow instructions in Registartion dialog
   that appears if license file is missing, corrupted or expired
3) keep lib_name.LIC in the same location as lib_name.OCX
4a) install OCX library into a Microsoft Visual * IDE
4b) install OCX into Delphi - either via "Component/Import ActiveX control" or
    install prepared packages, see
4c) create library in runtime


SOURCE CODES
============

There are included encrypted source files (*.encrypt). When you obtain the key you can
decrypt them using encrypt.exe utility. Just copy/paste obtained key
into encrypt.ini file and execute encrypt.exe. You can modify default options
using command line.
 /I:<ini_file> .. changes INI file location
 /K:<key_file> .. key is read from key_file instead from [Key] INI file section (Key=<key>)
 file1 [file2] [file3] .. plain list files to decrypt - overrides files listed in [Files] INI file section
 
