Quick_Start_Guide_Installing_the_S3DK_and_Testing.md
# Quick-Start Guide: Installing the S3DK and Testing your Installation
Requirements
LabView 2017, 32 bit.
Real-Time Data:
A PMU or PDC, PMU Connection tester, or
A PDC simulator (provided below)
- Familiarity with LabView. You should at least have completed the Core 1 and Core 2 trainings from NI.
Installation
- Download the .vip file (in the screenshot below, s3dk-1.2.0.1.vip) with the latest version of the S3DK from the Github repo: https://github.com/ALSETLab/S3DK/releases
Double click on the downloaded file. The JKI VI Package Manager will open as shown below.
Click on Install, under the 2017 icon.
Go through the installation process, and allow the S3DK to be connected to both public and private networks.
If your installation is successful you should see the following window. Click on Finish.
Testing your Installation
What you will need: If you have access to a PMU or PDC:
Access to a PMU or a Phasor Data Concentrator streaming data using TCP.
The IP Configuration for the PMU or PDC:
IP address: e.g. 127.0.0.1
Port Number: e.g. 4712
ID Code: e.g. 1
- Check that your PMU or PDC stream is sending data using PMU Connection Tester
What you will need if you don't have access to a PMU or PDC:
Download the following PDC Simulator: link
Unzip and run the PDC simulator. Allow access to both private and public networks.
Use the default configuration in PDC simulator, or modify it according to your preference:
- Uncheck the "Enable UDP Unicast" option. It is not needed.
- Click on "Start"
The simulator will stream output data as configured on the specified port:
The IP Configuration for the PDC simulator is:
IP address: 127.0.0.1
Port Number: 4712
ID Code: e.g. 1
Testing the S3DK Installation
Open LabView, and create a new project and a "Blank VI".
In the "Block Diagram", left click to open the "Functions" Palette, and scroll down to the "Smart grid Synchrophasor SDK (S3DK)".
- Click on "Buffer and Queues", and drag the "S3DK GUI" block to the "Block Diagram" of your new VI.
Double click on the "PMU" block with the red circle, this will open the GUI used to connect the S3DK and LabView to the real-time data stream, shown in the bottom left-hand side of the screenshot.
Click on the top bar of the GUI under Edit, "Run", and then "Config" on the bottom right hand side when the GUI is running.
- In the Connection tab, enter the IP Configuration for the PMU/PDC you have available, in this case, for the PDC simulator we have:
IP address: 127.0.0.1
Port Number: 4712
ID Code: e.g. 1
- Click on "OK"
- Next, click on "Start Up" in the GUI.
- The top of the GUI indicates "initialize —> configure" this means that the S3DK is receiving the configuration frame. Once the S3DK starts receiving data, the GUI will appear as follows:
- The dials above are about 20% and 10%, which corresponds to the CPU and memory resources being used. By clicking on the "Raw Data Panel" yellow button, you can display the raw data being received, as follows:
You can modify the update rate to display in the "Raw Data Panel" by selecting the "Update Rate" on the top left (in this case we are displaying 10 Hz of the 30 Hz data). Note that this is only for displaying purposes, the data available to the S3DK can be configured to report at the full or other update rates for computations on the data parcels.
To select the display form of the phasor quantities, i.e. either polar form (magnitude and angle) or cartesian coordinates (real and imaginary), move the button from "Re/Im" to "Amp/Ang".
The "Channel Selector" yellow button (below the "Raw Data Panel" button), allows to select the different signals in the stream and to use them in an application.
Using the S3DK for a New Synchrophasor Application
Now you are ready to make a new application in LabView using the S3DK and your real-time data stream.
You will now modify the simple VI made to call the GUI for connection with a PMU/PDC, and add a new application.
Click on "Shutdown" and then "Quit" from the S3DK GUI, and stop the LabView VI executing it.
Now go to the S3DK pallet, and select under "Examples" the "Simple Frequency Reader", shown in the bottom right of the screenshot below:
- Drag and drop the example to the VI where you have placed the function block for the GUI in the previous step; it should appear as in the screenshot below:
Save your edited VI and click on "Run".
After establishing your connection with a PMU/PDC, click on the GUI the "Channel Selector" button, and select the variable "PMUNameX/frequency", where PMUNameX is the name of the PMU whose frequency you want to visualize. In the screenshot below that is PMU.001/frequency.
- Go back to your VI's "Front Panel", you should be able to now visualize the frequency being streamed by the PMU/PDC, as shown below:
Now you have a new frequency visualization tool!
To develop more advanced applications you need to learn to use LabView; in this link you can find a catalog of courses from National Instruments: http://sine.ni.com/tacs/app/fp/p/ap/ov/lang/en/pg/1/sn/n8:142/