Metadata-Version: 1.1
Name: pyMeterBus
Version: 0.7.8
Summary: Python implementation of the Meter-Bus protocol
Home-page: https://github.com/ganehag/pyMeterBus
Author: Mikael Ganehag Brorsson
Author-email: mikael.brorsson@gmail.com
License: BSD-3-Clause

Description: Meter-Bus for Python
        ====================
        [![Build Status](https://travis-ci.org/ganehag/pyMeterBus.svg?branch=master)](https://travis-ci.org/ganehag/pyMeterBus) [![codecov](https://codecov.io/gh/ganehag/pyMeterBus/branch/master/graph/badge.svg)](https://codecov.io/gh/ganehag/pyMeterBus)
        
        About
        -----
        
        [M-Bus](http://www.m-bus.com/) (Meter-Bus) is a European standard (EN 13757-2 physical and link layer, EN 13757-3 application layer) for the remote reading of gas or electricity meters. M-Bus is also usable for other types of consumption meters. The M-Bus interface is made for communication on two wires, making it very cost effective.
        
        
        Current State
        -------------
        
        This implementation is currently under heavy development. It is targeted at a very specific solution. Thus only the *variable data structure* is implemented. However the missing pieces will be implemented in the future.
        
        Tools
        -----
        
        You can find a set of utilities in the `tools` folder.
        
        * mbus-serial-request-data.py
        * mbus-serial-request-data-multi-reply.py
        * mbus-serial-scan.py
        
        These tools can communicate over a serial device `/dev/ttyX` or even over RFC2217 using the format `rfc2217://host:port`.
        
        If you are using `ser2net` as a RFC2217 server. You need to configure it the following way:
        
        ```
        2000:telnet:0:/dev/ttySX:2400 remctl banner
        ```
        
        Known Issues
        ------------
        * Missing: Fixed data structure parsing.
        * Missing: Encoding to M-Bus frames.
        * Missing: Slave configuration.
        * Missing: Interface code (Serial, TCP/IP)
        * Missing: Extended VIF codes.
        
        
        What works
        ----------
        
        * Parsing of complete telegram.
        * Parsing of just Used Data segment.
        * Generation of basic JSON structure from telegram/user-data/record.
        
        
        Code examples
        -------
        
        ### Decode the value of a single record (record 3)
        ```python
        #!/usr/bin/python
        
        import meterbus
        
        data = "\x68\x6A\x6A\x68\x08\x01\x72\x43\x53\x93\x07\x65" \
               "\x32\x10\x04\xCA\x00\x00\x00\x0C\x05\x14\x00\x00" \
               "\x00\x0C\x13\x13\x20\x00\x00\x0B\x22\x01\x24\x03" \
               "\x04\x6D\x12\x0B\xD3\x12\x32\x6C\x00\x00\x0C\x78" \
               "\x43\x53\x93\x07\x06\xFD\x0C\xF2\x03\x01\x00\xF6" \
               "\x01\x0D\xFD\x0B\x05\x31\x32\x4D\x46\x57\x01\xFD" \
               "\x0E\x00\x4C\x05\x14\x00\x00\x00\x4C\x13\x13\x20" \
               "\x00\x00\x42\x6C\xBF\x1C\x0F\x37\xFD\x17\x00\x00" \
               "\x00\x00\x00\x00\x00\x00\x02\x7A\x25\x00\x02\x78" \
               "\x25\x00\x3A\x16"
        
        telegram = meterbus.load(data)
        print telegram.records[3].parsed_value
        ```
        
        ```shell
        ~$ 2014-02-19T11:18
        ```
        
        ### Request a frame over Serial and dump it in JSON format
        ```python
        #!/usr/bin/python
        
        import serial
        import meterbus
        
        address = 254
        
        with serial.Serial('/dev/ttyACM0', 2400, 8, 'E', 1, 0.5) as ser:
          meterbus.send_ping_frame(ser, address)
          frame = meterbus.load(meterbus.recv_frame(ser, 1))
          assert isinstance(frame, meterbus.TelegramACK)
        
          meterbus.send_request_frame(ser, address)
          frame = meterbus.load(meterbus.recv_frame(ser, meterbus.FRAME_DATA_LENGTH))
          assert isinstance(frame, meterbus.TelegramLong)
        
          print(frame.to_JSON())
        ```
        
        M-Bus Packet Format
        -------------------
        
        | Single Character | Short Frame | Control Frame | Long Frame             |
        |------------------|-------------|---------------|------------------------|
        | E5h              | Start 10h   | Start 68h     | Start 68h              |
        |                  | C Field     | L Field = 3   | L Field                |
        |                  | A Field     | L Field = 3   | L Field                |
        |                  | Check Sum   | Start 68h     | Start 68h              |
        |                  | Stop 16h    | C Field       | C Field                |
        |                  |             | A Field       | A Field                |
        |                  |             | CI Field      | CI Field               |
        |                  |             | Check Sum     | User Data (0-252 Byte) |
        |                  |             | Stop 16h      | Check Sum              |
        |                  |             |               | Stop 16h               |
        
        
        
        License
        -------
        Please see the [LICENSE](LICENSE) file
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Software Development :: Libraries
