Escolar Documentos
Profissional Documentos
Cultura Documentos
A command line programming tool for A3 ALPHA and A1800 ALPHA meters
www.elster.com
Contents
Contents
Using MetercatLite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7 About the command file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7 Using command line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7 Using the MetercatLite command . . . . . . . . . . . . . . . . . . . . . . .8 Example MetercatLite command line (explicit) . . . . . . . . . .8 Example MetercatLite command line (basic) . . . . . . . . . . .8 Using meter passwords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8 Viewing MetercatLite command line help . . . . . . . . . . . . . . . . .8 Viewing MetercatLite version information . . . . . . . . . . . . . . . . .9 Changing the language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Programming a meter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Completion report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Command file parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Using special characters in parameters . . . . . . . . . . . . . . . . . 14 Global . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 REPORT_FILENAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 SHOW_PROGRESS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Communication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 PORT_NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 BAUD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 USER_ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 PASSWORD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 PROGRAM_FILENAME . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 METER_ID_1_MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 METER_ID_1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 METER_ID_2_MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 METER_ID_2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 LINE_FREQUENCY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 USE_SYSTEM_TIME_ZONE . . . . . . . . . . . . . . . . . . . . . . . . 19 TIME_ZONE_NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 METERING_APP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 CT and VT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 DEMAND_OVERLOAD . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 USE_ADJUSTED_KH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 ADJUSTED_KH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Contents
REGISTER_MULTIPLIER . . . . . . . . . . . . . . . . . . . . . . . . . . . KYZ_VALUE and KYZ_DIVISOR . . . . . . . . . . . . . . . . . . . SERVICE_TEST_COMP_MODE . . . . . . . . . . . . . . . . . . . . SERVICE_TEST_COMP_FILENAME . . . . . . . . . . . . . . . . . PQM_COMP_MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . PQM_COMP_FILENAME . . . . . . . . . . . . . . . . . . . . . . . . . INSTRUM_PROFILE_COMP_MODE . . . . . . . . . . . . . . . . INSTRUM_PROFILE_COMP_FILENAME . . . . . . . . . . . . . REMOTE_COMP_MODE . . . . . . . . . . . . . . . . . . . . . . . . . REMOTE_COMP_FILENAME . . . . . . . . . . . . . . . . . . . . . . PORT_x_DEVICE_ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . ACB C12.21 protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . ACB Modbus protocol . . . . . . . . . . . . . . . . . . . . . . . . . . ACB DNP protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ACB DL/T protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Alternative Time Setting parameters . . . . . . . . . . . . . . . . TIME_ZONE_OFFSET . . . . . . . . . . . . . . . . . . . . . . . . . . . . DST_OFFSET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DST_SWITCH_TIME.HOUR . . . . . . . . . . . . . . . . . . . . . . . DST_SWITCH_TIME.MINUTE . . . . . . . . . . . . . . . . . . . . . .
22 22 22 22 23 23 23 23 23 24 24 24 25 25 25 26 26 26 26 26
1. Introduction
Introduction
What is MetercatLite?
MetercatLite allows users to use command line (cmd.exe) to program A3 ALPHA meters using the optical port of the meter. MetercatLite uses the following files when programming a meter: a command file specifying the configuration parameters for the program task (usually a modified version of the detaults.txt file) See Command.txt on page 31. a Metercat PED file containing the program to be written to the meter a TXT file (defaults.txt) specifying default values for the configuration parameters If a configuration parameter is specified in the command file too, then the command file value will override the default value specified in defaults.txt. See Defaults.txt on page 27.
Note: You can edit the defaults.txt to change a default value of a parameter (for example, COM port number). Note: You can create and use customized versions of the defaults.txt file for use with different meter types. To use a customized defaults file explicitly name the defaults file in the MetercatLite command line. See Example MetercatLite command line (explicit) on page 8.
1. Introduction
The MetercatLite programming process operates as follows: 1. Open a command prompt window. 2. At the prompt, navigate to the location of MetercatLite.exe. 3. At the prompt, type:
MetercatLite <command file>
where: <command file> specifies the full path and file name of the command file
Note: The full path can be specified (for example, C:\myfolder\sample_cmd_file.txt). If only the file name is specified, MetercatLite will search for the file in the current folder.
4. Press <Enter>. MetercatLite identifies the connected meter and attempts to program the meter using the PED file specified in the command file. Parameters not specified in the command file or the program PED file are read from the defaults.txt file.
System requirements
Windows 2000 SP4, Windows XP or Windows Vista Microsoft Internet Explorer 4.0 or higher An optical probe, such as the Elster UNICOM III USB Optical Probe, for communicating to A3 ALPHA meters
Installing MetercatLite
Note: MetercatLite does not require Metercat to be installed on the same computer. However, you will need access to a computer with Metercat to export the PED files used by MetercatLite. Note: Elster recommends that non-administrative users copy the defaults.txt and any command files to a folder location that is accessible to them and allows editing and saving of the files.
To install MetercatLite, follow the instructions in the Metercat Getting Started Guide.
2. Using MetercatLite
Using MetercatLite
2. Using MetercatLite
The password value specified at the command line overrides any passwords specified in the command or defaults file (PASSWORD parameter). The command line /pwd option can be used to avoid specifying any password in the command and defaults files.
2. Using MetercatLite
10
2. Using MetercatLite
where: ll is the ISO 639 two-letter language code, and CC is the ISO 3166 two-letter country code.: Languages Included in files English (ANSI markets) Portuguese (Brazil) Russian Romanian Spanish Chinese French For example:
MetercatLite /loc fr_FR
Note: The font used by the command prompt might need to be changed to correctly display certain languages. To change the font click on the command prompt window icon located on the top-left corner of the command prompt window and select Properties > Font.
11
2. Using MetercatLite
Programming a meter
To program a meter using MetercatLite: 1. From the Windows Start menu, select Programs > Accessories > Command Prompt. A Command Prompt window displays. 2. At the prompt, navigate to the \MetecatLite installation folder. 3. To program a meter, at the prompt, type:
MetercatLite <command file>
where: <command file> specifies the full path and file name of the command file
Note: The full path can be specified (for example, C:\myfolder\sample_cmd_file.txt). If only the file name is specified, MetercatLite will search for the file in the current folder.
4. Press <Enter>. MetercatLite identifies the connected meter and attempts to program the meter using the PED file specified in the command file. Parameters not specified in the command file are read from the defaults.txt file.
12
2. Using MetercatLite
Completion report
The MetercatLite Completion Report summarizes all activity performed by the function.
13
2. Using MetercatLite
14
The command and defaults files are organized into the following sections: Global - specifies system parameters Communication - specifies MetercatLite communication parameters Task - specifies task-specific parameters
Global
Example
//**************************************************************************** [GLOBAL] REPORT_FILENAME= "Reports\McatLiteReportProgram.html" SHOW_PROGRESS = TRUE
Parameters
REPORT_FILENAME
The REPORT_FILENAME parameter allows you to specify the path and file name for the MetercatLite Completion Report.
SHOW_PROGRESS
The SHOW_PROGRESS parameter allows you specify whether to display the percent progress of the command execution in the Command Prompt window. See Figure 2-5. Valid values are: FALSE - the percentage completion of task progress will not be displayed in the Command Prompt window TRUE - (default) the percentage completion will be displayed in the Command Prompt window
15
Communication
Example
//**************************************************************************** [COMMUNICATION] // Optical probe port. Format: "COMx" PORT_NAME = "COM4" // Baud rate for optical probe: // 300, 600, 1200, 2400, 4800, 9600, 14400, 19200, 28800, 38400, 57600, 115200 BAUD = 9600 USER_ID = 2 // 2 to 9999
Parameters
PORT_NAME
The PORT_NAME parameter specifies the COM port number used by the optical probe.
PORT_NAME = COM2
BAUD
The BAUD parameter specified the baud rate used by the optical probe. Valid values are: 300 600 1200 2400 4800 9600 - default 14400 19200 28800 38400 57600 115200
BAUD=14400
USER_ID
The USER_ID parameter specifies the identification number of the user executing the command file. This number will be programmed into the meter as the Programmer Number on the meters Status > Identification viewset. Valid values are in the range of 2 to 9999.
USER_ID=2
PASSWORD
The PASSWORD parameter specifies the password that will be used to establish communication with the connected meter.
PASSWORD = 00000000000000000000
16
Task
Example
//**************************************************************************** [TASK="Program"] //PROGRAM_FILENAME = "C:\Program Files\Elster\Metercat\Programs\A3R LP program.ped" // ID1 (Account ID) programming mode: VALUE | FACTORY_SERIAL_NUMBER | UTILITY_SERIAL_NUMBER METER_ID_1_MODE = VALUE // Applied only if METER_ID_1_MODE = VALUE; max length = 20 char METER_ID_1 = "" // ID2 (Meter ID) programming mode: FACTORY_SERIAL_NUMBER | VALUE | UTILITY_SERIAL_NUMBER METER_ID_2_MODE = FACTORY_SERIAL_NUMBER // Applied only if METER_ID_2_MODE = VALUE; max length = 20 char METER_ID_2 = "" // Meter Clock Source: Internal Oscillator used if LINE_FREQUENCY=FALSE LINE_FREQUENCY = TRUE // Use System Time Zone: TRUE | FALSE USE_SYSTEM_TIME_ZONE = TRUE // Meter is programmed according to TIME_ZONE_NAME if USE_SYSTEM_TIME_ZONE = FALSE // See possible values of TIME_ZONE_NAME in the MetercatLite User Guide TIME_ZONE_NAME = "" // Metering Application: PROGRAM_VALUE | PRIMARY | SECONDARY METERING_APP = PROGRAM_VALUE
// CT and VT ratios: These are 'pair' parameters, both of them are overridden or neither are. // If both parameters are not specified then Program Values are used. // If one of these parameters is missing but the other is specified then the task assumes // that the missing parameter has a value of 1.0 and CT VT overrides the Program value. //CT = 1.0 // 1.00 to 9999.99 //VT = 1.0 // 1.00 to 9999.99
// Demand Overload: program value is used when the parameter is commented //DEMAND_OVERLOAD = 0 // 0.0000 to 999999.9999 USE_ADJUSTED_KH = FALSE // Adjusted_Kh is used only if USE_ADJUSTED_KH = TRUE // If USE_ADJUSTED_KH=TRUE and ADJUSTED_KH parameter is commented then minimum value (0.001) is assumed //ADJUSTED_KH = 1.0 // 0.001 to 999.999 // Register_Multiplier is used only if USE_ADJUSTED_KH=FALSE // Register_Multiplier: program value is used when the parameter is commented //REGISTER_MULTIPLIER = 1.0 // 0.1 to 1000000
// KYZ_value and KYZ_divisor: // 1) if both parameters are defined then KYZ_value // is used if the meter supports it, otherwise KYZ_divisor is used // 2) If only one parameter is defined (the other is // commented) then the program task will use exactly that parameter // (if it is not supported the task will fail)
17
// 3) If both parameters are commented then the program value of either KYZ_value // or KYZ_divisor is used, depending on what the meter supports // //KYZ_VALUE = 1 // 0.000001 to 100.000000 //KYZ_DIVISOR = 1 // 1 to 999
// ---- Components Options ---------------------------------------------------// Service Test Component = DO_NOT_CHANGE | PROGRAM_VALUE | OVERRIDE SERVICE_TEST_COMP_MODE = PROGRAM_VALUE SERVICE_TEST_COMP_FILENAME = // PQM component = DO_NOT_CHANGE | PROGRAM_VALUE | OVERRIDE PQM_COMP_MODE = PROGRAM_VALUE PQM_COMP_FILENAME = // Instrumentation Profiling Config Component = DISABLE | PROGRAM_VALUE | OVERRIDE INSTRUM_PROFILE_COMP_MODE = PROGRAM_VALUE INSTRUM_PROFILE_COMP_FILENAME = // Remote component = DO_NOT_CHANGE | DISABLE | PROGRAM_VALUE | OVERRIDE REMOTE_COMP_MODE = PROGRAM_VALUE REMOTE_COMP_FILENAME =
// ---- Remote Component override parameters ---------------------------------// Values specified in the PORT_x_DEVICE_ID parameters are programmed only // if all the following conditions are met: // a) the program contains a Remote component // b) PORT_x is set to Direct Connect or Internal Modem or External Modem PORT_1_DEVICE_ID = 1//1-254; 1= Always Master PORT_2_DEVICE_ID = 1//1-254; 1= Always Master
// Values specified in the PORT_x call origination parameters are programmed only // if all the following conditions are met: // a) the program contains a Remote component // b) PORT_x is set to "Internal Modem" or "External Modem' // c) The remote component has both options 'Enable Billing Calling' and // 'Specify a Single Date and Time at Program Time' set for PORT_x PORT_1_CALL_ORIG_DATE_TIME.YEAR = 90 // YY PORT_1_CALL_ORIG_DATE_TIME.MONTH = 1 PORT_1_CALL_ORIG_DATE_TIME.DAY = 1 PORT_1_CALL_ORIG_DATE_TIME.HOUR = 0 // 0-23 PORT_1_CALL_ORIG_DATE_TIME.MINUTE = 0 PORT_2_CALL_ORIG_DATE_TIME.YEAR = 90// YY PORT_2_CALL_ORIG_DATE_TIME.MONTH = 1 PORT_2_CALL_ORIG_DATE_TIME.DAY = 1 PORT_2_CALL_ORIG_DATE_TIME.HOUR = 0 // 0-23 PORT_2_CALL_ORIG_DATE_TIME.MINUTE = 0
// ---- SpOB Component override parameters ----------------------------------// Program value is used when a parameter is commented // ACB board C1221 protocol parameters //ACB_C1221_IP_ADDRESS = "192.168.0.2" //ACB_C1221_SUBNET_MASK = "255.255.255.0"
18
//ACB_C1221_DEFAULT_GATEWAY = "192.168.0.1" // ACB board MODBUS protocol parameter //ACB_MODBUS_ADDRESS = 1 // 0 to 255 // ACB board DNP protocol parameters //ACB_DNP_SOURCE_ADDR = 1 // 0 to 65519 //ACB_DNP_DESTINATION_ADDR = 2 // 0 to 65519 // ACB board DLT protocol parameter //ACB_DLT_ADDRESS = "123456789012" // string of 12 decimal numbers (each must be 0 to 9)
// ---- Alternative Time setting parameters ---------------------------------// The following parameters can be used alternatively to USE_SYSTEM_TIME_ZONE // and TIME_ZONE_NAME parameters. // TZ Offset in minutes; Default value = 0 (GMT) //TIME_ZONE_OFFSET = 0 // -780 to 780 minutes (-13 to 13 hours) must be divisable by 5 minutes // Daylight Saving time offset in minutes; Default value = 60 minutes //DST_OFFSET = 60 // 0 to 180 minutes (0 to 3 hours) must be divisable by 5 minutes // Daylight Saving time switch time; Default value is 2:00. //DST_SWITCH_TIME.HOUR = 2 // 0 to 23 //DST_SWITCH_TIME.MINUTE = 0 // 0 to 59 //****************************************************************************
Parameters
PROGRAM_FILENAME
The PROGRAM_FILENAME parameter specified the path and file name for the Metercat PED file to be used in programming the connected meter. To use a PED file specified in the command file you must specify the path and file name:
PROGRAM_FILENAME = C:\path\filename.PED
If only the file name is specified, MetercatLite will look for the file in the MetercatLite installation folder.
PROGRAM_FILENAME = filename.PED
METER_ID_1_MODE
The METER_ID_1_MODE (Account ID) parameter specifies the source of the value to be programmed as the ID1. Valid values are: VALUE - (default) uses the value specified by METER_ID_1 in the command file FACTORY_SERIAL_NUMBER - uses the meters factory serial number UTILITY_SERIAL_NUMBER - uses the utilitys serial number stored in the meter
METER_ID_1_MODE = VALUE
METER_ID_1
If the METER_ID_1_MODE is VALUE, the value entered for METER_ID_1 will be programmed as ID1 in the connected meter. A valid value is a maximum of 20 characters in length.
19
METER_ID_2_MODE
The METER_ID_2_MODE (Meter ID) parameter specified the source of the value to be programmed as the ID2. Valid values are: VALUE - uses the value specified by METER_ID_2 in the command file FACTORY_SERIAL_NUMBER - (default) uses the meters factory serial number UTILITY_SERIAL_NUMBER - uses the utilitys serial number stored in the meter
METER_ID_2_MODE = VALUE
METER_ID_2
If the METER_ID_2_MODE is VALUE, the value entered for METER_ID will be programmed as ID2 in the connected meter. A valid value is a maximum of 20 characters in length.
METER_ID_2 = ABCDEFGHIJKLMNOPQRST
LINE_FREQUENCY
The LINE_FREQUENCY parameter specifies the meters clock source. Valid values are: TRUE - (default) the clock source is from the line frequency FALSE - the clock source is the meters internal oscillator
LINE_FREQUENCY = FALSE
USE_SYSTEM_TIME_ZONE
See TIME_ZONE_OFFSET, DST_OFFSET, DST_SWITCH_TIME.HOUR, and DST_SWITCH_TIME.MINUTE for an alternative use for time zone. The USE_SYSTEM_TIME_ZONE parameter specifies whether to use the computers system time zone setting. Valid values are: TRUE - (default) the time zone setting configured on the MetercatLite computer will be programmed into the connected meter FALSE - the value entered for TIME_ZONE_NAME will be programmed into the connected meter
USE_SYSTEM_TIME_ZONE = TRUE
TIME_ZONE_NAME
See TIME_ZONE_OFFSET, DST_OFFSET, DST_SWITCH_TIME.HOUR, and DST_SWITCH_TIME.MINUTE for an alternative use for time zone.
20
If USE_SYSTEM_TIME_ZONE = FALSE, the TIME_ZONE_NAME parameter specifies the time zone programmed into the connected meter. Valid values are: Afghanistan Standard Time Alaskan Standard Time Arab Standard Time Arabian Standard Time Arabic Standard Time Armenian Standard Time Atlantic Standard Time AUS Central Standard Time AUS Eastern Standard Time Azerbaijan Standard Time Azores Standard Time Canada Central Standard Time Cape Verde Standard Time Caucasus Standard Time Cen. Australia Standard Time Central America Standard Time Central Asia Standard Time Central Brazilian Standard Time Central Europe Standard Time Central European Standard Time Central Pacific Standard Time Central Standard Time Central Standard Time (Mexico) China Standard Time Dateline Standard Time E. Africa Standard Time E. Australia Standard Time E. Europe Standard Time E. South America Standard Time Eastern Standard Time Egypt Standard Time Ekaterinburg Standard Time Fiji Standard Time FLE Standard Time Georgian Standard Time GMT Standard Time Greenland Standard Time Greenwich Standard Time GTB Standard Time Hawaiian Standard Time India Standard Time Iran Standard Time Jerusalem Standard Time Jordan Standard Time Korea Standard Time Mexico Standard Time Mexico Standard Time 2 Mid-Atlantic Standard Time Middle East Standard Time Montevideo Standard Time Mountain Standard Time Mountain Standard Time (Mexico) Myanmar Standard Time N. Central Asia Standard Time Namibia Standard Time Nepal Standard Time New Zealand Standard Time Newfoundland Standard Time North Asia East Standard Time North Asia Standard Time Pacific SA Standard Time Pacific Standard Time Pacific Standard Time (Mexico) Romance Standard Time Russian Standard Time SA Eastern Standard Time SA Pacific Standard Time SA Western Standard Time Samoa Standard Time SE Asia Standard Time Malay Peninsula Standard Time South Africa Standard Time Sri Lanka Standard Time Taipei Standard Time Tasmania Standard Time Tokyo Standard Time Tonga Standard Time US Eastern Standard Time US Mountain Standard Time Venezuela Standard Time Vladivostok Standard Time W. Australia Standard Time W. Central Africa Standard Time W. Europe Standard Time West Asia Standard Time West Pacific Standard Time Yakutsk Standard Time
METERING_APP
The METERING_APP parameter specifies the meters position relative to a transformer. Valid values are: PROGRAM_VALUE - default PRIMARY SECONDARY
21
If PROGRAM_VALUE is specified, the setting specified in the PED file will be programmed into the meter. If PRIMARY is specified, transformer ratios will be used to calculate the measured energy and demand quantities. If SECONDARY is specified, transformer ratios will not be used to calculate adjusted Ke and the energy and demand quantities will not be adjusted.
METERING_APP = SECONDARY
CT and VT
The CT and VT parameters specify the transformer ratios used in the meter. Valid values are in the range of 1.00 to 9999.99. If both parameters are not specified then values set in the PED file are used.
//CT = 1.0 //VT = 1.0
These are pair parameters, either both or neither of them are overridden. If one of these parameters is missing but the other is specified then the task assumes the missing parameter has a value of 1.0 and CT VT overrides the PED program value.
//CT = 1.0 VT = 1.0
Or
CT = 1.0 //VT = 1.0
DEMAND_OVERLOAD
The DEMAND_OVERLOAD parameter specifies the demand overload value to be programmed into the meter. Valid values are 0.0000 to 999999.9999.
DEMAND_OVERLOAD=10.0000
To use the value specified in the PED file, comment the parameter using two f-slashes (//):
//DEMAND_OVERLOAD=0
USE_ADJUSTED_KH
The USE_ADJUSTED_KH parameter indicates whether the value specified in the ADJUSTED_KH parameter will be programmed in the meter. Valid values are: TRUE - the ADJUSTED_KH value will be programmed into the meter FALSE - (default) the REGISTER_MULTIPLIER value will be programmed into the meter
USE_ADJUSTED_KH = FALSE
ADJUSTED_KH
If USE_ADJUSTED_KH is TRUE, the ADJUSTED_KH value will be programmed in the meter. The value of REGISTER_MULTIPLIER (if any) is ignored. Valid value is in the range of 0.001 to 999.999.
ADJUSTED_KH = 10.000
If USE_ADJUSTED_KH is TRUE and ADJUSTED_KH is commented using two f-slashes (//), MetercatLite programs ADJUSTED_KH = 0.001.
22
REGISTER_MULTIPLIER
If USE_ADJUSTED_KH = FALSE, the REGISTER_MULTIPLIER parameter value will be programmed in the meter. The value of ADJUSTED_KH (if any) is ignored. Valid values are in the range of 0.1 to 1000000.
REGISTER_MULTIPLIER = 1.0
To use the value specified in the PED file, comment the REGISTER_MULTIPLIER parameter using two f-slashes (//):
//REGISTER_MULTIPLIER = 10.0
To use the value specified in the PED file, comment both parameters using two f-slashes (//). Then the program value of either KYZ_VALUE or KYZ_DIVISOR is used, depending on what the meter supports.
//KYZ_VALUE = 1 //KYZ_DIVISOR = 1
SERVICE_TEST_COMP_MODE
The SERVICE_TEST_COMP_MODE parameter specifies the source for the Service Test component to be programmed into the connected meter. Valid values are: DO_NOT_CHANGE - keep the existing Service Test component that is programmed in the meter PROGRAM_VALUE - (default) use the value specified in the PED file OVERRIDE - overrides the value specified in the PED file using the component specified by SERVICE_TEST_COMP_FILENAME
SERVICE_TEST_COMP_MODE = PROGRAM_VALUE
SERVICE_TEST_COMP_FILENAME
The SERVICE_TEST_COMP_FILENAME parameter specifies the PCD filename of the Service Test Component to be programmed in the meter. This parameter is ignored unless the OVERRIDE option is selected for SERVICE_TEST_COMP_MODE.
SERVICE_TEST_COMP_FILENAME = service_test_comp.pcd
23
PQM_COMP_MODE
The PQM_COMP_MODE parameter specifies the source for the PQM component to be programmed into the connected meter. Valid values are: DO_NOT_CHANGE - keep the existing PQM component that is programmed in the meter PROGRAM_VALUE - (default) use the value specified in the PED file OVERRIDE - overrides the value specified in the PED file using the component specified by PQM_COMP_FILENAME
PQM_COMP_MODE = PROGRAM_VALUE
PQM_COMP_FILENAME
The PQM_COMP_FILENAME parameter specifies the PCD filename of the PQM Component to be programmed in the meter. This parameter is ignored unless the OVERRIDE option is selected for PQM_COMP_MODE.
PQM_COMP_FILENAME = PQM_comp.pcd
INSTRUM_PROFILE_COMP_MODE
The INSTRUM_PROFILE_COMP_MODE parameter specifies the source for the Instrumentation Profiling Config component to be programmed into the connected meter. Valid values are: DISABLE - disables the Instrumentation Profiling Config component PROGRAM_VALUE - (default) use the value specified in the PED file OVERRIDE - overrides the value specified in the PED file using the component specified by INSTRUM_PROFILE_COMP_FILENAME
INSTRUM_PROFILE_COMP_MODE = PROGRAM_VALUE
INSTRUM_PROFILE_COMP_FILENAME
The INSTRUM_PROFILE_COMP_FILENAME parameter specifies the PCD filename of the Instrumentation Profile Component to be programmed in the meter. This parameter is ignored unless the OVERRIDE option is selected for INSTRUM_PROFILE_COMP_MODE.
INSTRUM_PROFILE_COMP_FILENAME = instr_profile_comp.pcd
REMOTE_COMP_MODE
The REMOTE_COMP_MODE parameter specifies the source for the Remote component to be programmed into the connected meter. Valid values are: DO_NOT_CHANGE - keep the existing Instrumentation Profiling Config component that is programmed in the meter DISABLE - disables the Remote component PROGRAM_VALUE - (default) use the value specified in the PED file OVERRIDE - overrides the value specified in the PED file using the component specified by REMOTE_COMP_FILENAME
REMOTE_COMP_MODE = PROGRAM_VALUE
24
REMOTE_COMP_FILENAME
The REMOTE_COMP_FILENAME parameter specifies the PCD filename of the Remote Component to be programmed in the meter. This parameter is ignored unless the OVERRIDE option is selected for REMOTE_COMP_MODE.
REMOTE_COMP_FILENAME = remote_comp.pcd
PORT_x_DEVICE_ID
Values specified in the PORT_x_DEVICE_ID parameters are programmed only if all the following conditions are met: the program contains a Remote component the Remote component Port 1 or Port 2 in the PED file is set to one of the following: Direct Connect Internal Modem External Modem Valid values are 1-254 (where 1= Always Master).
PORT_1_DEVICE_ID = 1 PORT_2_DEVICE_ID = 1
PORT_1_CALL_ORIG_DATE_TIME.YEAR = 90 // YY PORT_1_CALL_ORIG_DATE_TIME.MONTH = 1 PORT_1_CALL_ORIG_DATE_TIME.DAY = 1 PORT_1_CALL_ORIG_DATE_TIME.HOUR = 0 // 0-23 PORT_1_CALL_ORIG_DATE_TIME.MINUTE = 0 PORT_2_CALL_ORIG_DATE_TIME.YEAR = 90// YY PORT_2_CALL_ORIG_DATE_TIME.MONTH = 1 PORT_2_CALL_ORIG_DATE_TIME.DAY = 1 PORT_2_CALL_ORIG_DATE_TIME.HOUR = 0 // 0-23 PORT_2_CALL_ORIG_DATE_TIME.MINUTE = 0
25
the DHCP option is not set in the Special Option Board Component To use the value specified in the PED file, comment a parameter using two f-slashes,//. Then the program value for the ACB C12.21 parameter is used.
ACB_C1221_IP_ADDRESS
The ACB_C1221_IP_ADDRESS parameter specifies the IP address for the C12.21 advanced communications board. ACB_C1221_IP_ADDRESS = "192.168.0.2"
ACB_C1221_SUBNET_MASK
The ACB_C1221_SUBNET_MASK parameter specifies the subnet mask for the C12.21 advanced communications board. ACB_C1221_SUBNET_MASK = "255.255.255.0"
ACB_C1221_DEFAULT_GATEWAY
The ACB_C1221_DEFAULT_GATEWAY parameter specifies the gateway for the C12.21 advanced communications board. ACB_C1221_DEFAULT_GATEWAY = "192.168.0.1"
ACB_MODBUS_ADDRESS
The ACB_MODBUS_ADDRESS parameter specifies the address for the ModBus advanced communications board. ACB_MODBUS_ADDRESS = 1 // 0 to 255
ACB_DNP_SOURCE_ADDR
The ACB_DNP_SOURCE_ADDR parameter specifies the source address for the DNP advanced communications board. ACB_DNP_SOURCE_ADDR = 1 // 0 to 65519
ACB_DNP_DESTINATION_ADDR
The ACB_DNP_DESTINATION_ADDR parameter specifies the destination address for the DNP advanced communications board. ACB_DNP_DESTINATION_ADDR = 2 // 0 to 65519
26
the PED program contains a Special Option Board component the ACB board in the meter has capability to communicate using DL/T protocol To use the value specified in the PED file, comment the parameter using two f-slashes (//). Then the program value for the ACB DLT parameter is used.
ACB_DLT_ADDRESS
The ACB_DLT_ADDRESS parameter specifies the destination address for the DL/T advanced communications board. ACB_DLT_ADDRESS = "123456789012" // string of 12 decimal numbers (each must be 0 to 9)
DST_OFFSET
Daylight Saving Time (DST) offset used by the area. DST_OFFSET = 60 // 0 to 180 minutes (0 to 3 hours) must be divisable by 5 minutes
DST_SWITCH_TIME.HOUR
Hour at which DST goes into effect. DST_SWITCH_TIME.HOUR = 2 // 0 to 23
DST_SWITCH_TIME.MINUTE
Minute at which DST goes into effect. DST_SWITCH_TIME.MINUTE = 0 // 0 to 59
27
A. Defaults.txt
Defaults.txt
The following example illustrates the contents of the defaults.txt file that is installed with MetercatLite software. You may rename and edit the file for creating a variety of default files for use with MetercatLite. For example, you may need a default file for programming different meter types: A3 ALPHA meter, A3 ALPHA node, A3 ALPHA collector, etc.
//**************************************************************************** [TASK="Program"] //PROGRAM_FILENAME = "" // ID1 (Account ID) programming mode: VALUE | FACTORY_SERIAL_NUMBER | UTILITY_SERIAL_NUMBER METER_ID_1_MODE = VALUE // Applied only if METER_ID_1_MODE = VALUE; max length = 20 char METER_ID_1 = "" // ID2 (Meter ID) programming mode: FACTORY_SERIAL_NUMBER | VALUE | UTILITY_SERIAL_NUMBER METER_ID_2_MODE = FACTORY_SERIAL_NUMBER // Applied only if METER_ID_2_MODE = VALUE; max length = 20 char METER_ID_2 = "" // Meter Clock Source: Internal Oscillator used if LINE_FREQUENCY=FALSE LINE_FREQUENCY = TRUE
28
A. Defaults.txt
// Use System Time Zone: TRUE | FALSE USE_SYSTEM_TIME_ZONE = TRUE // Meter is programmed according to TIME_ZONE_NAME if USE_SYSTEM_TIME_ZONE = FALSE // See possible values of TIME_ZONE_NAME in the MetercatLite User Guide TIME_ZONE_NAME = "" // Metering Application: PROGRAM_VALUE | PRIMARY | SECONDARY METERING_APP = PROGRAM_VALUE
// CT/VT ratios: These are 'pair' parameters, both of them are overridden or neither are. // If both parameters are not specified then Program Values are used. // If one of these parameters is missing but the other is specified then the task assumes // that the missing parameter has a value of 1.0 and CT*VT overrides the Program value. //CT = 1.0 // 1.00 to 9999.99 //VT = 1.0 // 1.00 to 9999.99
// Demand Overload: program value is used when the parameter is commented //DEMAND_OVERLOAD = 0 // 0.0000 to 999999.9999 USE_ADJUSTED_KH = FALSE // Adjusted_Kh is used only if USE_ADJUSTED_KH=TRUE // If USE_ADJUSTED_KH=TRUE and ADJUSTED_KH parameter is commented then minimum value (0.001) is assumed //ADJUSTED_KH = 1.0 // 0.001 to 999.999 // Register_Multiplier is used only if USE_ADJUSTED_KH=FALSE // Register_Multiplier: program value is used when the parameter is commented //REGISTER_MULTIPLIER = 1.0 // 0.1 to 1000000 // KYZ_value and KYZ_divisor: // 1) if both parameters are defined then KYZ_value // is used if the meter supports it, otherwise KYZ_divisor is used // 2) If only one parameter is defined (the other is // commented) then the program task will use exactly that parameter // (if it is not supported the task will fail) // 3) If both parameters are commented then the program value of either KYZ_value // or KYZ_divisor is used, depending on what the meter supports // //KYZ_VALUE = 1 // 0.000001 to 100.000000 //KYZ_DIVISOR = 1 // 1 to 999
// ---- Components Options ---------------------------------------------------// Service Test Component = DO_NOT_CHANGE | PROGRAM_VALUE | OVERRIDE SERVICE_TEST_COMP_MODE = PROGRAM_VALUE SERVICE_TEST_COMP_FILENAME = "" // PQM component = DO_NOT_CHANGE | PROGRAM_VALUE | OVERRIDE PQM_COMP_MODE = PROGRAM_VALUE PQM_COMP_FILENAME = "" // Instrumentation Profiling Config Component = DISABLE | PROGRAM_VALUE | OVERRIDE INSTRUM_PROFILE_COMP_MODE = PROGRAM_VALUE INSTRUM_PROFILE_COMP_FILENAME = "" // Remote component = DO_NOT_CHANGE | DISABLE | PROGRAM_VALUE | OVERRIDE REMOTE_COMP_MODE = PROGRAM_VALUE REMOTE_COMP_FILENAME = "" // ---- Remote Component override parameters ----------------------------------
29
A. Defaults.txt
// Values specified in the PORT_x_DEVICE_ID parameters are programmed only // if all the following conditions are met: // a) the program contains a Remote component // b) PORT_x is set to 'Direct Connect' or 'Internal Modem' or 'External Modem' PORT_1_DEVICE_ID = 1//1-254; 1= Always Master PORT_2_DEVICE_ID = 1//1-254; 1= Always Master
// Values specified in the PORT_x call origination parameters are programmed only // if all the following conditions are met: // a) the program contains a Remote component // b) PORT_x is set to "Internal Modem" or "External Modem' // c) The remote component has both options 'Enable Billing Calling' and // 'Specify a Single Date and Time at Program Time' set for PORT_x PORT_1_CALL_ORIG_DATE_TIME.YEAR = 90 // YY PORT_1_CALL_ORIG_DATE_TIME.MONTH = 1 PORT_1_CALL_ORIG_DATE_TIME.DAY = 1 PORT_1_CALL_ORIG_DATE_TIME.HOUR = 0 // 0-23 PORT_1_CALL_ORIG_DATE_TIME.MINUTE = 0 PORT_2_CALL_ORIG_DATE_TIME.YEAR = 90// YY PORT_2_CALL_ORIG_DATE_TIME.MONTH = 1 PORT_2_CALL_ORIG_DATE_TIME.DAY = 1 PORT_2_CALL_ORIG_DATE_TIME.HOUR = 0 // 0-23 PORT_2_CALL_ORIG_DATE_TIME.MINUTE = 0 // ---- SpOB Component override parameters ----------------------------------// Program value is used when a parameter is commented // ACB board C1221 protocol parameters //ACB_C1221_IP_ADDRESS = "192.168.0.2" //ACB_C1221_SUBNET_MASK = "255.255.255.0" //ACB_C1221_DEFAULT_GATEWAY = "192.168.0.1" // ACB board MODBUS protocol parameter //ACB_MODBUS_ADDRESS = 1// 0 to 255 // ACB board DNP protocol parameters //ACB_DNP_SOURCE_ADDR = 1// 0 to 65519 //ACB_DNP_DESTINATION_ADDR = 2// 0 to 65519 // ACB board DLT protocol parameter //ACB_DLT_ADDRESS = "123456789012" // string of 12 decimal numbers (each must be 0 to 9)
// ---- Alternative Time setting parameters ---------------------------------// The following parameters can be used alternatively to USE_SYSTEM_TIME_ZONE // and TIME_ZONE_NAME parameters. If ALL of the parameters below are commented // the time according to USE_SYSTEM_TIME_ZONE and TIME_ZONE_NAME is programmed. // TZ Offset in minutes; Default value = 0 (GMT) //TIME_ZONE_OFFSET = 0 // -780 to 780 minutes (-13 to 13 hours) must be divisable by 5 minutes // Daylight Saving time offset in minutes; Default value = 60 minutes //DST_OFFSET = 60 // 0 to 180 minutes (0 to 3 hours) must be divisable by 5 minutes // Daylight Saving time switch time; Default value is 2:00. //DST_SWITCH_TIME.HOUR = 2 // 0 to 23 //DST_SWITCH_TIME.MINUTE = 0 // 0 to 59
30
A. Defaults.txt
//****************************************************************************
31
B. Command.txt
Command.txt
The following sample illustrates the contents of a command.txt file that is created for use by MetercatLite software.
//**************************************************************************** [TASK="Program"] PROGRAM_FILENAME = "C:\myfolder\test A3R program.ped" // ID1 (Account ID) programming mode: VALUE | FACTORY_SERIAL_NUMBER | UTILITY_SERIAL_NUMBER METER_ID_1_MODE = VALUE // Applied only if METER_ID_1_MODE = VALUE; max length = 20 char METER_ID_1 = "MY ACCOUNT" // ID2 (Meter ID) programming mode: FACTORY_SERIAL_NUMBER | VALUE | UTILITY_SERIAL_NUMBER METER_ID_2_MODE = FACTORY_SERIAL_NUMBER // Applied only if METER_ID_2_MODE = VALUE; max length = 20 char METER_ID_2 = ""
// // // // CT VT // // // // // // // //
CT/VT ratios: These are 'pair' parameters, both of them are overridden or neither are. If both parameters are not specified then Program Values are used. If one of these parameters is missing but the other is specified then the task assumes that the missing parameter has a value of 1.0 and CT*VT overrides the Program value. = 1.0 // 1.00 to 9999.99 = 1.0 // 1.00 to 9999.99 KYZ_value and KYZ_divisor: 1) if both parameters are defined then KYZ_value is used if the meter supports it, otherwise KYZ_divisor is used 2) If only one parameter is defined (the other is commented) then the program task will use exactly that parameter (if it is not supported the task will fail) 3) If both parameters are commented then the program value of either KYZ_value or KYZ_divisor is used, depending on what the meter supports
32
B. Command.txt
//****************************************************************************
33
B. Command.txt
ALPHA, ALPHA Plus, REX, TRACE and EnergyAxis are registered trademarks of Elster. AlphaPlus, REX2, REX2-EA, Route Manager and Metercat are trademarks of Elster. Other products may be trademarks and/or registered trademarks of their respective owners.
Elster 208 S Rogers Lane Raleigh, NC 27610-2144 United States T F +1 800 338 5251 (US toll free) +1 919 212 4801
support@us.elster.com www.elster.com
February 2009 by Elster. All rights reserved. No part of this software or documentation may be reproduced, transmitted, processed or recorded by any means or form, electronic, mechanical, photographic or otherwise, translated to another language, or be released to any third party without the express written consent of the Elster. Printed in the United States of America.c