www.lunainc.com
3157 State Street | Blacksburg, VA 24060
solutions@lunainc.com
Support phone: 1.866.586.2682
Contents
Overview ........................................................................................................................................................................ 2
Getting Started .............................................................................................................................................................. 2
Copying SDK Files ....................................................................................................................................................... 2
Runtime Installer ........................................................................................................................................................... 2
Using the OBR4200 SDK ................................................................................................................................................. 3
LabVIEW Support ....................................................................................................................................................... 3
Low Level VIs and Example Programs .................................................................................................................... 3
_Example_Scan.vi .................................................................................................................................................. 4
_Example_Scan_and_Save.vi ................................................................................................................................. 7
_Example_AcquireReference.vi ............................................................................................................................. 9
_Example_SetIPAddress.vi..................................................................................................................................... 9
C/C++ Support.......................................................................................................................................................... 10
C/C++ Function Definitions .................................................................................................................................. 11
Product Support Contact Information ......................................................................................................................... 25
Optical Backscatter Reflectometer 4200 (Handheld OBR) Software
Development Kit (OBR4200 SDK) User Guide
Luna Technologies Application Note and
Addendum to the Optical Backscatter Reflectometer User Guide
OBR4200SDK-D-UG
Rev. 001_3/26/2014
Page 2 of 25
Overview
The OBR4200 Software Development Kit (OBR4200 SDK) or Handheld SDK (HH SDK) is a
collection of software routines that allows users of Luna Technologies’ OBR4200 to develop
custom software utilities targeted for a specific measurement application. By utilizing the SDK
software package, OBR4200 users have the ability to write custom graphical user interfaces and
data analysis packages using the same source code used to develop the instrument operational
software.
The SDK includes sample code in C++ and LabVIEW. The example programs were written and
tested using Visual Studio 2005 and LabVIEW 2010.
The example programs call functions contained in DLLs (primarily OBR4000.DLL) to control the
OBR4200 and to perform calculations. It may be possible to call these same DLL functions from
other programming languages; however C++ and LabVIEW are the only languages currently
supported by the SDK.
Getting Started
Copying SDK Files
The SDK consists of a set of directories and files, which should be copied to a directory on your
PC. For the sake of clarity, it is recommended that the software be copied to the folder
C:\HHSDK. They can be placed in an alternate path if desired, but the remainder of these
instructions will assume that you have used the default name.
The SDK contains the following folders:
Example – contains C++ example and Visual Studio 2005 project file
include – contains the HHSDK C++ header file
lib – contains the DLLs, .lib, and the .llb which contains the LabVIEW code and
examples
Setup – contains the Microsoft Runtime installer and the setup batch file
Runtime Installer
The SDK DLLs require that a specific set of folders and the Microsoft C++ Runtime Library be
installed on your computer. To do this, run setup.bat from the HHSDK\Setup folder. If the
computer running the SDK already has the OBR4200 software installed, this step should be
unnecessary.