This short article tells how to install our Frameworks and start using it with your IDE. The Frameworks are the parts of Wireless Communication Library and each of them can be used as stand alone Framework. You can download each Framework as executable installer or as ZIP archive. To unzip the ZIP archived Framework you need use 7-ZIP.

If you are getting any problems or have any questions about installing Framework please do do hesitate to contact us.

Table Of Contents

Installing Framework from Executable Installer

If you downloaded demo version of one of our Framework you have to unpack it first. We use standard ZIP archive for this so it can be unpacked with using Windows Explorer. Registred versions of Frameworks are shipped as EXE files and are not packed. Once you get the Framework's executable installer file (EXE file) simple run it and follow the installer's instructions.

Unpack Executable Installer

However there can be a situation when you can not (or do not want) to use executable installer by any reason. And you need to install registered version of the Framework which is shipped as executable installer only. In this canse you also can unpack the installer and get Frameworks files. We use Inno Setup for installers so to unpack it you need to use Inno Unpacker.

To unpack Framework executable installer with Inno Unpacker use one of the command below:
innounp framework_installer_name -x -pPWD
where: framework_installer_name is the executable installer name; PWD - password for the registered framework. Do not use "-p" parameter (password) when unpack Framework's demo version.

When command has been completed you will find a folder named as "{app}" and all the Framework's files inside this folder. If you unpacked ZIP archived Framework you simple get Framework's files. After that refer to Installing Framework from ZIP Archive part.

Installing Framework from ZIP Archive

If you already have any previous installation fo the Framework or you already have any other our Framework copy just unpakced files into the same folder where previous version or other Framework is located with overriding existing files.

At this step you have the Framework ready for installation into your IDE. Framework package contains the following directories:
Demo - the Framework's demo projects (applications);
Doc - the Framework's documentation;
Lib - the Framework's binaries. May contains different files and directories depending on Framework's Edition (.NET, C++, VCL);
Source - the Framework's source code (not available in .NET Edition except .NET Edition with source code).

.NET Edition

Any .NET Edition does not require any additional installation steps. You can simple open demo projects (solutions) and start using it. To use the .NET Edition in your application you need to reference the framework's DLL files located in the Lib folder of the Framework package.

C++ Edition

Any C++ Edition does not require any additional installation steps. You can simple open demo projects (solutions) and start using it. To use the C++ Edition in your application you need to add Framework's libraries into your project. You can use #pragma directive or your IDE linker options to provide required Framework's libraries. The Framework's libraries files are located in the Lib folder (sorted by the Visual Studio versions). The Framework's header files are located in the Source folder.

By default all C++ Editions are built as static libraries with /MT option. If you need other build configuration please contact us and we try (if possible) to provide a libraries with required build options for testing purpose. In this case we also recommend to purchase Framework with source code so you can change its build configuration as you needs.

VCL Edition

Installing the VCL Edition requires some additional steps. First thing you have to do is copy some BPLs. Open the Lib folder. You can see tree or two folders there: Common, Communication (is not included with Timeline and WiFi Frameworks) and your framework folder (if you use Bluetooth Framework the folder name is Bluetooth, for WiFi Framework it is WiFi).

Copy files

Start from Common folder. Open it and find folder that is corresponding to your Delphi (RAD Studio) version. If you use any Delphi (RAD Studio) below XE (RAD Studio XE) then simple copy wclCommon.bpl into your RAD's Bin folder (it is usually located in c:\Program Files(x86)\{studio_dir}\Bin). For example, for RAD Studio XE the full path is c:\Program Files (x86)\Embarcadero\RAD Studio\8.0\bin. For RAD Studios starting from XE2 you will find 2 folders: Win32 and Win64. Copy wclCommon.bpl from Win32 folder to your Studio's Bin folder and copy wclCommon.bpl from Win64 folder to your Studio's Bin64 folder.

Do the same for Communication folder (the package name is wclCommunication.bpl) and for your Frameworkr's foder (Bluetooth: wclBluetoothFramewoprkR.bpl, IrDA: wclIrDAFrameworkR.bpl, Serial: wclSerialFrameworkR.bpl, Timeline: wclTimelineFramework.bpl and WiFi: wclWiFiFramework.bpl).

Install components

Now you need to install Framework's design time package (components).

  • If you are installing Framework on RAD Studio XE or below the design time package is located in {app_folder}\Lib\_framework_name_\_ide_ver_ directory.
  • If you are installing Framework on RAD Studio XE2 or above the design time package is located in {app_folder}\Lib\_framework_name_\_ide_ver_\Win32 directory.

Where {app_folder} is the folder where you unpacked the Framework's package, _framework_name_ is the Framework name (Bluetooth for Bluetooth Framework, IrDA for IrDA Framework and Serial for Serial Framework) and _ide_ver_ is your IDE version as described above.

The design time package name is:

  • Bluetooth Framework - wclBluetoothFrameworkD.bpl;
  • IrDA Framework - wclIrDAFrameworkD.bpl;
  • Serial Framework - wclSerialFrameworkD.bpl;
  • Timeline Framework - wclTimelineFrameworkD.bpl;
  • WiFi Framework - wclWiFiFrameworkD.bpl.

Open Install Packages dialog (Component->Install Packages), click Add... button, navigate to the runtime package folder and select the desired runtime package.

Add paths

The next step is to add paths to the Framework's binaries. The binaries are located in the following folders (under the library folder, let say under Common, Communication, Bluetooth, IrDA, Serial, Timeline or WiFi folder):
CBuilder 6 - C6;
Delphi 6 - D6;
Delphi 7 - D7;
Delphi 2005 - D2005;
Developer Studio 2006 - D2006;
RAD Studio 2007 - D2007;
RAD Studio 2009 - D2009;
RAD Studio 2010 - D2010;
RAD Studio XE - DXE;
RAD Studio XE2 - DXE2;
RAD Studio XE3 - DXE3;
RAD Studio XE4 - DXE4;
RAD Studio XE5 - DXE5;
RAD Studio XE6 - DXE6;
RAD Studio XE7 - DXE7;
RAD Studio XE8 - DXE8;
RAD Studio 10 - D10;
RAD Studio 10.1 - D101;
RAD Studio 10.2 - D102;
RAD Studio 10.3 - D103.
Starting from RAD Studio XE2 there are two subfolders under the IDE folder: Win32 and Win64.

If you are installing Bluetooth, IrDA or Serial Framework on RAD Studio XE or below you will need to add tree paths for your IDE: {app_folder}\Lib\Common\_ide_ver_, {app_folder}\Lib\Communication\_ide_ver_ and {app_folder}\Lib\_framework_name_\_ide_ver_. Where {app_folder} is the folder where you unpacked the Framework's package, _framework_name_ is the Framework name (Bluetooth for Bluetooth Framework, IrDA for IrDA Framework and Serial for Serial Framework) and _ide_ver_ is your IDE version as described above. If you are installing Timeline or WiFi Framework there is no Communication folder.

If you are installing Bluetooth, IrDA or Serial Framework on RAD Studio XE2 or above you will need to add six paths for your IDE: {app_folder}\Lib\Common\_ide_ver_\Win32, {app_folder}\Lib\Common\_ide_ver_\Win64, {app_folder}\Lib\Communication\_ide_ver_\Win32, {app_folder}\Lib\Communication\_ide_ver_\Win64, {app_folder}\Lib\_framework_name_\_ide_ver_\Win32 and {app_folder}\Lib\_framework_name_\_ide_ver_\Win64. Where {app_folder} is the folder where you unpacked the Framework's package, _framework_name_ is the Framework name (Bluetooth for Bluetooth Framework, IrDA for IrDA Framework and Serial for Serial Framework) and _ide_ver_ is your IDE version as described above. If you are installing Timeline or WiFi Framework there is no Communication folder.

CBuilder 6

You do not need to add any path into the IDE.

Delphi 6, 7
  • Open Environment Options dialog (Tools->Environment Options);
  • Switch to the Library tab;
  • Add paths to the Library path.
  • Click OK to save changes.
Delphi 2005, Developer Studio 2006
  • Open Options dialog (Tools->Options);
  • Expand Environment Options;
  • Expand Delphi Options;
  • Select Library - Win32;
  • Add paths to the Library path;
  • Click OK to save changes.
RAD Studio 2007, 2009, 2010
  • Open Options dialog (Tools->Options);
  • Expand Environment Options;
  • Expand Delphi Options;
  • Select Library - Win32;
  • Add paths to the Library path;
  • Expand C++ Options;
  • Select Path and Directories;
  • Add paths to the Include Path;
  • Add paths to the Library Path;
  • Click OK to save changes.
RAD Studio XE
  • Open Options dialog (Tools->Options);
  • Expand Environment Options;
  • Expand Delphi Options;
  • Select Library;
  • Add paths to the Library path;
  • Expand C++ Options;
  • Select Path and Directories;
  • Add paths to the Include Path;
  • Add paths to the Library Path;
  • Click OK to save changes.
RAD Studio XE 2
  • Open Options dialog (Tools->Options);
  • Expand Environment Options;
  • Expand Delphi Options;
  • Select Library;
  • Select 32-bit Windows from the Selected Platform drop down box;
  • Add Win32 paths to the Library path;
  • Select 64-bit Windows from the Selected Platform drop down box;
  • Add Win64 paths to the Library path;
  • Expand C++ Options;
  • Select Path and Directories;
  • Select 32-bit Windows from the Selected Platform drop down box;
  • Add Win32 paths to the Include Path;
  • Add Win32 paths to the Library Path;
  • Click OK to save changes.
RAD Studio XE 3, 4, 5, 6, 7, 8
  • Open Options dialog (Tools->Options);
  • Expand Environment Options;
  • Expand Delphi Options;
  • Select Library;
  • Select 32-bit Windows from the Selected Platform drop down box;
  • Add Win32 paths to the Library path;
  • Select 64-bit Windows from the Selected Platform drop down box;
  • Add Win64 paths to the Library path;
  • Expand C++ Options;
  • Select Path and Directories;
  • Select 32-bit Windows from the Selected Platform drop down box;
  • Add Win32 paths to the System Include Path;
  • Add Win32 paths to the Library Path;
  • Select 64-bit Windows from the Selected Platform drop down box;
  • Add Win64 paths to the User include Path;
  • Add Win64 paths to the Library Path;
  • Click OK to save changes.
RAD Studio 10, 10.1, 10.2
  • Open Options dialog (Tools->Options);
  • Expand Environment Options;
  • Expand Delphi Options;
  • Select Library;
  • Select 32-bit Windows from the Selected Platform drop down box;
  • Add Win32 paths to the Library path;
  • Select 64-bit Windows from the Selected Platform drop down box;
  • Add Win64 paths to the Library path;
  • Expand C++ Options;
  • Select Path and Directories;
  • Select 32-bit Windows from the Selected Platform drop down box;
  • Switch to Classic Compiler tab;
  • Add Win32 paths to the System Include Path;
  • Add Win32 paths to the Library Path;
  • Select 64-bit Windows from the Selected Platform drop down box;
  • Add Win64 paths to the User include Path;
  • Add Win64 paths to the Library Path;
  • Click OK to save changes.
RAD Studio 10.3
  • Open Options dialog (Tools->Options);
  • Expand Language;
  • Expand Delphi Options;
  • Select Library;
  • Select 32-bit Windows from the Selected Platform drop down box;
  • Add Win32 paths to the Library path;
  • Select 64-bit Windows from the Selected Platform drop down box;
  • Add Win64 paths to the Library path;
  • Expand C++ Options;
  • Select Path and Directories;
  • Select 32-bit Windows from the Selected Platform drop down box;
  • Switch to Classic Compiler tab;
  • Add Win32 paths to the System Include Path;
  • Add Win32 paths to the Library Path;
  • Select 64-bit Windows from the Selected Platform drop down box;
  • Add Win64 paths to the User include Path;
  • Add Win64 paths to the Library Path;
  • Click OK to save changes.

You are done! Now you can run Framework's demo apps or start develop your own.