Hioki BT4560 Instruction Manual

Hioki BT4560 Instruction Manual

Communication command for battery impedance meter
Hide thumbs Also See for BT4560:
Table of Contents

Advertisement

Quick Links

Communication Command Instruction Manual
This manual explains the communication commands for Model BT4560 Battery
Impedance Meter.
Please refer to the instruction manual for Model BT4560 for details regarding
command settings.
Although all reasonable care has been taken in the production of this manual, should you
find any points which are unclear or in error, please contact your local distributor or the
HIOKI International Sales Department at os-com@hioki.co.jp.
In the interest of product development, the contents of this manual may be subject to
revision without notice.
Unauthorized copying and replication of the contents of this instruction manual are strictly
prohibited. All Rights Reserved.
Battery Impedance Meter
Issued in November 2014 BT4560A987-00
BT4560

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the BT4560 and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Hioki BT4560

  • Page 1 This manual explains the communication commands for Model BT4560 Battery  Impedance Meter. Please refer to the instruction manual for Model BT4560 for details regarding  command settings. Although all reasonable care has been taken in the production of this manual, should you ...
  • Page 2: Table Of Contents

    Contents 1 Introduction ............................1 Message Format ............................. 1 Output Queue and Input Buffer ......................5 Status Byte Register ..........................6 Event Registers ............................8 Initialization Items ..........................11 Local Function ............................11 Command Execution Time ........................12 Errors During Communications ......................12 2 Message List ............................
  • Page 3 Zero Adjustment ........................27 (13) :ADJust ............................27 :ADJust:CLEar ..........................27 :ADJust:DATA:ALL? ........................28 :ADJust:DATA:SPOT? ........................29 :ADJust:STATe? ..........................29 Self-Calibration ........................30 (14) :CALibration ............................. 30 :CALibration:AUTO .......................... 30 Comparator ..........................30 (15) :CALCulate:LIMit:STATe ........................30 :CALCulate:LIMit:BEEPer ....................... 30 :CALCulate:LIMit:ABS ........................
  • Page 4: Introduction

    1 Introduction If the [COMMAND MONITOR] function is used at the time of program creation, commands and responses will be conveniently displayed on the measurement screen. For information on the [COMMAND MONITOR] function, see the instruction manual of the instruments. Various messages are supported for controlling the instrument through the interfaces.
  • Page 5  Response Messages When a query message is received, its syntax is checked and a response message is generated. command determines whether headers are prefixed to response messages. :SYSTem:HEADer Header ON :RANGE 3.0000E-3 Header OFF 3.0000E-3 (The current measurement range is 3mΩ) At power-on, Header OFF is selected.
  • Page 6  Message Terminators This instrument recognizes the following message terminators (delimiters): • • CR+LF Also the terminator for response messages is as follows: • CR+LF  Separators (1) Message Unit Separator Multiple messages can be written in one line by separating them with semicolons “;” :FREQUENCY 1000;...
  • Page 7  Data Formats The instrument uses character data, decimal numeric data and character string data depending on the command. (1) Character Data Character data always begins with an alphabetic character, and subsequent characters may be either alphabetic or numeric. Character data is not case-sensitive, although response messages from the instrument are only upper case.
  • Page 8: Output Queue And Input Buffer

     Compound Command Header Omission When several commands having a common header are combined to form a compound command (for example, if they are written together :CALCulate:LIMit:RESistance :CALCulate:LIMit:VOLTage), in sequence, the common portion (here, ) may be omitted after its initial occurrence. :CALCulate:LIMit: This common portion is called the “current path”...
  • Page 9: Status Byte Register

    Status Byte Register Standard Event Register Description Output Queue data information Each of these bits corresponds to a specific event register bit7 bit6 bit5 bit4 bit3 bit2 bit1 bit0 Status Byte Unused Unused Unused Unused ESB1 ESB0 Register (STB) ↑ ↓...
  • Page 10  Status Byte Register (STB) When any Status Byte Register bit enabled by the Service Request Enable Register has switched from 0 to 1, the MSS bit becomes 1. Although the MSS bit is only read by an query, it is not cleared until a clear event is initiated by the *STB? *CLS command.
  • Page 11: Event Registers

    Event Registers  Standard Event Status Register (SESR) The Standard Event Status Register is an 8-bit register. If any bit in the Standard Event Status Register is set to 1 (after masking by the Standard Event Status Enable Register), bit 5 (ESB) of the Status Byte Register is set to 1. See: “Standard Event Status Register (SESR) and Standard Event Status Enable Register (SESER)”...
  • Page 12  Standard Event Status Enable Register (SESER) Setting any bit of the Standard Event Status Enable Register to 1 enables access to the corresponding bit of the Standard Event Status Register. Standard Event Status Register (SESR) and Standard Event Status Enable Register (SESER) Status Byte Register (STB) bit6 bit5...
  • Page 13 Event Status Register 0 (ESR0) Bit 7 Unused Bit 6 Unused Bit 5 Measurement Fault Bit 4 V-Hi V Measurement High Comparator Result Bit 3 V-IN V Measurement IN Comparator Result Bit 2 V-Lo V Measurement Low Comparator Result Bit 1 INDEX End of Reading Bit 0...
  • Page 14: Initialization Items

     Register Reading and Writing Register Read Write Status Byte Register *STB? Service Request Enable Register *SRE? *SRE Standard Event Status Register *ESR? Standard Event Status Enable Register *ESE? *ESE Event Status Register 0 :ESR0? Event Status Enable Register 0 :ESE0? :ESE0 Event Status Register 1...
  • Page 15: Command Execution Time

    Command Execution Time Command execution time indicates the time for analyzing and processing long form commands. • Display delays may occur depending on the frequency of communication processes and process contents. • All commands except are processed sequentially. :INIT • In communications with the controller, time must be added for data transmission. Transfer time depends on the controller.
  • Page 16: Message List

    *STB? (0 to 255) Queries the Status Byte Register. *TRG Executes one sampling. Instrument Model Name :QPID (BT4560) Queries the instrument model name. Event Registers Sets the Event Status Enable :ESE0 0 to 255 Register 0. Queries the Event Status Enable...
  • Page 17 Message Data Formats Description [ ]: Omissible [ ]: Omissible ( ): Response data Voltage Limit :LIMiter 1/0/ON/OFF Sets the voltage limit function. :LIMiter? (ON/OFF) Queries the voltage limit function. <Voltage limit value> :LIMiter:VOLTage Sets the voltage limit value. =0.01 to 5.00 :LIMiter:VOLTage? (<Voltage limit value>) Queries the voltage limit value.
  • Page 18 Message Data Formats Description [ ]: Omissible [ ]: Omissible ( ): Response data Queries the upper/lower limits for the phase :CALCulate:LIMit:PHASe? (<Upper limit>,<Lower limit>) component. Sets the upper/lower limits for the voltage :CALCulate:LIMit:VOLTage <Upper limit>,<Lower limit> component. Queries the upper/lower limits for the voltage :CALCulate:LIMit:VOLTage? (<Upper limit>,<Lower limit>) component.
  • Page 19: Message Reference

    3 Message Reference Message Reference Interpretation < >: Indicates the contents (character or numeric parameters) of the data portion of a message. Character parameters are returned as all capital letters. Numeric Parameters: • Number format may be any of NR1, NR2 and NR3 Integer data (e.g.: +12, -23, 34) •...
  • Page 20: Standard Commands

    *IDN? <Manufacturer name>,<Model name>, <Serial number>, <Software version> Response *IDN? Example HIOKI, BT4560,123456,V1.00 The Instrument ID is HIOKI BT4560, serial number 123456, software version 1.00. (2) Internal Operation Command Initialize Instrument (Normal Reset) Syntax Command *RST Resets the instrument to factory settings excluding the communication state, ,...
  • Page 21: Synchronization Commands

    (3) Synchronization Commands Set OPC bit of SESR when Finished with All Pending Operations Syntax Command *OPC Sets OPC bit 0 of the Standard Event Status Register (SESR) when all commands prior Description *OPC have finished processing. A;B;*OPC;C Example The OPC bit of SESR is set after A and B command processing has been completed. Respond with ASCII “1”...
  • Page 22: Ese

    Set and Query Standard Event Status Enable Register (SESER) Command <0 to 255(NR1)> Syntax *ESE Query *ESE? <0 to 255(NR1)> Response The SESER mask is set to the numerical value 0 to 255. The initial value (at Description Command power-on) is 0. The contents of the SESER, as set by the *ESE command, are returned as...
  • Page 23: Sre

    Set and Query Service Request Enable Register (SRER) Command <0 to 255 (NR1)> Syntax *SRE Query *SRE? <0 to 255 (NR1)> Response The SRER mask is set to the numerical value 0 to 255. Description Command Although NRf numerical values are accepted, values to the right of the decimal are rounded to the nearest integer.
  • Page 24: Trg

    Query Instrument Model Name (Identification Code) Syntax Query :QPID BT4560 Response :QPID Example BT4560 The instrument model name is BT4560. (2) Event Status Register Set and Query Device-Specific Event Status Enable Register ESER0 <0 to 255 (NR1)> Syntax Command :ESE0 Query :ESE0? <0 to 255 (NR1)>...
  • Page 25: Esr0

    Query Device-Specific Event Status Register ESR0 Query :ESR0? Syntax <0 to 255 (NR1)> Response For the description of each ESR0 register, see the :ESE0 command table. Note Executing ESR0? clears the contents of ESR0. Set and Query Device-Specific Event Status Enable Register ESE1 Syntax Command :ESE1...
  • Page 26: Measurement Functions

    (4) Measurement Functions Set and Query Measurement Functions <RV / ZV / R / Z / V> Command :FUNCtion Syntax Query :FUNCtion? <RV / ZV / R / Z / V> Response RV…(R,X,V,T) function (resistance, reactance, voltage, temperature) ZV…(Z,θ,V,T) function (impedance, phase angle, voltage, temperature) R…..(R,X,T) function (resistance, reactance, temperature) Z…..(Z,θ,T) function (impedance, phase angle, temperature) V…..(V,T) function (voltage, temperature)
  • Page 27: Measurement Range

    (6) Measurement range Set and Query Measurement Range <Measurement range> Command :RANGe Syntax Query :RANGe? <Measurement range (Ω)> Response <Measurement range (Ω)> = 0.0~120.0E-03(NR3) Command Description • 0.0 ≤ <Measurement range (Ω)> ≤ 3.0E-03 Measurement range is set to 3mΩ. •...
  • Page 28: Sample Delay

    (8) Sample Delay Set and Query Sample Delay Mode <WAVE / VOLTage> Command :SAMPle:DELay:MODE Syntax :SAMPle:DELay:MODE? Query <WAVE / VOLTAGE> Response <WAVE> = Sets the sample delay with the frequency of the alternating current signal. <VOLTage> = Sets the sample delay with the deviation of voltage fluctuation. :SAMP:DEL:MODE WAVE Example Sets the mode to execute the sample delay with the frequency of the alternating current...
  • Page 29: Potential Slope Correction

    (9) Potential Slope Correction Set and Query Potential Slope Correction <1 / 0 / ON / OFF> Syntax Command :ADJust:SLOPe :ADJust:SLOPe? Query <ON / OFF> Response :ADJ:SLOP ON Example :ADJ:SLOP? (10) Voltage Limit Set and Query Voltage Limit Function <1 / 0 / ON / OFF> :LIMiter Syntax Command...
  • Page 30: Averaging

    (12) Averaging Set and Query Measurement Averaging <Count> Command :CALCulate:AVERage Syntax Query :CALCulate:AVERage? <Count> Response <Count> = 1 to 99 (NR1) Only the number of impedance measurement values specified in <Count> are averaged and output. :CALC:AVER 10 Example :CALC:AVER? (13) Zero Adjustment Execute Zero Adjustment and Query Result <SPOT / ALL>...
  • Page 31: Adjust:data:all

    Query Zero Adjustment Value (ALL) <V / R / RV> Query :ADJust:DATA:ALL? Syntax <Voltage adjusted value>, <Resistance adjusted value at 100Hz>, < Response Reactance adjusted value at 100Hz>, <Resistance adjusted value at 1kHz >, <Reactance adjusted value at 1kHz> Query <V>...
  • Page 32: Adjust:data:spot

    Query Zero Adjustment Value (SPOT) <V / R / RV> Query :ADJust:DATA:SPOT? Syntax <Voltage adjusted value>, <Resistance adjusted value>, <Reactance Response adjusted value> Query <V> Queries the voltage adjusted value. Description <R> Queries the resistance/reactance adjusted value at the currently set frequency.
  • Page 33: Self-Calibration

    (14) Self-Calibration Execute Self-Calibration :CALibration Command Syntax If this command is received while measuring, self-calibration executes after the Note measurement is finished. Execute and Set Self-Calibration <1 / 0 / ON / OFF> :CALibration:AUTO Syntax Command :CALibration:AUTO? Query <ON / OFF> Response <ON>...
  • Page 34: Calculate:limit:abs

    Set and Query Judgement of Voltage Component Comparator with Absolute Value <1 / 0 / ON / OFF > :CALCulate:LIMit:ABS Syntax Command :CALCulate:LIMit:ABS? Query <ON / OFF > Response :CALC:LIM:ABS ON Example Sets the judgement of the voltage component comparator to be performed with the absolute value.
  • Page 35: Calculate:limit:reactance

    Set and Query Reactance Component Comparator Upper/Lower Limit <Upper limit>,<Lower limit> :CALCulate:LIMit:REACtance Syntax Command :CALCulate:LIMit: REACtance? Query <Upper limit (Ω)>,<Lower limit (Ω)> Response <Upper limit (Ω)> = -1.20000E-01 to +1.20000E-01(NR3), or OFF Command <Lower limit (Ω)> = -1.20000E-01 to +1.20000E-01(NR3), or OFF If the upper limit is set to a value out of above range, the upper limit becomes OFF.
  • Page 36: Calculate:limit:phase

    Set and Query Phase Component Comparator Upper/Lower limit <Upper limit>,<Lower limit> :CALCulate:LIMit:PHASe Syntax Command Query :CALCulate:LIMit: PHASe? <Upper limit (°)>,<Lower limit (°)> Response <Upper limit (°)> = -1.80000E+02 to +1.80000E+02(NR3), or OFF Command <Lower limit (°)> = -1.80000E+02 to +1.80000E+02(NR3), or OFF If the upper limit is set to a value out of above range, the upper limit becomes OFF.
  • Page 37: Saving And Reading Measurement Conditions

    (16) Saving and Reading Measurement Conditions Save and Read Measurement Conditions <Save No.> :SAVE Command Syntax <Save No.> :LOAD <Save No.> = 1 to 126 (NR1) :SAVE 10 Example :SAVE:CLE 10 :LOAD 5 :SAVE is executed when measurement conditions for the <Save No.> have previously Note been saved, the saved measurement conditions will be overwritten.
  • Page 38: Key-Lock

    (19) Key-Lock Set and Query Key-Lock State <1 / 0 / ON / OFF> Command :SYSTem:KLOCk Syntax :SYSTem:KLOCk? Query <ON /OFF> Response :SYST:KLOC ON Example :SYST:KLOCK? (20) Communications Settings Return to Local Control :SYSTem:LOCal Syntax Command Disables communications remote control and re-enables local control. The panel keys Description are re-enabled.
  • Page 39: Lcd Settings

    (23) LCD Settings Set and Query Contrast <Contrast> Command :SYSTem:DISPlay:CONTrast Syntax :SYSTem:DISPlay:CONTrast? Query <Contrast> Response <Contrast> = <0 to 100> :DISP:CONT 50 Example Set the display contrast to 50%. :DISP:CONT? The display contrast has been set to 50%. Set and Query Backlight <Brightness>...
  • Page 40: Triggering

    (24) Triggering Relationship between Trigger Source and Continuous Measurement Operation :INITIATE:CONTINUOUS Operation depends on the continuous measurement setting ( ) (p.38) and the :TRIGGER:SOURCE trigger source setting ( ) (p.38) as follows. See: “5 Data Exporting Methods” (p.44) Continuous Measurement Command-Specific Settings Measurement Flow :INITIATE:CONTINUOUS ON...
  • Page 41: Initiate:continuous

    Set and Query Continuous Measurement <1/0/ON/OFF> Syntax Command :INITiate:CONTinuous Query :INITiate:CONTinuous? <ON/OFF> Response <ON> = Continuous Measurement Enabled <OFF> = Continuous Measurement Disabled • Continuous Measurement Enabled: Description After measurement, enters the Trigger Wait State. When there is an internal trigger (trigger source <IMMEDIATE>), the next trigger is promptly generated and enters a free run state.
  • Page 42: Initiate

    Transit to Trigger Waiting State :INITiate Syntax Command Switches triggering from the Idle State to the Trigger Wait State. Description Disable continuous measurement, and read one value for each trigger event. Example :TRIG:SOUR IMM ..Set the trigger source to internal triggering. Example :INIT ........
  • Page 43: Reading Measured Values

    (25) Reading Measured Values Measurement Value Formats • Impedance (absolute value display: unit Ω) Measured Value Measurement Fault See: Measurement Value Formats(Measurement Fault) (p.40) + □ . □□□□□ E-0□ • Phase angle (absolute value display: unit °) Measured Value Measurement Fault See: Measurement Value Formats(Measurement Fault) (p.
  • Page 44: Abort

    Abort Measurement :ABORt Syntax Query Measurement is abort (forced termination). Description :READ? cannot be abort. :TRIG:SOUR EXT Example :INIT:CONT ON *TRG :ABOR Aborts a measurement. :TRIG:SOUR EXT :INIT:CONT ON *TRG;*WAI :ABOR In this case, a measurement cannot be aborted because the instrument waits the measurement to finish.
  • Page 45: Fetch

    Read Most Recent Measurement Value :FETCh? Syntax Query <Total judgment result>,<Measurement value>,<Judgment result> Response ,<Measurement value>,<Judgment result>, … See: “Measurement Value Formats” (p.40) Reads the most recent impedance and voltalge measurement. No trigger occurs. Description See: Data Exporting Methods (p.44), Triggering (p.37) For (R,X,V,T) measurement, the response is as follows.
  • Page 46: Read

    Measure (Await Triggers and Read Measurements) :READ? Syntax Query <Total judgment result>,<Measurement value>,<Judgment result> Response ,<Measurement value>,<Judgment result>, … See: “Measured value Formats” (p.40) Switches from the Idle State to the Trigger Wait State, then reads the next measured Description value.
  • Page 47: Data Exporting Methods

    5 Data Exporting Methods Basic Data Exporting Methods Flexible data exporting is available depending on the application. Export Free-Run Data Default Setting :INITiate:CONTinuous ON (continuous measurement enable) :TRIGger:SOURce IMMediate (internal triggering) Exporting :FETCh? Imports the most recent measurement. Export by Controller (PC, PLC) Triggering Default Setting (continuous measurement disable) :INITiate:CONTinuous OFF...
  • Page 48 Using the :FETCh? Command during Continuous Measurement with Internal Triggering Measuring Measuring Measuring Measuring Measuring Measurement Processing Measurement Measurement Measurement Measurement Measurement value value value value value Measured Value Update Command Processing Returns the last measured value to the PC Response This is the simplest method for exporting measured values.
  • Page 49: Sample Programs

    6 Sample Programs These programs can be created using Visual Basic 5.0, 6.0 or Visual Basic2013. Visual Basic is a registered trademark of Microsoft Corporation. Using Visual Basic 5.0 or 6.0 These sample programs are created with Microsoft Visual Basic 5.0 and 6.0. The following are used for communication: For RS-232C/USB communication: MSComm from Visual Basic Professional...
  • Page 50: Measure By Pc Key

     Measure by PC Key Measures and imports by key input on the PC, and saves measurements in a text file. Private Sub MeasureReadSubRS() Dim recvstr As String 'Receiving character string Dim i As Integer MSComm1.CommPort = 1 'COM1 (Check a communication port) MSComm1.Settings = "9600,n,8,1"...
  • Page 51: External Trigger Measurement

     External Trigger Measurement Measures and imports based on external triggering (TRIG signal input), and saves measurements in a text file. Private Sub MeasureTrigSubRS() Dim recvstr As String 'Receiving character string Dim i As Integer MSComm1.CommPort = 1 'COM1 (Check a communication port) MSComm1.Settings = "9600,n,8,1"...
  • Page 52: Set Measurement Conditions

     Set Measurement Conditions Sets up the measurement setting state. 'Measurement Setting Configuration 'Configures instrument settings for measurement 'Function: [R, X, V, T] 'Measurement frequency: 1000Hz 'Range: 100mΩ 'Z sampling: FAST, V sampling: FAST 'Trigger: Internal triggering 'Comparator enabled, beep upon Hi or Lo 'Resistance: Upper limit 100mΩ, lower limit 50mΩ...
  • Page 53: Using Visual Basic2013

    Using Visual Basic2013 This section describes an example of how to use the Windows development language, Visual Basic2013 Express Edition, to operate the BT4560 unit from a PC via an RS232C/USB interface, incorporate measurement values, and save measurement values to a file.
  • Page 54 2. Place a button. 1. Click [Button] from [Common Controls] of [Toolbox]. 2. Drag and drop the button onto the form layout screen. Click Drag 3. Change [Text] to “Start Measurement” from the Properties window.
  • Page 55 4. The [Start Measurement] is placed on the form. 3. Place a serial communication component. 1. Click [SerialPort] from [Components] of [Toolbox]. 2. Drag and drop the [SerialPort] component onto the form layout screen. Drag Click...
  • Page 56 3. Change [PortName] to the port name to use for communication from the Properties window. Check the port to use for communication beforehand. 4. Describe the code. 1. Double-click the placed button to display the code editor. Double-click...
  • Page 57 2. Enter the sample program into the code editor. 3. Select [Save All] from the [File] menu. Click...
  • Page 58 Shown below is a sample program which uses VB2013 to initiate RS-232C/USB communications, set the instrument measurement conditions, read measurement results, and then save them to file. The sample program will be written in the following manner. Description of creation procedure Description in sample program Button created to begin measurement Button1...
  • Page 59 Imports System Imports System.IO Imports System.IO.Ports Public Class Form1 'Perform process when Button1 is pressed Private Sub Button1_Click(sender As Object, e As EventArgs) Handles Button1.Click Dim recvstr As String Dim i As Integer Button1.Enabled = False 'Disable buttons during communication ....(a) Button2.Enabled = False SerialPort1.NewLine = vbCrLf 'Terminator setting ..........

Table of Contents