Keyence LJ-V7000 Series Manual de usuario

LJ-V7000 Series Communication LibraryReference ManualPlease read this manual before use.After reading this manual, store it in a safe place where it

10 LJ-V7000_COM_RM_EName Get profile batch data position specification method designation (batch measurement: on)DefinitionTypedef enum {LJV7IF_BATCH_

11LJ-V7000_COM_RM_E8.2 Structure definitionsName Ethernet settings structureDefinitionTypedef struct {BYTE abyIpAddress[4];WORD wPortNo;BYTE reserve[2

12 LJ-V7000_COM_RM_EName Setting item designation structureDefinitionTypedef struct {BYTE byType;BYTE byCategory;BYTE byItem;BYTE reserve;BYTE byTarge

13LJ-V7000_COM_RM_E*: About the Z-phase flagThis flag can be used when the controller is version 3.0 or later.This flag is turned ON when Z-phase ON

14 LJ-V7000_COM_RM_EExample: Single phase 1x multiplier encoder trigger with no skippingNote: When the Z-phase input uses a negative logic encoder, s

15LJ-V7000_COM_RM_EName High-speed mode get profile request structure (batch measurement: on)DefinitionTypedef struct {BYTE byTargetBank;BYTE byPosMod

16 LJ-V7000_COM_RM_EName Advanced mode get profile request structure (batch measurement: on)DefinitionTypedef struct {BYTE byPosMode;BYTE reserve[3];D

17LJ-V7000_COM_RM_EName High-speed mode get profile response structure (batch measurement: on)DefinitionTypedef struct {DWORD dwCurrentBatchNo;DWORD d

18 LJ-V7000_COM_RM_EName Advanced mode get profile response structure (batch measurement: on)DefinitionTypedef struct {DWORD dwGetBatchNo;DWORD dwGetB

19LJ-V7000_COM_RM_EName Storage information structureDefinitionTypedef struct {BYTE byStatus;BYTE byProgramNo;BYTE byTarget;BYTE reserve[5];DWORD dwSt

20 LJ-V7000_COM_RM_EName Get batch profile storage request structureDefinitionTypedef struct {BYTE reserve[4];DWORD dwSurface;DWORD dwGetBatchNo;DWORD

21LJ-V7000_COM_RM_EName Get batch profile storage response structureDefinitionTypedef struct {DWORD dwGetBatchNo;DWORD dwGetBatchProfCnt;DWORD dwGetBa

22 LJ-V7000_COM_RM_E8.3 Callback function interface definitionFormatvoid (*pCallBack)(BYTE* pBuffer, DWORD dwSize, DWORD dwCount, DWORD dwNotify, DWOR

23LJ-V7000_COM_RM_E8.3.1 Supplement8.3.1.1 dwNotify parameterThis section describes the dwNotify parameter used in the callback function.In high-speed

24 LJ-V7000_COM_RM_EBit 0 to 2 and bit 8 indicate that continuous send was stopped.To restart continuous send, start the high-speed data communication

25LJ-V7000_COM_RM_E9 Functions9.1 Function list9.1.1 Operations for the DLLThese functions are processed normally even when the controller is in the s

26 LJ-V7000_COM_RM_E9.1.5 Functions related to modifying or reading settingsProcessing for these functions fails when the controller is in the system

27LJ-V7000_COM_RM_E9.1.7 Storage function relatedProcessing for these functions fails when the controller is in the system error state.9.1.8 High-spee

28 LJ-V7000_COM_RM_E9.2 Function referenceThe type of the return value for the functions where there is a possibility of an error occurring is LONG. N

29LJ-V7000_COM_RM_E9.2.2 Establish/disconnect the communication path with the controllerFor communication devices, see "9.2.9.1 Communication dev

3LJ-V7000_COM_RM_EContents1 Software License Agreement...

30 LJ-V7000_COM_RM_E Return to factory state Get system error information Clear system errorFormat LONG LJV7IF_RetrunToFactorySetting(LONG lDeviceI

31LJ-V7000_COM_RM_E9.2.4 Measurement controlFor communication devices, see "9.2.9.1 Communication devices". Trigger Start batch measuremen

32 LJ-V7000_COM_RM_E Auto zero Timing ResetFormat LONG LJV7IF_AutoZero(LONG lDeviceId, BYTE byOnOff, DWORD dwOut);ParameterslDeviceId(in)Specifies

33LJ-V7000_COM_RM_E Clear memory9.2.5 Functions related to modifying or reading settingsFor communication devices, see "9.2.9.1 Communication de

34 LJ-V7000_COM_RM_E Get setting Initialize settingFormatLONG LJV7IF_GetSetting(LONG lDeviceId, BYTE byDepth, LJV7IF_TARGET_SETTING TargetSetting, v

35LJ-V7000_COM_RM_E Request to reflect settings in the write settings area Update write settings area Check the status of saving to the save areaFo

36 LJ-V7000_COM_RM_E Set date/time Get date/time Change program Get the active program numberFormat LONG LJV7IF_SetTime(LONG lDeviceId, LJV7IF_TIM

37LJ-V7000_COM_RM_E9.2.6 Acquiring measurement resultsFor communication devices, see "9.2.9.1 Communication devices". Get measurement resul

38 LJ-V7000_COM_RM_E Get batch profiles (operation mode "high-speed (profile only)")FormatLONG LJV7IF_GetBatchProfile(LONG lDeviceId, LJV7I

39LJ-V7000_COM_RM_E Get profiles (operation mode "advanced (with OUT measurement)")FormatLONG LJV7IF_GetProfileAdvance(LONG lDeviceId, LJV7

4 LJ-V7000_COM_RM_E12 Appendix...

40 LJ-V7000_COM_RM_E Get batch profiles (operation mode "advanced (with OUT measurement)")FormatLONG LJV7IF_GetBatchProfileAdvance(LONG lDe

41LJ-V7000_COM_RM_E9.2.7 Store function relatedFor communication devices, see "9.2.9.1 Communication devices". Start storage Stop storage

42 LJ-V7000_COM_RM_E Get data storage dataFormatLONG LJV7IF_GetStorageData(LONG lDeviceId, LJV7IF_GET_STORAGE_REQ* pReq, LJV7IF_STORAGE_INFO* pStorag

43LJ-V7000_COM_RM_E Get profile storage dataFormatLONG LJV7IF_GetStorageProfile(LONG lDeviceId, LJV7IF_GET_STORAGE_REQ* pReq, LJV7IF_STORAGE_INFO* pS

44 LJ-V7000_COM_RM_E Get batch profile storage dataFormatLONG LJV7IF_GetStorageBatchProfile (LONG lDeviceId, LJV7IF_GET_BATCH_PROFILE_STORAGE_REQ* pR

45LJ-V7000_COM_RM_E9.2.8 High-speed data communication relatedFor communication devices, see "9.2.9.1 Communication devices". Initialize US

46 LJ-V7000_COM_RM_E Request preparation before starting high-speed data communication Start high-speed data communication Stop high-speed data com

47LJ-V7000_COM_RM_E9.2.9 Supplement9.2.9.1 Communication devicesThe controller that will communication with the PC is specified as a communication dev

48 LJ-V7000_COM_RM_E9.2.9.2.1 For operation mode: high-speed (profile only)Save target data: profileWhen the memory allocation is "double buffer&

49LJ-V7000_COM_RM_EWhen the memory allocation is "entire area (do not overwrite)"Change program operation and memory states transition examp

5LJ-V7000_COM_RM_E1 Software License AgreementNOTICE TO USER: PLEASE READ THIS SOFTWARE LICENSE AGREEMENT (THIS “AGREEMENT”) CAREFULLY. BY USING ALL O

50 LJ-V7000_COM_RM_E9.2.9.3 Write processing for settingsThe 4 functions listed below are used when performing write processing for settings.• LJV7IF_

51LJ-V7000_COM_RM_E<Usage example 2> Changing 1 setting• Measuring is stopped when writing settings to RUNNING (SAVE).• Do not turn the contro

52 LJ-V7000_COM_RM_E9.2.9.4 Detailed setting errorsThe settings have a consistency that must be observed. The detailed setting errors (dwError) that a

53LJ-V7000_COM_RM_E9.2.9.6 Profile data amount calculation methodThe amount of profile data to get with LJV7IF_GetProfile and other functions is a val

54 LJ-V7000_COM_RM_E9.2.9.8 Specific examples(i) For configuration 1 (initial settings)Heads: 2Measurement range X direction: FullBinning: OffWide: Of

55LJ-V7000_COM_RM_E(ii) For configuration 2Heads: 2Measurement range X direction: FullBinning: onWide: offCompression (X axis): 2Compression (time axi

56 LJ-V7000_COM_RM_E9.2.9.9 High-speed data communication troubleshooting9.2.9.10 Time data added to storage dataInformation that indicates the time t

57LJ-V7000_COM_RM_E9.2.9.11 Data storage data storage order and specific exampleStored measurements can be acquired using GetStorageData. The acquired

58 LJ-V7000_COM_RM_E9.2.9.12 Profile storage data storage order and specific exampleStored profile data, measurement values and internal measurement v

59LJ-V7000_COM_RM_E9.2.9.13 Batch profile storage data storage order and specific exampleStored profile data and measurement values can be acquired us

6 LJ-V7000_COM_RM_E2 IntroductionThe LJ-V7000 Series communication library provides a communication interface for controlling the LJ-V7000 Series from

60 LJ-V7000_COM_RM_E10 Common Return Codes10.1 Return codes returned by the communication libraryThe return codes shown below are judged in the commun

61LJ-V7000_COM_RM_E11 Sample ProgramThis chapter describes the sample program which has been included as an example of how to create an application us

62 LJ-V7000_COM_RM_E[DLL functions] Combination sample tabThe contents of previously distributed sample software can be found here. Communication esta

63LJ-V7000_COM_RM_E11.2 Save file formatThis section describes the file format for profiles that are saved in the get profile process.• File format: T

64 LJ-V7000_COM_RM_E Image of the arrangement of data saved to "Save path" in the [DLL functions] Combination sample tab (2 heads, compress

65LJ-V7000_COM_RM_E12 Appendix12.1 Sending/Receiving SettingsWith the LJ-V7000 Series, settings can be sent and received for each item using send sett

66 LJ-V7000_COM_RM_E12.3 Details of Items for Sending/Receiving SettingsChanging Environmental SettingsCommon measurement settings<Device name>T

67LJ-V7000_COM_RM_EChange Program setting• Trigger settings<Parallel imaging>Type:02h, Category:00h, Item:03hTarget1~4:00hbyte Setting Data0 Par

68 LJ-V7000_COM_RM_E• Imaging settings<Mutual interference prevention>Type:10h~1Fh (10h:Program NO.0, 11h:Program NO.1, ･･･ , 1F:Program NO.15)C

69LJ-V7000_COM_RM_E<Imaging mode>Type:10h~1Fh (10h:Program NO.0, 11h:Program NO.1, ･･･ , 1F:Program NO.15)Category:01h, Item:07h Target1:00h (he

7LJ-V7000_COM_RM_E6 Incorporating the Library6.1 File structureThe files required at execution are listed below.Place these folders/files in the same

70 LJ-V7000_COM_RM_E• Profile<Peak selection>Type:10h~1Fh (10h:Program NO.0, 11h:Program NO.1, ･･･ , 1F:Program NO.15)Category:01h, Item:11hTarg

71LJ-V7000_COM_RM_E<Smoothing>Type:10h~1Fh (10h:Program NO.0, 11h:Program NO.1, ･･･ , 1F:Program NO.15)Category:02h, Item:0BhTarget1:00h (headA/

72 LJ-V7000_COM_RM_E• Master regist<Height correction>Type:10h~1Fh (10h:Program NO.0, 11h:Program NO.1, ･･･ , 1F:Program NO.15)Category:02h, Ite

73LJ-V7000_COM_RM_E• Position correction settings<Dual head mode>Type:10h~1Fh (10h:Program NO.0, 11h:Program NO.1, ･･･ , 1F:Program NO.15)Catego

74 LJ-V7000_COM_RM_E• Profilemask settings<XZcorrection selection>Type:10h~1Fh (10h:Program NO.0, 11h:Program NO.1, ･･･ , 1F:Program NO.15)Categ

75LJ-V7000_COM_RM_E• OUT settings<Profile Mask area settings individual>Type:10h~1Fh (10h:Program NO.0, 11h:Program NO.1, ･･･ , 1F:Program NO.15

76 LJ-V7000_COM_RM_E[Unique parameters of measurement mode from 4byte]Measurement mode 0:OFFbyte Setting Data4Reserved (fixed as 0)~911:Height (when p

77LJ-V7000_COM_RM_E7:Anglebyte Setting Data4Measurement target head: 0: HeadA, 1: HeadB, 2: Combined profile (only when profile combine (wide) is on)5

78 LJ-V7000_COM_RM_E9:Areabyte Setting Data4Measurement target head: 0: HeadA, 1: HeadB, 2: Combined profile (only when profile combine (wide) is on)5

79LJ-V7000_COM_RM_E12:Distance (point-line)byte Setting Data4Measurement target head: 0: HeadA, 1: HeadB, 2: Combined profile (only when profile combi

8 LJ-V7000_COM_RM_E8 Constant, Structure Definitions8.1 Constant definitionsName Setting value storage level designationDefinitionTypedef enum {LJV7IF

80 LJ-V7000_COM_RM_E[Unique parameter of calculation from 8byte]17:Step (simple 3D)byte Setting Data4Measurement target head: 0: HeadA, 1: HeadB, 2: C

81LJ-V7000_COM_RM_E[Unique parameters of Measuring period from 4byte]<Measurement valuefilter detail>Type:10h~1Fh (10h:Program NO.0, 11h:Program

82 LJ-V7000_COM_RM_E• Terminal settings<Tolerance upper/lower limit>Type:10h~1Fh (10h:Program NO.0, 11h:Program NO.1, ･･･ , 1F:Program NO.15)Cat

83LJ-V7000_COM_RM_E• Storage settings• Program name•Measurement area detailsThe correction target selection of feature point correction of position co

84 LJ-V7000_COM_RM_E2:Kneebyte Setting Data0Area Left: any value in measurement range (0.01μm unit Sined 32-bit integerexample: 5mm=500000)1234Area Ri

85LJ-V7000_COM_RM_E5:Centerof circlebyte Setting Data0Arc calculation areacount: 0: Area2 disabled, 1: Area2 enabled1 Reserved (fixed as 0)2 Reserved

86 LJ-V7000_COM_RM_E12.4 Examples of sending/receiving measurement mode settingsExample: When "Height (profile compression (time axis): OFF"

87LJ-V7000_COM_RM_E13 Using the high-speed data communication commandWhen the high-speed data communication command is used, data for currently measur

88 LJ-V7000_COM_RM_E[Checking read profiles]Profiles read using the callback function each have a header that contains the following information.• Whe

89LJ-V7000_COM_RM_E Callback functionUse the callback function to deliver profile data to the application each time the amount of profile dataspecifi

9LJ-V7000_COM_RM_EName Definition that indicates the validity of a measurement valueDefinitionTypedef enum {LJV7IF_MEASURE_DATA_INFO_VALID = 0x00, //

90 LJ-V7000_COM_RM_E[Command procedure]Commands are sent using the following procedure. Confirm that the controller batch setting is ON. Start high-s

91LJ-V7000_COM_RM_E Callback functionUse the callback function to deliver profile data to the application each time the amount of profile dataspecifi

92 LJ-V7000_COM_RM_ERevision HistoryRevision date Revision number Revision detailsJune 2012 2nd edition Ver. 2October 2012 1st revision Z-phase specif

93LJ-V7000_COM_RM_E

Copyright (c) 2014 KEYENCE CORPORATION. All rights reserved. 122030E 1084-2 376GB Printed in Japan