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.