Panasonic HL-C2 Series User manual

Preface
Thank you for purchasing Ultra High-Speed, High-Accuracy Laser Displacement
Sensor “HL-C2 Series”.
To fully use this product safely and properly, please read this manual carefully.
See our Website (https://panasonic.net/id/pidsx/global) for the latest information
about the product and latest user’s manual.
■Note
1.
Please notice that illustrations in this manual might be little different from the actual
product.
2. Contents of this manual will be changed without notice due to improvements.
3. This manual and software must not be partially or totally copied or reprinted.
4. If there are any questions, mistakes, paging disorder, or missing pages in this
manual, please contact our sales office nearest you.
5. Windows, VisualBasic, and VisualC++ are registered trademarks of Microsoft
Corporation in the United States of America and other countries.
6. All other company names and product names in this manual are trademarks or a
registered trademarks of their respective companies.
7. We have no responsibility of any results of operations regardless of the above.

Preface
1
Whole USER’S MANUAL Construction
The HL-C2 Series is prepared for the following user’s manuals.
Read them as necessary.
HL-C2 Series USER’S MANUAL (PDF)
This manual describes cautions for using HL-C2 Series, and
installation method, operation method, function details,
specifications, maintenance and inspection method of
system components (controller, sensor head compact
console).
HL-C2 Series USER’S MANUAL: RS-232C Communication Control (PDF)
The manual describes various commands for controlling the
system by PLC or PC using RS-232C communication.
HL-C2 Series USER’S MANUAL: USB Communication Control (PDF)
This manual
The manual describes API for controlling the system by PLC
or PC using USB communication.
Ultra High-Speed, High-Accuracy
Laser Displacement Sensor
HL-C2 Series
User's Manual
ME-HLC2-09
2013.6
panasonic.net/id/pidsx/global
ME-HLCSRS-09
2013.6
panasonic.net/id/pidsx/global
Ultra High-Speed, High-Accuracy
Laser Displacement Sensor
HL-C2 Series
User's Manual
RS-232C Communication Control
Ultra High-Speed, High-Accuracy
Laser Displacement Sensor
HL-C2 Series
User's Manual
ME-HLCSUSB-08
2013.6
panasonic.net/id/pidsx/global
USB Communication Control

Preface
2
HL-C2 Series USER’S MANUAL: Ethernet Communication Control
(PDF)
This manual explains various settings to acquire
measurement information of the HL-C2 system by PLC
using Ethernet communication. For detailed explanation
concerning the system’s functions, precautions for use, etc.,
refer to the separate “HL-C2 Series USER’S MANUAL”.
■USER’S MANUAL for Intelligent Monitor AiM
The Intelligent Monitor AiM, which contains various useful functions in
addition to the compact console, is available when developing PC-based
system.
HL-C2 Series USER’S MANUAL: Intelligent Monitor AiM (PDF)
This manual is included as a PDF file in the Intelligent
Monitor AiM, which can be downloaded on our website.
This manual describes installation method, operation
method, functional details and error messages of the
software.
It also describes an evaluation analysis of HL-C2 Series or
use of buffering function and received light intensity
waveform display function, which are useful for optimum
system setting.
ME-HLCSEN-02
2013.6
panasonic.net/id/pidsx/global
Ultra High-Speed, High-Accuracy
Laser Displacement Sensor
HL-C2 Series
User's Manual
Ethernet Communication Control
Ultra High-Speed, High-Accuracy
Laser Displacement Sensor
HL-C2 Series
User's Manual
ME-HLCSAIM-08
2013.6
panasonic.net/id/pidsx/global
Intelligent Monitor AiM

Preface
3
Manual Construction
1
2
3
1
2
3
Apx
This chapter provides cautions for safe and correct
operation of the product. Be sure to read this chapter.
Preface
Control Example
API Function
Specifications
Prior to Use
This chapter provides the information that users should
know prior to use, such as specifications and
general
description of API, files provided, operating conditions
and instruction for installation of USB driver.
Appendix
Appendix
This chapter describes index and revision history.
This chapter explains specifications of API function
that are required to control HL
-C2 by external control
device (PC) through USB interface.
This chapter explains the example of control to load
the measurement value from the HL
-C2 by using API
function.

Preface
4
Contents
Whole USER’S MANUAL Construction· 1
■USER’S MANUAL for Intelligent
Monitor AiM··························································2
Manual Construction····································· 3
Contents····························································· 4
Safety Precautions ······································ 6
■Symbol Indications·········································· 6
For Correct Use ············································ 7
Correct Handling ·········································· 7
Cautions on Handling Laser Light········· 7
Standards ························································ 7
Use Condition················································ 8
1Prior to Use ·······················1-1
1-1 General Description ························ 1-2
1-2 Installation of USB Driver ············· 1-3
1-2-1 Uninstallation of old USB Driver1-3
1-2-2 Installation of USB Driver·············1-5
2ＡＰＩ Function Specifications · 2-1
2-1 Variable Type ····································· 2-2
2-1-1 Data Format Structure ···················2-3
1)HLC2_CONFIG5(For code setting
00000 to 99999) ·························· 2-3
2)HLC2_NUMERIC11(For numerical value
setting -999.999999 to +999.99999)
····· 2-3
3)HLC2_NUMERIC12(For difference value
setting -9999.999999 to +9999.999999)
· 2-3
4)HLC2_NUMERIC10(For setting of 10-digit
value
．
Used for the command format 3.) · 2-3
2-1-2 2-Output Measurement Value
Readout Structure ··························2-4
1)Data format structure：
HLC2_OUTMEASUREVALUE ········· 2-4
2-1-3 All Output Readout Structure······2-5
1) Data format structure:
HLC2_OUTALL_DATA··················· 2-5
2-1-4 Buffering Data Normal Readout
Structure·············································2-6
1) Data format structure:
HLC2_BUFFERNORMAL··············· 2-6
2-1-5 Buffering Data Rapid Readout
Structure·············································2-7
1) Data format structure:
HLC2_BUFFERRAPID ·················· 2-7
2-1-6 Memory Copy Structure ················2-8
1)HLC2_MEMCOPY ····················· 2-8
2-1-7 Return value ······································2-9
■Error message ·············································· 2-9
2-2 Function ············································· 2-11
■API function list ············································2-11
2-2-1 USB Device Control····················· 2-14
1)OpenByIndex ··························2-14
2)GetCount ·······························2-14
3)Init········································2-14
4)Close ····································2-15
5)GetSerialNumber ·····················2-15
6)Open·····································2-15
2-2-2
Head Setting (Head A/B) Command
2-16
1)HeadSetupMode ······················2-16
2)HeadFloodLightAdjust ···············2-17
3)ExecFloodLight························2-18
4)HeadAlarmDelayTimes ··············2-18
5)HeadHMeasureMode ················2-19
6)HeadMeasureWorkBasis············2-19
7)HeadCalibMeasureValueA··········2-20
8)HeadCalibCorrectValueA ···········2-20
9)HeadCalibMeasureValueB··········2-21
10)HeadCalibCorrectValueB··········2-21
11)ExecCaliburation ····················2-22
12)HeadLaserOff ························2-22
13)GetLightWaveData··················2-23
14) HeadPeakSearchMinLevel ·······2-23
15) HeadEmissionAdjustmentAreaA ·2-24
16) HeadEmissionAdjustmentAreaB ·2-24
17）HeadMedianFilter···················2-25
18）HeadMeasuringRangePointA ····2-25
19）HeadMeasuringRangePointB ····2-26

Preface
5
2-2-3 OUT Setting (OUT1/2) Command 2-27
1)OutPattern ····························· 2-27
2)OutMeasureWork····················· 2-28
3)OutReflectionCalc···················· 2-29
4)OutReflectionRate ··················· 2-29
5)OutZeroSet ···························· 2-30
6)OutTiming······························ 2-30
7)OutReset ······························· 2-31
8)OutHold ································ 2-31
9)OutMeasureMode ···················· 2-32
10) OutFilterSelect ····················· 2-33
11)OutAverageTimes··················· 2-34
12) OutCutOffCycle ···················· 2-35
13) OutSpan ····························· 2-36
14) OutOffsetInput······················ 2-36
15)OutDecisionMax ···················· 2-37
16)OutDecisionMin ····················· 2-37
17)OutDecisionHisMax ················ 2-38
18)OutDecisionHisMin ················· 2-38
19)OutScalingMeasureValueA ······· 2-39
20)OutScalingMeasureValueB ······· 2-39
21)OutScalingVoltageValueA ········ 2-40
22)OutScalingVoltageValueB ········ 2-40
23)ExecAnalogScaling ················ 2-41
24)OutAnalogOutOnAlarm············ 2-41
25)OutFixedValueInput ················ 2-42
26)OutAnalogOutOnUnfixed ········· 2-42
27)OutDegitalOutOnAlarm············ 2-43
28)OutAlarmDelayChange············ 2-43
29)OutlDispDigit ························ 2-44
30)GetMeasureValue ·················· 2-44
31)GetAlarmState······················· 2-45
32)GetStrobeState······················ 2-45
33)GetHighState ························ 2-46
34)GetGoState ·························· 2-46
35)GetLowState ························· 2-47
2-2-4 Common Setting Command ····· 2-48
1)CmnSamplingCycle·················· 2-48
2)CmnPreventInterference ··········· 2-49
3)CmnTerminalInputCtrl ··············· 2-49
4)CmnTerminallInputChattering ····· 2-50
5)Get2OutMeasureValue·············· 2-50
6)GetOutAll ······························ 2-51
7) CmnOffDaley························· 2-51
2-2-5 System Setting Command ·········2-52
1)ExecOutConfigCopy················· 2-52
2)SysMemChangePriority ············ 2-52
3)ExecMemChange ···················· 2-53
4)ExecMemCopy ······················· 2-53
5)ExecMemInitialize ··················· 2-54
6)ExecMemSave························ 2-54
7)SysRs232cBaudrate ················ 2-55
8)SysRs232cDataLen ················· 2-55
9)SysRs232cParity····················· 2-56
10)SysRs232cOutMode ··············· 2-56
11)SysRs232cOutType ················ 2-57
12)SysMeasureUpdateCycle········· 2-57
13)SysConsoleStartNo ················ 2-58
14)SysConsolePanelLock ············ 2-58
2-2-6 Buffering Setting Command······2-59
1)BufferingMode ························ 2-59
2)BufferingType ························· 2-59
3)BufferingRate ························· 2-60
4)BufferStoreNum ······················ 2-60
5)BufferSampleTriggerStoreNum ··· 2-61
6)BufferTriggerPoint ··················· 2-61
7)BufferTriggerDelay··················· 2-62
8)BufferEventCondition ··············· 2-62
9)ExecBuffering························· 2-63
10)BufferSelfStop······················· 2-63
11)GetBufferState ······················ 2-63
12)GetBufferFinalDataPoint·········· 2-64
13)GetBufferTriggerCount ············ 2-64
14)GetBufferDataNormal ············· 2-65
15)GetBufferDataRapid ··············· 2-66
3Control Example················· 3-1
3-1
HL-C2 Measurement Value Loading (example)
3-2
■Example of C code to load HL-C2
measurement value ···········································3-3
Appendix······························· 1
1Index······························································ 2
Revision history ························································ 6

Preface
6
Safety Precautions
This product is intended to detect the objects and does not have the control
function to ensure safety such as accident prevention.
Do not use the product as a sensing device to protect human body.
Please use the products that comply with local laws and standards for human
body protection specified by e.g., OSHA, ANSI and IEC.
Please read this manual carefully before using the product and use it
correctly.
■Symbol Indications
This manual uses symbols to indicate safety precautions, instructions, and
reference.
Before reading this manual, fully understand the meanings of these
indications.
“WARNING” indicates the possibility that death or
serious injury could result if a handling error occurs.
“CAUTION” indicates the possibility that the user could
be injured or property could be damaged if a handling
error occurs.
“CHECK” indicates any instructions or precautions for
using the system.
“REFERENCE” indicates any hints for operation, detail
explanations, or references.
“TECHNIQUE” indicates useful conditions or techniques
(know-how) for operation of the system.
●Install a fail-safe device when the product is used for the purpose that
has a possibility of physical injury or serious extended damage.
●Do not use the product in the atmosphere of flammable gas, to prevent
explosion.
●Use the product within specifications.
Abnormal heat or smoke generation may occur.
●Do not disassemble or remodel the product. Electrical shock or smoke
generation may occur.
●Connect the electric wire securely with the terminal screws.
Imperfect connection may cause abnormal heat or smoke generation.
●Do not touch the terminal during energization of the product, to prevent
electrical shock.

Preface
7
For Correct Use
This manual describes API function for controlling the HL-C2 system by USB
communication.
For the detailed description of construction and use of the system, refer to
“HL-C2 Series USER’S MANUAL”(separate volume).
Correct Handling
For the items listed below, refer to “HL-C2 Series USER’S MANUAL”
(separate volume).
・
Installation Environment
・
Use Environment
・
Measures to Noise
・
Warming Up Time
・
Insulation Resistance and Voltage Resistance
・
Power Supply
・
Instantaneous Power Failure
・
Grounding
・Installation
Cautions on Handling Laser Light
Refer to “HL-C2 Series USER’S MANUAL”.
Standards
Refer to “HL-C2 Series USER’S MANUAL”.

Preface
8
Use Condition
C-E-20160614
Software License Agreement
Panasonic Industrial Devices SUNX Co., Ltd. (“PIDSX”) grants to you a license
to use this Software on condition that you accept this Agreement. You must
read this Software License Agreement (this “Agreement”) carefully before using
this Software. Only in case that you accept this Agreement, you may start
your use of this Software.
Your unsealing the package of this Software, or your downloading, installing or
launching this Software or the like shall be deemed as your acceptance of this
Agreement.
Article 1 Grant of License
1-1. PIDSX hereby grants to you a non-exclusive license to use this
Software only in combination with PIDSX product(s) specified in the
manual of this Software (the “Product”) in accordance with the
terms of this Agreement.
1-2. For the purpose stipulated in the preceding paragraph, you may, at
your own responsibility, modify this Software and/or distribute
(including transfer, rent or lease either for fees or for free) this
Software to a third party on condition that you procure from such third
party a consent to the terms of this Agreement; provided, however,
that PIDSX shall not be liable for any defects or malfunctions caused
by your modification under any circumstances.
1-3. In no event may you use, modify, or distribute to a third party this
Software in connection with products of any third party other than
PIDSX.
Article 2 Restrictions
You may not use this Software by methods or for purposes other than
those specified in the manual provided by PIDSX.
Article 3 Disclaimer
3-1. PIDSX HEREBY DISCLAIMS ALL OTHER WARRANTIES ON THIS
SOFTWARE, EITHER EXPRESS OR IMPLIED, INCLUDING BUT
NOT LIMITED TO THE IMPLIED WARRANTIES OF
MARCHANTABILITY, FITNESS FOR PARTICULAR PURPOSE, AND

Preface
9
NON-INFRINGEMENT OF THIRD PARTY RIGHTS.
3-2. UNDER NO CIRCUMSTANCES SHALL PIDSX BE LIABLE FOR ANY
DAMAGES (INCLUDING DIRECT, INDIRECT, INCIDENTAL,
CONSEQUENTIAL OR SPECIAL OR WHATSOEVER) ARISING OUT
OF THE USE OF THIS SOFTWARE, INABILITY TO USE THIS
SOFTWARE, DEFECTS IN THIS SOFTWARE (e.g., BUGS,
SECURITY HOLES, AND MALFUNCTION), MODIFICATION OF
THIS SOFTWARE, DISTRIBUTION OF THIS SOFTWARE, OR
OTHERWISE IN CONNECTION WITH THIS SOFTWARE.
Article 4 Term
4-1. This Agreement shall come into effect upon your unsealing the
package of this Software, or your downloading, installing or
launching this Software or the like.
4-2. PIDSX may terminate this Agreement immediately, if you breach any
of the provisions of this Agreement.
4-3. You shall, at your own costs, return, delete or destroy this Software
and any of its copies within four (4) weeks after termination of this
Agreement.
Article 5 Export Control
You shall comply with all laws and regulations regarding export control
under any competent jurisdiction, including but not limited to the
Japanese Foreign Exchange & Foreign Trade Control Law, the export
control regulations based on resolutions of the United Nations
Security Council, etc. If any license or appropriate approval from a
governmental authority is required under the applicable laws, you may
not export this Software without such approval to any countries either
directly or indirectly. Furthermore, you shall neither use nor sell this
Software for military purposes either directly or indirectly.
Article 6 Intellectual Property Rights
All intellectual property rights in this Software, including the copyright,
belong to PIDSX and/or the licensors of PIDSX.
Article 7 Upgrade of this Software
7-1. Release of future upgrades or updates of this Software is not
guaranteed and left to the sole discretion of PIDSX. Furthermore,
PIDSX may charge fees for upgrading or updating of this Software.
7-2. If any upgrades or updates are provided to you either for fees or for
free, such upgrades or updates shall be deemed as a part of this
Software and shall be governed by this Agreement, unless PIDSX

Preface
10
designates otherwise at the time of provision of such upgrades or
updates.
Article 8 Limitation on Liability
AGGREGATE LIABILITIES OF PIDSX IN CONNECTION WITH THIS
AGREEMENT OR THIS SOFTWARE SHALL IN NO EVENT EXCEED
TEN THOUSAND (10,000) YEN.
Article 9 Governing Law and Jurisdiction
9-1. This Agreement shall be governed by the laws of Japan.
9-2. Should any dispute arise from or in connection with this Agreement,
Nagoya District Court, Japan shall exclusively have the jurisdiction
over such dispute.

1-1
1
1
Prior to Use
This chapter provides the information about the product that
users should know prior to use.
1-1 General Description ········ 1-2
1-2 Installation of USB Driver ··· 1-3
1-2-1 Uninstallation of old USB Driver ·· 1-3
1-2-2 Installation of USB Driver ·····1-5

Chapter 1 Prior to Use
1-2
1
1-1 General Description
This manual describes the API (Application Program Interface) used for Ultra
High-Speed, High-Accuracy Laser Displacement Sensor “HL-C2 Series”
HL-C2 can be controlled through the external host device (personal
computer) through USB interface by using the API function*.
* API function is hereinafter called “API”.
USB driver
USB driver should be installed to the external control device (personal
computer) in order to control HL-C2 by the device (PC).
If you have already installed the software HL-C2AiM on your PC, also the
USB driver has been installed.
Also the USB driver can be downloaded on our website
(https://panasonic.net/id/pidsx/global). For the installation method, please
refer to “1-2 Installation of USB Driver”
API file
API (Application Program Interface) is provided to easily control HL-C2 by
the external control device.
API is provided in DLL format.
Please feel free to ask our salesman how to obtain a DLL file, or check our
website (https://panasonic.net/id/pidsx/global).
Please contact the vendor of development environment for the use of DLL.
Refer to “Chapter 2 API Function Specifications” in “HL-C2 Series
USER’S MANUAL USB Communication Control”for the use of API.
Sample program (Only a Japanese document and commentary.)
Sample program for USB control, which was created using API, is provided.
We offer Sample program, which are for Visual Basic and Visual C++.
Please feel free to ask our salesman how to obtain Sample Program, or check
our website (https://panasonic.net/id/pidsx/global).

Chapter 1 Prior to Use
1-3
1
1-2 Installation of USB Driver
USB driver should be installed to control the HL-C2 by external control
device (USB host).
For a PC that has the old USB driver installed already Follow the
procedures in ”1-2-1 Uninstallation of Old USB Driver”and then install
the new USB driver.
For installation for the first time Follow the procedures in ”1-2-2
Installation of USB Driver”and install the driver.
Old USB driver is referring to drivers “FTDI USB Serial Converter Drivers”
* This explanation is based on using a PC with Windows XP as the external
control device.
The procedures vary depending on the OS you are using.
1-2-1 Uninstallation of old USB Driver
Uninstall following the below procedures.
1Open Control Panel from My Computer.

Chapter 1 Prior to Use
1-4
1
2In Control Panel, open “Add or Remove Programs”
3Delete “FTDI USB Serial Converter Drivers”.
Uninstallation is then complete.
Next, follow the procedures in “1-2-2 Installation of USB Driver”.

Chapter 1 Prior to Use
1-5
1
1-2-2 Installation of USB Driver
For PC that uses the old USB driver, make sure to delete the old driver and
then install the new driver. For deleting procedures Refer to “1-2-1
Uninstallation of Old USB Driver”
In case the control device is not installed yet, execute DPInst.exe following
the below procedures, and install the new USB driver.
1Execute DPInst.exe, which is inside "USB_DRIVER"-> "32bit" folder or
"64bit" folder.
This screen example is executing DPInst.exe after having copied
USB_DRIVER folder onto the Desktop.
There is no dialog displayed during installation execution.
After the execution is finished, installation is complete.

Chapter 1 Prior to Use
1-6
1
MEMO

2-1
2
2
ＡＰＩ Function Specifications
This chapter explains specifications of API function that are required to
control HL-C2 by external control device (PC) through USB interface.
2-1 Variable Type ······································· 2-2
2-1-1 Data Format Structure································ 2-3
2-1-2 2-Output Measurement Value Readout Structure ········· 2-4
2-1-3 All Output Readout Structure ······················· 2-5
2-1-4 Buffering Data Normal Readout Structure ··············· 2-6
2-1-5 Buffering data Rapid Readout Structure ················ 2-7
2-1-6 Memory Copy Structure······························ 2-8
2-1-7 Return value············································ 2-9
2-2 Function············································· 2-11
2-2-1 USB Device Control ································· 2-14
2-2-2 Head Setting (Head A/B) Command ·············2-16
2-2-3 OUT Setting (OUT1/2) Command ················2-27
2-2-4 Common Setting Command························2-48
2-2-5 System Setting Command··························2-52
2-2-6 Buffering Setting Command························2-59

Chapter 2 API Function Specifications
2-2
2
2-1 Variable Type
These variable type functions are available in the user’s program.
BYTE(8bit unsigned data)
typedef unsigned char BYTE;
WORD(16 bit unsigned data)
typedef unsigned short WORD;
DWORD(32 bit unsigned data)
typedef unsigned long DWORD;
PCHAR(8 bit unsigned data pointer)
typedef char * PCHAR;
LPDWORD(32 bit unsigned data pointer)
typedef DWORD *LPDWORD;
HLC2_HANDLE(Handle: handle type which is acquired at device
open)
typedef void * HLC2_HANDLE;
HLC2_STATUS(Status: type of Return value for each function)
typedef DWORD HLC2_STATUS;
LPDOUBLE(64 bit floating decimal point data pointer)
typedef double *LPDOUBLE
// dwHead selected.
#define HEADA 0 // Selected HAED-A
#define HEADB 1 // Selected HEAD-B
// dwOut selected.
#define OUT1 0 // Selected OUT1.
#define OUT2 1 // Selected OUT2.
// dwIO selected.
#define IO_IN 0 // GET
#define IO_OUT 1 // SET or EXECUTION