TurboPower Async Professional


Table of contents

1.  Introduction
2.  Package names
3.  Installation
3.1   Library setting 
3.2   Folder structure	
4.  Version history
4.1   Release history from 4.06 to 4.07 RC5
4.2   Release 5.0.0 RC1


==============================================


1. Introduction

Async Professional is a comprehensive communications toolkit for
Embarcadero/CodeGear Delphi for win32 targets. It provides direct
access to serial ports, TAPI, and the Microsoft Speech API. It
supports faxing, terminal emulation, VOIP, & more.

This is a source-only release of TurboPower Async Professional (AsyncPro).
It includes designtime and runtime packages for Delphi 7 through to Delphi 2010.

For help files and a PDF manual, please see the tpapro_docs package on
SourceForge (http://sourceforge.net/projects/tpapro).

==============================================

2. Package names


TurboPower AsyncPro source package names (*.dpk) have the following form:

  packages\<Compiler>\AsyncProGp.groupproj        -- Project Group source package.
  packages\<Compiler>\AsyncPro.dproj/.dpk         -- Run-time source package.
  packages\<Compiler>\dclAsyncPro.dproj/.dpk      -- Design-time source package.

where <Compiler> is one of:
  <D7>        -- for Delphi 7.
  <D2005>     -- for Delphi 2005.  (win 32 target).
  <D2007>     -- for Delphi 2006 and Delphi 2007.
  <D2010>     -- for Delphi 2010.

TurboPower AsyncPro compiled package names (*.bpl) have the following form
  AsyncPro_<Compiler>.bpl         -- Run-time package.
  dclAsyncPro_<Compiler>.bpl      -- Design-time package.

==============================================

3. Installation


To install TurboPower AsyncPro into your IDE, take the following steps:

  1. Unzip the release files into a directory (e.g., v:\Projects\TurboPower\AsyncPro\5).

  2. Start Delphi.
     This step needs to be repeated for each compiler that you want to install
     AsyncPro into.

  3. If you wish to debug-step into AsycPro source, then you can add the
     source subdirectory (e.g., v:\Projects\TurboPower\AsyncPro\5\run) to the IDE's
     library path. This step is optional.
     This step needs to be repeated for each compiler that you want to install
     AsyncPro into.

     3.1 For Delphi 7 and Delphi 2005, you also need to add the
       '<YourAproPath>\run\D2005- dfm' directory. This needs to come ealier in the
       library path list than the run directory.

     3.2 For Delphi 2006 and Delphi 2007, you also need to add the
       '<YourAproPath>\run\D2006,7 dfm' directory. This needs to come ealier in the
       library path list than the run directory.

     NOTE: For Delphi 2009 and higher, steps 3.1 and 3.2 are unnecessary.

  4. For both packages, run-time and design-time, open the project options and set
     the DCU, DCP and BPL output directories, as indicated in the notes below,
     according to your local developmental environment.
     This step needs to be repeated for each compiler that you want to install
     AsyncPro into.

  5. Build the runtime package.
     This step needs to be repeated for each compiler that you want to install
     AsyncPro into.

  6. Compile & install the designtime package.
     This step needs to be repeated for each compiler that you want to install
     AsyncPro into.

  7. Set up the default run-time packages list to include AsyncPro. This step is only
      needed if you want to compile your applications with "Build-with-packages" checked.
     Close all packages, projects and files. Open the project default options as
     indicated in the notes below.
     This step needs to be repeated for each compiler that you want to install
     AsyncPro into. If Build-with-packages is unchecked, you may need to temporarily
     check it. Once checked, add AsyncPro to the list, if it is not already there.

Library Setting - Win32
-----------------------
Two library parths are needed to setup in Library-win32 directory as follow.
Library-Win32		Directories		Library path:
<your AproPath>\run
<your AproPath>\version 4 units in queue for upgrade


Folder structure
----------------
AsyncPro 5.00
|--Design		(Folder: Design time source files)
|--Documentation	(Folder: Documentation for Aysnc Pro)
|--Examples		(Folder: AsyncPro Examples)
|--includes		(Folder: Includes source file)
|--packages		(Folder: Delphi Packages)
|--run			(Folder: Run time source files)
|--version 4 units	(Folder: version 4 units in queue for upgrade)
|--redme.txt		(File:   Read Me)


Setting the work-product output directories.
--------------------------------------------
Compiler          Active-project-condition  Options-to-set                                                                        Default-value
Delphi 7          <Package active>          Project | Options | Directories/Conditions | Directories | Unit output directory      $(DCU)
Delphi 7          <Package active>          Project | Options | Directories/Conditions | Directories | DCP output directory       $(DCP)
Delphi 7          <Package active>          Project | Options | Directories/Conditions | Directories | Output directory           $(BPL)
Delphi 7          <No projects open>        Project | Options | Packages | Runtime packages                                       AsyncPro
Delphi 2007/2010  <Package active>          Project | Options | Directories/Conditions | (all configs) | Unit output directory    $(DCU)
Delphi 2007/2010  <Package active>          Project | Options | Directories/Conditions | (all configs) | DCP output directory     $(DCP)
Delphi 2007/2010  <Package active>          Project | Options | Directories/Conditions | (all configs) | Output directory         $(BPL)
Delphi 2007/2010  <No projects open>        Project | Default Options | Delphi for win32 | Packages | Runtime packages            AsyncPro

Similar for other compilers.


==============================================

4. Version history



4.1 Release history from 4.06 to 4.07 RC5

Please refer to earlier versions of this file, via the subversion repository.


4.2 Release 5.0.0 RC1

This release is mainly upgraded for Unicode compatibility with Delphi 2009 and 2010.

Enhancements
------------
The following 6 components have been upgraded for Unicode compatibility.
1. TApdComPort
2. TApdSLController
3. TApdStatusLight
4. TAPDTapiDevice
5. TApdTapiLog
6. TApdTapiStatus
AsyncPro5  RC1 has the same functionality as version 4.07.
It also supports the following compilers (win32)
Delphi 7, Delphi 2005, Delphi 2007, Delphi 2009 and Delphi 2010.

To Do
-----
All the components inside "version 4 units in queue for upgrade" folder are needed to upgrade.