On this page you will find information about what an OBIS code is, how to understand the value read-outs from the energy meter (from the registers) as well as which OBIS codes can be processed and shared by the device.
To understand what an OBIS code is, let us explain it with an example raw data read from the meter.
The display of your meter will most likely show more readable values.
It contains 3 elements: OBIS code
1.8.0, its value
158233.46 and the unit
kWh separated with specific characters. The OBIS codes corresponds to the type of measurement. For example,
1.8.0 corresponds to positive active energy consumed from the grid. What does that mean? This is the amount of energy you consumed since your meter was installed (registers were reset).
1.8.0? It has been defined in the
IEC62056-21 standard, in which the exact representation of OBIS codes must be represented. Most of the meters compatible with our device follow the concepts of this standard.
According to the standard, apart from the classic measurements (power, energy, voltage), you can store other data unrelated to the energy (e.g. state of the meter). To simplify things, let's focus of on the most popular OBIS codes below.
Different colors were used only to communicate the difference between opposite codes.
Tariff can be described as the period of time when a specific price list for production or consumption occurs. Some of the meters can measure the production / consumption in particular tariffs (as sometimes a client needs to deal with multiple tariffs). For example, take a look at the right side of the picture above in which we provided an abstract tariff.
OBIS code totals¶
As the meter can only provide positive values regularly, we need two OBIS codes to represent the produced and consumed energy (for simplicity: positive / negative). We can tell that:
|OBIS code||represents how much energy|
|1.8.0 / 2.8.0||has been consumed / returned to the grid|
|3.8.0 / 4.8.0||has been lost during consumption / returned to the grid|
|5.8.0 / 7.8.0||inductive reactive has been consumed / returned to the grid|
|6.8.0 / 8.8.0||capacitive reactive has been returned / consumed|
|1.8.1 - 1.8.4||has been consumed effectively in particular tariffs|
|2.8.1 - 2.8.4||has been returned to the grid effectively in particular tariffs|
If you imagine an electrical installation as a single energy consumer connected to the grid, its nature depends on the nature of devices connected to it (which contains passive electronic components like coils and capacitors) For more information ask your electrician.
OBIS codes supported¶
The device can recognize several OBIS codes which can be divided into groups base on their purpose:
- installed when a device shares its values during installation process,
- synchronized when a device shares its values from the recent readout during synchronization,
- advertised when a mobile app with gateway mode enabled or OneMeter Gateway can receive its recent values during scanning,
- stored when all its historical values are shared during synchronization (are stored in a device memory).
|Codes - Measurements||+||+||+||+|
|Codes - Special||+||+||+|
|Codes - Identification||+||+|
|Codes - Additional||+||+|
All the stored OBIS codes are advertised and synchronized as well. During synchronization, all the codes from the recent readout are shared. The advertised codes may not be stored, similar ot how some codes whose only last reading is synchronized and their history is lost.
Special code S.1.1.12 is stored in memory.
If a readout failed, Measurement codes and special code S1.1.4 are not advertised.
Codes - Measurements¶
|1.8.0||Positive active energy, total||kWh||A+|
|1.8.1||Positive active energy in tariff I||kWh||A+ (T1)|
|1.8.2||Positive active energy in tariff II||kWh||A+ (T2)|
|1.8.3||Positive active energy in tariff III||kWh||A+ (T3)|
|1.8.4||Positive active energy in tariff IV||kWh||A+ (T4)|
|2.8.0||Negative active energy, total||kWh||A-|
|2.8.1||Negative active energy in tariff I||kWh||A- (T1)|
|2.8.2||Negative active energy in tariff II||kWh||A- (T2)|
|2.8.3||Negative active energy in tariff III||kWh||A- (T3)|
|2.8.4||Negative active energy in tariff IV||kWh||A- (T4)|
|3.8.0||Positive reactive energy, total||kvarh||Q+|
|4.8.0||Negative reactive energy, total||kvarh||Q-|
|5.8.0||Reactive energy in I quadrant, total||kvarh||QL+|
|6.8.0||Reactive energy in II quadrant, total||kvarh||QC+|
|7.8.0||Reactive energy in III quadrant, total||kvarh||QL-|
|8.8.0||Reactive energy in IV quadrant, total||kvarh||QC-|
|15.8.0||Absolute active energy, total||kWh|||A||
|15.8.1||Absolute active energy, total in tariff I||kWh|||A| (T1)|
|15.8.2||Absolute active energy, total in tariff II||kWh|||A| (T2)|
|15.8.3||Absolute active energy, total in tariff III||kWh|||A| (T3)|
|15.8.4||Absolute active energy, total in tariff IV||kWh|||A| (T4)|
Conflict of OBIS codes 1.8.X, 15.8.X
If a meter shares
15.8.0 vales, only one of them will be taken into consideration. The same situation will occur with tariff codes.
15.8.X are advertised and stored if and only if at least two of them were non-zero during installation process.
The other form of 15.8.X
Some meter manufacturers programmed meters to have
F.8.X codes instead of
Codes - Special¶
Special OBIS codes are provided by us uniquely. They may not have equivalents among official OBIS codes, however you can recognize them in the cloud by a
|S.1.1.4||Readout time (aligned)||2020-11-19 10:45:00|
|S.1.1.6||Successful readouts since restart (e.g. battery replacement)||433|
|S.1.1.7||Number of failed read attempts on first / second message since restart||23/22|
|S.1.1.8||Parameters of communication with meter||3, 300|
|S.1.1.10||Readout time (real)||2020-11-19 10:45:02|
|S.1.1.12||Energy consumption (from meter LED blink counting)||10.44|
S.1.1.7: The device asks meter for data twice. First it asks for an identifier, then registers with OBIS values. That is why we may have failed readouts on two messages.
S.1.1.8: It is the infrared transmission power (3) and a baud rate used for the communication (300 bps).
S.1.1.12: Based on the blinks/usage ratio and number of blinks counted, we can calculate the estimated energy consumption.
Codes - Identification¶
|0.0.0||Device address 1|
|C.1.0||Meter serial number|
|C.90.1||IEC port number|
|F.F.0||Meter error register|
0.2.2: The value of this code is unpredictable (may be displayed improperly) and represented with 4 characters only on cloud.
The unambiguous meter identification is constricted
Despite that a meter shares a couple of OBIS codes which can be treated as partials of a meter's uniqueness (
C.90.1 are processed by the device), meter manufacturers do not apply common nomenclature. However in 99% of cases, our device can distinguish meters properly.
Codes - Additional¶
|3.8.1||Positive reactive energy in tariff I||kvarh||Q+ (T1)|
|3.8.2||Positive reactive energy in tariff II||kvarh||Q+ (T2)|
|3.8.3||Positive reactive energy in tariff III||kvarh||Q+ (T3)|
|3.8.4||Positive reactive energy in tariff IV||kvarh||Q+ (T4)|
|4.8.1||Negative reactive energy in tariff I||kvarh||Q- (T1)|
|4.8.2||Negative reactive energy in tariff II||kvarh||Q- (T2)|
|4.8.3||Negative reactive energy in tariff III||kvarh||Q- (T3)|
|4.8.4||Negative reactive energy in tariff IV||kvarh||Q- (T4)|
|5.8.1||Reactive energy in I quadrant in tariff I||kvarh||QL+ (T1)|
|5.8.2||Reactive energy in I quadrant in tariff II||kvarh||QL+ (T2)|
|5.8.3||Reactive energy in I quadrant in tariff III||kvarh||QL+ (T3)|
|5.8.4||Reactive energy in I quadrant in tariff IV||kvarh||QL+ (T4)|
|6.8.1||Reactive energy in II quadrant in tariff I||kvarh||QC+ (T1)|
|6.8.2||Reactive energy in II quadrant in tariff II||kvarh||QC+ (T2)|
|6.8.3||Reactive energy in II quadrant in tariff III||kvarh||QC+ (T3)|
|6.8.4||Reactive energy in II quadrant in tariff IV||kvarh||QC+ (T4)|
|7.8.1||Reactive energy in III quadrant in tariff I||kvarh||QL- (T1)|
|7.8.2||Reactive energy in III quadrant in tariff II||kvarh||QL- (T2)|
|7.8.3||Reactive energy in III quadrant in tariff III||kvarh||QL- (T3)|
|7.8.4||Reactive energy in III quadrant in tariff IV||kvarh||QL- (T4)|
|8.8.1||Reactive energy in IV quadrant in tariff I||kvarh||QC- (T1)|
|8.8.2||Reactive energy in IV quadrant in tariff II||kvarh||QC- (T2)|
|8.8.3||Reactive energy in IV quadrant in tariff III||kvarh||QC- (T3)|
|8.8.4||Reactive energy in IV quadrant in tariff IV||kvarh||QC- (T4)|
|15.6.0||Absolute active maximum demand||kW||Pmax|
|15.6.1||Absolute active maximum demand in tariff I||kW||Pmax (T1)|
|15.6.2||Absolute active maximum demand in tariff 1I||kW||Pmax (T2)|
|15.6.3||Absolute active maximum demand in tariff 1II||kW||Pmax (T3)|
|15.6.4||Absolute active maximum demand in tariff 1V||kW||Pmax (T4)|
|15.7.0||Absolute active instantaneous power||kW||P|