RealTime PI software development kit (SDK) examples

The RealTime PI software development kit (SDK) examples solution contains sample source code for the following extension libraries:

• libPiDataQualityReMap

• libPiDigitalConvert

• libPiMsgSupport

Follow the procedure below to retrieve the source code and build the examples extended libraries on your system.

To build the RealTime PI SDK examples solution

1. Set up the Test and Development System.

   For more information around installation, please contact AVEVA Customer Support.

2. On the RealTime server in the Test and Development System, log on as dnaInstaller.

3. Install RealTime.PI.msi.

4. On the RealTime server in the Test and Development System, log on as a member of DNA Developers.

5. On the desktop, double-click the Windows PowerShell for DNA shortcut.

   Windows PowerShell for DNA opens.

6. Create a RealTime Developer Environment (refer to the AVEVA Enterprise SCADA Shared Components Developer documentation).

7. Open the C:\<workspace>\RealTime\build.xml file.

8. Navigate to the <ItemGroup Label="Solutions"> element, and add the text "RealTime.PI.Examples.sln":

   <ItemGroup Label="Solutions">

   <Solution Include="source\RealTime.PI.Examples.sln" />

   </ItemGroup>

9. Select Start, and, in the Search box, enter the following:

   Developer Command Prompt for Visual Studio

10. Press Enter.

    The Visual Studio Developer Command Prompt window opens.

11. Execute the following commands:

    cd C:\<workspace>\RealTime

    msbuild build.xml

12. Once msbuild completes successfully, navigate to the following directory to locate the .dll file:

    %DNADataRoot%\RealTime\bin

13. Copy the .dll file from the RealTime server in the Test and Development System to the following location on the PI Client host:

    %DNADataRoot%\RealTime\bin\

14. Configure the PI Client host to enable loading of the extension Dynamic-link library (DLL):

    1. Copy the %DNAInstallRoot%\RealTime\config\Settings\PI_Extensions.json file to %DNADataRoot%\RealTime\config\Settings\.

    2. In the JSON file, change the dll entries from false to true.

       For example, to load libPiDigitalConvert.dll:

       {

       "PI": {

       "Extensions": {

       "DataConvertSupport": {

       "libPiDigitalConvert.dll": true

       }

       }

       }

       }

15. Restart the RealTime service.