KYOWA CTRS-100A Instruction Manual
Hide thumbs Also See for CTRS-100A:
Table of Contents

Advertisement

Quick Links

Microsoft and Windows are trademarks or registered trademarks of Microsoft Corporation in the
United States and elsewhere.
Other company names and trade names described in this Instruction Manual are trademarks or
registered trademarks of their respective companies.
This Instruction Manual may not be copied or reproduced, in whole or part, without the consent of
KYOWA.
This document is the work of KYOWA Electronic Instruments Co., Ltd. and is copyright © Kyowa
Electronic Instruments Co., Ltd.
The content of this Instruction Manual and software specifications may be changed without prior
notice.
KYOWA shall not be held responsible for any damage resulting from the use of this software.
Instruction Manual
CTRS-100A
Thank you for purchasing this KYOWA product.
Read this Instruction Manual carefully in order to make full use of
the high performance capabilities of the product.
Use this product only as described in this Manual.
This Manual only describes how to operate the control DLL.
IM-A-1386 July 2021
Control DLL Manual

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the CTRS-100A and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for KYOWA CTRS-100A

  • Page 1 This Instruction Manual may not be copied or reproduced, in whole or part, without the consent of KYOWA. This document is the work of KYOWA Electronic Instruments Co., Ltd. and is copyright © Kyowa Electronic Instruments Co., Ltd. The content of this Instruction Manual and software specifications may be changed without prior notice.
  • Page 2: Table Of Contents

    - Table of Contents - Folder structure ........................... 6 Outline ..............................8 Operating environment ........................8 Functions ............................. 8 Limitations ............................8 Required files ............................8 Excel VBA sample programs ....................... 9 Sample programs ......................... 9 Required files ........................9 Operating environment ....................
  • Page 3 Save measurement conditions set in CTRS to SD card ..........41 Load measurement conditions saved to SD card and set conditions in CTRS ....41 Set measurement conditions ................... 42 Load measurement conditions ..................43 Initialize measurement conditions (parameters) set in CTRS ........43 Start AD conversion and switch to monitor status............
  • Page 4 Load measurement condition settings ................69 Set measurement mode ....................72 Load measurement mode ....................73 Set manual measurement conditions ................74 Load manual measurement conditions ................75 Set interval measurement conditions ................76 Load interval measurement conditions ................77 Set trigger overall conditions ..................
  • Page 5 Notations used in the instruction manual Cautionary statements The following notations are used in this document to draw attention to items that require special caution during use or information that could be of reference. Examples CAUTION Indicates something that requires special caution during use. MEMO Indicates something that could be of reference during use.
  • Page 6: Folder Structure

    Folder structure Extracting the ZIP file for this software will result in the following folder structure. CTRS100A_ControlDll │ ・IM-A-1315B_SoftwareLicenseAgreement.pdf │ ・ReadMe.txt ├─DLL │ ├─eng │ │ ・Ctrs100.dll │ │ ・Ctrs100.h │ │ ・Ctrs100.lib │ │ ・Ctrs100Usb.dll │ └─jpn │ ・Ctrs100.dll │...
  • Page 7 CAUTION You must agree with the free software license agreement in order to use this software. Be sure to read IM-A-1315B_SoftwareLicenseAgreement.pdf.
  • Page 8: Outline

    This Instruction Manual describes functions that use CTRS-100A ("CTRS" below) control DLL files to perform CTRS control. The control DLL controls CTRS-100A. USB is used for communication between CTRS and a PC. Up to 32 channels can be measured for CTRS.
  • Page 9: Excel Vba Sample Programs

    Before starting the sample program and CTRS, connect CTRS and the PC with a USB cable. You may be asked for a USB driver when CTRS is connected to the PC. If so, download the KYOWA USB driver from the Kyowa Electronic Instruments website (https://www.kyowa kyowa-ei.com) and then...
  • Page 10: Program To Control Ctrs From A Pc And Obtain Monitor Data

    Program to control CTRS from a PC and obtain monitor data Outline This program (CTRS100A_SampleVBA) uses Excel VBA to obtain monitor data and display it on a worksheet. Operations ① Set the amount of data to obtain. ② Perform balancing and an input resistance check. ③...
  • Page 11: Program Execution

    Program execution (1) Create a folder for executing the sample program, then copy the following files into this folder. ① CTRS100A_SampleVBA.xlsm ② Ctrs100.dll ③ Ctrs100Usb.dll (2) Connect CTRS and the PC with a USB cable. (3) Turn CTRS ON, execute CTRS100A_SampleVBA.xlsm, and then press "UserForm." (4) The sample program user form is opened.
  • Page 12 (5) Press "Connect." (6) Select the measuring range and amount of recorded data. (7) Press "Recording." Balancing is performed then the balancing result and input resistance check result are displayed. To begin recording now, press "Yes."...
  • Page 13 (8) Recording starts, and measurement results are written to the sheet. To stop while recording, press "Stop." (9) The following message will be displayed when recording is complete. (10) To end this program, press "Disconnect" and then press "Close."...
  • Page 14: Program To Convert A Ks3 File On An Sd Card Into Csv Format

    Program to Convert a KS3 file on an SD card into CSV format Outline This program (CTRS100A_KS3ToCSV) uses Excel VBA to control CTRS from a PC and download a KS3 file from the CTRS SD card to the PC. It then converts the downloaded KS3 file into a CSV file to allow the user to confirm measurement results.
  • Page 15: Program Execution

    Program execution (1) Create a folder for executing the sample program, then copy the following files into this folder. ① CTRS100A_KS3ToCSV.xlsm ② Ctrs100.dll ③ Ctrs100Usb.dll (2) Connect CTRS and the PC with a USB cable. (3) Turn CTRS ON, execute CTRS100A_KS3ToCSV.xlsm, and then press "UserForm." (4) The user form is displayed.
  • Page 16 (5) Press "Destination" and select where to save the KS3 file and CSV file. (6) Press "FileList" to display a list of KS3 files on the SD card in the list box.
  • Page 17 (7) Select the KS3 file to download and convert into CSV format, and then press "ConvertCSV" to begin downloading and converting the file to CSV format. (8) To stop while converting, press "Stop." (9) The following message is displayed when CSV conversion is complete. The KS3 file and CSV file will be output to the selected folder.
  • Page 18 (10) To end this program, press "Disconnect" and then press "Close."...
  • Page 19: Common Function Specifications

    Common function specifications Functions return values If a return value is not mentioned in the detailed explanation of a function, that function will use a common function return value. Return value Error content Normal end Unknown command Parameter error SD card access error SD card not inserted Insufficient free space on SD card File does not exist...
  • Page 20: Ctrs Status

    CTRS status Refer to the following table for the "plStatus[0]" of a function. This allows you to check the CTRS status. Each bit is independent, and multiple may be set at the same time. Bit value Details 0x00000001 AD possible 0x00000002 AD conversion (measurement) operation in progress 0x00000004...
  • Page 21 Following are the conditions for setting and clearing each CTRS status. ● AD possible (0x00000001) Set: • When no error occurs as a result of checking measurement conditions, with measurement conditions set during startup. • When no error occurs as a result of checking measurement conditions when the monitor is started using the OPTION button (start monitor function assigned).
  • Page 22 ● Manual measurement data recording paused (0x00000008) Set: • During manual measurement data recording, when recording is paused via the PAU command or the OPTION button to which the PAUSE function is assigned (only when the repeat count is one recording).
  • Page 23 ● Waiting for time-based recording to start (0x00000100) Set: • When time-specified manual recording starts. Clear: • When recording starts. ● System operating (busy) (0x00000200) Set: • When a command is received from the PC and a process that can operate with only a header response is started.
  • Page 24 ● Measurement channel check result present (0x00002000) Set: • When the measurement channel check ends normally via the CCH command or the BAL button. Clear: • When no error occurs as a result of checking measurement conditions when measurement conditions are set using the MSD (load) command, MES (set) command, or the READ button. •...
  • Page 25 ● Battery charging (0x00200000) Set: • When an AC adapter is connected to the battery unit. Clear: • When no AC adapter is connected to the battery unit. ● Control interface (0x00400000) Set: • When a synchronous unit is connected, the communication interface is set to LAN, and CTRS is started.
  • Page 26 ● GPV result present (0x40000000) Set: • When auto range ends via the STP command, STOP button, or an error. • During manual measurement or interval measurement, when recording ends with the pause function disabled. Clear: • When measurement conditions are set via the MSD (load) command, MES (set) command, or the READ button, or when auto range is started.
  • Page 27: Ctrs Error Statuses

    CTRS error statuses Refer to the following table for the "plStatus[1]" of a function. If an error occurs in CTRS, the following bits will be set. Bit value Details 0x00000001 Insufficient measurement data storage capacity 0x00000002 (Reserved) 0x00000004 SD card access error 0x00000008 External clock error 0x00000010...
  • Page 28 Set: • During external clock operation, when the external clock signal input during an AD conversion (measurement) operation is outside of specification. (Refer to the " CTRS-100A Compact Recorder [Hardware Manual]" Instruction Manual.) Clear: • When a normal external clock signal is input.
  • Page 29 ● File number error (0x00000020) Set: • When the file naming convention is set to number specification, and measurement starts with a file number that exceeds the set number of file digits. • When the file naming convention is set to number specification, and the set number of file digits is exceeded when recording ends.
  • Page 30 ● Battery deteriorated (0x00002000) Set: • When battery integrity drops to the specified value or lower. Clear: • When the "do not perform battery error determination" setting is disabled and battery integrity reaches the specified value or higher. • When the "do not perform battery error determination" setting is enabled. ●...
  • Page 31: List Of Control Functions

    List of control functions The control functions included in the DLL are shown in the table below. Processes when connected to CTRS Control function Details Ctrs100_ControlStart Start CTRS control Ctrs100_UsbCheckConnect Check CTRS connection status Ctrs100_ControlEnd End CTRS control Functions for sending/receiving control commands to CTRS Control function Details Ctrs100_DFN1...
  • Page 32: Functions Related To Setting/Loading Dll Internal Parameters

    Ctrs100_FCF Close file opened via FOF command Ctrs100_FDF Delete file Ctrs100_FMT Quick format SD card Ctrs100_FFF Start searching files in data folder on SD card Ctrs100_FFN Continue file search started via FFF command Ctrs100_FFC End file search started via FFF command Ctrs100_FDK Delete immediately preceding recorded data file Ctrs100_AVG1...
  • Page 33: General-Purpose Functions

    Ctrs100_SetChOffsetZero Set offset zero conditions Ctrs100_GetChOffsetZero Load offset zero condition settings Ctrs100_SetChNameEx Set channel name Ctrs100_GetChNameEx Load channel name Ctrs100_SetChTeds Set TEDS information for channel conditions Ctrs100_GetChTeds Load TEDS information for channel conditions Ctrs100_SetChRatedCapacity Set rated capacity, etc. Ctrs100_GetChRatedCapacity Load rated capacity, etc. settings General-purpose functions Control function Details...
  • Page 34: Function Execution Availability

    Function execution availability Some functions may not be available based on the CTRS status. The following tables lists whether each function can be executed in each status. Refer to "8-2 CTRS status" for information on CTRS status. AD stopped Function File File CCH,AVG...
  • Page 35 (*1) When performing balancing, performing an input resistance check, or measuring the average value. (*2) Possible only when a file is open. (*3) Possible only when searching files. (*4) Enabled only during the period from when AD is stopped immediately after recording until subsequent recording starts.
  • Page 36: Descriptions Of Functions

    Descriptions of functions CAUTION The numbers listed next to the arguments of each function indicate the number of required variables. Make sure to pass this number of variables when passing arguments. Processes when connected to CTRS Start CTRS control Definition long __stdcall Ctrs100_ControlStart(void) Argument Data type...
  • Page 37: Functions For Sending/Receiving Control Commands To Ctrs

    Functions for sending/receiving control commands to CTRS MEMO Refer to "8-2 CTRS status" and "8-3 CTRS error statuses" for information on plStatus2 for each function. Set data file name Definition long __stdcall Ctrs100_DFN1(char *pszName128, char *pszTitle128, long *plStatus2) Argument Data type Description pszName128 Char*...
  • Page 38: Set Monitor Data Output Conditions

    Set monitor data output conditions Definition long __stdcall Ctrs100_SMD1(long *plMode8, long *plStatus2) Argument Data type Description plMode[] Description plMode8 Long* Monitor data output mode (*1) -1: No monitor data output 0: Continuous monitor data output mode 1: Intermittent monitor data output mode Analog data monitor data output 0:OFF...
  • Page 39 (*) Monitor output modes • No monitor data output (monitor data output mode is -1) Monitor data output is not performed. The amount of monitor data will always be 0 even if the function for obtaining monitor data (Ctrs100_GMD) is used. If CTRS is offline, this mode will automatically be set.
  • Page 40: Load Monitor Data Output Conditions

    Load monitor data output conditions Definition long __stdcall Ctrs100_SMD0(long *plMode8, long *plStatus2) Argument Data type Description plMode[] Description plMode8 Long* Monitor data output mode Analog data monitor data output Auto range data monitor data output Reserved Refer to Ctrs100_SMD1 plStatus[0] Status plStatus2 Long*...
  • Page 41: Save Measurement Conditions Set In Ctrs To Sd Card

    Save measurement conditions set in CTRS to SD card Definition long __stdcall Ctrs100_MSD1(long *plStatus2) Argument Data type Description plStatus[0] Status plStatus2 Long* plStatus[1] Error status Notes Load measurement conditions saved to SD card and set conditions in CTRS Definition long __stdcall Ctrs100_MSD0(long *plResult1, long *plStatus2) Argument Data type...
  • Page 42: Set Measurement Conditions

    0x00040000 File number error 0x00080000 Folder number error 0x00100000 Reserve 0x00200000 Reserve 0x00400000 Reserve 0x00800000 Reserve 0x01000000 Reserve 0x02000000 Reserve 0x04000000 Reserve 0x08000000 Reserve 0x10000000 Reserve 0x20000000 Reserve 0x40000000 Reserve 0x80000000 Reserve plStatus[0] Status plStatus2 Long* plStatus[1] Error status Notes Set measurement conditions Definition long __stdcall Ctrs100_MES1(long *plResult1,...
  • Page 43: Load Measurement Conditions

    Load measurement conditions Definition long __stdcall Ctrs100_MES0(long *plStatus2) Argument Data type Description plStatus[0] Status plStatus2 Long* plStatus[1] Error status Notes • Loads the current measurement conditions from CTRS to an internal variable of CTRS100.dll. • When controlling CTRS, call this function after calling Ctrs100_ControlStart().
  • Page 44: Start Ad Conversion And Switch To Monitor Status

    • CTRS-100A IP address: 192.168.70.100 • Subnet mask: 255.255.255.0 • Default gateway: 0.0.0.0 • Number of recording channels: Measure using all channels capable of recording • Channel conditions: Initial values for each unit (refer to " CTRS- 100A_ForControlCommand ") • Balancing value: 0...
  • Page 45: Start Data Recording

    Start data recording Definition long __stdcall Ctrs100_REC(long *plStatus2) Argument Data type Description plStatus[0] Status plStatus2 Long* plStatus[1] Error status Notes This function is enabled only in the AD possible status, when monitoring, or when recording is paused. Stop AD conversion or data recording Definition long __stdcall Ctrs100_STP(long *plStatus2) Argument...
  • Page 46: Clear Range-Over Status Occurring During Ad

    Clear range-over status occurring during AD Definition long __stdcall Ctrs100_ROS(long *plStatus2) Argument Data type Description plStatus[0] Status plStatus2 Long* plStatus[1] Error status Notes Execute measurement channel check Definition long __stdcall Ctrs100_CCH1(long lMode, long *plStatus2) Argument Data type Description lMode Long Execution mode (bit-compatible) 0x0001: Balancing 0x0002: Input resistance check...
  • Page 47: Obtain Measurement Channel Check Result

    Obtain measurement channel check result Definition long __stdcall Ctrs100_CCH0 (long *plItem1, long *plResult512, long *plStatus2) Argument Data type Description plItem1 Long* Check execution item (bit-compatible) 0x01: Balancing 0x02: Input resistance check plResult512[] Description plResult512 Long* Balancing result -1: No unit, no function, measurement OFF 0: OK 1: NG...
  • Page 48: Obtain Monitor Data (Ad Value)

    Obtain monitor data (AD value) Definition long __stdcall Ctrs100_GMD_Long(long *plDataNum1, long *plData150000, long *plStatus2) Argument Data type Description plDataNum1 Long* Amount of data per channel However, the value set by the monitor data output mode from the SMD command will vary. •...
  • Page 49: Obtain Monitor Data (Range Value)

    MEMO Use the following equation to convert an AD value into a physical amount. Physical amount = AD value × Calibration factor × Cable factor × (Range value / AD full scale) + Offset value+ Offset zero value (when offset zero is ON) Ex.) AD value = 8.192, Calibration factor = 1.0, Cable factor = 1.0, Range value = 1000, AD full scale = 8192000 (for range value 1000), Offset value = 0.0, Offset zero OFF Physical amount = 8.192 ×...
  • Page 50 ● Monitor data arrangement Monitor data will be four bytes for a single channel for an analog channel. Monitor data is arranged in order of analog channel 1, 2, then 3 each time sampling is performed. Ex.) Measurement data over two samplings when measurement is ON for three channels of analog data (A1, A2, A3) •...
  • Page 51: Insert Marker Into Record File

    Insert marker into record file Definition long __stdcall Ctrs100_IMK1(long lMakerBit, long *plStatus2) Argument Data type Description Marker specification (bit-compatible 0x0001 to 0x0200) lMakerBit Long plStatus[0] Status plStatus2 Long* plStatus[1] Error status Notes This function is enabled only during recording. Load marker from record file Definition long __stdcall Ctrs100_IMK0(long *plMakerNum2, long *plStatus2)
  • Page 52: Lock Remote Control Unit Buttons

    Lock remote control unit buttons Definition long __stdcall Ctrs100_LOC1(long lLockKey long *plStatus2) Argument Data type Description lLockKey Long Key lock status (1: Enabled, 0: Disabled) (0x01:REC, 0x02:STOP, 0x04:BAL 0x08:READ, 0x10:OPTION1, 0x20:OPTION2) plStatus[0] Status plStatus2 Long* plStatus[1] Error status Notes • If the connection with the PC is disconnected, the currently set key lock status will be cleared.
  • Page 53: Set Date And Time

    Set date and time Definition long __stdcall Ctrs100_TIM1(long *plTime8, long *plStatus2) Argument Data type Description plTime8[] Description plTime8 Long* year month hour minute second reserve reserve plStatus[0] Status plStatus2 Long* plStatus[1] Error status Notes Load date and time setting Definition long __stdcall Ctrs100_TIM0(long *plTime8, long *plStatus2) Argument...
  • Page 54: Load Ctrs System Information

    Load CTRS system information Definition long __stdcall Ctrs100_SYS(long *plStatus2) Argument Data type Description plStatus[0] Status plStatus2 Long* plStatus[1] Error status Notes Use Ctrs100_GetSYSInfo() to obtain the value from the DLL. Flash or light up LED Definition long __stdcall Ctrs100_LED(long lUnit, long lAction, long *plStatus2) Argument...
  • Page 55: Check Free Space On Sd Card

    Check free space on SD card Definition long __stdcall Ctrs100_FFR(char *pszFree16, char *pszTotal16, long* plStatus2) Argument Data type Description pszFree16 Char* Free space on SD card pszTotal16 Char* Total capacity of SD card plStatus[0] Status plStatus2 Long* plStatus[1] Error status Notes The value of the free space on the SD card will be returned as a value with the system reserved area (approx.
  • Page 56: Load Data From File Opened Via Fof Command

    Load data from file opened via FOF command Definition long __stdcall Ctrs100_FRF(long lSetReadByte, long *plResult1, long *plReadByte1 char *pszReadData2000000, long *plStatus2) Argument Data type Description lSetReadByte long Number of bytes to load (up to 2,000,000 bytes) plResult1 Long* Load result (same as function return value) plReadByte1 Long* Number of bytes actually loaded...
  • Page 57: Delete File

    Delete file Definition long __stdcall Ctrs100_FDF(char *pszFileName128, long *plStatus2) Argument Data type Description pszFileName128 Char* Name of file to delete (including extension) plStatus[0] Status plStatus2 Long* plStatus[1] Error status Notes • This is used to delete files in the data folder of the SD card. •...
  • Page 58: Start Searching Files In Data Folder On Sd Card

    Start searching files in data folder on SD card Definition long __stdcall Ctrs100_FFF(char *pszFindFileName128, long *plResult1, long *plInputFileNum1, long *plAllFileNum1, char *pszFileSize16, long *plTime8, long *plStatus2) Argument Data type Description pszFindFileName128 Char* Name of file to search (including extension) plResult1 Long* File search result pszFileName128...
  • Page 59 MEMO • If the return value of this function is 0 (normal end), the status will be set to "file open or searching via control command." Only the Ctrs100_FFN() and Ctrs100_FFC() functions can be executed at this time. • Execute Ctrs100_FFC() to stop searching files.
  • Page 60: Continue File Search Started By Ctrs100_Fff

    Continue file search started by Ctrs100_FFF Definition long __stdcall Ctrs100_FFN(long *plResult1, char *pszFileName128, char *pszFileSize16, long *plFileInfo8, long *plStatus2) Argument Data type Description plResult1 Long* File search result (same as standard type) pszFileName128 Char* File name (with extension) pszFileSize16 Char* File size plFileInfo8[] Description...
  • Page 61: Delete Immediately Preceding Recorded Data File

    Delete immediately preceding recorded data file Definition long __stdcall Ctrs100_FDK(long *plStatus2) Argument Data type Description plStatus[0] Status plStatus2 Long* plStatus[1] Error status Notes • This function returns the return value prior to the file being deleted. The status while deleting a file will be set to "SD card being accessed." File deletion can be confirmed by checking that the "SD card being accessed"...
  • Page 62: Execute Auto Range

    Execute auto range Definition long __stdcall Ctrs100_ATR1(long *plStatus2) Argument Data type Description plStatus[0] Status plStatus2 Long* plStatus[1] Error status • When using this function to set the range, follow the procedure below. Notes (1) Execute this function. (2) Execute Ctrs100_STP() and complete auto range. (3) Use Ctrs100_ATR0() to load the auto range result.
  • Page 63: Load Ctrs Status

    Load CTRS status Definition long __stdcall Ctrs100_STS(long lMode, long *plStatus24, char *pszFileName128) Argument Data type Description lMode Long 0: Obtain status that was most recently obtained. 1: Send/receive header and obtain status. plStatus24[] Description plStatus24 Long* Status Error status File number Repeat count Set repeat count Year...
  • Page 64: Setting/Loading Dll Internal Parameters

    Setting/loading DLL internal parameters Load system information Definition long __stdcall Ctrs100_GetSYSInfo(long lUnitType, long lUnitPos, char *pszType32, char *pszCpuVer32, char *pszFpgaVer32, char *pszReserve32, long *plInfo4) Argument Data type Description lUnitType Long 0: Main unit 1: Measuring unit 2: Expansion unit 3: Remote control lUnitPos Long Main unit: Fixed at 0...
  • Page 65: Configure Ks3 File-Related Settings

    Configure KS3 file-related settings Definition long __stdcall Ctrs100_SetKs3FileName(char *pszFileName64, char *pszFileTitle128, long lFileNo) Argument Data type Description pszFileName64 Char* KS3 file name (up to 63 characters, "." cannot be used) pszFileTitle128 Char* File notes (up to 127 characters, "." cannot be used) lFileNo Long File number...
  • Page 66: Configure Measurement Condition Settings

    Configure measurement condition settings Definition long __stdcall Ctrs100_SetOption(long lSetItem, long *plOption32) Argument Data type Description lSetItem Long Bit-compatible 0x00000001 KS3 language 0: Japanese 1: English 0x00000002 BEEP 0: OFF 1: ON (loud) 2: ON (quiet) 0x00000004 Input exceeded BEEP 0: OFF 1: Only when input exceeded 2: Until REC/STOP 0x00000008...
  • Page 67 0x00000100 Option button 1 operation 0: None 1: Start monitor 2: Delete recorded data 3: Reset input exceeded 4: Pause 5: Marker 6: Auto range 7: CAN output 0x00000200 Option button 2 operation 0: None 1: Start monitor 2: Delete recorded data 3: Reset input exceeded 4: Pause 5: Marker...
  • Page 68 0x00010000 Clock output mode 0: Output from startup 1: Output inverted from startup 2: Output only during recording 3: Output inverted only during recording 4: Do not output 0x00020000 Check during balancing 0x00: Disabled 0x01: Input resistance check 0x02: Burnout check 0x00040000 Auto range settable range Set from 50 to 100% in increments of 1%...
  • Page 69: Load Measurement Condition Settings

    Load measurement condition settings Definition long __stdcall Ctrs100_GetOption(long *plOption32) Argument Data type Description plOption32[] Function lSetItem Long KS3 language 0: Japanese 1: English BEEP 0:OFF 1: ON (loud) 2: ON (quiet) Input exceeded BEEP 0:OFF 1: Only when input exceeded 2: Until REC/STOP Do not perform battery error determination...
  • Page 70 Option button 2 operation 0: None 1: Start monitor 2: Delete recorded data 3: Reset input exceeded 4: Pause 5: Marker 6: Auto range Timezone Japan: -540 Power supply shutoff monitoring time Enabled only when power supply is OFF after backup 0: 15 seconds 1 to 60 seconds Operation when PC disconnected...
  • Page 71 Pause function 0: Disabled 1: Enabled File name assignment rule 0: Number 1: Recording start time Number of file digits 0: 4 digits 3 to 5 digits (3 digits: up to 999, 5 digits: up to 99,999) Overwrite check 0: Disabled 1: Enabled Reserve Reserve...
  • Page 72: Set Measurement Mode

    Set measurement mode Definition long __stdcall Ctrs100_SetMeasMode(long lMeasMode, long lSamplingFrequency, long lSamplingType) Argument Data type Description lMeasMode Long Measurement mode -1: PC recording mode (without file name and free space check) 0: Manual 1: Interval 2: Analog trigger 3: External trigger 4: Manual trigger 5: Compound trigger lSamplingFrequency Long...
  • Page 73: Load Measurement Mode

    Load measurement mode Definition long __stdcall Ctrs100_GetMeasMode(long *plMeasMode1, long *plSamplingFrequency1, long *plSamplingType1) Argument Data type Description plMeasMode1 Long Measurement mode -1: PC recording mode (without file name and free space check) 0: Manual 1: Interval 2: Analog trigger 3: External trigger 4: Manual trigger 5: Compound trigger plSamplingFrequency1...
  • Page 74: Set Manual Measurement Conditions

    Set manual measurement conditions Definition long __stdcall Ctrs100_SetManualCondition(long lDataNum, long lRepeatCount, long *plStartTime8) Argument Data type Description lDataNum Long Amount of manual recorded data 0 or less than 5 seconds: Repeat count must be one recording Other: Pause must be disabled lRepeatCount Long Manual repeat count...
  • Page 75: Load Manual Measurement Conditions

    Load manual measurement conditions Definition long __stdcall Ctrs100_GetManualCondition(long *plDataNum1, long *plRepeatCount1, long *plStartTime8) Argument Data type Description plDataNum1 Long* Amount of manual recorded data plRepeatCount1 Long* Manual repeat count 0: Unlimited From 1 to the limit of digits specified by number of file digits Manual start time plStartTime8...
  • Page 76: Set Interval Measurement Conditions

    Set interval measurement conditions Definition long __stdcall Ctrs100_SetIntvalCondition(long lDataNum, long lRepeatCount, long lIntvalTime, long *plStartTime8) Argument Data type Description lDataNum Long Amount of interval recorded data From 1 to amount of time recording is possible lRepeatCount Long Number of intervals 0: Unlimited From 1 to the limit of digits specified by number of file digits...
  • Page 77: Load Interval Measurement Conditions

    Load interval measurement conditions Definition long __stdcall Ctrs100_GetIntvalCondition(long *plDataNum1, long *plRepeatCount1, long *plIntvalTime1, long *plStartTime8) Argument Data type Description plDataNum1 Long* Amount of interval recorded data From 1 to amount of time recording is possible plRepeatCount1 Long* Number of intervals 0: Unlimited From 1 to the limit of digits specified by number of file digits...
  • Page 78: Set Trigger Overall Conditions

    Set trigger overall conditions Definition long __stdcall Ctrs100_SetTriggerCondition(long lDataNum, long lRepeatCount, long lEndTrigger, long lPriDataNum, long lPostDataNum) Argument Data type Description lDataNum Long Amount of trigger recorded data 0: Specify if end trigger exists From 1 to amount of time recording is possible lRepeatCount Long Trigger repeat count...
  • Page 79: Load Trigger Overall Conditions

    Load trigger overall conditions Definition long __stdcall Ctrs100_GetTriggerCondition(long *plDataNum1, long *plRepeatCount1, long *plEndTrigger1, long *plPriDataNum1, long *plPostDataNum1) Argument Data type Description plDataNum1 Long* Amount of trigger recorded data 0: Specify if end trigger exists From 1 to amount of time recording is possible plRepeatCount1 Long* Trigger repeat count...
  • Page 80: Set Analog Trigger Conditions

    Set analog trigger conditions Definition long __stdcall Ctrs100_SetAnalogTriggerCondition (long *plStartCondition4,, Char *pszStartLevel28,, long *plEndCondition4, char *pszEndLevel28) Argument Data type Description plStartCondition4[] Description plStartCondition4 Long* Start trigger channel (1 to 32) Start trigger slope 0: UP 1: DOWN Start trigger level (AD) ±8192000 Reserve pszStartLevel28...
  • Page 81: Load Analog Trigger Conditions

    Load analog trigger conditions Definition long __stdcall Ctrs100_GetAnalogTriggerCondition (long *plStartCondition4,, Char *pszStartLevel28,, long *plEndCondition4, char *pszEndLevel28) Argument Data type Description plStartCondition4[] Description plStartCondition4 Long* Start trigger channel Start trigger slope Start trigger level (AD) reserve pszStartLevel28 Char* Start trigger level (physical amount) plEndCondition4[] Description plEndCondition4...
  • Page 82: Set External Trigger Conditions

    Set external trigger conditions Definition long __stdcall Ctrs100_SetExTriggerCondition(long lStartSlope, long lEndSlope) Argument Data type Description lStartSlope Long Start trigger slope 0: UP 1: DOWN lEndSlope Long End trigger slope 0: UP 1: DOWN Notes If a parameter was changed using this function, in order to configure CTRS, make sure to execute Ctrs100_MES1().
  • Page 83: Set Compound Trigger Conditions

    Set compound trigger conditions Definition long __stdcall Ctrs100_SetExternalTriggerCondition (long *plAndOr4, long *plStartCondition20, long *plEndCondition20) Argument Data type Description Start/end AND/OR setting (0: OR, 1: AND) plAndOr4 Long* plAndOr4[] Description Analog trigger CH1 and CH2 AND/OR setting Analog trigger CH3 and CH4 AND/OR setting AND/OR setting for two settings listed above...
  • Page 84: Load Compound Trigger Conditions

    Reserve plEndCondition20 Long* End compound trigger conditions Refer to start compound trigger conditions Notes If a parameter was changed using this function, in order to configure CTRS, make sure to execute Ctrs100_MES1(). Load compound trigger conditions Definition long __stdcall Ctrs100_GetExternalTriggerCondition (long *plAndOr4, long *plStartCondition20, long *plEndCondition20)
  • Page 85: Set Marker Name

    Manual trigger 0: Disabled 1: Enabled reserve plEndCondition20 Long* End compound trigger conditions Refer to start compound trigger conditions Notes To obtain the latest information in CTRS, before executing this function, execute Ctrs100_MES0(). Set marker name Definition long __stdcall Ctrs100_SetMakerInfo(long lMakerNo, char *pszMakerInfo128) Argument Data type...
  • Page 86: Load Test Information

    Load test information Definition long __stdcall Ctrs100_GetTestInfo(long lTestNo, char *pszTestInfo128) Argument Data type Description lTestNo Long Number of arbitrary test information to load (1 to 10) pszTestInfo128 Char* Arbitrary test information Notes To obtain the latest information in CTRS, before executing this function, execute Ctrs100_MES0().
  • Page 87: Set Channel Conditions

    Set channel conditions Definition long __stdcall Ctrs100_SetChCondition(long lChNo, long lSetItem, long *plChCond16, char *pszCoeff28, char *pszOffset28, char *pszCable28, char *pszUnit32, char *pszName128) Argument Data type Description lChNo Long Channel number (0 to 31) lSetItem Long Bit-compatible 0x00000001 Measurement ON/OFF 0x00000002 Mode number 0x00000004 Range number...
  • Page 88 Balancing ON/OFF 0: OFF 1: ON 2: NONE Input check (bit-compatible) 0x00: OFF 0x02: Input resistance 0x04: Burnout Number of digits after decimal point -1: Automatic Upper limit check value (*) Full scale ±100% Lower limit check value (*) Full scale ±100% Reserve Reserve Reserve...
  • Page 89: Load Channel Conditions

    Load channel conditions Definition long __stdcall Ctrs100_GetChCondition(long lChNo, long *plChCond16, char *pszCoeff28, char *pszOffset28, char *pszCable28, char *pszUnit32, char *pszName128) Argument Data type Description lChNo Long Channel number (0 to 31) plChCond16[] Description plChCond16 Long* Measurement ON/OFF -1: No channel 0: Do not measure 1: Measure Mode number...
  • Page 90: Set Offset Zero Conditions

    Reserve Reserve Reserve pszCoeff28 Char* Calibration factor pszOffset28 Char* Offset pszCable28 Char* Cable factor pszUnit32 Char* Unit character string pszName128 Char* Channel name Notes To obtain the latest information in CTRS, before executing this function, execute Ctrs100_MES0(). Set offset zero conditions Definition long __stdcall Ctrs100_SetChOffsetZero(long lChNo, long lOnOff,...
  • Page 91: Set Channel Name

    Set channel name Definition long __stdcall Ctrs100_SetChNameEx(long lChNo, char *pszChName32) Argument Data type Description lChNo Long Channel number (0 to 31) pszChName32 Char* Channel name (up to 31 characters, "." cannot be used) Notes If a parameter was changed using this function, in order to configure CTRS, make sure to execute Ctrs100_MES1().
  • Page 92: Load Teds Information For Channel Conditions

    Load TEDS information for channel conditions Definition long __stdcall Ctrs100_GetChTeds(long lChNo, char *pszUserData32, char *pszSerialNo16, char *pszType32, char *pszRomId32) Argument Data type Description lChNo Long Channel number (0 to 31) pszUserData32 Char* TEDS user data pszSerialNo16 Char* Sensor manufacturing number pszType32 Char* Sensor model...
  • Page 93: Load Rated Capacity, Etc. Settings

    Load rated capacity, etc. settings Definition long __stdcall Ctrs100_GetChRatedCapacity (long lChNo, long *plEnable1, char *pszRatedCapacity28 char *pszRatedOutput28, char *pszRatedOutputStrain28) Argument Data type Description lChNo Long Channel number plEnable1 Long Rated capacity and rated output information status 0: Rated capacity and rated output information disabled 1: Set rated capacity and rated output (sensor output) 2: Set rated capacity, rated output (sensor output), and rated output (mV/V)
  • Page 94: Convert Ks3 File On A Pc Into Csv File

    Convert KS3 file on a PC into CSV file Definition long __stdcall Ctrs100_ExeConvertKs3ToCsv (char *pszFileName260) Argument Data type Description pszFileName260 Char* Absolute path of KS3 file to convert (including extension) Notes When this function is executed, the CSV file will be output in the same folder as the selected KS3 file.
  • Page 95: Obtain Exedownloadfile And Execonvertks3Tocsv Progress

    Obtain ExeDownloadFile and ExeConvertKs3ToCsv progress Definition long __stdcall Ctrs100_ReturnProgress(long* plProgress) Argument Data type Description plProgress Long* Progress (0 to 100) Notes Stop ExeDownloadFile and ExeConvertKs3ToCsv operations Definition long __stdcall Ctrs100_StandStopFlag() Argument Data type Description None If suspending Ctrs100_ExeDownloadFile() and Notes Ctrs100_ExeConvertKs3ToCsv() operations, make sure to execute this function.

Table of Contents