Metadata-Version: 2.1
Name: growattRS232
Version: 1.0.0
Summary: Python wrapper for getting data asynchronously from Growatt inverters via serial usb RS232 connection and modbus RTU protocol.
Home-page: https://github.com/ArdescoConsulting/growattRS232
Author: Manuel Stevens
Author-email: manuel.stevens@ardesco.be
License: MIT
Project-URL: Bug Reports, https://github.com/ArdescoConsulting/growattRS232/issues
Project-URL: Source, https://github.com/ArdescoConsulting/growattRS232
Description: # growattRS232
        
        [![PyPI][pypi-releases-shield]][pypi-releases]
        [![GitHub issues](https://img.shields.io/github/issues/ArdescoConsulting/growattRS232.svg)](https://GitHub.com/ArdescoConsulting/growattRS232/issues/)
        
        Python wrapper for getting data asynchronously from Growatt inverters via serial usb RS232 connection and modbus RTU protocol.
        
        The Growatt inverted must support the modbus protocol (some older inverters only support proprietary serial communication)
        Connect the RS232 DB9 usb adapter to the RS232 port on the underside of the inverter (you might have to remove a cover plate).
        
        ## Attributes
        
        Depending on the firmware version of your inverter, not all attributes might be available
        
        Inverter properties
        
        - serial_number
        - model_number
        - firmware
        
        DC input PV
        
        - input_power
        - input_energy_today
        
        DC input string 1 PV
        
        - input_1_amperage
        - input_1_voltage
        - input_1_power
        - input_1_energy_today
        - input_1_energy_total
        
        DC input string 2 PV
        
        - input_2_amperage
        - input_2_voltage"
        - input_2_power"
        - input_2_energy_today"
        - input_2_energy_total"
        
        AC output grid
        
        - output_power
        - output_energy_today
        - output_energy_total
        - power_factor
        - output_reactive_power
        - output_reactive_energy_today
        - output_reactive_energy_total
        
        AC output phase 1 grid
        
        - output_1_voltage
        - output_1_amperage
        - output_1_power
        
        AC output phase 2 grid
        
        - output_2_voltage
        - output_2_amperage
        - output_2_power
        
        AC output phase 3 grid
        
        - output_3_voltage
        - output_3_amperage
        - output_3_power
        
        Miscellaneous information
        
        - operation_hours
        - frequency
        - temperature
        - ipm_temperature
        - p_bus_voltage
        - n_bus_voltage
        - derating_mode
        - derating
        
        Status, faults & warnings
        
        - status
        - status_code
        - fault_code
        - fault
        - warning_code
        - warning_value
        - warning
        
        ## How to use the package
        
        ```py
        import asyncio
        import logging
        from sys import argv
        
        from growattRS232 import GrowattRS232
        
        # defaults
        # USB port of RS232 converter
        DEFAULT_PORT = "/dev/ttyUSB0"
        # Growatt modbus address
        DEFAULT_ADDRESS = 0x1
        
        logging.basicConfig(level=logging.DEBUG)
        
        
        async def main():
            port = str(argv[1]) if len(argv) > 1 else DEFAULT_PORT
            address = int(argv[2]) if len(argv) > 2 else DEFAULT_ADDRESS
            growattRS232 = GrowattRS232(port, address)
            try:
                data = await growattRS232.async_update()
                print(f"Sensors data: {data}")
            except Exception as error:
                print("Error: " + repr(error))
        
        
        loop = asyncio.get_event_loop()
        loop.run_until_complete(main())
        loop.close()
        ```
        
        [pypi-releases]: https://pypi.org/project/growattRS232
        [pypi-releases-shield]: https://img.shields.io/pypi/v/growattRS232
        
Keywords: growatt rs232 modbus
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: MIT License
Classifier: Intended Audience :: Developers
Requires-Python: >=3.6, <4
Description-Content-Type: text/markdown
