Do you have a question about the X3M and is the answer not in the manual?
Questions and answers
Summary of Contents for Electrex X3M
Page 1
Energy Data Manager User Manual Version8 November 2005 The document can be modified without prior information.
Page 2
Analog output set up with Modbus registers..............26 5.1.2.6.2 4-20 mA output configuration of the average AVG values ..........26 5.1.2.7 Clock calendar configuration (for X3M-D only) ..........27 5.1.2.7.1 Clock set up with Modbus registers................28 5.1.2.7.2 Time zones ........................29 5.1.3...
Page 3
Record Structure ...................... 46 6.13 Average and peak Energy ....................46 6.14 Tariff Time Bands ......................46 System Architecture......................... 47 General Features ....................... 47 7.1.1 X3M ..........................47 7.1.2 Options ........................48 7.1.2.1 RS485 Port......................48 7.1.2.2 RS232 Port......................48 7.1.2.3 2 x 4-20 mA Analog Output................
Page 4
9.4.4 Input Registers (backward compatibility area) ............88 9.4.5 Coils (back compatibility)..................... 91 9.4.6 X3M coils........................91 File organization and management in the X3M flash memory..........92 10.1 File system ........................92 10.1.1 Types of file......................94 10.1.2 File structure ......................95 10.1.3...
Page 5
Clock related Modbus registers................ 128 10.6.5 Upgrading the firmware..................129 The XMBF.EXE utility (Electrex ModBus File) ..............130 11.1 Commands for PC handling of the files of the X3M memory........130 11.1.1 Short commands ....................131 11.2 Operation type ......................131 11.2.1...
Detailed description of the fault and of the operating condition when the fault occurred • The Electrex repair lab will send the authorization number to the customer directly or to the distributor as per applicable case. The RMA authorization number shall be clearly marked on the packaging and on the return transport document.
Space reserved to ELECTREX R.M.A. No. The RMA number shall be clearly indicated on the external packaging and on the shipping document:. Failure to observe this requirement will entitle the ELECTREX warehouse to refuse the delivery.
2 Safety This instrument was manufactured and tested in compliance with IEC 61010 class 2 standards for operating voltages up to 250 VAC rms phase to neutral. In order to maintain this condition and to ensure safe operation, the user must comply with the indications and markings contained in the following instructions: •...
3 Mounting 3.1 Dimensions (mm) 3.2 Fixing and blocking The connection terminals of the instrument are held in place by a plastic panel, which must be mounted using 4 screws (supplied). This set up will prevent the disconnection of the current measurement terminals.
4 Wiring Diagrams 4.1 Power Supply The instrument is fitted with a separated power supply with extended functioning range. The terminals for the power supply are numbered (13 and 14). Use cables with max cross-section of 4 mm 4.2 Measurement Connections 4.2.1 Voltage connection Use cables with max cross-section of 4 mm and connect them to the terminals marked VOLTAGE INPUT...
4.2.3 4W Star Connection (4 wires) Low voltage 3 CTs Average or high voltage 3 TCs 3 CTs Configuration 3P 4W Configuration 3P 4W Low Voltage 1 CT (balanced and symmetric) Configuration 3P-b 4W...
4.2.4 3W Delta Connection (3 wires) Connection with 3 CTs Connection with 1CT Low Voltage 3 CTs Low Voltage 1 CT (Balanced and symmetric) 3P 3W Configuration 3P-b 3W Configuration 4.2.4.1 L1 L3 Phase Connection with 2 CTs Low Voltage Average or High Voltage 3P 3W Configuration 3P 3W Configuration...
4.2.6 2 Wire Connection (double phase) Low Voltage phase 1 CT 2P 2W Configuration 4.3 Output Connection The instrument is equipped with two opto-isolated transistor outputs rated 27 Vdc, 27 mA (DIN 43864 standards). The outputs working mode is set by default to operate as pulse output proportional to the Active energy (output 1) and to the Reactive energy (output 2).
4.4 Connecting Optional Components The optional components of X3M are assembled on the back panel of the instrument, where the RJ45 connectors are located The optional component feature settings are only displayed when one of them is connected to the instrument...
Instrument Use The programming procedure allows to vary the instrument functioning parameters. You can enter the procedure with the button Program located at the back of the instrument. In this environment, you can enter the measurement parameters and the network configuration. The various fields can be selected by pressing the button which also allows navigating to all the Setup pages...
5.1.1 Set up sequence Within the first page of the instrument set up menu, the following functions are available too. - a pressure of the key opens the energy counters reset page. - a pressure of the key opens the reset page of the average and maximum demand. Here below the page format and the programming flow.
5.1.2 Configuration Procedure 5.1.2.1 Electrical system configuration The first programming page shows the configuration of the type of electrical system. The first selection sets the type of electrical system and the type of wiring used: • 3 phase 4 wire system , Star , •...
Page 20
• Import only user • Import-Export system The instrument is set by default to and Import only mode. and automatically corrects possible CTs connection errors The following page enables to set the type of voltage measurement. If the voltage measurement is direct in low voltage, select ;...
5.1.2.2 Communication Parameters Configuration This menu appear only upon connection to the instrument of an RS-485 or an RS-232 optional module. The setting of the RS485 communication characteristics requires to scroll the programming pages with two keys; key advances to the next page, the key returns to the previous page The first page is the following: This page enables the setting of respectively:...
ALARM for operation as alarm contact output REM Remote for operation as remote output device controlled via Modbus 5.1.2.4 Pulse characteristics configuration If the PULSE selection is operated, the following page is shown allowing the configuration of the pulse characteristics: Where: (1) Pulse output number being programmed.
5.1.2.5 Alarm Configuration The Instrument is equipped with two alarms that are triggered by a programmable threshold on anyone of the measured parameters. The types of alarm available are: maximum, minimum and 1-of-3. A minimum alarm is triggered when the selected parameter is lower than the alarm threshold. A maximum alarm is triggered when the selected parameter exceeds the alarm threshold.
Phase 1 quantity. Phase 2 quantity. Phase 3 quantity. L1-L2 Phase L1 phase L2 value (Phase to phase Voltages and THD only) L2-L3 Phase L2 phase L3 value (Phase to phase Voltages and THD only) L3-L1 Phase L3 phase L1 value (Phase to phase Voltages and THD only) 1di 3 Alarm on all three phases.
5.1.2.6 Analog 4-20 mA Outputs Configuration. The instrument supports two 4-20 mA or 0-20 mA analog outputs with 500 ohms maximum load. Each output is to one of the parameters handled by the instrument. The output is updated every 10 cycles of the network frequency (i.e. every 200mSec with 50 Hz mains) with a maximum delay of 50 mSec from the actual measurement.
L1-L2 Phase-phase (L1-L2) value (applicable to system voltages and THD only) L2-L3 Phase-phase (L2-L3) value (applicable to system voltages and THD only) L3-L1 Phase-phase (L3-L1) value applicable to system voltages and THD only) Average value (applicable to average powers - demand - only). (3) Threshold voltage: programmable in the range –1999 +1999 (4) The quantity can be scaled by powers of ten by using the m, K, M symbols and the decimal point.
5.1.2.7 Clock calendar configuration (for X3M-D only) The X3M-D is equipped with a clock/calendar with internal battery having a 15 years life time. The clock/calendar supports the time zone handling functions and the automatic change from Standard Time to Daylight Saving Time and vice versa.
(3) Time Configuration in hours and minutes. Starting the selection the configuration is Pushing the button it is possible to visualize the actual time and date and modify them, first the hours then the minutes. The hour change will occur only exiting the programming mode. The hour change will influence the data storage thus it is important to operate modifications only if strictly necessary, otherwise leave to the instrument management software the clock update..
The pertinent time zone is entered to the instrument by a numeric index (time zone index). The time zone index and the standard time zone names are shown in the charts below: X3M-D X3M-D Standard Timezone Name (FW > 1.06) Standard Timezone Name (FW >...
Page 30
X3M-D X3M-D Standard Timezone Name (FW > 1.06) Standard Timezone Name (FW > 1.06) Timezone Index Timezone Index America/Glace_Bay America/Rankin_Inlet America/Godthab America/Recife America/Goose_Bay America/Regina America/Grand_Turk America/Rio_Branco America/Grenada America/Santiago America/Guadeloupe America/Santo_Domingo America/Guatemala America/Sao_Paulo America/Guayaquil America/Scoresbysund America/Guyana America/St_Johns America/Halifax America/St_Kitts America/Havana America/St_Lucia...
Page 31
X3M-D X3M-D Standard Timezone Name (FW > 1.06) Standard Timezone Name (FW > 1.06) Timezone Index Timezone Index Asia/Dhaka Asia/Yakutsk Asia/Dili Asia/Yekaterinburg Asia/Dubai Asia/Yerevan Asia/Dushanbe Atlantic/Azores Asia/Gaza Atlantic/Bermuda Asia/Harbin Atlantic/Canary Asia/Hong_Kong Atlantic/Cape_Verde Asia/Hovd Atlantic/Faeroe Asia/Irkutsk Atlantic/Madeira Asia/Jakarta Atlantic/Reykjavik Asia/Jayapura Atlantic/South_Georgia...
Page 32
X3M-D X3M-D Standard Timezone Name (FW > 1.06) Standard Timezone Name (FW > 1.06) Timezone Index Timezone Index Etc/UTC Indian/Mayotte Europe/Amsterdam Indian/Reunion Europe/Andorra Europe/Athens Pacific/Apia Europe/Belfast Pacific/Auckland Europe/Belgrade Pacific/Chatham Europe/Berlin Pacific/Easter Europe/Brussels Pacific/Efate Europe/Bucharest Pacific/Enderbury Europe/Budapest Pacific/Fakaofo Europe/Chisinau Pacific/Fiji Europe/Copenhagen...
The X3M-D features a built-in database including all the information (time zone rules) which allow to calculate the GMT and DST offsets at any time in each time zones listed in the charts. By knowing the GMT and the DST offset, the instrument is able to convert from universal time to local time and vice versa.
Readings 5.2.1 Readings selection keys The visualization of the measurements is through buttons: Voltage and frequency visualizations. Current visualization. Power visualization. Power factor visualization Energy visualization. Functioning time visualization. These buttons allow you to move up and down in the measurement pages. This button is not used in measurement visualization.
5.2.1.2 Current readings By pressing the key, the current readings page is prompted showing the currents of each phase as well as the neutral current. A pressure of the key prompts the total harmonic distortion readings of the current of each phase. 5.2.1.2.1 3P 4W Configuration 5.2.1.2.2 3P 3W Configuration 5.2.1.2.3 3P-b 4W Configuration...
5.2.1.3 Powers By pressing the key the power reading pages for P Active Power, Q Reactive power and S Apparent power are scrolled in sequence. By pressing the keys the average and the maximum powers (Demand and Maximum Demand readings) are displayed. 5.2.1.3.1 3P 4W Configuration 5.2.1.3.2 3P 4W only Import Configuration.
5.2.1.4 P.F. Visualization By pressing the key, the power factor readings page is prompted showing the PF of each phase as well as the 3-phase reading. Only one page is displayed. The – sign ahead of the value identifies a capacitive (leading) reading. 5.2.1.4.1 3P 4W Configuration 5.2.1.4.2 3Pb 4W Configuration 5.2.1.4.3 3P 3W e 3Pb 3W Configuration...
5.2.1.5 Energy By pressing repeatedly the key, the several energy readings will be displayed consecutively on the lower right part of the screen. The energy readings may be recalled at any time irrespective the readings page being displayed. The energy readings will however disappear upon selection of another readings page but they may be recalled, at any time, by pressing the key.
5.2.1.7 Tariff Energies and Tariff Maximum Demand By pressing the key for 2 seconds from any page, it is possible to display the Energy counters and the Max Demand of each tariff. The top left symbol identifies the parameter being displayed and the Maximum Demand reading is shown next to it.
(e.g. electric welding machines). X3M can be programmed to analyze three phase networks, both on three and four wires with low or high voltage with 1, 2 or 3 CTs in addition to single phase measurements. The option of setting any required conversion factor on the voltage and current inputs makes X3M suitable for use in both high and low voltage networks.
6.2 Simplicity and versatility Keyboard programming is extremely easy and allows setting of: • Connection type (star and delta) • Low Tension or Medium Tension • Setting of CTs and VTs values (freely settable) • Integration time (1-99 min.) • RS485 features (speed, parity and data format) •...
The pulses number is referred to the instrument Full Scale without the CT and TV scale factors. 6.9 Alarms X3M is triggered and programmed by switchboard and/or Holding registers with MODBUS protocol. The advanced functions of the Energy Brain configuration software allow to customize each of the two alarms on any available parameter either as a minimum or max alarm.
• It identifies the time zone it belongs to. X3M, starting from the UTC time can autonomously calculate the local time (Wall Time) of any place on earth The zone it belongs to is indicated to the instrument through a numeric index (time zone index) either on the display or on a MODBUS register.
(from 1 to 9999). 6.13 Average and peak Energy While the X3M was designed to measure energy consumption (the so called import mode), it can be configured to work in import/export mode. When in import mode, the device automatically compensates wiring errors on CTs (e.g.
7 System Architecture 7.1 General Features 7.1.1 X3M Energy and Supply quality Analyzer Very accurate and stable measurement system thanks to the digital signal elaboration; Continuous sampling of the wave shape of voltages and currents; Offset automatic compensation of the measurement chain;...
• “Write General File”. • “Read General File”. The data on disk are organized in record files, according to ModBus standard. − Files Structure Each file is identified by a numeric index of 2 bytes (FILE NUMBER, from 0 to 65535).
8 Parameters and formulas For each type of connection, the available readings as well as the formulas used for their calculation are provided. The redings not available will be displayed as in place of the value. 3P 4W Three phase with 4 wire neutral Voltage inputs Current inputs 8.1.1 Available Reading:...
Page 50
3 Phase Apparent Power: Σ Power Factor: λ λ λ Phase Power Factor: λ 3 Phase Power Factor: Σ Energies: Active Energy (import): − Active Energy (export): Inductive reactive Energy with import Active Power: Capacitive reactive Energy with import Active Power: −...
8.1.2 Measurement Formulas: Phase Voltages: − − − ∑ ∑ ∑ Phase-phase Voltages: − − − ∑ ∑ ∑ − − − where: are the star voltage samples; is the number of samples taken over a period (64); Star Voltages THD in % −...
8.2 3P 3W Three phase without neutral Voltage inputs Current inputs 8.2.1 Available Reading: Frequency: Voltage frequency RMS amplitude: Phase-phase Voltages: Mean Phase-phase Voltage: ∆ Line Currents: Mean three phase Current: Σ Total harmonic distortion (in percentage): THD of the Phase to phase Voltages Average THD of the Phase to phase Voltages ∆...
Page 54
Apparent Energy with import Active Power: − Apparent Energy with export Active Power: Average Power integrated over the programmed integration period “Sliding Average”,: Import average Active Power: − Export average Active Power: Average inductive reactive Power with import Active Power: Average capacitive reactive Power with import Active Power: −...
8.2.2 Measurement Formulas: Phase-phase Voltages: − − − ∑ ∑ ∑ are the Phase to phase Voltages samples. M is the number of samples taken over a period (64) Phase to phase Voltages THD in % − ∑ − ⎧ ⎫...
8.3 3P-b 4W Balanced Three phase with neutral Voltage inputs Current inputs 8.3.1 Available Reading: Frequency: Voltage frequency RMS Amplitude: Star Voltage: Phase Current: Total harmonic Distortion (in percentage): Star Voltage THD: Phase Current THD: Power (on the short period): Phase Active Power: 3 Phase Active Power: Σ...
Page 58
Apparent Energy with import Active Power: − Apparent Energy with export Active Power: Average Power integrated over the programmed integration period “Sliding Average”, Import average Active Power: − Export average Active Power: Average inductive reactive Power with import Active Power: Average capacitive reactive Power with import Active Power: −...
8.3.2 Measurements Formulas: − ∑ Phase Voltages: where: are the samples of the star voltages; is the number of samples on a period (64); Star voltages THD in % − ∑ − ⎧ ⎫ ⎡ π ⎤ ⎡ π ⎤ −...
8.4 3P-b 3W Balanced three Phase without neutral 3 wires Voltage inputs Current inputs 8.4.1 Available Reading: Frequency: Voltage frequency RMS amplitude: Phase-phase Voltages: Phase Current: Total harmonic distortion (in percentage): Phase to phase Voltages THD: Phase Current THD: Power (on short period): 3 Phase Active Power: Σ...
Page 61
Average Power integrated over the programmed integration period “Sliding Average”, Import average Active Power: − Export average Active Power: Average inductive reactive Power with import Active Power: Average capacitive reactive Power with import Active Power: − Average inductive reactive Power with export Active Power: −...
8.4.2 Measurement Formulas: − ∑ Phase-phase Voltages: Where: are the samples of the chained values. M is the number of sampling on a period (64) Phase to phase Voltages THD in % − ∑ − ⎧ ⎫ π π ⎡ −...
8.5 1P (2W) Single phase Current inputs Voltage inputs 8.5.1 Available Reading: Frequency: Voltage Frequency RMS Amplitude: Voltage: Phase Current: Total harmonic Distortion (in percentage): Voltage THD: Phase Current THD: Power (on short period): Active Power: Reactive Power: Apparent Power: Power Factor: λ...
Page 64
Average Power integrated over the programmed integration period “Sliding Average”, Import average Active Power: − Export average Active Power: Average inductive reactive Power with import Active Power: Average capacitive reactive Power with import Active Power: − Average inductive reactive Power with export Active Power: −...
8.5.2 Measurement Formulas: − ∑ Voltage: are the samples of the star voltages; is the number of samples on a period (64); Star voltages THD in % − ∑ − ⎧ ⎫ π π ⎡ ⎤ ⎡ ⎤ ⎪ − −...
8.6 2P (2W) Double phase Current inputs Voltage inputs 8.6.1 Available Reading: Frequency: Voltage frequency RMS amplitude: Voltage: Phase Current: Total harmonic distortion (in percentage): Voltage THD : Phase Current THD: Power (on short period): Active Power: ∑ Reactive Power: ∑...
Page 67
− Apparent Energy with export Active Power: Average Power taken on a time interval (sliding window) of programmable amplitude: Import average Active Power: − Export average Active Power: Average inductive reactive Power with import Active Power: Average capacitive reactive Power with import Active Power: −...
8.6.2 Measurements Formulas: − ∑ Voltage: are the samples of the star voltages; is the number of samples taken on a period (64); Star voltage THD in % − ∑ − ⎧ ⎫ π π ⎡ ⎤ ⎡ ⎤ ⎪ −...
8.7.1 Energy counting X3M is equipped with 8 “non volatile” energy counters which can count up to a maximum of 99999999.9 kWh (either kvarh or kVAh) with a resolution equal to 0.1 kWh (either kvarh or kVAh). The value of these counters can be read either by communication port or display.
9 MODBUS Protocol 9.1 Foreword: The instrument modbus protocol is implemented according to the document “MODBUS Application Protocol Specification V1.1”, available in www.modbus.org The following “Public functions” are implemented: (0x01) Read Coils (0x02) Read Discrete Inputs (0x03) Read Holding Registers (0x04) Read Input Registers (0x05) Write Single Coil (0x06) Write Single Register...
9.2 “Device dependent” Functions 9.2.1 (0x11) Slave ID Report (0x11) Report Slave ID Byte Description Value address function code 0x11 byte count 0x1F slave ID run indicator status 0xFF Application version major Application version minor Loader version major Loader version minor Serial number - Swap bytes: 0 ≡...
9.2.2 (0x07) Exception Status Read Not available. 9.3 “User defined” Functions 9.3.1 (0x42) Slave Address Change The instruments accepts query with function code 0x42 (change slave address) only of “Broadcast” type (address 0). Consequently, there is no answer. Change Slave Address Query Byte Description Value...
Registers from address 0 to 7 are compatible with the registers of the old instrument, in order to assure the backwards compatibility. The one described are the ones of the KILO (T). Registers from address 70 to 79 specific for X3M. Registers from address 8 to 69 and from 132 to 139 are reserved for future expansions.
Page 74
Holding Registers Notes Addr. Type Description Range [Unit] or Bitmap 0 ≡ 4 wires (Star); 1 ≡ 3 wires (Delta) Network type: Bitmapped Network type 0 ≡ Export disabled (2 quadrants); Import/Export: Word 1 ≡ Export enabled (4 quadrants) Not Allocated Integer Word CT Primary 1-10000 [A]...
Page 75
Holding Registers Notes Addr. Type Description Range [Unit] or Bitmap 00 ≡ Pulse; 01 ≡ Alarm; Mode: 10 ≡ Remote; 11 ≡ Not allowed Bitmapped Digital Word Configuration Polarity: 0 ≡ Normally opened; 1 ≡ Normally closed Not Allocated 00 ≡ Pulse; 01 ≡...
Page 76
Holding Registers Notes Addr. Type Description Range [Unit] or Bitmap Alarm coil driving mode: 00 ≡ Normal 01 ≡ Pulsed Bitmapped 10 ≡ Not allowed Alarm 2 - Mode Word 11 ≡ Not allowed 0 ≡ Min; 1≡ Max Alarm type: Not Allocated Float IEEE754 Alarm 2 - Threshold...
Page 77
Holding Registers Notes Addr. Type Description Range [Unit] or Bitmap Measurement scaling: 0=scaled to signal at primary side of CT/VT; 1=scaled to signal at secondary side of CT/VT; Bitmapped Pulse Out 2 - Quantity Word selection Measurement selection: 0-7 0=P+, 1=P-, 2=Qind+, 3=Qcap+, 4=Qind-, 5=Qcap-, 6=S+,...
Page 78
Holding Registers Notes Addr. Type Description Range [Unit] or Bitmap This group of registers is updated on each read access to the first register. Read queries not including the first address, will give not updated values. Byte Array Write queries involving at least one register of ASCIIZ String Active Timezone Name these, initiate a search in the timezone names...
Page 79
Holding Registers Notes Addr. Type Description Range [Unit] or Bitmap Number of elapsed seconds since Unix Epoch Time (January 1, 1970 00.00.00) not including neither leap seconds nor timezone offsets. Universal Time Only date values in the range of 1/1/2004 and Integer UNIX Timestamp...
Holding Registers Notes Addr. Type Description Range [Unit] or Bitmap Time of Next Changeover (Daylight Unix Time Stamp of next changeover from Integer Saving Time to Standard Time to Daylight Saving Time or (4 bytes) Standard Time or viceversa viceversa) as UNIX Timestamp Format 9.4.2 Parameter selection tables The following tables allow the selection of the parameters to be associated to the alarms and to analog outputs.
9.4.3 X3M Input registers In this chapter the X3M original registers are listed with all the available measurements. Addr. Type Description Unit Symbol System config / Notes Phase to neutral Voltage, THD ⇒ 3P4W, 3P-b 4W, 1P2W Float IEEE754 Phase to phase Voltage, THD ⇒...
Page 85
Addr. Type Description Unit Symbol System config / Notes Float Phase Reactive Power (+/-) ⇒ 3P4W IEEE754 Float Phase Reactive Power (+/-) ⇒ 3P4W IEEE754 Float Phase Apparent Power ⇒ 3P4W, 3P-b 4W, 1P2W IEEE754 Float Phase Apparent Power ⇒ 3P4W IEEE754 Float...
Page 86
Addr. Type Description Unit Symbol System config / Notes ⇒ Float Total exported apparent power, 3P4W, 3P-b 4W, 1P2W, 3P3W, − IEEE754 3P-b 3W, 2P2W ⇒ Import/ Export only Float Total imported Active Power, ⇒ 3P4W, 3P-b 4W, 1P2W, 3P3W, IEEE754 3P-b 3W, 2P2W Float...
Page 87
Addr. Type Description Unit Symbol System config / Notes Integer Imported inductive energy ⇒ 3P4W, 3P-b 4W, 1P2W, 3P3W, varh/10 (8 bytes) (Hi Resolution) 3P-b 3W, 2P2W Integer Imported capacitive energy ⇒ 3P4W, 3P-b 4W, 1P2W, 3P3W, varh/10 (8 bytes) (Hi Resolution) 3P-b 3W, 2P2W Integer...
9.4.4 Input Registers (backward compatibility area) In this area the registers guaranteeing the compatibility with the previous ELECTREX products are listed. This allows compatibility with written software. The considered registers are KILO (T)’s. Addr. Type Description Unit Symbol Wirings / Notes...
Page 89
Addr. Type Description Unit Symbol Wirings / Notes IEEE754 Float Phase Active Power (+/-) ⇒ 3P4W IEEE754 ⇒ Float 3P4W Voltage Input Frequency IEEE754 ⇒ 3P3W Float Phase reactive power (+/-) ⇒ 3P4W, 3P-b 4W, 1P2W IEEE754 Float Phase reactive power (+/-) ⇒...
Page 90
Addr. Type Description Unit Symbol Wirings / Notes NOT AVAILABLE Return undefined valued, if read. ⇒ Phase to neutral Voltage, THD Float 3P4W IEEE754 Phase to phase Voltage, THD ⇒ 3P3W Float ⇒ Line current, THD 3P4W, 3P3W IEEE754 ⇒ Phase to neutral Voltage, THD Float 3P4W...
Not allocated Not allocated Not allocated Swap words & bytes (2, 4) Format Control of the memory stored data Not allocated 9.4.6 X3M coils Proprietary X3M coils area. X3M Coils Address Description Note: Data format control in memory Swap bytes (5)
10 File organization and management in the X3M flash memory. 10.1 File system X3M uses a “Flash-Disk” for the storage of its configuration parameters, readings and other operating information. Data on disk are organized in record files, as specified by the Modbus standard.
Page 93
Generic file structure Record Size Record Number Field Name and Size Type Value (bytes) Header Size Unsigned (1 byte) integer Data record size Unsigned (1 byte) integer Reserved Unsigned (1 byte) integer Reserved Unsigned (1 byte) integer Reserved Unsigned Record definition structure (1 byte) integer (4 bytes)
10.1.1 Types of file The X3M classifies the possible 65.536 files in 256 “types” according to the value of most significant byte of the file number. The least significant byte is used to identify the possible 256 files belonging to each type.
10.1.2 File structure There are two file categories: − files containing structured information, whose fields have an assigned type (structured files) − files containing “raw” data, without defined fields, or field types (raw files) Raw files are distinguished by the RAW FILE flag in the record definition structure 10.1.3 Structured Files Structured files are mostly used to save on disc the values of variables allocated in the device volatile memory.
10.1.4 Descriptors Each descriptor listed in the “variable definition structure” defines a file variable. The structure of a generic descriptor follows: Generic descriptor Filed Size Field Name Field Type Field Description 1 byte Descriptor size Unsigned Integer Descriptor size (in bytes) External allocation flag=0 indicates that the variable is stored within the descriptor;...
Page 97
The following variable types are defined: Variable types Name Description 2 bytes: signed or unsigned integer Word 4 bytes: signed or unsigned integer or single accuracy IEEE-754 float DoubleWord 8 bytes: signed or unsigned integer or double accuracy IEEE-754 float QuadWord Generic Types...
Page 98
The following table indicates the formats of each variable type and of the corresponding parameters: Variable types Type Type Variable Variable Identification Name Field Size Field Field Type Description Field SIze Field (bytes) Name Field Type Description (bytes) Name Numeric index identifying the Word Variable unsigned...
Page 99
Variable types Type Type Variable Variable Identification Name Field size Field Field type Description (bytes) name Signed or Field size Field BYTE 1 unsigned integer Field type Description Array of signed or (bytes) name or ASCII character Numeric index identifying the unsigned integers or Signed or Variable...
Page 100
Variable types Type Type Variable Variable Identification Name Field size Field name Field type Description (bytes) Number leap UNIX unsigned seconds since the so called TIMESTAMP integer (1/1/1970 Unix Epoch Field size Field Field type Description 00:00:00) (bytes) name Unix Epoch Numeric index identifying the Time + DST Variable...
Page 101
Variable types Type Type Variable Variable Identification Name Field size Field Field type Description (bytes) name unsigned Century Century integer unsigned Year Year integer unsigned Month Month integer unsigned Field size Field Field type Description integer (bytes) name unsigned Numeric index identifying the Date/Hour Variable unsigned...
Page 102
Variable types Type Type Variable Variable Identification Name Field size Field Field name Description (bytes) type Address input register Address of unsigned If the “Type of A” field indicates a 32-bit data type, integer the instruments will operate on a pair of contiguous registers starting at this address.
10.1.5 Homogenous files Homogenous files always contain a single “variable definition structure” allocated in the header and contiguous to the “record definition structure”. All the descriptors contained in this structure define a variable that can be allocated either in the file header (in the descriptor) or in the data area. The area where the variable is allocated is described by the status of the external allocation flag contained in the descriptor.
Page 104
Structure of an Homogeneous File containing no external single allocation variables. Record Record Size Field name and size Type Value Number (bytes) Header size unsigned (1 byte) integer Data record size unsigned (1 byte) integer Reserved unsigned (1 byte) integer Reserved unsigned (1 byte)
Page 105
Structure of an Homogeneous File containing at least one external single allocation variable Record Record Size Field name and size Type Value Number (bytes) Header size unsigned (1 byte) integer Data record size unsigned (1 byte) integer Reserved unsigned (1 byte) integer Reserved unsigned...
10.1.6 Non Homogeneous files The non-homogeneous file format is as follows NON HOMOGENEOUS file structure Record Record Type Field Name and size Type Value Number (bytes) Header size Unsigned (1 byte) integer Data record size Unsigned (1 byte) integer Reserved Unsigned (1 byte) integer...
10.2 Type 0 files Type 0 files contain information about type 1 ÷ 255 files stored on the disk. Because of this, type 0 files can be considered disk “directories”. By reading type 0 files, it is possible to retrieve information about the files on the disk. By writing type 0 files, it is possible to create or to delete files.
− The n record in file 00.T, where 257 ≤ n ≤ 513, contains information about type T file number n- 257. Each record contains an instance of the variable called “File status ” and one of the variable called “Service status”.
10.3 Type 1 files Type 1 files are dedicated to the “load profiles logging service (file number from 01.00 to 01.FF). This service is mainly designed for recording load profiles (evolution of the energy counters vs. time) by means of a periodical storage on file of the content of one or more Modbus registers (input registers and/or holding registers).
10.3.1 Service configuration The “load profiles logging” service makes use of the following output variables: Load Profile Logging service – Output Variables Name Type Description Unix Timestamp 06h) Unix Timestamp offset 07h) System clock Unix Timestamp flag 08h) FF80h System clock, UTC Date 09h) Hour...
Page 111
Each configuration profile may contain: − An internal allocation descriptor for each of the following input variables: Max data-file number Max data-file size Sampling interval The value given by the descriptor is assigned to the corresponding input variable upon service initialisation.
10.4 Type 4 files The type 4 files are dedicated to recording of events related to power quality. The “Events service”, when configured, records the following events in its files: • Power Off: power supply drop below the voltage level ensuring instrument energisation; •...
Page 113
Each record contains: 1. a time-stamp (with configurable format) of the sampling time description identifying simultaneously event type and current or voltage phase involved. • Power On; • Power Off; • Voltage Sag / Dip; • Undervoltage, Start; • Undervoltage, End; •...
10.4.1 Service Configuration This service makes use of the following output variables: Events Service – Output variables Mandat. Name Type Description WORD (ID 01h) 0480h Hundredths of second Time-stamp Hundredths (Unsigned integer) WORD (ID 01h) Numerical code identifying the Event ID 0481h (Unsigned integer) event...
Page 115
The service configuration parameters are stored in the following input variables: Events Service – Input variables Name Type Range Default Unit Description All space DWORD (ID 02h) Maximum admitted size Max data-file size FF00h available bytes Unsigned integer for each data file on disk WORD (ID 01h) Maximum number of files...
10.4.2 Example of configuration file: “Events.xmbf” The file contains only the data indicated in the Data (hex) columns RECORD #0: FILE HEADER RECORDS DEFINITION STRUCTURE Data (hex) Description Header size (Bytes) Data records size (Bytes) Reserved ID Flags RECORD #1: DATA RECORD VARIABLES DEFINITION STRUCTURE Data (hex) Description...
10.4.3 Type 5 files The type 5 files are dedicated to the service called “peaks logging service”. This service logs on file the maximum and minim values (peak values) of any of the input or holding registers. For any register - whose peak values will be logged (target register) a second one can be specified, which will act as “reference register”.
10.4.4 Service configuration This service makes use of the following output variables: Peaks Recording Service – Output variables Name Type Description Unix Timestamp 06h) Unix Timestamp offset 07h) System clock Unix Timestamp + DST flag (ID 08h) FF80h System clock, UTC Date 09h) Time...
10.4.5 Example of configuration file: “Peaks.xmbf” The file contains only the data indicated in the Data (hex) columns. RECORD #0: FILE HEADER RECORDS DEFINITION STRUCTURE Data (hex) Description Header size (Bytes) Data records size (Bytes) Reserved ID Flags RECORD #1: DATA RECORD VARIABLES DEFINITION STRUCTURE Data (hex) Description...
10.5 Type 7 files Type 7 files are dedicated to Tariff Energy Counters for time of use tariffs. They are strictly related to type 6 files, e.g. calendar files, which determine the tariff changeover and the repartition of energies into groups of counters (one group for each tariff). Each record of the report file is matched to a given tariff.
Tariff Energy Counters service – Output variables Name Type Mandat. Description Import Reactive energy inductive Er ind imp 0781h QUADWORD (ID 03h) (high resolution) Import Reactive energy capacitive Er cap imp 0782h QUADWORD (ID 03h) (high resolution) Import Apparent energy Es imp 0783h QUADWORD (ID 03h)
10.5.3 Example of configuration file: “EnergyCounters.xmbf” The file contains only the data indicated in the Data (hex) columns The order of the external multiple allocation variables can be changed however the type cannot be changed (storage of counters in low resolution – e.g. in FLOAT IEEE754 format – is not allowed. All external variables indicated as mandatory on the table below must be included in the descriptors list.
10.6 Type 8 files Type 8 files are dedicated to the storage of Tariff Maximum Demands for time of use tariffs. They are strictly related to type 6 files, e.g. calendar files, that determine the tariff changeover and the repartition of Maximum demand into groups (one group for each tariff). For further information please refer to “Type 6 files”.
Tariff Maximum Demands Service - Output variables Mandat. Name Type Description Maximum Demand MD P imp 0880h DOUBLEWORD (ID 02h) Import Active Power Maximum Demand MD Q ind imp 0881h DOUBLEWORD (ID 02h) Import Reactive power (inductive) Maximum Demand MD Q cap imp 0882h DOUBLEWORD (ID 02h) Import Reactive power (capacitive)
10.6.3 Example of configuration file: “MaximumDemands.xmbf” The file contains only the data indicated in the Data (hex) column The order of the external multiple allocation variables can be changed subject however to the presence in the descriptors list of the mandatory variables as indicated by the tables. RECORD #0: FILE HEADER RECORDS DEFINITION STRUCTURE Data (hex)
UTC Date/Time; − Timezone ID; The X3M, in this way, uses its internal UTC timing to compute the local time (Wall Time) anywhere on earth. 10.6.4.1 Timezones The pertinent timezone is set by specifying a numeric timezone index. The correspondence between timezone index and standard name is listed in the table available on chapter “Set up”...
File FF.02 contains the timezones the instrument is supporting – in id order (see table). FF.02 is a structured homogeneous file identified as follows: − Name = name of the file by elsie.nci.nih.gov (e.g. “tzdata2004g”) used to build the timezone rules of the X3M database. − Creation Date/Time = date/time of database creation −...
The X3M firmware is released as binary files whose name has the x3m extension. The file name also contains the version and an identification code of the module (the ID is an abbreviation of the module name).
In order to allow a simple and easy management of the standard MobBus files available in the memory of the X3M, a specific program was developed for file writing and reading that supports the "Read general file" and "Write general file" ModBus commands. For further ease of operation, the program supports also the file conversion to various formats with no need of specifically developed tools.
It executes the program resident in C:\Programs\X3M and it transfers the 0101 file (load profiles) from the instrument at address 27 to PC via the serial port Com1 38400 bps 8 data bits, no parity, 2 stop bits and it saves it to a file named (0101)Loadprofiles.html in HTML format.
11.2.3 --del Delete It removes the file having the number that is specified. This command is executed directly with no request of confirmation and maximum care should therefore be used. The “Delete” command allows to remove a list of files too. The file numbers to be removed must be specified on the same command line with comma separation.
11.7 File Name The file name identifies the name of the file that needs to be uploaded to the instrument. The name must indicate (fnum)Servicename where: (fnum) is the file number of the instrument where one requires to write the content of the origin file from the PC.
11.9 Output format This command gives the possibility of rendering a file content into a structured and commented format for easier readability. The file structure is the one better described in the instrument manual; it is divided in records with the first one describing the structure of the file itself, the others records being the data. The comments, or variable descriptors, used are taken from the X3M_01.map file that is resident in the same folder of the xmbf.exe file.
Page 135
The comments are identified by the // characters. Should this be a configuration file, the data part may be edited with Notepad, reconverted into a binary file by means of the hex2bin command and stored in the instrument by means of an Upload command. This is the procedure that enables to modify the configuration of the various Services supported by the instrument.
11.9.4 HTML Output A browser readable HTML file is generated and saved. (0401)Events Size: 1390 bytes Creation time (WALL): lunedì 6 giugno 2005 16.36.12 (GMT: +01.00, DST: +01.00) Last modification time (WALL): mercoledì 8 giugno 2005 22.06.36 (GMT: +01.00, DST: +01.00) File Header - Input variables Variable Value...
11.9.5 XLS output type ® This type of output generates an XLS-formatted file suitable for Microsoft EXCEL or for import by other spreadsheet programs. The file format is as below indicated; the example refers to a Load Profile file. (0120)LoadProfiles Size (bytes): 7416 Creation time (WALL):...
Page 139
If the data are used for drawing a load profile of Active Demand in kW it is Time P imp kW Q ind imp kvar 0.15 0,9428 necessary to: 0.30 1,0668 determine the energy readings of each period by calculating the 0.45 0,7984 difference of one period with respect to earlier period (e.g.
In order to change the configuration it is first necessary to download the existing configuration in HEX format by using the following command line. C:\Programs\X3M\XMBF --read --ser=com1,38400,8,n,2 --addr=27 --fnum=0100 --hex Edit then the file by means of the Notepad program.
Page 141
The “data records size” is unchanged whilst the “descriptor list size”, having added 6 significant bytes, changes from 3EH to 44H. Upload the new file by means of the command: C:\Programs\X3M\XMBF --write --ser=com1,38400,8,n,2 --addr=27 --fname=(0100)LoadProfiles.hex Upon re-reading the file, after its up-date, and by opening the file with the Notepad program, the following window is obtained: Pag.
In order to change the configuration it is first necessary to download the existing configuration in HEX format by means of the following command C:\Programs\X3M\XMBF --read --ser=com1,38400,8,n,2 --addr=27 --fnum=0400 --hex Open then the file by means of the Notepad program.
Page 144
Into the file the current has to be specified in 1/100 of A so we have to write 10.000 decimal that correspond to 2710H. Upload the new file by means of the following command line: C:\Programs\X3M\XMBF --write --ser=com1,38400,8,n,2 --addr=27 --fname=(0400)Events.hex By re-reading the file after its up-date and by opening it file with the Notepad program, the following window is obtained: Pag.
11.10.3 Changing the parameters stored by Service (5) Peaks Read the configuration file of this service in Hex format by means of the following command: C:\Programs\X3M\XMBF --read --ser=com1,38400,8,n,2 --addr=27 --fnum=0500 --hex A file is downloaded and saved, named (0500)Peaks.hex, that is opened by means of the Notepad program.
Page 147
By re-reading the file, after its up-date, and by opening it with the Notepad program, the following window is obtained: From now on, the Service will operate on the base of the new settings. In order to have the data file updated, it is necessary to remove the existing one. Pag.
12 Technical Characteristics Measurement sections: Voltmetric Inputs: 500 Vrms phase-phase (crest factor max 1.7); Amperometric Inputs: 5 Arms (crest factor max 1.7); Frequency: 45 ÷ 65 Hz Precision: Class 1 on active energy, compliant with CEI EN 61036; Alternate Voltage Sensitivity, Range Accuracy...
Page 149
Counters: energy counters with 0.1 kWh resolution and maximum value 99,999,999.9 kWh (serial input). Mount: DIN 96 x 96 mm. Weight: 360 g (460 g with packaging). Protection: IP51 on front, IP20 elsewhere. Size: 96 x 96 x 90 mm (up to 105 mm max with options) Outputs: 2 digital outputs for pulses or alerts (Din 43864 27 Vdc 27 mA) Option Galvanically Isolated RS485...
OUTPUT 2x4-20 mA PFE 422-00 any unit. (96) 15 DECLARATION OF CONFORMITY Electrex hereby declares that its range of products complies with the following directives EMC 89/336/EEC 73/23CE 93/68 CE and complies with the following product’s standard CEI EN 61326 – IEC 61326 CEI EN 61010 –...
Page 152
Edition 8 November 2005 The document can be modified without prior information. This document belongs to ELECTREX which maintains all legal rights Via Claudia, 96 41056 Savignano sul Panaro (MO) ITALY Telephone: +39 059 796372 Fax: +39 059 796378 E-mail: info@electrex.it Internet: www.electrex.it...
Need help?
Do you have a question about the X3M and is the answer not in the manual?
Questions and answers